Formación para utilizar GraphQL con AEM: contenido y consultas de muestra

Aprenda a utilizar GraphQL AEM con el para ofrecer contenido sin encabezado explorando contenido y consultas de muestra.

Para empezar a usar las consultas de GraphQL AEM y ver cómo funcionan con fragmentos de contenido de la aplicación, ayuda ver algunos ejemplos prácticos.

Para ayudarle con esto, consulte lo siguiente:

GraphQL: consultas de muestra con la estructura de fragmentos de contenido de muestra

Vea estas consultas de muestra para ver de forma ilustrada la creación de consultas, junto con resultados de muestra.

NOTA

Según la instancia, puede acceder directamente a AEM Interfaz de GraphiQL incluida con la API de GraphQL de para enviar y probar consultas.

Por ejemplo: http://localhost:4502/content/graphiql.html

NOTA

Consulta de muestra: todos los esquemas y tipos de datos disponibles

Esta consulta de ejemplo devuelve todos los types para todos los esquemas disponibles.

Consulta de muestra

{
  __schema {
    types {
      name
      description
    }
  }
}

Resultado de muestra

{
  "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"
        }
      ]
    }
  }
}

Consulta de muestra: toda la información acerca de todas las ciudades

Para recuperar toda la información acerca de todas las ciudades, puede utilizar la consulta básica:
Consulta de muestra

{
  cityList {
    items
  }
}

Cuando se ejecuta, el sistema expande automáticamente la consulta para incluir todos los campos:

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

Resultados de muestra

{
  "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
        }
      ]
    }
  }
}

Consulta de muestra: nombres de todas las ciudades

Esta consulta de ejemplo es una consulta directa para devolver el namede todas las entradas de la cityesquema.

Consulta de muestra

query {
  cityList {
    items {
      name
    }
  }
}

Resultados de muestra

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

Consulta de muestra: un solo fragmento de ciudad específico

Esta consulta de ejemplo es una consulta para devolver los detalles de una sola entrada de fragmento en una ubicación específica del repositorio.

Consulta de muestra

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

Resultados de muestra

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

Consulta de muestra: todas las ciudades con una variación con nombre

Si crea una variación denominada "Centro de Berlín" (berlin_centre), para el city Berlín, puede utilizar una consulta para devolver detalles de la variación.

Consulta de muestra

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

Resultados de muestra

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

Consulta de muestra: nombres de todas las ciudades Etiquetado como City Breaks

Si:

  • crear varias etiquetas, con el nombre Tourism : Business, City Break, Holiday
  • y asignar estas etiquetas a la variación Principal de varios City instances

A continuación, puede utilizar una consulta para devolver detalles de la name y tagsde todas las entradas etiquetadas como City Breaks en la cityesquema.

Consulta de muestra

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

Resultados de muestra

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

Consulta de muestra: detalles completos del CEO y los empleados de una compañía

Utilizando la estructura de los fragmentos anidados, esta consulta devuelve todos los detalles del CEO de una compañía y de todos sus empleados.

Consulta de muestra

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

Resultados de muestra

{
  "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": []
            }
          ]
        }
      ]
    }
  }
}

Consulta de muestra: todas las personas que tienen el apellido “Jobs” o “Smith”

Esta consulta de muestra filtra todo persons para cualquier que tenga el nombre Jobso Smith.

Consulta de muestra

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

Resultados de muestra

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

Consulta de muestra: todas las personas que no tienen el apellido “Jobs”

Esta consulta de muestra filtra todo persons para cualquier que tenga el nombre Jobso Smith.

Consulta de muestra

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

Resultados de muestra

{
  "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"
        }
      ]
    }
  }
}

Consulta de muestra: todas las aventuras cuya _path comienza con un prefijo específico

Todas las adventures en que la _path comienza con un prefijo específico (/content/dam/wknd/en/adventures/cycling).

Consulta de muestra

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

Resultados de muestra

{
  "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"
        }
      ]
    }
  }
}

Consulta de muestra: todas las ciudades de Alemania o Suiza con una población de 400000 a 999999

Aquí se filtra una combinación de campos. Un AND (implícito) se utiliza para seleccionar el rango de population, mientras que un OR (explícito) se utiliza para seleccionar las ciudades requeridas.

Consulta de muestra

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
    }
  }
}

Resultados de muestra

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

Consulta de muestra: todas las ciudades con SAN en el nombre, sin importar las mayúsculas

Esta consulta busca todas las ciudades que tienen SAN en el nombre, sin importar las mayúsculas.

Consulta de muestra

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

Resultados de muestra

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

Consulta de muestra: filtro en una matriz con un elemento que deba producirse al menos una vez

Esta consulta filtra una matriz con un elemento (city:na) que debe producirse al menos una vez.

Consulta de muestra

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

Resultados de muestra

{
  "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"
          ]
        }
      ]
    }
  }
}

Consulta de muestra: filtro de un valor de matriz exacto

Esta consulta filtra un valor de matriz exacto.

Consulta de muestra

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

Resultados de muestra

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

Consulta de muestra para fragmentos de contenido anidados: todas las compañías que tienen al menos un empleado con el apellido “Smith”

Esta consulta ilustra el filtrado para cualquier person de name “Smith”, que devuelve información de entre dos fragmentos anidados: company y employee.

Consulta de muestra

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

Resultados de muestra

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

Consulta de muestra para fragmentos de contenido anidados: todas las compañías en las que todos los empleados han ganado el premio “Gamestar”

Esta consulta ilustra el filtrado entre tres fragmentos anidados: company, employee y award.

Consulta de muestra

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
        }
      }
    }
  }
}

Resultados de muestra

{
  "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"
                }
              ]
            }
          ]
        }
      ]
    }
  }
}

Consulta de muestra para metadatos: enumera los metadatos de los premios titulados GB

Esta consulta ilustra el filtrado entre tres fragmentos anidados: company, employee y award.

Consulta de muestra

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

Resultados de muestra

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

Consultas de muestra con el proyecto WKND

Estas consultas de muestra se basan en el proyecto WKND. Tiene lo siguiente:

  • Modelos de fragmentos de contenido disponibles en:
    http://<hostname>:<port>/libs/dam/cfm/models/console/content/models.html/conf/wknd

  • Fragmentos de contenido (y otro contenido) disponibles en:
    http://<hostname>:<port>/assets.html/content/dam/wknd/en

NOTA

Como los resultados pueden ser extensos, no se reproducen aquí.

Consulta de muestra para todos los fragmentos de contenido de un determinado modelo con las propiedades especificadas

Esta consulta de muestra busca lo siguiente:

  • para todos los fragmentos de contenido del tipo article
  • con las propiedades path y author.

Consulta de muestra

{
  articleList {
    items {
      _path
      author
    }
  }
}

Consulta de muestra para metadatos

Esta consulta busca lo siguiente:

  • para todos los fragmentos de contenido del tipo adventure
  • metadatos

Consulta de muestra

{
  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
        }
      }
    }
  }
}

Consulta de muestra para un solo fragmento de contenido de un modelo determinado

Esta consulta de muestra busca lo siguiente:

  • para un solo fragmento de contenido de tipo article en una ruta específica
    • dentro de esa ruta, todos los formatos de contenido:
      • HTML
      • Markdown
      • Texto sin formato
      • JSON

Consulta de muestra

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

Consulta de muestra para un modelo de fragmento de contenido de un modelo

Esta consulta de muestra busca lo siguiente:

  • para un solo fragmento de contenido
    • detalles del modelo de fragmento de contenido subyacente

Consulta de muestra

{
  adventureByPath(_path: "/content/dam/wknd/en/adventures/riverside-camping-australia/riverside-camping-australia") {
    item {
      _path
      adventureTitle
      _model {
        _path
        title
      }
    }
  }
}

Consulta de muestra para un fragmento de contenido anidado: tipo de modelo único

Esta consulta busca lo siguiente:

  • para un solo fragmento de contenido de tipo article en una ruta específica
    • dentro de esa ruta, la ruta y el autor del fragmento al que se hace referencia (anidado)
NOTA

El campo referencearticle tiene el tipo de datos fragment-reference.

Consulta de muestra

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

Consulta de muestra para un fragmento de contenido anidado: tipo de modelo múltiple

Tipo de modelo referenciado único

Esta consulta busca lo siguiente:

  • para varios fragmentos de contenido de tipo bookmark
    • con referencias de fragmento a otros fragmentos del tipo de modelo específico Article
NOTA

El campo fragments tiene el tipo de datos fragment-reference, con el modelo Article seleccionados. La consulta ofrece fragments como una matriz de [Article].

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

Varios tipos de modelos referenciados

Esta consulta busca lo siguiente:

  • para varios fragmentos de contenido de tipo bookmark
    • con referencias de fragmento a otros fragmentos de tipos de modelo específicos Article y Adventure
NOTA

El campo fragments tiene el tipo de datos fragment-reference, con los modelos Article y Adventure seleccionados. La consulta ofrece fragments como una matriz de [AllFragmentModels], a la que se hace referencia con el tipo de unión.

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

Consulta de muestra para un fragmento de contenido de un modelo específico con referencias de contenido

Hay dos tipos de consulta:

  1. Para devolver todas las referencias de contenido.
  2. Para devolver referencias de contenido específicas del tipo attachments.

Estas consultas buscan:

  • para varios fragmentos de contenido de tipo bookmark
    • con referencias de contenido a otros fragmentos

Consulta de muestra para varios fragmentos de contenido con referencias recuperadas previamente

La siguiente consulta devuelve todas las referencias de contenido utilizando _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
    }
  }
}

Consulta de muestra para varios fragmentos de contenido con archivos adjuntos

La siguiente consulta devuelve todos los attachments - un campo específico (subgrupo) del tipo content-reference:

NOTA

El campo attachments tiene el tipo de datos content-reference, con varios formularios seleccionados.

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

Consulta de muestra para un solo fragmento de contenido con referencia en línea RTE

Esta consulta busca lo siguiente:

  • para un solo fragmento de contenido de tipo bookmark en una ruta específica
    • dentro de él, referencias en línea RTE
NOTA

Las referencias en línea RTE se hidratan en _references.

Consulta de muestra

{
  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
      }
    }
  }
}

Consulta de muestra para una única variación de fragmento de contenido de un modelo determinado

Esta consulta busca lo siguiente:

  • para un solo fragmento de contenido de tipo article en una ruta específica
    • dentro de esa ruta, los datos relacionados con la variación: variation1

Consulta de muestra

{
  articleByPath (_path: "/content/dam/wknd/en/magazine/alaska-adventure/alaskan-adventures", variation: "variation1") {
    item {
      _path
      author
      main {
        html
        markdown
        plaintext
        json
      }
    }
  }
}

Consulta de muestra para una variación con nombre de varios fragmentos de contenido de un modelo determinado

Esta consulta busca lo siguiente:

  • para fragmentos de contenido de tipo article con una variación específica: variation1

Consulta de muestra

{
  articleList (variation: "variation1") {
    items {
      _path
      author
      main {
        html
        markdown
        plaintext
        json
      }
    }
  }
}

Consulta de muestra para varios fragmentos de contenido y sus variaciones de un modelo determinado

Esta consulta busca lo siguiente:

  • para fragmentos de contenido de tipo article y todas las variaciones

Consulta de muestra

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

Consulta de muestra para variaciones de fragmentos de contenido de un modelo determinado que tienen una etiqueta específica adjunta

Esta consulta busca lo siguiente:

  • para fragmentos de contenido de tipo article con una o más variaciones que tienen la etiqueta WKND : Activity / Hiking

Consulta de muestra

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

Consulta de muestra para varios fragmentos de contenido de una configuración regional determinada

Esta consulta busca lo siguiente:

  • para fragmentos de contenido de tipo article dentro de la configuración regional fr

Consulta de muestra

{
  articleList (_locale: "fr") {
    items {
      _path
      author
      main {
        html
        markdown
        plaintext
        json
      }
    }
  }
}

La estructura del fragmento de contenido de muestra (utilizada con GraphQL)

Las consultas de muestra se basan en la siguiente estructura, que utiliza:

Modelos de fragmentos de contenido de muestra (esquemas)

Para las consultas de muestra, utilice los siguientes modelos de contenido y sus interrelaciones (referencias ->):

Compañía

Los campos básicos que definen a la compañía son los siguientes:

Nombre del campo Tipo de datos Referencia
Nombre de la compañía Texto de una sola línea
CEO Referencia de fragmento (único) Persona
Empleados Referencia de fragmento (multicampo) Persona

Persona

Los campos que definen a una persona, que también puede ser un empleado:

Nombre del campo Tipo de datos Referencia
Nombre Texto de una sola línea
Nombre Texto de una sola línea
Premios Referencia de fragmento (multicampo) Premio

Premio

Los campos que definen un premio son los siguientes:

Nombre del campo Tipo de datos Referencia
Método abreviado/ID Texto de una sola línea
Título Texto de una sola línea

Ciudad

Los campos para definir una ciudad son los siguientes:

Nombre del campo Tipo de datos Referencia
Nombre Texto de una sola línea
País Texto de una sola línea
Población Número
Categorías Etiquetas

Fragmentos de contenido de muestra

Los siguientes fragmentos se utilizan para el modelo adecuado.

Compañía

Nombre de la compañía CEO Empleados
Apple Steve Jobs Duke Marsh
Max Caulfield
Little Pony Inc. Adam Smith Lara Croft
Cutter Slade
NextStep Inc. Steve Jobs Joe Smith
Abe Lincoln

Persona

Nombre Nombre Premios
Lincoln Abe
Smith Adam
Enclavado Cutter Gameblitz
Gamestar
Marsh Duke
Smith Joe
Croft Lara Gamestar
Caulfield Max Gameblitz
Jobs Steve

Premio

Método abreviado/ID Título
GB Gameblitz
GS Gamestar
OSC Oscar

Ciudad

Nombre País Población Categorías
Basilea Suiza 172258 city:emea
Berlín Alemania 3669491 city:capital
city:emea
Bucarest Rumanía 1821000 city:capital
city:emea
San Francisco EE. UU. 883306 city:beach
city:na
San José EE. UU. 102635 city:na
Stuttgart Alemania 634830 city:emea
Zúrich Suiza 415367 city:capital
city:emea

En esta página