Dienste im WorkflowSubsystem in ThingWorx Composer ausführen
Voraussetzungen
Stellen Sie sicher, dass Sie die folgenden Voraussetzungen erfüllen, bevor Sie die Dienste in ThingWorx Composer ausführen:
• Der ThingWorx Flow Server muss ausgeführt werden.
• Sie sind bei ThingWorx als Administrator angemeldet.
Schritte
1. Klicken Sie im ThingWorx Flow Dashboard auf Composer, um zu ThingWorx Composer zu navigieren.
2. Wählen Sie in ThingWorx Composer unter System die Option Untersysteme aus.
3. Wählen Sie WorkflowSubsystem aus, und klicken Sie auf die Registerkarte Dienste. Die folgenden Dienste sind für ThingWorx Flow verfügbar:
4. Suchen Sie nach dem Dienst, und führen Sie eine der folgenden Aufgaben aus:
◦ Wählen Sie den Dienst aus, um seine Eingabe- und Ausgabeinformationen anzuzeigen.
◦ Klicken Sie auf 
. Geben Sie die entsprechenden Eingabewerte an, und klicken Sie auf Ausführen.
. Geben Sie die entsprechenden Eingabewerte an, und klicken Sie auf Ausführen.Dienste
LoadOAuthConfiguration
Verwenden Sie diesen Dienst, um die JSON-Datei der OAuth-Konfiguration auf den ThingWorx Flow Server zu laden. Dieser Dienst aktualisiert OAuth-Anbieter für in der JSON-Datei angegebene Konnektoren oder fügt diese hinzu. Es werden keine vorhandenen OAuths gelöscht.
Eingabe | Ausgabe | ||
|---|---|---|---|
Parametername | Basistyp | Beschreibung | |
oauthConfigurations | JSON | Geben Sie eine gültige JSON-Datei mit korrekten OAuth-Konfigurationseinstellungen für einen Konnektor an. | Gibt eine Meldung zurück, die den erfolgreichen Abschluss oder die Fehler angibt, die während der Ausführung des Diensts auftreten. |
Beispiel: Um die OAuth-Konfiguration für JIRA zu laden, geben Sie den Wert von oauthConfigurations als
"jira": {
"JIRA": {
"CLIENT_ID": "<Client ID>"
"CLIENT_SECRET": "<Secret>"
}
},
"JIRA": {
"CLIENT_ID": "<Client ID>"
"CLIENT_SECRET": "<Secret>"
}
},
an.
DeleteOAuthConfiguration
Verwenden Sie diesen Dienst, um eine OAuth-Konfiguration vom ThingWorx Flow Server zu löschen, wenn der OAuth-Anbieter nicht von einem Konnektor verwendet wird.
Eingabe | Ausgabe | ||
|---|---|---|---|
Parametername | Basistyp | Beschreibung | |
Connector config name | String | Geben Sie einen
gültigen Wert einer Konnektorkonfiguration an, deren OAuth-Konfigurationseinstellungen Sie löschen möchten. | Gibt eine Meldung zurück, die den erfolgreichen Abschluss oder die Fehler angibt, die während der Ausführung des Diensts auftreten. |
OAuth provider | String | Geben Sie einen gültigen OAuth-Anbieter für den angegebenen Konnektor an. | |
Um die gleiche OAuth-Konfiguration für JIRA zu löschen, geben Sie den Wert des Felds Connector config name als jira und den des Felds OAuth provider als JIRA an.
GetOAuthConfiguration
Verwenden Sie diesen Dienst, um die Liste der Konnektoren abzurufen, für die OAuths auf den ThingWorx Flow Server geladen werden. Vertrauliche Informationen wie Client-IDs, Client-Verschlüsselungswörter und URLs werden nicht angezeigt.
Eingabe | Ausgabe | ||
|---|---|---|---|
Parametername | Basistyp | Beschreibung | |
– | – | - | Gibt ein JSON-Objekt mit dem Namen des Konnektors und den OAuth-Anbieternamen aller auf den ThingWorx Flow Server geladenen OAuths zurück. |
ValidateFlowSetup
Führen Sie diesen Dienst aus, um zu verifizieren, dass ThingWorx mit ThingWorx Flow Diensten kommunizieren kann.
Eingabe | Ausgabe | ||
|---|---|---|---|
Parametername | Basistyp | Beschreibung | |
– | – | – | Gibt eine Meldung zurück, die den erfolgreichen Abschluss oder die Fehler angibt, die während der Ausführung des Diensts auftreten. |
Bei Konnektivitätsproblemen zwischen ThingWorx und ThingWorx Flow Diensten werden die nachfolgenden Fehlercodes und Meldungen angezeigt.
Fehlercode | Fehlermeldung |
|---|---|
[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. |