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

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

Para empezar a utilizar las consultas de GraphQL y ver cómo funcionan con fragmentos de contenido de AEM, 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 la interfaz de GraphiQL incluida con la API de GraphQL de AEM para enviar y probar consultas.

Puede acceder al editor de consultas desde:

  • Herramientas -> General -> Editor de consultas de GraphQL
  • directamente; por ejemplo, http://localhost:4502/aem/graphiql.html
NOTA

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

Esto devolverá 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 muy 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 es una consulta directa para devolver el name de todas las entradas del esquema city.

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 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 nueva variación, denominada “Centro de Berlín” (berlin_centre), para el city de 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: 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”

Esto filtrará todas las persons al buscar cualquiera que tenga el apellido Jobs o 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”

Esto filtrará todas las persons al buscar cualquiera que tenga el apellido Jobs o 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 situadas en Alemania o Suiza con una población entre 400 000 y 999 999

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. Esto tiene:

  • 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

    http://<hostname>:<port>/assets.html/content/dam/wknd-shared/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 _path y propiedades de authorFragment.

Consulta de muestra

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

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 él, todos los formatos de contenido:
      • HTML
      • Markdown
      • Texto sin formato
      • JSON

Consulta de muestra

{
  articleByPath(_path: "/content/dam/wknd-shared/en/magazine/alaska-adventure/alaskan-adventures") {
    item {
        _path
        authorFragment {
          _path
          firstName
          lastName
          birthDay
        }
        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-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 único

Esta consulta busca lo siguiente:

  • para un solo fragmento de contenido de tipo article en una ruta específica
    • dentro de él, 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 al que se hace referencia única

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
NOTA

El campo fragments tiene el Tipo de datos fragment-reference, con el modelo Article seleccionado. Entregas de consultas fragments como una matriz de [Article].

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

Varios tipos de modelo a los que se hace referencia

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. Entregas de consultas 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 author en una ruta específica
    • dentro de él, los datos relacionados con la variación: another

Consulta de muestra

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

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 author con una variación específica: another
NOTA

Esto demostrará la alternativa para los fragmentos de contenido que no tienen una variación del nombre especificado.

Consulta de muestra

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

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
      authorFragment {
        _path
        firstName
        lastName
        birthDay
      }
      main {
        html
        markdown
        plaintext
        json
      }
    }
  }
}

Ejemplo de consulta de lista con desplazamiento y límite

Esta consulta busca lo siguiente:

  • para la página de resultados que contienen hasta cinco artículos, a partir del quinto artículo de la lista de resultados completa

Consulta de muestra

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

Ejemplo de consulta de paginación que utiliza primero y después

Esta consulta busca lo siguiente:

  • para la página de resultados que contiene hasta cinco aventuras, empezando por el elemento de cursor dado en la lista de resultados completa:

Consulta de muestra

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

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, utilizaremos 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 línea única
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 línea única
Nombre Texto de línea única
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 línea única
Título Texto de línea única

Ciudad

Los campos para definir una ciudad son los siguientes:

Nombre del campo Tipo de datos Referencia
Nombre Texto de línea única
País Texto de línea única
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
Trabajos 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