Delivery de conteúdo

Os aplicativos móveis devem ser capazes de usar todo e qualquer conteúdo no AEM, conforme necessário, para oferecer a experiência do aplicativo direcionado.

Isso inclui o uso de ativos, conteúdo do site, conteúdo de CaaS (over-the-air) e conteúdo personalizado que pode ter sua própria estrutura.

Há três tipos principais de material que os Serviços de conteúdo fornecem:

1. Assets
2. Conteúdo HTML empacotado (HTML/CSS/JS)
3. conteúdo independente do Canal

Assets

As coleções de ativos são construções AEM que contêm referências a outras coleções.

Uma coleção de ativos pode ser exposta por meio dos Serviços de conteúdo. Chamar uma coleção de ativos em uma solicitação retorna um objeto que é uma lista dos ativos - incluindo seus URLs. Os ativos são acessados por meio de um URL. O URL é fornecido em um objeto. Por exemplo:

• Uma entidade de página retorna JSON (objeto de página) que inclui uma referência de imagem. A referência de imagem é um URL usado para obter o binário de ativo da imagem.
• Uma solicitação de lista de ativos em uma pasta retorna o JSON com detalhes sobre todas as entidades dessa pasta. Essa lista é um objeto. O JSON tem referências de URL que são usadas para obter o binário de ativos para cada ativo nessa pasta.

Otimização de ativos

Um valor importante dos Serviços de conteúdo é a capacidade de retornar ativos otimizados para o dispositivo. Isso reduz as necessidades de armazenamento do dispositivo local e melhora o desempenho do aplicativo.

A otimização de ativos será uma função do lado do servidor, com base nas informações fornecidas na solicitação da API. Sempre que possível, as representações de ativos devem ser armazenadas em cache, de modo que solicitações semelhantes não exijam uma regeração da representação de ativos.

Fluxo de trabalho de ativos

O fluxo de trabalho do ativo é o seguinte:

1. Referência de ativos disponível AEM pronto

2. Criar entidade de referência de ativo, considerando seu modelo

3. Editar entidade

   1. Selecionar ativo ou coleção de ativos
   2. Personalizar renderização JSON

O diagrama a seguir mostra o fluxo de trabalho de referência de ativos:

Gerenciar ativos

Os Serviços de conteúdo fornecem acesso a ativos gerenciados AEM que podem não ser referenciados por meio de outro conteúdo AEM.

Ativos gerenciados existentes

Um usuário existente do AEM Sites e do Assets está usando o AEM Assets para gerenciar todo o material digital para todos os canais. Eles estão desenvolvendo um aplicativo móvel nativo e precisam usar vários ativos gerenciados pela AEM Assets. Por exemplo, logotipos, imagens de fundo, ícones de botão etc.

Atualmente, esses valores são distribuídos no repositório Ativos. Os arquivos que o aplicativo precisa referenciar estão em:

• /content/dam/geometrixx-outdoors/brand/logo_light.png
• /content/dam/geometrixx-outdoors/brand/logo_dark.png
• /content/dam/geometrixx-outdoors/styles/backgrounds/gray_blue.jpg
• /content/dam/geometrixx-outdoors/brand/icons/app/cart.png
• /content/dam/geometrixx-outdoors/brand/icons/app/home.png

Acessar entidades de ativos do CS

Vamos deixar de lado as etapas de como a página é disponibilizada por meio da API por enquanto (ela será coberta pela descrição da interface do usuário AEM) e assumir que foi feita. As entidades de ativos foram criadas e adicionadas ao espaço "appImages". Pastas adicionais foram criadas no espaço para fins de organização. Portanto, as entidades do ativo são armazenadas no JCR AEM como:

• /content/entity/appImages/logos/logo_light
• /content/entity/appImages/logos/logo_escuro
• /content/entity/appImages/bkgnd/gray_blue
• /content/entity/appImages/icons/carrinho
• /content/entity/appImages/icons/home

Obtendo uma lista de entidades de ativos disponíveis

Um desenvolvedor de aplicativos pode obter uma lista de quais ativos estão disponíveis, recuperando as entidades de ativos. O terminal de espaço do Content Services pode fornecer essas informações por meio do SDK da API do serviço da Web.

O resultado seria um objeto em um formato JSON que forneceria uma lista dos ativos na pasta "ícones".

Obtendo uma imagem

O JSON fornece um URL para cada imagem, gerada pelos Serviços de conteúdo para a imagem.

Para obter o binário para a imagem do "carrinho", a biblioteca do cliente é usada novamente.

Conteúdo HTML empacotado

O conteúdo HTML é necessário para clientes que precisam manter o layout do conteúdo. Isso é útil para aplicativos nativos que estão usando um container da Web - como uma visualização da Web do Cordova - para exibir o conteúdo.

AEM Content Services poderá fornecer conteúdo HTML para o aplicativo móvel por meio da API. Os clientes que desejam expor AEM conteúdo como HTML criarão uma entidade de página HTML que aponte para a fonte de conteúdo AEM.

As seguintes opções são consideradas:

• Arquivo Zip: Para ter a melhor chance de exibir corretamente no dispositivo, todo o material referenciado da página - css, JavaScript, ativos etc. - será incluído em um único arquivo compactado com a resposta. As referências na página HTML serão ajustadas para usar um caminho relativo para esses arquivos.
• Streaming: Obtendo um manifesto dos arquivos necessários do AEM. Em seguida, use esse manifesto para solicitar todos os arquivos (HTML, CSS, JS etc.) com solicitações subsequentes.

Conteúdo independente do Canal

O conteúdo independente do Canal é uma forma de expor construções de conteúdo AEM - como páginas - sem se preocupar com layout, componentes ou outras informações específicas do canal.

Essas entidades de conteúdo são geradas usando um modelo de conteúdo para traduzir as estruturas AEM em um formato JSON. Os dados JSON resultantes contêm informações sobre os dados do conteúdo, que são dissociados do repositório AEM. Isso inclui o retorno de metadados e links de referência AEM para ativos, bem como as relações entre estruturas de conteúdo - incluindo hierarquia de entidades.

Gerenciamento de conteúdo independente do Canal

O conteúdo pode acessar o aplicativo de várias maneiras.

1. Conteúdo de GET ZIPS via AEM Over-the-Air

   • Os manipuladores de Sincronização de conteúdo podem atualizar o pacote zip diretamente ou chamando os renderizadores de conteúdo existentes

     • Manipuladores de plataforma
     • Manipuladores de AEMM
     • Manipuladores personalizados

2. conteúdo de GET diretamente por meio de renderizadores de conteúdo

   • Renderizadores padrão prontos para uso
   • Renderizadores de conteúdo do AEM Mobile/Content Services
   • Renderizações personalizadas