After you generate the SPCRetrieveMappings.xml file and check it into Smart Construction, you can retrieve documents in Smart Construction. In Smart Construction, the retrieve process gets the data files published by the authoring tools and processes the data contained in them. These files contain the list of components available for both the authoring tools and Smart Construction.
During a retrieve operation, Smart Construction gets the view files and data files associated with the published document that is being retrieved. The data files contain engineering data exposed by various 3D models and 2D drawings generated by the various SmartPlant engineering tools. These data files contain the component list and relationships you see in the engineering tools, as well as Smart Construction. The SPCRetrieveMappings.xml file is used during the import of the components that are in the data files. When a component is encountered in the data file, the SPCRetrieveMappings.xml file is used to look for any mapping that matches on the following key structure:
Tool Domain UID, Component Class Definition, Component Interface Definition
Mapping is applicable to the given component if the following is true:
-
The Tool Domain UID of the mapping and the Tool Domain UID of the component match.
-
The Component Class Definition of the mapping and the Component Class Definition of the component match.
-
The Component Interface UID of the mapping is an interface that is on the component.
If no mappings are found for the given component, the retrieve process in Smart Construction looks for mappings that match the same key structure; but, instead of using the component's class definition, a wildcard value, *, is used, as seen in the following key structure:
Tool Domain UID, *, Component Interface Definition
A mapping is applicable to the given component if the following is true:
-
The Tool Domain UID of the mapping and the Tool Domain UID of the component match.
-
The Component Interface UID of the mapping is an interface that is on the component.
Once the list of applicable mapping relationships for each component is determined, the retrieve process copies the data from the specified source interface (cifc) and property (cpd) to the specified target interface (spcifc) and property (spcpd) on the component in Smart Construction.
When you retrieve, the relationship between the component category and SmartPlant schema class definition is created.