DocumentaçãoAEM 6.5Guia do usuário

Trabalho com Fragmentos de conteúdo working-with-content-fragments

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Criado para:

  • Usuário

Com o Adobe Experience Manager (AEM), os fragmentos de conteúdo permitem projetar, criar, preparar e publicar conteúdo independente de página. Eles permitem preparar conteúdo pronto para uso em vários locais/canais, ideal para entrega headless.

Os fragmentos de conteúdo contêm conteúdo estruturado:

  • Eles se baseiam em um Modelo de fragmento de conteúdo, que predefine uma estrutura para o fragmento resultante.

  • A estrutura pode variar entre:

    • Básico

      • Por exemplo, um único campo de texto de várias linhas.
      • Usado para preparar conteúdo direto para uso na criação de páginas.

    • Complexo

      • Uma combinação de vários campos de tipos de dados variáveis, incluindo texto, número, booleano, data e hora, entre outros.
      • Usado para preparar conteúdo mais estruturado para a criação de páginas ou para entrega em seu aplicativo.

    • Aninhado

      • Os tipos de dados de referência disponíveis permitem aninhar o conteúdo.
      • Tendem a ser usados para entrega em seu aplicativo.

Os fragmentos de conteúdo também podem ser entregues no formato JSON, usando os recursos de exportação do Modelo Sling (JSON) dos componentes principais do AEM. Esta forma de entrega:

  • permite usar o componente para gerenciar quais elementos de um fragmento fornecer
  • permite a entrega em massa, adicionando vários componentes principais do fragmento de conteúdo na página que está sendo usada para a entrega da API

Esta e as seguintes páginas abordam as tarefas de criação, configuração, manutenção e uso dos fragmentos de conteúdo:

NOTE
Essas páginas podem ser lidas com:

O número de canais de comunicação aumenta anualmente. Normalmente, os canais se referem ao mecanismo de entrega, como:

  • Canal físico; por exemplo, desktop, móvel.
  • Forma de entrega em um canal físico; por exemplo, “página de detalhes do produto”, “página de categoria do produto” para desktop ou “web para publicação de conteúdo para dispositivos móveis”, “aplicativo para publicação de conteúdo para dispositvos móveis” para celular.

No entanto, você (provavelmente) não deseja usar o mesmo conteúdo para todos os canais; é necessário otimizar o conteúdo de acordo com o canal específico.

Os fragmentos de conteúdo permitem:

  • Considerar como atingir públicos-alvo com eficiência em todos os canais.
  • Criar e gerenciar conteúdo editorial neutro para o canal.
  • Criar grupos de conteúdo para um intervalo de canais.
  • Desenvolver variações de conteúdo para canais específicos.
  • Adicionar imagens ao texto inserindo ativos (fragmentos de mídia mista).
  • Crie conteúdo aninhado para que você possa refletir a complexidade dos seus dados.

Esses fragmentos de conteúdo podem ser reunidos para fornecer experiências em vários canais.

NOTE
Fragmentos de conteúdo e fragmentos de experiência são recursos diferentes no AEM:

  • Fragmentos de conteúdo são conteúdos editoriais que podem ser usados para acessar dados estruturados, incluindo textos, números, datas, entre outros. Eles são conteúdo puro, com definição e estrutura, mas sem designs visuais e/ou layouts adicionais.

  • Fragmentos de experiência são conteúdo totalmente apresentado; um fragmento de uma página da Web.

Fragmentos de experiência podem incluir conteúdo na forma de Fragmentos de conteúdo, mas não o contrário.
Para obter mais informações, consulte Entenda sobre os fragmentos de conteúdo e fragmentos de experiência do AEM.
NOTE
Antes do AEM 6.3, os fragmentos de conteúdo eram criados com o uso de modelos em vez de modelos. Os modelos não estão mais disponíveis para criar fragmentos, mas qualquer fragmento criado com esse modelo ainda é compatível.

Fragmentos de conteúdo e serviços de conteúdo content-fragments-and-content-services

Os Serviços de conteúdo do AEM foram criados para generalizar a descrição e a entrega de conteúdo de e para o AEM para além do foco em páginas da Web.

Eles realizam a entrega de conteúdo para canais que não são páginas da Web tradicionais do AEM, usando métodos padronizados que podem ser consumidos por qualquer cliente. Esses canais podem incluir:

  • Aplicativos de página única
  • Aplicativos nativos para dispositivos móveis
  • outros canais e pontos de contato externos ao AEM

A entrega é feita no formato JSON usando o Exportador JSON.

Os fragmentos de conteúdo do AEM podem ser usados para descrever e gerenciar conteúdo estruturado. O conteúdo estruturado é definido em modelos que podem conter vários tipos de conteúdo; incluindo texto, dados numéricos, booleano, data e hora e muito mais.

Juntamente com os recursos de exportação em JSON dos componentes principais do AEM, esse conteúdo estruturado pode ser usado para fornecer conteúdo do AEM a outros canais além das páginas do AEM.

NOTE
O AEM também permite a tradução do conteúdo do fragmento.

Tipo de conteúdo content-type

Os fragmentos de conteúdo são:

  • Armazenados como Ativos:

    • Os fragmentos de conteúdo (e suas variações) podem ser criados e mantidos no console Assets.
    • Criados e editados no Editor de fragmento de conteúdo.

  • Usado no editor de páginas com o componente Fragmento de Conteúdo (componente de referência):

    • O componente Fragmento de conteúdo está disponível para autores de página. Ele permite referenciar e entregar o fragmento de conteúdo necessário nos formatos HTML ou JSON.

  • Acessíveis por meio da API GraphQL do AEM.

Fragmentos de conteúdo são uma estrutura de conteúdo que:

Fragmentos com ativos visuais fragments-with-visual-assets

Para conceder mais controle do conteúdo aos autores, as imagens podem ser adicionadas e/ou integradas a um fragmento de conteúdo.

O Assets pode ser usado com um fragmento de conteúdo de várias maneiras; cada uma com suas próprias vantagens:

  • Inserir ativo em um fragmento (fragmentos de mídia mista)

    note note
    NOTE
    Os ativos visuais inseridos no fragmento de conteúdo propriamente dito são anexados ao parágrafo anterior no fragmento. Quando o fragmento é adicionado a uma página, esses ativos são movidos em relação a esse parágrafo quando o conteúdo intermediário é adicionado.

  • Conteúdo associado

    • Estão conectados a um fragmento; mas não a uma parte fixa do fragmento (consulte Partes constituintes de um fragmento de conteúdo).
    • Permitem alguma flexibilidade para o posicionamento.
    • Estão facilmente disponíveis para uso (como conteúdo intermediário) ao usar o fragmento em uma página.
    • Consulte o Conteúdo associado para obter mais informações.

  • Ativos disponíveis no navegador de Ativos do editor de página

    • Permitem flexibilidade total para a seleção de um ativo.
    • Permitem alguma flexibilidade para o posicionamento.
    • Não fornecem o conceito de aprovação para um fragmento específico.

Partes constituintes de um fragmento de conteúdo constituent-parts-of-a-content-fragment

Os ativos do fragmento de conteúdo são compostos das seguintes partes (direta ou indiretamente):

  • Elementos do fragmento

    • Os elementos estão correlacionados aos campos de dados que contêm conteúdo.
    • Usa-se um modelo de conteúdo para criar o fragmento de conteúdo. Os elementos (campos) especificados no modelo definem a estrutura do fragmento. Esses elementos (campos) podem ser de vários tipos de dados.

  • Parágrafos de fragmento

    • Blocos de texto, geralmente de várias linhas, que são delimitados como entidades individuais.

    • Nos modos Rich Text e Markdown, um parágrafo pode ser formatado como um cabeçalho. Nesse caso, ele e o parágrafo a seguir pertencem como uma unidade.

    • Ativam o controle de conteúdo durante a criação da página.

  • Ativos inseridos em um fragmento (fragmentos de mídia mista)

    • Ativos (imagens) inseridos no fragmento real e usados como conteúdo interno de um fragmento.

    • São incorporados ao sistema de parágrafo do fragmento.

    • Podem ser formatados quando o fragmento é usado/referenciado em uma página.

    • Só podem ser adicionados, excluídos ou movidos dentro de um fragmento usando o editor de fragmentos. Essas ações não podem ser realizadas no editor de páginas.

    • Só podem ser adicionados, excluídos ou movidos dentro de um fragmento usando o formato Rich Text no editor de fragmento.

    • Só podem ser adicionados a elementos de texto multilinha (qualquer tipo de fragmento).

    • São anexados ao texto anterior (parágrafo).

      note caution
      CAUTION
      Os ativos podem ser (inadvertidamente) removidos de um fragmento ao alternar para o formato de Texto sem formatação.
      note note
      NOTE
      Os ativos também podem ser adicionados como conteúdo adicional (intermediário) ao usar um fragmento em uma página; usando o conteúdo associado ou ativos do navegador de ativos.

  • Conteúdo associado

    • Esse é um conteúdo externo a um fragmento, mas com relevância editorial. Normalmente, imagens, vídeos ou outros fragmentos.

    • Os ativos individuais contidos na coleção estão disponíveis para serem usados com o fragmento no editor de páginas, quando ele é adicionado a uma página. Isso significa que elas são opcionais, dependendo dos requisitos do canal específico.

    • Os ativos são associados aos fragmentos por meio de coleções; as coleções associadas permitem que o autor decida quais ativos usar ao criar a página.

      • As coleções podem ser associadas aos fragmentos como conteúdo padrão ou por autores durante a criação do fragmento.
      • As coleções de ativos (DAM) são a base para o conteúdo associado de fragmentos.

    • Opcionalmente, também é possível adicionar o próprio fragmento a uma coleção para auxiliar no rastreamento.

  • Metadados de fragmento

    • Usa os esquemas de metadados de ativos.

    • Tags podem ser criadas quando você:

      • Cria o fragmento

      • Ou posteriormente:

        • Ao visualizar/editar as Propriedades do fragmento no console
        • Ao editar os Metadados no editor de fragmento
    note caution
    CAUTION
    Os perfis de processamento de metadados não se aplicam aos fragmentos de conteúdo.

  • Principal

    • Uma parte do fragmento

      • Cada fragmento de conteúdo tem uma instância Principal.
      • O Principal não pode ser excluído.

    • O Principal pode ser acessado no editor de fragmentos, em Variações.

    • O Principal não é uma variação em si, mas a base de todas as variações.

  • Variações

    • Representações de texto de fragmento específicas para um objetivo editorial; podem estar relacionadas a canais, mas não é obrigatório. Também podem ser para modificações locais ad hoc.
    • São criadas como cópias de Mestre, mas podem ser editadas conforme necessário; há sobreposição de conteúdo entre as próprias variações.
    • Podem ser definidas durante a criação do fragmento.
    • São armazenadas no fragmento para ajudar a evitar a dispersão de cópias de conteúdo.
    • As variações podem ser sincronizadas com o Principal se o conteúdo do Principal tiver sido atualizado.
    • Podem ser resumidas para truncar rapidamente o texto em um comprimento predefinido.
    • Disponíveis na guia Variações do editor de fragmentos.

Conteúdo intermediário ao criar páginas com fragmentos de conteúdo in-between-content-when-page-authoring-with-content-fragments

Conteúdo intermediário:

CAUTION
O conteúdo intermediário é o conteúdo da página. Ele não é armazenado no fragmento de conteúdo.

Exigido por fragmentos required-by-fragments

Para criar fragmentos de conteúdo, considere o seguinte:

  • Modelo de conteúdo

    • É ativado usando o Navegador de configuração.
    • É criado usando Ferramentas.
    • Obrigatório para criar um fragmento.
    • Define a estrutura de um fragmento (título, elementos de conteúdo, definições de tag).
    • As definições do modelo de conteúdo exigem um título e um elemento de dados; todo o resto é opcional.
    • O modelo pode definir o conteúdo padrão, se aplicável.
    • Os autores não podem alterar a estrutura definida ao criar o conteúdo do fragmento.
    • As alterações feitas em um modelo após a criação de fragmentos de conteúdo dependentes podem afetar esses fragmentos de conteúdo.

Para usar os Fragmentos de conteúdo para a criação de páginas, também é necessário:

  • Componente Fragmento de Conteúdo

    • Fundamental para entregar o fragmento no formato HTML e/ou JSON.
    • Obrigatório para fazer referência ao fragmento em uma página.
    • Responsável pelo layout e entrega de um fragmento (ou seja, os canais).
    • Os fragmentos precisam de um ou mais componentes dedicados para definir o layout e fornecer alguns ou todos os elementos/variações e conteúdo associado.
    • Arrastar um fragmento para uma página na criação associa automaticamente o componente necessário.

Exemplo de uso example-usage

Um fragmento, com seus elementos e variações, pode ser usado para criar conteúdo coerente para vários canais. Ao projetar o fragmento, você deve considerar o que é usado e onde é usado.

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2