値のマッピング
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
値マッピングは、単一の値をあるオブジェクトから別のオブジェクトへマッピングすることを制御します。汎用値マッピングのテンプレートは*/sitecore/templates/DataExchange/Framework/DataAccess/Mapping/ValueMapping*にあります。
通常、このコンポーネントを拡張する必要はありません。
構成
フィールド
概要
ソースアクセサル
値アクセス器は*、ソースオブジェクトからマッピングされる値を読み取るために使用されます。(より正確には、値アクセス器に割り当てられた値リーダーが使われます。)複数の値アクセスツールが指定されている場合、ソースオブジェクトから読み取った値はコレクションに加えられます。これは、値作成者が複数の値を期待する場合(例えば値作成*者がメソッドを表す場合)に使用されます。
常に値をコレクションに読み込む
選択された場合、たとえソース 値のアクセル が1つだけ指定されていても、コレクションが読み込まれます(新しいコレクションが作成され、その値がコレクションに追加されます)。このオプションは 、値作成 者が値の集合を期待する場合(例えば メソッドを表現 する場合)に使用されます。
ターゲットアクセサ
対象オブジェクトにマッピングされる値を書き込むために使われる値アクセス器です。(より正確には、値アクセス器に割り当てられた値ライターが使われます。)
トランス以前のソースバリュー
ソースアクセスが使われる前に*、元のオブジェクトを変換するために使われる値リーダーです。変換された値は、この値マッピングの文脈の中でソースオブジェクトとなります。このオプションは、ソースオブジェクトを別の形式に変換してからソースアクセスツール*から値を読み取る必要がある場合に使用されます。
ソースバリュートランスフォーマー
値リーダーは*、ソースアクセサが読み取った値をターゲットオブジェクトに書き込む前に変換するために使われます。このオプションは、ソースオブジェクトから読み取った値を別の形式に変換し、その後ターゲットアクセサでターゲットオブジェクトに値を書き込む必要がある場合に使用されます。*
ソース値を読み取れない場合は失敗しないでください
デフォルトでは、このチェックボックスはクリアです。 もしソースオブジェクトから値を読み取れない場合、データマッピングプロセスは失敗を報告します。
このチェックボックスを選択すると、 値のマッピング は失敗せず、単に実行されません。
ヌル値を無視する
このチェックボックスはデフォルトで選択されます。 ソースオブジェクトからnull値を読み取ると、 値のマッピング は実行されません。これにより、既存のデータが上書きされるのを防ぎます。
このチェックボックスをクリアすると、元のオブジェクトからnull値を読み取っても値のマッピングは実行されます。
マッピングルールを適用する
値マッピングを実行するかどうかを決定する適用マッピングルールです。ここで指定されたすべての適用マッピングルールは、値マッピングを実行するためには通過しなければなりません。もし適用マッピングルールの一つが失敗した場合、値マッピングは実行されません。
マッピングセットは失敗します。このマッピングが失敗した場合
デフォルトでは、単一の 値のマッピング が失敗しても、マッピングプロセス全体が失敗するわけではありません。このチェックボックスを選択すると 、その値 マッピングが失敗すると、マッピングプロセス全体が失敗します。
値マッピングがデータマッピングプロセスにとって重要な場合にこのオプションを使用します。例えば、値マッピングがターゲットオブジェクトのプライマリキーの設定方法を指定する場合、それなしではターゲットシステムを更新できません。これは重大なエラーなので、マッピングプロセス全体も失敗しなければなりません。