Teamcenter BOM Structure Add

 

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 Teamcenter 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

Type

Format

Number of Views

Examples of Upstream and Downstream Snaps

Description

Input 

Document

  • Min: 1

  • Max: 1

  • Mapper

  • JSON Generator

The parent ID, child ID, and the attributes that must be fetched from the Teamcenter software.

Output

Document

  • Min: 1

  • Max: 1

  • Teamcenter BOM Structure Get

  • Teamcenter BOM Structure Get Recursive

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:

  • Stop pipeline Execution: Stops the current pipeline execution if the Snap encounters an error.

  • Discard Error Data and Continue: Ignores the error, discards that record, and continues with the remaining records.

  • Route Error Data to Error View: Routes the error data to an error view without stopping the Snap execution.

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

Field Name

Field Type

Description

Label*

 

Default ValueTeamcenter BOM Structure Add
ExampleTeamcenter 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
Example: Client details

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
Example: new client_tc

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
Example: 3<1

String/Expression/Suggestion

Specify the revision rule you want the Snap to revise for the structure expansion.

View type

Default Value: N/A
Example: Queryview

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
Example: newclient-tc ->color

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 to add a row.

Name*

Default Value: None
ExampleQuantity

String

 

Specify the name of the attribute.

Value*

Default Value: None
Example5

String

Specify the value of the attribute.

Snap Execution

Default ValueExecute
Example: Validate & Execute

Dropdown list

Select one of the following three modes in which the Snap executes:

  • Validate & Execute: Performs limited execution of the Snap and generates a data preview during pipeline validation. Subsequently, performs complete execution of the Snap (unlimited records) during pipeline runtime.

  • Execute only: Performs complete execution of the Snap during pipeline execution without generating preview data.

  • Disabled: Disables the Snap and all Snaps that are downstream from it.

Troubleshooting

Error

Reason

Resolution

Unable to start the embedded Teamcenter Adapter.

The Teamcenter Snap Pack 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 Teamcenter Snap. The host cannot be connected.

The configured hostname cannot be resolved to an IP address.

  • Hostname Check: Verify and correct the hostname.

  • DNS Configuration: Check and correct the DNS configuration.

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.

Snap Pack History