Classify objects and attributes between your modeling tool and Teamcenter using the integration definition file

Using the integration definition file, you can define the classification for objects and attributes in your modeling tool and map them to objects and attributes in Teamcenter.

As an integrator, define the classification between the modeling tool and Teamcenter as follows:

1. Define the classification mapping in the integration definition file. A sample integration definition file is available.

   In this step, you specify how the objects and attributes in the modeling tool map to the Teamcenter classification objects.

2. Generate the JSON file.

3. Use the export or import operation to classify the mapped objects.

An example of the classification mapping in the integration definition file is as follows:

<ClassificationMapping>
	<AtributeCollection  toolClassId="EDABOMComp">
		<ClassAttribute toolClassAttrId="PartNumber" tcClassAttrId="-5485" direction="TcToTool"/>
		<ClassAttribute toolClassAttrId="Mass" tcClassAttrId="-5491" direction="ToolToTc"/>
		<ClassAttribute toolClassAttrId="OperatingTemperature" tcClassAttrId="-5517" direction="ToolToTc"/>
	</AtributeCollection>
	<Class toolClassId="EDABOMComp" tcClassId="RNC363" classifyAnchor="false">
		<ClassAttribute toolClassAttrId="NumberOfFans" tcClassAttrId="-5160"/>
		<ClassAttribute toolClassAttrId="FanDiameter" tcClassAttrId="-5159"/>
		<ClassAttribute toolClassAttrId="UnitCapacity" tcClassAttrId="-5158"/>
		<ClassAttribute toolClassAttrId="NumbMaximumSupplyPowererOfFans" tcClassAttrId="-5157"/>
	</Class>
	<Class toolClassId="EDABOMComp" toolClassifybyAttribute="Partition"  toolClassifybyAttributeValue="top/HEATSINK" tcClassId="RNC364" classifyAnchor="false">
		<ClassAttribute toolClassAttrId="ThermalResistance" tcClassAttrId="-6700" direction="TcToTool"/>
		<ClassAttribute toolClassAttrId="Height" tcClassAttrId="-6643" direction="ToolToTc"/>
		<ClassAttribute toolClassAttrId="Length" tcClassAttrId="-6641" direction="ToolToTc"/>
		<ClassAttribute toolClassAttrId="FinThickness" tcClassAttrId="-5182" direction="ToolToTc"/>
	</Class>
</ClassificationMapping>

Define the classification mapping in the integration definition file

In the integration definition file, the classification mapping is enclosed in the ClassificationMapping section.

<ClassificationMapping>
  Classification mapping occurs here
</ClassificationMapping>

Within the ClassificationMapping section, you can map classification attributes from your tool to Teamcenter as follows:

• Map the common attributes of the class
• Map the attributes of a class using simple mapping
• Map the attributes of a class using conditional mapping

Map the common attributes of the class

You can map the common attributes of the class in the AtributeCollection section for the specified object.

<AtributeCollection toolClassId="EDABOMComp">
	<ClassAttribute toolClassAttrId="PartNumber" tcClassAttrId="-5485" direction="TcToTool"/>
	<ClassAttribute toolClassAttrId="Mass" tcClassAttrId="-5491" direction="ToolToTc"/>
	<ClassAttribute toolClassAttrId="OperatingTemperature" tcClassAttrId="-5517" direction="ToolToTc"/>
</AtributeCollection>

In this section:

• toolClassId represents the ID of the object in the tool. The attributes are mapped for this object.
• toolClassAttrId represents the ID of the attribute that you want to map with the Teamcenter attribute.
• tcClassAttrId represents the classification ID of the attribute in Teamcenter. You can find the classification ID in the Classification workspace in Active Workspace.
• direction represents the flow of information. You can use the following values:
  • ToolToTc: The attribute mapping information is sent to Teamcenter, and the classification happens on the Teamcenter side.
  • TcToTool: The attribute mapping information is sent to the tool, and the classification happens on the tool side.
  • Both: Classification happens on both sides.

Map the attributes of a class using simple mapping

You can map the attributes of a class in the Class section using input variables.

<Class toolClassId="EDABOMComp" tcClassId="RNC363" classifyAnchor="false">
	<ClassAttribute toolClassAttrId="NumberOfFans" tcClassAttrId="-5160"/>
	<ClassAttribute toolClassAttrId="FanDiameter" tcClassAttrId="-5159"/>
	<ClassAttribute toolClassAttrId="UnitCapacity" tcClassAttrId="-5158"/>
	<ClassAttribute toolClassAttrId="NumbMaximumSupplyPowererOfFans" tcClassAttrId="-5157"/>
</Class>

In this section:

• toolClassId represents the ID of the object in the tool.
• tcClassId represents the ID of object in the Teamcenter.
• classifyAnchor represents whether you want to classify an item or an item revision. You can specify either value: true — an item is classified; false — an item revision is classified.
• toolClassAttrId represents the ID of the attribute that you want to map with the Teamcenter attribute.
• tcClassAttrId represents the classification ID of the attribute in Teamcenter. You can find the classification ID in the Classification workspace in Active Workspace.

Map the attributes of a class using conditional mapping

You can specify how the attribute in a class is classified based on the value of an attribute. In the following example, if the attribute Partition has the value top/HEATSINK, one set of classification mapping is followed. If the attribute Partition has the value new/HEATSINK, a different set of classification mapping is followed.

<Class toolClassId="EDABOMComp" toolClassifybyAttribute="Partition"  toolClassifybyAttributeValue="top/HEATSINK" tcClassId="RNC364" classifyAnchor="false">
	<ClassAttribute toolClassAttrId="ThermalResistance" tcClassAttrId="-6700" direction="TcToTool"/>
	<ClassAttribute toolClassAttrId="Height" tcClassAttrId="-6643" direction="ToolToTc"/>
	<ClassAttribute toolClassAttrId="Length" tcClassAttrId="-6641" direction="ToolToTc"/>
	<ClassAttribute toolClassAttrId="FinThickness" tcClassAttrId="-5182" direction="ToolToTc"/>
</Class>
<Class toolClassId="EDABOMComp1" toolClassifybyAttribute="Partition" toolClassifybyAttributeValue="new/HEATSINK" tcClassId="RNC364" classifyAnchor="false">
	<ClassAttribute toolClassAttrId="ThermalResistance" tcClassAttrId="-6700" direction="TcToTool"/>
	<ClassAttribute toolClassAttrId="Height" tcClassAttrId="-6644" direction="ToolToTc"/>
	<ClassAttribute toolClassAttrId="Length" tcClassAttrId="-6642" direction="ToolToTc"/>
	<ClassAttribute toolClassAttrId="FinThickness" tcClassAttrId="-5183" direction="ToolToTc"/>
</Class>

You can map the attributes of a class in the Class section. In this section:

• toolClassId represents the ID of the object in the tool.
• toolClassifybyAttribute represents the attribute on which the classification will be defined.
• toolClassifybyAttributeValue represents the attribute value on which classification will be applied.
• classifyAnchor indicates whether you want to classify an item or an item revision. You can specify either value: true — an item is classified; false — an item revision is classified.
• toolClassAttrId represents the classification ID of the attribute in Teamcenter. You can find the classification ID in the Classification workspace in Active Workspace.
• direction represents the flow of information. You can use the following values:
  • ToolToTc: The attribute mapping information is sent to Teamcenter, and the classification happens on the Teamcenter side.
  • TcToTool: The attribute mapping information is sent to the tool, and the classification happens on the tool side.
  • Both: Classification happens on both sides.

Generate the JSON file

From your tool, you can generate a JSON file based on the JSON schema used by the MBSE Integration Services framework. For testing purposes, you can use the MBSE Integration Services Toolkit to generate the JSON file.

Use the export or import operation to classify the mapped objects

You can use the exportCollection and updateCollection APIs to update the classification in Teamcenter.

You can use the importCollection API to import the classification data into your modeling tool.

You can use the MBSE Integration Services Toolkit to test these operations.