Capítulo 2 - Uso de modelos de fragmento de conteúdo

AEM Modelos de fragmento de conteúdo define esquemas de conteúdo que podem ser usados para modelar a criação de conteúdo bruto por autores AEM. Essa abordagem é semelhante ao scaffolding ou à criação 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 se destina ao uso de vários canais, onde o aplicativo de consumo, seja 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 ao consumo de aplicativos.

Este capítulo aborda a ativação e 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

Os Modelos de fragmento de conteúdo devem ser ativados por AEM Navegador de configuração.

Se os Modelos de fragmento de conteúdo forem not ativados para uma configuração, o botão Criar > Fragmento de conteúdo não aparecerá para a configuração de AEM relevante.

OBSERVAÇÃO

AEM configurações representam um conjunto de configurações de locatários com reconhecimento de contexto armazenadas em /conf. Normalmente, AEM configurações se correlacionam a um site específico gerenciado no AEM Sites ou a uma unidade comercial responsável por um subconjunto de conteúdo (ativos, páginas etc.) em AEM.

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

Quando a configuração global é usada, a configuração se aplica a todo o conteúdo e cq:conf não precisa ser definida.

Consulte a documentação Navegador de configuraçã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, o usuário admin 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 toque no botão Editar no canto superior esquerdo.

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

    Isso ativa os Modelos de fragmento de conteúdo nas árvores de conteúdo da pasta de ativos com a configuração WKND Mobile aplicada.

    OBSERVAÇÃO

    Essa alteração de configuração não é reversível da interface do usuário da Web AEM Configuration. Para desfazer essa configuração:

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

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

  5. Aplique a configuração WKND Mobile à pasta WKND MobileAtivos para permitir que os Fragmentos de conteúdo dos Modelos de fragmento de conteúdo sejam criados na hierarquia da pasta Ativos:

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

Noções básicas do modelo de fragmento de conteúdo para criar

Antes de definir o modelo de Fragmento de conteúdo, vamos rever a experiência que estaremos conduzindo para garantir que estamos capturando todos os pontos de dados necessários. Para isso, analisaremos o design dos aplicativos móveis e mapearemos os elementos do design para o conteúdo coletado.

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

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

Munido do mapeamento, podemos definir o Fragmento do conteúdo que será usado para coletar e, em última análise, expor os dados do Evento.

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

  1. Navegue até Ferramentas > Ativos > Modelos de fragmento de conteúdo.
  2. Toque na pasta WKND Mobile para abrir.
  3. Toque em Criar para abrir o assistente de criação do Modelo de fragmento de conteúdo.
  4. Insira 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 > Ativos > Modelos de fragmento de conteúdo >WKND.

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

  3. Na guia Data Types à direita, arraste Single line text input para a zona suspensa esquerda para definir o campo Question.

  4. Verifique se a nova Single line text input está selecionada à esquerda e se a Properties tab está selecionada à direita. Preencha os campos Propriedades da seguinte maneira:

    • Renderizar como : textfield
    • Rótulo do campo : Event Title
    • Nome da Propriedade : eventTitle
    • Extensão Máx.: 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

Os campos Nome da propriedade DEVEM corresponder exatamente, pois o aplicativo Android é programado para destacar 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
  • Extensão Máx.: 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

O Nome da propriedade indica o ambos nome da propriedade JCR onde esse valor será 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.

Após concluir a criação do Modelo do fragmento de conteúdo, você deve acabar com uma definição que se parece com:

Modelo de fragmento do conteúdo do evento

Próxima etapa

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

Nesta página