7.14. 条件のマッピングへの適用

前提条件

• データマッパー ステップでフィールドをマッピングします。
• Microsoft Excel 式に詳しいか、マッピングに適用する条件付きの式がある必要があります。

条件式でサポートされる関数

• SELECT(FILTER(source-collection-name, source-field-name1 != 'v1' ), source-field-name2)

  複数のフィールドを持つコレクションの場合、データマッパーは、(同じコレクション内の) 別のソースフィールドの値に基づいて、1 つのソースフィールドの値をフィルタリングします。たとえば、コレクション (person) に name および gender を含む複数のフィールドが含まれている場合は、次の条件式を使用して、gender フィールドの値で name をフィルター処理し、男性の名前のみがターゲットフィールドにマップされるようにすることができます。

  SELECT(FILTER(person, gender = 'male' ), name)`

• ISEMPTY(source-field-name1 [+ source-field-name2])

  ISEMPTY() 関数の結果はブール値です。条件を適用するマッピングのソースフィールドの名前である引数を最低でも 1 つ指定します。指定したソースフィールドが空の場合、ISEMPTY() 関数は true を返します。

  必要に応じて、次の例のように + (連結) 演算子を追加のフィールドと追加します。

  ISEMPTY(lastName + firstName)

  この式は、ソースフィールドの lastName と firstName が両方空の場合に true に評価されます。

  多くの場合、 ISEMPTY() 関数は IF() 関数の最初の引数になります。

• IF(boolean-expression, then, else)

  boolean-expression が true に評価されると、データマッパーは then を返します。boolean-expression が false に評価されると、データマッパーは else を返します。3 つの引数がすべて必要です。最後の引数は null にすることができます。つまり、boolean-expression が false に評価されると何もマッピングされません。

  たとえば、ターゲット customerName フィールドの lastName および firstName を組み合わせるマッピングについて考えてみましょう。この条件式を指定できます。

  IF (ISEMPTY(lastName), firstName, lastName + ‘,' + firstName )

  実行中、データマッパーは lastName フィールドを評価します。

  • lastName フィールドが空で、 ISEMPTY(lastName) が true を返す場合、データマッパーは firstName の値のみをターゲット customerName フィールドに挿入します。

  • lastName フィールドに値が含まれ、ISEMPTY(lastName) が false を返す場合、データマッパーは firstName の値とコンマの後に lastName の値をターゲットの customerName フィールドにマップします。

    この式の 3 つ目の引数が null であった場合の動作について考えてみましょう。

    IF (ISEMPTY(lastName), firstName, null )

    実行中、データマッパーは lastName フィールドを評価します。

  • 前の例のように、lastName フィールドが空で、ISEMPTY(lastName) が true を返す場合、でデータマッパーは firstName の値のみをターゲットの customerName フィールドに挿入します。
  • しかし、3 つ目の引数が null であり、lastName フィールドに値が含まれ、ISEMPTY(lastName) が false を返す場合は、データマッパーはターゲットの customerName フィールドに何もマップしません。

• LT(x,y) または <(x,y)

  データマッパーは x および y を評価し、小さい方の値を返します。x と y はどちらも数字である必要があります。

• TOLOWER(string)

  データマッパーは指定の文字列を小文字に変換し、返します。