Trabalho com Fragmentos de conteúdo working-with-content-fragments
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:
- Ativar a funcionalidade de fragmento de conteúdo para sua instância
- Modelos de fragmentos do conteúdo - ativar, criar e definir modelos
- Gerenciamento de fragmentos de conteúdo : crie fragmentos de conteúdo; em seguida, edite, publique e faça referência
- Variações - Criação do conteúdo dos fragmentos — crie o conteúdo do fragmento e variações do Principal
- Markdown — uso da sintaxe de marcação para o fragmento
- Uso de conteúdo associado — adição de conteúdo associado
- Metadados - Propriedades do fragmento — visualização e edição das propriedades do fragmento
- Uso Fragmentos de conteúdo, juntamente com o GraphQL, para fornecer conteúdo para uso em seus aplicativos. Para ajudar nisso, você pode visualizar Saída JSON.
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.
-
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 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.
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 do Assets console.
- 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:
- Não ter layout ou design (alguma formatação de texto é possível no modo Rich Text).
- Ter um ou mais partes componentes.
- Podem conter ou estar conectados a imagens.
- Podem usar conteúdo intermediário quando referenciados em uma página.
- São independentes do mecanismo de entrega (ou seja, a página ou canal).
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.
Os ativos podem ser usados 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)
- São parte do fragmento (consulte Partes constituintes de um fragmento de conteúdo).
- Definem a posição do ativo.
- Consulte Inserir ativos no fragmento no Editor de fragmentos para obter mais informações.
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 Principal, 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:
- Está disponível para uso no Editor de páginas ao trabalhar com Fragmentos de conteúdo.
- É conteúdo adicional adicionado no fluxo de um fragmento depois de ter sido usado ou referenciado em uma página.
- Está disponível para uso no Editor de páginas ao trabalhar com Fragmentos de conteúdo.
- O conteúdo intermediário pode ser adicionado a qualquer fragmento onde há apenas um elemento visível.
- O conteúdo associado pode ser usado, assim como os ativos e/ou componentes do navegador apropriado.
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.