Ejecución de servicios en el subsistema de flujo de trabajo en ThingWorx Composer
Requisitos previos
Antes de ejecutar los servicios en ThingWorx Composer, asegúrese de que se cumplan los siguientes requisitos previos:
• El servidor ThingWorx Flow debe estar en ejecución.
• El usuario se ha conectado a ThingWorx como administrador.
Pasos
1. En el tablero de ThingWorx Flow, pulse en Composer para ir a ThingWorx Composer.
2. En ThingWorx Composer, en Sistema, seleccione Subsistemas.
3. Seleccione Subsistema de flujo de trabajo y pulse en la ficha Servicios. Los siguientes servicios están disponibles para ThingWorx Flow:
4. Busque el servicio y realice una de las siguientes tareas:
◦ Seleccione el servicio para ver la información de entrada y salida.
◦ Pulse en 
. Proporcione los valores de entrada adecuados y pulse en Ejecutar.
. Proporcione los valores de entrada adecuados y pulse en Ejecutar.Servicios
LoadOAuthConfiguration
Utilice este servicio para cargar el fichero JSON de configuración de OAuth en el servidor ThingWorx Flow. Este servicio actualiza o añade proveedores de OAuth para los conectores especificados en el fichero JSON. No se borran los elementos OAuth existentes.
Entrada | Salida | ||
|---|---|---|---|
Nombre del parámetro | Tipo base | Descripción | |
oauthConfigurations | JSON | Proporcione un fichero JSON válido con la configuración de OAuth correcta para un conector. | Permite devolver un mensaje en el que se indica la finalización correcta o los errores que se producen durante la ejecución del servicio. |
Por ejemplo: para cargar la configuración de OAuth para JIRA, proporcione el valor de oauthConfigurations como
"jira": {
"JIRA": {
"CLIENT_ID": "<Client ID>"
"CLIENT_SECRET": "<Secret>"
}
},
"JIRA": {
"CLIENT_ID": "<Client ID>"
"CLIENT_SECRET": "<Secret>"
}
},
.
Consulte Configuración y carga de elementos OAuth para obtener las plantillas de fichero JSON de configuración de OAuth disponibles en ThingWorx Composer
DeleteOAuthConfiguration
Este servicio se utiliza para borrar una configuración de OAuth del servidor ThingWorx Flow, si ningún conector utiliza el proveedor de OAuth.
Entrada | Salida | ||
|---|---|---|---|
Nombre del parámetro | Tipo base | Descripción | |
Connector config name | Cadena | Proporcione un valor de configuración de conector válido cuyas opciones de configuración de OAuth desea borrar. | Permite devolver un mensaje en el que se indica la finalización correcta o los errores que se producen durante la ejecución del servicio. |
OAuth provider | Cadena | Proporcione un proveedor de OAuth válido para el conector especificado. | |
Para borrar la misma configuración de OAuth para JIRA, proporcione el valor del campo Connector config name como jira y del campo OAuth provider como JIRA.
GetOAuthConfiguration
Utilice este servicio para recuperar la lista de conectores para los que se cargan elementos OAuth en el servidor de ThingWorx Flow. No se muestra información confidencial como, por ejemplo, ID de cliente, secretos de cliente y URL.
Entrada | Salida | ||
|---|---|---|---|
Nombre del parámetro | Tipo base | Descripción | |
– | – | - | Permite devolver un JSON que proporciona el nombre del conector y el nombre del proveedor de OAuth de todos los elementos OAuth cargados en el servidor de ThingWorx Flow. |
DeleteOAuthAccessToken
Utilice este servicio para borrar los tokens de acceso de OAuth del proveedor de OAuth especificado.
Entrada | Salida | ||
|---|---|---|---|
Nombre del parámetro | Tipo base | Descripción | |
OAuth provider | Cadena | Proporcione un proveedor de OAuth válido para el servicio o la utilidad de terceros. | Permite devolver un mensaje en el que se indica la finalización correcta o los errores que se producen durante la ejecución del servicio. |
User Name | Cadena | Proporcione el nombre de usuario de ThingWorx del que desea borrar los tokens de acceso generados para el proveedor de OAuth especificado. Este campo es opcional. Si no se especifica un nombre de usuario, el servicio borra todos los tokens de acceso de OAuth de cualquier usuario para el proveedor de OAuth especificado. | |
 | Después de que el servicio borre el token de acceso de OAuth para un proveedor de OAuth, el conector de OAuth (usuario con nombre) aparece con un icono  en el tablero de ThingWorx Flow. |
Después de borrar los tokens de acceso de OAuth de un usuario, los usuarios deben proporcionar su información de autorización para que el conector de OAuth ejecute el flujo de trabajo:
◦ OAuth (usuario con nombre): permite editar el conector de OAuth (usuario con nombre) para proporcionar credenciales y volver a configurar el conector.
◦ OAuth (usuario de la sesión): todos los usuarios que utilicen este conector de OAuth (usuario de la sesión) en su flujo de trabajo deben volver a conectarse y proporcionar aprobaciones y concesiones al servicio o a la utilidad de terceros.
RefreshMetadata
ThingWorx Flow almacena en caché la información de OData de Windchill para mejorar el rendimiento. Si se han modificado las especificaciones de metadatos de Windchill o se han actualizado los atributos simplificados en el servidor Windchill, se debe utilizar este servicio para actualizarlos en el servidor ThingWorx Flow.
Entrada | Salida | ||
|---|---|---|---|
Nombre del parámetro | Tipo base | Descripción | |
connectorName | Cadena | Proporcione el nombre del conector de un servicio de terceros. | Permite devolver un mensaje en el que se indica la finalización correcta o los errores que se producen durante la ejecución del servicio. |
ValidateFlowSetup
Ejecute este servicio para verificar si ThingWorx se puede comunicar con los servicios de ThingWorx Flow.
Entrada | Salida | ||
|---|---|---|---|
Nombre del parámetro | Tipo base | Descripción | |
– | – | – | Permite devolver un mensaje en el que se indica la finalización correcta o los errores que se producen durante la ejecución del servicio. |
En caso de que existan problemas de conectividad entre ThingWorx y los servicios de ThingWorx Flow, se muestran los siguientes códigos de error y mensajes.
Código de error | Mensaje de error |
|---|---|
[FLOW-CONFIG-01] | ThingWorx Flow is not enabled. Add the OrchestrationSettings section to the platform-settings.json file to enable ThingWorx Flow. |
[FLOW-RABBIT-01] | Failed to connect to RabbitMQ. Check whether the RabbitMQ service is running and is accessible. |
[FLOW-API-01] | Failed to connect to ThingWorx Flow. Check ThingWorx logs for more detail. |
[FLOW-API-02] | Failed to connect to ThingWorx Flow. Asegúrese de tener acceso a ThingWorx través del nombre de host ThingWorx Flow y el puerto una vez ThingWorx Flow se haya instalado. De lo contrario, ThingWorx Flow y ThingWorx no se podrán comunicar entre sí. |
[FLOW-KEY-01] | OAuth admin key not found in the ThingWorx KeyStore. |
[FLOW-KEY-02] | Exchange admin key not found in the ThingWorx KeyStore. |
[FLOW-KEY-03] | Failed to get ThingWorx Flow keys from the ThingWorx KeyStore. |
[FLOW-KEY-04] | Failed to get ThingWorx Flow keys from the ThingWorx KeyStore. |
[FLOW-EXCHANGE-01] | Failed to connect to ThingWorx Flow exchange service. Check ThingWorx logs for more details. |
[FLOW-EXCHANGE-02] | Failed to connect to ThingWorx Flow exchange service. Check whether ThingWorx Flow exchange service is up and running. |
[FLOW-OAUTH-01] | Failed to connect to ThingWorx Flow OAuth service. Check ThingWorx logs for more details. |
[FLOW-OAUTH-02] | Failed to connect to ThingWorx Flow OAuth service. Check whether ThingWorx Flow OAuth service is up and running. |