1. GraphQL

Edgeプレビュー付きヘッドレスサービスの制限と制限

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

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

Experience Edgeプレビューエンドポイントでヘッドレスサービスを使用する場合、以下の制限や制限が適用されます。

!注Content Hubの情報アーキテクトや技術職の方は、プレビューサイトの詳細は「Accelerate Cookbook for SitecoreAI」でご覧いただけます。このレシピは、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を参照してください。

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)。
  • スペースはダッシュに符号化されます。
この記事を改善するための提案がある場合は、 お知らせください!