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

A história até agora

No início do jornada do autor de conteúdo sem cabeçalho do AEM o Introdução O aborda os conceitos básicos e a terminologia relevantes para a criação para periféricos.

Este artigo é baseado neles para que você entenda como criar seu próprio conteúdo para seu projeto sem periféricos de AEM.

Objetivo

  • Público: Iniciante
  • Objetivo: Apresente as noções básicas da criação de CMS sem cabeçalho:
    • Introdução à criação com o AEMaaCS
    • Introdução aos fragmentos de conteúdo

Manuseio básico

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

Autor 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 seu conteúdo. Quando estiver pronto, publique seu conteúdo para que ele fique disponível. Para ser impotente, 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 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.

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

Em seguida, você pode usar o Painel de navegação para acessar áreas-chave de AEM. Para Fragmentos de conteúdo, você usará a variável Fragmentos de conteúdo (para algumas ações, você também usará o Ativos ).

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

OBSERVAÇÃO

Embora os Fragmentos de conteúdo sejam um recurso de AEM Sites, são salvas como Ativos. Este é um detalhe técnico que não deve afetá-lo, mas que pode ser útil saber.

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

Console Fragmentos de conteúdo

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

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
OBSERVAÇÃO

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

Então, essa foi uma introdução muito rápida à interface do usuário do AEM, mas espero que você tenha tido a chance de experimentá-la. Agora, mostramos seu interesse real - 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ê desejará organizá-los - para que você (e outros) os encontre novamente.

Criação de uma pasta

Você pode fazer isso criando uma série de pastas no Arquivos da seção Ativos console. Selecione o Criar (canto superior direito), seguido por Pasta:

Opção Criar pasta

Uma caixa de diálogo será aberta onde você pode inserir os detalhes e, em seguida, 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

Esta seção está um pouco mais avançada. Você realmente não precisa disso se você está apenas começando e tentando coisas, mas é very ú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 fragmento de conteúdo necessários para seu projeto atual e talvez alguns outros projetos também. Para ajudar a simplificar as coisas para si 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 abri-la 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 o Políticas para definir caminhos e/ou tags específicas para essa pasta. Isso limita os Modelos de fragmento de conteúdo disponíveis para uso na pasta, pois significa que os Modelos de fragmento de conteúdo devem atender a esses requisitos antes que possam ser usados para gerar fragmentos nessa pasta.

Criar propriedades de pasta - Políticas

OBSERVAÇÃO

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

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

Por acaso - Configuração de Cloud Services de pasta

Só para o caso…

Você provavelmente receberá uma pasta inicial onde 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 variável Configuração no Cloud Services da pasta Propriedades:

Criar propriedades de pasta - Configuração

OBSERVAÇÃO

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

Criação de um fragmento de conteúdo

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

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

Especifique o:

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

Em seguida, confirme com Criar ou Criar e abrir.

Edição de um fragmento

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

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

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

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

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

Como exemplos:

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

    Editor de fragmento de conteúdo - Meu fragmento

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

    Editor de fragmentos de conteúdo - Espirais do Alasca

OBSERVAÇÃO

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 obter detalhes genéricos.

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

OBSERVAÇÃO

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

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

OK, essa seção pode parecer um pouco estranha, mas depois de 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 sem cabeçalho como um Autor de conteúdo. Então isto é apenas uma breve visualização do que você deve ser capaz de ignorar no contexto sem cabeça:

  • Modelos de fragmentos do 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 outra pessoa, o Arquiteto de conteúdo.

    OBSERVAÇÃO

    Se quiser saber mais, leia a Jornada do AEM Headless Content Architect.

  • Conteúdo associado

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

    Fragmentos de conteúdo foram disponibilizados no AEM para várias 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.

  • Visualizar

    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 (elipses). Não é interessante para autores sem cabeçalho, 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 sem periféricos.

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

Editor de fragmento de conteúdo - Meu fragmento

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

Nesta página