Tool map schemas describe the mapping between objects in the tool database structure (tool metadata) and the SmartPlant schema. For example, the Drawing class in Smart P&ID maps to the PIDDrawing class in the SmartPlant schema. This mapping is used during publish and retrieve to convert tool data to SmartPlant data and vice versa. Every integrated authoring tool has a tool map schema.
When a document is published, the authoring tool adapter uses the tool map schema to convert the data used by the tool to a format that adheres to the SmartPlant schema. When a data file is retrieved into an authoring tool, the authoring tool adapter uses the tool map schema to convert the SmartPlant XML to the format used by the tool.
Tool map schemas can be edited directly in the Schema Editor, or they can be synchronized with the tool metadata using the Edit Engineering Tool Options command for authoring tools that have a metadata adapter. The Edit Engineering Tool Options is only available after a SmartPlant Foundation connection exists. You can establish this connection by checking the SmartPlant schema file out of the SmartPlant Foundation Desktop Client and launching the Schema Editor from the client. For more information about metadata adapters and tool map schemas, see Mapping with Metadata Adapters.
For more information about the delivered mapping between the SmartPlant authoring tools, see the SPECPMappingReports.zip, available from Hexagon Support. These reports include:
-
The mapping between classes, properties, and enumerations in the map file
-
The properties that are mapped out-of-the-box for publishing and retrieving information
-
The properties that are unmapped
The reports also show an example of a comparison between properties from two authoring tools.