Tekla Structures 2019 US environments Release Notes

Last updated March 13, 2019 by Tekla Support US tekla.support.us@trimble.com

Software version: 
United States (Imperial)
United States (Metric)

Tekla Structures 2019 US environments Release Notes

Table of Contents

  1. Folder Structure Reorganization
  2. Common to all US Roles
  3. Steel Detailing Role
  4. Partner Developer Notes
  5. Administrator Release Notes

1. Folder Structure Reorganization

1.1 Environment folders

We have modified the environment to now contain both US Imperial and US Metric within one environment. See image below for reference, the environments have now been combined into one environment called USA.

Within the USA environment, we have 3 main folders, one which contains shared files between both US Imperial and US Metric called “Common” and then specific folders for settings that are different between US Imperial and US Metric. These folders are called Imperial and Metric.

1.2 Specific Environment folder structure breakdown

Within each main folder (i.e. common, imperial, and metric) there is a breakdown of folders. In the old environment we had a folder called “us_roles” and now the comparable folder would be the main folders. For example, within “Common” we have the breakdown below. These are not all files but specific files to a role such as precast, steel, etc.. Also here is "General" which compares to the older "system" folder and now contains General items all roles share within common, imperial, and metric.

If we start to look in these folders we have new folders here also. The reorganization includes renaming files and spreading out folders into more appropriately named folders for the function of the settings within. For example,
before we had an "inp" folder and now we have "Catalogs" and "UserDefined" to contain files that "inp" used to contain. 

If we look at this on a larger scale, files that were in metric and imperial but were common (meaning the binary file is no different) are now placed in usa\common. Which means files in the older version in folders like system, profil, template, etc... have some settings in usa\common\general and some in usa\imperial\general. 

1.3 Installing environments in version 2019

After you run the exe for the environment you will need to launch Tekla Structures to complete the installation process. Upon starting Tekla Structures for the first time after you run the exe the Tekla Structures File Dispatcher will launch and finish installing the environment. Please allow this to run so the environment will install, do not hit cancel on the screen show below or else the environment will not be completely installed. 

1.4 Startup login screen

Now that we have combined the environments you will now see Role files for each environment. There are separators also to help distinguish between Imperial and Metric roles. 

2. Common to all us roles

2.1 Environment ini updated

New Advanced optionssettings used to customize Tekla Structures for specific companies, standards, users, or user groups

In Tekla Structures, advanced options are settings that are used, for example, in a specific project or geographical area, or by a specific company.

In Tekla Structures, advanced options usually begin with the initials XS and are followed by the name of the function, for example XS_BACKGROUND_COLOR.

added for new folder structure. These options link to XS_SYSTEM, therefore any directory added to these options will string with XS_SYSTEM when Tekla starts. 

  • XS_COMMON_CIPcast unit type where the concrete is formed, poured, and cured in its final position


Role ini files such as Role_Imperial_Steel_detailing.ini now have added directories for XS_MACROsaved series of actions that includes instructions for a program

Macros are located in the applications and components catalog. They are recorded or created manually and stored as .cs file in a folder defined with the advanced option XS_MACRO_DIRECTORY.

Macros can, for example, be used for creating drawings or reports.

Macros are sometimes used to run an application.

_DIRECTORY. This directory now reads %XS_MACRO_DIRECTORY%;%XSDATADIR%environments\usa\Common\General\Macros\ 

%XS_MACRO_DIRECTORY% now equals %XSDATADIR%environments\common\macros\

XS_ATTRIBUTE_FILE_EXCLUDE now also includes exclusions for common/system settings:
assembly_back_view;assembly_bottom_view;assembly_undeformed_view;custom_object_editor_perspectiveview projection that displays objects in a model view from a particular standpoint so that distant objects appear smaller than close ones, as do text and points

The user can zoom, rotate, pan, or fly through the model objects.

_view;part_undeformed_view;A_Assembly;B_Bolt;B_Studbolt element that represents a metal rod or pin that is used to transfer loads

Studs and other bolt elements are listed in the bolt catalog.

A stud can be secured with two or more nuts and have threading at both ends, or it can be welded to steel parts, for example.

A stud is part of the bolt assembly.

;C_Cast;D_Drawing;I_IFCfile format commonly used in BIM that facilitates software interoperability

IFC is an open specification developed by the IAI (International Alliance for Interoperability).

Model can be exported into an IFC file.


2.2 Catalogs

A few profile catalogcatalog that displays profiles and information on the profiles

In addition to the available profiles in the respective Tekla Structures environment, the user can add fixed or parametric user-defined profiles to the profile catalog. It is also possible to import profiles to the profile catalog.

changes have been made

  • Irregular beams added to work with Geometry Detailing Strip component.

  • Folded Plate(1) part that represents a flat structure

    (1) In some contexts, for example in analysis, the term plate object may be used to refer to plates.

    (2) plate that represents a steel structure

    (2) Plate is mainly used as a connection piece or as a floor plate.

    profile FLDPL has been removed

2.3 Components

Framing Components have been removed and Partial Pour Stop component was removed. These components are still available in the system location (i.e. environments/usa/Imperial/CustomComponents) and are labeled WoodConnectors.UEL and Pourstop-Partial.UEL. 

2.4 Extensions

In version 2019 we will now be including a set of predefined extensions with the environment installation. Please note that these extensions are updated each environment release, if an update to an extension comes before a new environment you can download the update by clicking on the tool below that you want to update and download the updated installer directly from the warehouse. These extensions include the following:

3. Steel Detailing Role

3.1   Steel Detailing Role

The Steel Detailing Role was created to include only the items needed to use Tekla Structures for Steel Detailing and Steel Fabrication. The Role_Imperial_Steel_Detailing.ini (Role_Metric_Steel_Detailing.ini) file located in the usa folders runs after the env_US.ini file is run.

3.2   Drawings

Assembly drawings out of the box will now default to 11x17 layout sizes. Other sizes are still available. 

4. Partner Developer Notes

Environment changes for US Imperial and US Metric in version 2019 have the potential to affect extensions and their installers. These changes include an extensive restructuring of the folders into a single USA environment (see the section 1.1 above).  Extensions might utilize these folders for supporting files either supplied with the environments or by the extension installer.

This primary difference is that the usimp and usmet folders are being replaced by a single USA folder and that the folders do not correspond old to new. This affects:

  • extension installers that are looking to place their files in the old environment location such as TSEPs that indicate future compatibility through their manifest files;
  • extensions utilizing hard coded paths for accessing supporting files within the US environments.
  • Custom roles that might read in existing files from old usimp or usmet environment directories

Another difference is that the new USA environment has been set up to read from the Common environmentTekla Structures environment that forms a basis for other environments

The common environment is included in the software installation and includes the global settings, macros, symbols, and fonts, for example. The common environment and global settings form the basis for all other environments.

that installs with Tekla Structures. In previous versions, needed content from this environment was replicated within the US environments for various reasons. Since the introduction of the TSEP delivery, all extensions have been installed to this common environment. Released extensions that took this into account and also supplied their support files within this common environment should not be affected.  They may still generate an error within the installation log for not being able to place files into the now non-existent usimp and/or usmet folders.

Additionally, the new USA environment has been set up to read from the same macro directory for both imperial and metric.  This allows for one copy of the applicationpart of Tekla Structures functionality that is developed in order to extend the capability of Tekla Structures but that is not included in the Tekla Structures installation

starting macros to be sufficient for the extension to be started from the Applications & Components Cataloguser interface for displaying or modifying information in categorized lists

For example, profile catalog and shape catalog are catalogs.

and/or ribbon.

New locations now read are environments\common\macros and evironments\common\system. 

5. Administrator Release Notes

For changes in all evironments related to components, drawings, etc... Please see the administrator release notes here You can also find full release notes for 2019 here 

Content rating: 
Average page rating: 2.7 (3 votes)
Refresh page after voting to show updated result.