Noções básicas de criação para headless com AEM

A história até agora

No início da Jornada do autor de conteúdo headless do AEM, a Introdução abordou os conceitos básicos e a terminologia relevante para a criação de conteúdo headless.

Este artigo se baseia nessas noções para que você entenda como criar seu próprio conteúdo para o seu projeto headless do AEM.

Objetivo

• Público-alvo: iniciante
• Objetivo: apresentar as noções básicas da criação de CMS headless:
  • Introdução à criação com o AEMaaCS
  • Introdução aos Fragmentos de conteúdo

Manuseio básico

Antes de lidar com os Fragmentos de conteúdo, veja uma introdução (muito) rápida ao uso do AEM…mas nada substitui a experiência de entrar e tentar usar o sistema.

Criação e publicação

Uma instalação do AEM geralmente consiste em pelo menos dois ambientes:

• Autor
• Publicação

Você faz logon e usa o ambiente de criação para gerar o seu conteúdo. Quando estiver pronto, publique seu conteúdo para que ele fique disponível. Para headless, isso seria para outros aplicativos, para páginas da Web, isso seria para os leitores na Web.

Para obter mais detalhes, consulte os Conceitos de criação.

Fazer logon

Assim como na maioria dos sistemas, você precisará fazer logon. Como autor, você receberá:

• Nome do usuário (conta)
• Senha
• Link para acessar a tela de logon

Sua conta já terá sido configurada com os privilégios necessários. Em caso de problemas, recomendamos que você entre em contato com a equipe interna de suporte a projetos.

Navegação

A primeira vez que você efetuar o logon, um pequeno tutorial online destacará alguns dos principais recursos da interface.

Em seguida, você pode usar o Painel de navegação para acessar as áreas-chave do AEM. Para Fragmentos de conteúdo, você usará a variável Console de ativos.

O Painel de navegação pode ser aberto selecionando o ícone Adobe na parte superior esquerda, seguido pelo pequeno ícone de bússola:

No console, é possível selecionar pastas para navegar até o Fragmento do conteúdo ou a navegação estrutural (no cabeçalho) para navegar de volta para a árvore.

Ações, Seleção, Exibição

O Ativos o console dedicou-se Barras de ferramentas de ação e Ações rápidas que você pode usar depois de selecionar um recurso (por exemplo, uma pasta ou fragmento de conteúdo).

As Ações rápidas estão disponíveis para um único recurso, consulte Basileia no exemplo abaixo:

A barra de ferramentas Ações fornece acesso a toda a gama de ações - aplicáveis ao cenário atual. As ações disponíveis podem mudar; por exemplo, dependendo da sua localização ou se você selecionou vários recursos:

Você pode selecionar o formato para visualizar seus recursos com o Seletor de exibições:

Você pode exibir informações adicionais sobre itens usando o Seletor de painéis. Isso também dá acesso a ações adicionais.

Criação de fragmentos de conteúdo

Então, essa foi uma introdução bem rápida à interface do AEM, mas espero que você tenha tido uma chance de experimentá-la. Agora, chegamos ao seu verdadeiro interesse: Fragmentos de conteúdo para headless.

Teremos que passar pelas coisas do início ao fim, mas sua instância já pode ter pastas e/ou fragmentos criados, e eles podem estar em locais diferentes. Os princípios são os mesmos.

Organização e navegação

A menos que tenha pouquíssimos Fragmentos de conteúdo, você vai querer organizá-los - para que você (e outros) possam encontrá-los novamente.

Criação de pastas

Você pode fazer isso criando uma série de pastas na seção Arquivos do console Ativos. Selecione a opção Criar (parte superior direita), seguido por Pasta:

Uma caixa de diálogo será aberta em que você pode inserir os detalhes e, em seguida, confirmar clicando em Criar:

Uso de caminhos e tags para limitar os Modelos de fragmentos de conteúdo disponíveis na pasta

Esta seção é um pouco mais avançada. Você realmente não precisa dela se você está começando e apenas testando as coisas, mas é muito útil quando você tem muitos fragmentos. Por isso é bom saber - mesmo que ainda não o utilize.

Seu Arquiteto de conteúdo terá criado todos os Modelos de fragmentos de conteúdo necessários para seu projeto atual e talvez alguns outros projetos também. Para ajudar a simplificar as coisas para você mesmo e para outros autores, você pode limitar a lista de modelos disponíveis para uma pasta específica.

Depois de criar a pasta, você pode abrir suas Propriedades. Aqui estão várias guias com informações e detalhes de configuração sobre a pasta. Especificamente para Fragmentos de conteúdo, você pode usar a guia Políticas para definir caminhos e/ou tags específicas para a pasta. Isso limita os Modelos de fragmentos do conteúdo disponíveis para uso na pasta, pois significa que eles devem atender a esses critérios antes que possam ser usados para gerar fragmentos nessa pasta.

Em seguida, navegue por essas pastas para criar e editar os Fragmentos de conteúdo.

Por segurança - Configuração dos serviços de pasta na nuvem

Por segurança…

Você provavelmente receberá uma pasta inicial em que poderá criar suas pastas. Isso ocorre porque alguns detalhes de configuração devem ser aplicados (geralmente por um Desenvolvedor ou Administrador do Sistema) à pasta raiz. Isso provavelmente não lhe interessará, mas, se necessário, você poderá verificar a Configuração nos Serviços na nuvem da pasta Propriedades:

Criação de um Fragmento de conteúdo

A criação de um Fragmento de conteúdo é muito semelhante - você apenas usa a variável Fragmento de conteúdo em vez disso:

Desta vez, um assistente será aberto. A primeira etapa é selecionar o Modelo do fragmento de conteúdo no qual o fragmento será baseado:

Depois de continuar com o Próximo você pode fornecer os detalhes (Básico e Avançado) para o fragmento:

Confirme com Criar e você pode Abrir no editor.

Edição de um fragmento

Você pode abrir um fragmento imediatamente após criá-lo ou selecionando-o no console Assets.

Quando o editor for aberto pela primeira vez, você verá:

• Uma lista de ícones no lado esquerdo - isso lhe dá acesso a várias áreas de funcionalidade. O editor é aberto na guia Variações, em que ocorre a maioria das edições. Você também pode estar interessado nas guias Anotações e Metadados.

• Um cabeçalho com as informações sobre o fragmento e acesso a várias ações.

• A área de edição principal - isso depende do modelo usado para criar o fragmento.

Como exemplos:

• Um fragmento que apenas requer várias informações, algumas com um tipo específico. Para conteúdo headless, as referências são fundamentais. Você aprenderá sobre isso mais tarde na sua jornada.

  

• Um fragmento que permite escrever uma longa seção de texto. Aqui há opções adicionais para gerenciar e formatar o texto. Você pode até mesmo abrir os campos de texto individuais em um editor de tela cheia (usando o ícone de tela pequena à direita)

  

Confirme suas atualizações com Salvar ou Salvar e fechar.

Com o que você (provavelmente) não precisa se preocupar

Essa seção pode parecer um pouco estranha, mas após abrir o Editor de Fragmento de conteúdo e começar a explorar, você verá várias opções que (provavelmente) não se aplicam à sua jornada headless como um Autor de conteúdo. Então, isto é apenas um rápido aviso do que você deve ser capaz de ignorar no contexto headless:

• Modelos de fragmentos de conteúdo

  Você verá o nome do Modelo do Fragmento de Conteúdo na parte superior do editor - diretamente sob o nome do fragmento. Este também é um link que leva você ao editor de modelo.
  Os Modelos de fragmentos de conteúdo são essenciais para os Fragmentos de conteúdo, pois definem a estrutura usada. No entanto, criá-los e editá-los é (geralmente) responsabilidade de outro perfil, o Arquiteto de conteúdo.

  OBSERVAÇÃO

  Se quiser saber mais, leia a Jornada do arquiteto de conteúdo do AEM Headless.

• Conteúdo associado

  Esta é bastante óbvia, já que é uma guia no editor.

  Fragmentos de conteúdo foram disponibilizados no AEM há algumas versões. Originalmente, eles eram disponibilizados para uso “tradicional” durante a criação de páginas…e ainda são usados nesse contexto. Isso pode envolver a associação de ativos (por exemplo, imagens) que, embora não estejam incorporados ao fragmento, precisam estar disponíveis para o autor ao criar uma página.

• Visualização

  Esta é outra guia no editor e fornece uma visualização técnica, destinada principalmente aos desenvolvedores.

• Atualizar referências de página

  Essa ação está disponível no menu suspenso … (reticências). Não é interessante para autores headless, pois se relaciona à criação de página.

Publicação

Após concluir o fragmento, é possível Publicar para que esteja disponível para os aplicativos headless.

As ações de publicação estão disponíveis no editor (ou na barra de ferramentas do Ativos console):

O que vem a seguir

Agora que você aprendeu o básico, o próximo passo é Saiba mais sobre referências. Isso introduzirá e discutirá as várias referências disponíveis e como criar níveis de estrutura com as Referências de fragmento - uma parte essencial da criação para o headless.

Recursos adicionais

• Conceitos de criação

• Manuseio básico - esta página se baseia principalmente no console Sites, mas muitos/a maioria dos recursos também são relevantes para a criação Fragmentos de conteúdo no console Ativos.

  • Painel Navegação

  • O Cabeçalho

  • Barra de ferramentas de ação

  • Ações rápidas

  • Visualização e seleção de recursos

  • Seletor de painéis

• Trabalho com Fragmentos de conteúdo

  • Gerenciamento dos Fragmentos de conteúdo

    • Aplique a configuração à sua pasta de ativos

    • Criação de um Fragmento de conteúdo

  • Variações: criação de Fragmentos de conteúdo

  • Modelos de fragmentos do conteúdo

    • Modelos de fragmento de conteúdo - Tipos de dados

    • Modelos de fragmento de conteúdo: propriedades

    • Modelos de fragmentos de conteúdo: permitir modelos de fragmento de conteúdo na pasta Ativos

• Guias de introdução

  • Criação de uma pasta de ativos sem cabeçalho Guia de início rápido

• Jornada do arquiteto de conteúdo do AEM Headless

• Jornada de tradução headless do AEM

Recursos do Business.Adobe.com