Create start-up shortcuts with customized initializations

Tekla Structures
2020
Tekla Structures

Create start-up shortcuts with customized initializations

You can use shortcuts to start teklastructures.exe with customized initializations. You can use this functionality to create shortcuts for different purposes, for example, to have customized setup files depending on the client you are working for in a project. The Tekla Structures installation automatically creates shortcuts for the selected environments.

Note:

We recommend that only administrators create the customization and the necessary shortcuts. Otherwise, your settings may differ from the settings defined for your firm, or for the particular project you are working for.

Create a start-up shortcut with customized initialization

  1. Open the user.ini file using any standard text editor.
  2. Save the file with a new name, for example, customer.ini or project.ini.
  3. Modify the file by adding the required settings.
  4. Save the modified initialization file.
  5. Open the Windows Start menu and select All Programs > Tekla Structures <version>.
  6. Right-click Tekla Structures <version> and select Copy.
  7. Paste the shortcut to your desktop.
  8. Select the shortcut, right-click and select Properties.
  9. Modify the Target of the shortcut by adding the required project initialization information to it.

    First enter the path to the current teklastructures.exe, then the desired parameters.

    Use the quotation marks (") in the path to avoid possible problems if the path contains spaces. If you have installed Tekla Structures to a path that does not contain spaces, there will be no problems even if you remove the quotations marks, for example, C:\TeklaStructures\. If you have installed Tekla Structures to a path that contains spaces, the quotation marks are needed, for example, C:\Program Files\Tekla Structures\.

    The maximum length of a shortcut is 256 characters. If you have problems with the length, you can call all other necessary initialization files from your customized initialization file instead of adding them to the shortcut.

  10. To override the settings defined in the shortcuts, use the parameter -i <initialization_file> in the user.ini and option.ini files.

Available parameters in shortcuts

The table below lists the parameters you can use in the start-up shortcuts.

The parameters can be used in combinations. You can set the parameters to automatically bypass the Tekla Structures - Choose setup dialog box, open a model and run a macro, for example.

Parameter Description

-I <ini_file_path>

The given .ini file is loaded before the environment .ini files. This parameter can be specified multiple times.

This parameter can be used to bypass the Tekla Structures - Choose setup dialog (the login dialog).

Example:

"C:\Program Files\Tekla Structures\<version>\nt\bin\TeklaStructures.exe" -I "C:\ProgramData\Trimble\Tekla Structures\<version>\Environments\uk\Bypass.ini"

-i <ini_file_path>

The given .ini file is loaded after the role .ini files. This parameter can be specified multiple times.

Example:

"C:\Program Files\Tekla Structures\<version>\nt\bin\TeklaStructures.exe" -i "C:\TeklaStructures\MySettings.ini"
To open an existing model

<model_path>

The given model is opened after start-up.

Example:

"C:\Program Files\Tekla Structures\<version>\nt\bin\TeklaStructures.exe" "C:\TeklaStructuresModels\My model"

To open an existing, autosaved model

<model_path> /autosaved

The given autosaved model is opened after start-up.

Example:

"C:\Program Files\Tekla Structures\<version>\nt\bin\TeklaStructures.exe""C:\TeklaStructuresModels\My model" /autosaved

To create a new model without a model template

/create:<model_path>

A new model is created after start-up.

Example:

"C:\Program Files\Tekla Structures\<version>\nt\bin\TeklaStructures.exe"/create:"C:\TeklaStructuresModels\My model"

To create a new model using a model template

/create:<model_path> /modelTemplate:<template_name>

A new model using a model template is created after start-up.

Example:

"C:\Program Files\Tekla Structures\<version>\nt\bin\TeklaStructures.exe"/create:"C:\TeklaStructuresModels\My model" /modelTemplate:"Cast-in-Place"

To create a new multi-user model

/create:<model_path> /server:<server_name>

A new multi-user model is created after start-up.

Example:

"C:\Program Files\Tekla Structures\<version>\nt\bin\TeklaStructures.exe"/create:"C:\TeklaStructuresModels\My model" /server:"my-server:1234"

To run a macro after start-up

-m <macro_file_path>

The given macro is executed after start-up.

The example below opens Tekla Structures, sets the environment, role and configuration from the Bypass.ini file, opens the model, and reads in and saves the model by using the Example Macro: Model Sharing Read in and Save from the BIM Publisher tool that is available in Tekla Warehouse.

"C:\Program Files\Tekla Structures\<version>\nt\bin\TeklaStructures.exe" -I "C:\ProgramData\Trimble\Tekla Structures\<version>\Environments\<environment>\Bypass.ini" "C:\TeklaStructuresModels\<model>" -m "C:\ReadInSave2016.cs"

Example of an initialization file

Below is an example of a customized project initialization file that calls other initialization files.

MyProject.ini
//The project is based on the default UK settings
call C:\ProgramData\Trimble\Tekla Structures\2019.0\Environments\uk\env_UK.ini
//..but our company policy requires these changes
call c:\CompanySettings\OurPolicy.ini
//..and the fabricator requires something
call c:\Fabricators\Fabricator1.ini
//..and then we let users to make some changes (color etc.)
call c:\Users\user_%USERNAME%.ini

The project shortcut for this initialization file:

"C:\Program Files\Tekla Structures\<version>\nt\bin\TeklaStructures.exe" -i "\\MyServer\MyProject\MyProject.ini" "\\MyServer\MyProject\MyModel\"
Var det här användbart?
Föregående
Nästa