1. Experience Edge API

プレビューGraphQLエンドポイント

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

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

プレビューGraphQLエンドポイントは、公開済みおよび未公開のコンテンツをコンテンツ管理(CM)バックエンドから読み込みます。未公開コンテンツの閲覧は、コンテンツを最終決定しExperience Edgeに公開する前に、コンテンツ開発ライフサイクルの重要な部分です。

注記

プレビューGraphQLエンドポイントはトークン化された検索インデックスを使用します。その結果、検索の挙動はフィールドのインデックス付け方法に依存します:

  • CONTAINS演算子はトークン化されたフィールド値に基づいて複数の結果を返すことができます。

  • EQ(等)演算子は、完全に一致が期待されていてもトークン化されたテキストフィールドに対して複数の結果を返すこともあります。

プレビューエンドポイントでEQとexact matchingを確保するために、SearchQueryFieldMapping機能を使ってトークン化されたフィールドを非トークン化された計算フィールドにマッピングしてください。関連するサポート記事も参照KB1003665。

探索演算子の挙動に関する情報は、Search演算子を参照してください。

以下のトピックは、Preview GraphQLエンドポイントの使い方を説明します。

GraphQLプレビューの制限や制限については、「 Edgeプレビューによるヘッドレスサービスの制限と制限」をご覧ください。

重要

読み取り専用のGraphQL(ミラー)スキーマの拡張はサポートしていません。なぜなら、Experience Edgeとの互換性が壊れるからです。

プレビューコンテンツと公開コンテンツのフィールドにはいくつかの違いがあります。したがって、Experience Edgeで公開されているコンテンツをクエリする際は、Experience Edgeのドキュメントに記載されているフィールドや、標準テンプレートから公開可能なフィールドを追加したフィールドを使いましょう。

メディアアイテムの認証を無効にすること

デフォルトでは、プレビューエンドポイントでメディア項目を表示するには認証が必要です。ただし、sitecore.configファイルのMedia.UrlSignatureExpirationTimeout設定を以下の形式で使用することで、指定された期間その要件を無効にすることができます。

<!-- MEDIA URL SIGNATURE EXPIRATION TIMEOUT
            The time after which the media URL signature expires.
            The value must be in the format "hh:mm:ss".
            Default value: 00:10:00 (10 minutes)
      -->
        <setting name="Media.UrlSignatureExpirationTimeout" value="00:10:00"/>

値が0に設定されている場合、認証は常に強制されます。

設定を更新した後は、パッチファイルを使って 設定変更を適用することを忘れないでください。

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