--- title: "Edgeプレビュー付きヘッドレスサービスの制限と制限" slug: "limitations-and-restrictions-for-headless-services-with-the-edge-preview" abstract: "Experience Edge PreviewおよびHeadlessサービスでの利用に関する制限、制限、制限について。" --- # Edgeプレビュー付きヘッドレスサービスの制限と制限 Experience Edge[プレビューエンドポイント](https://doc.sitecore.com/xp/ja/developers/hd/19/sitecore-headless-development/sitecore-experience-edge-for-xm-preview-graphql-endpoint.html "Sitecore Experience Edge for XM Preview GraphQL endpoint")でヘッドレスサービスを使用する場合、以下の制限や制限が適用されます。 > !注Content Hubの情報アーキテクトや技術職の方は、プレビューサイトの詳細は「[Accelerate Cookbook for SitecoreAI](https://developers.sitecore.com/learn/accelerate/xm-cloud/implementation/information-architecture/preview-website#additonal-preview-site-definition)」でご覧いただけます。このレシピは、SitecoreAIのセットアップ、設定、実装を円滑に行うための情報を提供しています。 ## カスタムフィールド命名 検索述語で使用されるカスタムフィールド名は、アンダースコア(\_)で始まってはなりません。検索サービスは、\_name、\_path、\_languageなどのシステムフィールドに対してアンダースコアプレフィックスを予約します。 \_myCustomFieldというカスタムフィールドで検索しようとすると、サービスがカスタムフィールドをシステムフィールドの内部許可リストに対して解析しようとするため、例外(*NotSupportedFieldException*)が発生します。 ## ページ数制限 ページ数制限はクエリの種類によって異なります: - *allSiteInfo* クエリ - オフセット(pageNumber × pageSize)の組み合わせは10,000を超えてはなりません。この数を超えると、エラーメッセージ *「オフセットページングは最大10,000サイトのみをサポートしていますが、{X}* 」が表示されます。 - *Dictionary* クエリ - サイトノードの最初の引数(ページサイズ)は1,000を超えてはなりません。サイト { siteInfo { dictionary(first: 1001) } } などのフィールドで最初の1,001以上を要求するとGraphQLエラーになります。 *「最初の」値は1000を超えてはいけ*ません。 ## オペレーターの挙動 *Equality*演算子(EQ)は文字列フィールドの*Contains*演算子のように振る舞います。例えば、次の検索述語はフィールドトークン化のため正確な一致を生み出しません。この制限を回避するために、Sitecoreサポートナレッジベースの[KB1003665](https://support.sitecore.com/kb?id=kb_article_view&sysparm_article=KB1003665)を参照してください。 name: "customField" value: "value to look for" operator: EQ ## 順序付けの挙動 検索クエリは、項目テキストフィールドでorderByを使うとフィールドトークン化のために一貫性のない結果を返すことがあります。 ## ルート経路の制限 サイトクエリのルートフィールドはフィルタリングされたパスの数を制限しています。引数includedPathsとexcludedPathsに割り当てられる文字列の合計は100を超えてはなりません。この制限を超えるとエラーが発生します。 *「routes」フィールドでは、「excludedPaths」と「includedPaths」の合計数は100を超えてはなりません*。 ## URL解決 アイテムの**URL**フィールドは、上書きされたItemUrlBuilderOptionsを用いて解決されます: - AlwaysIncludeServerUrl は trueに設定されています。 - AlwaysExcludeVirtualFolder は trueに設定されています。 - SiteResolving 無効化されています(false)。 - スペースはダッシュに符号化されます。