Capítulo 2 - Uso de modelos de fragmento de contenido

AEM modelos de fragmento de contenido definen esquemas de contenido que se pueden usar para crear plantillas de la creación de contenido sin procesar por parte de AEM autores. Este método es similar al scaffolding o a la creación basada en formularios. El concepto clave con los fragmentos de contenido es que el contenido creado no depende de la presentación, lo que significa que está pensado para un uso multicanal en el que la aplicación que lo consume, ya sea AEM, una aplicación de una sola página o una aplicación móvil, controle cómo se muestra el contenido al usuario.

La principal preocupación del fragmento de contenido es garantizar:

  1. El contenido correcto se recopila del autor
  2. El contenido se puede exponer en un formato estructurado y bien entendido a aplicaciones consumidoras.

Este capítulo trata sobre la activación y definición de modelos de fragmento de contenido utilizados para definir una estructura de datos normalizada y una interfaz de creación para modelar y crear "Eventos".

Habilitar modelos de fragmento de contenido

Los modelos de fragmento de contenido deben habilitarse mediante AEM Explorador de configuración.

Si los modelos de fragmento de contenido no están habilitados para una configuración, el botón Crear > Fragmento de contenido no aparecerá para la configuración de AEM pertinente.

NOTA

AEM configuraciones representan un conjunto de configuraciones de inquilino según el contexto almacenadas en /conf. Normalmente, las configuraciones de AEM se correlacionan con un sitio web concreto administrado en AEM Sites o con una unidad de negocio responsable de un subconjunto de contenido (activos, páginas, etc.) en AEM.

Para que una configuración afecte a una jerarquía de contenido, se debe hacer referencia a la configuración a través de la propiedad cq:conf en esa jerarquía de contenido. (Esto se logra para la configuración WKND Mobile en Paso 5 a continuación).

Cuando se utiliza la configuración global, la configuración se aplica a todo el contenido y no es necesario configurar cq:conf.

Consulte la documentación Configuration Browser para obtener más información.

  1. Inicie sesión en AEM Author como usuario con los permisos adecuados para modificar la configuración relevante.

    • Para este tutorial, se puede utilizar el usuario admin .
  2. Vaya a Herramienta > General > Explorador de configuración

  3. Pulse el icono de carpeta situado junto a WKND Mobile para seleccionarlo y, a continuación, pulse el botón Editar en la parte superior izquierda.

  4. Seleccione Modelos de fragmento de contenido y pulse Guardar y cerrar en la parte superior derecha.

    Esto habilita los modelos de fragmento de contenido en árboles de contenido de carpetas de recursos que tienen aplicada la configuración WKND Mobile .

    NOTA

    Este cambio de configuración no es reversible desde la interfaz de usuario web AEM Configuration. Para deshacer esta configuración:

    1. Abra CRXDE Lite
    2. Ir a /conf/wknd-mobile/settings/dam/cfm
    3. Eliminar el nodo models

    Cualquier modelo de fragmento de contenido existente creado con esta configuración se eliminará, así como sus definiciones se almacenarán en /conf/wknd-mobile/settings/dam/cfm/models.

  5. Aplique la configuración WKND Mobile a la WKND Mobilecarpeta de recursos para permitir que los fragmentos de contenido de los modelos de fragmento de contenido se creen dentro de esa jerarquía de carpetas de recursos:

    1. Vaya a AEM > Assets > Archivos
    2. Seleccione la carpeta WKND Mobile
    3. Pulse el botón Properties en la barra de acciones superior para abrir Folder Properties
    4. En Propiedades de carpeta, pulse la pestaña Cloud Services
    5. Compruebe que el campo Cloud Configuration está configurado en /conf/wknd-mobile
    6. Toque Guardar y cerrar en la esquina superior derecha para mantener los cambios

Explicación del modelo de fragmento de contenido que se va a crear

Antes de definir el modelo de fragmento de contenido, vamos a revisar la experiencia que vamos a generar para asegurarnos de que estamos capturando todos los puntos de datos necesarios. Para ello, analizaremos el diseño de las aplicaciones móviles y asignaremos los elementos de diseño al contenido que se va a recopilar.

Podemos dividir los puntos de datos que definen un evento de la siguiente manera:

Creación del modelo de fragmento de contenido

Con la asignación podemos definir el fragmento de contenido que se utilizará para recopilar y, en última instancia, exponer los datos de evento.

Creación del modelo de fragmento de contenido

  1. Vaya a Herramientas > Recursos > Modelos de fragmento de contenido.
  2. Pulse la carpeta WKND Mobile para abrirla.
  3. Pulse Crear para abrir el asistente de creación del modelo de fragmento de contenido.
  4. Introduzca Event como Model Title (la descripción es opcional) y pulse Create para guardar.

Definición de la estructura del modelo de fragmento de contenido

  1. Vaya a Herramientas > Recursos > Modelos de fragmento de contenido >WKND.

  2. Seleccione el Modelo de fragmento de contenido Event y pulse Editar en la barra de acciones superior.

  3. En la pestaña Data Types de la derecha, arrastre el Single line text input a la zona desplegable izquierda para definir el campo Question.

  4. Asegúrese de que la nueva Entrada de texto de una sola línea está seleccionada a la izquierda y la pestaña está seleccionada a la derecha. Rellene los campos Propiedades como se indica a continuación:

    • Procesar como : textfield
    • Etiqueta de campo : Event Title
    • Nombre de propiedad : eventTitle
    • Longitud máxima: 25
    • Requerido : Yes

Repita estos pasos utilizando las definiciones de entrada definidas a continuación para crear el resto del Modelo de fragmento de contenido de evento.

NOTA

Los campos Property Name DEBEN coincidir exactamente, ya que la aplicación de Android está programada para eliminar la clave de estos nombres.

Descripción del evento

  • Tipo de datos : Multi-line text
  • Etiqueta de campo : Event Description
  • Nombre de propiedad : eventDescription
  • Tipo predeterminado : Rich text

Fecha y hora del evento

  • Tipo de datos : Date and time
  • Etiqueta de campo : Event Date and Time
  • Nombre de propiedad : eventDateAndTime
  • Requerido : Yes

Tipo de evento

  • Tipo de datos : Enumeration
  • Etiqueta de campo : Event Type
  • Nombre de propiedad : eventType
  • Opciones : Art,Music,Performance,Photography

Precio de entrada

  • Tipo de datos : Number
  • Procesar como : numberfield
  • Etiqueta de campo : Ticket Price
  • Nombre de propiedad : eventPrice
  • Tipo : Integer
  • Requerido : Yes

Imagen del evento

  • Tipo de datos : Content Reference
  • Procesar como : contentreference
  • Etiqueta de campo : Event Image
  • Nombre de propiedad : eventImage
  • Ruta de acceso raíz : /content/dam/wknd-mobile/images
  • Requerido : Yes

Nombre del lugar

  • Tipo de datos : Single-line text
  • Procesar como : textfield
  • Etiqueta de campo : Venue Name
  • Nombre de propiedad : venueName
  • Longitud máxima: 20
  • Requerido : Yes

Ciudad del lugar

  • Tipo de datos : Enumeration
  • Etiqueta de campo : Venue City
  • Nombre de propiedad : venueCity
  • Opciones : Basel,London,Los Angeles,Paris,New York,Tokyo
NOTA

El Nombre de propiedad denota el ambos nombre de propiedad JCR donde se almacenará este valor, así como la clave en el archivo JSON . Debe ser un nombre semántico que no cambie durante la vida del modelo de fragmento de contenido.

Después de completar la creación del modelo de fragmento de contenido, debe terminar con una definición similar a:

Modelo de fragmento de contenido de evento

Paso siguiente

Opcionalmente, instale el paquete de contenido com.adobe.aem.guides.wknd-mobile.content.chapter-2.zip en AEM Author a través del Administrador de paquetes AEM. Este paquete contiene las configuraciones y el contenido descritos en esta parte del tutorial.

En esta página