ThingWorx Flow > Instalación y administración de ThingWorx Flow > Administración de ThingWorx Flow > Ejecución de servicios en el subsistema de flujo de trabajo en ThingWorx Composer
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.
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>"
}
},
.
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.
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. Ensure that you are accessing an Nginx-hosted ThingWorx instance. ThingWorx Flow is not supported on a Tomcat-hosted ThingWorx. Ensure that all ThingWorx Flow services are running and are healthy. In case of self-signed certificate, make sure that correct CN is provided.
[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 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.