ブランチテンプレート
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
ブランチ テンプレート (ブランチ テンプレート定義アイテムとも呼ばれます) を使用すると、ユーザーは再利用可能な定義済みの構造を使用して複数のアイテムを作成できます。ブランチ テンプレートは、ブランチ テンプレート定義アイテム (そのすべての子孫を含む) で構成され、アイテム内の任意のフィールドの値を含めることができます。ユーザーが挿入オプションからブランチ テンプレートを選択すると、Sitecoreはブランチ テンプレート定義アイテムの下のアイテム (フィールド値を含む) を複製し、アイテム名とフィールド値に対してトークン置換を実行します。ブランチテンプレートは、データテンプレートおよびコマンドテンプレートとともに割り当てることができます。
すべてのデータテンプレートに対して ブランチテンプレートを作成する 必要はありません。ブランチ テンプレートは、次の場合に使用します。
-
初期フィールド値を (標準値から継承するのではなく) 作成したアイテムにコピーします。これには、標準テンプレート フィールド (アイテムのアイコンやアクセス権の割り当てなど、リボン コントロールを使用して割り当てられる) と、カスタム データ テンプレートで定義されたフィールド (製品番号など) の両方のフィールド値が含まれます。
-
複数のアイテムを挿入します。
-
挿入されたアイテムにアクセス権を割り当てます。
-
ブランチテンプレートを使用してアイテムを挿入できるアカウントを制御します。
-
コンテンツ作成者が一度に複数のアイテム (兄弟または子孫) を作成できるようにします。ブランチテンプレートを使用して、複数のコンテンツサブツリーを作成できます。
ブランチ テンプレート定義アイテム内には任意の数のアイテムを作成でき、各アイテムは任意の数の子孫アイテムを持つことができます。ユーザーがブランチ テンプレートを使用してアイテムを作成すると、Sitecoreはトークンを展開する前に、ブランチ テンプレート定義アイテムのすべての子孫をレプリケートします。
新しいブランチ テンプレート定義アイテムは、Branch dataテンプレート (/System/Branches/Branch data template ) またはNew Branch commandテンプレート (/Branches/System/Branch/New Branch command template) を使用して挿入できます。コマンド テンプレートを使用する場合、Sitecoreは指定したデータ テンプレートにちなんで名付けられたブランチ テンプレート定義アイテムを作成し、ブランチ テンプレート定義アイテム内のそのデータ テンプレートに基づいて $nameという名前のアイテムを作成します。
ブランチテンプレート定義アイテム内の各アイテムのフィールドには、以下のトークンを含む値を入力できます。Sitecoreは、ブランチ テンプレートを使用して挿入された各アイテムのフィールド値でこれらのトークンを展開します。
-
$name - ユーザーがアイテムを挿入するときに入力した名前。
-
$id - アイテムのID。
-
$parentid - アイテムの親のID。
-
$parentname - アイテムの親の名前。
-
$date - システム日付 (yyyyMMdd)。
-
$time - システム時刻 (HHmmss)。
-
$now - 日付と時刻 (yyyyMMddTHHmmsss)。
Sitecoreがデータ テンプレートごとに1つの標準値アイテムに保存し、そのテンプレートに基づくすべてのアイテムに適用され、それらのフィールドに値がない標準値とは異なり、Sitecoreはブランチ テンプレート定義アイテム内のフィールド値を、そのブランチ テンプレートを使用して作成された各アイテムに複製します。データの重複を避けるには、ブランチテンプレートのフィールド値の代わりに標準値を使用します。
ブランチテンプレートの使用時に実行されるアクション
ブランチテンプレートの使用時に実行されるアクション
ユーザーがブランチ テンプレートを呼び出すと、Sitecoreは次のことを行います。
-
分岐テンプレート定義項目の子孫 (すべてのフィールド値を含む) をコピーして、新しい項目を作成します。
-
新しいアイテムに対してトークン置換を実行し、アイテム名とフィールド値の両方の $nameトークンと他のトークンを、ブランチテンプレートの呼び出し時にユーザーが入力した名前に置き換えます。
0個以上の子孫を持つ1つの子項目で構成されるブランチ テンプレートでは、通常、その子の名前は $nameされるため、ユーザーは作成するルート項目の名前を指定できます。ブランチ テンプレートのアイテム名については、$nameのみがサポートされています
ブランチ テンプレートの標準値をオーバーライドしないフィールドの場合、新しいアイテムの対応するフィールドには標準値が含まれます (ただし、標準値に $nameなどのトークンが含まれていて、Sitecoreも指定されたアイテム名に置き換えられます。
ブランチ テンプレートのフィールド値は、データの重複を簡単に引き起こす可能性があります。したがって、テンプレートの標準値は、一般にブランチ テンプレートのフィールド値よりも適しています。また、ブランチテンプレートのフィールド値は、テンプレートの標準値のように継承されず、コピーされることにも注意してください。
したがって、そのブランチを使用してアイテムを作成した後にブランチに加えられた変更は、以前に作成したアイテムには反映されません。