了解如何将 GraphQL 与 AEM 结合使用 – 示例内容和查询 learn-graphql-with-aem-sample-content-queries

Last update: Sat Sep 07 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主题：
无头

创建对象：

管理员
开发人员

通过探索示例内容和查询，了解如何将 GraphQL 与 AEM 结合使用，以 Headless 方式提供内容。

NOTE

阅读本页以及以下内容：

要开始了解 GraphQL 查询以及它们如何与 AEM 内容片段结合使用，看一些具体的示例会有所帮助。

有关这方面的帮助，请查看：

一个示例内容片段结构
以及一些示例 GraphQL 查询，基于示例内容片段结构（内容片段模型以及相关的内容片段）。

GraphQL – 使用示例内容片段结构的示例查询 graphql-sample-queries-sample-content-fragment-structure

查看这些示例查询，以了解创建查询的说明以及示例结果。

NOTE

根据您的实例，您可以直接访问 AEM GraphQL API 中包含的 GraphiQL 接口，用于提交和测试查询。

您可以通过以下任一方式访问查询编辑器：

工具 > 常规 > GraphQL 查询编辑器
直接；例如，http://localhost:4502/aem/graphiql.html

NOTE

示例查询基于用于 GraphQL 的示例内容片段结构

示例查询 – 所有可用架构和数据类型 sample-all-schemes-datatypes

返回所有可用架构的所有 types。

示例查询

{
  __schema {
    types {
      name
      description
    }
  }
}

示例结果

{
  "data": {
    "__schema": {
      "types": [
        {
          "name": "AdventureModel",
          "description": null
        },
        {
          "name": "AdventureModelArrayFilter",
          "description": null
        },
        {
          "name": "AdventureModelFilter",
          "description": null
        },
        {
          "name": "AdventureModelResult",
          "description": null
        },
        {
          "name": "AdventureModelResults",
          "description": null
        },
        {
          "name": "AllFragmentModels",
          "description": null
        },
        {
          "name": "ArchiveRef",
          "description": null
        },
        {
          "name": "ArrayMode",
          "description": null
        },
        {
          "name": "ArticleModel",
          "description": null
        },

...more results...

        {
          "name": "__EnumValue",
          "description": null
        },
        {
          "name": "__Field",
          "description": null
        },
        {
          "name": "__InputValue",
          "description": null
        },
        {
          "name": "__Schema",
          "description": "A GraphQL Introspection defines the capabilities of a GraphQL server. It exposes all available types and directives on the server, the entry points for query, mutation, and subscription operations."
        },
        {
          "name": "__Type",
          "description": null
        },
        {
          "name": "__TypeKind",
          "description": "An enum describing what kind of type a given __Type is"
        }
      ]
    }
  }
}

示例查询 – 关于所有城市的所有信息 sample-all-information-all-cities

要检索有关所有城市的所有信息，您可以使用以下基本的查询：
示例查询

{
  cityList {
    items
  }
}

在运行时，系统会自动扩展查询，以包含所有字段：

{
  cityList {
    items {
      _path
      name
      country
      population
    }
  }
}

示例结果

{
  "data": {
    "cityList": {
      "items": [
        {
          "_path": "/content/dam/sample-content-fragments/cities/basel",
          "name": "Basel",
          "country": "Switzerland",
          "population": 172258
        },
        {
          "_path": "/content/dam/sample-content-fragments/cities/berlin",
          "name": "Berlin",
          "country": "Germany",
          "population": 3669491
        },
        {
          "_path": "/content/dam/sample-content-fragments/cities/bucharest",
          "name": "Bucharest",
          "country": "Romania",
          "population": 1821000
        },
        {
          "_path": "/content/dam/sample-content-fragments/cities/san-francisco",
          "name": "San Francisco",
          "country": "USA",
          "population": 883306
        },
        {
          "_path": "/content/dam/sample-content-fragments/cities/san-jose",
          "name": "San Jose",
          "country": "USA",
          "population": 1026350
        },
        {
          "_path": "/content/dam/sample-content-fragments/cities/stuttgart",
          "name": "Stuttgart",
          "country": "Germany",
          "population": 634830
        },
        {
          "_path": "/content/dam/sample-content-fragments/cities/zurich",
          "name": "Zurich",
          "country": "Switzerland",
          "population": 415367
        }
      ]
    }
  }
}

示例查询 – 所有城市的名称 sample-names-all-cities

可返回city架构中name所有条目的直接查询。

示例查询

query {
  cityList {
    items {
      name
    }
  }
}

示例结果

{
  "data": {
    "cityList": {
      "items": [
        {
          "name": "Basel"
        },
        {
          "name": "Berlin"
        },
        {
          "name": "Bucharest"
        },
        {
          "name": "San Francisco"
        },
        {
          "name": "San Jose"
        },
        {
          "name": "Stuttgart"
        },
        {
          "name": "Zurich"
        }
      ]
    }
  }
}

示例查询 – 一个特定城市片段 sample-single-specific-city-fragment

可返回存储库中特定位置的单个片段条目的详细信息的查询。

示例查询

{
  cityByPath (_path: "/content/dam/sample-content-fragments/cities/berlin") {
    item {
      _path
      name
      country
      population
     categories
    }
  }
}

示例结果

{
  "data": {
    "cityByPath": {
      "item": {
        "_path": "/content/dam/sample-content-fragments/cities/berlin",
        "name": "Berlin",
        "country": "Germany",
        "population": 3669491,
        "categories": [
          "city:capital",
          "city:emea"
        ]
      }
    }
  }
}

示例查询 – 具有指定变体的所有城市 sample-cities-named-variation

如果您为 city 柏林创建了一个名为“柏林中心” (berlin_centre) 的变体，则可以使用查询返回变体的详细信息。

示例查询

{
  cityList (variation: "berlin_center") {
    items {
      _path
      name
      country
      population
      categories
    }
  }
}

示例结果

{
  "data": {
    "cityList": {
      "items": [
        {
          "_path": "/content/dam/sample-content-fragments/cities/berlin",
          "name": "Berlin",
          "country": "Germany",
          "population": 3669491,
          "categories": [
            "city:capital",
            "city:emea"
          ]
        }
      ]
    }
  }
}

示例查询 - 标记为“城市度假”的所有城市的名称 sample-names-all-cities-tagged-city-breaks

如果您：

创建各种标签，并命名为 Tourism : Business, City Break, Holiday
并将其分配给各种 City 实例的主变体

然后，您可以使用查询返回city模式中标记为 City Breaks 的所有条目的 name 和 tags 的详细信息。

示例查询

query {
  cityList(
    includeVariations: true,
    filter: {_tags: {_expressions: [{value: "tourism:city-break", _operator: CONTAINS}]}}
  ){
    items {
      name,
      _tags
    }
  }
}

示例结果

{
  "data": {
    "cityList": {
      "items": [
        {
          "name": "Berlin",
          "_tags": [
            "tourism:city-break",
            "tourism:business"
          ]
        },
        {
          "name": "Zurich",
          "_tags": [
            "tourism:city-break",
            "tourism:business"
          ]
        }
      ]
    }
  }
}

示例查询 – 公司的 CEO 和员工的完整详细信息 sample-full-details-company-ceos-employees

使用嵌套片段的结构，此查询返回公司的 CEO 及其所有员工的完整详细信息。

示例查询

query {
  companyList {
    items {
      name
      ceo {
        _path
        name
        firstName
        awards {
        id
          title
        }
      }
      employees {
       name
        firstName
       awards {
         id
          title
        }
      }
    }
  }
}

示例结果

{
  "data": {
    "companyList": {
      "items": [
        {
          "name": "Apple Inc.",
          "ceo": {
            "_path": "/content/dam/sample-content-fragments/persons/steve-jobs",
            "name": "Jobs",
            "firstName": "Steve",
            "awards": []
          },
          "employees": [
            {
              "name": "Marsh",
              "firstName": "Duke",
              "awards": []
            },
            {
              "name": "Caulfield",
              "firstName": "Max",
              "awards": [
                {
                  "id": "GB",
                  "title": "Gameblitz"
                }
              ]
            }
          ]
        },
        {
          "name": "Little Pony, Inc.",
          "ceo": {
            "_path": "/content/dam/sample-content-fragments/persons/adam-smith",
            "name": "Smith",
            "firstName": "Adam",
            "awards": []
          },
          "employees": [
            {
              "name": "Croft",
              "firstName": "Lara",
              "awards": [
                {
                  "id": "GS",
                  "title": "Gamestar"
                }
              ]
            },
            {
              "name": "Slade",
              "firstName": "Cutter",
              "awards": [
                {
                  "id": "GB",
                  "title": "Gameblitz"
                },
                {
                  "id": "GS",
                  "title": "Gamestar"
                }
              ]
            }
          ]
        },
        {
          "name": "NextStep Inc.",
          "ceo": {
            "_path": "/content/dam/sample-content-fragments/persons/steve-jobs",
            "name": "Jobs",
            "firstName": "Steve",
            "awards": []
          },
          "employees": [
            {
              "name": "Smith",
              "firstName": "Joe",
              "awards": []
            },
            {
              "name": "Lincoln",
              "firstName": "Abraham",
              "awards": []
            }
          ]
        }
      ]
    }
  }
}

示例查询 – 所有名为“Jobs”或“Smith”的人 sample-all-persons-jobs-smith

用于筛选所有名称为 Jobs 或 Smith 的 persons 的查询。

示例查询

query {
  personList(filter: {
    name: {
      _logOp: OR
      _expressions: [
        {
          value: "Jobs"
        },
        {
          value: "Smith"
        }
      ]
    }
  }) {
    items {
      name
      firstName
    }
  }
}

示例结果

{
  "data": {
    "personList": {
      "items": [
        {
          "name": "Smith",
          "firstName": "Adam"
        },
        {
          "name": "Smith",
          "firstName": "Joe"
        },
        {
          "name": "Jobs",
          "firstName": "Steve"
        }
      ]
    }
  }
}

示例查询 – 所有名字不是“Jobs”的人 sample-all-persons-not-jobs

用于筛选所有名称为 Jobs 或 Smith 的 persons 的查询。

示例查询

query {
  personList(filter: {
    name: {
      _expressions: [
        {
          value: "Jobs"
          _operator: EQUALS_NOT
        }
      ]
    }
  }) {
    items {
      name
      firstName
    }
  }
}

示例结果

{
  "data": {
    "personList": {
      "items": [
        {
          "name": "Lincoln",
          "firstName": "Abraham"
        },
        {
          "name": "Smith",
          "firstName": "Adam"
        },
        {
          "name": "Slade",
          "firstName": "Cutter"
        },
        {
          "name": "Marsh",
          "firstName": "Duke"
        },
        {
          "name": "Smith",
          "firstName": "Joe"
        },
        {
          "name": "Croft",
          "firstName": "Lara"
        },
        {
          "name": "Caulfield",
          "firstName": "Max"
        }
      ]
    }
  }
}

示例查询 – 其 `_path` 以特定前缀开头的所有冒险 sample-wknd-all-adventures-cycling-path-filter

其 _path 以特定前缀 (/content/dam/wknd/en/adventures/cycling) 开头的所有 adventures。

示例查询

query {
  adventureList(
    filter: {
      _path: {
        _expressions: [
        {
          value: "/content/dam/wknd/en/adventures/cycling"
         _operator: STARTS_WITH
        }]
       }
    })
    {
    items {
      _path
    }
  }
}

示例结果

{
  "data": {
    "adventureList": {
      "items": [
        {
          "_path": "/content/dam/wknd/en/adventures/cycling-southern-utah/cycling-southern-utah"
        },
        {
          "_path": "/content/dam/wknd/en/adventures/cycling-tuscany/cycling-tuscany"
        }
      ]
    }
  }
}

示例查询 – 位于德国或瑞士且人口在 400000 到 999999 之间的所有城市。 sample-all-cities-d-ch-population

以下是筛选的字段组合。使用 AND（隐式）来选择 population 范围，使用 OR（显式）来选择所需的城市。

示例查询

query {
  cityList(filter: {
    population: {
      _expressions: [
        {
          value: 400000
          _operator: GREATER_EQUAL
        }, {
          value: 1000000
          _operator: LOWER
        }
      ]
    },
    country: {
      _logOp: OR
      _expressions: [
        {
          value: "Germany"
        }, {
          value: "Switzerland"
        }
      ]
    }
  }) {
    items {
      name
      population
      country
    }
  }
}

示例结果

{
  "data": {
    "cityList": {
      "items": [
        {
          "name": "Stuttgart",
          "population": 634830,
          "country": "Germany"
        },
        {
          "name": "Zurich",
          "population": 415367,
          "country": "Switzerland"
        }
      ]
    }
  }
}

示例查询 – 名称中包含 SAN 的所有城市，不考虑大小写 sample-all-cities-san-ignore-case

此查询查找名称中包含 SAN 的所有城市，不考虑大小写。

示例查询

query {
  cityList(filter: {
    name: {
      _expressions: [
        {
          value: "SAN"
          _operator: CONTAINS
          _ignoreCase: true
        }
      ]
    }
  }) {
    items {
      name
      population
      country
    }
  }
}

示例结果

{
  "data": {
    "cityList": {
      "items": [
        {
          "name": "San Francisco",
          "population": 883306,
          "country": "USA"
        },
        {
          "name": "San Jose",
          "population": 1026350,
          "country": "USA"
        }
      ]
    }
  }
}

示例查询 – 筛选数组中必须至少出现一次的项 sample-array-item-occur-at-least-once

此查询筛选数组中必须至少出现一次的项 (city:na)。

示例查询

query {
  cityList(filter: {
    categories: {
      _expressions: [
        {
          value: "city:na"
          _apply: AT_LEAST_ONCE
        }
      ]
    }
  }) {
    items {
      name
      population
      country
      categories
    }
  }
}

示例结果

{
  "data": {
    "cityList": {
      "items": [
        {
          "name": "San Francisco",
          "population": 883306,
          "country": "USA",
          "categories": [
            "city:beach",
            "city:na"
          ]
        },
        {
          "name": "San Jose",
          "population": 1026350,
          "country": "USA",
          "categories": [
            "city:na"
          ]
        }
      ]
    }
  }
}

示例查询 – 根据精确的数组值筛选 sample-array-exact-value

此查询筛选一个精确的数组值。

示例查询

query {
  cityList(filter: {
    categories: {
      _expressions: [
        {
          values: [
            "city:beach",
            "city:na"
          ]
        }
      ]
    }
  }) {
    items {
      name
      population
      country
      categories
    }
  }
}

示例结果

{
  "data": {
    "cityList": {
      "items": [
        {
          "name": "San Francisco",
          "population": 883306,
          "country": "USA",
          "categories": [
            "city:beach",
            "city:na"
          ]
        }
      ]
    }
  }
}

嵌套内容片段的示例查询 – 至少有一位员工名为“Smith”的所有公司 sample-companies-employee-smith

此查询演示了筛选 name 为“Smith”的任意 person，跨两个嵌套片段返回结果：company 和 employee。

示例查询

query {
  companyList(filter: {
    employees: {
      _match: {
        name: {
          _expressions: [
            {
              value: "Smith"
            }
          ]
        }
      }
    }
  }) {
    items {
      name
      ceo {
        name
        firstName
      }
      employees {
        name
        firstName
      }
    }
  }
}

示例结果

{
  "data": {
    "companyList": {
      "items": [
        {
          "name": "NextStep Inc.",
          "ceo": {
            "name": "Jobs",
            "firstName": "Steve"
          },
          "employees": [
            {
              "name": "Smith",
              "firstName": "Joe"
            },
            {
              "name": "Lincoln",
              "firstName": "Abraham"
            }
          ]
        }
      ]
    }
  }
}

嵌套内容片段的示例查询 – 所有员工赢得了“Gamestar”奖项的所有公司 sample-all-companies-employee-gamestar-award

此查询演示了跨三个嵌套片段筛选：company、employee 和 award。

示例查询

query {
  companyList(filter: {
    employees: {
      _apply: ALL
      _match: {
        awards: {
          _match: {
            id: {
              _expressions: [
                {
                  value: "GS"
                  _operator:EQUALS
                }
              ]
            }
          }
        }
      }
    }
  }) {
    items {
      name
      ceo {
        name
        firstName
      }
      employees {
        name
        firstName
        awards {
          id
          title
        }
      }
    }
  }
}

示例结果

{
  "data": {
    "companyList": {
      "items": [
        {
          "name": "Little Pony, Inc.",
          "ceo": {
            "name": "Smith",
            "firstName": "Adam"
          },
          "employees": [
            {
              "name": "Croft",
              "firstName": "Lara",
              "awards": [
                {
                  "id": "GS",
                  "title": "Gamestar"
                }
              ]
            },
            {
              "name": "Slade",
              "firstName": "Cutter",
              "awards": [
                {
                  "id": "GB",
                  "title": "Gameblitz"
                },
                {
                  "id": "GS",
                  "title": "Gamestar"
                }
              ]
            }
          ]
        }
      ]
    }
  }
}

元数据的示例查询 – 列出标题为 GB 的奖项的元数据 sample-metadata-awards-gb

此查询演示了跨三个嵌套片段筛选：company、employee 和 award。

示例查询

query {
  awardList(filter: {
      id: {
        _expressions: [
          {
            value:"GB"
          }
        ]
    }
  }) {
    items {
      _metadata {
        stringMetadata {
          name,
          value
        }
      }
      id
      title
    }
  }
}

示例结果

{
  "data": {
    "awardList": {
      "items": [
        {
          "_metadata": {
            "stringMetadata": [
              {
                "name": "title",
                "value": "Gameblitz Award"
              },
              {
                "name": "description",
                "value": ""
              }
            ]
          },
          "id": "GB",
          "title": "Gameblitz"
        }
      ]
    }
  }
}

使用 WKND 项目的示例查询 sample-queries-using-wknd-project

这些示例查询基于 WKND 项目。它包括以下内容：

在以下位置提供的内容片段模型：
http://<hostname>:<port>/libs/dam/cfm/models/console/content/models.html/conf/wknd
在以下位置提供的内容片段（和其他内容）：
http://<hostname>:<port>/assets.html/content/dam/wknd/en
http://<hostname>:<port>/assets.html/content/dam/wknd-shared/en

NOTE

由于结果可能会很庞大，所以这里不再重复。

具有指定属性的特定模型的所有内容片段示例查询 sample-wknd-all-model-properties

此示例查询查找：

类型为 article 的所有内容片段
具有 _path 和 authorFragment 属性。

示例查询

{
  articleList {
    items {
      _path
      authorFragment {
        _path
        firstName
        lastName
        birthDay
      }
    }
 }
}

元数据的示例查询 sample-wknd-metadata

此查询查找：

类型为 adventure 的所有内容片段
元数据

示例查询

{
  adventureList {
    items {
      _path,
      _metadata {
        stringMetadata {
          name,
          value
        }
        stringArrayMetadata {
          name,
          value
        }
        intMetadata {
          name,
          value
        }
        intArrayMetadata {
          name,
          value
        }
        floatMetadata {
          name,
          value
        }
        floatArrayMetadata {
          name,
          value
        }
        booleanMetadata {
          name,
          value
        }
        booleanArrayMetadata {
          name,
          value
        }
        calendarMetadata {
          name,
          value
        }
        calendarArrayMetadata {
          name,
          value
        }
      }
    }
  }
}

给定模型的单个内容片段的示例查询 sample-wknd-single-content-fragment-of-given-model

此示例查询查找：

特定路径下类型为 article 的单个内容片段
- 在该片段中，所有格式的内容：
  - HTML
  - Markdown
  - 纯文本
  - JSON

示例查询

{
  articleByPath(_path: "/content/dam/wknd-shared/en/magazine/alaska-adventure/alaskan-adventures") {
    item {
        _path
        authorFragment {
          _path
          firstName
          lastName
          birthDay
        }
        main {
          html
          markdown
          plaintext
          json
        }
    }
  }
}

来自模型的内容片段模型的示例查询 sample-wknd-content-fragment-model-from-model

此示例查询查找：

单个内容片段
- 底层内容片段模型的详细信息

示例查询

{
  adventureByPath(_path: "/content/dam/wknd-shared/en/magazine/western-australia/western-australia-by-camper-van") {
    item {
      _path
      title
      _model {
        _path
        title
      }
    }
  }
}

嵌套内容片段的示例查询 – 单个模型类型 sample-wknd-nested-fragment-single-model

此查询查找：

特定路径下类型为 article 的单个内容片段
- 在该片段中，引用（嵌套）片段的路径和作者

NOTE

字段 referencearticle 具有数据类型 fragment-reference。

示例查询

{
  adventureByPath(_path: "/content/dam/wknd-shared/en/magazine/western-australia/western-australia-by-camper-van") {
    item {
      _path
      title
      _model {
        _path
        title
      }
    }
  }
}

嵌套内容片段的示例查询 – 多个模型类型 sample-wknd-nested-fragment-multiple-model

单一引用模型类型

此查询查找：

类型为 bookmark 的多个内容片段
- 带有对特定模型类型 Article 的其他片段的片段引用

NOTE

字段 fragments 具有数据类型 fragment-reference，并选择了模型 Article。查询将fragments作为[Article]的数组传递

{
  bookmarkList {
    items {
        fragments {
          _path
          author
        }
     }
  }
}

多个引用模型类型

此查询查找：

类型为 bookmark 的多个内容片段
- 带有对特定模型类型 Article 和 Adventure 的其他片段的片段引用

NOTE

字段 fragments 具有数据类型 fragment-reference，并选择了模型 Article、Adventure。查询以 [AllFragmentModels] 数组形式传递 fragments，该数组通过联合类型解除引用。

{
  bookmarkList {
    items {
        fragments {
          ... on ArticleModel {
            _path
            author
          }
          ... on AdventureModel {
            _path
            adventureTitle
          }
        }
     }
  }
}

具有内容引用的特定模型的内容片段示例查询 sample-wknd-fragment-specific-model-content-reference

此查询有两种风格：

用于返回所有内容引用。
用于返回类型为 attachments 的特定内容引用。

这些查询查找：

类型为 bookmark 的多个内容片段
- 具有对其他片段的内容引用

具有预获取引用的多个内容片段的示例查询 sample-wknd-multiple-fragments-prefetched-references

以下查询通过使用 _references 返回所有内容引用：

{
  bookmarkList {
     _references {
         ... on ImageRef {
          _path
          type
          height
        }
        ... on MultimediaRef {
          _path
          type
          size
        }
        ... on DocumentRef {
          _path
          type
          author
        }
        ... on ArchiveRef {
          _path
          type
          format
        }
    }
    items {
        _path
    }
  }
}

具有附件的多个内容片段的示例查询 sample-wknd-multiple-fragments-attachments

以下查询返回所有 attachments – 类型为 content-reference 的特定字段（子组）：

NOTE

字段 attachments 具有数据类型 content-reference，并选择了多种格式。

{
  bookmarkList {
    items {
      attachments {
        ... on PageRef {
          _path
          type
        }
        ... on ImageRef {
          _path
          width
        }
        ... on MultimediaRef {
          _path
          size
        }
        ... on DocumentRef {
          _path
          author
        }
        ... on ArchiveRef {
          _path
          format
        }
      }
    }
  }
}

具有 RTE 内联引用的单个内容片段的示例查询 sample-wknd-single-fragment-rte-inline-reference

此查询查找：

特定路径下类型为 bookmark 的单个内容片段
- 在其中，具有 RTE 内联引用

NOTE

RTE 内联引用在 _references 中水合。

示例查询

{
  bookmarkByPath(_path: "/content/dam/wknd/en/bookmarks/skitouring") {
    item {
      _path
      description {
        json
      }
    }
    _references {
      ... on ArticleModel {
        _path
      }
      ... on AdventureModel {
        _path
      }
      ... on ImageRef {
        _path
      }
      ... on MultimediaRef {
        _path
      }
      ... on DocumentRef {
        _path
      }
      ... on ArchiveRef {
        _path
      }
    }
  }
}

给定模型的单个内容片段变体的示例查询 sample-wknd-single-fragment-given-model

此查询查找：

特定路径下类型为 author 的单个内容片段
- 在该片段中，与变体相关的数据：another

示例查询

{
  authorByPath(_path: "/content/dam/wknd-shared/en/contributors/ian-provo", variation: "another") {
    item {
        _path
        _variation
        firstName
        lastName
        birthDay
    }
  }
}

给定模型的多个内容片段的指定变体示例查询 sample-wknd-variation-multiple-fragment-given-model

此查询查找：

类型为 author 且具有以下特定变体的内容片段：another

NOTE

该查询会演示没有指定名称的变化的内容片段的回退。

示例查询

{
  authorList(variation: "another") {
    items {
        _path
        _variation
        firstName
        lastName
        birthDay
    }
  }
}

给定模型的多个内容片段及其变体的示例查询 sample-wknd-multiple-fragment-variations-given-model

此查询查找：

article 类型和所有变体的内容片段

示例查询

query {
  articleList(
    includeVariations: true  ){
    items {
      _variation
      _path
      _tags
      _metadata {
        stringArrayMetadata {
          name
          value
        }
      }
    }
  }
}

附加了特定标签的给定模型的内容片段变体的示例查询 sample-wknd-fragment-variations-given-model-specific-tag

此查询查找：

带有一个或多个标签为 WKND : Activity / Hiking 的变体的 article 类型的内容片段

示例查询

{
  articleList(
    includeVariations: true,
    filter: {_tags: {_expressions: [{value: "wknd:activity/hiking", _operator: CONTAINS}]}}
  ){
    items {
      _variation
      _path
      _tags
      _metadata {
        stringArrayMetadata {
          name
          value
        }
      }
    }
  }
}

给定区域设置的多个内容片段的示例查询 sample-wknd-multiple-fragments-given-locale

此查询查找：

fr 区域设置中类型为 article 的内容片段

示例查询

{
  articleList(_locale: "fr") {
    items {
      _path
      authorFragment {
        _path
        firstName
        lastName
        birthDay
      }
      main {
        html
        markdown
        plaintext
        json
      }
    }
  }
}

使用偏移和限制的示例列表查询 sample-list-offset-limit

此查询查找：

最多包含五篇文章的结果页面，从完整结果列表中的第五篇文章开始

示例查询

{
   articleList(offset: 5, limit: 5) {
    items {
      authorFragment {
        _path
        firstName
        lastName
        birthDay
      }
      _path
    }
  }
}

使用“先”和“后”的示例分页查询 sample-pagination-first-after

此查询查找：

包含最多五次冒险的结果页面，从完整结果列表中的给定光标项开始

示例查询

{
    adventurePaginated(first: 5, after: "ODg1MmMyMmEtZTAzMy00MTNjLThiMzMtZGQyMzY5ZTNjN2M1") {
        edges {
          cursor
          node {
            title
          }
        }
        pageInfo {
          endCursor
          hasNextPage
        }
    }
}

按 _tags ID 过滤并排除变体的示例查询 sample-filtering-tag-not-variations

此查询查找：

带有 big-block 标签的 vehicle 类型的内容片段
排除变体

示例查询

query {
  vehicleList(
    filter: {
    _tags: {
      _expressions: [
        {
          value: "vehicles:big-block"
          _operator: CONTAINS
        }
      ]
    }
  }) {
    items {
      _variation
      _path
      type
      name
      model
      fuel
      _tags
    }
  }
}

按 _tags ID 过滤并包含变体的示例查询 sample-filtering-tag-with-variations

此查询查找：

带有 big-block 标签的 vehicle 类型的内容片段
包含变体

示例查询

{
  enginePaginated(after: "SjkKNmVkODFmMGQtNTQyYy00NmQ4LTljMzktMjhlNzQwZTY1YWI2Cmo5", first: 9 ,includeVariations:true, sort: "name",
    filter: {
    _tags: {
      _expressions: [
        {
          value: "vehicles:big-block"
          _operator: CONTAINS
        }
      ]
    }
  }) {
    edges{
    node {
        _variation
        _path
        name
        type
        size
        _tags
        _metadata {
          stringArrayMetadata {
            name
            value
          }
        }
    }
      cursor
    }
  }
}

用于传递 DAM 和动态媒体资产的示例查询 sample-queries-delivery-DAM-DM

对于 Web 优化的图像传递（DAM 资产）：

用于将 URL 传送到 Dynamic Media 资产

示例内容片段结构（用于 GraphQL） content-fragment-structure-graphql

示例查询基于以下结构，该结构使用：

一个或多个示例内容片段模型 – 构成了 GraphQL 架构的基础
基于以上模型的示例内容片段

示例内容片段模型（架构） sample-content-fragment-models-schemas

对于相同的查询，使用以下内容模型及其相互关系（引用 ->）：

公司
-> 人员
-> 奖励
城市

公司 model-company

定义公司的基本字段包括：

字段名

数据类型

引用

公司名称

单行文本

CEO

片段引用（单个字段）

人员

员工

片段引用（多个字段）

人员

人员 model-person

这些字段定义人员，也可以是员工：

字段名

数据类型

引用

名称

单行文本

名字

单行文本

奖励

片段引用（多个字段）

奖励

奖励 model-award

定义奖励的字段包括：

字段名

数据类型

引用

简称/ID

单行文本

标题

单行文本

城市 model-city

定义城市的字段包括：

字段名

数据类型

引用

名称

单行文本

国家/地区

单行文本

人口

数字

类别

标记

示例内容片段 sample-content-fragments

以下片段用于相应的模型。

公司 fragment-company

公司名称

CEO

员工

Apple

Steve Jobs

Duke Marsh
Max Caulfield

Little Pony Inc.

Adam Smith

Lara Croft
Cutter Slade

NextStep Inc.

Steve Jobs

Joe Smith
Abe Lincoln

人员 fragment-person

姓名

名字

奖励

Lincoln

Abe

Smith

Adam

Slade

Cutter

Gameblitz
Gamestar

Marsh

Duke

Smith

Joe

Croft

Lara

Gamestar

Caulfield

Max

Gameblitz

Jobs

Steve

奖励 fragment-award

简称/ID

标题

Gameblitz

Gamestar

OSC

Oscar

城市 fragment-city

名称

国家/地区

人口

类别

巴塞尔

瑞士

172258

city:emea

柏林

德国

3669491

city:capital
city:emea

布加勒斯特

罗马尼亚

1821000

city:capital
city:emea

旧金山

美国

883306

city:beach
city:na

圣何塞

美国

102635

city:na

斯图加特

德国

634830

city:emea

苏黎世

瑞士

415367

city:capital
city:emea

recommendation-more-help

fbcff2a9-b6fe-4574-b04a-21e75df764ab

了解如何将 GraphQL 与 AEM 结合使用 – 示例内容和查询 learn-graphql-with-aem-sample-content-queries

GraphQL – 使用示例内容片段结构的示例查询 graphql-sample-queries-sample-content-fragment-structure

示例查询 – 所有可用架构和数据类型 sample-all-schemes-datatypes

示例查询 – 关于所有城市的所有信息 sample-all-information-all-cities

示例查询 – 所有城市的名称 sample-names-all-cities

示例查询 – 一个特定城市片段 sample-single-specific-city-fragment

示例查询 – 具有指定变体的所有城市 sample-cities-named-variation

示例查询 - 标记为“城市度假”的所有城市的名称 sample-names-all-cities-tagged-city-breaks

示例查询 – 公司的 CEO 和员工的完整详细信息 sample-full-details-company-ceos-employees

示例查询 – 所有名为“Jobs”或“Smith”的人 sample-all-persons-jobs-smith

示例查询 – 所有名字不是“Jobs”的人 sample-all-persons-not-jobs

示例查询 – 其 _path 以特定前缀开头的所有冒险 sample-wknd-all-adventures-cycling-path-filter

示例查询 – 位于德国或瑞士且人口在 400000 到 999999 之间的所有城市。 sample-all-cities-d-ch-population

示例查询 – 名称中包含 SAN 的所有城市，不考虑大小写 sample-all-cities-san-ignore-case

示例查询 – 筛选数组中必须至少出现一次的项 sample-array-item-occur-at-least-once

示例查询 – 根据精确的数组值筛选 sample-array-exact-value

嵌套内容片段的示例查询 – 至少有一位员工名为“Smith”的所有公司 sample-companies-employee-smith

嵌套内容片段的示例查询 – 所有员工赢得了“Gamestar”奖项的所有公司 sample-all-companies-employee-gamestar-award

元数据的示例查询 – 列出标题为 GB 的奖项的元数据 sample-metadata-awards-gb

使用 WKND 项目的示例查询 sample-queries-using-wknd-project

具有指定属性的特定模型的所有内容片段示例查询 sample-wknd-all-model-properties

元数据的示例查询 sample-wknd-metadata

给定模型的单个内容片段的示例查询 sample-wknd-single-content-fragment-of-given-model

来自模型的内容片段模型的示例查询 sample-wknd-content-fragment-model-from-model

嵌套内容片段的示例查询 – 单个模型类型 sample-wknd-nested-fragment-single-model

嵌套内容片段的示例查询 – 多个模型类型 sample-wknd-nested-fragment-multiple-model

单一引用模型类型

多个引用模型类型

具有内容引用的特定模型的内容片段示例查询 sample-wknd-fragment-specific-model-content-reference

具有预获取引用的多个内容片段的示例查询 sample-wknd-multiple-fragments-prefetched-references

具有附件的多个内容片段的示例查询 sample-wknd-multiple-fragments-attachments

具有 RTE 内联引用的单个内容片段的示例查询 sample-wknd-single-fragment-rte-inline-reference

给定模型的单个内容片段变体的示例查询 sample-wknd-single-fragment-given-model

给定模型的多个内容片段的指定变体示例查询 sample-wknd-variation-multiple-fragment-given-model

给定模型的多个内容片段及其变体的示例查询 sample-wknd-multiple-fragment-variations-given-model

附加了特定标签的给定模型的内容片段变体的示例查询 sample-wknd-fragment-variations-given-model-specific-tag

给定区域设置的多个内容片段的示例查询 sample-wknd-multiple-fragments-given-locale

使用偏移和限制的示例列表查询 sample-list-offset-limit

使用“先”和“后”的示例分页查询 sample-pagination-first-after

按 _tags ID 过滤并排除变体的示例查询 sample-filtering-tag-not-variations

按 _tags ID 过滤并包含变体的示例查询 sample-filtering-tag-with-variations

用于传递 DAM 和动态媒体资产的示例查询 sample-queries-delivery-DAM-DM

示例内容片段结构（用于 GraphQL） content-fragment-structure-graphql

示例内容片段模型（架构） sample-content-fragment-models-schemas

公司 model-company

人员 model-person

奖励 model-award

城市 model-city

示例内容片段 sample-content-fragments

公司 fragment-company

人员 fragment-person

奖励 fragment-award

城市 fragment-city

示例查询 – 其 `_path` 以特定前缀开头的所有冒险 sample-wknd-all-adventures-cycling-path-filter