Windchill Trigger
Use the Windchill trigger to subscribe to events occurring in Windchill.
Prerequisite
• For security reasons, the Windchill Webhook URL needs to be under white list. To do so, complete the following steps:
1. From the <ThingWorx Flow Installation Folder>\modules\trigger\deploymentConfig.json file, copy the value of the DOMAIN property.
Edit the URL in the format <protocol>://<Windchill FQDN>/Thingworx by removing the port number from the URL. This is the base webhook URL.
2. In Windchill, under > > , paste the edited value of webhook URL in > .
• Ensure that you are on one of the following supported Windchill versions:
◦ Windchill PDMLink 11.2.0.0 or any later Windchill PDMLink releases
◦ Windchill PDMLink 11.1 M020-CPS01 and later
◦ Windchill PDMLink 11.1 M010-CPS05 and later
◦ Windchill PDMLink 11.0 M030-CPS14 and later
Using Windchill Trigger
To use this trigger in your workflow, create a new event for the Windchill trigger, and then connect to the flow. To create a new event, do the following:
1. Place the pointer on the start icon
, and then click
or double-click
. A list of triggers appears.
2. Select the Windchill trigger. The Windchill trigger configuration window opens.
| • If a trigger is already created, select an existing trigger, and then click SAVE. • To create a new trigger, click Create a new event for Windchill, and then proceed with the steps further. |
3. Edit the trigger label, if needed.
| Labels are case-sensitive. You cannot use spaces, some special characters, and leading numbers. |
4. To add a connection, refer to the section
Adding a Connection in the Windchill connector topic. The default value is
Basic.
| If you previously added a connection for Windchill, select a connection from the list. |
5. Select an Entity Type from the list or specify an entity type in the format PTC.domainName.entity such as PTC.ProdMgmt.Part.
6. In the Event field, select an event name from the list or enter an event ID. A list of events dynamically appears from the Windchill subscription service. If the value of the Event field is set to Life Cycle State, specify its value in the Life Cycle State field.
7. In the Subscribe To field, select an option from the list. The input form changes based on the selected option.
◦ Specific Windchill Entity—To subscribe to a specific Windchill entity, enter the details that follow:
▪ Name—Specific Windchill entity name.
▪ Number—Specific Windchill entity number.
| Either provide a name or number or provide both name and number. |
▪ Subscribe to All Versions—To subscribe to all versions, select true, otherwise select false.
◦ Container—To subscribe event on a container, enter the entity container details in Windchill OID format such as OR:Type:ID, where Type is the internal name of the Windchill entity type such as OR:wt.pdmlink.PDMLinkProduct:142471
When Subscribe To container is selected, an event is triggered when the specified event occurs on any entity from specified entity type from that particular container. For example, when Entity Type is Part and Event is Checkin or Checkout and container value is specified as GOLF_CART then the event is triggered when Checkin or Checkout action occurs on any Part present under container GOLF_CART. Container value needs to be selected from the lookup or a container ID (OR:wt.pdmlink.PDMLinkProduct:142471) needs to be specified.
8. Click
to set an
Expiration Date for limiting the subscription of an event until the selected date. If you do not set an expiration date, the event subscription never expires.
9. Select a Life Cycle State. This field value is applicable only in case of Event - Life Cycle State. For any other event subscription, value provided for this field will be ignored.
10. In the Custom Filters section, click ADD, and then enter the following details:
◦ Input
◦ Expected—The expected output.
◦ Condition—Condition to apply on the filters such as equals, greater than, less than, contains, does not contain, matches, and so on.
Click ADD to set multiple custom filtering criteria.
11. Click SAVE.