Administración de los modelos de fragmento de contenido managing-content-fragment-models
Desde la consola de fragmentos de contenido puede administrar los modelos de fragmentos de contenido y, a continuación, abrir el editor para definir la estructura.
Los modelos de fragmentos de contenido de Adobe Experience Manager (AEM) as a Cloud Service definen la estructura del contenido de sus fragmentos de contenido. Estos fragmentos se pueden utilizar como base para el contenido sin encabezado o para la creación de páginas.
Cómo trabajar con modelos de fragmentos de contenido how-to-work-with-content-fragment-models
Como descripción general muy rápida, para trabajar con los modelos de fragmentos de contenido puede hacer lo siguiente:
- Habilite la funcionalidad de modelos de fragmentos de contenido para la instancia.
- Crear su modelo de fragmento de contenido.
- En este punto también puede Habilitar el modelo (para usarlo al crear fragmentos de contenido).
- Defina la estructura de su modelo.
- Habilite el modelo de fragmento de contenido, si no lo ha hecho ya.
- Permita los modelos de fragmentos de contenido en las carpetas de recursos necesarias configurando Políticas.
Estructura básica y administración de modelos de fragmentos de contenido en la consola basic-structure-handling-content-fragment-models-console
Puede usar el panel del extremo izquierdo de la consola Fragmentos de contenido para seleccionar Modelos de fragmentos de contenido como tipo de recurso para ver, examinar y administrar:
Se abrirá la vista para modelos de fragmentos de contenido:
Aquí se pueden ver tres áreas principales:
-
La barra de herramientas superior
- Proporciona funcionalidad AEM estándar
- También muestra su organización IMS
- Proporciona varias acciones
-
El panel izquierdo
- Muestra las rutas de acceso a todas las configuraciones enumeradas como carpetas
- Aquí puede ocultar o mostrar el árbol de carpetas
- Puede seleccionar una carpeta específica del árbol
- Se puede cambiar el tamaño para mostrar carpetas anidadas (subconfiguraciones)
- Además de los modelos de fragmentos de contenido, puede ver fragmentos de contenido o Assets; también puede comprimir o expandir los vínculos a los paneles
-
Panel principal/derecho, desde aquí puede hacer lo siguiente:
-
Consulte la lista de todos los modelos de fragmento de contenido que se encuentran en la carpeta seleccionada:
-
Se mostrarán los modelos de fragmento de contenido de la carpeta seleccionada y todas las subcarpetas:
- La ubicación se indica mediante las rutas de exploración; también se pueden utilizar para cambiar la ubicación:
-
Varios campos de información acerca de un modelo de fragmento de contenido proporcionan vínculos; según el campo, pueden:
- Abra el modelo adecuado en el editor
- Mostrar información sobre la ruta a la configuración
- Mostrar información sobre el estado del modelo
-
Algunos otros campos de información acerca de un modelo de fragmento de contenido se pueden usar para Filtrado rápido:
- Seleccione un valor en la columna y se aplicará inmediatamente como filtro
- Se admite el filtrado rápido para las columnas Modificado por, Publicado por y Estado.
-
Al utilizar el ratón sobre los encabezados de columna, se mostrará un selector de acciones desplegable y controles deslizantes de anchura. Esto le permite lograr lo siguiente:
- Ordenar: seleccione la acción adecuada, ya sea ascendente o descendente.
Así se ordenará toda la tabla según esa columna. La ordenación solo está disponible en las columnas adecuadas. - Cambiar el tamaño de la columna: mediante los controles deslizantes de acción o de anchura
- Ordenar: seleccione la acción adecuada, ya sea ascendente o descendente.
-
Seleccione uno o más modelos para realizar más acción
-
-
Abrir el panel Filtro
-
Hay una selección de métodos abreviados de teclado disponibles para usar en esta consola
-
La información proporcionada sobre los modelos de fragmentos de contenido information-content-fragment-models
El panel principal/derecho (vista de tabla) de la consola proporciona una amplia gama de información sobre los modelos de fragmentos de contenido. Algunos elementos también proporcionan vínculos directos a otras acciones o información:
-
Nombre
- Proporciona un vínculo para abrir el modelo en el editor.
-
Bloqueado (icono de candado)
- Cuando el modelo está bloqueado, esto se indica con un icono de candado.
-
Ruta
- Proporciona la ruta de acceso como vínculo para abrir la configuración en la consola.
Al pasar el ratón por encima del nombre de la carpeta, se muestra la ruta JCR.
- Proporciona la ruta de acceso como vínculo para abrir la configuración en la consola.
-
Estado
- Solo información.
- Se puede usar para Filtrado rápido
-
Modificado
- Solo información.
-
Modificado por
- Solo información.
- Se puede usar para Filtrado rápido.
-
Etiquetas
- Solo información.
- Muestra todas las etiquetas relacionadas con el modelo.
- Se puede usar para Filtrado rápido.
-
Publicado en
- Solo información.
-
Publicado por
- Solo información.
- Se puede usar para Filtrado rápido.
Propiedades de modelo model-properties
Al seleccionar un modelo específico, se muestran las propiedades de dicho modelo (tal como se definen al crear el modelo). Si el modelo no está Bloqueado, se podrán actualizar algunos elementos. También puede usar el icono de información (junto al modelo Title) para abrir y cerrar este panel de información.
-
Título
-
Etiquetas
-
Descripción
-
Patrón de URL de vista previa
Los modelos de fragmentos de contenido permiten a los autores obtener una vista previa de su contenido en una aplicación de front-end externa. Una vez configurado el servicio de vista previa, agregue la dirección URL de la aplicación de front-end.
La URL de vista previa debe seguir este patrón:
https://<preview_url>?param=${expression}Las expresiones disponibles son:
${contentFragment.path}${contentFragment.model.path}${contentFragment.model.name}${contentFragment.variation}${contentFragment.id}
Acciones actions
Una vez seleccionada una carpeta (en el panel izquierdo), hay una serie de acciones que puede utilizar, ya sea directamente o después de seleccionar un modelo específico:
- Varias acciones están disponibles desde la consola directamente
- Puede seleccionar uno o más modelos de fragmento de contenido para mostrar las acciones adecuadas
Acciones (sin seleccionar) actions-unselected
Ciertas acciones están disponibles desde la consola, después de seleccionar una carpeta, pero sin seleccionar un modelo de fragmento de contenido específico:
- Crear un nuevo modelo (vacío)
Acciones para un modelo de fragmento de contenido en la consola Fragmentos de contenido actions-selected-content-fragment-models
Al seleccionar un modelo específico, se abre una barra de herramientas centrada en las acciones disponibles para dicho modelo. También puede seleccionar varios modelos: las acciones disponibles se ajustarán en consecuencia.
- Editar para definir el modelo de fragmento de contenido.
- Publicar en los niveles Publicar o Vista previa.
- Bloquear/Desbloquear para controlar si un usuario tiene permiso para modificar el modelo.
- Habilitar/Deshabilitar para controlar si un usuario puede crear fragmentos de contenido basados en este modelo.
Al seleccionar un solo modelo, también se muestran las propiedades del modelo en el panel derecho.
Seleccionar columnas mostradas en la consola select-columns-console
Al igual que con otras consolas, puede configurar las columnas que son visibles y están disponibles para la acción:
Se mostrará una lista de columnas que puede ocultar o mostrar:
Filtrar modelos de fragmentos de contenido filter-content-fragment-models
El panel Filtro ofrece lo siguiente:
-
una selección de predicados;
- incluyendo campos de estado, etiquetas, usuarios, entre otros
- se pueden seleccionar uno o más predicados y combinarlos para crear el filtro
Una vez seleccionadas, se muestran las opciones Filtrado por (en la parte superior del panel principal). Se pueden anular las selecciones desde allí. Por ejemplo:
Filtrado rápido fast-filtering
También puede seleccionar un predicado haciendo clic en un valor de columna específico de la lista. Puede seleccionar uno o más valores para combinar predicados.
Por ejemplo, seleccione Habilitado en la columna Estado. Una vez seleccionado, esto se mostrará como un predicado de filtro y la lista se filtrará en consecuencia.
Creación de un modelo de fragmento de contenido creating-a-content-fragment-model
-
Vaya a la carpeta adecuada para su configuración o subconfiguración.
-
Use Crear para abrir el cuadro de diálogo.
note caution CAUTION La opción Crear solo estará disponible: - Si se ha habilitado el uso de modelos de fragmentos de contenido
- cuando haya seleccionado la carpeta en la que desea crear el modelo.
-
Seleccione la ruta a la configuración y especifique el nombre.
note note NOTE La configuración se rellenará automáticamente con la configuración actual (la carpeta en la que se encuentra actualmente). También puede cambiar la configuración haciendo clic en el icono de la carpeta. También puede definir varias propiedades:
- Título
Si escribe primero el Título, a partir de ahí se generará Nombre. - una descripción
- Habilitar modelo para habilitar el modelo
note note NOTE Consulte Modelo de fragmento de contenido: propiedades para obtener información detallada. 
- Título
-
Use Crear para guardar el modelo vacío o Crear y abrir.
Activación de un modelo de fragmento de contenido enabling-a-content-fragment-model
Una vez creado un modelo, debe activarse para que:
- Está disponible para su selección al crear un fragmento de contenido.
- Se pueda hacer referencia a él desde un modelo de fragmento de contenido.
- Esté disponible para GraphQL y por lo tanto, se genere el esquema.
Puede habilitar un modelo:
- Al crear un nuevo modelo
- Se muestra una opción en el cuadro de diálogo.
- Cuando un modelo se ha deshabilitado específicamente
- Cuando se selecciona el modelo requerido, la acción Enable está disponible en la barra de herramientas superior.
Desactivación de un modelo de fragmento de contenido disabling-a-content-fragment-model
Un modelo también se puede desactivar para que:
-
El modelo ya no esté disponible como base para la creación de nuevos fragmentos de contenido.
-
Sin embargo:
- El esquema de GraphQL se siga generando y aún se pueda consultar (para evitar afectar a la API de JSON).
- Cualquier fragmento de contenido basado en el modelo se puede consultar y devolver desde el extremo de GraphQL.
-
Ya no se puede hacer referencia al modelo, pero las referencias existentes no se tocan y aún se pueden consultar y devolver desde el extremo GraphQL.
Para deshabilitar un modelo marcado como Habilitado, usa la opción Deshabilitar de:
- La barra de herramientas superior, cuando se selecciona el Modelo requerido.
Permitir modelos de fragmento de contenido en la carpeta de recursos allowing-content-fragment-models-assets-folder
Para implementar el control de contenido, puede configurar las Directivas en la carpeta Recursos para controlar qué modelos de fragmento de contenido están permitidos para la creación de fragmentos en esa carpeta.
Para configurar las Directivas para Modelos de fragmento de contenido permitidos:
-
Navegar y abrir Propiedades para la carpeta de recursos necesaria.
-
Abra la pestaña Directivas, donde puede configurar lo siguiente:
-
Heredado de
<folder>Las directivas se heredan automáticamente al crear nuevas carpetas secundarias; la directiva se puede reconfigurar (y la herencia se rompe) si las subcarpetas necesitan permitir modelos diferentes de la carpeta principal.
-
Modelos de fragmento de contenido permitidos por ruta
Se pueden permitir varios modelos.
-
Modelos de fragmento de contenido permitidos por etiquetas
Se pueden permitir varios modelos.
-
-
Guardar cualquier cambio.
Los modelos de fragmento de contenido permitidos para una carpeta se resuelven de la siguiente manera:
- Las Directivas para los Modelos de fragmento de contenido permitidos.
- Si está vacío, intente determinar la directiva utilizando las reglas de herencia.
- Si la cadena de herencia no proporciona un resultado, consulte la configuración de Cloud Services para esa carpeta (primero directamente y luego mediante herencia).
- Si ninguno de los anteriores proporciona ningún resultado, no hay modelos permitidos para esa carpeta.
Publicación de un modelo de fragmento de contenido publishing-a-content-fragment-model
Los modelos de fragmento de contenido deben publicarse cuando se publican fragmentos de contenido dependientes, o antes de hacerlo.
Para publicar un modelo de fragmento de contenido:
-
Vaya a y seleccione el Modelo de fragmento de contenido. Puede seleccionar varios modelos.
-
Seleccione Publicar en la barra de herramientas.
-
En el cuadro de diálogo Publicar, seleccione Destino:
- Servicio de publicación
- Servicio de vista previa
-
Se iniciará el flujo de trabajo para publicar los modelos seleccionados y sus referencias. El estado publicado se muestra en la consola.
Modelos de fragmento de contenido bloqueados locked-content-fragment-models
Esta función le permite controlar si un modelo se puede actualizar, pero también proporciona control para los modelos de fragmento de contenido que se han publicado.
Desafíos the-challenge
-
Los modelos de fragmentos de contenido determinan el esquema de las consultas de GraphQL en AEM.
-
Los esquemas de GraphQL de AEM se crean en cuanto se genera un modelo de fragmento de contenido y pueden existir en entornos de creación y publicación.
-
Los esquemas en la publicación son los más críticos, ya que proporcionan la base para la entrega en directo de contenido de fragmento de contenido en formato JSON.
-
-
Pueden producirse problemas cuando se modifican los modelos de fragmento de contenido o, dicho de otro modo, se editan. Esto significa que el esquema cambia, lo que a su vez puede afectar a las consultas de GraphQL existentes.
-
La adición de nuevos campos a un modelo de fragmento de contenido no debería (normalmente) tener ningún efecto perjudicial. Sin embargo, si se modifican los campos de datos existentes (por ejemplo, su nombre) o se eliminan las definiciones de campos, las consultas de GraphQL existentes se romperán al solicitar estos campos.
Requisitos the-requirements
-
Para concienciar a los usuarios sobre los riesgos que se plantean al editar modelos que ya se utilizan para la entrega de contenido en directo (es decir, modelos que se han publicado).
-
Además, para evitar cambios no deseados.
Cualquiera de estos criterios podría generar consultas si se vuelven a publicar los modelos modificados.
Solución the-solution
Para solucionar estos problemas, los modelos de fragmentos de contenido son bloqueados en modo de SOLO LECTURA en el autor, tan pronto como se hayan publicado. Este estado está indicado por Bloqueado.
Cuando el modelo es Bloqueado (en modo de SOLO LECTURA), puede ver el contenido y la estructura de los modelos, pero no puede editarlos.
Puede administrar modelos Bloqueados desde la consola o desde el editor de modelos:
-
Consola
Desde la consola, puede administrar el modo de SOLO LECTURA con las acciones Desbloquear y Bloquear de la barra de herramientas.
-
Puede Desbloquear un modelo para activar las ediciones.
Si seleccionas Desbloquear se mostrará una advertencia y debes confirmar la acción Desbloquear.
A continuación, puede abrir el modelo para editarlo.
-
También puede Bloquear el modelo después.
-
Volver a publicar el modelo inmediatamente lo devuelve al modo Bloqueado (SOLO LECTURA).
-
-
Editor de modelo
-
Cuando abra un modelo bloqueado, se le avisará y se le presentarán tres acciones: Cancelar, Ver solo lectura, Editar.
-
Si selecciona Ver solo lectura, podrá ver el contenido y la estructura del modelo.
-
Si seleccionas Editar, puedes editar y guardar tus actualizaciones:
note note NOTE Puede que todavía haya una advertencia en la parte superior, pero es cuando el modelo ya está siendo utilizado por fragmentos de contenido existentes. -
Cancelar le devuelve a la consola.
-