Load and Unload Exchanges

This topic details how to share data using Autodesk Data Exchange Connector for Tekla. Following are the steps to load an exchange in Tekla Active Document.

Load an Exchange

The load feature allows you to view and load an exchange from Autodesk Docs to your connector.

1. Click Data Exchange under the DATA EXCHANGE tab.

2. Click Load exchange.

   

3. You will view a list of the exchanges you can access in Autodesk Docs. You can also switch between different projects from the project drop-down list.

   

4. Select your project, select an exchange, and click Load.

   Important: You can preview the exchange before loading with the Preview button.

5. Once you've selected the exchange to load, you click on the "Load" dropdown to choose Advanced load options.

6. Select the required option from Exchange Load Option.

   • Single Reference Model: Loads the entire exchange as a single reference model. Faster to load, but does not include individual object attributes.
   • Individual Reference Models: Loads each object as an individual reference model. Includes object attributes, but takes more time to load.
   • Individual Objects as Items: It is a recommended option. Loads each object as an Item. Faster to load and includes attributes.

   

7. After selecting the load option, you will be prompted to choose where to place the exchange in Tekla. In the Exchange Placement window, you have four options:

   • Load Exchange at Tekla Origin: The exchange will be placed at the model’s origin (0,0,0).
   • Load Exchange at specific Coordinates: Manually enter the X, Y, and Z coordinates to place the exchange at a specific location.
   • Pick point for Exchange Placement: Select this option to place the exchange interactively by clicking on a location within the model using your cursor.
   • Relocate Exchange: Select a reference point on the exchange and specify where you want to move the exchange.

   

8. Choose the required option and click Load.

9. You can select Group to Category Mapping and Include Parameter while the exchange loading is in process.

   

10. If the model contains unsupported or failed elements, they’re now automatically captured in a detailed HTML report. After the workflow finishes, the interface shows a notification with a clickable link to the report. The progress bar shows the progress.

11. The exchange will be listed in the connector interface after the load is completed.

    

    Important: In loading an exchange from Dynamo to Tekla, the exchanges are created for native objects from Dynamo. When you load that exchange in Tekla, it adds parameters under the General category.

    The workflow involves the following steps:

    1. Creating or defining parameters in Dynamo and creating an exchange.
    2. Loading an exchange in Tekla.
    3. Parameters for Dynamo's natively created objects will be added to the General category in Tekla.

Load the Latest Version of an Exchange

When a newer version of an exchange is available in Autodesk Docs, you can use the Load the latest feature in the connector to refresh, view, and load the latest version. Additionally, the Push Events feature automatically notifies users when one or more exchanges in the list have new versions available. A blue dot appears in the interface to indicate these updates.

1. Click refresh icon to check if any of the exchanges you have loaded to the connector have newer versions available, in Autodesk Docs. If an exchange has the latest versions available, then it shows a blue dot.

2. Select the relevant exchange which needs to be updated from the list.

3. Click More menu and click Load the latest from the drop-down list.

   

4. You can select Group to Category Mapping and include Parameter while the loading is in process.

   

5. If the model contains unsupported or failed elements, they’re now automatically captured in a detailed HTML report. After the workflow finishes, the interface shows a notification with a clickable link to the report. The progress bar shows the progress.

6. The exchange will update to the latest version, with the latest changes. (for example, V1 to V2).

   

Unload an Exchange

You can unload the selected exchange and remove it from the connector interface. While this feature allows you to remove the exchange from the connector interface, it does not remove the exchange from Autodesk Docs or the associated data from the Tekla model. This means that although the exchanges may not be visible in the interface, they are still available in Autodesk Docs and Tekla Structures software.

1. Select an exchange from the connector interface list.

2. Click More menu and click Unload Exchange from the drop-down list.

3. A warning message will appear to inform you that removing an exchange will eliminate all its associated elements from your file. Click Unload to confirm.

   

   It unloads the exchange and removes it from interface.

Unload a Deleted Exchange

You can unload or remove exchanges from the connector interface when the corresponding exchanges are deleted and no longer available in Autodesk Docs.

1. Open Tekla model which references the deleted exchange in Autodesk Docs.

2. Open the connector interface and click the refresh icon.

3. A message appears to confirm if you want to unload the deleted exchange from Tekla Structures software.

4. Select the exchange from the list and click Unload. It removes the deleted exchange from the interface.

   Important: Select Cancel to retain the Tekla objects of an exchange.