Distribute customized tabs by using a firm or environment folder

Tekla Structures
Modified: 13 Jan 2023
2023
Tekla Structures

Distribute customized tabs by using a firm or environment folder

As an alternative to customized ribbon files, which override the existing ribbon, you can distribute customized tabs to other users in the company by placing the tab files in a firm or an environment folder.

The customized tabs are automatically appended to the end of the ribbon for all users who use the same firm or environment folder. An administrator can distribute customizations to all users in the company while still allowing individual users to customize their ribbons.

These customized tabs do not appear in the Ribbon editor, so the users are not able to edit them. When an administrator updates the contents of a customized tab, the users receive the update when they restart Tekla Structures. Tabs are not configuration-specific. They are imported regardless of the user's Tekla Structures subscription configuration. If the tab contains commands that are not available in the user's configuration, the commands appear dimmed on the ribbon.

Note:

If you use a firm folder to distribute the custom tabs, set the firm folder path in an .ini file, such as user.ini, teklastructures.ini,project.ini, or company.ini. If you set the firm folder path in the advanced option XS_FIRM, the tab file does not work correctly because the XS_FIRM definition in the advanced options is made on the model level and the custom tab is not initialized.

  1. Create the following folder structure in your company's firm folder or in the system folder.

  2. In the Ribbon editor, create a customized tab and add commands to it.
  3. Save the ribbon.
  4. Go to the ..\Users\<user>\AppData\Local\Trimble\Tekla Structures\<version>\UI\Ribbons folder.
  5. In a text editor, open the ribbon *.xml file that contains the tab that you want to share with other users.
  6. Remove all the other content from the ribbon file except the first row and the description of the tab that you want to share.

    Alternatively, you can copy the content to a new text file.

    For example:

    <?xml version="1.0" encoding="utf-8" standalone="yes"?>
    <Tab Header="My Tab" IsCollapsed="false" IsUserDefined="true">
      <SimpleButton X="0" Y="0" Width="3" Height="4" Command="Common.Interrupt" Text="command:ShortText" Icon="myicon.png" ShowText="true" ShowIcon="true" />
      <SimpleButton X="3" Y="0" Width="3" Height="4" Command="RibbonEditor.Open" Text="command:ShortText" Icon="somefolder\myicon2.png" ShowText="true" ShowIcon="true" />
    </Tab>

    The button icons use relative paths. The icon path is relative to the *.xml file where tab is read from. For example Icon="myicon.png" refers to an icon in the same folder as the *.xml file, and the Icon="somefolder\myicon2.png" refers to an icon in a sub-folder.

    Alternatively, you can also create paths to folders at levels above the current folder: Icon="..\myicon.png".

  7. Save the *.xml file with a new name in the ..\CustomTabs\Modeling or ..\CustomTabs\Drawing folder.

    Tab files have the file name extension *.xml. We recommend that you use the same name as for the tab. For example, MyTab.xml. The file name is not case sensitive.

    The tab is added to either the modeling or drawing mode ribbons, depending on the folder that it is located in. There can be several custom tab files in the same folder. They are added to the ribbon one after the other. If the same tab file exists in both the environment and firm folders, the firm version overrides the environment version.

    Note:

    To avoid file name conflicts, we recommend that administrators prefix all custom tab files with the company name, and that extension developers prefix all custom tab files with the name of the extension (for example, MyExtension_TabName.xml).

  8. If the tab contains user-defined commands, copy the UserDefined.xml file from the ..\Users\<user>\AppData\Local\Trimble\Tekla Structures\<version>\UI\Commands folder to the \Commands folder that you created in the firm folder or the system folder.
  9. Restart Tekla Structures.

    The customized tab now appears at the end of the ribbon.

Was this helpful?
Previous
Next