このページでは次のカテゴリを対象に、CAIの開発時にお役立ていただける記事を体系的にまとめています。
- 基礎
- XQueryと関数を利用した実装
- サービス接続
- ファイル処理
- DB操作
- その他のアプリケーション接続/IICSとの連携
- CAIを利用したCDIの動作検証
- 運用監視
- トラブルシューティング
- 意図しないエラーを発生させて製品動作を理解する
なお、[CAIレシピ]では特に記載のない限りLinux環境にインストールしたSecure Agentを利用して、Linux環境にて動作確認を行っております。
実装レシピ
基礎
- はじめてCAIを使う際に
- プロセスの作成と実行(匿名アクセスと基本認証)
- プロセス実行環境の切り替え(Secure Agent環境での実行)
- Secure Agent環境の証明書入れ替え
- プロセスのデプロイ先・認証方法によるサービスURLの違い
- API Managerを利用したプロセスの実行 * EOL
- 割り当てステップと、各種変数フィールドの利用
- プロセスIDの取得と、アプリケーション統合コンソールとの突き合わせ
- デバッグのためのログレベル
- 待機ステップによるスリープ処理
- マイルストーンステップによる非同期実行
- 終了ステップによるHTTPレスポンスコード/ヘッダーの設定
- ディシジョンステップによるによる分岐処理
- ジャンプステップによる実行制御
- 並列パスステップによる同時実行制御
- スローステップを利用してエラーを発生させる * NEW
- サブプロセスの実行と非同期実行 * NEW
- OSコマンドの実行
- プロセスオブジェクトによるユーザー定義変数の利用
- リスト型のプロセスオブジェクト変数の利用
- メッセージ処理による同期実行 * NEW
- スケジューラによるCAIプロセスの実行 * NEW
XQueryと関数を利用した実装
- CAIでXQueryを利用する時に覚えておきたいこと
- XQuery+XPathサンプル
- CAIプロセス実行時のプロトコル(HTTP/HTTPS)を確認する
- CAIプロセス実行時の動詞(GET, POSTなど)/ResourcePathに応じた処理
- CAIプロセス呼び出し元IPアドレスの取得
- 環境移行のための設定を変数化する - URNマッピング * NEW
サービス接続
- サービス接続によるREST APIの実行
- 動的なURLを使用するサービス接続
- BASIC認証を使用するサービス接続
- サービス接続をSwaggerファイルから作成する * NEW
- HTTPレスポンスコード/ヘッダーを扱うサービス接続
- REST APIによりファイルを取得するサービス接続
- サービス接続で生成したプロセスオブジェクトを、CAIプロセスの入力フィールドとして利用する * NEW
ファイル処理
- ファイルの存在チェック
- テキストファイルの作成
- CSVファイル読み込み・CSVファイル書き出し
- CSVファイル読み込み・CSVファイル書き出し(動的ヘッダー)
- CSVファイル読み込み、XMLファイル書き出し
- XMLファイル読み込み、CSVファイル書き出し
- XMLファイル読み込み、JSONファイル書き出し
- ファイルアップロードとSecure Agent環境への保存(multipart/form-data)
- Secure Agent実行環境のファイルダウンロード
- ファイルの監視と処理(CSVファイル)
- ファイルの監視と処理(固定長ファイル)
DB操作
- DBを操作するためのアプリケーション接続設定 * NEW
- DBデータの取得(SELECT) * NEW
- DBデータの登録(INSERT) * NEW
- DBデータの更新(UPDATE) * NEW
- DBデータの削除(DELETE) * NEW
- DASによるSQL実行 * NEW
- DASによるストアドプロシージャ実行とストアドファンクションの実行 * NEW
- アプリケーション接続(JDBC)の処理性能 * NEW
その他のアプリケーション接続/IICSとの連携
- CAIプロセスにてメール通知するには？ * NEW
- IICS API接続によるIICS REST APIの実行 * NEW
- IICSの様々なタスクを実行する * NEW
CAIを利用したCDIの動作検証
- REST V2接続の検証 * NEW
- Web Service Consumer接続の検証 * NEW
- OData Consumer接続の検証 * NEW
運用監視
トラブルシューティング
- JDBC接続利用時のSQLトレース方法 * NEW
- HTTP Request/Responseのトレース方法
意図しないエラーを発生させて製品動作を理解する
おわりに
私が社会人をプログラマとしてスタートした時、お世話になった書籍は 秀和システムさんの逆引き大全シリーズ と 技術評論社さんのSQLポケットリファレンス でした。体系的に情報がまとめられており、かけだしプログラマーの私にはバイブル的な存在でした。
CAIはプログラミング要素の強い製品であり、体系的に・順を追って製品の理解を深めてゆく必要があると感じています(例えば、CSVファイルの読み込み・書き出し処理を実装したい場合は、まずは基本的なCAIプロセスの作り方、割り当てステップの使い方、プロセスオブジェクトの使い方、XQueryの使い方、アプリケーション接続の使い方を理解する必要があります)。しかし、残念ながら2024年時点では、CAIの実装を体系的に・順を追って理解を深められる情報はありませんでした。
このような現状を踏まえてQiitaの場を借りて、CAIの実装レシピをまとめてみました。一連のCAIレシピが、CAIエンジニアにとってのバイブル的な存在になってくれると嬉しいなと思っています。
2024年12月時点では、紹介したい未投稿のレシピが多数あります。 2025年12月末までには現状でリンクのないレシピを全てお見せできるように頑張りたいと思っています。もし良ければイイね！をいただけると、とても励みになります！！