Customized default setup for Organizer

Tekla Structures
2020
Tekla Structures

Customized default setup for Organizer

You can customize Organizer by creating a setup that opens the same templates and categories in all new models. A customized setup is useful if you have templates and categories you want to use in all models. Then you do not need to create or import the templates and categories for each model separately. The customized setup is used when you open Organizer in a model for the first time.

You can also exclude some object types from Organizer using the ExcludedTypesFromOrganizer.xaml file. Excluded object types are not displayed in Object Browser and they are not included in categories.

To make the customized property templates and categories available in all models, store the templates in the \ProjectOrganizerData\PropertyTemplates folder and the categories in the \ProjectOrganizerData\DefaultCategoryTrees folder. The templates and categories are stored as in the xml format. Property template files have the .propertytemplate file extension and categories have the .category file extension.

Note:

The defined location categories are automatically imported but they behave like manually created categories. Automatic categories need to be defined in each model separately.

You can have the folders under any or all of the following folders:

  • Current model folder

  • Project folder, defined in the XS_PROJECT advanced option

  • Firm folder, defined in the XS_FIRM advanced option

  • Folders defined in the XS_SYSTEM advanced option

Example of folders:

All templates and categories in these folders are loaded to Organizer when you open it for the first time in a model. If there are many files with the same file name in several different folders, the first file found is loaded and the other files with the same file name are ignored. The search order is always: model, project, firm, system. The roles.ini does not affect this order.

For example, if you have rebar.category, category.category and material.category in a system folder \ProjectOrganizerData\DefaultCategoryTrees folder, these files will all be loaded automatically to the categories. If you also have a rebar.category file in the \PROJECT\ProjectOrganizerData\DefaultCategoryTrees folder and in the \model\ProjectOrganizerData\DefaultCategoryTrees folder, only the first rebar.category file found is used. In this case, the file under the model folder would be the first one found.

Note:

You can use the roles.ini files to control multiple setups. For example, create a \Concrete\ProjectOrganizerData folder and a \Steel\ProjectOrganizerData folder under the firm folder. Then define in the roles.ini file which of these folders is read and/or in which order the folders are read. This way you can read only the \Concrete folder files, or read the \Concrete folder first. In this case, the files with the same name in the steel folder are ignored.

The loaded templates and categories are saved in the ProjOrg.db in the \ProjectOrganizer folder under the model folder. When you open Organizer for the first time, the ProjOrg.db is created and the files are read in from the model, project, firm and system folders. The ProjOrg.db database stores all template and category information used in the model. When you make changes to the templates and categories in the folders, they are not automatically updated in ProjOrg.db. The database will not read in the template and category xml files again, so updates to the files will not be automatically applied.

If you want to apply the changed templates and categories to the ProjOrg database, you have two options:

  • Delete the old templates and categories in Organizer and import the changed templates and categories. We recommend that you use this option.

  • Export from Organizer all the templates and categories that you want to keep and close the model. Delete the ProjOrg.db database from the \ProjectOrganizer folder under the model folder, and re-open the model. Import the exported templates and categories back to Organizer.

    Note:

    The second option will reset Organizer completely. All data will be lost if not exported.

Was this helpful?
Previous
Next