Application Integration でサポートされているコネクタをご覧ください。

Data Transformer タスク

Data Transformer タスクには、データを変換するための 2 つのモード（図式とスクリプト）があります。図式モードでは、Data Transformer エディタと呼ばれる視覚的なマッピングキャンバスを使用して、統合でデータの割り当てとマッピングを行います。さらに、サポートされている変換を使用して、データを意味のある変数や形式に変換し、統合内の他のタスクやトリガーからアクセスすることもできます。スクリプト モードでは、カスタム Jsonnet テンプレートを作成、編集、評価して、統合でデータマッピングを実行できます。

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

Data Transformer タスクを構成する

Data Transformer タスクを統合に追加する手順は次のとおりです。

Google Cloud コンソールで [Application Integration] ページに移動します。
Application Integration に移動
ナビゲーションメニューで [統合] をクリックします。
[統合] ページが開き、Google Cloud プロジェクトで使用可能なすべての統合が一覧表示されます。
既存の統合を選択するか、[統合の作成] をクリックして新しい統合を作成します。
新しい統合を作成する場合:
1. [統合の作成] ペインで名前と説明を入力します。
2. 統合のリージョンを選択します。
  注: [リージョン] プルダウンには、Google Cloud プロジェクトにプロビジョニングされたリージョンのみが表示されます。新しいリージョンをプロビジョニングするには、[リージョンを有効にする] をクリックします。詳細については、新しいリージョンを有効にするをご覧ください。
3. 統合用のサービスアカウントを選択します。統合のサービスアカウントの詳細は、統合ツールバーの [統合の概要] ペインでいつでも変更または更新できます。
  注: サービスアカウントを選択するオプションは、選択したリージョンで統合ガバナンスを有効にしている場合にのみ表示されます。
4. [作成] をクリックします。
統合エディタで統合が開きます。
統合エディタのナビゲーションバーで、[タスク] をクリックして、使用可能なタスクとコネクタのリストを表示します。
[Data Transformer] 要素をクリックして、統合エディタに配置します。
[Data Transformer] 要素をクリックして、タスク構成ペインを表示します。
[Open Data Transformer editor] をクリックします。[Data Transformer（プレビュー版）タスクエディタ] ページで、次のいずれかのオプションを選択します。

デフォルトでは、図式モードが開きます。図式モードでは、コンソールベースの操作で入力変数と出力変数を選択し、データ変換エディタで変換を実行できます。
[図式] モードでは、入力変数と出力変数間のデータマッピングを視覚的に行うことができます。
カスタム Jsonnet テンプレートを作成、編集、評価して、統合でデータ変換を実行するには、[スクリプト] をクリックしてスクリプトモードに移動します。複雑なデータ変換の要件があり、Jsonnet 関数を活用する場合は、スクリプト モードを使用できます。
Data Transformer エディタが開き、コメント付きのデフォルトの Jsonnet テンプレートサンプルが表示されます。Jsonnet コードを記述し、完了したらエディタを閉じます。変更は自動的に保存されます。

マッピングの追加方法について詳しくは、マッピングの追加をご覧ください。

マッピングを追加する

マッピングを追加するには、[図式] モードまたは [スクリプト] モードを使用します。

図式モードを使用する

図式モードでは、コンソールベースの操作で入力変数と出力変数を選択し、データ変換エディタで変換を実行できます。[図式] モードを使用してマッピングを追加する手順は次のとおりです。

Data Transformer タスク構成ペインで、[Open Data Transformer Editor] をクリックします。
デフォルトでは、[図式] モードが開いています。
マッピングの入力変数を追加するには、[+ 入力を追加] をクリックします。[Choose Input Variable or Value] ダイアログが表示されます。デフォルトでは [変数] タブが選択されています。
Input: データ変換入力のソース。ソースは、マッピング関数を使用したリテラル値、基本関数、または入力変数になります。

次に、以下の操作を行います。
1. [変数を選択] リストから、入力変数を選択します。新しい変数を作成するには、[+ 新しい変数を追加] をクリックします。
2. [送信] をクリックします。
必要に応じて、定数を追加するには、[定数] タブをクリックします。

変数とは異なり、定数には統合内の他のタスクやトリガーからアクセスできません。定数は、作成されたデータ変換タスクでのみ使用できます。たとえば、定数を使用して区切り文字を追加したり、定数値を変数にマッピングしたりできます。

次に、以下の操作を行います。
1. [定数 ID] フィールドに、定数の名前を入力します。
2. [データ型] リストから、次のいずれかのデータ型を選択します。
  - String
  - ブール値
  - 数値
3. [Enter the constant value] フィールドに値を入力します。
4. [送信] をクリックします。
マッピングの出力変数を追加するには、[+ 出力を追加] をクリックして出力変数を選択するか、新しい変数を作成します。
マッピングを構成します。
1. [入力] セクションの [変数] リストにある変数またはそのサブフィールドから、[出力] セクションの [変数] リストにある変数またはそのサブフィールドへのマッピングを追加します。
2. 変換関数を追加するには、マッピング行にカーソルを合わせ、settings をクリックしてデータ変換関数を追加します。キャンバスに [変換] ボタンが表示されます。
  または、[ 変換を追加] をクリックして変換関数を追加することもできます。
  
  次に、以下の操作を行います。
  1. 変換を追加するには、[変換] ボタンをクリックします。[変換] パネルが表示されます。
    
    次に、以下の操作を行います。
    1. [+ Add Operation] をクリックします。[Add Operation] ダイアログが表示されます。
    2. [検索オペレーション] フィールドに、追加するオペレーションを入力します。または、オペレーションのリストからオペレーションを選択することもできます。
      カスタムオペレーションを追加する場合は、[関数式] を選択し、関数式を入力します。変数をコピーするには、[変数] リストからをクリックし、式エディタに貼り付けます。
    3. [完了] をクリックします。
  2. オペレーションに応じて、必要な情報を入力します。必要に応じて、変換に複数のオペレーションを追加できます。次のオペレーションで前のオペレーションの結果を選択する場合は、次の図に示すように [Previous Operation Result] 変数を選択します。
  3. オペレーションを削除するには、オペレーションの横にある [削除] をクリックします。
3. 必要に応じて、複数の入力変数から変換関数へのマッピングを追加できます。ただし、変換関数からの出力変数ごとに追加できるマッピングは 1 つだけです。
4. 入力変数と出力変数を削除するには、 > [削除] をクリックします。
5. 必要に応じて、マッピング行または変換を削除するには、マッピングを選択し、[削除] を押します。
6. マッピングが完了したら、[データマッピングエディタ] を閉じます。変更は自動的に保存されます。
例: 古いバグチケットシステムを新しいチケットシステムにマッピングする

新しいチケットシステムに移行するレガシーバグチケットシステムがあるとします。次の図に示すように、[図式] オプションを使用して、古いシステムから新しいシステムにフィールドをマッピングできます。

いずれかのフィールドに定数値を追加するには、[入力を追加] をクリックして新しい定数を追加します。新しく追加した定数は、[入力] セクションから [出力] セクションのフィールドにマッピングできます。

直接マッピングできないフィールドの変換を追加するには、[ 変換] をクリックし、[+ オペレーションを追加] をクリックして変換オペレーションを追加します。

変換が完了したら、統合を実行して古いチケット販売システムを新しいシステムにマッピングできます。

スクリプトモードを使用する

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 関数を使用します。

注意: Jsonnet では、識別子名の一部にハイフン（-）を使用できません。たとえば、変数名や関数名が考えられます。変数名の一部としてハイフン（-）を使用する場合は、次の例に示すように、変数を二重引用符で囲む必要があります。
例: 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 タスクに適用される使用量上限については、使用量上限をご覧ください。

次のステップ
- 以下の内容を学習します。