Set up common connector-based integration

To set up the common connector-based integration, perform the following two configurations:

• Update the project definition file with information about the modeling tool file types
• Create an integration definition file that contains the mapping information between the modeling tool types and Teamcenter types. If an integration already exists, for example, the MATLAB Simulink integration, you need not create an integration definition file. You can modify the existing one.

Update the project definition file with information about the modeling tool file types

Procedure

1. In the Teamcenter rich client, search for and check out the dataset PROJECT_BHM_INT_DEF_FILE.
2. Update the named reference file in the dataset by adding information about the modeling tool and its file extension in the ToolFileMapping section as follows:

<ToolFileMapping>
  <ToolFileMap toolType="MATLAB" fileExtension="mdl"/>
  <ToolFileMap toolType="MATLAB" fileExtension="slx"/>
  <ToolFileMap toolType="<CUSTOMTOOLTYPE>" fileExtension="<Extension of file specific to tool>"/>
</ToolFileMapping>

3. Check in the PROJECT_BHM_INT_DEF_FILE dataset.

Create an integration definition file that contains mapping information between the modeling tool types and Teamcenter types

Procedure

1. Create an XML file named CUSTOMTOOLTYPE_BHMIntegrationDefinition.xml.
2. Update the XML file with mapping information.
3. If you are modifying an existing integration definition file, update the name attribute of the ConnectorClass.
4. Create a dataset in Teamcenter named CUSTOMTOOLTYPE_BHM_INT_DEF_FILE and add the XML file that you created to the dataset as a named reference.
5. Use the command line operation to import and export the model data.

The CUSTOMTOOLTYPE_BHMIntegrationDefinition.xml definition is as follows:

<?xml version="1.0" encoding="utf-8"?>
<BHMIntegration xmlns="http://www.plmxml.org/Schemas/bhm"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.plmxml.org/Schemas/bhm"
applicationName="%CUSTOMETOOLTYPE%">
  <!--Below line specifies to use smart connector-->
  <ConnectorClass fullName="com.teamcenter.behaviormodeling.commonclient.defaultconnector.CommonConnector" jarFilePath="" />
  <SupportedVersions>
    <Version id="17" />
  </SupportedVersions>
  <!-- Map object type and teamcenter type with behavior-->
  <ObjectMapping type="Model" behaviorType="BVR/GRM" tctype="%teamcentertype%">
    <BHMElement type="RootModel" tctype="%teamcentertype%">
      <AttributeMappings>
        <AttributeMapping name="Name" tcattr="object_name" includeinduplicatecheck="false"/>
        <RevisionAttributeMapping/>
      </AttributeMappings>
    </BHMElement>
    <BHMElement type="Project" checkforduplicates="false" reftype="Model">
      <AttributeMappings>
        <AttributeMapping name="Name" tcattr="object_name" includeinduplicatecheck="false"/>
        <RevisionAttributeMapping/>
      </AttributeMappings>
    </BHMElement>
    <OrganizationData>
    </OrganizationData>
  </ObjectMapping>
  <PrimaryDataFileMapping>
    <FileMapping>
    <!-- Map file extension of tool type with supported dataset and named reference-->
      <FileMap fileExt="file extension same as what was mapped in the PROJECT_BHM_INT_DEF_FILE ToolFileMapping section"
      tcDatasetType="supported teamcenter dataset for file extension"
      tcNameReferencedType="supported teamcenter dataset names reference for file extension" />
      <FileMap fileExt="*" tcDatasetType="supported teamcenter dataset for generic file e.g MISC"
      tcNameReferencedType="supported teamcenter dataset names reference for file extension e.g. MISC_TEXT" />
    </FileMapping>
  </PrimaryDataFileMapping>
  <FileMapping><!--additional mapping for File-->
    <FileMap fileExt="txt" tcDatasetType="Text" tcNameReferencedType="Text" />
    <FileMap fileExt="png" tcDatasetType="Image" tcNameReferencedType="Image" />
    <FileMap fileExt="html" tcDatasetType="HTML" tcNameReferencedType="HTML" />
    <FileMap fileExt="jpg" tcDatasetType="JPEG" tcNameReferencedType="JPEG_Reference" />
    <FileMap fileExt="zip" tcDatasetType="Zip" tcNameReferencedType="ZIPFILE" />
    <FileMap fileExt="tif" tcDatasetType="TIF" tcNameReferencedType="TIF_Reference" />
    <FileMap fileExt="gif" tcDatasetType="GIF" tcNameReferencedType="GIF_Reference" />
    <FileMap fileExt="*" tcDatasetType="MISC" tcNameReferencedType="MISC_TEXT" />
  </FileMapping>
  <Extensions>
  </Extensions>
  <Operations>
  </Operations>
</BHMIntegration>

After completing this configuration, you can:

• Refer to the List of optional server-side configurations for Teamcenter MBSE Integration Services topic to see other configurations.
• Refer to the MBSE Integration Services deployment checklist to see next steps.