一般的なクエリ構文
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
Sitecoreクエリ構文はコンテキストアイテムの概念を活用し、関連するアイテムを参照するために以下の記号を使用します:
シンボル
概要
/
コンテンツツリーの根、または親子関係。
本文
アイテム名でマッチング。
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
ダッシュを含むエスケープテキスト(-)。例えば:#meta-data#。また、特別な単語のエスケープにも使えます。例えば #and#、#or#。
*
ワイルドカード、名前のアイテムをマッチさせる。
..
コンテキストアイテムの親です。
[ ]
フィールドおよびXML要素属性に関連する条件をSearch。
@
アイテムの基本テンプレートで定義されたフィールド
@@
XML要素属性であり、すべてのSitecoreアイテムは「アイテム」要素として扱われ、以下の属性が含まれます
- アイテムのname.key - すべての小文字のアイテム名 characters.id - アイテムのGUID.tid - アイテムのベーステンプレートのGUID.mid - アイテムを作成するために使われる分岐テンプレート。sortorder - アイテムのsort order.template - アイテムのベーステンプレートの名前.parentid - アイテムの親のGUID。これらの記号を組み合わせることで、特定のアイテムやアイテムのグループを参照します。例えば:
Sitecoreクエリ文字列
結果集合
/*
コンテンツツリーの根です。
/sitecore/content/home
Sitecoreのホームアイテムです。
/sitecore/content/home/*[startswith(@title,'P')]
ホームアイテムの下にあるTitleフィールドがPで始まる直属サブアイテム。
Sitecoreクエリ文字列
結果集合
*[@ hidden='1']
コンテキスト項目の下に隠されたすべてのサブアイテム。
クエリ: //content/#meta- data#/colors/[@show='1']
Color項目で「表示」チェックボックスが選ばれたすべてのサブアイテムを選択するソースフィールドです。
./*[@@tid="{A87A00B1-E6DB-45AB-8B54-636FEC3B5523}"]
フォルダテンプレートに基づくコンテキストアイテムの下にサブアイテムを配置します。
!注可能な限り / 記号の使用は避けてください。なぜなら、クエリを複雑にし、パフォーマンスの問題を引き起こす可能性があるからです。例えば、query:$siteがquery:/$siteよりも望ましいです。
クエリトークン
クエリでは以下のトークンを使用できます:
- $pageDesigns - ページデザインの根源(sitecore/content/
/ )。/Presentation/Page Designs - $partialDesigns - 部分設計の根(sitecore/content/
/ )。/Presentation/Partial Designs - $currenttemplate - 現在のテンプレートの名前。
- $tenant - 現在のサイトコレクションへのパス。
- $site - 現在の場所への道。
- $home- 現在のサイト開始項目へのパス(デフォルトでは /sitecore/content/
/ )。/Home - $linkableHomes - リンク可能なサイトからホームアイテムへの経路。
- $templates - 現在のサイトテンプレートへのパス(/sitecore/templates/Project/Site Collection)。
- $siteMedia - 仮想メディアフォルダ項目の Additional Children フィールドで指定されたメディアフォルダへのパス。
- $sharedSites - マルチルートフィールドの場合、現在のサイトコレクションの共有サイトを解決します。
- $xaRichTextProfile - XA.Foundation.Editing.DefaultRichTextProfile 設定値。
- $sitelang - コンテキストサイトのデフォルト言語で、サイト定義項目に設定されています。
- $lang - 文脈言語。
- $vf - コンテキストサイトの仮想フォルダ。