Capítulo 5 - Criação de páginas dos serviços de conteúdo
O capítulo 5 do tutorial sem periféricos do AEM aborda a criação da página a partir dos modelos definidos no Capítulo 4. A página criada neste capítulo atuará como o ponto de extremidade HTTP JSON para o aplicativo móvel.
/content/wknd-mobile/en/api foi pré-criada. As páginas base de en e api atendem a uma finalidade arquitetônica e organizacional, mas não são estritamente necessárias. Se o conteúdo da API puder ser localizado, é prática recomendada seguir as práticas recomendadas habituais da organização de Cópia de idioma e Página de vários sites, já que a página da API pode ser localizada como qualquer uma das páginas do AEM Sites.Criando a página API de evento
-
Navegue até AEM > Sites > WKND Mobile > English >API.
-
Toque no rótulo da página API e toque no botão Criar na barra de ações superior e crie uma nova página API de Eventos na página API.
- Toque em Criar na barra de ação superior
- Selecionar modelo de API de Eventos
- No campo Nome, digite eventos
- No campo Título, digite API de Eventos
- Toque em Criar na barra de ações superior para criar a página
- Toque em Concluído para retornar ao administrador do AEM Sites
Criação da página da API de eventos
-
Edite a página API de Eventos navegando até AEM > Sites > WKND Mobile > Inglês > API, selecionando a página API de Eventos e tocando em Editar na barra de ação superior.
-
Adicione uma imagem de logotipo para exibir no aplicativo, arrastando-a e soltando-a do Localizador de ativos no espaço reservado do componente Imagem.
- Use o logotipo fornecido em
/content/dam/wknd-mobile/images/wknd-logo.png.
- Use o logotipo fornecido em
-
Adicione a linha da marca para exibição acima dos eventos.
- Editar o componente Texto
- Insira o texto:
The WKND is here.
-
Selecione os eventos a serem exibidos:
-
Defina a seguinte configuração na guia Propriedades:
- Modelo: Evento
- Caminho pai: /content/dam/wknd-mobile/en/events
- Marcas: <Deixe em branco>
-
Defina a seguinte configuração na guia Elementos:
- Remova todos os elementos listados, para garantir que TODOS os elementos dos Fragmentos de conteúdo do evento sejam expostos.
-
Revise a saída JSON da página da API
A saída JSON e seu formato podem ser revisados ao solicitar a Página com o seletor .model.json.
Essa estrutura JSON (ou esquema) deve ser bem compreendida pelos consumidores dessa API. É essencial que os consumidores de API entendam quais aspectos da estrutura são fixos (ou seja, o Logotipo da API de evento (Imagem) e a Tag ativa (Texto), que são fluidos (ou seja, os eventos listados em Componente de lista do fragmento de conteúdo).
Romper este contrato em uma API publicada pode resultar em comportamento incorreto no consumo de aplicativos.
-
Em novas guias do navegador, solicite as páginas da API de Eventos usando o seletor
.model.json, que chama o Exportador JSON do AEM Content Services, e serializa a Página e os Componentes em uma estrutura JSON normalizada e bem definida.A estrutura JSON produzida por essas páginas é a estrutura que os aplicativos que consomem devem se alinhar.
-
Solicite a página API de Eventos como JSON.
O resultado deve ser semelhante a:
.tidy:Próxima etapa
Opcionalmente, instale o pacote de conteúdo do com.adobe.aem.guides.wknd-mobile.content.chapter-5.zip no AEM Author via Gerenciador de Pacotes do AEM. Este pacote contém as configurações e o conteúdo descritos neste e nos capítulos anteriores do tutorial.