Important Information

Tekla Structural Designer
Modificado: 14 Ago 2025
Not version-specific
Tekla Structural Designer

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
Esta informação foi útil?
Anterior
Seguinte