1. Set the XS_COMPONENT_CATALOG_ALLOW_SYSTEM_EDIT advanced option to TRUE to edit the catalog definition files.
2. In the Applications & components catalog, click Access advanced features > Catalog management > Edit mode, and select the catalog definition file that you want to edit.

   The list of files shows all the environment folders, the project and firm folders if defined, and the model folder. You can define the needed catalog definition file folder paths in XS_SYSTEM.

   If XS_COMPONENT_CATALOG_ALLOW_SYSTEM_EDIT is not set to TRUE, a small warning icon is shown next to the files in the XS_SYSTEM folder locations. The image shows warning icons next to the files that appear dimmed.

   

   The files that appear dimmed do not exist, but you can create the files by selecting them, and answering Yes in the Edit mode message box.

   

   You can remove an existing file by clicking the button next to the file.

   

3. 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.

   

4. Create new groups and subgroups to organize the catalog content, right-click in the catalog and select New group....
5. 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, and 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.

   For instructions on how to collect content to a group and publish it as a catalog definition file, see Publish a group in the Applications & components catalog.

1. Click 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.

2. 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.

   

3. Test thoroughly that these changes do not create any further errors, or mess up the group structure in the Applications & components catalog. Check at least the Ungrouped items and Legacy catalog groups.
4. Newly added items are placed in the Ungrouped items group. If there are new items in the group, move them to the appropriate predefined groups, and hide them from specific roles, if needed.
5. Add suitable thumbnails to the items, if needed.

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.

1. In the Applications & components catalog, click Access advanced features > Catalog management > Show dump command for selected component or group.
2. In the catalog, select the component or group, then right-click and select Dump troubleshooting data.
3. 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.