Export and import tag references

The Export option enables you to export tag references of the required device or node to a CSV file. It allows you to copy tag references and edit the tag names in bulk or individually. You can import this CSV file using the Import option in the Device Items tab of the required Broker Group.

Export tag references of the selected object to a CSV file

1. In the OCMC, select the required MQTT Broker node and then select the MQTT Browser tab.

2. In the MQTT Browser window, select anywhere on the line Click here to export tag references of selected object to a file.

   

3. If required, open the CSV file and make the tag name changes.

4. Save and Close the CSV file.

Import tag references from a CSV file

5. In the OCMC, select the required MQTT Group node and then select the Device Items tab.

6. In the Device Items window, right-click anywhere in the table, and select Import.

   The Open dialog box appears. It defaults to the .csv file extension within the current-system-configured default directory.

7. Browse and select the specific CSV file you want to import, then select OK for confirmation.

8. Once the import is complete, you can see the tags and the respective tag references. The left column is the sample alias name and the right column is the item reference.

9. Select the Save icon to save the changes.

Note: When you select another part of the Communication Driver tree hierarchy, you are prompted to save the modifications to the configuration set.

During the imported file processing:

• New item references will be added based on unique names.

• If there are duplicate names, you can replace the existing entry with the new entry or ignore the new entry.

When the MQTT Communication Driver is running and a client requests item information, the imported configured items will show up under the controller hierarchy node.

Other ways to export tag references

• You can drag a required node from the hierarchy and drop it to the Excel file. All the tags below the selected node in the hierarchy are exported to the Excel file.

• You can also use the system copy buffer to export the tag references. Right-click on the required hierarchy to copy the tag references under the selected hierarchy. You can then go to the IO Mapping table in the IDE and paste the copied tag references by pressing Ctrl+V.