Crear fragmentos de contenido
En el capítulo anterior, creó cinco modelos de fragmento de contenido: persona, equipo, ubicación, dirección e información de contacto. Este capítulo le guiará por los pasos para crear fragmentos de contenido basados en esos modelos. También explora cómo crear directivas de carpeta para limitar qué modelos de fragmentos de contenido se pueden utilizar en la carpeta.
Requisitos previos prerequisites
Este documento forma parte de un tutorial de varias partes. Asegúrese de que el capítulo anterior se haya completado antes de continuar con este capítulo.
Objetivos objectives
En este capítulo, aprenderá a:
- Crear carpetas y establecer límites mediante directivas de carpetas
- Cree referencias de fragmento directamente desde el editor de fragmentos de contenido
- Uso de tipos de datos Tab, Date y JSON Object
- Inserte referencias de contenido y fragmentos en el editor de texto multilínea
- Añadir varias referencias de fragmento
- Anidar fragmentos de contenido
Instalación de contenido de muestra sample-content
AEM Instale un paquete de que contenga varias carpetas e imágenes de muestra utilizadas para acelerar el tutorial.
-
AEM En la barra de herramientas, vaya a Herramientas > Implementación > Paquetes para acceder al Administrador de paquetes.
-
Cargue e instale el paquete (archivo zip) descargado en el paso anterior.
Crear carpetas y establecer límites mediante directivas de carpetas
AEM En la página de inicio de la, seleccione Assets > Archivos > WKND Compartido > Inglés. Aquí puede ver las distintas categorías de fragmentos de contenido, incluidas Aventuras y Colaboradores.
Crear carpetas create-folders
Vaya a la carpeta Adventures. Puede ver que ya se han creado carpetas para Equipos y ubicaciones para almacenar fragmentos de contenido de Equipos y ubicaciones.
Cree una carpeta para los fragmentos de contenido de los instructores basada en el modelo de fragmento de contenido de la persona.
-
En la página Aventuras, selecciona Crear > Carpeta en la esquina superior derecha.
-
En el modal Crear carpeta que aparece, escriba "Instructores" en el campo Title. Observe la 's' al final. Los títulos de las carpetas que contienen muchos fragmentos deben ser plural. Seleccione Crear.
Ahora ha creado una carpeta para almacenar los instructores de aventura.
Establecer límites mediante directivas de carpeta
AEM le permite definir permisos y directivas para las carpetas de fragmentos de contenido. Con los permisos, puede conceder acceso a determinadas carpetas solo a determinados usuarios (autores) o grupos de autores. Mediante directivas de carpeta, puede limitar lo que los autores de modelos de fragmentos de contenido pueden utilizar en esas carpetas. En este ejemplo, limitemos una carpeta a los modelos Person e Contact Info. Para configurar una directiva de carpeta:
-
Seleccione la carpeta Instructores que ha creado y, a continuación, seleccione Propiedades en la barra de navegación superior.
-
Seleccione la ficha Políticas y, a continuación, anule la selección de Heredadas de /content/dam/wknd-shared. En el campo Modelos de fragmento de contenido permitidos por ruta, seleccione el icono de carpeta.
-
En el cuadro de diálogo Seleccionar ruta que se abre, siga la ruta conf > WKND compartido. El modelo de fragmento de contenido de persona, creado en el capítulo anterior, contiene una referencia al modelo de fragmento de contenido de información de contacto. Los modelos de persona e información de contacto deben estar permitidos en la carpeta Instructores para crear un fragmento de contenido de instructor. Seleccione Persona y Información de contacto; a continuación, presione Seleccionar para cerrar el cuadro de diálogo.
-
Seleccione Guardar y cerrar y seleccione Aceptar en el cuadro de diálogo de éxito que aparece.
-
Ahora ha configurado una directiva de carpeta para la carpeta Instructores. Vaya a la carpeta Instructores y seleccione Crear > Fragmento de contenido. Los únicos modelos que puedes seleccionar ahora son Persona y Información de contacto.
Crear fragmentos de contenido para instructores
Vaya a la carpeta Instructores. A partir de aquí, vamos a crear una carpeta anidada para almacenar la información de contacto de los instructores.
Siga los pasos descritos en la sección de creación de carpetas para crear una carpeta denominada "Información de contacto". La carpeta anidada hereda las directivas de carpeta de la carpeta principal. No dude en configurar directivas más específicas para que la carpeta recién creada solo permita utilizar el modelo Información de contacto.
Crear un fragmento de contenido de instructor
Vamos a crear cuatro personas que se puedan añadir a un equipo de instructores de aventura.
-
Desde la carpeta Instructores, cree un fragmento de contenido basado en el modelo de fragmento de contenido de persona y asígnele el título "Jacob Wester".
El fragmento de contenido recién creado tiene el siguiente aspecto:
-
Introduzca el siguiente contenido en los campos:
- Nombre completo: Jacob Wester
- Biografía: Jacob Wester ha sido instructor de caminatas por diez años y le ha encantado cada minuto de ella. Jacob es un buscador de aventuras con un talento para la escalada en roca y el mochilero. Jacob es el ganador de las competiciones de escalada, incluyendo la competición de escalada de la Batalla de la Bahía. Jacob vive actualmente en California.
- Nivel de experiencia del instructor: experto
- Habilidades: Escalada en roca, Surf, Mochilero
- Detalles del administrador: Jacob Wester ha estado coordinando aventuras de mochilero durante tres años.
-
En el campo Imagen de perfil, agregue una referencia de contenido a una imagen. Vaya a WKND compartido > Inglés > Colaboradores > jacob_wester.jpg para crear una ruta a la imagen.
Crear una referencia de fragmento desde el editor de fragmentos de contenido fragment-reference-from-editor
AEM le permite crear una referencia de fragmento directamente desde el editor de fragmentos de contenido. Vamos a crear una referencia a la información de contacto de Jacob.
-
Seleccione Nuevo fragmento de contenido debajo del campo Información de contacto.
-
Se abre el modal Nuevo fragmento de contenido. En la ficha Seleccionar destino, siga la ruta Aventuras > Instructores y marque la casilla que hay junto a la carpeta Información de contacto. Seleccione Siguiente para continuar a la ficha Propiedades.
-
En la ficha Propiedades, escriba "Jacob Wester Contact Info" en el campo Título. Seleccione Crear y, a continuación, presione Abrir en el cuadro de diálogo de éxito que aparece.
Aparecen nuevos campos que le permiten editar el fragmento de contenido de información de contacto.
-
Introduzca el siguiente contenido en los campos:
- Teléfono: 209-888-0000
- Correo electrónico: jwester@wknd.com
Cuando termine, seleccione Guardar. Ahora ha creado un fragmento de contenido de información de contacto.
-
Para volver al fragmento de contenido del instructor, seleccione Jacob Wester en la esquina superior izquierda del editor.
El campo Información de contacto ahora contiene la ruta al fragmento de información de contacto al que se hace referencia. Es una referencia de fragmento anidada. El fragmento de contenido del instructor terminado tiene este aspecto:
-
Seleccione Guardar y cerrar para guardar el fragmento de contenido. Ahora tiene un nuevo fragmento de contenido de instructor.
Creación de fragmentos adicionales
Siga el mismo proceso que se describe en la sección anterior para crear tres fragmentos de contenido de instructores más y tres fragmentos de contenido de información de contacto para estos instructores. Añada el siguiente contenido en los fragmentos de Instructores:
Stacey Roswells
Kumar Selvaraj
Ayo Ogunseinde
Deje vacío el campo Información adicional.
Agregue la siguiente información en los fragmentos de Información de contacto:
Ya está listo para crear un equipo.
Crear fragmentos de contenido para ubicaciones
Vaya a la carpeta Ubicaciones. Aquí puede ver dos carpetas anidadas que ya se han creado: Yosemite National Park y Yosemite Valley Lodge.
Ignora la carpeta Yosemite Valley Lodge por ahora. Volvemos más adelante en esta sección cuando creamos una ubicación que actúa como base principal para nuestro equipo de instructores.
Vaya a la carpeta Parque Nacional Yosemite. Actualmente, solo contiene una foto del Parque Nacional Yosemite. Vamos a crear un fragmento de contenido utilizando el Modelo de fragmento de contenido de ubicación y ponerle el título "Parque nacional Yosemite".
Marcadores de pestaña
AEM le permite usar marcadores de posición de pestañas para agrupar diferentes tipos de contenido y facilitar la lectura y administración de los fragmentos de contenido. En el capítulo anterior, agregó marcadores de posición de tabulación al modelo Ubicación. Como resultado, el fragmento de contenido de ubicación ahora tiene dos secciones de pestañas: Detalles de ubicación y Dirección de ubicación.
La pestaña Detalles de ubicación contiene los campos Nombre, Descripción, Información de contacto, Imagen de ubicación y Tiempo por temporada, mientras que la pestaña Dirección de ubicación contiene una referencia a un fragmento de contenido de dirección. Las pestañas dejan claro qué tipos de contenido se deben rellenar, por lo que la creación de contenido es más fácil de administrar.
Tipo de datos de objeto JSON
El campo Tiempo por temporada es un tipo de datos de objeto JSON, lo que significa que acepta datos en formato JSON. Este tipo de datos es flexible y se puede utilizar para cualquier dato que desee incluir en el contenido.
Puede ver la descripción del campo que se creó en el capítulo anterior pasando el puntero sobre el icono de información a la derecha del campo.
En este caso, tenemos que proporcionar el tiempo promedio para la ubicación. Introduzca los datos siguientes:
{
"summer": "81 / 89°F",
"fall": "56 / 83°F",
"winter": "46 / 51°F",
"spring": "57 / 71°F"
}
El campo Tiempo por temporada debería tener este aspecto:
Añadir contenido
Añadamos el resto del contenido al fragmento de contenido de ubicación para consultar la información con GraphQL en el capítulo siguiente.
-
En la ficha Detalles de ubicación, escriba la siguiente información en los campos:
- Nombre: Parque Nacional Yosemite
- Descripción: El Parque Nacional Yosemite está en las montañas de Sierra Nevada en California. Es famosa por sus hermosas cascadas, secuoyas gigantes y vistas icónicas de El Capitán y los acantilados de Media Cúpula. Caminar y acampar son las mejores formas de experimentar Yosemite. Numerosos senderos ofrecen infinitas oportunidades para la aventura y la exploración.
-
En el campo Información de contacto, cree un fragmento de contenido basado en el modelo Información de contacto y asígnele el título "Información de contacto del Parque nacional Yosemite". Siga el mismo proceso como se describe en la sección anterior sobre creación de una referencia de fragmento desde el editor e introduzca los siguientes datos en los campos:
- Teléfono: 209-999-0000
- Correo electrónico: yosemite@wknd.com
-
En el campo Imagen de ubicación, vaya a Aventuras > Ubicaciones > Parque Nacional Yosemite > yosemite-national-park.jpeg para crear una ruta a la imagen.
Recuerde, en el capítulo anterior configuró la validación de imágenes, por lo que las dimensiones de la imagen de ubicación deben ser inferiores a 2560 x 1800 y su tamaño de archivo debe ser inferior a 3 MB.
-
Con toda la información agregada, la ficha Detalles de ubicación ahora tiene este aspecto:
-
Vaya a la ficha Dirección de ubicación. En el campo Dirección, cree un fragmento de contenido titulado "Dirección del parque nacional de Yosemite" usando el modelo de fragmento de contenido de dirección que creó en el capítulo anterior. Siga el mismo proceso que se describe en la sección de creación de una referencia de fragmento desde el editor e introduzca los siguientes datos en los campos:
- Dirección: 9010 Curry Village Drive
- Ciudad: Yosemite Valley
- Estado: CA
- Código postal: 95389
- País: Estados Unidos
-
La ficha Dirección de ubicación del fragmento del Parque Nacional Yosemite tiene el siguiente aspecto:
-
Seleccione Guardar y cerrar.
Crear un fragmento más
-
Vaya a la carpeta Yosemite Valley Lodge. Cree un fragmento de contenido con el modelo de fragmento de contenido de ubicación y asígnele el título "Yosemite Valley Lodge".
-
En la ficha Detalles de ubicación, escriba la siguiente información en los campos:
- Nombre: Yosemite Valley Lodge
- Descripción: Yosemite Valley Lodge es un centro para reuniones de grupos y todo tipo de actividades, como ir de compras, cenar, pescar, hacer caminatas y mucho más.
-
En el campo Información de contacto, cree un fragmento de contenido basado en el modelo Información de contacto y asígnele el título "Información de contacto de Yosemite Valley Lodge". Siga el mismo proceso que se describe en la sección de creación de una referencia de fragmento desde el editor e introduzca los siguientes datos en los campos del nuevo fragmento de contenido:
- Teléfono: 209-992-0000
- Correo electrónico: yosemitelodge@wknd.com
Guarde el fragmento de contenido recién creado.
-
Vuelva a Yosemite Valley Lodge y vaya a la ficha Dirección de ubicación. En el campo Dirección, cree un fragmento de contenido titulado "Dirección de alojamiento de Yosemite Valley" utilizando el modelo de fragmento de contenido de dirección que creó en el capítulo anterior. Siga el mismo proceso que se describe en la sección de creación de una referencia de fragmento desde el editor e introduzca los siguientes datos en los campos:
- Dirección: 9006 Yosemite Lodge Drive
- Ciudad: Parque Nacional Yosemite
- Estado: CA
- Código postal: 95389
- País: Estados Unidos
Guarde el fragmento de contenido recién creado.
-
Vaya de nuevo a Yosemite Valley Lodge y luego seleccione Guardar y cerrar. La carpeta Yosemite Valley Lodge ahora contiene tres fragmentos de contenido: Yosemite Valley Lodge, Información de contacto de Yosemite Valley Lodge y Dirección de Yosemite Valley Lodge.
Crear un fragmento de contenido de equipo
Examine carpetas para Equipos > Equipo de Yosemite. Puede ver que la carpeta Equipo de Yosemite actualmente solo contiene el logotipo del equipo.
Vamos a crear un fragmento de contenido utilizando el Modelo de fragmento de contenido de equipo y ponerle el título "Equipo de Yosemite".
Referencias de contenido y fragmentos en el editor de texto multilínea
AEM le permite añadir contenido y referencias de fragmento directamente en el editor de texto multilínea y recuperarlas más tarde mediante consultas de GraphQL. Vamos a agregar referencias de contenido y fragmento al campo Descripción.
-
Primero, agregue el siguiente texto al campo Descripción: "El equipo de aventureros profesionales e instructores de senderismo que trabajan en el Parque Nacional Yosemite".
-
Para agregar una referencia de contenido, seleccione el icono Insertar recurso en la barra de herramientas del editor de texto multilínea.
-
En el modal que aparece, selecciona team-yosemite-logo.png y pulsa Seleccionar.
La referencia de contenido ahora se agrega al campo Descripción.
Recuerde que en el capítulo anterior permitió que se agregaran referencias de fragmento al campo Descripción. Vamos a añadir uno aquí.
-
Seleccione el icono Insertar fragmento de contenido en la barra de herramientas del editor de texto multilínea.
-
Vaya a WKND Shared > Inglés > Aventuras > Ubicaciones > Yosemite Valley Lodge > Yosemite Valley Lodge. Pulse Seleccionar para insertar el fragmento de contenido.
El campo Descripción tiene el siguiente aspecto:
Ahora ha agregado las referencias de contenido y fragmento directamente al editor de texto multilínea.
Tipo de datos de fecha y hora
Veamos el tipo de datos Fecha y hora. Seleccione el icono Calendario a la derecha del campo Fecha de fundación del equipo para abrir la vista de calendario.
Las fechas pasadas o futuras se pueden establecer utilizando las flechas hacia delante y hacia atrás a ambos lados del mes. Digamos que el equipo de Yosemite fue fundado el 24 de mayo de 2016, así que fijaremos la fecha para entonces.
Añadir varias referencias de fragmento
Añadamos Instructores a la referencia de fragmento de miembros del equipo.
-
Seleccione Agregar en el campo Integrantes del equipo.
-
En el nuevo campo que aparece, seleccione el icono de carpeta para abrir el modal Select Path. Examine las carpetas para WKND Shared > English > Adventures > Instructores y, a continuación, seleccione la casilla de verificación que hay junto a jacob-wester. Pulse Seleccionar para guardar la ruta.
-
Seleccione el botón Agregar tres veces más. Utilice los nuevos campos para añadir los tres instructores restantes al equipo. El campo Miembros del equipo tiene este aspecto:
-
Seleccione Guardar y cerrar para guardar el fragmento de contenido del equipo.
Añadir referencias de fragmento a un fragmento de contenido de aventura
Por último, vamos a añadir los fragmentos de contenido recién creados a una aventura.
-
Vaya a Aventuras > Mochilero Yosemite y abra el fragmento de contenido de mochilero Yosemite. En la parte inferior del formulario, puede ver los tres campos que creó en el capítulo anterior: Ubicación, Equipo del instructor y Administrador.
-
Agregue la referencia de fragmento en el campo Ubicación. La ruta de ubicación debe hacer referencia al fragmento de contenido del Parque Nacional Yosemite que ha creado:
/content/dam/wknd-shared/en/adventures/locations/yosemite-national-park/yosemite-national-park. -
Agregue la referencia de fragmento en el campo Equipo de instructores. La ruta de acceso del equipo debe hacer referencia al fragmento de contenido de Yosemite Team que ha creado:
/content/dam/wknd-shared/en/adventures/teams/yosemite-team/yosemite-team. Es una referencia de fragmento anidada. El fragmento de contenido de equipo contiene una referencia al modelo de persona que hace referencia a los modelos de dirección e información de contacto. Por lo tanto, tiene fragmentos de contenido anidados tres niveles por debajo. -
Agregue la referencia de fragmento en el campo Administrador. Digamos que Jacob Wester es administrador de la aventura de mochileros de Yosemite. La ruta debe llevar al fragmento de contenido Jacob Wester y aparecer de la siguiente manera:
/content/dam/wknd-shared/en/adventures/instructors/jacob-wester. -
Ahora ha agregado tres referencias de fragmento a un fragmento de contenido de aventura. Los campos tienen este aspecto:
-
Seleccione Guardar y cerrar para guardar el contenido.
Enhorabuena.
Enhorabuena. Ahora ha creado fragmentos de contenido basados en los modelos de fragmentos de contenido avanzados creados en el capítulo anterior. También ha creado una directiva de carpeta para limitar qué modelos de fragmentos de contenido se pueden seleccionar dentro de una carpeta.
Pasos siguientes
En el capítulo siguiente, aprenderá a enviar consultas de GraphQL avanzadas mediante el entorno de desarrollo integrado (IDE) de GraphiQL. Estas consultas nos permiten ver los datos creados en este capítulo y, finalmente, añadir estas consultas a la aplicación WKND.