REST V2コネクタ > REST V2コネクタを使用したマッピングとマッピングタスク > マッピングにおけるRESTミッドストリームトランスフォーメーション
  

マッピングにおけるRESTミッドストリームトランスフォーメーション

ミッドストリームトランスフォーメーションを設定する前に、[新規] > [コンポーネント]タブで、ビジネスサービスを作成する必要があります。ビジネスサービスを作成する際、REST V2接続と操作を選択する必要があります。
ミッドストリームトランスフォーメーションを設定する際、[Webサービス]タブでビジネスサービスと操作を選択します。
[要求マッピング]タブで、ソースファイルから入力フィールドを要求構造内の要素にマッピングできます。
応答構造は、フィールドマッピングに表示できます。応答構造の要素を出力フィールドにマッピングすると、Secure Agentは出力グループを作成し、加えて、フィールド名のプライマリキーと外部キーを作成します。

詳細ミッドストリームプロパティ

以下の表に、ミッドストリームトランスフォーメーションで設定できる詳細プロパティを示します。
プロパティ
説明
ページングタイプ
次のいずれかの値を指定します。
ページ。ページングを有効にして、[ページパラメータ]、[開始ページ]、[終了ページ]、[応答終了式]の各プロパティ値を考慮します。
なし。[ページパラメータ]、[開始ページ]、[終了ページ]、[応答終了式]のプロパティ値を無視します。
ページパラメータ
ページング操作で使用するパラメータの名前。クエリパラメータまたはパスパラメータを使用できます。
パラメータは整数型で、要求メッセージから抽出されます。
開始ページ
ページ操作の実行範囲の最初のページを示すページ番号。
終了ページ
ページ操作の実行範囲の最後のページを示すページ番号。デフォルトは10000です。
ページングは、終了ページに達するか、応答終了式が満たされると停止します。
ページ増分ファクタ
ページパラメータを増分する整数。ページ増分ファクタは、要求ごとにフェッチされるレコード数と同じにする必要があります。ページ増分ファクタオプションが、要求ごとにフェッチされるレコード数と同じでない場合、2つのコール間でレコードがなかったり重複したりすることが発生します。
応答終了式
ページングを制御する式または文字列を指定します。次のいずれかの動作になります。
  • - 文字列または式を指定した場合、値がページ応答と一致すると、ページングが停止します。応答終了と一致するページは解析されません。
  • - 文字列も式も指定しない場合、空のページかNull応答に到達したところでページングが停止します。空のページまたはNull応答が発生しない場合、ページングはデフォルトの終了ページで停止します。
  • - 終了ページと応答終了式の両方を指定すると、先に満たされた条件に応じてページングが停止します。
  • - 終了ページも応答終了式も指定しない場合、空のページかNull応答に到達したところでページングが停止します。空のページまたはNull応答が発生しない場合、ページングはデフォルトの終了ページで停止します。
URLの上書き
Swagger仕様で指定されているURLを上書きします。URLの上書きではクエリパラメータを使用できません。パスパラメータを[URLの上書き]に含める場合は、パスパラメータを中かっこ{}で囲むようにしてください。例:
Swagger仕様で指定されているURL: http://invr28pers102:13080/sample/day/20170505?a:b
20170505をパス変数として変数名をpath1と定義すると、URLの上書きにより、http://invr28pers102:13080/sample/day/{path1}のようになります。
Webサービス要求のキャッシュサイズ(KB)
デフォルトは100 KBです。要求が100 KBを超える場合は、キャッシュサイズを増やすことができます。
Webサービス応答のキャッシュサイズ(KB)
Webサービス応答で利用可能なメモリ。Webサービス応答に多数の行またはカラムが含まれている場合は、キャッシュサイズを大きくします。デフォルトは100 KBです。
入力フラッシュを許可
該当なし。
トランザクションコミット制御
該当なし。

ミッドストリームトランスフォーメーションマッピングの例

人事部長が、従業員の詳細な情報をApache CouchDBから抽出しようとしています。
CouchDBから従業員の詳細な情報を抽出し、フラットファイルに書き込むには、以下のタスクを実行します。
    1CouchDBからデータを読み取るためのREST V2接続を作成します。
    次の図は、設定されたCouchDB接続を示しています。
    2ビジネスサービスを作成して、REST V2接続と操作を関連付けます。
    次の図は、設定済みのビジネスサービスを示しています。
    3REST V2マッピングを作成します。
    4Webサービストランスフォーメーションを追加します。全般プロパティで名前と説明を指定します。
    5[Webサービス]タブで、設定済みのビジネスサービスと操作を選択します。ページングパラメータも指定します。
    次の図は、設定済みのWebサービスを示しています。
    6[要求マッピング]タブで、ソースの入力フィールドを、CouchDBの対応するフィールドにマッピングします。
    7[応答マッピング]タブで、[応答構造]上のターゲットファイルに書き込む従業員情報フィールドを選択します。
    8[詳細]タブで、キャッシュサイズの詳細設定を行います。
    Webサービストランスフォーメーションの[応答構造]から選択したフィールドは、ターゲットオブジェクトの入力フィールドとして表示されます。
    9 必要に応じて、この入力ファイルをフラットファイルフィールドにマッピングします。
    10[新規] > [タスク] > [マッピングタスク]の順にクリックして、タスクに対してマッピングを選択します。
    11マッピングタスクを保存して実行すると、Secure Agentは、[要求マッピング]タブでマッピングした従業員についての従業員レコードをCouchDBから取得し、対応するフラットファイルにそのデータを書き込みます。