topic Re: view template "include" in Revit API Forum

view template "include"

Ning_Zhou — Tue, 18 Nov 2014 08:39:30 GMT

see attached JPG, is that "include" parameter available?

Re: view template "include"

jeremytammik — Wed, 19 Nov 2014 10:36:25 GMT

Dear Ning,

Thank you for your query. I passed it on to the development team and will let you know what I find out.

Cheers,

Jeremy

Re: view template "include"

Revitalizer — Wed, 19 Nov 2014 10:47:08 GMT

Dear Ning_Zhou,

the View.GetNonControlledTemplateParameterIds() and View.GetTemplateParameterIds() methods may match your needings.

Best regards,
Revitalizer

Re: view template "include"

Ning_Zhou — Thu, 20 Nov 2014 02:40:37 GMT

thanks Jeremy, as mentioned by Revitalizer, it may already be available but your confirmation will be very much appreciated. Ning

Re: view template "include"

Ning_Zhou — Thu, 20 Nov 2014 02:48:16 GMT

thanks Revitalizer for the hint, I noticed these 2 methods before but not quite sure and never tested, will give a try later. Ning

Re: view template "include"

Ning_Zhou — Thu, 20 Nov 2014 04:34:18 GMT

just curious, you can get parameter id from View.GetTemplateParameterIds() , but how can you know which is which, well, I may miss something very simple, how to get parameter from parameter id if it's negative "number"?

Re: view template "include"

Anonymous — Thu, 20 Nov 2014 05:58:27 GMT

negative parameter Id values are found in the BuiltInParameter enumeration. The underlaying values in the enumeration map directly to the interger value of the parameter Id.

Re: view template "include"

Ning_Zhou — Thu, 20 Nov 2014 09:36:13 GMT

got it, thanks Scott, managed to get list of template parameters, no luck in matching any one to that "include" guys

Re: view template "include"

jeremytammik — Tue, 03 Feb 2015 09:07:40 GMT

Dear Ning,

Thank you for your patience. I submitted a wish list item for this for you: CF-2158 [API: set 'include' toggle in view template list].

Cheers,

Jeremy

Re: view template "include"

Ning_Zhou — Wed, 04 Feb 2015 01:15:24 GMT

great! thanks Jeremy

Re: view template "include"

jeremytammik — Mon, 11 Jun 2018 15:34:46 GMT

Dear Ning and all others concerned,

Thank you for your patience, and I hope you noticed and voted for the associated wish list item:

Set View Template from API -- https://forums.autodesk.com/t5/revit-ideas/set-view-template-from-api/idi-p/6661957

This wish list item appears to be on the roadmap now, and the development team are requesting feedback on it.

The discussion forum threads, ADN cases and development tasks affected are:

CF-1509 [API wish: create view template -- 09693106, 11795199]
09693106 [ViewTemplate] -- http://forums.autodesk.com/t5/Revit-API/ViewTemplate/m-p/5094076
11795199 [Create a view template] -- http://forums.autodesk.com/t5/revit-api/create-a-view-template/m-p/6320813
CF-2158 [API: set 'include' toggle in view template list] -- 10199679 [view template "include"]
10199679 [view template "include"] -- http://forums.autodesk.com/t5/revit-api/view-template-quot-include-quot/m-p/5410347

Would you like to review the current draft of the plans below and let us know whether you think they will meet your needs?

We think the Acceptance Criteria listed below cover the customer wishes; please let us know if this is correct and if there are other requirements related to View Templates.

Draft Release Epic:

As an API developer, I need the ability to create, modify and apply view templates via the API, so that I don’t need to use Revit interface to create and manage my view templates.

Draft Acceptance Criteria:

Ability to edit and control all view template setting via the API (this may be available now?)
Ensure that the action of including parameters via the “Include” column in the view templates dialog is available through the API. (maybe this is the same as line #1?)
Create a new view template from scratch via the API
Duplicate an existing view template via the API
Create a view template from the current view and from existing views via the API
Allow Revit command “CreateTemplateFromCurrentView" to be called silently and with the required arguments. (Is this request redundant?)

Customer sentiment:

My goal is to create X views, each with a new view template that has filter variations which depend on parameter values. I managed (via the API) to associate each view with the correct template, but had to create the templates via the UI, before I could edit them with the API.

Does that sound as if it matches and covers all your requirements?

Thank you!

Cheers,

Jeremy

Re: view template "include"

Ning_Zhou — Mon, 11 Jun 2018 18:12:16 GMT

thanks Jeremy for this good news! i'm happy as long as that "Include" will be available via API. Ning

Re: view template "include"

teocomi — Thu, 01 Nov 2018 15:43:06 GMT

Hi all,

I've been able to get the "includes" with `viewTemplate.GetNonControlledTemplateParameterIds`.

The method returns a list of Parameter ids, and you can then use `viewTemplate.Parameters` to map them.

Same for setting them, see below an example:

//creating a list so that I can use linq
var viewparams = new List<Parameter>();
foreach (Parameter p in viewTemplate.Parameters)
 viewparams.Add(p);

//getting parameters by name (safety checks needed)
var modelOverrideParam = viewparams.Where(p => p.Definition.Name == "V/G Overrides Model").First();
var viewScaleParam = viewparams.Where(p => p.Definition.Name == "View Scale").First();

//setting includes
viewTemplate.SetNonControlledTemplateParameterIds(new List<ElementId> { modelOverrideParam.Id, viewScaleParam.Id });

cc @jeremytammik

Re: view template "include"

jeremytammik — Thu, 01 Nov 2018 16:34:26 GMT

Thank you!

Preserved for posterity:

https://thebuildingcoder.typepad.com/blog/2018/11/view-template-include-setting.html

Cheers,

Jeremy

Re: view template "include"

Dale.Bartlett — Fri, 02 Nov 2018 08:57:34 GMT

That is useful information. Thanks. Can you tell me if this is only for Revit 2019 and later? Dale

Re: view template "include"

teocomi — Fri, 02 Nov 2018 17:04:14 GMT

@Dale.Bartlett I have't tried with previous versions, but the same methods exist in the 2016 API, so it should work...

https://apidocs.co/apps/revit/2016/15617b2e-89a4-ddbe-5f93-7855c2994d79.htm

Re: view template "include"

Anonymous — Wed, 07 Nov 2018 16:18:53 GMT

@teocomi I was asked about this yesterday so it was funny to see your name appear so recently on this thread with a solution!

One comment though would be that by using the view.SetNonControlledTemplateParameterIds() method it takes the parameters of a view and sets them to true in the view template unless specified in the input. As a result you may wish to do a check first that gets all of the parameters currently not included and add them to the list of id's you feed in should you wish to stop them all defaulting to include.