In this article
Overview
You can use this Snap to add a new item or revision to the Teamcenter software bill of materials (BOM) structure based on the specifications of an input JSON document.
Snap Type
The PLM TC BOM Structure Add Snap is a Write-type Snap that writes JSON input documents to the Teamcenter software.
Prerequisites
Valid client ID.
A valid account with the required permissions.
Limitations and Known Issues
None.
Snap Views
Type | Format | Number of Views | Examples of Upstream and Downstream Snaps | Description |
---|---|---|---|---|
Input | Document |
|
| The parent ID, child ID, and the attributes that must be fetched from the Teamcenter software. |
Output | Document |
|
| The BOM structure with the newly added element. |
Error | Error handling is a generic way to handle errors without losing data or failing the Snap execution. You can handle the errors that the Snap might encounter when running the pipeline by choosing one of the following options from the When errors occur list under the Views tab:
Learn more about Error handling in Pipelines. |
Snap Settings
Asterisk ( * ): Indicates a mandatory field.
Suggestion icon (
): Indicates a dynamically populated list based on the configuration.
Expression icon (
): Indicates the value is an expression (if enabled) or a static value (if disabled). Learn more about Using Expressions in SnapLogic.
Add icon (
): Indicates that you can add fields in the field set.
Remove icon (
): Indicates that you can remove fields from the field set.
Upload icon (
): Indicates that you can upload files.
Field Name | Field Type | Description | |
---|---|---|---|
Label* Default Value: TC BOM Structure Add | String | The name for the Snap. You can modify this to be more specific, especially if you have more than one of the same Snap in your pipeline. | |
Parent ID* Default Value: N/A | String/Expression | Specify the _id or a UID of the parent item where you want to add the new item. | |
Child ID* Default Value: N/A | String/Expression | Specify the _id, a UID, or a Teamcenter adapter ID of the child you want to add to the parent element. | |
Revision Rule*
Default Value: N/A | String/Expression/Suggestion | Specify the revision rule you want the Snap to revise for the structure expansion. | |
View type Default Value: N/A | String/Expression/Suggestion | Specify the view type to determine the layout, visibility, and organization of data in the Teamcenter software. A view type represents a preconfigured collection of attributes and visual settings employed to showcase details regarding an object or a specific facet of the system's capabilities. | |
Child line attributes path Default Value: N/A | String/Expression | Specify the path to the child line attributes in the input document. Child line attributes are the specific attributes of the child objects in a parent-child relationship or hierarchical structure. When creating a parent-child relationship in the Teamcenter software, child line attributes can be defined to capture and store data relevant to the child objects. | |
Child Attributes | Specify the child's attributes by which you want the Snap to fetch the item from the Teamcenter software. Each attribute must be specified as a new row. Click | ||
Name* Default Value: None | String | Specify the name of the attribute. | |
Value* Default Value: None | String | Specify the value of the attribute. | |
Snap Execution Default Value: Execute | Dropdown list | Select one of the following three modes in which the Snap executes:
|
Troubleshooting
Error | Reason | Resolution |
---|---|---|
Unable to start the embedded Teamcenter Adapter. | The PLM TC requires SOA API Libraries. The required SOA API Libraries are unavailable in the JCC (Java Command Center) environment. | Copy the required API library files to the %SL_ROOT%/teamcenter_lib directory. Then, ensure they are added to SL_CLASSPATH. Verify the correct library setup. |
Communication failure with the PLM TC Snap. The host cannot be connected. | The configured hostname cannot be resolved to an IP address. |
|
The connection failed when connecting to the Teamcenter software. | Communication with the Teamcenter Webtier cannot be established because of firewall settings or incorrect URL/port configuration. | Investigate if there's a firewall between the Groundplex and the Teamcenter server. Verify the URL and port settings. |
Incorrect account credentials. | The username and password provided in the account configuration are incorrect. | Ensure that the correct username and password are configured in the account. |
Invalid user or user does not exist. | The user configured in the account is set to inactive in Teamcenter software. | Reactivate the user account in the Teamcenter software through an authorized user, typically an administrator. |