---
title: "一般的なクエリ構文"
slug: "general-query-syntax"
abstract: "Sitecoreクエリ構文の概要。"
---
# 一般的なクエリ構文

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

シンボル

概要

/

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

本文

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

#

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

\*

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

..

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

\[ \]

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

@

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

@@

XML要素属性であり、すべてのSitecoreアイテムは「アイテム」要素として扱われ、以下の属性が含まれます:name - アイテムの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/<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 - [リンク可能なサイト](https://doc.sitecore.com/xp/en/developers/sxa/104/sitecore-experience-accelerator/adjust-link-settings-to-enable-cross-site-linking.html)からホームアイテムへの経路。
-   $templates - 現在のサイトテンプレートへのパス(*/sitecore/templates/Project/Site Collection*)。
-   $siteMedia - 仮想メディアフォルダ項目の Additional Children フィールドで指定されたメディアフォルダへのパス。
-   $sharedSites - マルチルートフィールドの場合、現在のサイトコレクションの共有サイトを解決します。
-   $xaRichTextProfile - XA.Foundation.Editing.DefaultRichTextProfile 設定値。
-   $sitelang - コンテキストサイトのデフォルト言語で、サイト定義項目に設定されています。
-   $lang - 文脈言語。
-   $vf \- コンテキストサイトの仮想フォルダ。