---
title: "オプション挿入"
slug: "insert-options"
abstract: "挿入オプションの概要とその使い方。"
---
# オプション挿入

効果的な挿入オプションは、ユーザーが既存アイテムの下に挿入できるアイテムの種類を制御します。Sitecoreは割り当てられた挿入オプションからアイテムの効果的な挿入オプションを決定します。個々のアイテムやデータテンプレートに基づいて、アイテムやデータテンプレートの標準値に挿入ルールを割り当てることで、個々のアイテムやすべてのアイテムに対してプログラム的に有効挿入オプションを操作できます。インサートオプションパイプライン内のプロセッサを削除、置き換え、または追加することで、すべてのアイテムの効果的な挿入オプションを操作できます。

Sitecoreの管理者および開発者は、挿入オプションを以下に設定します:

-   既存のアイテムの下に適切なタイプのアイテムを作成するのを支援しましょう。これにより、ユーザーが挿入可能なすべての種類のデータのリストを表示するのではなく、関連するオプションにリストを限定することで使いやすさが向上します。
-   既存の項目で作成できるアイテムの種類を制限しましょう。これにより情報アーキテクチャを強化でき、一貫性が向上します。
-   異なるユーザーが既存のアイテムの下に異なる種類のアイテムを作成できるようにします。
-   ユーザーインターフェースの単一のアクションで複数のアイテムを作成するのを助けましょう。
-   例えば、ウィザードを呼び出すことでプログラム的にアイテムを作成できます。また、システム内で利用可能なデータの種類を予測できるプレゼンテーションコンポーネントを作成することもできます。

以下の表は利用可能な挿入オプションを示しています。

オプション挿入

概要

効果的な挿入オプション

効果的な挿入オプションには、選択した項目の下に新しい項目を挿入するために使用できるデータテンプレート、ブランチテンプレート、コマンドテンプレートのリストが含まれます。詳細については、「 [割り当てられた挿入オプション」と「有効挿入オプション](https://doc.sitecore.com/xp/ja/developers/103/sitecore-experience-manager/assigned-insert-options-versus-effective-insert-options.html)」を参照してください。

割り当てられた挿入オプション

データテンプレートの標準値で挿入オプションを割り当てることができます。割り当てられた挿入オプションには、データテンプレート、ブランチテンプレート、コマンドテンプレート、挿入ルールが含まれます。詳細は「 [割り当てられた挿入オプションと効果的な挿入オプション](https://doc.sitecore.com/xp/ja/developers/103/sitecore-experience-manager/assigned-insert-options-versus-effective-insert-options.html)」をご覧ください。  
  
\>\[!重要\]  
\> 可能な限り、個々のアイテムに挿入オプションを割り当てるのではなく、標準値で挿入オプションを割り当ててください。

ルール挿入

管理者は挿入オプション内で挿入ルールを割り当て、実行時にユーザーの効果的な挿入オプションを動的に再定義できます。開発者は管理者が選択できるカスタム挿入ルールを実装できます。

オプションルールを挿入

管理者は効果的な挿入オプションを定義するために挿入オプションルールを実装でき、ルールパラメータを選択するユーザーインターフェースを提供します。特定のアイテムに適用される挿入ルールとは異なり、挿入オプションルールはすべてのアイテムに適用されますが、条件は通常その適用を制限します。.

uiGetMastersパイプライン

SitecoreはSitecore.configファイルで定義されたuiGetMastersパイプラインを呼び出して、効果的な挿入オプションのリストを構築します。uiGetMastersパイプラインは、新しいアイテムを挿入するためにユーザーが利用可能なデータテンプレート、コマンドテンプレート、ブランチテンプレートのリストを定義します。  
  
uiGetMastersパイプラインは、アイテムの効果的な挿入オプションを決定するために以下のプロセスを用います。  
  

1.  コンテキストユーザーが読みアクセス権を持つ各アイテムの割り当て挿入オプションを、効果的な挿入オプションのリストに追加します。
2.  アイテムに関連する挿入ルールを有効な挿入オプションのリストに適用します。
3.  効果的な挿入オプションのリストに挿入オプションルールを適用します。
4.  コンテキストユーザーが insert:show アクセス権を持っていない項目は削除してください。

  
  
開発者は、実行時にユーザーの効果的な挿入オプションを決定するために、ロジックを含むカスタムプロセッサを uiGetMasters パイプラインに追加できます。挿入ルールがそれらのルールを参照するアイテムにのみ適用されるのに対し、 uiGetMasters パイプラインはすべてのアイテムに適用されます。