Configuring the MPMLink OData Connector
The work instructions building block includes Things that retrieve data from Windchill MPMLink and store it in ThingWorx. The MPMLink OData connector Thing (PTC.SCA.SCO.MPMLink_ODataConnector) is based on the OData connector Thing Template (ODataConnector).
Configure the MPMLink OData connector Thing to connect to the OData domain where all the Windchill MPMLink services reside.
 |
To customize the connector, for example, by overriding any of the services, make a duplicate and configure it as described in this topic. For more information, see Duplicating Building Block Entities.
|
1. Under Generic Connector Connection Settings, set Authentication Type to the appropriate value:
◦ Fixed for basic authentication.
◦ SSO for single sign-on authentication. For more information, see Single Sign-on Authentication in the ThingWorx Help Center.
◦ None if you are configuring to use Windchill for authentication. For more information, see Configuring the Work Instructions Building Block for Session
User (Windchill Authentication).
2. Under CSRF Settings, the Relative URL For CSRF Get Request field is pre-populated with the default value /servlet/odata. Enter a value pointing to a valid Windchill resource that can return a CSRF nonce token. For more information on CSRF GET requests, see Function to Get the Value of Nonce Token in the Windchill REST Services Help Center.
3. Under HTTP Connector Connection Settings, update the fields as needed for your system.
◦ Username and Password—For the Fixed authentication type, enter the credentials for a Windchill user who is authorized to request data from Windchill MPMLink. For SSO and None, leave these fields blank.
◦ Base URL—Specify the base URL for the Windchill MPMLink system, for example, https://<hostname>:<port>/Windchill. Ensure that you specify the appropriate transport mechanism (http or https) in the URL. For SSO, enter a URL that supports OAuth.
◦ Relative URL—URL on which the OData services reside, relative to the Base URL. For example, the default value is: /servlet/odata
|
|
As a REST client for Windchill REST Services (WRS), the work instructions building block uses specific versions of certain WRS domains. These domains and versions are the default Service Root Relative URL values that are specified in the OData Connector Connection Settings configuration table:
• /v4/MfgProcMgmt
• /v5/ProdMgmt
• /v3/NavCriteria
Specifying other domain versions in the Relative URL field is not supported, and can result in errors when the work instructions building block attempts to communicate with Windchill.
For more information, see Windchill REST Services Domains Used in Process Plan Conversion.
|
Connection URL—URL used to verify the connection. This value is relative to the Base URL value.
The full paths to the OData domains are constructed from the Base URL value, plus the Relative URL value, followed by the Service Root Relative URL for each OData domain that is specified in the OData Connection Connector Settings configuration table.
4. Update the MPMLink work definition converter as necessary to reference your configured MPMLink OData connector. For more information, see Configuring the MPMLink Work Definition Converter.
|
|
If you have configured the Integration Runtime Service before configuring the MPMLink OData connector, restart the Integration Runtime Service before converting any process plans.
|
The configuration values on the configured MPMLink OData connector Thing and the content proxy media entity (PTC.SCA.SCO.OperatorAdvisorContentProxyMediaEntity) must match. This table maps the configuration options on the MPMLink OData connector Thing with the corresponding options on the content proxy media entity.
|
MPMLink OData Connector Thing Property
|
Content Proxy Media Entity Property
|
|---|---|
|
Authentication Type—Fixed
|
Authentication Type—basic
|
|
Authentication Type—SSO
|
Authentication Type—SSO
|
|
Authentication Type—None
|
Authentication Type—Session User
|
|
Base URL
|
URL
|
For more information on configuring OData connectors, see Getting Started Using Integration Connectors in the ThingWorx Help Center.
To create a custom OData connector, use the MPMLink OData connector as an example, and refer to Creating Integration Connectors in the ThingWorx Help Center for more information.