ブランチテンプレート
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
ブランチテンプレート(ブランチテンプレート定義アイテムとも呼ばれる)は、再利用可能な事前定義構造を使って複数のアイテムを作成することを可能にします。ブランチテンプレートはブランチテンプレート定義アイテムで構成され、そのすべての子孫を含むもので、アイテム内の任意のフィールドの値を含めることができます。ユーザーが挿入オプションからブランチテンプレートを選択すると、Sitecoreはブランチテンプレート定義項目の下にある項目を複製し、フィールド値を含めて項目名やフィールド値のトークン置換を行います。ブランチテンプレートはデータテンプレートやコマンドテンプレートと共に割り当てることができます。
すべてのデータテンプレートに対して ブランチテンプレートを作成する 必要はありません。ブランチテンプレートは、必要なときに使ってください:
- 初期フィールド値を作成したアイテムにコピーします(標準値から継承するのではなく)。これには、標準テンプレートフィールド(リボンコントロールで割り当てられる、例えばアイテムのアイコンやアクセス権割り当て)とカスタムデータテンプレートで定義されたフィールド(製品番号など)の両方が含まれます。
- 複数のアイテムを挿入しましょう。
- 挿入された項目にアクセス権を割り当てます。
- 分岐テンプレートを使ってどの口座がアイテムを挿入できるかを管理できます。
- コンテンツ作成者が複数のアイテム(兄弟または子孫のいずれか)を同時に作成できる機能を提供します。複数のコンテンツサブツリーは、ブランチテンプレートを使って作成可能です。
ブランチテンプレートの定義項目内には任意の数のアイテムを作成でき、各アイテムは任意の数の子孫項目を持てます。ユーザーが分岐テンプレートを使ってアイテムを作成すると、Sitecoreはトークンを展開する前に分岐テンプレート定義項目のすべての子孫を複製します。
!注Branch dataテンプレート(/System/Branches/Branch data template )または 新しいブランチコマンド テンプレート(/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つ以上の子孫を持つ1つの子項目からなる分岐テンプレートでは、その子項目の名前は通常 $nameされ、ユーザーが作成するルート項目の名前を指定できます。分岐テンプレートの項目名については、$nameのみがサポートされています
分岐テンプレートで標準値を上書きしないフィールドについては、新しい項目の対応するフィールドが標準値を示します。ただし、標準値に $nameのようなトークンが含まれていなければ、Sitecore与えられたアイテム名で置き換えられます。
!注ブランチテンプレートのフィールド値は簡単にデータの重複を引き起こす可能性があります。したがって、テンプレートの標準値は一般的にブランチテンプレートのフィールド値よりも好ましいです。また、ブランチテンプレートのフィールド値はテンプレートの標準値のように継承されるのではなく、コピーされるものであることも覚えておく必要があります。
したがって、そのブランチを使ってアイテムを作成した後に行われた変更は、以前に作成されたアイテムには反映されません。