Skip to main content

Administrator's release notes: Reorganization of folders in the Tekla Structures installation folder

Tekla Structures 2022
2022
Tekla Structures

The folders in the Tekla Structures installation folder have been reorganized to enable easier packaging of the product and new methods of delivering content in the future.

The reorganization of the folders clarifies what content is delivered in the Tekla Structures installation package: installation content and your custom content have been separated from each other. The reorganization of plugins has improved the performance of opening or creating models.

Breaking changes

Tekla Structures 2022 includes some changes that are not compatible with previous versions. These changes require you to take action when you upgrade Tekla Structures.

Breaking change Action required

New folders have been created in the bin\plugins folder to organize plugins according to their type.

For more information, see Detailed changes in the bin\plugins folder.

Note: The bin\plugins is no longer supported for deploying custom plugins.

If you use the bin\plugins folder to deploy custom plugins, migrate your plugins to the TSEP system. Place extensibility plugins in \Environments\common\extensions.

Test and fix all extensions and macros that use plugins from the bin\plugins folder. We recommend using the XSBIN variable to represent the location of binaries.

The TplEd, dstv2dxf and symed tools have been moved from the bin folder to different folders.

For more information, see Detailed changes in the bin folder.

If you use hard-coded paths to the old locations, update the paths.

Test and fix all extensions and macros that use these tools. We recommend using the XSBIN variable to represent the location of binaries.

Deprecated advanced options

Tekla Structures 2022 is the last version that supports these advanced options.

Deprecated advanced option Replacement
XS_APPLICATIONS XS_APPLICATIONS_PATH
XS_DIR
  • Use XSDATADIR for the root location for the installation.
  • Use XSBIN for the location of binaries.
XS_MESSAGE XS_MESSAGES_PATH

Detailed changes in the XSDATADIR folder

Folders under the XSDATADIR folder have been moved or removed.

Folder Change Action required
nt

Removed

The previous content of this folder has been moved to other locations.

bin

Moved

Moved one level up from nt\bin to \bin.

messages

Moved

Translation files that are used throughout the application have been moved to bin\messages.

If required, a user-defined folder in the same location as the 2021 version can be created to keep user translation files. However, this location is marked as deprecated and might be removed in newer versions.

The official recommended location to place translations files is \Environments\common\Extensions\messages\. Additionally, this can be extended by setting the XS_MESSAGES_PATH advanced variable in TeklaStructures.ini

Default Locations: %XSBIN%\messages\; %XSBIN%\plugins\messages\; %XSDATADIR%environments\common\Extensions\messages\; %XSDATADIR%Extensions\messages\; %XSDATADIR%\messages\

applications

Moved

Tekla rpc components have been moved to bin\applications\rpc.

If required, a user defined folder in the same location as the 2021 version can be created to keep user components. However, this location is marked as deprecated and might be removed in newer versions.

The official recommended location to place users rpc components is \Environments\common\Extensions\applications\. Additionally, this can be extended by setting the XS_APPLICATIONS_PATH advanced variable in TeklaStructures.ini

Default Locations: XS_APPLICATIONS_PATH=%XSBIN%\applications\rpc; %XSDATADIR%environments\common\Extensions\applications\; %XSDATADIR%\applications\

ThirdPartyLicenses

Moved

Third party licenses have been moved to \bin\ThirdPartyLicenses.

These licenses files are relevant to the product itself. They do not necessarily cover external extensions that would be normally installed in the environment.

Detailed changes in the nt folder

The previous content of the nt folder has been moved to other locations and the nt folder has been removed.

The previous nt\bin folder has been moved one level up and new content has been added to the bin folder.

The following folders under the nt folder have also been moved to other locations:

Folder Change Action required
dstv2dxf Moved to \bin\applications\Tekla\Tools\dstv2dxf.

Environments that contain macros that call tekla_dstv2dxf.exe have been updated. If your environment uses this tool, update macros that have the following:

  • var binDir = string.Empty;
  • TeklaStructuresSettings.GetAdvancedOption("XSBIN", ref binDir);
  • var dstvFolder = Path.Combine(binDir, "applications", "Tekla", "Tools", "dstv2dxf");
License

Moved to \bin\License.

The Tekla Structures installer has been updated to register flex service from this location.

Detailed changes in the bin folder

Folder Change Action required
analysis

Removed

The previous content of this folder has been moved to the \bin folder to avoid dll duplication between this folder and same .dll files found in bin\.

The Tekla Structures installer has been updated to register COM files from the new location.

To manually register COM files, run the following command: \bin\register_analysis.bat.
cef

Moved

This folder has been moved to ExternalDeps\cef to reflect the component origin.

Teigha

Moved

This folder has been moved to ExternalDeps\Teigha to reflect the component origin.

dialogs

Removed

The previous content of this folder has been moved to the \bin folder.

This folder contained only Tekla.Structures.Dialog.dll. This file is now found in the same location as all assemblies that are registered to Global Assembly Cache (GAC).

modelsharing

Removed

The previous content of this folder has been moved to the \bin folder to enforce the single .dll version principle in the application.

referenceplugins

Moved

The previous content of this folder has been moved to the \bin\plugins\referenceplugins folder to reflect the nature of the folder.

Tekla Structures has been updated to use the new location.

symed

Moved

The previous content of this folder has been moved to \bin\applications\Tekla\Tools\symed.

Addressing this location can be done using:

  • var binDir = string.Empty;
  • TeklaStructuresSettings.GetAdvancedOption("XSBIN", ref binDir);
  • var symEdFolder = Path.Combine(binDir, "applications", "Tekla", "Tools", "symed");
TplEd

Moved

The previous content of this folder has been moved to \bin\applications\Tekla\Tools\TplEd.

Addressing this location can be done using:

  • var tplEdFolder = string.Empty;
  • TeklaStructuresSettings.GetAdvancedOption("XS_TPLED_DIRECTORY", ref tplEdFolder);

TrimbleConnectVisualizer

Moved

The previous content of this folder has been moved to \bin\applications\Tekla\Tools\TrimbleConnectVisualize.

Tekla Structures has been updated to use the new location.

Detailed changes in the bin\plugins folder

The content of the bin\plugins folder has been heavily reorganized to provide better architectural separation between plugins and to improve loading times.

This change also ensures that your custom content and installation content is kept separate, so that custom content is preserved when you upgrade Tekla Structures.

Note: The bin\plugins folder is no longer supported for deploying custom plugins.

If you use the bin\plugins folder to deploy custom plugins, migrate your plugins to the TSEP system.

Place extensibility plugins in \Environments\common\extensions.

The following new folders have been created to organize plugins according to the extensibility type:

Folder Content
CustomProperties Custom properties plugins
Interaction Direct Manipulation features
Macros Akit macros
Messages Translation files for plugins
Presentation Custom Presentation plugins
referenceplugins Reference plugins
Tekla Dialogs and Tekla Open API Plugins
Submit

Table of Contents