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

Com o Adobe Experience Manager (AEM) as a Cloud Service, 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. Eles também podem ser usados junto com o Gerenciamento de vários sites para permitir que você reutilize o conteúdo.

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.
      • Ele pode ser 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.
      • Ele pode ser 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
NOTE
Os Fragmentos de conteúdo são um recurso do Sites, mas são armazenados como Assets.
Agora eles são gerenciados principalmente com o console Fragmentos de conteúdo, embora ainda possam ser gerenciados no console Assets. Esta seção aborda o gerenciamento do console Assets.
Existem dois editores para a criação de fragmentos de conteúdo. Esta seção abrange o editor original, acessado principalmente do console Assets. Consulte a documentação do Sites, Fragmentos de conteúdo - Criação, para obter detalhes do novo editor (acessado principalmente do console Fragmentos de conteúdo). Ambos os editores têm um botão de alternância na barra de ferramentas superior para fornecer acesso rápido ao outro editor.

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

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.

Com os Fragmentos de conteúdo é possível:

  • 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 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:
  • Os fragmentos de conteúdo são conteúdos editoriais com definição e estrutura, mas sem design visual e/ou layout adicional. Eles podem ser usados para acessar dados estruturados, incluindo textos, números, datas, entre outros.
  • 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 também Entendendo os fragmentos de conteúdo e fragmentos de experiência no AEM.

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
Consulte Headless e AEM para obter uma introdução ao desenvolvimento headless do AEM Sites as a Cloud Service.
NOTE
O AEM também permite a tradução do conteúdo do fragmento. Consulte Tradução de ativos para obter mais informações.

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 pelo 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

    • Conectado a um fragmento; mas não a uma parte fixa do fragmento (consulte Partes constituintes de um fragmento de conteúdo).
    • Possui alguma flexibilidade para o posicionamento.
    • Facilmente disponível 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.
    • Possui alguma flexibilidade para o posicionamento.
    • Não fornecem o conceito de aprovação para um fragmento específico.

    Consulte Navegador de ativos para obter mais informações.

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 multilinha, 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.

    • Incorporado no 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
      O Assets também pode ser adicionado como conteúdo adicional (intermediário) ao usar um fragmento em uma página; usando o Conteúdo associado ou ativos do navegador Assets.
  • 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 estã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, é necessário:

  • 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, JSON ou ambos.
    • 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.

Reutilizar fragmentos de conteúdo com o MSM reusing-content-fragments-with-msm

Quando acessado por meio do console Assets, você pode usar o MSM e criar Live Copies para seus fragmentos.

Para obter mais detalhes, consulte:

Eles habilitam a herança para variações e campos individuais dos fragmentos.

CAUTION
Se você quiser usar o MSM (que cria cópias de Fragmentos de conteúdo), qualquer restrição única deverá ser removida de qualquer Tipo de dados usado nos respectivos Modelos de fragmento de conteúdo.

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, considere o que é usado e onde é usado.

Amostra do WKND wknd-sample

As amostras do Site WKND são fornecidas para ajudá-lo a aprender sobre o AEM as a Cloud Service.

O projeto WKND inclui:

  • Modelos de fragmentos de conteúdo disponíveis em:
    http://<hostname>:<port>/libs/dam/cfm/models/console/content/models.html/conf/wknd

  • Fragmentos de conteúdo (e outro conteúdo) disponíveis em:
    http://<hostname>:<port>/assets.html/content/dam/wknd/en

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