If you want to define many-to-one or many-to-many mapping between the tool map schema and the SmartPlant schema, you must create map edge definitions that traverse the relationship between two authoring tool class definitions. Map edge definitions allow you to traverse relationships between map class definitions to locate properties that you want to map.
Any map edge definitions defined as part of the tool map schema must be explicitly supported by the adapter for that tool. Unless the tool adapter has been defined to allow user definition of map edge definitions or the user defining the map edge definition has access to the tool adapter code and can modify it to recognize the new map edge definition, any map edge definitions defined by the user will not be recognized by the tool adapter and will not be supported for publish and retrieve operations. Therefore, new map edge definitions should only be created if the underlying tool adapter can either be modified or if the adapter supports user-added map edge definitions. See your authoring tool mapping rules for more information.
-
After you open the tool map schema that you want to edit in the Schema Editor, click View > Tool Schema.
-
Click Options on the View Schema dialog box.
-
On the View tab, click Editor, and then click OK.
If you do not see the View tab, the View dialog box is in Simple mode. Click Editor in the Form list instead.
-
In the Create tree, double-click SPMapEdgeDef.
You can also create map edge definitions by double-clicking the SPMapCEdgeDef node in any tree view in any Schema Editor view.
-
In the Name box, type a unique name for the map edge definition.
-
In the Select criteria box, define the criteria that the tool adapter uses to select or identify objects for this tool edge definition. See the mapping rules for your authoring tool for how to set the value for this property.
-
In the Process criteria box, define the criteria that the adapter uses to process objects that are instances of this tool edge definition. See the mapping rules for your authoring tool for how to set the value for this property.
-
To define the starting map class definition for the edge definition, click
beside the Starts at map class box, and select the starting tool map class.
If the map class definition that you want to use as the starting point for the map
edge definition does not already exist in the tool map schema, you can click Create in the Possible StartMapClassDef dialog box to create it. For more information, see Create a Map Class Definition.
-
To define the ending map class definition for the edge definition, click
beside the Ends at map class box, and select the ending tool map class.
-
Click
beside the Only 1 end map object? box. Select True if, when going from the starting object and traversing the edge, there will only ever
be one end object encountered. If it is possible that the edge will end with more
than one object, select False.
-
Click OK to save the new map edge definition.
-
The authoring tool adapter determines whether one-to-many, many-to-many, and many-to one mapping is supported. For more information, see the rules for your authoring tool in the tool documentation.
-
When you create a map edge definition, the Schema Editor automatically assigns a UID to the map edge definition. If you want to change the UID, click Change UID. See the mapping rules for your authoring tool for information on UID values to use. Some application adapters will not work correctly if the values for the UID do not follow the rules for that application.