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 |
|
| 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:
|
| 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:
|
| TplEd |
Moved The previous content of this folder has been moved to \bin\applications\Tekla\Tools\TplEd. |
Addressing this location can be done using:
|
| 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.
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 |