Data Transformer Script タスク

Data Transformer Script タスクを使用すると、カスタム Jsonnet テンプレートを作成、編集、評価して、統合でデータマッピングを実行できます。

Apigee Integration のデータマッピングの詳細については、データマッピングの概要をご覧ください。

Data Transformer Script タスクを構成する

Data Transformer Script タスクを統合に追加するには、次の操作を行います。

Apigee UI で、Apigee 組織を選択します。
[Develop] > [Integrations] の順にクリックします。
既存のインテグレーションを選択するか、[Create Integration] をクリックして新しいインテグレーションを作成します。
新しいインテグレーションを作成する場合:
1. [Create Integration] ダイアログで名前と説明を入力します。
2. サポートされているリージョンのリストから、インテグレーションのリージョンを選択します。
3. [Create] をクリックします。
インテグレーションデザイナーでインテグレーションが開きます。
インテグレーションデザイナーのナビゲーションバーで、[+ Add a task/trigger] > [Tasks] の順にクリックして、使用可能なタスクのリストを表示します。
[Data Transformer Script] 要素をクリックして、インテグレーションエディタに配置します。
デザイナーの [Data Transformer Script] 要素をクリックして、[Data Transformer Script] タスク構成ペインを表示します。
[Open Data Transformer Script editor] をクリックします。
Data Transformer Script エディタが開き、コメント付きのデフォルトの Jsonnet テンプレートサンプルが表示されます。
Jsonnet コードを記述し、完了したらエディタを閉じます。変更は自動的に保存されます。

Data Transformer Script エディタの使用

Data Transformer Script エディタを使用して、統合変数にアクセスして変数の割り当てを実行し、統合で変数の追加または変更を行うことができます。Data Transformer Script エディタには、スクリプトエクスペリエンスを向上させる次の機能が用意されています。

構文とコードのハイライト表示、インデント、行番号付け。コードを読みやすくし、構造を認識しやすくします。
スクリプトコードの概要を表示し、簡単なナビゲーションに役立つミニマップ。
クリックしてコピーするオプション。スクリプトコードをクリップボードにコピーします。

エディタを開くには、[Data Transformer Script] タスク構成ペインに移動して、[Open Data Transformer Script Editor] をクリックします。

Data Transformer Script エディタは、デフォルトで functions をインポートします。これは、Apigee Integration のデータマッピング用の Jsonnet 関数のセットを含む事前定義のカスタムライブラリです。使用可能なカスタム関数の詳細については、Data Transformer 関数をご覧ください。

次の図は、Data Transformer Script エディタのサンプルレイアウトを示しています。

Data Transformer Script エディタを示す画像

統合変数にアクセスする

Data Transformer Script エディタから既存の統合変数を読み取るには、事前定義された functions ライブラリの extVar 関数を使用します。

例: Data Transformer Script エディタを使用して既存の統合変数の読み取りと更新を行う

Jsonnet スクリプト

local f = import "functions"; // Import predefined Data Transformer function library

local str1 = f.extVar("inputVar1"); // Access integration input variable "Inputstr1" with value "Hello"
local str2 = f.extVar("inputVar2"); // Access integration input variable "Inputstr2" with value "World"
{
  OutputVar: str1 + " " + str2 + "!", // Write to Jsonnet output variable "OutputVar"
  "output-str-var": str1 + " Integration " + str2 + "!", // Write to Jsonnet output variable "output-str-var"
}

出力

data-transformer スクリプトの例を示す画像