第8章 インテグレーションデータを次のコネクションのフィールドにマッピング

手順

1. フロービジュアライゼーションで、 アイコンを見つけます。
2. アイコンをクリックして Data Type Mismatch 通知を確認します。
3. メッセージで Add a data mapping step をクリックし、データマッパーを表示します。

手順

1. Sources パネルで、マップ元となるデータフィールドをクリックします。

   ステップを展開して、提供されるデータフィールドを表示する必要がある場合があります。

   ソースフィールドが多数ある場合は、 をクリックして対象のフィールドを検索し、検索フィールドにデータフィールドの名前を入力します。

2. Target パネルで、マップ先のデータフィールドをクリックします。

   データマッパーは、先ほど選択した 2 つのフィールドを接続する行を表示します。

3. 必要に応じて、データマッピングの結果をプレビューします。これは、マッピングに変換を追加する場合や、マッピングにタイプ変換が必要な場合に便利です。

   1. データマッパーの右上で をクリックし、Show Mapping Preview を選択して、ソースフィールドにテキスト入力フィールドを表示し、ターゲットフィールドに読み取り専用結果フィールドを表示します。
   2. ソースフィールドのデータ入力フィールドにテキストを入力します。
   3. このテキストボックスの外部をどこかクリックし、ターゲットフィールドの読み取り専用フィールドにマッピングの結果を表示します。
   4. 任意で、変換の結果を確認するには、Mapping Details パネルに変換を追加します。
   5. を再度クリックし、Show Mapping Preview を選択して、プレビューフィールドを非表示にします。

4. 任意で、マッピングが定義されていることを確認するには、右上の をクリックし、定義されたマッピングを表示します。

   このビューでデータマッピングの結果をプレビューすることもできます。プレビューフィールドが表示されない場合は、 をクリックし、Show Mapping Preview を選択します。前の手順で説明したデータを入力します。定義されたマッピングの表では、プレビューフィールドは選択したマッピングでのみ表示されます。別のマッピングのプレビューフィールドを表示するには、そのマッピングを表示します。

   を再度クリックし、データフィールドパネルを表示します。

5. 右上の Done をクリックし、データマッパーステップをインテグレーションに追加します。

1. Configure Mapper ページで、右上のプラスマークをクリックし、Mapping Details パネルを表示します。
2. Sources セクションに、ソースフィールドの名前を入力します。
3. Action セクションで、デフォルトの Map アクションを受け入れます。
4. Target セクションで、マップ先のフィールドの名前を入力し、Enter をクリックします。

手順

1. Target パネルで、複数のソースフィールドをマップするフィールドをクリックします。

2. Sources パネルに、ターゲットフィールドにマップするフィールドが含まれるフィールドがある場合は、そのコンテナーフィールドをクリックし、含まれるすべてのフィールドをターゲットフィールドにマップします。

   各ソースフィールドを個別に選択するには、ターゲットフィールドに組み合わせる最初のフィールドをクリックします。ターゲットフィールドに組み合わせる他の各フィールドにマウスオーバーし、CTRL-Mouse1 (MacOS では CMD-Mouse1) を押します。

   作業が完了したら、各ソースフィールドからターゲットフィールドへの線が表示されるはずです。

3. Mapping Details パネルの Separator フィールドで、データマッパーが異なるソースフィールドからのコンテンツの間に挿入する文字を許可または選択します。デフォルトは空白文字です。

4. Mapping Details パネルの Sourcesの下にあるソースフィールドの順番が、複合ターゲットフィールドの対応するコンテンツと同じになるようにしてください。

   必要な場合は、同じ順番になるようにソースフィールドをドラッグアンドドロップします。データマッパーは新しい順番を反映するためにインデックス番号を自動的に更新します。

5. ソースフィールドを複合ターゲットフィールドの各パーツにマップした場合は、次のステップを省略します。

   ターゲットフィールドがマップできないデータを想定する場合、Mapping Details パネルで各ソースフィールドのインデックスを編集し、複合ターゲットフィールドの対応するデータのインデックスと同じになるようにします。データマッパーは、不足しているデータを示すために、必要に応じてパディングフィールドを自動的に追加します。

   誤って余分なパディングフィールドを作成した場合は、余分なパディングフィールドのごみ箱アイコンをクリックして削除します。

6. 必要に応じて、データマッピングの結果をプレビューします。

   1. データマッパーの右上にある をクリックします。Show Mapping Preview を選択して、テキスト入力フィールドを現在選択しているマッピングの各ソースフィールドに表示し、読み取り専用結果フィールドを現在選択しているマッピングのターゲットフィールドに表示します。

   2. ソースデータ入力フィールドにテキストを入力します。テキストボックスの外部をクリックし、ターゲットフィールドの読み取り専用フィールドにマッピングの結果を表示します。

      ソースフィールドの順序を変更したり、マッピングに変換を追加すると、ターゲットフィールドの結果フィールドにこれが反映されます。データマッパーがエラーを検出すると、Mapping Details パネルの上部に情報メッセージが表示されます。

   3. を再度クリックし、Show Mapping Preview を選択して、プレビューフィールドを非表示にします。

      プレビューフィールドを再表示すると、入力したデータはデータマッパーが終了するまでそのまま存在します。

7. マッピングが適切に定義されていることを確認するには、右上の をクリックし、このステップで定義されたマッピングを表示します。複数のソースフィールドの値を 1 つのターゲットフィールドに組み合わせるマッピングは次のようになります。

   このビューでは、マッピングの結果をプレビューすることもできます。 をクリックし、 Show Mapping Preview を選択して、先ほどのステップの説明どおりにテキストを入力します。プレビューフィールドは選択したマッピングのみに表示されます。表の別のマッピングをクリックして、そのプレビューフィールドを表示します。

手順

1. Sources パネルで、分割するコンテンツのあるフィールドをクリックします。
2. Target パネルで、ソースフィールドデータを区切る最初のフィールドをクリックします。

3. Target パネルで、ソースフィールドのデータの一部を含める追加の各ターゲットフィールドにマウスオーバーし、CTRL-Mouse1 (MacOS では CMD-Mouse1) を押して選択します。

   ターゲットフィールドの選択を終了すると、ソースフィールドから各ターゲットフィールドへの線が表示されるはずです。

4. Mapping Details パネルの Separator フィールドで、ソースフィールドの値を区切る場所を示すソースフィールドの文字を許可または選択します。デフォルトは空白文字です。

5. Mapping Details パネルの Targets の下にあるターゲットフィールドの順番が、複合ソースフィールドの対応するコンテンツと同じになるようにしてください。

   必要な場合は、同じ順番になるようにターゲットフィールドをドラッグアンドドロップします。データマッパーは新しい順番を反映するためにインデックス番号を自動的に更新します。

6. 複合ソースフィールドの各パーツをターゲットフィールドにマップした場合は、次のステップを省略します。

   ソースフィールドに、不必要なデータが含まれる場合は、Mapping Details パネルで、各ターゲットフィールドのインデックスを編集して、複合ソースフィールドの対応するデータのインデックスと同じになるようにします。データマッパーは、不要なデータを示すため、必要に応じてパディングフィールドを自動的に追加します。

7. 必要に応じて、データマッピングの結果をプレビューします。

   1. データマッパーの右上で をクリックし、Show Mapping Preview を選択して、ソースフィールドにテキスト入力フィールドを表示し、各ターゲットフィールドに読み取り専用結果フィールドを表示します。

   2. ソースフィールドのデータ入力フィールドにテキストを入力します。フィールドのパーツの間には必ず区切り文字を入力してください。テキストボックスの外部をクリックし、ターゲットフィールドの読み取り専用フィールドにマッピングの結果を表示します。

      ターゲットフィールドの順序を変更したり、ターゲットフィールドに変換を追加すると、ターゲットフィールドの結果フィールドにこれが反映されます。データマッパーがエラーを検出すると、Mapping Details パネルの上部に情報メッセージが表示されます。

   3. を再度クリックし、Show Mapping Preview を選択して、プレビューフィールドを非表示にします。

      プレビューフィールドを再表示すると、入力したデータはデータマッパーが終了するまでそのまま存在します。

8. マッピングが適切に定義されていることを確認するには、 をクリックし、このステップで定義されたマッピングを表示します。ソースフィールドの値を複数のターゲットフィールドに分割するマッピングは次のようになります。

   このビューでは、マッピングの結果をプレビューすることもできます。 をクリックし、 Show Mapping Preview を選択して、先ほどのステップの説明どおりにテキストを入力します。プレビューフィールドは選択したマッピングのみに表示されます。表の別のマッピングをクリックして、そのプレビューフィールドを表示します。

手順

1. フィールドをマップします。これは、1 対 1 のマッピング、組み合わせのマッピング、または分割のマッピングになります。
2. Mapping Details パネルの Sources または Targets にある変換するフィールドのボックスで、ごみ箱を指す矢印をクリックします。データマッパーが実行する変換を選択するフィールドが表示されます。
3. このフィールドをクリックして変換のリストを表示します。
4. 実行する変換をクリックします。
5. 変換に入力パラメーターが必要な場合は、該当する入力フィールドに指定します。
6. 別の変換を追加するには、ごみ箱を指す矢印を再度クリックします。

手順

1. データタイプが表示されない場合は、 をクリックした後、Show Types をクリックして表示します。

   これは、条件を指定するための要件ではありませんが、データタイプを表示すると便利です。

2. 条件を適用するマッピングを作成するか、現在選択しているマッピングが条件を適用するマッピングであることを確認します。たとえば、以下のマッピングについて考えてみましょう。

   

3. 右上の をクリックして条件式入力フィールドを表示します。

   データマッパーは、式フィールドに現在のマッピングにあるソースフィールドの名前を自動的に表示します。以下に例を示します。

   

   式入力フィールドでは、ソースフィールドの順序は、マッピングの作成時に選択した順序になります。これは、データマッパーがこの順序でフィールド値を連結し、結果をターゲットフィールドに挿入するのがデフォルトのマッピング動作であるため、重要になります。この例では、このマッピングの作成では、最初に lastName が選択されてからfirstName が選択されます。

4. 式入力フィールドを編集して、データマッパーがマッピングに適用する条件式を指定します。サポートされる条件式の詳細は、次の手順に従います。

   式を指定する際に、以下を実行できます。

   • @ を入力してフィールドの名前の入力を開始します。データマッパーは入力内容に一致するフィールドのリストを表示します。式に指定するフィールドを選択します。

   • フィールドをマッピングキャンバスから式入力フィールドにドラッグします。

     フィールド名を式に追加するとき、データマッパーはそのフィールドをマッピングに追加します。たとえば、以下の条件式について考えてみましょう。

     

     実行中、データマッパーによって lastName が空であると判断されると、firstname フィールドのみを firstName フィールドのみをターゲット customerName フィールドにマップします。lastName フィールドに値が含まれ、空でない場合、データマッパーはソースの orderIdおよび phone フィールドの値を連結し、結果を customerName フィールドに挿入します。(以下の例は論理の仕組みを示していますが、lastName フィールドに値があるときは、データマッパーと使って単にマッピングを実行し、他の値をターゲットにマップしない可能性が高いため、実践的な例とは言えません。)

     この例では、式の入力後にデータマッピングは次のようになります。

     

   条件式で式が適用されるマッピングにあるフィールド名を削除すると、データマッパーはそのフィールドをマッピングから削除します。つまり、マッピングのすべてのフィールド名は条件式にある必要があります。

5. マッピングプレビューフィールドが表示されていない場合は、 をクリックした後に Show Mapping Preview をクリックして表示します。
6. ソースのプレビュー入力フィールドにサンプルデータを入力して、ターゲットフィールドが正しい値であることを確認します。

7. 必要に応じて、マッピングにある 1 つ以上のソースまたはターゲットフィールドに変換を適用します。

   1. Mapping Details パネルで、変換を適用するフィールドを見つけます。
   2. 下にある Add Transformation をクリックします。
   3. データマッパーが実行する変換をクリックします。
   4. 必要な場合は入力パラメーターを指定します。

   たとえば、この手順と同じマッピングで Mapping Details パネルにて Uppercase 変換を firstName フィールドに適用できます。これをテストするには、firstName フィールドのプレビュー入力フィールドにデータを入力します。

8. 必要に応じて条件式を編集して、目的の結果を取得します。

手順

1. 右上の をクリックします。
2. マッピングのリストを解除し、ソースおよびターゲットフィールドを再表示するには、 を再度クリックします。