In this article
Overview
You can use this Snap to start a workflow in the Teamcenter software. Workflows are automated business processes in which documents, information, and tasks are passed between the organization's authorized users in a controlled way with rules and conditions.
Snap Type
The PLM TC Start Workflow Snap is a write-type Snap that starts the workflow in 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 ID, Template Name, Project Name, Project Subject, and Process Description of the object must be fetched from the Teamcenter software. |
Output | Document |
|
| The workflow is created in the Teamcenter software. |
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 list that is dynamically populated 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 Start Workflow | 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. | |
Object ID*
Default Value: N/A | Dropdown | None | Select the object's UID (unique identifier) or the Teamcenter adapter ID. | |
Template Name* Default Value: N/A | String | None | Specify the template name you want to use for the workflow. | |
Process Name* Default Value: N/A | String | None | Specify the name of the process that you want the workflow to follow in the Teamcenter software. | |
Process Subject* Default Value: N/A | String | None | Specify the subject of the process that you want the workflow to follow in the Teamcenter software. | |
Process Description Default Value: N/A | String | None | Specify the process description that you want the workflow to follow in the Teamcenter software. | |
Add targets Default Value: deselected | Checkbox | None | Specify the targets you want the Snap to fetch from the Teamcenter software. Each target must be specified as a new row. Click to add a row. | |
Targets path Default Value: N/A | String | Add targets | Specify the path to fetch the list of targets from Snap input documents. | |
Targets Default Value: N/A | Specify the references you want the Snap to fetch from the Teamcenter software. Each attribute must be specified as a new row. Click to add a row. | |||
Target* Default Value: N/A | String/Expression | Add targets | Specify the name of the target. | |
Add references Default Value: N/A | Checkbox | None | Specify the additional references to process. | |
References path Default Value: N/A | String/Expression | Add references | Specify the path to fetch the list of references from Snap input documents. | |
References | Specify the references you want the Snap to fetch from the Teamcenter software. Each attribute must be specified as a new row. Click to add a row. | |||
Reference* Default Value: N/A | String/Expression | Add references | Specify the name of the reference. | |
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 expand attributes in the input document. | |
Expand Attributes | Specify the attributes you want the Snap to fetch from the Teamcenter software. 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. |