Create Mapping for Enumerating Lists in Map Environment - Integration - Update 44 - Help - Hexagon

The following topic provides an example of defining mapping for an enumerated list to multiple tool schemas from the Schema Editor.

1. In the Schema Editor, open the tool map schemas that you want to view. For more information, see Open a Tool Map Schema.

   

   • If you have checked the SmartPlant schema CMF file out of the Desktop Client, launched the Schema Editor, synchronized the tool map schema and the tool metadata, and are working with the tool's metadata adapter to define mapping, the authoring tool map schema is already open in the Schema Editor.

   • Before you can open a tool map schema, you must open a schema file.

     You can also open a file configuration or session file that contains the SmartPlant schema and the tool map schema files that you want to view.

   • The tool map schema file for each authoring tool is installed with the authoring tool. For more information about authoring tool map files and their locations, see your authoring tool documentation.

2. Click Tools > Tool Schema > Integrated Map Environment.

   The Integrated Map Environment contains a left and right panel. The left panel contains the integration schema and all tool map schemas that you opened. The columns to the left of the Integration Schema column contain publish values, while the columns to the right of the Integration Schema column contain retrieve values for the various tool schemas. The right panel populates mapping details for any value you click on in the left panel. This environment allows you to see the integration and tool schemas as a whole and map them from a single environment.

3. Right-click an empty Publish cell in the left panel and select Auto-create map enumerated list for <object>, where object is the schema object you selected. For example, right-click the empty cell in the Cardinal point row of the SmartPlant P&ID Publish column and select Auto-create map enumerated list for Cardinal point.

   

   You can select Create new map enumerated list to manually create a new enumerated list with the New Map Enumerated List Definition dialog box. For more information, start with step 6 in Create an Enumerated List.

   If you select a multi-level enumerated list, a dialog box asks if you want an equivalent multi-level list created within the tool schema (map file) or if you want this multi-level list flattened to a single-level list in the tool schema. If you select a multi-level list, an equivalent hierarchy of enumerations (as existed in the original enumerated list in the integration schema) is created in the tool schema. If you select a flattened list, a single-level list is created in the tool schema.

   The software creates a new map enumerated list for the integration enumerated list, a new map enumeration for each enumeration in the integration enumerated list, and maps all of the created map objects to the corresponding integration object.

   

4. Repeat step 3 on the corresponding tool schema Retrieve cell. For example, right-click the empty cell in the Cardinal point row of the SmartPlant P&ID Retrieve column and select Copy Publish relationships to create Retrieve relationships.

   This creates the retrieve relationships corresponding to the publish relationships created in step 3.

   

5. Click the cell that you mapped in the previous step. For example, click either of the Cardinal point cells you created.

   The mapping details for Cardinal point appear in the right panel.

   In the right panel, you can use the Edit Form or MultiMap tabs to create additional mapping.

6. Right-click any cell in the left panel, and click Create a spreadsheet to create a spreadsheet of the displayed tool and integration schema information.