はじめに
次の記事では、CAIプロセスを非同期モード(CAIプロセスが完了する前にレスポンスを返す)とする実装方法を確認しました。
CAIを非同期モードに構成した場合、実行結果を後から確認したい場合もあると思います。この記事では、実行済みのCAIプロセスのステータスを取得する方法を説明します。
なお、この記事は次の記事の内容を理解していることを前提としています。
プロセスIDからステータスを確認する
プロセスIDからステータスを確認するには、CAIプロセスのデプロイ先別に次のURLを使用して基本認証にてGETリクエストを実行します。
- クラウドサーバー
https://<Informatica Cloud Application Integration URL>/active-bpel/restadmin/processes/?processId=<プロセスID> - Secure Agent
http://<agentName>:<httpPortNumber>/process-engine/restadmin/processes/?processId=<プロセスID>
ステータスはprocessStateとして表示され、次のタイプがあります。
ステータス(日本語) | ステータスの意味 |
---|---|
Running(実行中) | プロセスは正常に実行中です。 |
Suspended(一時停止中) | 何らかの理由でプロセスが一時停止しています。 |
Completed(完了) | 正常に完了しています。 |
Faulted(フォルト) | プロセスはフォールトで終了しています。 |
Compensatable(補償可能) | サブプロセスが完了し、補償の対象となっています。 |
クラウドサーバーでの確認例
プロセスの作成と実行(匿名アクセスと基本認証)で作成した recipe-pca-HelloWorld を実行して、プロセスIDをアプリケーション統合コンソールから確認します。次の例ではプロセスIDは1049154077944557568
です。
なお、この例ではURLの表示よりIICS・CAIサーバーのFQDNは usw5-cai.dm-us.informaticacloud.com であることがわかります。
確認したプロセスIDと、IICSサーバーのFQDNを指定して、CAIプロセスのステータスを確認します。
// curl コマンド(見やすいようにjqコマンドで整形してます)
curl -u username:password https://<IICS・CAIサーバー>/active-bpel/restadmin/processes/?processId=1049154077944557568 | jq
// 実行結果
{
"totalRowCount": 1,
"completeRowCount": true,
"process": [
{
"processId": "1049154077944557568",
"processState": "COMPLETED",
"processStateReason": null,
"processName": {
"value": "recipe-pca-HelloWorld",
"namespace": "urn:screenflow:process:recipe-pca-HelloWorld"
},
"title": "recipe-pca-HelloWorld",
"planId": "1049153518378254336",
"cid": "1049153517958823936",
"version": 3,
"persistenceType": "BRIEF",
"processGroup": "RT.User",
"processInitiator": null,
"processInitiatorTenantContext": null,
"tenantContext": "<利用環境のOrgID>",
"started": "2024-12-05T02:43:44.522+00:00",
"modified": "2024-12-05T02:43:45.000+00:00",
"completed": "2024-12-05T02:43:44.833+00:00"
}
]
}
Secure Agentサーバーでの確認例
プロセス実行環境の切り替え(Secure Agent環境での実行)で作成した recipe-psa-HelloWorld を実行して、プロセスIDをアプリケーション統合コンソールから確認します。次の例ではプロセスIDは3508
です。
確認したプロセスIDと、Secure AgentサーバーのFQDN、ポートを指定してCAIプロセスのステータスを確認します。
// curl コマンド(見やすいようにjqコマンドで整形してます)
curl -u username:password http://localhost:7080/process-engine/restadmin/processes/?processId=3508 | jq
// 実行結果
{
"totalRowCount": 1,
"completeRowCount": true,
"process": [
{
"processId": "3508",
"processState": "COMPLETED",
"processStateReason": null,
"processName": {
"value": "recipe-psa-HelloWorld",
"namespace": "urn:screenflow:process:recipe-psa-HelloWorld"
},
"title": "recipe-psa-HelloWorld",
"planId": "276",
"cid": "91",
"version": 1,
"persistenceType": "FINAL",
"processGroup": "RT.User",
"processInitiator": null,
"processInitiatorTenantContext": null,
"tenantContext": "$public",
"started": "2024-12-05T03:55:14.040+00:00",
"modified": "2024-12-05T03:55:14.639+00:00",
"completed": "2024-12-05T03:55:14.635+00:00"
}
]
}