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

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?

Agora que você criou alguns fragmentos de conteúdo, você pode usar AEM APIs para entregá-las sem periféricos.

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 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 era chamado person com campos firstName, lastNamee 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 o Ctrl-Enter A tecla de atalho e os resultados são exibidos como JSON no painel direito.
    Resultados GraphiQL

  6. Clique em:

    • Documentação na parte superior direita da página para mostrar a documentação contextual para ajudá-lo a criar suas consultas que se adaptam aos seus próprios modelos.

    • Histórico na barra de ferramentas superior para mostrar consultas anteriores.

      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.

Nesta página