Capítulo 2 - Utilização de modelos de fragmento de conteúdo

Última atualização em 2023-05-20
  • Tópicos
  • Content Fragments
    Exibir mais informações sobre este tópico
  • APIs
    Exibir mais informações sobre este tópico
  • Criado para:
  • Beginner
    Developer

Os modelos de fragmento de conteúdo do AEM definem esquemas de conteúdo que podem ser usados para modelar a criação de conteúdo bruto por autores do AEM. Essa abordagem é semelhante à criação em andaime ou baseada em formulários. O conceito principal com Fragmentos de conteúdo é que o conteúdo criado é independente de apresentação, o que significa que ele é destinado ao uso em vários canais, onde o aplicativo de consumo, seja o AEM, um aplicativo de página única ou um aplicativo móvel, controla como o conteúdo é exibido ao usuário.

A principal preocupação do fragmento de conteúdo é garantir:

  1. O conteúdo correto é coletado do autor
  2. O conteúdo pode ser exposto em um formato estruturado e bem compreendido a aplicativos de consumo.

Este capítulo aborda a ativação e a definição dos modelos de fragmento de conteúdo usados para definir uma estrutura de dados normalizada e uma interface de criação para modelagem e criação de "Eventos".

Ativar modelos de fragmento de conteúdo

Modelos de fragmentos do conteúdo deve ser ativado via AEM Navegador de configuração.

Se os modelos de fragmento de conteúdo forem não ativado para uma configuração, a variável Criar > Fragmento do conteúdo O botão não será exibido para a configuração relevante do AEM.

OBSERVAÇÃO

As configurações de AEM representam um conjunto de configurações de locatários com reconhecimento de contexto armazenado em /conf. Normalmente, as configurações do AEM estão correlacionadas a um site específico gerenciado no AEM Sites ou a uma unidade de negócios responsável por um subconjunto de conteúdo (ativos, páginas etc.) no AEM.

Para que uma configuração afete uma hierarquia de conteúdo, a configuração deve ser referenciada por meio do cq:conf nessa hierarquia de conteúdo. (Isso é feito para o WKND Mobile configuração no Etapa 5 abaixo).

Quando a variável global for usada, a configuração se aplicará a todo o conteúdo e cq:conf não precisa ser definido.

Consulte a Navegador de configuração documentação para obter mais informações.

  1. Faça logon no AEM Author como um usuário com as permissões apropriadas para modificar a configuração relevante.

    • Para este tutorial, a variável administrador usuário pode ser usado.
  2. Navegue até Ferramenta > Geral > Navegador de configuração

  3. Toque no ícone de pasta ao lado de WKND Mobile para selecionar e, em seguida, toque no Editar botão no canto superior esquerdo.

  4. Selecionar Modelos de fragmentos do conteúdo e toque em Salvar e fechar no canto superior direito.

    Isso ativa a criação de modelos de fragmento de conteúdo em árvores de conteúdo da pasta de ativos que têm o WKND Mobile configuração aplicada.

    OBSERVAÇÃO

    Essa alteração de configuração não é reversível do Configuração do AEM Interface da Web. Para desfazer essa configuração:

    1. Abertura [CRXDE Lite](http://localhost:4502/crx/de)
    1. Vá até `/conf/wknd-mobile/settings/dam/cfm`
    1. Exclua o `models` nó
    

    Todos os modelos de fragmento de conteúdo existentes criados nessa configuração são excluídos, bem como suas definições são armazenadas em /conf/wknd-mobile/settings/dam/cfm/models.

  5. Aplique o WKND Mobile configuração para o WKND MobilePasta de ativos para permitir que fragmentos de conteúdo de modelos de fragmento de conteúdo sejam criados nessa hierarquia de pastas de ativos:

    1. Navegue até AEM > Assets > Arquivos
    2. Selecione o WKND Mobile pasta
    3. Toque no Propriedades botão na barra de ação superior para abrir Propriedades da pasta
    4. Entrada Propriedades da pasta, toque na guia Cloud Services guia
    5. Verifique se Configuração na nuvem o campo está definido como /conf/wknd-mobile
    6. Toque Salvar e fechar no canto superior direito para continuar com as alterações
AVISO

Modelos de fragmentos do conteúdo moveram-se de Ferramentas > Ativos para Ferramentas > Geral.

Noções básicas sobre o modelo de fragmento de conteúdo para criação

Antes de definir nosso modelo de Fragmento de conteúdo, vamos analisar a experiência que conduziremos para garantir que capturemos todos os pontos de dados necessários. Para isso, analisaremos o design de aplicativos móveis e mapearemos os elementos de design para o conteúdo a ser coletado.

Podemos dividir os pontos de dados que definem um Evento da seguinte maneira:

Criação do modelo de fragmento de conteúdo

De posse do mapeamento, podemos definir os Fragmentos de conteúdo usados para coletar e, por fim, expor os dados do evento.

Criação do modelo de fragmento de conteúdo

  1. Navegue até Ferramentas > Geral > Modelos de fragmentos do conteúdo.
  2. Toque no WKND Mobile pasta a ser aberta.
  3. Toque Criar para abrir o assistente de criação do modelo de fragmento de conteúdo.
  4. Enter Event como o Título do modelo (a descrição é opcional) e toque em Criar para salvar.

Definição da estrutura do modelo de fragmento de conteúdo

  1. Navegue até Ferramentas > Geral > Modelos de fragmentos do conteúdo >WKND.

  2. Selecione o Event Modelo de fragmento de conteúdo e toque em Editar na barra de ação superior.

  3. No Tipos de dados guia à direita, arraste o Entrada de texto em linha única na área à esquerda para definir o Question campo.

  4. Garanta a nova Entrada de texto em linha única está selecionada à esquerda e a variável Propriedades guia está selecionada à direita. Preencha os campos Propriedades da seguinte maneira:

    • Renderizar como : textfield
    • Rótulo do campo : Event Title
    • Nome da Propriedade : eventTitle
    • Comprimento máximo : 25
    • Obrigatório : Yes

Repita essas etapas usando as definições de entrada definidas abaixo para criar o restante do modelo de fragmento de conteúdo do evento.

OBSERVAÇÃO

A variável Nome da propriedade Os campos DEVEM corresponder exatamente, pois o aplicativo Android está programado para apagar esses nomes.

Descrição de evento

  • Tipo de dados : Multi-line text
  • Rótulo do campo : Event Description
  • Nome da Propriedade : eventDescription
  • Tipo padrão : Rich text

Data e hora do evento

  • Tipo de dados : Date and time
  • Rótulo do campo : Event Date and Time
  • Nome da Propriedade : eventDateAndTime
  • Obrigatório : Yes

Tipo de evento

  • Tipo de dados : Enumeration
  • Rótulo do campo : Event Type
  • Nome da Propriedade : eventType
  • Opções : Art,Music,Performance,Photography

Preço do tíquete

  • Tipo de dados : Number
  • Renderizar como : numberfield
  • Rótulo do campo : Ticket Price
  • Nome da Propriedade : eventPrice
  • Tipo : Integer
  • Obrigatório : Yes

Imagem do evento

  • Tipo de dados : Content Reference
  • Renderizar como : contentreference
  • Rótulo do campo : Event Image
  • Nome da Propriedade : eventImage
  • Caminho raiz : /content/dam/wknd-mobile/images
  • Obrigatório : Yes

Nome do local

  • Tipo de dados : Single-line text
  • Renderizar como : textfield
  • Rótulo do campo : Venue Name
  • Nome da Propriedade : venueName
  • Comprimento máximo : 20
  • Obrigatório : Yes

Cidade do local

  • Tipo de dados : Enumeration
  • Rótulo do campo : Venue City
  • Nome da Propriedade : venueCity
  • Opções : Basel,London,Los Angeles,Paris,New York,Tokyo
OBSERVAÇÃO

A variável Nome da propriedade denota o ambos o nome da propriedade JCR em que esse valor é armazenado, bem como a chave no arquivo JSON. Esse deve ser um nome semântico que não será alterado durante a vida útil do modelo de fragmento de conteúdo.

Depois de concluir a criação do modelo de fragmento de conteúdo, você deve obter uma definição que se parece com:

Modelo de fragmento do conteúdo do evento

Próxima etapa

Como opção, instale o com.adobe.aem.guides.wknd-mobile.content.chapter-2.zip pacote de conteúdo no AEM Author via Gerenciador de pacotes AEM. Este pacote contém as configurações e o conteúdo descritos nesta parte do tutorial.

Nesta página