1. Sitecoreクエリ

一般的なクエリ構文

日本語翻訳に関する免責事項

このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。

Sitecoreクエリ構文はコンテキストアイテムの概念を活用し、関連するアイテムを参照するために以下の記号を使用します:

シンボル

概要

/

コンテンツツリーの根、または親子関係。

テキスト

アイテム名でマッチング。

#

ダッシュを含むエスケープテキスト(-)。例えば:#meta-data#。また、特別な単語を逃れるためにも使われます。例えば、#and#、#or#。

*

ワイルドカード、名前のアイテムをマッチさせる。

..

コンテキストアイテムの親です。

フィールドおよびXML要素属性に関連する条件をSearch。

@

アイテムの基本テンプレートで定義されたフィールド

@@

XML要素属性であるすべてのSitecoreアイテムは「アイテム」要素として扱われ、以下の属性が含まれます:

  • name - アイテム名。

  • key - アイテム名をすべて小文字で表す。

  • id - アイテムはGUID。

  • tid - アイテムのベーステンプレートのGUID。

  • mid - アイテム作成に使用された分岐テンプレート(もし存在する場合)。

  • sortorder - 品物の並べ順。

  • template - アイテムのベーステンプレートの名前。

  • parentid - そのアイテムの親のGUID。

これらの記号を組み合わせることで、特定のアイテムやアイテムのグループが指されます。例えば：

Sitecoreクエリ文字列

結果集合

/*

コンテンツツリーの根です。

/sitecore/content/home

Sitecoreのホームアイテムです。

/sitecore/content/home/*startswith(@title,'P')

ホームアイテムの下にある即時のサブアイテムで、Pで始まるTitleフィールドが含まれています。

Sitecoreクエリ文字列

結果集合

*@ hidden='1'

コンテキスト項目の下に隠されたすべてのサブアイテム。

query: /*/content/#meta- data#/colors/*@show='1'

Showチェックボックスが選ばれたColor項目のサブアイテムをすべて選択するSourceフィールドです。

./*@@tid="{A87A00B1-E6DB-45AB-8B54-636FEC3B5523}"

Folderテンプレートに基づくコンテキスト項目の下にサブアイテムを配置します。

注記

可能な限り / 記号の使用は避けてください。なぜなら、クエリが複雑になりパフォーマンスの問題につながる可能性があるからです。例えば、query:$siteがquery:/$siteよりも好ましいです。

変数

クエリには以下の変数を含めることができます:

  • $compatibleThemes - すべてのテーマへの道。

  • $theme - 現在使用されているテーマ。

  • $pageDesigns - ページデザインの根(sitecore/content/<site collection>/<site>/Presentation/Page Designs)。

  • $partialDesigns - 部分設計の根(sitecore/content/<site collection>/<site>/Presentation/Partial Designs)。

  • $currenttemplate - 現在のテンプレートの名前。

  • $tenant - 現在のサイトコレクションへのパス。

  • $site - 現在の場所への道。

  • $home - 現在のサイト開始項目へのパス(デフォルトでは /sitecore/content/<site collection>/<site>/Home)。

  • $linkableHomes - リンク可能なサイトからホームアイテムへの経路。

  • $templates - 現在のサイトテンプレートへのパス(/sitecore/templates/Project/Site Collection)。

  • $siteMedia - 仮想メディアフォルダ項目のAdditional Childrenフィールドで指定されたメディアフォルダへのパス。

  • $sharedSites - マルチルートフィールドの場合、現在のサイトコレクションの共有サイトを解決します。

  • $rvSystemTemplates - 構成で定義されたテンプレートの一覧。これらのテンプレートは、バリアントのレンダリング用フィールドAllowedInTemplatesに供給するために使われます。

  • $xaRichTextProfile - XA.Foundation.Editing.DefaultRichTextProfile設定値。

  • $sitelang - コンテキストサイトのデフォルト言語で、サイト定義項目に設定されています。

  • $lang - 文脈言語。

  • $vf - コンテキストサイトの仮想フォルダ。

この記事を改善するための提案がある場合は、 お知らせください!