Data Transformer Script タスク
Data Transformer Script タスクを使用すると、カスタム Jsonnet テンプレートを作成、編集、評価して、統合でデータ マッピングを実行できます。
Application Integration のデータ マッピングの詳細については、データ マッピングの概要をご覧ください。
Data Transformer Script タスクを構成する
Data Transformer Script タスクを統合に追加する手順は次のとおりです。
- Google Cloud コンソールで [Application Integration] ページに移動します。
- ナビゲーション メニューで [統合] をクリックします。
[統合] ページが開き、Google Cloud プロジェクトで使用可能なすべての統合が一覧表示されます。
- 既存の統合を選択するか、[統合の作成] をクリックして新しい統合を作成します。
新しい統合を作成する場合:
- [統合の作成] ペインで名前と説明を入力します。
- 統合のリージョンを選択します。
- 統合用のサービス アカウントを選択します。統合のサービス アカウントの詳細は、統合ツールバーの [統合の概要] ペインでいつでも変更または更新できます。
- [作成] をクリックします。
統合エディタで統合が開きます。
- 統合エディタのナビゲーション バーで、[タスク] をクリックして、使用可能なタスクとコネクタのリストを表示します。
- [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
をインポートします。これは、Application Integration のデータ マッピング用の Jsonnet 関数のセットを含む事前定義のカスタム ライブラリです。使用可能なカスタム関数の詳細については、Data Transformer 関数をご覧ください。
次の図は、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" }
出力
Jsonnet の使用方法のリファレンス
Jsonnet は純粋な関数型言語であり、プログラムは式で構成されます。これらの式の作成方法については、Jsonnet 式をご覧ください。
割り当てと上限
Data Transformer Script タスクに適用される使用量上限については、使用量上限をご覧ください。
次のステップ
- すべてのタスクとトリガーを確認する。
- Data Transformer 関数(プレビュー)について学習する
- インテグレーションをテストして公開する方法について学習する。
- エラー処理について学習する。
- 統合の実行ログについて学習する。