Passar para o conteúdo principal

Create project settings

Modified: 22 Maio 2026 Tekla Structures - Not version-specific
Not version-specific
Tekla Structures

Project settings are a collection of customized settings that let you distribute an environment to users who start Tekla Structures using Tekla Launcher. Project settings can be based on an existing official Tekla Structures environment with customizations, or fully customized with collections and dependencies.

Create project settings

Create project settings to define and manage configurations for your projects.

Before you begin, we recommend that you create one or more collections to organize the content in the project settings.

  1. Sign in to the Project Settings Management Console.
  2. In the navigation pane on the left, click the Project settings sandbox icon.
  3. Click Add new, then select Project settings.
  4. Enter a unique name and a description.
  5. Upload a thumbnail image.
  6. To include environments as dependencies, add them to the pinned environments.
    1. Click Add in the Pinned Environments section.
    2. Select one or more environments.
    3. Click Add.
  7. To include collections as dependencies, add them to the collection dependencies.
    1. Click Add in the Collection dependencies section.
    2. Select one or more collections.

      The reading order of the settings in Tekla Structures does not depend on the order of the collection dependencies

    3. Click Add
  8. Click Create.

Create private collections in project settings

You can create private collections inside project setting to organize the content in the project settings.

Private collections in project settings can only be used in the project settings where they are created. To create reusable collections instead, create a collection or a company collection.

  1. Sign in to the Project Settings Management Console.
  2. In the navigation pane on the left, click the Project settings sandbox icon.
  3. Open the project settings in which you want to create a private collection.
  4. Click Add collection.
  5. Add content to categories in the collection manually or use AI to add content to categories automatically.
  6. Drag and drop the collections to change the order.

    The order of the collections in the editor affects the order in which the files are loaded in Tekla Structures

Add TSEP extensions to project settings

You can search for and add extensions from Tekla Warehouse or add extensions manually.

  1. Sign in to the Project Settings Management Console.
  2. In the navigation pane on the left, click the Project settings sandbox icon.
  3. Open the project settings to which you want to add TSEP extensions.
  4. In the TSEP extensions section, click the + icon.
  5. Select one or more TSEP extensions in one of these ways:
    • Search for an extension in Tekla Warehouse, then click the Add to installation icon on the extension information card.
    • Manually enter the details of the extension, then click Add.
  6. To add the selected TSEP extensions, click Add.

Customize settings inherited from a pinned environment

If a fully managed project settings is pinned, users can customize what settings are included or excluded.

  1. Sign in to the Project Settings Management Console.
  2. In the navigation pane on the left, click the Project settings sandbox icon.
  3. Open the project settings in which you want to customize settings inherited from a pinned environment.
  4. In the Derived from project settings section, click the Edit icon.

    The Inherited dependencies pane opens.

  5. Click the eye icon to include or exclude settings.

Add roles to project settings

You can use roles in project settings to enable or disable specific settings within the project to provide a customized experience for different end users.

  1. Sign in to the Project Settings Management Console.
  2. In the navigation pane on the left, click the Project settings sandbox icon.
  3. Open the project settings to which you want to add a role.
  4. In the Roles section, click the + icon to add a role.
  5. Enter a name for the role, select an icon for the role, then click Add.
  6. Expand the roles section and click the role.

    A role customization panel with a dependency tree opens.

  7. In the dependency tree, click the eye icon to include or exclude settings.
  8. To add advanced options for the role, follow these steps:
    1. Click the + icon in the Advanced options section.
    2. Enter the name and value of the advanced option.
    3. Click Apply.

Test project settings in the project settings sandbox

To ensure that your project settings work as expected, test the project settings in the project settings sandbox before you publish them.

To test project settings, Tekla Launcher must be running on the same computer where you use the Project Settings Management Console.

  1. Start Tekla Launcher.
  2. Sign in to the Project Settings Management Console.
  3. In the navigation pane on the left, click the Project settings sandbox icon.
  4. Open the project settings that you want to test.
  5. Click Test.
  6. Select the version of Tekla Structures in which you want to test your project settings.

    Your project settings are tested in the selected version. If there are errors, an error message is shown and information about the errors is written to a log file on the local computer.

  7. If there are errors, click Open log file in Tekla Launcher to view the log file.

    The log file opens in your default text editor.

  8. Check the log file for errors, then edit your project settings to fix the errors.

When your project settings works as expected, publish the project settings.

Publish project settings

  1. Sign in to the Project Settings Management Console.
  2. In the navigation pane on the left, click the Project settings sandbox icon.
  3. Open the project settings that you want to publish.
  4. Click Publish.
  5. Enter the publishing information.
    • Version: Enter a version number in semantic versioning 2.0 format. For example, 1.0.0 for the first version of the collection.

      This version number is used to keep track of changes to the content. We do not recommend using a Tekla Structures version number in the version number of the content.

    • Minimum supported Tekla Structures version: Enter the minimum version of Tekla Structures that is compatible with this environment. Only versions 2025 or later are supported.

    • Default storage location: To change the region where data related to this collection is store, select a location.

      By default, the default storage location that you selected when you set up your user information is used.

    • Description of the published changes: Enter a short description of the changes in the version that you are publishing.

  6. Click Publish.

Publish a classic environment in the Project Settings Management Console

A classic environment is a package that contains uncategorized settings used by Tekla Structures. A classic environment can be an official Tekla Structures environment or your own custom environment.

Classic environments make the transition to using the Project Settings Management Console easier. You can upload an existing classic environment to the Project Settings Management Console to distribute the environment and extensions to users who start Tekla Structures using Tekla Launcher.

  1. Sign in to the Project Settings Management Console.
  2. In the navigation pane on the left, click the Project settings sandbox icon.
  3. Click Add new, then select Publish classic environment.
  4. In the Publish classic environment dialog, fill in the details of the environment:
    • Name: Enter a unique name. The name is used to generate an ID for the classic environment.

    • Description: Enter a description of the classic environment.

    • Version: Enter a version number in semantic versioning 2.0 format. For example, 1.0.0 for the first version of the environment.

      This version number is used to keep track of changes to the content. We do not recommend using a Tekla Structures version number in the version number of the content.

    • Minimum supported Tekla Structures version: Enter the minimum version of Tekla Structures that is compatible with this environment. Only versions 2025 or later are supported.

    • Extract to this folder: Enter the name of the folder where the environment will be extracted on users' computers. The folder name must match the folder defined by the %XSDATADIR% for the environment. To use the environment ID as the folder name, leave this option empty.
    • Upload a thumbnail image for the environment.

  5. To change the region where data related to this environment is stored, select a location from the Default storage location list.

    By default, the default storage location that you selected when you set up your user information is used.

  6. Click Next.
  7. Drag and drop the folder that contains the environment files, or browse for the folder.
  8. Click Next.
  9. To start the upload, click Upload.

The files from the selected folder are uploaded. Depending on the number of files, the upload can take several minutes. When the upload is finished, the environment is visible in the Project settings view of the Project Settings Management Console.

Enviar

Table of Contents