---
title: "値のマッピング"
slug: "value-mappings"
abstract: "Sitecore Data Exchange Frameworkにおいて、あるオブジェクトから別のオブジェクトへ値をマッピングするための価値マッピングのガイド。"
---
# 値のマッピング

*値マッピング*は、単一の値をあるオブジェクトから別のオブジェクトへマッピングすることを制御します。汎用値マッピングのテンプレートは*/sitecore/templates/DataExchange/Framework/DataAccess/Mapping/ValueMapping*にあります。

通常、このコンポーネントを拡張する必要はありません。

## 構成

フィールド

概要

ソースアクセサル

[値アクセス器](https://doc.sitecore.com/xp/ja/developers/def/60/data-exchange-framework/value-accessors.html)は*、ソースオブジェクト*からマッピングされる値を読み取るために使用されます。(より正確には、*値アクセス器*に割り当てられた*値リーダー*が使われます。)複数の*値アクセスツール*が指定されている場合、*ソースオブジェクト*から読み取った値はコレクションに加えられます。これは*、値作成*者が複数の値を期待する場合(例えば値*作成*者がメソッドを表す場合)に使用されます。

常に値をコレクションに読み込む

選択された場合、たとえソース *値のアクセル* が1つだけ指定されていても、コレクションが読み込まれます(新しいコレクションが作成され、その値がコレクションに追加されます)。このオプションは *、値作成* 者が値の集合を期待する場合(例えば *メソッドを表現* する場合)に使用されます。

ターゲットアクセサ

対象オブジェクトにマッピングされる値を書き込むために使われる[値アクセス](https://doc.sitecore.com/xp/ja/developers/def/60/data-exchange-framework/value-accessors.html)器です。(より正確には、*値アクセス器*に割り当てられた*値ライター*が使われます。)

トランス以前のソースバリュー

ソース*アクセス*が使われる前に*、元のオブジェクト*を変換するために使われる[値リーダー](https://doc.sitecore.com/xp/ja/developers/def/60/data-exchange-framework/value-readers.html)です。変換された値は、この*値*マッピングの文脈の中で*ソースオブジェクト*となります。このオプションは、*ソースオブジェクト*を別の形式に変換してからソース*アクセスツール*から値を読み取る必要がある場合に使用されます。

ソースバリュートランスフォーマー

値[リーダー](https://doc.sitecore.com/xp/ja/developers/def/60/data-exchange-framework/value-readers.html)は*、ソースアクセサ*が読み取った値をターゲット*オブジェクト*に書き込む前に変換するために使われます。このオプションは*、ソースオブジェクト*から読み取った値を別の形式に変換し、その後ターゲット*アクセサ*でターゲットオブジェクトに値を書き込む必要がある場合*に使用されます。*

ソース値を読み取れない場合は失敗しないでください

デフォルトでは、このチェックボックスはクリアです。 *もしソースオブジェクト*から値を読み取れない場合、データマッピングプロセスは失敗を報告します。  
  
このチェックボックスを選択すると、 *値のマッピング* は失敗せず、単に実行されません。

ヌル値を無視する

このチェックボックスはデフォルトで選択されます。 *ソースオブジェクト*からnull値を読み取ると、 *値のマッピング* は実行されません。これにより、既存のデータが上書きされるのを防ぎます。  
  
このチェックボックスをクリアすると、*元のオブジェクト*からnull値を読み取っても*値のマッピング*は実行されます。

マッピングルールを適用する

値マッピングを実行するかどうかを決定する[適用マッピングルール](https://doc.sitecore.com/xp/ja/developers/def/60/data-exchange-framework/apply-mapping-rule-components.html)です。ここで指定されたすべての*適用マッピングルール*は、*値*マッピングを実行するためには通過しなければなりません。もし適用マッピング*ルール*の一つが失敗した場合、*値マッピング*は実行されません。

マッピングセットは失敗します。このマッピングが失敗した場合

デフォルトでは、単一の *値のマッピング* が失敗しても、マッピングプロセス全体が失敗するわけではありません。このチェックボックスを選択すると *、その値* マッピングが失敗すると、マッピングプロセス全体が失敗します。  
  
*値マッピング*がデータマッピングプロセスにとって重要な場合にこのオプションを使用します。例えば、*値マッピング*が*ターゲットオブジェクト*のプライマリキーの設定方法を指定する場合、それなしではターゲットシステムを更新できません。これは重大なエラーなので、マッピングプロセス全体も失敗しなければなりません。