はじめに
IICSが提供しているREST APIは、サービス接続を作成することでも実行できますが、アプリケーション接続(IICS API)を利用するとサービス接続の定義する必要なくREST APIを実行できます。
この記事では、アプリケーション接続(IICS API)を利用してIICSが提供しているREST APIを実行する手順を確認します。
この記事は次の記事の内容を理解していることを前提としています。
IICS API接続の作成と利用
IICS API接続の作成
次の手順でアプリケーション接続(IICS API)を作成します。
-
IICSにログインして アプリケーション統合 のページに移動、 新規メニュー を選択して アプリケーション接続 の作成画面を表示します。
-
利用可能なアプリケーション接続の一覧が表示されます。検索ボックスに IICS API と入力して接続タイプをフィルタ後に IICS API Version V2 を選択します。
-
アプリケーション接続の名前は recipe-appConn-IICSAPIv2 として、以下の接続プロパティを指定します。
- IcsLoginUrl ... IICSへのログインURL
- Username ... IICSのログインユーザー名
-
Password ... IICSのログインユーザーのパスワード
参考までの情報となりますが、以下はUS AWS PODを利用している場合の設定例です。
-
保存後にパブリッシュを実行します。パブリッシュ完了後、メタデータ タブを表示すると実行可能なアクションの一覧を確認できます。
CAIプロセスの作成と動作確認
次の手順でCAIプロセスにてアプリケーション接続(IICS API)を作成します。なお、今回はActivity Monitor(実行中タスク情報)を取得するアクションを利用します。
-
CAIプロセスを次の設定で作成します。
- 名前を recipe-pca-appConnIICSAPIv2 とする
- 匿名アクセス を許可する
- クラウドサーバー にデプロイする
-
サービスステップ を追加して アプリケーション接続 recipe-appConn-IICSAPIv2 によりアクション Login を実行するように指定します。
-
サービスステップ を追加して アプリケーション接続 recipe-appConn-IICSAPIv2 によりアクション Activity Monitor を実行するように指定します。
出力フィールドのタイプが ActivityMonitorEntry(リスト) であることを確認します。 -
入力フィールドタブ に切り替えて次のように指定します。
ここでは、step2で実行したサービスステップの出力フィールドを、アプリケーション接続(IICS API)の入力フィールドとして設定しています。 -
出力フィールド out を定義して以下のように定義します。
ここで指定しているタイプは、Step3で確認したアクション Activity Monitor の出力フィールドと一致するようにします。 -
割り当てステップ を追加して次のように指定します。
-
保存してパブリッシュします。
マッピングタスクを実行した状態にて、curlコマンドによりCAIプロセスを実行すると、以下のように実行中タスクの情報が得られる動作を確認できます。
// curl コマンド
curl curl https://<IICS・CAIサーバー>/active-bpel/public/rt/<Org ID>/recipe-pca-appConnIICSAPIv2
// 実行結果
{
"out": [
{
"Id": "01A26R0E0000000016QX",
"Type": "MTT_TEST",
"TaskName": "m_dummy_sleep_java",
"ObjectName": null,
"RunId": "5",
"StartTime": "2025-12-05T10:13:17Z",
"EndTime": null,
"ExecutionState": "RUNNING",
"FailedSourceRows": 0,
"FailedTargetRows": 0,
"SuccessSourceRows": 0,
"SuccessTargetRows": 0,
"ErrorMsg": null,
"Entries": null,
"AgentId": "01A26R0800000000000M",
"RuntimeEnvironmentId": "01A26R25000000000003"
}
]
}
おわりに
アプリケーション接続(IICS API)で提供しているアクションについては、以下のように製品ドキュメントにも記載があるのですが、全てのアクションが綺麗に記載されている訳ではないようにも見えました。今後、利用可能なアクションについて確認してこの記事をブラッシュアップできたら良いなと考えています。
