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

A história até agora story-so-far

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 objective

  • 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 basic-handling

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.

Autor, visualização e publicação author-preview-publish

Uma instalação do AEM geralmente conta com três ambientes:

  • Autor
  • Publicação
  • Visualizaçã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.

Usando o console de fragmentos de conteúdo, você também pode publicar no serviço de visualização para testar e visualizar antes de publicar. Consulte Publicar e visualizar um fragmento.

Logon signing-in

Como na maioria dos sistemas, é necessário 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. Se você tiver algum problema, a Adobe recomenda que você entre em contato com a equipe interna de suporte ao projeto.

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á o console Fragmentos de Conteúdo (para algumas ações, você também usará o console Ativos).

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

NOTE
Embora os Fragmentos de conteúdo sejam um recurso do AEM Sites, eles são salvos como Ativos. Este é um detalhe técnico que não deve afetar você, mas que pode ser útil.

No console, é possível selecionar pastas no painel esquerdo para navegar até o seu Fragmento de conteúdo. Também é possível filtrar e/ou pesquisar.

Console de Fragmentos de conteúdo

Ações, Seleção, Exibição actions-selecting-viewing

No console de Fragmentos de conteúdo, várias ações estão disponíveis para seus fragmentos de conteúdo na barra de ferramentas:

  • Abrir no Assets
  • Criar
  • A coluna Referenciado por também fornece um link direto para mostrar todas as referências principais desse fragmento, incluindo a referência a fragmentos de conteúdo, fragmentos de experiência e páginas.
  • Passar o mouse sobre o nome da pasta mostrará o caminho JCR.

Após a seleção do fragmento, todas as ações apropriadas estarão disponíveis:

  • Abrir
  • Publicar (e Desfazer publicação)
  • Copiar
  • Mover
  • Renomeie
  • Excluir
NOTE
Ações como Publicar, Desfazer publicação, Excluir, Mover, Renomear e Copiar acionam um processo assíncrono. O progresso desse processo pode ser monitorado por meio da interface de processos assíncronos do AEM.

Criação de fragmentos de conteúdo authoring-content-fragments

Essa foi uma introdução bem rápida à interface do AEM, mas espero que você tenha tido uma chance de experimentá-lo. 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 organizing-and-navigating

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 creating-folder

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:

Opção Criar pasta

Uma caixa de diálogo é aberta, onde você pode inserir os detalhes e confirmar com Criar:

Caixa de diálogo Criar pasta

Uso de caminhos e tags para limitar os Modelos de fragmentos de conteúdo disponíveis na pasta tags-paths-for-models-in-folder

Esta seção é um pouco mais avançada. Você realmente não precisa dela se estiver apenas começando e testando as coisas, mas é muito útil quando há muitos fragmentos. Por isso é bom saber sobre ela mesmo que ainda não a 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.

Criar propriedades de pasta - Políticas

NOTE
Você pode ler mais detalhes em Modelos de fragmentos do conteúdo - Permitir Modelos de fragmentos do conteúdo na pasta de ativos.

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 cloud-services-folder

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:

Criar propriedades de pasta - Configuração

NOTE
Você pode ler mais em Aplicar a configuração à sua pasta de Ativos.

Criação de um Fragmento de conteúdo creating-fragment

No console de Fragmentos de conteúdo, você pode usar Criar para abrir a caixa de diálogo Novo fragmento de conteúdo:

Console de Fragmentos de conteúdo - Criar um novo fragmento

Especifique o:

  • Local
  • Modelo de Fragmentos do conteúdo
  • Título
  • Nome
  • Descrição

Em seguida, confirme com Criar ou Criar e abrir.

Edição de um fragmento editing-fragment

É possível abrir um fragmento imediatamente depois de criá-lo ou selecionando-o no console Fragmentos de conteúdo (também no console Ativos).

NOTE
Os fragmentos de conteúdo são um recurso do Sites, mas são armazenados como Assets.
Existem dois editores para a criação de fragmentos de conteúdo.
  • O novo editor, acessado principalmente pelo Fragmentos de conteúdo console.
  • O editor original, acessado principalmente pelo Assets console.

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

  • barra de ferramentas superior: para informações principais e ações

    • um link para o Console de fragmentos de conteúdo (ícone Início)
    • informações sobre o modelo e a pasta
    • links para Visualização; se o Padrão de URL de Visualização Padrão estiver configurado para o modelo
    • Publicar e Desfazer publicação de ações
    • uma opção para mostrar tudo Referências principais (ícone de link)
    • o fragmento Status e as últimas informações salvas
    • uma alternância para alternar para o editor original (baseado em ativos)
  • painel esquerdo: mostra o Variações para o Fragmento de conteúdo e suas Campos:

    • esses links podem ser usados para navegar pela estrutura do fragmento de conteúdo
  • painel direito: apresenta guias mostrando as propriedades (metadados) e tags, informações sobre o histórico de versões e informações relacionadas a quaisquer cópias de idioma

    • no Propriedades guia, é possível atualizar a guia Título e Descrição para o fragmento ou Variação
  • painel central: mostra os campos reais e o conteúdo da variação selecionada

    • permite editar o conteúdo
    • se Espaço reservado da guia Os campos são definidos no modelo mostrado aqui e podem ser usados para navegação

Por exemplo, um fragmento pode:

  • Exigir várias informações, algumas com um tipo específico. Para conteúdo headless, as referências são fundamentais (você aprenderá sobre elas mais tarde na jornada).

  • 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)

Editor de Fragmentos de conteúdo - Alaska Spirits

NOTE
A documentação específica do projeto pode ser necessária para ajudar os autores com detalhes sobre como preencher alguns campos com êxito.
Consulte Modelos de fragmentos de conteúdo - Tipos de dados e propriedades para detalhes genéricos.

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

NOTE
Para obter mais detalhes, leia Variações - Criação de Fragmentos de conteúdo.

Com o que você (provavelmente) não precisa se preocupar what-you-probably-do-not-need-to-worry-about

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ê pode ver o nome do Modelo de fragmento de conteúdo no painel direito do editor. 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.

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

Publicação publishing

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:

Editor de fragmento de conteúdo - Meu fragmento

NOTE
Você também pode publicar seu fragmento usando o console de Ativos ou Fragmentos de conteúdo.

O que vem a seguir whats-next

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 additional-resources

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab