Distribute customized ribbons by using a firm or environment folder

Tekla Structures
Modified: 13 Jan 2023
2023
Tekla Structures

Distribute customized ribbons by using a firm or environment folder

Administrators can distribute the customized ribbon files to other users in the company by placing the ribbon files in a firm or environment folder.

For example, you can create company ribbons and save them in the firm folder. These ribbons are shown in the Tekla Structures user interface for all users who use the same firm folder.

Add ribbons to a firm or environment folder

  1. In the Ribbon editor, create the modeling and drawing ribbons that you want to share.

    The ribbons are saved in the ..\Users\<user>\AppData\Local\Trimble\Tekla Structures\<version>\UI\Ribbons folder.

    If you cannot find the folder, ensure that you are able to view the hidden files and folders on your computer.

  2. Copy the entire \Ribbons folder either to your company's firm folder or to the system folder.
  3. If the ribbon contains user-defined commands, create a sub-folder named \Commands on the same level as the \Ribbons folder, and copy the UserDefined.xml file from the ..\Users\<user>\AppData\Local\Trimble\Tekla Structures\<version>\UI\Commands folder to the \Commands folder you just created.
  4. Restart Tekla Structures.

Loading order of custom ribbons

Tekla Structures loads the ribbons in the following order:

  1. Tekla Structures default ribbon

  2. Company ribbons in the environment folders

  3. Company ribbons in the firm folder

  4. User-defined ribbons under %localappdata%

Ribbons that are loaded later override previously loaded ribbons that have the same combination of configuration and editing mode. For example, a ribbon defined in the firm folder overrides ribbons in the environment folders.

If you have a customized ribbon in the ..\Users\<user>\AppData\Local\Trimble\Tekla Structures\<version>\UI\Ribbons folder, it overrides company ribbons. To use the ribbon in the environment or firm folder, open the Ribbon editor and click Restore. Alternatively, you can remove or rename your own customized ribbons.

Naming convention for ribbon files

The customization tool saves the custom ribbons as .xml files. The naming convention for these files is:

<Tekla-Structures-configuration_identifier>--<Tekla-Structures-editing-mode>.xml

The name consists of an internal configuration name, a separator of two dash characters (--), an internal editing mode name, and the file name extension .xml. For example, the Full license modeling ribbon is called albl_up_Full--main_menu.xml.

Configuration identifier

Configuration name

albl_up_Diamond

Tekla Structures Diamond

albl_up_Graphite

Tekla Structures Graphite

albl_up_Carbon

Tekla Structures Carbon

albl_up_Construction_Modeling

Construction Modeling

albl_up_Developer

Developer

albl_up_Drafter

Drafter

albl_up_Educational

Educational

albl_up_Engineering

Engineering

albl_up_Full

Full

albl_up_PC_Detailing

Precast Concrete Detailing

albl_up_Rebar_Detailing

Rebar Detailing

albl_up_Steel_Detailing

Steel Detailing

albl_up_Tekla_Structures_Primary

Primary

albl_up_Viewer

Project Viewer

Editing mode

Purpose

main_menu

Modeling ribbon

edit_draw_menu

Drawing ribbon

plan_main_menu

Importing ribbon

Was this helpful?
Previous
Next