Customize the Applications & components catalog
You can modify the catalog definition settings of the Applications & components catalog using catalog definition files, and set up a group structure to suit the needs of your company.
Always check the settings and the group structure when upgrading to a new Tekla Structures version.
Catalog definition files (ComponentCatalog.xml) can be located in folders that are defined by the XS_SYSTEM, XS_FIRM, and XS_PROJECT advanced options, and in the model folder. If there are several catalog definition files, Tekla Structures combines the information in the files. For more information about the folder search order, see Folder search order.
When you create a group structure for the Applications & components catalog, define the highest level structure in a catalog definition file that is located in a folder that is defined by the XS_SYSTEM advanced option. To hide unnecessary parts of the group structure and catalog content from certain roles, edit the catalog definition files of these roles.
You can also add your own instructor side pane help pages for the tools in the Applications & components catalog.
Edit the Applications & components catalog
To edit the catalog
definition files, set the XS_COMPONENT_CATALOG_ALLOW_SYSTEM_EDIT advanced option to
In the Applications & components catalog, click , then select the catalog definition file that you want to
The list of files shows all the environment folders, the project and firm folders if defined, and the model folder. You can define the catalog definition file folder paths in
XS_COMPONENT_CATALOG_ALLOW_SYSTEM_EDITis not set to
TRUE, a small warning icon is shown next to the files in the
XS_SYSTEMfolder locations. The image shows warning icons next to the files that appear dimmed.
Files that appear dimmed do not exist, but you can create the files by selecting them, and clicking Yes in the Edit mode message box.
You can remove an existing file by clicking the button next to the file.
Select the file that you want to edit.
The check mark in front of the folder name shows the file that is currently being edited.
- Create new groups and subgroups to organize the catalog content, right-click in the catalog and select New group....
Move the content from
Ungrouped items to the new groups, or to other predefined custom groups.
To move an item to another group, right-click the item, select Add to group, then select the target group.
It is important to keep the Ungrouped items group empty because all items downloaded from Tekla Warehouse are placed in that group. When you place an item to a predefined group, it is automatically removed from the ungrouped items.
Maintain the Applications & components catalog
To keep the Applications & components catalog structure and content clear and in order, keep the groups up to date and organized, and remove the unnecessary items from the catalog definition files.
in the bottom-right corner in the
Applications & components catalog to display the message log:
If an item defined in a catalog definition file is removed from the Tekla Structures software, the removed item will be included in the Applications & components catalog error message log.
If the log contains references to missing items, edit the relevant
ComponentCatalog.xml file to remove the references manually.
We recommend that you make a back-up copy of the file before you start editing.
Thoroughly test that these
changes do not create any further errors, or cause problems in the group
structure in the Applications & components catalog.
Check at least the Ungrouped items and Legacy catalog groups.
- If there are new items in the group, move them from the Ungrouped items group to the appropriate predefined groups, and hide them from specific roles, if needed.
- Add suitable thumbnails to the items, if needed.
Create your own component folder
Usually, only a few different connections and components are used in a project. To ensure that everyone in the project uses the same components and finds the components faster, we recommend that you create your own component folder.
In the Applications & components catalog, use the commands in Access advanced features > Catalog management to modify catalog definitions.
- Click the Applications & components button in the side pane to open the Applications & components catalog.
- To create a new group for the project, right-click in the catalog, then select New group.
Add components to the
- Select the components in the catalog, right-click, then select Add to group.
Select the group to
which you want to add the components.
You can also drag the selected components to another group.
- To hide the groups that you do not need, select the group, right-click, then select Hide/Unhide.
Troubleshooting components or groups in the Applications & components catalog
If a component or group in the Applications & components catalog is not working as expected, you can generate a troubleshooting dump file that shows the data used to construct the component or group.
- In the Applications & components catalog, click .
- In the catalog, select the component or group, then right-click and select Dump troubleshooting data.
In the dialog box that opens, select the target file path and enter the
file name, then click Save to save the file.
By default, the file is stored in the \local\temp folder for the model.