Entrega de conteúdo headless usando fragmentos de conteúdo com GraphQL headless-content-delivery-using-content-fragments-with-graphQL
Com os fragmentos de conteúdo e a API GraphQL, é possível usar o Adobe Experience Manager (AEM) as a Cloud Service como um sistema de gerenciamento de conteúdo (CMS) headless.
Isso é feito usando fragmentos de conteúdo em conjunto com a API GraphQL do AEM (uma implementação personalizada, com base no GraphQL padrão), para fornecer conteúdo estruturado para uso em seus aplicativos de forma headless. A capacidade de personalizar uma única consulta de API permite recuperar e fornecer o conteúdo específico que você deseja/precisa renderizar (como resposta à consulta de API única).
-
O que é Headless? para obter uma introdução a conceitos e terminologia sobre headless.
-
Headless e AEM para obter uma introdução ao desenvolvimento headless no AEM Sites as a Cloud Service.
CMS headless headless-cms
Um sistema de gerenciamento de conteúdo (CMS) headless é um sistema exclusivamente back-end criado desde o início como um repositório de conteúdo e que torna o conteúdo acessível por meio de uma API para exibição em qualquer dispositivo.
Em termos de criação de fragmentos de conteúdo no AEM, isso significa que:
-
É possível usar fragmentos de conteúdo para criar um conteúdo que não é inicialmente destinado a ser publicado diretamente (1:1) em páginas formatadas.
-
O conteúdo dos fragmentos de conteúdo é estruturado de maneira predeterminada, de acordo com os Modelos de fragmento de conteúdo. Isso simplifica o acesso para os seus aplicativos, que processarão ainda mais seu conteúdo.
GraphQL - Uma visão geral graphql-overview
O GraphQL é:
-
“…um idioma de consulta para APIs e um tempo de execução para realizar essas consultas com seus dados existentes.”.
Consulte GraphQL.org
A API GraphQL do AEM permite executar consultas (complexas) nos seus Fragmentos de conteúdo; com cada consulta sendo de acordo com um tipo de modelo específico. O conteúdo retornado pode ser usado pelos seus aplicativos.
API GraphQL do AEM aem-graphql-api
Para o Adobe Experience as a Cloud Experience, uma implementação personalizada da API GraphQL padrão foi desenvolvida. Consulte API GraphQL do AEM para uso com fragmentos de conteúdo para obter detalhes.
A implementação da API GraphQL do AEM é baseada nas bibliotecas GraphQL do Java.
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 o GraphQL em consultas do AEM, pois:
- Permitem projetar, criar, preparar e publicar conteúdo independente de páginas.
- Os Modelos de fragmentos do conteúdo fornecem a estrutura necessária por meio de tipos de dados definidos.
- A referência do fragmento, disponível ao definir um modelo, pode ser usada para definir camadas adicionais de estrutura.
Fragmentos de conteúdo content-fragments
Fragmentos de conteúdo:
-
Contêm conteúdo estruturado.
-
Baseiam-se em um Modelo de fragmento de conteúdo, que predefine a estrutura do fragmento resultante.
Modelos de fragmentos do conteúdo content-fragments-models
Esses Modelos de fragmento de conteúdo:
-
São usados para gerar os Esquemas, uma vez Ativados.
-
Fornecem os tipos de dados e campos necessários para o GraphQL. Garantem que seu aplicativo solicite apenas o que é possível e receba o que é esperado.
-
O tipo de dados Referências de fragmento pode ser usado no modelo para fazer referência a outro fragmento de conteúdo e, assim, introduzir níveis adicionais de estrutura.
Referências do fragmento fragment-references
-
É particularmente interessante em conjunto com o GraphQL.
-
É um tipo de dados específico que pode ser usado ao definir um Modelo de fragmento de conteúdo.
-
Faz referência a outro fragmento, dependente de um Modelo de fragmento de conteúdo específico.
-
Permite recuperar dados estruturados.
- Quando definido como multifeed, vários fragmentos secundários podem ser referenciados (recuperados) pelo fragmento principal.
Visualização JSON json-preview
Para ajudar a projetar e desenvolver os Modelos de fragmentos de conteúdo, você pode visualizar a saída JSON.
Saiba como usar o GraphQL com o AEM - Exemplos de conteúdo e consultas learn-graphql-with-aem-sample-content-queries
Consulte Saiba como usar o GraphQL com o AEM - Exemplos de conteúdo e consultas para obter uma introdução sobre o uso da API GraphQL do AEM.
Tutorial - Introdução ao AEM Headless e GraphQL
Procurando um tutorial prático? Veja o tutorial completo de Introdução ao AEM Headless e GraphQL que ilustra como criar e expor conteúdo usando as APIs GraphQL do AEM e consumi-lo por meio de um aplicativo externo, em um cenário de CMS headless.