Hello!

Did you know that logged in users can see a lot more content?

Distribute customized ribbons using a firm or environment folder

Last updated September 10, 2018 by Tekla User Assistance tekla.documentation@trimble.com

Software version: 
2018i

Distribute customized ribbons using a firm or environment folder

Distribute customized ribbons using a firm or environment folder

You can distribute customized ribbon files to other users in the company by placing the ribbon files in a firm or environment folder (not in the project folderfolder that is used for storing Tekla Structures-related files customized for a particular project

). For example, the administrator can create company ribbons and save them in the firm folderfolder that is used for storing Tekla Structures-related files customized for a particular organization

A Tekla Structures user can, for example, customize a company’s cloning templates and save them in a sub-folder located under the firm folder. After this, the customized cloning templates can be used in all projects carried out for the company.

. These ribbons will be displayed in the Tekla Structures user interface for all users who use the same firm folder.

Add ribbons to the 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\TeklaStructures\<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, which is located under the environment folder: ..\ProgramData\Tekla Structures\<version>\Environments\<environment>\system.
  3. If the ribbon contains user-defined commands, create a subfolder named \Commands on the same level as the \Ribbons folder, and copy the UserDefined.xml file from the ..\Users\<user>\AppData\Local\Trimble\TeklaStructures\<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%

Note that the ribbons which are loaded later will override previously loaded ribbons that have the same configuration + editing mode combination. For example, a ribbon defined in the firm folder will take precedence over the ribbons in the environment folders.

If you have a customized ribbon in the ..\Users\<user>\AppData\Local\Trimble\TeklaStructures\<version>\UI\Ribbons folder, it will take precedence over company ribbons. To override this, open the Ribbon editor and click Restore. The ribbon in the environment or firm folder will now be used. 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

Name

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

Quick feedback

The feedback you give here is not visible to other users. We use your comments to improve our content.
We use this to prevent automated spam submissions.
Content rating: 
No votes yet