Trabajar con fragmentos de contenido working-with-content-fragments
Con Adobe Experience Manager AEM () as a Cloud Service, los fragmentos de contenido le permiten diseñar, crear, depurar y publicar contenido independiente de cualquier página. Permiten preparar contenido listo para usar en varias ubicaciones/en varios canales, lo que resulta ideal para la entrega sin encabezado. También se pueden usar junto con Administración de varios sitios para permitirle reutilizar su contenido.
Los fragmentos de contenido incluyen contenido estructurado:
-
Se basan en un Modelo de fragmento de contenido, que predefine una estructura para el fragmento resultante.
-
La estructura puede variar entre lo siguiente:
-
Básico
- Por ejemplo, un campo de texto de varias líneas.
- Se puede utilizar para preparar contenido directo para su uso en la creación de páginas.
-
Complejo
- Una combinación de muchos campos de diferentes tipos de datos, incluidos texto, número, booleano, datos y tiempo, entre otros.
- Se puede utilizar para preparar contenido más estructurado para la creación de páginas o para su entrega a la aplicación.
-
Anidado
- Los tipos de datos de referencia disponibles le permiten anidar el contenido.
- Tiende a utilizarse para su entrega a la aplicación.
-
Los fragmentos de contenido también se pueden entregar en formato JSON, utilizando las capacidades de exportación del Modelo Sling (JSON) de los componentes principales de AEM. Esta forma de entrega:
- permite utilizar el componente para administrar qué elementos enviar de un fragmento.
- permite la entrega por lotes, añadiendo varios componentes principales de fragmento de contenido en la página que se utiliza para la entrega de API.
Esta y las siguientes páginas tratan sobre las tareas para crear, configurar, mantener y utilizar sus fragmentos de contenido:
- Habilitación de la funcionalidad de fragmento de contenidos para la instancia
- Modelos de fragmentos de contenido: habilitando, creando y definiendo sus modelos
- Administración de fragmentos de contenido: cree sus fragmentos de contenido; a continuación, edite, publique y haga referencias
- Variaciones, creación de contenido de fragmentos: cree el contenido del fragmento y variaciones del principal
- Markdown: uso de la sintaxis de markdown para el fragmento
- Uso de contenido asociado: añadir contenido asociado
- Metadatos, propiedades del fragmento: visualización y edición de las propiedades del fragmento
- Use Fragmentos de contenido, junto con GraphQL, para poder entregar contenido para su uso en aplicaciones. Para ayudarle con esto, puede obtener una vista previa de salida JSON.
- Reutilización de fragmentos de contenido mediante MSM
- Creación de páginas con fragmentos de contenido.
- Personalizar y ampliar fragmentos de contenido
- Fragmentos de contenido Configurar componentes para procesamiento
- Compatibilidad con fragmentos de contenido en la API HTTP de AEM Assets
- API de GraphQL de AEM para su uso con fragmentos de contenido
- Las API abiertas del modelo de fragmento de contenido y fragmento de contenido
El número de canales de comunicación aumenta de forma anual. Normalmente, los canales hacen referencia al mecanismo de entrega, ya sea como los siguientes:
- Canal físico; por ejemplo, escritorio o móvil.
- Forma de entrega en un canal físico; por ejemplo, la “página de detalles del producto”, la “página de categoría del producto” para escritorio o la “web móvil” o la “aplicación móvil” para móvil.
Sin embargo, probablemente no desee utilizar el mismo contenido para todos los canales y debe optimizar su contenido según el canal específico.
Los fragmentos de contenido le permiten lo siguiente:
- Pensar en cómo llegar a las audiencias de destino de forma eficaz en todos los canales.
- Crear y administrar contenido editorial neutro para el canal.
- Creargrupos de contenido para una amplia gama de canales.
- Diseñar variaciones de contenido para canales específicos.
- Agregar imágenes al texto insertando recursos (fragmentos de medios mixtos).
- Cree contenido anidado para reflejar la complejidad de sus datos.
Estos fragmentos de contenido se pueden ensamblar para ofrecer experiencias en varios canales.
- Los fragmentos de contenido son contenidos editoriales, con definición y estructura, pero sin diseño y/o maquetación visuales adicionales. Pueden utilizarse para acceder a datos estructurados, incluidos textos, números y fechas, entre otros.
- Los fragmentos de experiencias son contenidos plenamente diseñados; un fragmento de una página web.
Fragmentos de contenido y servicios de contenido content-fragments-and-content-services
Los servicios de contenido de AEM están diseñados para generalizar la descripción y la entrega de contenido desde o hacia AEM, más allá del enfoque en las páginas web.
Proporcionan la entrega de contenido a canales que no son páginas web de AEM tradicionales, mediante métodos estandarizados que cualquier cliente puede consumir. Estos canales pueden incluir lo siguiente:
- Aplicaciones de una sola página
- Aplicaciones móviles nativas
- Otros canales y puntos de contacto externos a AEM
La entrega se ejecuta en formato JSON utilizando el exportador de JSON.
Los fragmentos de contenido de AEM se pueden usar para describir y administrar el contenido estructurado. El contenido estructurado se define en modelos que pueden contener varios tipos de contenido, incluidos texto, datos numéricos, booleanos, fecha y hora, etc.
Junto con las capacidades de exportación de JSON de los componentes principales de AEM, este contenido estructurado se puede utilizar para entregar contenido de AEM a canales que no sean páginas de AEM.
Tipo de contenido content-type
Los fragmentos de contenido son lo siguiente:
-
Se almacenan como Recursos:
- Los fragmentos de contenido (y sus variaciones) se pueden crear y mantener desde la consola Assets.
- Se crean y editan en el editor de fragmentos de contenido.
-
Utilizado en el editor de páginas por el componente Fragmento de contenido (componente de referencia):
- El componente Fragmento de contenido está disponible para los autores de páginas. Les permite hacer referencia y entregar el fragmento de contenido requerido en formato HTML o JSON.
-
Son accesibles mediante la API de AEM GraphQL.
Los fragmentos de contenido son una estructura de contenido que:
- No tiene diseño (es posible aplicar algo de formato de texto en el modo Texto enriquecido).
- Contiene una o más partes constitutivas.
- Contiene imágenes o puede conectarse a ellas.
- Se usa contenido intermedio cuando se hace referencia a él en una página.
- Son independientes del mecanismo de envío (es decir, página, canal).
Fragmentos con recursos visuales fragments-with-visual-assets
Para que los autores tengan un mayor control sobre su contenido, las imágenes se pueden añadir o integrar con un fragmento de contenido.
Assets se puede utilizar con un fragmento de contenido de varias formas, cada una con sus propias ventajas:
-
Insertan recursos en un fragmento (fragmentos de medios mixtos)
- Forman parte del fragmento (consulte Partes constitutivas de un fragmento de contenido).
- Definen la posición del recurso.
- Consulte Inserción de recursos en el fragmento en el editor de fragmentos para obtener más información.
note note NOTE Los recursos visuales insertados en el propio fragmento de contenido se adjuntan al párrafo anterior. Cuando se agrega el fragmento a una página, estos recursos se mueven en relación con ese párrafo al agregarse contenido intermedio. -
Contenido asociado
- Conectado a un fragmento; pero no a una parte fija del fragmento (consulte Partes constitutivas de un fragmento de contenido).
- Tiene cierta flexibilidad para el posicionamiento.
- Fácil de usar (como contenido intermedio) al usar el fragmento en una página.
Consulte Contenido asociado para obtener más información.
-
Recursos disponibles desde el explorador de Assets del editor de páginas
- Permiten flexibilidad total para la selección de un recurso.
- Tiene cierta flexibilidad para el posicionamiento.
- No proporcionan el concepto de aprobarse para un fragmento específico.
Consulte el Explorador de recursos para obtener más información.
Partes constitutivas de un fragmento de contenido constituent-parts-of-a-content-fragment
Los activos de fragmento de contenido están formados por las siguientes partes (directa o indirectamente):
-
Elementos de fragmento
- Los elementos se correlacionan con los campos de datos que tienen contenido.
- Utiliza un modelo de contenido para crear el fragmento de contenido. Los elementos (campos) especificados en el modelo definen la estructura del fragmento. Estos elementos (campos) pueden ser de varios tipos de datos.
-
Párrafos de fragmento
-
Bloques de texto, a menudo multilínea, que se delimitan como entidades individuales.
-
En los modos Texto enriquecido y Markdown, un párrafo se puede formatear como un encabezado, en cuyo caso, ese párrafo y el siguiente se unirán como una sola unidad.
-
Habilite el control de contenido durante la creación de páginas.
-
-
Recursos insertados en un fragmento (fragmentos de medios mixtos)
-
Recursos (imágenes) insertados en el fragmento real y usados como contenido interno de un fragmento.
-
Incrustado en el sistema de párrafos del fragmento.
-
Se les puede dar formato cuando el fragmento se utiliza/referencia en una página.
-
Solo se pueden agregar, eliminar o mover dentro de un fragmento con el editor de fragmentos. Estas acciones no se pueden llevar a cabo en el editor de páginas.
-
Solo se pueden agregar, eliminar o mover dentro de un fragmento con el formato de texto enriquecido en el editor de fragmentos.
-
Solo se puede añadir a elementos de texto multilínea (cualquier tipo de fragmento).
-
Se adjuntan al texto anterior (párrafo).
note caution CAUTION Los recursos se pueden eliminar (de forma involuntaria) de un fragmento cambiando al texto sin formato. note note NOTE Assets también se puede agregar como contenido adicional (intermedio) al usar un fragmento en una página; usando Contenido asociado o recursos del explorador Assets.
-
-
Contenido asociado
-
Es contenido externo a un fragmento, pero con relevancia editorial para él. Normalmente, imágenes, vídeos u otros fragmentos.
-
Los recursos individuales de la colección están disponibles para su uso con el fragmento en el editor de páginas, cuando se añada a una página. Esto significa que son opcionales, según los requisitos del canal específico.
-
Los recursos están asociados a fragmentos mediante colecciones; las colecciones asociadas permiten al autor decidir qué recursos utilizar cuando esté creando la página.
- Las colecciones se pueden asociar a fragmentos como contenido predeterminado, o por parte de los autores durante la creación de fragmentos.
- Las Colecciones de recursos (DAM) son la base del contenido asociado de los fragmentos.
-
De forma opcional, también puede añadir el fragmento a una colección para ayudar en el seguimiento.
-
-
Metadatos de fragmento
-
Utilice los Esquemas de metadatos de recursos.
-
Las etiquetas se pueden crear cuando hace lo siguiente:
-
Crea el fragmento
-
O luego:
- Al visualizar o editar las Propiedades del fragmento desde la consola
- Editando los Metadatos en el editor de fragmentos
-
note caution CAUTION Los perfiles de procesamiento de metadatos no se aplican a los fragmentos de contenido. -
-
Principal
-
Una parte del fragmento
- Cada fragmento de contenido tiene una instancia de Principal.
- El Principal no se puede eliminar.
-
Se puede acceder al Principal en el editor de fragmentos, en Variaciones.
-
El Principal no es una variación como tal, sino la base de todas las variaciones.
-
-
Variaciones
- Representaciones de texto de fragmento específicas para un propósito editorial; pueden estar relacionadas con el canal, pero no es obligatorio, y también pueden ser para modificaciones locales específicas.
- Se crean como copias de Principal, pero se pueden editar según sea necesario. Hay superposición de contenido entre las propias variaciones.
- Se pueden definir durante la creación de fragmentos.
- Almacenadas en el fragmento para evitar la dispersión de copias de contenido.
- Las variaciones se pueden sincronizar con el Principal si se actualizó el contenido principal.
- Pueden resumirse para truncar rápidamente el texto a una longitud predefinida.
- Disponibles en la pestaña Variaciones del editor de fragmentos.
Contenido intermedio al crear páginas con fragmentos de contenido in-between-content-when-page-authoring-with-content-fragments
Contenido intermedio:
- Disponible para usar en el editor de páginas al trabajar con fragmentos de contenido.
- Contenido adicional que se agrega dentro del flujo de un fragmento después de que se utilice o se haga referencia a él en una página.
- Disponible para usar en el Editor de páginas al trabajar con fragmentos de contenido.
- El contenido intermedio se puede añadir a cualquier fragmento donde solo haya un elemento visible.
- Se puede utilizar contenido asociado, así como recursos o componentes del explorador adecuado.
Requerido por fragmentos required-by-fragments
Para crear fragmentos de contenido, necesita lo siguiente:
-
Modelo de contenido
- Están habilitados mediante el Explorador de configuración.
- Son creados mediante Herramientas.
- Requerido para crear un fragmento.
- Define la estructura de un fragmento (título, elementos de contenido, definiciones de etiquetas).
- Las definiciones de modelos de contenido requieren un título y un elemento de datos; todo lo demás es opcional.
- El modelo puede definir el contenido predeterminado, si corresponde.
- Los autores no pueden cambiar la estructura definida al crear contenido de fragmento.
- Los cambios realizados en un modelo después de crear fragmentos de contenido dependientes pueden afectar a esos fragmentos de contenido.
Para utilizar los fragmentos de contenido para la creación de páginas, también necesita lo siguiente:
-
Componente Fragmento de contenido
- Instrumental para entregar el fragmento en formato HTML, en formato JSON o en ambos.
- Requerido para hacer referencia al fragmento en una página.
- Responsable del diseño y entrega de un fragmento; es decir, de los canales.
- Los fragmentos necesitan uno o más componentes dedicados para definir el diseño y proporcionar algunos o todos los elementos/variaciones y el contenido asociado.
- Al arrastrar un fragmento a una página en la creación, se asocia automáticamente el componente requerido.
Reutilización de fragmentos de contenido con MSM reusing-content-fragments-with-msm
Cuando se accede a través de la consola Assets, puede usar MSM y crear Live Copies para los fragmentos.
Para obtener más información, consulte:
Esto habilita inheritance tanto para variaciones como para campos individuales de los fragmentos.
Uso de ejemplo example-usage
Un fragmento, con sus elementos y variaciones, se puede utilizar para crear contenido coherente para varios canales. Al diseñar el fragmento, tenga en cuenta qué se utiliza y dónde.
Ejemplo de WKND wknd-sample
Los ejemplos del Sitio WKND se proporcionan para ayudarle a obtener más información acerca AEM as a Cloud Service.
El proyecto WKND incluye lo siguiente:
-
Modelos de fragmentos de contenido disponibles en:
http://<hostname>:<port>/libs/dam/cfm/models/console/content/models.html/conf/wknd
-
Fragmentos de contenido (y otro contenido) disponibles en:
http://<hostname>:<port>/assets.html/content/dam/wknd/en