Como acessar seu conteúdo por meio das APIs de entrega do AEM access-your-content

Nesta parte da Jornada do desenvolvedor headless do AEM, você pode aprender a usar consultas GraphQL para acessar o conteúdo dos Fragmentos de conteúdo e alimentá-lo em seu aplicativo (entrega headless).

A história até agora story-so-far

No documento anterior da jornada headless do AEM, Como modelar seu conteúdo, você aprendeu as noções básicas da modelagem de conteúdo no AEM, então agora você deve entender como modelar a estrutura de conteúdo e, em seguida, colocar essa estrutura em prática usando Modelos de fragmento de conteúdo e Fragmentos de conteúdo do AEM:

Este artigo se baseia nesses fundamentos para que você entenda como acessar o conteúdo headless existente no AEM usando a API GraphQL do AEM.

Gostaria de acessar seu conteúdo? so-youd-like-to-access-your-content

Todo esse conteúdo perfeitamente estruturado (em Fragmentos de conteúdo) está disponível para alimentar seu novo aplicativo. A questão é: como fazer isso?

O que você precisa é de uma maneira de direcionar conteúdo específico, selecionar o que precisa e retorná-lo ao seu aplicativo para processamento adicional.

Com o Adobe Experience Manager (AEM), você pode acessar seletivamente os fragmentos de conteúdo, usando a API do GraphQL AEM, para retornar somente o conteúdo necessário. Isso significa que você pode realizar a entrega headless de conteúdo estruturado para uso em seus aplicativos.

GraphQL: uma Introdução graphql-introduction

GraphQL é uma especificação de código aberto que fornece:

GraphQL é uma API fortemente definida. Isso significa que todo o conteúdo deve ser claramente estruturado e organizado por tipo, para que a GraphQL entenda o que acessar e como. Os campos de dados são definidos nos esquemas GraphQL, que definem a estrutura dos objetos de conteúdo.

Os pontos de acesso da GraphQL fornecem os caminhos que respondem às consultas GraphQL.

Tudo isso significa que seu aplicativo pode selecionar com precisão, confiabilidade e eficiência o conteúdo de que precisa. Exatamente o que você precisa quando usado com o AEM.

API GraphQL do AEM aem-graphql-api

A API GraphQL do AEM é uma versão personalizada com base na especificação padrão da API GraphQL, especialmente configurada para permitir que você execute consultas (complexas) nos Fragmentos de conteúdo.

Fragmentos de conteúdo são usados, pois o conteúdo é estruturado de acordo com Modelos de fragmento de conteúdo. Isso atende a um requisito básico da GraphQL.

Para acessar a GraphQL para o AEM (e o conteúdo), um ponto de acesso é usado para fornecer o caminho de acesso.

O conteúdo retornado, por meio da API GraphQL do AEM, pode ser usado pelos seus aplicativos.

Para ajudá-lo a inserir diretamente e testar consultas, uma implementação da interface GraphiQL padrão também está disponível para uso com a GraphQL do AEM (isso pode ser instalado com o AEM). Isso fornece recursos como realce de sintaxe, preenchimento automático e sugestão automática, juntamente com um histórico e uma documentação online.

Fragmentos de conteúdo para uso com a API GraphQL do AEM content-fragments-use-with-aem-graphql-api

Os fragmentos de conteúdo podem ser usados como base para esquemas e consultas GraphQL do AEM, como:

Modelos de fragmentos de conteúdo content-fragments-models

Esses modelos de fragmentos de conteúdo:

Referências do fragmento fragment-references

A Referência do fragmento:

Visualização JSON json-preview

Para ajudar na criação e desenvolvimento dos modelos de fragmentos de conteúdo, é possível visualizar a saída JSON no editor de fragmento de conteúdo.

Usar de fato a API GraphQL do AEM actually-using-aem-graphiql

Configuração inicial initial-setup

Antes de começar com as consultas de conteúdo, você precisa:

Estrutura de amostra sample-structure

Para usar de fato a API GraphQL do AEM em uma consulta, podemos usar duas estruturas muito básicas de modelo de fragmentos de conteúdo:

Como você pode ver, os campos CEO e Funcionários fazem referência aos fragmentos de Pessoa.

Os modelos de fragmento são usados:

Onde testar suas consultas where-to-test-your-queries

As consultas podem ser inseridas na Interface GraphiQL, por exemplo, em:

Introdução às consultas getting-Started-with-queries

Uma consulta bastante simples é retornar o nome de todas as entradas no esquema Empresa. Aqui você solicita uma lista de todos os nomes de empresas:

query {
  companyList {
    items {
      name
    }
  }
}

Uma consulta um pouco mais complexa é selecionar todas as pessoas que não têm o nome “Jobs”. Isso filtrará todas as pessoas, mantendo apenas as que não tenham o nome Jobs. Isso é feito com o operador EQUALS_NOT (há muitos outros):

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

Você também pode criar consultas mais complexas. Por exemplo: consultar todas as empresas que tenham pelo menos um funcionário com o nome de “Smith”. Esta consulta ilustra a filtragem de pessoas com o nome “Smith”, retornando informações dos fragmentos aninhados:

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

Para obter os detalhes completos sobre o uso da API GraphQL do AEM, juntamente com a configuração dos elementos necessários, consulte:

O que vem a seguir whats-next

Agora que já sabe acessar e consultar seu conteúdo headless usando a API GraphQL do AEM, você pode aprender como usar a API REST para acessar e atualizar o conteúdo dos fragmentos de conteúdo.

Recursos adicionais additional-resources