Magic xpiでIBMiをRESTサーバー化する

Magic xpiはIBMiのような企業内の基幹システムや各種アプリケーション、クラウドサービスをノーコーディングで連携・統合を可能とするシステム連携プラットフォームです。

今回Magic xpi設定例としてMagic xpiのHTTPトリガーを用い、WebサーバーへのURLリクエストを検知し、IBMiデータベースへ照会を行い、照会結果をjson形式で返す手順をご紹介いたします。リクエストを行うHTTPクライアント(RESTクライント)から見るとIBMiがRESTサーバーの振る舞いをします。

動画で解説

動作概要

①見積り内容照会をWeb越しに行います。例えば下図のようなWeb照会画面を作成し「見積もり番号」欄に照会したい見積もり番号を入力後、「見積照会」ボタンをクリックします。

「見積照会」ボタンをクリックすると②Magic xpi提供のWebサーバーに設定したエンドポイントである「mitumori」宛てに、照会したい見積り番号を意味する引数noに指定した見積り番号でリクエストをします。③Magic xpiはエンドポイント「mitumori」へのリクエストを監視しています。④リクエストを検知するとIBMiへ引数noに指定した見積もり番号でIBMiへSQLを投入し照会します。⑤照会結果をjson形式に変換し、返信(レスポンス)の準備とします。⑥レスポンスヘッダーを作成し、⑦照会結果を返信(レスポンス)します。

実際の設定では下図のように3つの手順となっています。①エンドポイント監視であるHTTPトリガーを配置し、②リクエストを検知した場合、データマッパーを用いIBMiへSQLを投入し、照会結果をjson形式に変換しています。③レスポンスヘッダーにはお約束のContent-Type: application/json; やcharset=utf-8、必要があればクッキーなど、ここで指定します。

以降は上記①～③設定解説です。

①エンドポイント監視

事前に監視対象のエンドポイントをプロジェクト-->設定-->サービスから作成します。今回はエンドポイント名を「mitumori」とし、照会する見積もり番号を意味する引数名noを指定しています。

HTTPトリガー自体の設定は下図のように、上記で設定したエンドポイント名「mitumori」を監視し、見積り照会番号を意味する引数名noの内容を変数C.UserStringに格納しています。次ステップの「②IBMiへSQL投入・・・」時に、このC.UserStringに格納した見積り照会番号で検索を行います。照会結果は次ステップの「②IBMiへSQL投入・・」で変数「C.UserBlob」に格納予定ですので、このHTTPトリガー戻値（リクエスト元へ返す照会結果）は「C.UserBlob」を指定しています。