In this article
Overview
You can use this Snap to execute the saved queries in Teamcenter. PLM TC Query is based on the Teamcenter persistence data model.
Snap Type
The PLM TC Query Snap is a Read-type Snap that executes the saved queries in the Teamcenter.
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 |
|
| Requires query key, query criteria, and the number of items to be retrieved from Teamcenter. |
Output | Document |
|
| The output of the executed query. |
Error | Error handling is a generic way to handle errors without losing data or failing the Snap execution. You can take 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 fieldset.
Remove icon ( ): Indicates that you can remove fields from the fieldset.
Upload icon ( ): Indicates that you can upload files.
Field Name | Field Type | Field Dependency | Description | |
---|---|---|---|---|
Label* Default Value: PLM TC Query | String | None | 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. | |
Query Key* Default Value: N/A | String | None | Specify the key name of the query that you want the Snap to execute from Teamcenter. | |
Max Items* Default Value: 0 | Integer | None | Specify the maximum number of results you want in the query output. | |
Query Criteria | Specify the name and the value of the query you want the Snap to execute from Teamcenter. Each attribute must be specified as a new row. Click to add a row. | |||
Name* Default Value: N/A | String | None | Specify the name of the query. | |
Value* Default Value: N/A | String | None | Specify the value of the query. | |
Wrap Result* | Checkbox | None | Select this checkbox if you want the Snap to return a single document containing the result instead of multiple documents. | |
Configure Output Default Value: deselected | Checkbox | None | Select this checkbox if you want the Snap to specify the configuration of the Teamcenter properties in the output. | |
Type
Default Value: N/A | String/Expression | Configure Output | Specify the name of the Teamcenter type. | |
Expand attributes path Default Value: N/A | String/Expression | Configure Output | Specify the path of the expanded attributes in the input document. | |
Expand Attributes | Specify the attributes you want the Snap to fetch from Teamcenter. Each attribute must be specified as a new row. Click to add a row. | |||
Name* Default Value: None. | String | Configure Output | Specify the name of the attribute. | |
Snap Execution Default Value: Execute only | Dropdown list | None | 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. |