Create a Map Unit of Measure List Definition - Integration - Update 44 - Help - Hexagon

Integration Help

Language
English
Product
Integration
Search by Category
Help
Smart 3D Version
12.1 (2019)
Smart Construction Version
2019(7.0)
SmartPlant Foundation / SDx Version
10
Smart Electrical Version
2019 (9.0)
Smart Materials/Smart Reference Data Version
2020 (10.0)
Smart P&ID Version
9 (2019)
Smart Review Version
2020 (15.0)
Smart Engineering Manager Version
10 (2019)
Smart Interop Publisher Version
13.1 (2019 R1)
Smart Isometrics Version
7.0(2019)
Spoolgen Version
9.0(2019)

When you create a map unit of measure (UoM) list definition, you must create the UoM list definition and then define the UoM list entries that the list contains. In the tool map schema, a UoM list is exactly like an enumerated list and can be mapped to an enumerated list in the SmartPlant schema.

  1. After you open the tool map schema that you want to edit in the Schema Editor, click View > Tool Schema.

  2. Click Options on the View Schema dialog box.

  3. On the View tab, click Editor, and then click OK.

    SHARED Tip If you do not see the View tab, the View dialog box is in Simple mode. Click Editor in the Form list instead.

  4. In the Tool Schema Editor UML window, double-click SPMapUoMListDef in the Create tree.

    SHARED Tip You can also create map unit of measure list definitions by double-clicking the SPMapUoMListDef node in any tree view in any Schema Editor view.

  5. In the Short description box, type the name of the UoM list.

  6. In the Select criteria box, define the criteria that the tool adapter uses to select or identify objects for this tool UoM list definition and its entries. See the mapping rules for your authoring tool for how to set the value for this property.

  7. In the Process criteria box, define the criteria that the adapter uses to process objects that are instances of this tool UoM list definition and its enumerations. See the mapping rules for your authoring tool for how to set the value for this property.

  8. To define the SmartPlant UoM list that the tool UoM list definition maps to for publish, click beside the Maps to box, and select the SmartPlant UoM list.

  9. To define the SmartPlant UoM list that maps to the tool map UoM list definition for retrieve, click beside the Mapped from box, and select the SmartPlant UoM list.

  10. To define the tool map properties that this list defines UoMs for, click beside the Scoped map properties box, and select the map property definitions that are scoped by this map UoM list.

  11. To create a UoM list entry (MapEnum) for this map UoM list, click New Child in the New Map Unit of Measure List Definition dialog box.

    SHARED Tip If you have a spreadsheet containing your list entries, you can copy them to the Clipboard and then add them to the list using the Import Clipboard Entries button. For more information, see Import Enumerated List Entries from a Spreadsheet.

  12. In the Short description box, type the name of the list entry.

    Mapping_EnumListEntry

    SHARED Tip When you move out of the Short description box, the new list entry is automatically added to the Map unit of measure list definition tree.

    Mapping_EnumList_Tree

  13. If a secondary numeric key identifies the UoM list entry, type the key in the Number box.

  14. In the Select criteria box, define the criteria that the tool adapter uses to select or identify objects for this tool UoM list entry. See the mapping rules for your authoring tool for how to set the value for this property.

  15. In the Process criteria box, define the criteria that the adapter uses to process objects that are instances of this tool UoM list entry. See the mapping rules for your authoring tool for how to set the value for this property.

  16. To create additional list entries, click New Sibling, and repeat steps 12-15 for each entry that you want to add.

  17. To save your changes, click OK.

For some authoring tools, you must change the system-generated UID so that the adapter can correlate the enumerated list and its entries with the appropriate enumerated list and entries in the tool database. For example, for Smart P&ID, you must replace the system-generated UID for the map enumerated list and the list entries with UIDs from the Smart P&ID database. For more information, see the rules for your authoring tool in the tool documentation. To change the system-generated UID, click Change UID.

  • To view properties for the map UoM list or UoM list entries, click the list or entry in the tree view.

  • As you add UoM list entries to the list, the software adds them to the Contains box for the map UoM list definition.

  • When you define UoM list entries, the ContainedIn box is automatically populated with the map UoM list name. However, you can change the map UoM list for a UoM list entry by clicking beside the ContainedIn box and selecting another map UoM list. The UoM entry is automatically moved to the selected map UoM list.