ThingWorx Composer の WorkflowSubsystem でのサービスの実行
必要条件
ThingWorx Composer でサービスを実行する前に、以下の前提条件を満たしていることを確認してください。
• ThingWorx Flow サーバーが実行されていること。
• ThingWorx に管理者としてログインしていること。
ステップ
1. ThingWorx Flow ダッシュボードで、「Composer」をクリックして ThingWorx Composer に移動します。
2. ThingWorx Composer の「システム」で、「サブシステム」を選択します。
3. 「WorkflowSubsystem」を選択し、「サービス」タブをクリックします。ThingWorx Flow では、次のサービスを使用できます。
4. サービスをサーチし、次のいずれかのタスクを実行します。
◦ サービスを選択して、その入力と出力の情報を表示します。
◦ 
をクリックします。適切な入力値を指定し、「実行」をクリックします。
をクリックします。適切な入力値を指定し、「実行」をクリックします。サービス
LoadOAuthConfiguration
このサービスを使用して、OAuth コンフィギュレーションの JSON ファイルを ThingWorx Flow サーバーにロードします。このサービスは、JSON ファイルで指定されているコネクタに対する OAuth プロバイダを更新または追加します。既存の OAuth は削除されません。
入力 | 出力 | ||
|---|---|---|---|
パラメータ名 | ベースタイプ | 説明 | |
oauthConfigurations | JSON | コネクタに対する正しい OAuth コンフィギュレーション設定を含む有効な JSON ファイルを指定します。 | 正常に完了したこと、またはサービスの実行中に発生したエラーを示すメッセージを返します。 |
例: JIRA に対する OAuth コンフィギュレーションをロードするには、oauthConfigurations の値を
"jira": {
"JIRA": {
"CLIENT_ID": "<Client ID>"
"CLIENT_SECRET": "<Secret>"
}
},
"JIRA": {
"CLIENT_ID": "<Client ID>"
"CLIENT_SECRET": "<Secret>"
}
},
に指定します。
DeleteOAuthConfiguration
このサービスは、Oauth プロバイダがどのコネクタによっても使用されていない場合に、ThingWorx Flow サーバーから OAuth コンフィギュレーションを削除するときに使用します。
入力 | 出力 | ||
|---|---|---|---|
パラメータ名 | ベースタイプ | 説明 | |
Connector config name | 文字列 | 削除する OAuth コンフィギュレーション設定を含む
有効なコネクタコンフィギュレーション値を指定します。 | 正常に完了したこと、またはサービスの実行中に発生したエラーを示すメッセージを返します。 |
OAuth provider | 文字列 | 指定されたコネクタの有効な OAuth プロバイダを指定します。 | |
JIRA に対する同じ OAuth コンフィギュレーションを削除するには、Connector config name フィールドを jira に指定し、OAuth provider フィールドを JIRA に指定します。
GetOAuthConfiguration
このサービスを使用して、OAuth が ThingWorx Flow サーバーにロードされているコネクタのリストを取得します。クライアント ID、クライアントシークレット、URL などの機密情報は表示されません。
入力 | 出力 | ||
|---|---|---|---|
パラメータ名 | ベースタイプ | 説明 | |
– | – | - | ThingWorx Flow サーバーにロードされているすべての OAuth のコネクタ名と OAuth プロバイダ名を提供する JSON を返します。 |
ValidateFlowSetup
このサービスを実行して、ThingWorx が ThingWorx Flow サービスと通信できるかどうかを確認します。
入力 | 出力 | ||
|---|---|---|---|
パラメータ名 | ベースタイプ | 説明 | |
– | – | – | 正常に完了したこと、またはサービスの実行中に発生したエラーを示すメッセージを返します。 |
ThingWorx と ThingWorx Flow サービスの間で接続の問題が発生した場合、次のエラーコードとメッセージが表示されます。
エラーコード | エラーメッセージ |
|---|---|
[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. |