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

A criação dos fragmentos de conteúdo foca na entrega headless e na criação de páginas.

Há dois editores disponíveis para Fragmentos de conteúdo. O editor descreveu nesta seção:

  • O foi desenvolvido para entrega de conteúdo headless (embora possa ser usado para todos os cenários)
  • está disponível no console Fragmentos de conteúdo

Esse editor fornece:

WARNING
O editor descrito nesta seção está somente disponível no online Adobe Experience Manager (AEM) as a Cloud Service.

Editor de fragmento de conteúdo content-fragment-editor

Ao abrir o Editor de fragmento de conteúdo pela primeira vez, você vê quatro áreas principais:

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

  • painel esquerdo: mostra as Variações do fragmento de conteúdo e seus Campos:

  • painel direito: apresenta as 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

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

    • permite editar o conteúdo
    • se os campos Espaço reservado de guia forem definidos no modelo, eles serão mostrados aqui e poderão ser usados para navegação; eles serão apresentados horizontalmente ou como uma lista suspensa.
    note note
    NOTE
    Dependendo das definições no modelo subjacente, os campos podem estar sujeitos a determinados tipos de Validação.

Editor de fragmento de conteúdo - Visão geral

Um único fragmento de conteúdo;

  • Consiste em dois níveis:

    • Variações do fragmento de conteúdo
    • Campos - definidos pelo Modelo de fragmento de conteúdo e usados por cada variação
  • Pode conter várias referências.

Variações e campos variations-and-fields

No painel esquerdo, você pode ver:

  • a lista de Variações que foram criadas para este fragmento:

    • Principal é a variação que está presente quando o fragmento de conteúdo é criado pela primeira vez. Você pode adicionar outros mais tarde
    • você pode usar Gerar variações(#generate-variations) para usar um modelo baseado em prompt que o Adobe criou para um caso de uso específico.
    • você também pode criar uma Variação
  • os Campos dentro do fragmento e suas variações:

    • o ícone indica o Tipo de Dados
    • o texto é o nome do campo
    • juntos, eles fornecem um link direto para o conteúdo do campo no painel central (para a Variação atual)

Em várias partes do editor, é possível ver o ícone de link. Isso pode ser usado para abrir o item exibido; por exemplo, um Modelo de fragmento de conteúdo, uma Referência principal ou um fragmento que está sendo referenciado:

Editor de Fragmento de Conteúdo - Ícone de Link

Árvore de estrutura structure-tree

Abra a guia Árvore de estrutura na barra de ferramentas do editor para mostrar a estrutura hierárquica do fragmento de conteúdo e suas referências. Use os ícones de link para navegar até as referências.

Editor de fragmento de conteúdo - Árvore de estrutura

Salvando e salvando automaticamente saving-autosaving

A cada atualização feita, o fragmento de conteúdo é salvo automaticamente. A última vez que foi salvo é mostrada na barra de ferramentas superior.

Variações variations

Variações são um recurso importante dos Fragmentos de conteúdo do AEM. Eles permitem criar e editar cópias do conteúdo Principal para uso em canais e cenários específicos, tornando a entrega de conteúdo headless e a criação de página ainda mais flexíveis.

No editor, é possível:

Criar uma variação create-variation

Para criar uma variação do fragmento de conteúdo:

  1. No painel esquerdo, selecione o sinal de adição (Criar variação) à direita de Variações.

    note note
    NOTE
    Depois de criar sua primeira variação, as variações existentes serão listadas no mesmo painel.

    Editor de Fragmento de Conteúdo - Criar sua primeira Variação

  2. Na caixa de diálogo, insira um Título para sua variação e uma Descrição, se desejar:

    Editor de Fragmento de Conteúdo - Caixa de diálogo Criar Variação

  3. Crie a variação. Ele aparece na lista.

Renomear uma variação rename-variation

Para renomear uma Variação:

  1. Selecione a variação necessária.

  2. Abra a guia Propriedades no painel direito.

  3. Atualize a variação Título.

  4. Pressione Retornar ou mova para outro campo para salvar automaticamente a alteração. O título é atualizado no painel Variações à esquerda.

Criar variações usando GenAI com Gerar variações generate-variations-ai

Use as Variações gerativas para aproveitar a IA gerativa para acelerar a criação de conteúdo.

Para usar as Variações gerativas no Editor de fragmento de conteúdo:

  1. Abra o Editor de fragmento de conteúdo. No cabeçalho, você encontrará o ponto de entrada para Gerar variações:

    Gerar variações no Editor de fragmento de conteúdo

  2. Gerar variações abre em uma nova guia. No painel à esquerda, é possível ver a instância da nuvem de AEM e o fragmento de conteúdo para o qual você está criando conteúdo. Selecione o prompt que deseja usar ou crie um novo prompt.

    note note
    NOTE
    Os modelos de prompt de Adobe disponíveis agora são limitados, mas serão adicionados mais em versões futuras.

    Exportar para gerar variações no fragmento de conteúdo

  3. Gere conteúdo preenchendo os prompts. O modelo de conteúdo do fragmento será usado automaticamente para gerar conteúdo usando GenAI.

    note note
    NOTE
    Atualmente, só há suporte para campos de texto.

    Exportar para gerar variações no fragmento de conteúdo

  4. Selecione a variante de geração que você gosta e selecione "exportar variação". Confirme o nome da variação do fragmento de conteúdo e selecione:

    • Exportar: exporte a variação para o Fragmento de conteúdo e permaneça no aplicativo Gerar variação.

    • Exportar e abrir: exporte a variação para o Fragmento de conteúdo e abra uma nova guia que mostre o Fragmento de conteúdo com a nova variação da GenAI.

      Exportar para gerar variações no fragmento de conteúdo

  5. As variações geradas são mostradas no Editor de fragmento do conteúdo principal.

    Exibir e gerar variações no fragmento de conteúdo

Você pode saber mais sobre como Gerar Variações aqui.

Excluir uma variação delete-variation

Para excluir uma variação do fragmento de conteúdo:

<div class="extension note">
<div>NOTE</div>
<div>
<p>Não é possível excluir *<em>Principal</em>.</p>
</div>
</div>
  1. Selecione a Variação.

  2. No painel Variação, selecione o ícone Excluir (Lixeira):

    Editor de Fragmento de Conteúdo - ícone Excluir Variação

  3. Uma caixa de diálogo é aberta. Selecione Excluir para confirmar a ação.

Editar campos de texto multilinha - Texto sem formatação ou Markdown edit-multi-line-text-fields-plaintext-markdown

Os campos de texto de várias linhas podem ter um destes três formatos:

Os campos definidos como Texto sem formatação ou Markdown têm uma caixa de texto simples, sem opções de formatação (na tela):

Editor de Fragmento de Conteúdo - Texto multilinha - tela cheia

Editar campos de texto multilinha - Rich text edit-multi-line-text-fields-rich-text

Para campos de Texto multilinha definidos como Rich Text, vários recursos estão disponíveis:

  • Edite o conteúdo:

    • Desfazer/Refazer
    • Colar/Colar como texto
    • Copiar
    • Selecionar formato de parágrafo
    • Criar/gerenciar tabela
    • Formatar texto; negrito, itálico, sublinhado, cor
    • Definir alinhamento do parágrafo
    • Criar/gerenciar listas; com marcadores, numeradas
    • Recuar texto; diminuir, aumentar
    • Limpar formatação atual
    • Inserir links
    • Selecionar e inserir referências a ativos de imagem
    • Adicionar caracteres especiais
  • Editor de tela cheia - alternar entre tela cheia e em fluxo

  • Estatísticas

  • Comparar e sincronizar

Por exemplo:

Editor de Fragmento de Conteúdo - Texto multilinha - alternância de tela inteira

NOTE
Campos de texto multilinha também são indicados pelo ícone apropriado no painel Campos.

Editor de tela cheia - Rich Text full-screen-editor-rich-text

O editor de tela cheia oferece as mesmas opções de edição que quando em fluxo, mas oferece mais espaço para o texto.

Por exemplo:

Editor de Fragmento de Conteúdo - Texto multilinha - tela cheia

Estatísticas - Rich Text statistics-rich-text

A ação Estatísticas exibe um intervalo de informações sobre o texto em um campo de Várias linhas.

Por exemplo:

Editor de fragmento de conteúdo - Estatísticas

Comparar e Sincronizar - Rich Text compare-and-synchronize-rich-text

A ação Comparar estará disponível para campos de Várias linhas quando você tiver uma Variação aberta.

O campo Várias linhas é aberto em tela cheia e:

  • exibe o conteúdo de Principal e da Variação atual em paralelo, com todas as diferenças realçadas

  • as diferenças são indicadas por cor:

    • verde indica conteúdo adicionado (à variação)
    • vermelho indica conteúdo removido (da variação)
    • azul indica texto substituído
  • fornece a ação Sincronizar, que sincroniza o conteúdo de Principal para a variação atual

    • se Principal tiver sido atualizado, essas alterações serão transferidas para a variação
    • se a variação foi atualizada, essas alterações serão substituídas pelo conteúdo de Principal
    note caution
    CAUTION
    A sincronização só está disponível para copiar alterações de Main ​para a variação.
    A transferência de alterações de uma variação para Main não está disponível como uma opção.

Por exemplo, um cenário em que o conteúdo de variação foi completamente reescrito, portanto, uma sincronização substituirá esse novo conteúdo pelo conteúdo de Principal:

Editor de Fragmento de Conteúdo - Comparar e Sincronizar

Gerenciar referências manage-references

Referências de fragmento fragment-references

Referências de fragmento podem ser usadas para:

Criar uma referência a um fragmento de conteúdo existente create-reference-existing-content-fragment

Para criar uma referência a um fragmento de conteúdo existente:

  1. Selecione o campo.

  2. Selecione Adicionar fragmento existente.

  3. Selecione o fragmento necessário no seletor de fragmentos.

    note note
    NOTE
    Você pode selecionar apenas um fragmento por vez.

Criar um fragmento de conteúdo e fazer referência create-reference-content-fragment

Como alternativa, selecione Criar novo fragmento para abrir a caixa de diálogo Criar. Depois de criado, esse fragmento será referenciado.

Referências do conteúdo content-references

Referências de conteúdo são usadas para fazer referência a outros tipos de conteúdo AEM, como imagens, páginas e Fragmentos de experiência.

Imagens de referência reference-images

Nos campos Referência de Conteúdo, você pode:

  • ativos de referência que já existem no repositório

  • carregá-los diretamente no campo; isso evita a necessidade de usar o console Assets para carregar

    note note
    NOTE
    Para carregar uma imagem diretamente no campo Referência de Conteúdo, ela deve:
    • tem um Caminho Raiz definido (no Modelo de Fragmento de Conteúdo). Especifica onde a imagem será armazenada.
    • incluir Imagem na lista de tipos de conteúdo aceitos

Para adicionar um ativo, é possível:

  • arraste e solte o novo arquivo de ativo diretamente (por exemplo, do seu sistema de arquivos) no campo Referência de conteúdo

  • use a ação Adicionar ativo e selecione Procurar Assets ou Carregar para abrir o seletor apropriado para você usar:

    Editor de fragmento de conteúdo - Adicionar opções de ativos

Páginas de referência reference-pages

Para adicionar referências a páginas AEM, Fragmentos de experiência ou outros tipos de conteúdo semelhantes:

  1. Selecione Adicionar caminho de conteúdo.

  2. Adicione o caminho necessário no campo de entrada.

  3. Confirmar com Adicionar.

NOTE
Isso não deve ser usado para referências a:

Exibir Referências Pai view-parent-references

Selecionar o ícone de link na barra de ferramentas superior abre uma lista de todas as referências principais.

Por exemplo:

Editor de fragmento de conteúdo - Mostrar referências

Uma janela é aberta, listando todas as referências relacionadas. Para abrir uma referência, selecione o nome, o título ou o ícone de link.

Por exemplo:

Editor de fragmento de conteúdo - Mostrar referências

Propriedades da exibição e tags view-properties-tags

Na guia Propriedades do painel direito, as propriedades (metadados) e as tags podem ser visualizadas. As propriedades podem ser:

  • para o Fragmento do conteúdo - se Principal estiver selecionado no momento
  • para uma Variação específica

Editor de fragmento de conteúdo - Propriedades

Editar propriedades e tags edit-properties-tags

Na guia Propriedades (painel direito), também é possível editar:

  • Título

  • Descrição

  • Marcas: usando a lista suspensa ou a caixa de diálogo de seleção

    Editor de fragmento de conteúdo - Gerenciar marcas

Abrir o modelo de fragmento de conteúdo open-content-fragment-model

Quando você seleciona Principal, o nome do modelo de fragmento de conteúdo subjacente é exibido na seção de propriedades. Selecionar o ícone de link abre o modelo em uma guia separada.

Por exemplo:

Editor de fragmento de conteúdo - abrir modelo de fragmento de conteúdo

Exibir o histórico da versão view-version-history

Na guia Histórico de versões do painel direito, os detalhes das versões atual e anterior são mostrados:

NOTE
Uma nova versão é criada quando o fragmento de conteúdo é publicado.

Editor de fragmento de conteúdo - Visão geral do histórico de versões

Comparar versão compare-version

Para um fragmento de conteúdo, é possível comparar uma versão anterior com a versão atual.

Para comparar uma versão anterior à atual:

  1. Selecione o ícone de três pontos ao lado da versão.

  2. Selecione Comparar.

Editor de Fragmento de Conteúdo - Comparação de Histórico de Versões

Isso abre uma visualização que mostra as diferenças entre a versão atual do conteúdo e a versão anterior selecionada do fragmento de conteúdo. No menu suspenso Variações com alterações, é possível selecionar para ver as diferenças do conteúdo principal e/ou do conteúdo de uma Variação.

As diferenças são indicadas por cor:

  • Verde: indica conteúdo adicionado (à versão atual)
  • Vermelho: indica conteúdo removido (da versão atual)

Editor de Fragmento de Conteúdo - Versões de Comparação do Histórico de Versões

Reverter para uma versão revert-version

Você pode reverter para qualquer versão do.

Para reverter para uma versão específica:

  1. Selecione o ícone de três pontos ao lado da versão.

  2. Selecione Reverter.

Editor de Fragmento de Conteúdo - Reverter Histórico de Versões

Exibir as cópias de idioma view-language-copies

Na guia Propriedades de idioma, são exibidos detalhes de todas as cópias de idioma relacionadas. Selecionar um ícone de link abre a cópia em uma guia separada.

Por exemplo:

Editor de Fragmento de Conteúdo - abrir Cópia de Idioma

NOTE
Para obter mais detalhes sobre a tradução de um fragmento de conteúdo e a criação de cópias de idioma, consulte a Jornada de tradução do AEM Headless.

Visualizar o fragmento preview-content-fragment

O editor de fragmento de conteúdo fornece aos autores a opção de visualizar suas edições em um aplicativo de front-end externo.

Para usar esse recurso, primeiro é necessário:

  • Trabalhe com sua equipe de TI para configurar o aplicativo de front-end externo que renderizará o fragmento de conteúdo consumindo sua saída JSON.
  • Quando o aplicativo de front-end externo está configurado, o Padrão de URL de Visualização Padrão deve ser definido como uma propriedade do Modelo de Fragmento de Conteúdo apropriado.

Quando a URL tiver sido definida, o botão Visualizar ficará ativo. Você pode selecionar esse botão para iniciar o aplicativo externo (em uma guia separada) para renderizar o fragmento de conteúdo.

Publish seu fragmento publish-content-fragment

Você pode Publish seu fragmento para:

  • Visualizar instância
  • Instância do Publish

Você pode publicar o fragmento no editor ou no console. Consulte Publicação e visualização de um fragmento para obter detalhes completos.

Cancelar publicação do fragmento unpublish-content-fragment

Você também pode Desfazer a publicação do fragmento de:

  • Visualizar instância
  • Instância do Publish

Você pode desfazer a publicação do fragmento no editor ou no console. Consulte Desfazer a publicação de um fragmento para obter detalhes completos.

Campos, tipos de dados e ícones fields-datatypes-icons

O painel Campos lista todos os campos dentro do Fragmento de conteúdo. O ícone indica o Tipo de Dados:

Texto em linha única
Texto multilinha
Número
Booleano
Data e hora
Lista discriminada
Tags
Referência de conteúdo
Referência de fragmento
Objeto JSON

Espaço reservado da guia

Embora não seja representado por um ícone real, um Espaço reservado para tabulação é representado no painel esquerdo.
Ele também é representado no painel central, seja horizontalmente, como mostrado, ou em uma lista suspensa (quando houver muitos para serem exibidos horizontalmente).

É bom saber good-to-know

  • Para editar um fragmento de conteúdo, você precisa de as permissões apropriadas. Entre em contato com o(a) administrador(a) do sistema em caso de problemas.

    Por exemplo, se você não tiver edit permissões, o editor será somente leitura.

  • Um modelo de fragmento de conteúdo geralmente pode definir campos de dados chamados Título e Descrição. Se esses campos existirem, eles serão definidos pelo usuário e poderão ser atualizados no painel central ao editar o fragmento.

    O Fragmento de Conteúdo e suas variações também têm campos de metadados (propriedades de Variação) chamados Título e Descrição. Esses campos são parte integral de qualquer fragmento de conteúdo e são definidos inicialmente quando o fragmento é criado. Eles podem ser atualizados no painel direito ao editar o fragmento.

  • Consulte a documentação do Assets para obter informações completas sobre o editor original de Fragmento de Conteúdo - ela está disponível no console do Assets e no console do Fragmentos de Conteúdo.

  • A equipe do projeto pode personalizar o editor, se necessário. Consulte Personalização do Console e do Editor de Fragmentos de Conteúdo para obter mais detalhes.

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