Experience Edgeスキーマ

Experience Edgeスキーマで利用可能なタイプは、公開されたSitecoreインスタンスのテンプレート定義を反映しています。特定のタイプからフィールドを選択するインラインフラグメントを使用することで、強力型テンプレートフィールドを有効にすることができます。

Sitecoreのバックエンドでは、テンプレートやフィールドに同じ名前を付けることができます。しかし、GraphQLでは型やフィールドの名前は一意でなければなりません。命名衝突が発生すると、最も新しい作成日のアイテムまたはフィールドアイテムが _{guid} 名前に付加されます。作成日が使われるのは、順序が安定していなければならず、グラフ型の名前は参照後に決して変更されてはならないからです。

検索クエリのようなページ分け付きクエリやExperience Edgeスキーマ内のフィールドは、カーソルベースのシステムを使って結果ページを要求します。

ページ付きクエリの場合:

クエリの複雑度とは、実行にどれだけリソースを消費するかに基づいてGraphQLクエリに割り当てられる数値スコアを指します。このスコアは、過度に複雑なクエリがパフォーマンスを低下させたり、サービス拒否のリスクを生むのを防ぐのに役立ちます。Experience Edgeクエリには複雑さの上限があります。クエリを実行環境で使用する前に、複雑さの要件を満たしているか確認するためにテストすることをお勧めします。もしクエリが複雑すぎる場合は、以下の方法を試してみてください。

データ構造の本質的な違いにより、複雑度はデリバリーエンドポイントとプレビューエンドポイント(コンテンツ管理のバックエンド)で異なる計算方法で行われます。複雑さ計算ができるだけ近いようにデフォルト設定を導入しました。しかし、それらを完全に一致させることは不可能です。

プレビューエンドポイントのいくつかの設定オプションは、sitecore.configファイルのcomplexityConfigurationオブジェクト内で利用可能です。

<!-- 
  COMPLEXITY CONFIGURATION
  It is possible to conduct denial of service attacks by constructing extremely expensive to run GraphQL queries.
  The complexity configuration defeats that by limiting how complex of a query will be run.
  
  maxDepth: the maximum nesting depth in a query. maxDepth values lower than 15 will prevent /ui from running.  
  fieldImpact: the average impact of adding a list field to a query (e.g. how many average items it would return).
  maxComplexity: the maximum field impact a query can have before it's rejected. With a fieldImpact at 2, values of maxComplexity less than 250 will prevent /ui from running.
-->
<complexityConfiguration type="GraphQL.Validation.Complexity.ComplexityConfiguration, GraphQL" patch:source="Mvp.Environment.GraphQL.config">
  <maxDepth>15</maxDepth>
  <maxComplexity>10000</maxComplexity>
  <fieldImpact>2</fieldImpact>
</complexityConfiguration>

あるいは、非本番環境では、プレビューエンドポイントの複雑さ制限を到達できない大きな数に引き上げ、本番環境でのExperience Edge(デリバリー)クエリのコストを見積もるためにクエリを実行することもできます。

Experience Edgeでは、以下の表に記載された特殊フィールドに対してGraphQL searchクエリを使用できます。テンプレートをクエリする際は、ユーザー定義のフィールドと以下の特殊フィールドのみを照会できます。例えば、サンプルアイテムテンプレートのユーザー定義titleフィールドをクエリすることはできますが、_Sortorderはできません。

query Search {
  search(
    where: {
      name: "title",
      value: "Sitecore",
      operator: CONTAINS
    }
  ) {
    results {
      id
      name
    }
  }
}

query Search {
  search(
    where: {
      name: "_parent"
      value: "110D559FDEA542EA9C1C8A5DF7E70EF9"
      operator: EQ
    }
  ) {
    results {
      id
      name
    }
  }
}

query Search {
  search(
    where: {
      AND: [
        {
          name: "_parent"
          value: "110D559FDEA542EA9C1C8A5DF7E70EF9"
          operator: EQ
        },
        {
          name: "title"
          value: "another"
          operator: CONTAINS
        }
      ]
    }
  ) {
    results {
      id
      name
    }
  }
}

Edgeで画像に変更を直接適用できます。画像操作には以下のオプションがサポートされています: