Acessar e entregar fragmentos de conteúdo sem cabeçalho Guia de início rápido

Saiba como usar AEM API REST do Assets para gerenciar Fragmentos de conteúdo e a API GraphQL para entrega sem interface do conteúdo do Fragmento de conteúdo.

O que são APIs REST de GraphQL e Assets?

Depois de criar alguns fragmentos de conteúdo, você pode usar AEM APIs para entregá-los sem periféricos.

  • A API GraphQL permite criar solicitações para acessar e fornecer Fragmentos de conteúdo.
  • A API REST de ativos permite criar e modificar Fragmentos de conteúdo (e outros ativos).

O restante deste guia terá como foco o acesso GraphQL e a entrega do Fragmento de conteúdo.

Como entregar um fragmento de conteúdo usando GraphQL

Os arquitetos de informações precisarão projetar consultas para seus pontos de extremidade de canal para fornecer conteúdo. Geralmente, esses queries só precisarão ser considerados uma vez por endpoint por modelo. Para os fins deste guia de introdução, só será necessário criar um.

  1. Faça logon no AEM como um Cloud Service e acesse a interface GraphiQL:

    • Por exemplo: https://<host>:<port>/content/graphiql.html.
  2. O GraphiQL é um editor de consultas do navegador para GraphQL. Você pode usá-lo para criar consultas para recuperar Fragmentos de conteúdo para entregá-los com facilidade como JSON.

    • O painel esquerdo permite criar o query.

    • O painel direito exibe os resultados.

    • O Editor de consultas apresenta a conclusão de código e teclas de atalho para executar facilmente a consulta.

      Editor GraphiQL

  3. Supondo que o modelo que criamos foi chamado person com campos firstName, lastName e position, podemos criar uma consulta simples para recuperar o conteúdo do Fragmento de conteúdo.

    query 
    {
      personList {
        items {
          _path
          firstName
          lastName
          position
        }
      }
    }
    
  4. Insira o query no painel esquerdo.
    Consulta GraphiQL

  5. Clique no botão Executar Consulta ou use a tecla de atalho Ctrl-Enter e os resultados são exibidos como JSON no painel direito.
    Resultados GraphiQL

  6. Clique no link Docs no canto superior direito da página para mostrar a documentação de contexto para ajudá-lo a criar suas consultas que se adaptam aos seus próprios modelos.
    Documentação GraphiQL

O GraphQL permite consultas estruturadas que podem direcionar não apenas conjuntos de dados específicos ou objetos de dados individuais, mas também fornecer elementos específicos dos objetos, resultados aninhados, oferecer suporte para variáveis de consulta e muito mais.

O GraphQL pode evitar solicitações de API iterativas, bem como entrega excessiva e, em vez disso, permite a entrega em massa do que é necessário para renderização como resposta a uma única consulta de API. O JSON resultante pode ser usado para fornecer dados a outros sites ou aplicativos.

Próximas etapas

Pronto! Agora você tem uma compreensão básica do gerenciamento de conteúdo sem periféricos no AEM. É claro que há muito mais recursos onde você pode aprofundar um entendimento abrangente dos recursos disponíveis.

  • Navegador de configuração - Para obter detalhes sobre o Navegador de configuração de AEM
  • Fragmentos de conteúdo - Para obter detalhes sobre a criação e o gerenciamento dos Fragmentos de conteúdo
  • Suporte a fragmentos de conteúdo na API HTTP do AEM Assets - Para obter detalhes sobre como acessar AEM conteúdo diretamente sobre a API HTTP, por meio de operações CRUD (Criar, Ler, Atualizar, Excluir)
  • API GraphQL - Para obter detalhes sobre como fornecer fragmentos de conteúdo sem interrupções

Nesta página