DocumentaçãoAEM 6.4Guia de criação

Fragmentos de experiência experience-fragments

Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Criado para:

  • Usuário
CAUTION
AEM 6.4 chegou ao fim do suporte estendido e esta documentação não é mais atualizada. Para obter mais detalhes, consulte nossa períodos de assistência técnica. Encontre as versões compatíveis here.

Um Fragmento de experiência é um grupo de um ou mais componentes, incluindo conteúdo e layout que podem ser referenciados nas páginas. Eles podem conter qualquer componente.

Um fragmento de experiência:

  • Faz parte de uma experiência (página).
  • Pode ser usado em várias páginas.
  • É baseado em um modelo (somente editável) para definir a estrutura e os componentes.
  • É composto de um ou mais componentes, com layout, em um sistema de parágrafos.
  • Pode conter outros fragmentos de experiência.
  • Pode ser combinado com outros componentes (incluindo outros Fragmentos de experiência) para formar uma página completa (experiência).
  • Pode ter variações diferentes, que podem compartilhar conteúdo e/ou componentes.
  • Pode ser dividida em blocos de construção que poderão ser usados em várias variações do fragmento.

Use os Fragmentos de experiência:

  • Se um autor quiser reutilizar partes (um fragmento de uma experiência) de uma página, precisará copiar e colar esse fragmento. Criar e manter essa experiências de copiar/colar é um processo demorado e pode causar erros feitos pelo usuário. Os fragmentos de experiência eliminam a necessidade de copiar/colar.
  • Para dar suporte ao caso de uso de CMS sem periféricos. Os autores desejam usar o AEM somente para criação, não para entrega ao cliente. Um ponto de contato ou sistema de terceiros consumiria essa experiência e a entregaria para o usuário final.
NOTE
O acesso de gravação para fragmentos de experiência requer que a conta de usuário seja registrada no grupo:
experience-fragments-editors
Entre em contato com o administrador do sistema em caso de problemas.

Quando você deve usar fragmentos de experiência? when-should-you-use-experience-fragments

Fragmentos de experiência devem ser usados:

  • Sempre que quiser reutilizar experiências.

    • Experiências que serão reutilizadas com o mesmo conteúdo ou com conteúdo semelhante

  • Ao usar o AEM como uma plataforma de entrega de conteúdo para terceiros.

    • Qualquer solução que deseje usar o AEM como a plataforma de entrega de conteúdo
    • Ao incorporar conteúdo em pontos de contato de terceiros

  • Se você tiver uma Experiência com variações ou representações diferentes.

    • Canal ou variações específicas do contexto
    • Experiências que fazem sentido agrupar (por exemplo, uma campanha com experiências diferentes em canais)

  • Quando você usar o Comércio omnichannel.

    • Ao compartilhar conteúdo comercial em canais de redes sociais em escala
    • Tornar pontos de toque transacionais

Organizar os Fragmentos de experiência organizing-your-experience-fragments

Recomenda-se:

A criação de pastas permite:

  • criar uma estrutura significativa para os Fragmentos de experiência; por exemplo, de acordo com a classificação

    note note
    NOTE
    Não é necessário alinhar a estrutura dos Fragmentos de experiência com a estrutura de página do site.

  • alocar os modelos permitidos no nível da pasta

    note note
    NOTE
    Você pode usar o editor de modelos para criar seu próprio modelo.

O exemplo a seguir mostra Fragmentos de experiência estruturados de acordo com Contributors. A estrutura usada também ilustra a maneira como outros recursos, como o Gerenciamento de vários sites (incluindo cópias de idiomas), podem ser usados.

CAUTION
A seguinte captura de tela foi tirada do site WKND usando o Adobe Experience Manager as a Cloud Service.

Pastas para Fragmentos de experiência

Criação e configuração de uma pasta para os Fragmentos de experiência creating-and-configuring-a-folder-for-your-experience-fragments

Para criar e configurar uma pasta para os Fragmentos de experiência, recomenda-se:

  1. Criar uma pasta.

  2. Configurar os modelos de Fragmento de experiência permitidos para essa pasta.

NOTE
Também é possível configurar a variável Modelos permitidos para sua instância, mas este método é not recomendado, pois os valores podem ser substituídos na atualização.

Configurar os Modelos permitidos para sua Pasta configure-allowed-templates-folder

NOTE
Esse é o método recomendado para especificar os Modelos permitidos, pois os valores não serão substituídos na atualização.

  1. Acesse a pasta Fragmentos de experiência necessária.

  2. Selecione a pasta e depois as Propriedades.

  3. Especifique a expressão regular para recuperar os modelos necessários no campo Modelos permitidos.

    Por exemplo:
    /conf/(.*)/settings/wcm/templates/experience-fragment(.*)?

    Propriedades dos fragmentos de experiência - Modelos permitidos

  4. Selecione Salvar e fechar.

Configurar os Modelos permitidos para sua Instância configure-allowed-templates-instance

CAUTION
Não é recomendável alterar a variável Modelos permitidos por esse método, pois os modelos especificados podem ser substituídos na atualização.
Use esta caixa de diálogo apenas para fins informativos.

  1. Acesse o console Fragmentos de experiência necessário.

  2. Selecione Opções de configuração:

    Botão Configuração

  3. Especifique os modelos necessários na caixa de diálogo Configurar fragmentos de experiência:

    Configurar fragmentos de experiência

  4. Selecione Salvar.

Criação de um fragmento de experiência creating-an-experience-fragment

Para criar um fragmento de experiência:

  1. Selecione Fragmentos de experiência na Navegação global.

    screen_shot_2018-04-05at9221am1

  2. Navegue até a pasta desejada e selecione Criar.

  3. Selecione Fragmento de experiência para abrir o assistente Criar fragmento de experiência.

    Selecione o modelo obrigatório e, em seguida, clique em Avançar:

    xf-authoring-02

  4. Insira as Propriedades do Fragmento de experiência.

    É obrigatório ter um título. Se a variável Nome for deixado em branco, ele será derivado do Título.

    xf-authoring-03

  5. Clique em Criar.

    Uma mensagem será exibida. Selecionar:

    • Concluído para retornar ao console
    • Abrir para abrir o editor de fragmento

Edição de seu fragmento de experiência editing-your-experience-fragment

O Editor de fragmento de experiência oferece recursos semelhantes ao Editor de páginas normal. Consulte Editar conteúdo da página para obter mais informações sobre como usá-lo.

O seguinte procedimento de exemplo ilustra como criar um teaser para um produto:

  1. Arraste e solte uma Teaser da categoria do Navegador de componentes.

    xf-authoring-04

  2. Selecionar Configurar na barra de ferramentas do componente.

  3. Adicione o Ativo e defina as Propriedades conforme necessário.

  4. Confirme as definições com Concluído (ícone de marca de verificação).

  5. Adicione mais componentes conforme necessário.

Criação de uma variação de Fragmento de experiência creating-an-experience-fragment-variation

Você pode criar variações do Fragmento de experiência, dependendo das suas necessidades:

  1. Abra o fragmento para edição.

  2. Abra a guia Variações.

    xf-authoring-06

  3. Criar O permite criar:

    • Variação
    • Variação como Live Copy.

  4. Defina as propriedades necessárias:

    • Modelo
    • Título
    • Nome; se deixado em branco, ele será derivado do Título
    • Descrição
    • Tags de variação

    xf-authoring-07

  5. Confirme com Concluído (ícone de marca de verificação), a nova variação será mostrada no painel:

    xf-authoring-08

Usar seu fragmento de experiência using-your-experience-fragment

Agora é possível usar o Fragmento de experiência ao criar suas páginas:

  1. Abra qualquer página para edição.

    Por exemplo: http://localhost:4502/editor.html/content/we-retail/language-masters/en/products/men.html

  2. Crie uma instância do componente Fragmento de experiência arrastando o componente do navegador Componentes para o sistema de parágrafos da página:

    xf-authoring-09

  3. Adicione o Fragmento de experiência real à ocorrência de componente:

    • Arraste o fragmento necessário do Navegador de Ativos e solte no componente
    • Selecionar Configurar na barra de ferramentas do componente e especifique o fragmento a ser usado, confirme com Concluído (marca de verificação)

    xf-authoring-10

    note note
    NOTE
    Editar, na barra de ferramentas do componente, opera como um atalho para abrir o fragmento no editor de fragmentos.

Blocos de construção building-blocks

Selecione um ou mais componentes para criar um bloco de construção para reciclagem no seu fragmento:

Criar um bloco de construção creating-a-building-block

Para criar um novo Bloco de construção:

  1. No editor Fragmento de experiência, selecione os componentes que deseja reutilizar:

    xf-authoring-12

  2. Na barra de ferramentas dos componentes, selecione Converter em bloco de construção:

    xf-authoring-13-icon

    Por exemplo:

    xf-authoring-13

  3. Insira o nome do Bloco de construção e confirme com Converter:

    xf-authoring-14

  4. O Bloco de construção será mostrado na guia e poderá ser selecionado no sistema de parágrafos:

    xf-authoring-15

Gerenciar um bloco de construção managing-a-building-block

O bloco de construção está visível na guia Blocos de construção. Para cada bloco, as seguintes ações estão disponíveis:

  • Acesse o mestre: abra a variação mestre em uma nova guia
  • Renomear
  • Excluir

xf-authoring-16

Usar um bloco de construção using-a-building-block

Arraste o bloco de construção para o sistema de parágrafo de qualquer fragmento, como com qualquer componente.

A representação HTML simples the-plain-html-rendition

Usar o .plain. no URL, você pode acessar a representação de HTML simples.

Isso está disponível no navegador, mas o objetivo principal é permitir outros aplicativos (por exemplo, aplicativos da Web de terceiros, implementações móveis personalizadas) para acessar o conteúdo do Fragmento de experiência diretamente, usando apenas o URL.

A representação de HTML simples adiciona o protocolo, host e caminho de contexto aos caminhos que são:

  • do tipo: src, hrefou action

  • ou terminar com: -srcou -href

Por exemplo:

.../brooklyn-coat/master.plain.html

NOTE
Os links sempre fazem referência à instância de publicação. Eles devem ser consumidos por terceiros, de modo que o link sempre será chamado da instância de publicação, não do autor.

xf-authoring-17

Exportar fragmentos de experiência exporting-experience-fragments

Por padrão, os Fragmentos de experiência são entregues no formato HTML. Isso pode ser usado por canais de AEM e de terceiros.

Para exportação para o Adobe Target, é usado o HTML. Consulte Integração do Target com fragmentos de experiência para obter informações completas.

recommendation-more-help
5f6f1f67-8db1-40cb-84e9-024e65b9fc4c