Tekla Structures 2024 Open API Release Notes

TEKLA.STRUCTURES.CATALOGS 2024.0.0.0 ASSEMBLY

• New GetMetadata(), SetMetadata(), GetAllMetadataKeys(), and DeleteMetadata() methods have been added to the ShapeItem class for manipulating and enumerating metadata of a shape item in shape catalog.
  TTSD-59395

TEKLA.STRUCTURES.DIALOG 2024.0.0.0 ASSEMBLY

• The width of the Cancel button in the WpfOkApplyModifyGetOnOffCancel user control was changed from fixed to scalable so translated text is shown correctly.
  TTSD-56251
• When you set a HelpUrl in a dialog that uses the WpfSaveLoad control, a browser with the correct page opens when a user clicks the Help button.
  TTSD-56511

TEKLA.STRUCTURES.PLUGINS.DIRECTMANIPULATION 2024.0.0.0 ASSEMBLY

• Previously, the plane was sometimes incorrect when using direct modification in the Open API. This issue has now been fixed.
  TTSD-53505
• Plugins that use the Direct Modification platform had a problem in snapping to reference model object edges with certain reference models. The problem is now fixed.
  TTSD-59163

TEKLA.STRUCTURES.DRAWINGS 2024.0.0.0. ASSEMBLY

• Loading an attribute file with a value change for 'show numeric value' is now supported for straight dimension sets.
  TTSD-50550
• Previously, it was not possible to properly modify a drawing view that was created using the Open API. This issue has now been fixed.
  TTSD-57219
• API tools can now read information from the model database while Tekla Structures executes a drawing cloning operation.
  TTSD-58768
• It is now possible to use true RGB custom colors for drawings in the ViewAttributes, SymbolElement, and FontAttributes Tekla Open API classes. We strongly recommend that developers use the new colors instead of the old color properties.
  TTSD-60332
• The SymbolAttributes and BoltAttributes Tekla Open API classes now have new TrueColor properties for using the full user-defined RGB colors in drawings.
  TTSD-60374
• The EmbeddedObjectFrame, Frame, and DimensionSetBaseAttributes Tekla Open API classes now have new TrueColor properties that can be used for setting the object color to a custom RGB value. Use of the old color properties is still possible, but we strongly recommend that developers use the new colors. The old color properties should be considered obsolete.
  TTSD-60563

The github repository of Tekla Structures Open API contains in the 2024 branch a new example showing the new true color properties: 

https://github.com/TrimbleSolutionsCorporation/TSOpenAPIExamples/tree/2024/Drawings/Applications/DrawingPartColorExample

TEKLA.STRUCTURES.MODEL 2024.0.0.0. ASSEMBLY

• Previously, rebar solid was calculated only once when using the Open API. Now, the GetSolid() method returns the correct values after rebars are modified.
  TTSD-52712
• The GetRebarComplexGeometries function now returns a polyline if the simplified parameter is set to NONE. Previously, it returned a polycurve when there were curved rebar set leg surfaces. The old version of GetRebarComplexGeometries, which does not have a simplified parameter, has been deprecated.
  TTSD-56795
• The ViewHandler class has a new GetActiveView() method to fetch the currently active MDI child window.
  TTSD-57868
• A new UndoClicked event has been added to the Events class in the Tekla.Structures.Model namespace. The event is sent when a user clicks Undo in the user interface.
  TTSD-58261
• Shape UDA or metadata can now be called using the GetReportProperty() method from the model object. The method must be prefixed with PROFILE. or SHAPE. For example: part.GetReportProperty("SHAPE.Material", ref tempStr) or part.GetReportProperty("PROFILE.Material", ref tempStr).
  TTSD-58367
• A new CreateShapeFromGeometry method has been added to create a new entry in the shape catalog from the geometry of an existing part.
  TTSD-60697

Tekla Open API 2024 libraries are now compatible with .NET Standard 2.0

Tekla Structures APIs have now been modernized to be compatible with .NET standard 2.0. Tekla Structures and Tekla Open API are now built using .NET Framework 4.8. The modernization work also removed COM support from Open API assemblies. Thanks to this change, applications now can communicate with TeklaStructures internal code at leats two times faster than before, improving the performance of this type of tools.

Open API assemblies are no longer registered to the Global Assembly Cache (GAC). GAC was previously used when an application communicated with Tekla Structures. More information about this topic is available in a separate page: Gacless Tekla Structures.

We recommend that you test at least some of your existing extensions with Tekla Structures 2024 to check everything works as expected. If the current extension version works, TSEP files in Tekla Warehouse do not need to be recreated.

While it was previously possible to target older .NET Framework versions when using Tekla Open API libraries, .NET Framework 4.8 or newer is now required to compile tools using Tekla Open API 2024 libraries. .NET 6, 7, and 8 are not yet supported to compile tools.