TeamcenterKnowledge

MBSE Integration Services for Integrating Modeling Tools

JSON schema

JSON key Description
AllContainers Holds all the containers to be created, updated or imported from Teamcenter and information common to containers.
toolIdentifier Application name to identify the integrating tool, for example MATLAB, ECAD, SAMPLE. This value is used by the framework to identify the integration definition file where integration specific configuration is done. This value and corresponding integration definition file are unique for different integrations. This is a required field.
Containers This array holds containers to be created, updated or imported from Teamcenter. Each container is represented by a separate Teamcenter business object.
containerIdentifier A unique identifier for the container assigned by the integrating modeling tool. This is required in all operations.
tcContainerIdentifier A unique identifier of the Teamcenter business object corresponding to the container. This field is empty for exportCollection as no corresponding Teamcenter business object is created. It is a required field for updateCollection() and importCollection() SOAs.
containerName Name of container in the tool.
tcContainerName Name of the Teamcenter business object corresponding to the container. If this field is empty then containerName is given to the Teamcenter object.
containerType The object type of a container in the tool. This is used to process the corresponding Teamcenter object mapped in the integration definition file.
tcContainerType The type of object in Teamcenter such as Item, Dataset. This maps to the containerType in the tool. If this value is empty, then the mapped Teamcenter object type is picked from the integration definition file.
isTopContainer If value is true and tcFolderUid value is empty then the container is copied under Newstuff folder in Teamcenter.
action Action to be performed on this container. add creates new container object in Teamcenter. update updates the relationship or metadata of existing Teamcenter component.
tcFolderUid The UID of Teamcenter folder where the new container can be pasted. It is optional. If value of isTopContainer is true and tcFolderUid value is empty then the container is copied under Newstuff folder in Teamcenter.
tcLastModifiedDate The last modified date of the container saved to Teamcenter. This is populated in the output JSON.
attributes An array of attributes of model object in tool mapped to the Teamcenter object properties and their values.
attrName Name of attribute in the tool.
tcAttrName Name of the Teamcenter object property mapped with the name of attribute in tool.
value Array of attribute values. If the Teamcenter object property accepts single value, then the array will have only one value.
revAttributes An array of attributes of model object in tool mapped to the Teamcenter revision object properties and their values.
datasetFileInfos An array of attributes of tool files to be associated with a Teamcenter dataset.
fileName Name of the file to be uploaded to Teamcenter without extension.
fileExtension Extension of the file to be uploaded to Teamcenter without extension.
filePath Absolute path of the folder where the file resides on the user desktop.
namedReferenceName Name of the file reference in the dataset business object.
allowReplace Allows overriding an existing named reference of a dataset. true overrides, false adds a new named reference to the dataset.
isText The type of Named Reference file. true represents a text file, false represents a binary file.
writeTicket This is an FMS write ticket to upload a file to Teamcenter dataset. This will be empty in case of saving a new dataset to Teamcenter. This is populated in the output JSON returned by the Common Integration Framework service operations exportCollection() and updateCollection().
readTicket The FMS read ticket to download a file from Teamcenter dataset. This will be empty in case of saving data to Teamcenter. This is populated in the output JSON of importCollection().
Components Array of components associated to the container. The association can be of the following types: a relation (GRM), the product structure (BVR) of the owning container, or a referenced container (REF).
componentName This is the name of the occurrence if this is a BVR association.
componentIdentifier Unique identifier of a component in the tool. This is required if component is added in the Container.
componentType Type of component in the tool. For example a Model, Referenced Model, or a Referenced library in Matlab. This is a required field.
tcComponentType Type of Teamcenter object. If this is empty then the default value is picked from the mapping file of the tool. This is the Teamcenter type of a relation object or the occurrence object. In case of referenced component it is empty.
ComponentLinks This array in Component is to establish an association between two components of a container.
owningContainerIdentifier This is the tool assigned unique identifier of container in which the component resides.
ContextualComponents An array of contextual components, that is, associations or relations between two components in the context of a specific container, not necessarily the immediate parent container. For example, a tracelink relation between two occurrences of a wheel (Container) such as front wheel (component) and rear wheel (component) in the context of bicycle (container).
tcComponentIdentifier This is a Teamcenter assigned unique identifier of the associated or related object. This is required when the action is UPDATE or REMOVE.
rootContainerIdentifier This is containerIdentifier of a container in the context of which the association or relation is created.
tcRootContainerIdentifier This is tcContainerIdentifier of a container in the context of which the association or relation is created.
owningComponentIdentifier A :: (double colon) separated list of all parent componentIdentifiers, used to uniquely identify a nested component (e.g. Front Wheel component :: Rim component for a valve nested inside a bicycle's front wheel's rim). Required if the parent components are not saved into Teamcenter.
tcOwningComponentIdentifier A :: separated list of all parent tcComponentIdentifiers, the Teamcenter-side equivalent of owningComponentIdentifier.
userSpecificInputs User actions and operation specific input, with keys such as CHECKOUT, CHECKIN, REVISION_RULE, and VARIANT_RULE.
systemInputs Special inputs, with keys such as RETURN_MAPPED_ATTRIBUTES and BOM_VIEW_TYPE_NAME.

Example systemInputs usage:

"systemInputs" : [ {
                    "values" : [ "true" ],
                    "inputKey" : "RETURN_MAPPED_ATTRIBUTES"
                } ],

Source: https://docs.sw.siemens.com/en-US/doc/282219420/PL20251212545240207.xid1913857/xid1914676 · retrieved Fri Jul 10 2026 00:00:00 GMT+0000 (Coordinated Universal Time)