Capítulo 4: Definición de plantillas de servicios de contenido

Última actualización: 2024-01-25
  • Creado para:
  • Beginner
    Developer

AEM AEM AEM El capítulo 4 del tutorial sin encabezado de la cubre la función de las plantillas editables de la aplicación en el contexto de los servicios de contenido de la. AEM AEM Las plantillas editables se utilizan para definir la estructura de contenido JSON que expone Content Services a los clientes a través de la composición de los componentes de contenido habilitados para los servicios de contenido.

AEM Explicación de la función que desempeñan las plantillas en los servicios de contenido de

AEM Las plantillas editables se utilizan para definir los puntos finales HTTP a los que se accede para exponer el contenido del evento como JSON.

AEM Tradicionalmente, las plantillas editables se utilizan para definir páginas web, aunque este uso es simplemente convencional. Las plantillas editables se pueden utilizar para componer cualquiera conjunto de contenido; cómo se accede a ese contenido: como HTML AEM SPA en un explorador, como JSON consumido por JavaScript (Editor de) o una aplicación móvil es una función del modo en que se solicita esa página.

AEM En los servicios de contenido de la, se utilizan plantillas editables para definir cómo se exponen los datos JSON.

Para el WKND Mobile Crearemos una sola plantilla editable que se utiliza para dirigir un único extremo de API. AEM Aunque este ejemplo es sencillo de ilustrar los conceptos de sin encabezado, puede crear varias páginas (o puntos finales), cada una de las cuales expone diferentes conjuntos de contenido para crear una API más compleja y mejor organizada.

Explicación del punto final de la API

Para comprender cómo componer nuestro punto final de API y qué contenido debe exponerse a nuestras WKND Mobile App, vamos a revisar el diseño.

Descomposición de página de API de eventos

Como podemos ver, tenemos tres conjuntos lógicos de contenido para proporcionar a la aplicación móvil.

  1. El Logotipo
  2. El Línea de etiqueta
  3. La lista de Eventos

AEM AEM Para ello, podemos asignar estos requisitos a Componentes de la (y, en nuestro caso, a Componentes principales de WCM) para exponer el contenido requerido como JSON.

  1. El Logotipo se muestra mediante un Componente de imagen
  2. El Línea de etiqueta aparece a través de un Componente Texto
  3. La lista de Eventos aparece a través de un Componente Lista de fragmentos de contenido que, a su vez, hace referencia a un conjunto de Fragmentos de contenido de eventos.
NOTA

AEM Para admitir la exportación de páginas y componentes JSON del servicio de contenido de la, las páginas y los componentes deben AEM derivar de componentes principales de WCM de la.

AEM Componentes principales de WCM tienen funcionalidad integrada para admitir un esquema JSON normalizado de páginas y componentes exportados. AEM Todos los componentes de WKND Mobile utilizados en este tutorial (página, imagen, texto y lista de fragmentos de contenido) se derivan de los componentes principales de WCM de la.

Definición de la plantilla de API de eventos

  1. Vaya a Herramientas > General > Plantillas >WKND Mobile.

  2. Cree el Events API plantilla:

    1. Tocar Crear en la barra de acciones superior
    2. Seleccione el WKND Mobile - Empty Page plantilla
    3. Tocar Siguiente en la barra de acciones superior
    4. Entrar Events API en el Título de plantilla campo
    5. Tocar Crear en la barra de acciones superior
    6. Tocar Abrir abra la nueva plantilla para editarla
  3. AEM En primer lugar, permitimos que los tres componentes identificados en la lista de componentes que necesitamos modelen el contenido editando el Política de la raíz Contenedor de diseño. Asegúrese de que Estructura El modo está activo, seleccione la opción Layout Container [Root] y pulse el botón Política botón.

  4. En Propiedades > Componentes permitidos buscar WKND Mobile. Permitir los siguientes componentes de WKND Mobile grupo de componentes para que se puedan utilizar en Events página de API.

    • WKND Mobile > Image

      • El logotipo de la aplicación
    • WKND Mobile > Text

      • Texto introductorio de la aplicación
    • WKND Mobile > Content Fragment List

      • La lista de categorías de eventos disponibles para su visualización en la aplicación
  5. Pulse el botón Listo marca de verificación en la esquina superior derecha cuando esté completo.

  6. Actualizar la ventana del explorador para ver los Componentes permitidos en el carril izquierdo.

  7. AEM En el buscador Componentes, en el carril izquierdo, arrastre los siguientes componentes de la:

    1. Image para el logotipo
    2. Text para la línea de etiquetas
    3. Content Fragment List para los eventos
  8. Para cada uno de los componentes anteriores, selecciónelos y pulse el botón desbloquear botón.

  9. Sin embargo, asegúrese de que contenedor de diseño es bloqueado para evitar que se agreguen otros componentes o que se eliminen estos tres componentes.

  10. Tocar Información de página > Ver en administración para volver a la WKND Mobile listado de plantillas. Seleccione el recién creado Events API plantilla y pulse Activar en la barra de acciones superior.

NOTA

Observe que los componentes utilizados para mostrar el contenido se añaden a la propia plantilla y se bloquean. Esto sirve para permitir a los autores editar los componentes predefinidos, pero no añadir ni eliminar componentes arbitrariamente, ya que el cambio de la propia API podría romper las suposiciones sobre la estructura JSON y romper las aplicaciones consumidoras. Todas las API deben ser estables.

Pasos siguientes

Si lo desea, instale com.adobe.aem.guides.wknd-mobile.content.chapter-4.zip AEM paquete de contenido en el autor de la mediante AEM Administrador de paquetes. Este paquete contiene las configuraciones y el contenido descritos en este y en los capítulos anteriores del tutorial.

En esta página