Automatically Create and Map New Properties Created in the Tool - Integration - Update 44 - Help - Hexagon

This procedure is for tools that have metadata adapters. For more information, see Before You Begin Mapping for Tools with Metadata Adapters.

Create the Enumerated List, List Entries, and Property in the Authoring Tool

• Use the appropriate authoring tool software to add new enumerated list, enumerated list entries, and property that uses the enumerated list to the authoring tool metadata database. Be sure to set the data type to string for a string property.

  For example, for Smart P&ID or Smart Electrical, create a new select list, add entries to the select list, and then create a property associated with the new select list in the appropriate database table in Data Dictionary Manager. The new property should have a data type of select list and a relationship to the select list that you created.

  Terminology for enumerated lists differs from tool-to-tool. Some authoring tools call enumerated lists select lists, picklists, codelists, or lookup tables. For more information, see the documentation for the authoring tool for which you want to add metadata.

Load the Tool Map Schema and Open a Map Class Definition

1. In the Desktop Client, set your scope for the applicable plant, and then find the CMF file.

2. Right-click the CMF file, and then select Edit > Check Out to display the Check Out dialog.

3. Select OK.

4. In the New Items window, right-click the new version of the CMF file, and select Launch Schema Editor.

5. On the Set Active Configurations dialog, select the schema version that you want to view.For more options, select Advanced.

6. Select OK to set the configuration.

• The CMF file must be checked in to SmartPlant Foundation before users can publish from an authoring tool.

• By default, changes to the SmartPlant Schema are written to all versions managed by the CMF file. Although you can choose to write changes to only selected versions, we do not recommend doing so.

  If you choose to view one version of the schema (Specify configurations to display window) but write changes to all versions (Set Configurations for new objects window), an information window appears when you select OK, indicating that you will be prompted with every change to the schema to confirm that you want to write the changes to all versions. Select OK to continue.

1. In the Schema Editor, synchronize the authoring tool map schema for which you want to define mapping. For more information, see Synchronize Tool Metadata with the Tool Map Schema.

   The new property, enumerated list, and list entries that you added in the authoring tool appear in the Synchronization dialog box to be added to the tool map schema file. As you can see in the following graphic, if you add a property to the Plant Item table in Data Dictionary Manager for Smart P&ID, multiple map classes inherit that property, and therefore, multiple map classes are updated in the tool map schema during synchronize.

   

2. In the Map Environment, expand the Tool node, and then expand the node for the appropriate authoring tool.

3. Under the authoring tool node in the tree view, expand Loaded Map Schemas and the <Authoring Tool> Tool Schema node to display contents of the authoring tool map schema.

   

Automatically Create and Map the New Property

1. Click the Publish or Retrieve tab in the Edit Map Class Definition dialog box.

2. Under Unmapped application properties, select the tool properties that you want to create in the SmartPlant schema and map, and then click Auto-create on the toolbar.

   

3. In the Create and Map Properties dialog box, review the auto creation and mapping information, make any necessary changes to the displayed information, and click OK to create and map the properties.

   

4. Click OK in the Edit Map Class Definition dialog box to save your changes.