Capítulo 4 - Definição dos modelos do Content Services
O Capítulo 4 do tutorial AEM Headless aborda o papel dos modelos editáveis AEM no contexto dos serviços de conteúdo AEM. Modelos editáveis são usados para definir a estrutura de conteúdo JSON que o AEM Content Services expõe aos clientes por meio da composição de componentes AEM habilitados para o Content Services.
Compreender a função dos modelos nos serviços de conteúdo AEM
Modelos editáveis AEM são usados para definir os pontos de extremidade HTTP que são acessados para expor o conteúdo do Evento como JSON.
Tradicionalmente, os modelos editáveis com AEM são usados para definir páginas da Web, no entanto, esse uso é simplesmente convencional. Modelos editáveis podem ser usados para compor qualquer conjunto de conteúdo; como esse conteúdo é acessado: como um HTML em um navegador, como JSON consumido pelo JavaScript (editor de SPA do AEM) ou um aplicativo móvel é uma função de como essa página é solicitada.
No AEM Content Services, os modelos editáveis são usados para definir como os dados JSON são expostos.
Para o WKND Mobile Criaremos um único Modelo editável usado para direcionar um único endpoint de API. Embora este exemplo seja simples de ilustrar os conceitos de AEM Headless, você pode criar várias páginas (ou pontos de extremidade), cada uma expondo diferentes conjuntos de conteúdo para criar uma API mais complexa e mais bem organizada.
Noções básicas sobre o endpoint da API
Para entender como compor nosso endpoint de API e entender qual conteúdo deve ser exposto ao nosso WKND Mobile App, vamos rever o design.
Como podemos ver, temos três conjuntos lógicos de conteúdo para fornecer ao aplicativo móvel.
- A variável Logotipo
- A variável Linha de tag
- A lista de Eventos
Para fazer isso, podemos mapear esses requisitos para componentes AEM (e, no nosso caso, AEM WCM Componentes principais) para expor o conteúdo necessário como JSON.
- A variável Logotipo é revelado através de um Componente de imagem
- A variável Linha de tag é revelado através de um Componente de texto
- A lista de Eventos é revelado através de um Componente da lista de fragmentos do conteúdo que, por sua vez, faz referência a um conjunto de Fragmentos de conteúdo do evento.
Definição do modelo de API de eventos
-
Navegue até Ferramentas > Geral > Modelos >WKND Mobile.
-
Crie o Events API modelo:
- Toque Criar na barra de ação superior
- Selecione o WKND Mobile - Empty Page modelo
- Toque Próxima na barra de ação superior
- Enter Events API no Título do modelo campo
- Toque Criar na barra de ação superior
- Toque Abertura abrir o novo modelo para edição
-
Primeiro, permitimos os três componentes do AEM identificados de que precisamos para modelar o conteúdo editando o Política da Raiz Contêiner de layout. Assegure a Estrutura estiver ativo, selecione a variável Layout Container [Root] e toque no Política botão.
-
Em Propriedades > Componentes permitidos pesquisar WKND Mobile. Permitir os seguintes componentes do WKND Mobile grupo de componentes para que possam ser usados no Events API.
-
WKND Mobile > Image
- O logotipo do aplicativo
-
WKND Mobile > Text
- O texto de introdução do aplicativo
-
WKND Mobile > Content Fragment List
- A lista de categorias de Evento disponíveis para exibição no aplicativo
-
-
Toque no Concluído marca de seleção no canto superior direito ao concluir.
-
Atualizar a janela do navegador para ver as novas Componentes permitidos no painel esquerdo.
-
No localizador Componentes no painel à esquerda, arraste os seguintes Componentes AEM:
- Image para o logotipo
- Text para a linha da tag
- Content Fragment List para os eventos
-
Para cada um dos componentes acima, selecione-os e pressione a tecla desbloquear botão.
-
No entanto, assegurar a contêiner de layout é bloqueado para impedir que outros componentes sejam adicionados ou que esses três componentes sejam removidos.
-
Toque Informações da página > Exibir no Administrador para retornar ao WKND Mobile listagem de modelos. Selecione o recém-criado Events API modelo e toque em Ativar na barra de ação superior.
Próximas etapas
Como opção, instale o com.adobe.aem.guides.wknd-mobile.content.chapter-4.zip pacote de conteúdo no AEM Author via Gerenciador de pacotes AEM. Este pacote contém as configurações e o conteúdo descritos neste e nos capítulos anteriores do tutorial.