Role settings - role_<role>.ini

The role_<role>.ini files contain all the advanced options that have typical role-specific settings.

The file is read from the environment folder ..\ProgramData\Trimble\Tekla Structures\<version>\environments\. The exact location might vary depending on the environment.

Warning:

Do not modify the role_<role>.ini file. If you need to modify some settings, copy the needed advanced options from this file to your user.ini file and modify the settings there, or modify the settings in the Advanced Options dialog.

The role_<role>.ini file contains advanced options that are set according to typical role requirements in your local area. These settings are different from your environment settings in env_<environment name>.ini. The global default environment settings file env_global_default.ini contains a complete listing of advanced options. The advanced option settings in role_<role>.ini override the ones in env_<environment>.ini

Using roles for ribbon selection with subscription configurations

Note:

Ribbon selection with subscription configurations is primarily meant to be configured by Trimble and reseller localization personnel.

With subscriptions, roles can be used for controlling which ribbon is shown for a certain role. The role-specific .ini files in the environments, such as role_Steel_Detailer.ini or role_Rebar_Detailer.ini, contain the advanced options XS_RIBBON_CONFIGURATION_DIAMOND, XS_RIBBON_CONFIGURATION_GRAPHITE, and XS_RIBBON_CONFIGURATION_CARBON. These advanced options define the ribbons for the specific role.

The advanced options must point to the configuration identifiers of the ribbon files, or to the configuration identifiers of the subscription configurations. It is not possible to make up new configuration identifiers.

If the advanced options are not set, Tekla Structures uses the default ribbons for each subscription configuration.

Example:

For the users who select the Precast Concrete Detailing role, you could have the following settings in the role_Precast_Detailer.ini file:


set XS_RIBBON_CONFIGURATION_CARBON=albl_up_Carbon
set XS_RIBBON_CONFIGURATION_GRAPHITE=albl_up_PC_Detailing
set XS_RIBBON_CONFIGURATION_DIAMOND=albl_up_PC_Detailing

For more examples, see your role_<role>.ini files used in your environment.

Tip:

Administrators who have their own environment and roles: for the role, such as timber detailer, you can create a folder for the ribbon files in ..\<environment>\Timber\Detailing\Ribbons, for example. Place the customized ribbon files in the folder, and include the folder in the XS_SYSTEM path definition for that specific role.