データ マッピング タスク

データ マッピングタスクを使用すると、統合で変数の割り当てを実行し、json オブジェクトのプロパティを取得して設定し、値にネストされた変換関数を適用できます。これらの変数は統合変数またはタスク変数です。

たとえば、統合変数 X の値をタスク変数 Y に割り当てることも、タスク変数 Y の値を統合変数 X に割り当てることもできます。Application Integration の変数の詳細については、Application Integration での変数の使用をご覧ください。

データ マッピング タスクを構成する

データ マッピング タスクを構成するには、次の手順を実施します。

  1. Google Cloud コンソールで、[Application Integration] ページに移動します。

    Application Integration に移動

  2. ナビゲーション メニューで [統合] をクリックします。

    [統合] ページが開き、Google Cloud プロジェクトで使用可能なすべての統合が一覧表示されます。

  3. 既存の統合を選択するか、[統合の作成] をクリックして新しい統合を作成します。

    新しい統合を作成する場合:

    1. [統合の作成] ペインで名前と説明を入力します。
    2. 統合のリージョンを選択します。
    3. 統合用のサービス アカウントを選択します。統合のサービス アカウントの詳細は、統合ツールバーの [統合の概要] ペインでいつでも変更または更新できます。
    4. [作成] をクリックします。新しく作成された統合が統合エディタで開きます。

  4. 統合エディタのナビゲーション バーで、[タスク] をクリックして、使用可能なタスクとコネクタのリストを表示します。
  5. 統合エディタで [Data Mapping] 要素をクリックして配置します。
  6. デザイナーの [Data Mapping] 要素をクリックして、[Data Mapping] タスク構成ペインを表示します。
  7. タスクのデフォルト値を表示して、新しいマッピングを追加するには、[データ マッピング エディタを開く] をクリックします。マッピングの追加方法について詳しくは、マッピングの追加をご覧ください。

    データ マッピング エディタのレイアウトの詳細については、データ マッピングの概要をご覧ください。

マッピングを追加する

マッピングを追加する手順は、次のとおりです。

  1. データ マッピング タスク構成ペインで、[Open Data Mapping Editor] をクリックします。
  2. マッピング [Input] を構成します。
    1. 変数またはそのサブフィールドを、[Variables] リストから [Input] 行にドラッグします。変数の使用可能なサブフィールドを表示するには、[Variables] リストの変数の横にある （Expand）をクリックします。
    2. または、入力行で、変数または値をクリックし、次の操作を行います。
      • [変数] を選択して、既存の変数を検索して使用します。新しい変数を作成するには、[+ Add new variable] をクリックして、新しい変数の名前とデータ型を入力します。
      • [値] を選択して、string、integer、double、Boolean 型のリテラル値を入力します。
      • [Function] を選択して、基本関数を検索して使用します。

        基本関数は、統合の実行中に値を取得または生成するために使用されます。たとえば、ランダムな UUID の生成、現在の統合リージョンの取得などです。サポートされている基本関数については、サポートされている基本関数をご覧ください。

      • [保存] をクリックします。
    3. [Input] 行の任意の入力変数、値、または基本関数で [+（Add a function）] をクリックして、使用可能なマッピング関数のリストからマッピング関数を追加します。マッピング関数には 1 つ以上のパラメータを指定できます。各パラメータには、さらに値、変数、または基本関数の後にマッピング関数のチェーンを記述できます。
      • ネストされた関数を追加するには、関数のパラメータの横にある [+（Add a function）] をクリックします。同様に、最後に追加された関数を削除するには、[- (直前の関数を削除)] をクリックします。
      • マッピング式の間で関数を追加、削除、または変更するには、関数をクリックし、プルダウン メニューから [Add Function]、[Remove Function]、または [Change Function] を選択します。

        • マッピング関数の詳細については、マッピング関数をご覧ください。

        サポートされているマッピング関数については、サポートされているデータ型とマッピング関数をご覧ください。

      • マッピング式内の変数を削除するには、変数行の横にある （Remove）をクリックします。
      • 入力行全体を削除するには、行の （Clear）をクリックします。
  3. [Output] のマッピングを構成します。
    1. 変数を [Variables] リストから [Output] 行にドラッグします。変数が使用できない場合は、[create a new one] をクリックして、新しい変数の名前とデータ型を構成します。必要に応じて、出力変数をクリックして、その変数を統合の出力として使用するか、別の統合への入力として使用するかを選択できます。
    2. 出力変数を削除するには、 （Clear） をクリックします。
  4. （省略可）マッピング行を削除するには、 (Delete this mapping) をクリックします。
  5. マッピングが完了したら、[データ マッピング エディタ] を閉じます。変更は自動的に保存されます。

完了したデータ マッピングは、次の図に示すように、[Data Mapping] タスク構成ペインに表示されます。

データ マッピング エディタの画像 データ マッピング エディタの画像

サポートされているデータ型とマッピング関数

Application Integration では、データ マッピング タスクの変数に対して次のデータ型がサポートされています。

  • 文字列と文字列配列
  • 整数と整数配列
  • Double と Double 配列
  • ブール値とブール値配列
  • JSON
次の表に、各データ型で使用可能なデータ マッピング関数を示します。
データ型 サポートされているマッピング関数
ブール値 AND、EQUALS、NAND、NOR、NOT、OR、TO_JSON、TO_STRING、XNOR、XOR
ブール値配列 APPEND、APPEND_ALL、CONTAINS、FILTER、FOR_EACH、GET、REMOVE、REMOVE_AT、SET、SIZE、TO_JSON、TO_SET
Double ADD、 DIVIDE、 CEIL, EQUALS、 EXPONENT、 GREATER_THAN、 GREATER_THAN_EQUAL_TO、 FLOOR、 LESS_THAN、 LESS_THAN_EQUAL_TO、 MOD、 MULTIPLY、 ROUND、 SUBTRACT、 TO_JSON、 TO_STRING
Double 配列 APPEND、APPEND_ALL、AVG、CONTAINS、FILTER、FOR_EACH、GET、MAX、MIN、REMOVE、REMOVE_AT、SET、SIZE、SUM、TO_JSON、TO_SET
整数 ADD、DIVIDE、EPOCH_TO_HUMAN_READABLE_TIME、EQUALS、EXPONENT、GREATER_THAN、GREATER_THAN_EQUAL_TO、LESS_THAN、LESS_THAN_EQUAL_TO、MOD、MULTIPLY、SUBTRACT、TO_DOUBLE、TO_JSON、TO_STRING
整数配列 APPEND、APPEND_ALL、AVG、CONTAINS、FILTER、FOR_EACH、GET、MAX、MIN、REMOVE、REMOVE_AT、SET、SIZE、SUM、TO_JSON、TO_SET
JSON APPEND_ELEMENT、FLATTEN、FILTER、FOR_EACH、GET_ELEMENT、GET_PROPERTY、MERGE、REMOVE_PROPERTY、RESOLVE_TEMPLATE、SET_PROPERTY、SIZE、TO_BOOLEAN、TO_BOOLEAN_ARRAY、TO_DOUBLE、TO_DOUBLE_ARRAY、TO_INT、TO_INT_ARRAY、TO_STRING、TO_STRING_ARRAY
文字列 CONCAT、CONTAINS、DECODE_BASE64_STRING、EQUALS、EQUALS_IGNORE_CASE、LENGTH、REPLACE_ALL、RESOLVE_TEMPLATE、SPLIT、SUBSTRING、TO_BASE_64、TO_BOOLEAN、TO_DOUBLE、TO_INT、TO_JSON、TO_LOWERCASE、TO_UPPERCASE
文字列配列 APPEND、APPEND_ALL、CONTAINS、FILTER、FOR_EACH、GET、REMOVE、REMOVE_AT、SET、SIZE、TO_JSON、TO_SET
各データ マッピング関数の詳細については、データ マッピング関数リファレンスをご覧ください。

サポートされている基本関数

次の表に、利用可能なデータ マッピングの基本関数を示します。
データ型 サポートされている基本関数
整数 NOW_IN_MILLIS
整数配列 INT_LIST
文字列