Tc BOM Structure Create TraceLink
This Snap create a tracelink relation between two occurrences in Teamcenter. Tracelink relation is a managed relation in Teamcenter. To get the IDs of the occurrences to be related use Snap Tc BOM Structure Get For TraceLinks (*) first.
Supported Accounts
- This is a Write-type Snap.
Works in Ultra Tasks

Prerequisites
- A valid Teamcenter account with the required permissions.
Limitations
- (*) signs the snap as project specific solution. Works for simple use cases.
- Creating a tracelink between occurrence of structure head and child occurrence will not work since Teamcenter doesn’t support this. So don’t use
occurenceIdofstructureelement (see picture) as Primary ID or Secondary ID.

Known issues
In case tracelink allready exists, exception is thrown.
Snap views
| Type | Description | Examples of upstream and downstream Snaps |
|---|---|---|
| Input |
Optional.This Snap has at the most one document input view. The required input of the snap is the Object IDs of two objects to be linked in Teamcenter. |
|
| Output |
This Snap has exactly one document output view. The output of the snap is the newly created tracelink object in Teamcenter. |
|
| Learn more about Error handling. | ||
Examples
Tc BOM Structure Create TraceLink: Create a tracelink between two occurrencesSnap settings
| Field/Field set | Description |
|---|---|
Label
String |
Specify a unique name for the Snap. Modify this to
be more appropriate, especially if there are more than one of the same Snap in the
pipeline.
Default value: Tc BOM Structure Create TraceLink |
Configure policy
Checkbox |
Select this checkbox to run the Snap with a specific named Teamcenter policy. A policy determines the set of object properties that Teamcenter returns. Learn more: Configure policy. Default status: Deselected |
Configure session context
Checkbox |
Select this checkbox to run the Snap with a group, role, or project other than the one configured in the account. Learn more: Configure session context. Default status: Deselected |
Primary ID*
String/Expression |
Select the UID (unique identifier) or the Teamcenter adapter ID of the object to be primary object of tracelink in Teamcenter. Default value: N/A Example: $.primary._id |
Secondary ID*
String/Expression |
Select the UID (unique identifier) or the Teamcenter adapter ID of the object to be secondary object of tracelink in Teamcenter. Default value: N/A Example: $.secondary._id |
Configure error handling
Checkbox |
Select this checkbox to define how the Snap behaves when Teamcenter returns an error. Use these settings for analysis and debugging. Learn more: Configure error handling. Default status: Deselected |
Simplified expand
Checkbox |
Select this checkbox to make the Snap look for the name given in
Expand Attributes Path in the input document (for example,
When deselected, configure Expand Attributes Path as a string or an expression. Default status: Deselected |
Expand Attributes Path
String/Expression |
Specify the JSON path to the expand attributes in the input document. Expand attributes are the list of attributes that the Teamcenter response must contain. Each name must be the technical name of a valid property in the Teamcenter data model for the expected objects. For example:
Learn more: Configuring Expand Attributes. Default value: N/A Example: $.expandAttributes |
Build reference/lov documents
Dropdown list/Expression |
Select how the Snap represents references and lists of values (LOVs) that
Teamcenter returns. The Snap can return them as nested JSON objects instead of
flattened IDs and internal values with additional
The available options are:
Default value: Use Default Example: Yes |
Configure output
Checkbox |
Select this checkbox to specify the Teamcenter properties that the Snap includes in the output. This Snap offers the output settings described in Variant: type field in configuration settings. Default status: Deselected |
Snap execution
Dropdown list |
Choose one of the three modes in
which the Snap executes. Available options are:
|