ブランチテンプレート
このページの翻訳は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 - 日付と時間(yyyyMMddTHHmmss)。
標準値は各データテンプレートに対して単一の標準値項目にSitecoreし、そのテンプレートに基づくすべての項目に適用されますが、Sitecoreは分岐テンプレート内のフィールド値をその分岐テンプレートで作成された各項目に重複させます。データの重複を避けるために、ブランチテンプレートではフィールド値の代わりに標準値を使用してください。
分岐テンプレートを使用した場合に行われる操作
分岐テンプレートを使用した場合に行われる操作
ユーザーがブランチテンプレートを呼び出すと、Sitecore:
-
分岐テンプレート定義項目の子孫をコピーし、すべてのフィールド値を含めて新しい項目を作成します。
-
新しいアイテムに対してトークンの置換を行い、アイテム名やフィールド値の $nameや他のトークンを、ブランチテンプレートを呼び出す際にユーザーが入力した名前に置き換えます。
子項目が0つ以上の子孫を持つ分岐テンプレートでは、その子項目の名前は通常 $nameされ、ユーザーが作成するルート項目の名前を指定できるようにしています。ブランチテンプレートのアイテム名については、$nameのみがサポートされています
分岐テンプレートで標準値を上書きしないフィールドについては、新しい項目の対応するフィールドが標準値を示します。ただし、標準値に $nameのようなトークンが含まれていない限り、Sitecoreそのトークンも与えられたアイテム名で置き換えられます。
分岐テンプレートのフィールド値は簡単にデータの重複を引き起こす可能性があります。したがって、テンプレート標準値は一般的に分岐テンプレートのフィールド値よりも好ましいです。また、ブランチテンプレートのフィールド値はテンプレート標準値のように継承されるのではなく、コピーされるものであることも覚えておく必要があります。
したがって、そのブランチを使ってアイテムを作成した後に行われた変更は、以前に作成されたアイテムには反映されません。