Important Information
The use and importance of GUID references
The integration between Tekla Structural Designer and Autodesk Revit software is enabled by the use of GUID (Global Unique IDentifiers) references.
A GUID is a unique number that can be used as an identifier but should not be able to be replicated - with randomly generated GUIDs you should only be duplicating references once every 10-30 trillion GUIDs.
GUID references themselves are a 32 digit hexadecimal reference and are created by a complex algorithm, with the references written as part of a member's properties within the CXL file. We track members based on the GUID reference rather than member size, position, Revit element ID or any other method.
The GUID reference itself is automatically created by Tekla Structural Designer when an object is first inserted into the model. This happens 'behind the scenes' of the program interface and the user is never directly aware of the references.

Please note however, that Revit by default does not use GUID references. Revit instead uses Element ID references, which can be easily duplicated within differing models.
To help avoid any sort of duplication issues, the integration process will assign GUID references to all object instances when models are either imported into Revit or exported from Revit.
Although duplicate GUID references are largely avoided, they can be encountered when using workshared models and attempting to integrate Revit instances which are not owned or are borrowed by another user. See the section below Resolving duplicate GUID references for further information.
Please note that GUID references will be lost on exiting from Revit unless the model is saved first.
It is therefore vital that the Revit model is saved after performing an export to Tekla Structural Designer.
Failure to save will lose the GUID references on exiting the program and remove the ability to communicate any model changes with Tekla Structural Designer.
Resolving duplicate GUID references
The integration process will report where duplicate GUID references are detected.
To avoid errors from occurring, the older instance retains its GUID, the newer instance is then assigned a new GUID reference. Both the Revit model and the created .cxl file are then updated accordingly.
The integrator will also help identify the source of duplicates caused by copied instances in Revit.
Important note: Please ensure the Revit model is saved after the export process has been completed.
API - Application Program Interface
An API (Application Program Interface) controls the transfer between Tekla Structural Designer and Autodesk Revit. The API is a separate program that sits inside the Tekla Structural Designer Integrator for Autodesk Revit application, and is provided by Autodesk for the Trimble Solutions product development team to use.
The API is the governing factor between the two items of software and controls which object can be passed to and from the software packages. It can also limit what sort of change control can be performed with each category.
-
For example, floor category instances can be created or deleted using the API, but they cannot be updated in boundary shape. Therefore, if a floor instance changes boundary shape, the integrator is forced to delete the existing floor instance and create a new instance in its place.
Parameters transferred
Tekla Structural Designer will transfer the following parameters into Revit:-
| Analysis Result Parameters | ||
|---|---|---|
| Parameter Name | Description | Notes |
| Result_AxialMax | Maximum Axial Force | Applicable to Structural Framing Bracing members only when analysis results imported |
| Result_AxialMin | Minimum Axial Force | Applicable to Structural Framing Bracing members only when analysis results imported |
| Result_ColMajorMomentMax | Maximum Moment in Major Axis | Populated by Steel Structural Column Members when analysis results imported |
| Result_ColMajorMomentMin | Minimum Moment in Major Axis | Populated by Steel Structural Column Members when analysis results imported |
| Result_ColMajorShearMax | Maximum Shear in Major Axis | Populated by Steel Structural Column Members when analysis results imported |
| Result_ColMajorShearMin | Minimum Shear in Major Axis | Populated by Steel Structural Column Members when analysis results imported |
| Result_ColMinorMomentMax | Maximum Moment in Minor Axis | Populated by Steel Structural Column Members when analysis results imported |
| Result_ColMinorMomentMin | Minimum Moment in Minor Axis | Populated by Steel Structural Column Members when analysis results imported |
| Result_ColMinorShearMax | Maximum Shear in Minor Axis | Populated by Steel Structural Column Members when analysis results imported |
| Result_ColMinorShearMin | Minimum Shear in Minor Axis | Populated by Steel Structural Column Members when analysis results imported |
| Result_ColVShearMax | Maximum Vertical Shear | Populated by Steel Structural Column Members when analysis results imported |
| Result_ColVShearMin | Minimum Vertical Shear | Populated by Steel Structural Column Members when analysis results imported |
| Result_EndAxialMax | Maximum Positive Axial on Beam End | Populated by Steel Structural Framing Beam members without pinned ends when analysis results imported |
| Result_EndAxialMaxNeg | Maximum Negative Axial on Beam End | Populated by Steel Structural Framing Beam members without pinned ends when analysis results imported |
| Result_EndMomentMax | Maximum Positive Moment on Beam End | Populated by Steel Structural Framing Beam members without pinned ends when analysis results imported |
| Result_EndMomentMaxNeg | Maximum Negative Moment on Beam End | Populated by Steel Structural Framing Beam members without pinned ends when analysis results imported |
| Result_EndVShearMax | Maximum Positive Shear on Beam End | Populated by Steel Structural Framing Beam members when analysis results imported |
| Result_EndVShearMaxNeg | Maximum Negative Shear on Beam End | Populated by Steel Structural Framing Beam members without pinned ends when analysis results imported |
| Result_StartAxialMax | Maximum Positive Axial on Beam Start | Populated by Steel Structural Framing Beam members without pinned ends when analysis results imported |
| Result_StartAxialMaxNeg | Maximum Negative Axial on Beam Start | Populated by Steel Structural Framing Beam members without pinned ends when analysis results imported |
| Result_StartMomentMax | Maximum Positive Moment on Beam Start | Populated by Steel Structural Framing Beam members without pinned ends when analysis results imported |
| Result_StartMomentMaxNeg | Maximum Negative Moment on Beam Start | Populated by Steel Structural Framing Beam members without pinned ends when analysis results imported |
| Result_StartVShearMax | Maximum Positive Shear on Beam Start | Populated by Steel Structural Framing Beam members when analysis results imported |
| Result_StartVShearMaxNeg | Maximum Negative Shear on Beam Start | Populated by Steel Structural Framing Beam members without pinned ends when analysis results imported |
| Reinforced Concrete Specific Parameters | ||
|---|---|---|
| Parameter Name | Description | Notes |
| TSDI_RC_Bars | Designed rebar requirement in column | Populated by Concrete Structural Column objects |
| TSDI_RC_Bottom | Designed rebar requirement in bottom of beam | Populated by Concrete Structural Framing objects only |
| TSDI_RC_Cover | Designed rebar cover requirement | Populated by Concrete Structural Column and Structural Framing objects |
| TSDI_RC_Links | Designed rebar link requirement | Populated by Concrete Structural Column and Structural Framing objects - TSD English UK language |
| TSDI_RC_Side | Designed rebar requirement in side of beam | Populated by Concrete Structural Framing objects only |
| TSDI_RC_Span_Links | Designed rebar link requirement | Populated by Concrete Structural Framing objects only if option 'Separate Support and Span Regions' has been enabled |
| TSDI_RC_Span_Stirrups | Designed rebar stirrup requirement | Populated by Concrete Structural Framing objects only if option 'Separate Support and Span Regions' has been enabled |
| TSDI_RC_Stirrups | Designed rebar stirrup requirement | Populated by Concrete Structural Column and Structural Framing objects - TSD English US language |
| TSDI_RC_Supp_Links | Designed rebar link requirement | Populated by Concrete Structural Framing objects only if option 'Separate Support and Span Regions' has been enabled. |
| TSDI_RC_Supp_Region | Description of the Support Region extents | Populated by Concrete Structural Framing objects only if option 'Separate Support and Span Regions' has been enabled. |
| TSDI_RC_Supp_Stirrups | Designed rebar stirrup requirement | Populated by Concrete Structural Framing objects only if option 'Separate Support and Span Regions' has been enabled. |
| TSDI_RC_Top | Designed rebar requirement in top of beam | Populated by Concrete Structural Framing objects only |
| General Parameters | ||
|---|---|---|
| Parameter Name | Description | Notes |
| TSDI_Alias | Alias information | Blank parameter left for users own use |
| TSDI_Concrete_Fill | Is the member concrete filled? | Populated when concrete filled hollow section columns are integrated - Yes/No answer |
| TSDI_Design_Grp | Design Group assigned in TSD | Populated by all objects when used in TSD |
| TSDI_Detail_Grp | Detail Group assigned in TSD | Populated by Concrete Structural Framing and Structural Column members |
| TSDI_Dim | Steel decking profile gauge | Populated by Floor objects only |
| TSDI_EndConn | Connection type on end of member | Populated by Structural Framing and Structural Column members |
| TSDI_Fibre_Reinf | Fibre reinforcement details | Populated by Floor objects only |
| TSDI_Integration_Status | Integration Status of Object | Populated by all objects - New / Updated / Unchanged settings available |
| TSDI_Manufacturer | Steel decking manufacturer | Populated by Floor objects only |
| TSDI_Matl | Material grade assigned in TSD | Populated by all objects |
| TSDI_Not_Converted | Indicates any mapping problems | Populated by Structural Framing and Structural Column members |
| TSDI_Note | Applicable notes | Populated if UDA for Note is used |
| TSDI_Part_Mark | Part mark assigned in TSD | Populated by all objects |
| TSDI_Reference | Steel decking profile name | Populated by Floor objects only |
| TSDI_Size | Numerical decking data for US Slabs | Was populated by Floor objects only but is no longer used |
| TSDI_StartConn | Connection type on start of member | Populated by Structural Framing and Structural Column members |
| TSDI_Trans_Reinf | Transverse Reinforcement Requirements | Populated by compositely designed Structural Framing objects only |
| TSDI_Type | Member, Slab or Wall Type in TSD | Populated by all objects |