Ejecución de servicios Info*Engine con OData Connector
ThingWorx Navigate ahora soporta el conector OData para ejecutar tareas de Info*Engine. Si las tareas personalizadas utilizan tareas de Info*Engine, utilice el conector OData para llamar a las tareas de Info*Engine.
Para obtener la información más actualizada sobre el soporte del conector OData para
Windchill, consulte
Platform Support Matrix for ThingWorx Navigate.
|
|
En versiones futuras de ThingWorx Navigate, quedará desfasado el soporte para los conectores de Windchill, ptc-windchill-connector y ptc-windchill-swagger-connector. Para realizar una transición fluida a una versión que no soporta los conectores anteriores de Windchill, ahora es necesario ejecutar las tareas de Info*Engine con ptc-windchill-OData-connector siguiendo los pasos que se detallan en este tema.
|
Para utilizar el conector OData con el fin de ejecutar tareas de Info*Engine, primero se debe configurar ptc-windchill-OData-connector para la conexión a los servicios REST Odata de Windchill del dominio de Info*Engine. Después, los servicios REST Odata de Windchill se pueden utilizar para ejecutar tareas de Info*Engine.
|
|
La instancia de Integration Runtime se debe configurar. Para obtener más información, consulte el tema "Configuración de Integration Runtime" en el manual Instalación de ThingWorx Navigate 8.5. • Al configurar ptc-windchill-OData-connector, es necesario volver a crear cualquier personalización anterior que se haya realizado en ptc-windchill-OData-connector de fábrica.
|
1. En ThingWorx Composer, busque ptc-windchill-OData-connector y ábralo. Se abre la página Información general.
2. Pulse en Configuración. Se abre la página Configuración.
La configuración depende del método de autenticación: inicio de sesión único, autenticación de Windchill o autenticación fija.
Inicio de sesión único
Si se ha configurado el inicio de sesión único, siga estos pasos:
1. En Configuración de conexión del conector genérico, para Tipo de autenticación, seleccione SSO.
2. En ID del servidor de autorización, introduzca el valor de AuthorizationServerSettingsID que se ha proporcionado en sso-settings.json, como PingFed1.
3. En Configuración de ámbitos de servidor de autorización, pulse en Añadir. Se abre la ventana AuthorizationServerScopesSettings.
4. En Ámbito, introduzca el ámbito de Windchill que se ha registrado en PingFederate, como WINDCHILL.
5. Pulse en Añadir.
6. En Configuración de CSRF, introduzca esta información:
◦ URL relativa para la solicitud Get de CSRF: servlet/odata
◦ Nombre de token CSRF: CSRF_NONCE
7. En Configuración de conexión del conector HTTP, introduzca esta información:
◦ URL base: el URL de Windchill. El URL debe finalizar en /oauth. Utilice este formato:
[https]://[Windchill Host]:[port]/[Windchill-web-app]/oauth
Este formato permite especificar que la conexión utiliza el estándar OAuth y permite las solicitudes de datos en el proveedor de recursos.
◦ URL relativo: /servlet/odata
No es necesario introducir el nombre de usuario y la contraseña.
8. Pulse en Guardar. El conector OData está configurado ahora para funcionar en el entorno de inicio de sesión único.
Ahora vaya hasta la sección "Ejecución de las tareas de Info*Engine".
Autenticación de Windchill
Si se ha configurado la autenticación de Windchill, siga estos pasos:
1. En Configuración de conexión del conector genérico, para Tipo de autenticación, seleccione None.
2. En Configuración de CSRF, introduzca esta información:
◦ URL relativa para la solicitud Get de CSRF: servlet/odata
◦ Nombre de token CSRF: CSRF_NONCE
3. En Configuración de conexión del conector HTTP, introduzca esta información:
◦ URL base: el servidor Windchill que recibe la solicitud Info*Engine de ODataConnector. Utilice este formato:
[https]://[Windchill Host]:[port]/[Windchill-web-app]/sslClientAuth
◦ URL relativo: /servlet/odata
◦ URL de conexión: /servlet/WindchillGW/wt.httpgw.HTTPServer/ping
No es necesario introducir un nombre de usuario y una contraseña.
4. Pulse en Guardar.
Ahora vaya hasta la sección "Ejecución de las tareas de Info*Engine".
Autenticación fija
Si se ha configurado la autenticación fija, siga los pasos para configurar el conector OData:
1. En Configuración de conexión del conector genérico, para Tipo de autenticación, seleccione Fixed.
2. En Configuración de CSRF, introduzca esta información:
◦ URL relativa para la solicitud Get de CSRF: servlet/odata
◦ Nombre de token CSRF: CSRF_NONCE
3. En Configuración de conexión del conector HTTP, introduzca esta información:
◦ Nombre de usuario: nombre de usuario del administrador de Windchill.
◦ Contraseña: la contraseña de administrador de Windchill
◦ URL base: el servidor Windchill que recibe la solicitud Info*Engine de ODataConnector. Utilice este formato:
[https]://[Windchill Host]:[port]/[Windchill-web-app]
◦ URL relativo: /servlet/odata
4. Pulse en Guardar. El conector OData está configurado ahora para funcionar en el entorno de autenticación fija.
Vaya hasta la sección "Ejecución de las tareas de Info*Engine".
Ejecución de las tareas de Info*Engine
Ahora, ejecute las tareas de Info*Engine con el servicio:
1. Pulse en Servicios. Se abre la página Servicios.
2. Para
RefreshEndpointCache, pulse en
. Se abre la ventana
Ejecutar servicio.
3. Pulse en Ejecutar. Se debe recibir el mensaje: Correcto. El servicio se ha ejecutado correctamente.
4. Pulse en Terminado.
5. Para
InvokeIETask, pulse en
.
6. En la ventana Entrada, añada la siguiente información en formato JSON:
◦ Task: el fichero XML de la tarea de Info*Engine. El fichero se encuentra aquí: <Instalación de Windchill>/<Windchill_Home>/tasks/.
| Asegúrese de que la tarea esté activada para la ejecución. Para ello, verifique que el siguiente markup aparece al principio del fichero XML: <%@page language="java" access="http"%> |
◦ Params: (opcional) una matriz JSON que contiene pares de nombre y valor para transferir como parámetro a la tarea de Info*Engine.
Ejemplo:
{
"Task": "wt/federation/delegates/windchill/QueryObjects.xml",
"Params": [
{ "Name": "type", "Value": "wt.part.WTPart" },
{ "Name": "where", "Value": "name=SOME_PART_NAME" }
]
}
7. Pulse en Ejecutar para iniciar la tarea de Info*Engine. La salida del servicio se encuentra en formato JSON y contiene las siguientes propiedades:
◦ @odata.context: el URL de contexto para la carga útil.
◦ Value: una matriz JSON que contiene objetos JSON con las propiedades Groupname y Element.
8. Para ejecutar otra tarea de Info*Engine, se deben repetir los pasos del 1 al 7.
| Puede que los extremos del conector OData no funcionen según lo previsto en ThingWorx Navigate y, como resultado, es posible que sea necesario realizar cambios. Para ver los detalles y obtener instrucciones sobre cómo configurar los servicios de OData en los datos de Windchill, consulte el manual Windchill REST Services User's Guide. |
