---
title: "マッピングパイプラインの適用ステップ"
slug: "the-apply-mapping-pipeline-step"
abstract: "Sitecore Data Exchange Frameworkのマッピングパイプラインを適用するステップの使い方。"
---
# マッピングパイプラインの適用ステップ

[Applyマッピング](https://doc.sitecore.com/xp/ja/developers/def/60/data-exchange-framework/apply-mappings-pipeline-step-components.html "Apply mappings pipeline step components")パイプラインステップを使って、あるオブジェクトから別のオブジェクトへのデータのマッピングを行います。このトピックでは、Applyマッピングパイプラインステップがどのように動作し、どのように設定するかを説明します。

## マッピングパイプラインの適用ステップの設定

パイプラインステップで以下の情報を設定します:

-   **ソースオブジェクトの位置** - パイプラインがデータを読み取るソースオブジェクトの場所。
    
-   **ターゲットオブジェクトの位置** - パイプラインがデータを書き込むオブジェクトデータの位置。
    
-   **Mapping set** - パイプラインがソースオブジェクトから読み取るものとターゲットオブジェクトに書き込むものを指定する値マッピングセット。
    
    > !注値マッピングセットには1つ以上の値マッピングが含まれています。値マッピングを使って、パイプラインがソースデータの要素をどのように読み取り、必要に応じて変換し、ターゲットに書き込むかを設定します。
    

## パイプラインステップロジック

パイプラインステップを実行すると、以下のロジックが実装されます:

-   パイプラインステップで指定された場所からソースオブジェクトを読み込みます。
-   パイプラインステップで指定された場所からターゲットオブジェクトを読み込みます。
-   パイプラインステップで指定された値マッピングセットを読みます。
-   値のマッピングセットを適用します。

## 値写像集合ロジック

*「値マッピングセットを適用」*ステップで何が起こるかは、使用される値マッピングセットの種類によって異なります。データ交換フレームワークには標準的な値マッピングセットが含まれていますが、開発者はカスタムのものを実装することも可能です。

標準値マッピングセットは、パイプラインがソースデータから読み取る各レコードに、含まれる値マッピングを適用します。各値マッピングに対して以下のロジックを実行します。

-   値マッピングにソース値のアクセサを割り当ててください。
-   元のバリューアクセスからバリューリーダーを取得します。
-   値リーダーを使ってソースオブジェクトから値を読み取ってください。
-   値マッピングにソース値変換器が割り当てられている場合は、それを使って値を変換します。
-   値マッピングにターゲットの値アクセクターを割り当ててください。
-   ターゲットのバリューアクセサから値作成者を取得します。
-   値作成ツールを使ってターゲットオブジェクトに値を書き込みます。