Configuración de la sincronización de Live Copy

Realice las siguientes tareas para controlar cómo y cuándo se sincronizan los elementos de Live Copy con su contenido de origen.

  • Decida si las opciones de configuración de lanzamiento existentes cumplen los requisitos o si necesita crear una o más.
  • Especifique las opciones de configuración de lanzamiento que se utilizarán en los elementos de Live Copy.

Opciones de configuración de lanzamiento personalizadas e instaladas

Esta sección proporciona información sobre las opciones de configuración de lanzamiento instaladas y las acciones de sincronización que utilizan, así como información para crear opciones de configuración personalizadas si es necesario.

PRECAUCIÓN

Actualizar o cambiar una configuración de despliegue predeterminada (instalada) es no recomendado. Si hay algún requisito para una acción en directo personalizada, debe añadirse en una configuración de despliegue personalizada.

Activadores de lanzamiento

Cada configuración de lanzamiento utiliza un activador de lanzamiento que hace que se produzca el lanzamiento. En las opciones de configuración de lanzamiento se puede utilizar uno de los siguientes activadores:

  • En el lanzamiento: el comando Lanzar se utiliza en la página del modelo, o el comando Sincronizar se utiliza en la página de Live Copy.

  • En la modificación: la página de origen se modifica.

  • En la activación: la página de origen se activa.

  • En la desactivación: la página de origen se desactiva.

NOTA

Recuerde que el uso del activador En la modificación puede afectar al rendimiento. Consulte las prácticas recomendadas de MSM para obtener más información.

Opciones de configuración de lanzamiento instaladas

En la siguiente tabla se enumeran las opciones de configuración de lanzamiento que se instalan con AEM. La tabla incluye las acciones de activación y sincronización de cada configuración de lanzamiento. Si las acciones de configuración de lanzamiento instaladas no cumplen los requisitos, puede crear una nueva configuración de lanzamiento.

Nombre Descripción Activador Acciones de sincronización

; consulte también las acciones de sincronización instaladas
Configuración de lanzamiento estándar La configuración de lanzamiento estándar permite iniciar procesos de lanzamiento con el activador de lanzamientos, y ejecuta acciones como crear, actualizar, eliminar contenido y ordenar nodos secundarios. En el despliegue contentUpdate
contentCopy
contentDelete
referencesUpdate
productUpdate
orderChildren
Activar si se activa el modelo Publica la Live Copy cuando se publica el origen. En la activación targetActivate
Desactivar si se desactiva el modelo Desactiva la Live Copy cuando se desactiva el origen. En la desactivación targetDeactivate
Insertar al modificar

Inserta el contenido la Live Copy cuando se modifica el origen.

Utilice esta configuración de lanzamiento con moderación, ya que usa el activador "En la modificación".

En la modificación contentUpdate
contentCopy
contentDelete
referencesUpdate
orderChildren
Insertar al modificar (superficial)

Inserta el contenido en la Live Copy cuando se modifica la página del modelo sin actualizar las referencias (por ejemplo, para copias superficiales).

Utilice esta configuración de lanzamiento con moderación, ya que usa el activador "En la modificación".

En la modificación contentUpdate
contentCopy
contentDelete
orderChildren
Lanzamiento de promoción Configuración del lanzamiento estándar para promocionar páginas de inicio con dicho fin. En el despliegue contentUpdate
contentCopy
contentDelete
referencesUpdate
orderChildren
markLiveRelationship
Configuración del lanzamiento de contenido de la página del catálogo Aplica plantillas de página de un modelo de catálogo. En el despliegue contentUpdate
contentCopy
contentDelete
referencesUpdate
productCreateUpdate
orderChildren
Configuración del lanzamiento de actualización de la página del catálogo Aplica propiedades de destino de un modelo de catálogo. Debe ejecutarse después de la configuración de lanzamiento del contenido de la página del catálogo. En el despliegue catalogRolloutHooks
Configuración del lanzamiento de publicaciones de DPS La configuración del lanzamiento de publicación de DPS permite iniciar el proceso del activador "En el lanzamiento" al mismo tiempo que se excluyen las propiedades de enlace de FolioProducer en el lanzamiento inicial. En el despliegue contentUpdate
contentCopy
contentDelete
referencesUpdate
orderChildren
dpsMetadataFilter
Configuración del lanzamiento del catálogo heredado (5.6.0) En desuso. Use el generador de catálogos en lugar de MSM para los lanzamientos de catálogos. En el despliegue editProperties

Acciones de sincronización instaladas

En la siguiente tabla se enumeran las acciones de sincronización que se instalan con AEM. Si las acciones instaladas no cumplen con sus requisitos, puede Crear una nueva acción de sincronización.

Nombre de la acción Descripción Propiedades
contentCopy Cuando los nodos de origen no existen en la Live Copy, se copian en el mismo. Configure el servicio de acción de copia de contenido de CQ MSM para especificar los tipos de nodo, los elementos de párrafo y las propiedades de página que se excluirán.
contentDelete

Elimina nodos de la Live Copy que no existen en el origen. Configure el servicio de acción de eliminación de contenido de CQ MSM para especificar los tipos de nodo, los elementos de párrafo y las propiedades de página que se excluirán.

contentUpdate Actualiza el contenido de la Live Copy con los cambios del origen. Configure el servicio de acción de actualización de contenido de CQ MSM para especificar los tipos de nodo, los elementos de párrafo y las propiedades de página que se excluirán.
editProperties

Edita las propiedades de la Live Copy. La propiedad editMap determina qué propiedades se editan y su valor. El valor de la propiedad editMap debe utilizar el formato siguiente:

[property_name_1]#[current_value]#[nuevo_valor],
[property_name_2]#[current_value]#[nuevo_valor],
... ,
[property_name_n]#[current_value]#[nuevo_valor]

El current_value y new_value los elementos son expresiones regulares.

Por ejemplo, considere el valor siguiente para editMap:

sling:resourceType#/(contentpage|homepage)#/
mobilecontentpage,
cq:template#/contentpage#/mobilecontentpage

Este valor edita las propiedades de los nodos de la Live Copy de la siguiente manera:

  • El sling:resourceType propiedades que se establecen como contentpage o a homepage están configuradas como mobilecontentpage.
  • Las propiedades cq:template definidas en contentpage se establecen como mobilecontentpage.

editMap: (cadena) Identifica la propiedad, el valor actual y el nuevo valor. Consulte la descripción para obtener más información.

notify Envía un evento de página que indica que la página se ha lanzado. Para recibir notificaciones, primero debe suscribirse a eventos de lanzamiento.
orderChildren En la Live Copy, ordena los elementos secundarios (nodos) según el orden del modelo
referencesUpdate

En la Live Copy, esta acción de sincronización actualiza referencias como los vínculos.
Busca rutas de acceso en las páginas de Live Copy que apuntan a un recurso dentro del modelo. Cuando se encuentran, se actualiza la ruta de acceso para que apunte al recurso relacionado dentro de la Live Copy (en lugar del modelo). Las referencias que tienen los destinos fuera del modelo no cambian.

Configure el servicio de acción de actualización de referencias de CQ MSM para especificar los tipos de nodo, los elementos de párrafo y las propiedades de página que se excluirán.

targetVersion

Crea una versión de la Live Copy.

Esta acción debe ser la única acción de sincronización incluida en una configuración de lanzamiento.

targetActivate

Activa la Live Copy.

Esta acción debe ser la única acción de sincronización incluida en una configuración de lanzamiento.

targetDeactivate

Desactiva la Live Copy.

Esta acción debe ser la única acción de sincronización incluida en una configuración de lanzamiento.

flujo de trabajo

Inicia el flujo de trabajo que define la propiedad de destino (solo para páginas) y toma la Live Copy como carga útil.

La ruta de destino es la ruta del nodo del modelo.

destino: (cadena) La ruta de acceso del modelo de flujo de trabajo.
mandatory

Establece el permiso de varias ACL en la página de la Live Copy como de solo lectura para un grupo de usuarios específico. Están configuradas las siguientes ACL:

  • ActionSet.ACTION_NAME_REMOVE
  • ActionSet.ACTION_NAME_SET_PROPERTY
  • ActionSet.ACTION_NAME_ACL_MODIFY

Utilice esta acción solo para páginas.

destino: (cadena) El ID del grupo para el que se define la configuración.
mandatoryContent

Establece el permiso de varias ACL en la página de la Live Copy como de solo lectura para un grupo de usuarios específico. Están configuradas las siguientes ACL:

  • ActionSet.ACTION_NAME_SET_PROPERTY
  • ActionSet.ACTION_NAME_ACL_MODIFY

Utilice esta acción solo para páginas.

destino: (cadena) El ID del grupo para el que se define la configuración.
mandatoryStructure Establece el permiso de la ACL ActionSet.ACTION_NAME_REMOVE en la página de la Live Copy como de solo lectura para un grupo de usuarios específico. Utilice esta acción solo para páginas. destino: (cadena) El ID del grupo para el que se define la configuración.
VersionCopyAction Si la página de origen o el modelo se ha publicado al menos una vez, crea una página de Live Copy mediante la versión publicada. Nota: Esta acción solo está disponible para crear una página de Live Copy basada en una página de origen publicada, no para actualizar una página de Live Copy existente.
PageMoveAction

PageMoveAction se aplica cuando una página se ha movido en el modelo.

La acción copia la página de Live Copy (relacionada) en lugar de moverla desde la ubicación, antes de realizar el traslado a la ubicación posterior.

PageMoveAction no cambia la página de Live Copy a la ubicación antes del traslado. Por lo tanto, para configuraciones de RolloutConfigurations consecutivas, esta página tiene el estado de un elemento LiveRelationhip sin modelo.

Configure el servicio de acción de traslado de páginas de CQ MSM para especificar los tipos de nodo, los elementos de párrafo y las propiedades de página que se excluirán.

Esta acción debe ser la única acción de sincronización incluida en una configuración de lanzamiento.

prop_referenceUpdate: (booleano) establezca este valor en "verdadero" para actualizar las referencias. El valor predeterminado es "verdadero".

productCreateUpdate Crea o actualiza recursos del producto en un catálogo. Esta acción se debe utilizar en una de las siguientes situaciones:
  • Generación o lanzamiento de un catálogo (o sección de catálogos)
  • Un usuario restaura la herencia de sincronización de un componente del producto.
markLiveRelationship Indica una relación dinámica del contenido creado para el lanzamiento.
catalogRolloutHooks Ejecuta enlaces de lanzamiento específicos de la generación del catálogo. Llama a los métodos executePageRolloutHooks y executeProductRolloutHooks del objeto CatalogGenerator.
Consulte com.adobe.cq.commerce.pim.api.CatalogGenerator en los archivos JavaDoc de AEM.
productUpdate Actualiza las páginas del producto en una Live Copy de un catálogo de productos

Creación de una configuración de lanzamiento

Puede crear una configuración de lanzamiento cuando las opciones de la misma que estén instaladas no cumplan los requisitos de la aplicación:

La nueva configuración de lanzamiento estará disponible al establecer las opciones de la misma en una página de Live Copy o modelo.

Exclusión de propiedades y tipos de nodos de la sincronización

Puede configurar varios servicios de OSGi que admitan las acciones de sincronización correspondientes para que no afecten a los tipos de nodos y propiedades específicos. AEM Por ejemplo, muchas propiedades y subnodos relacionados con el funcionamiento interno de los no deben incluirse en una Live Copy. Solo se debe copiar el contenido relevante para el usuario de la página.

AEM Al trabajar con los servicios de correo electrónico, existen varios métodos para administrar los parámetros de configuración de dichos servicios; consulte Configurar OSGi para obtener más información y las prácticas recomendadas.

En la tabla siguiente se enumeran las acciones de sincronización para las que se pueden especificar los nodos que se excluirán. La tabla proporciona los nombres de los servicios que se configuran mediante la consola web y el PID para configurar el uso de un nodo del repositorio.

Acción de sincronización Nombre del servicio en la consola web PID de servicio
contentCopy Acción de copia de contenido de CQ MSM com.day.cq.wcm.msm.impl.actions.ContentCopyActionFactory
contentDelete Acción de eliminación de contenido de CQ MSM com.day.cq.wcm.msm.impl.actions.ContentDeleteActionFactory
contentUpdate Acción de actualización de contenido de CQ MSM com.day.cq.wcm.msm.impl.actions.ContentUpdateActionFactory
PageMoveAction Acción de movimiento de página de CQ MSM com.day.cq.wcm.msm.impl.actions.PageMoveActionFactory
referencesUpdate Acción de actualización de referencias de CQ MSM com.day.cq.wcm.msm.impl.actions.ReferencesUpdateActionFactory

En la tabla siguiente se describen las propiedades que se pueden configurar:

Propiedad de la consola web/propiedad OSGi Descripción

Nodetypes excluidos

cq.wcm.msm.action.excludednodetypes

Expresión regular que coincide con los tipos de nodos que se van a excluir de la acción de sincronización.

Elementos de párrafo excluidos

cq.wcm.msm.action.excludedparagraphitems

Expresión regular que coincide con los elementos de párrafo que se van a excluir de la acción de sincronización.

Propiedades de página excluidas

cq.wcm.msm.action.excludedprops

Expresión regular que coincide con las propiedades de página que se van a excluir de la acción de sincronización.

Tipos de nodos de Mixin ignorados

cq.wcm.msm.action.ignoredMixin

Disponible solo para la acción de actualización de contenido de CQ MSM. Expresión regular que coincide con los nombres de los tipos de nodos de Mixin que se van a excluir de la acción de sincronización.
NOTA

En la interfaz de usuario clásica, el icono de bloqueo que aparece en el cuadro de diálogo Propiedades de la página para las páginas de Live Copy no refleja la configuración de la propiedad "Propiedades de la página excluidas". El icono de bloqueo aparece incluso para las propiedades que se excluyen de la acción de sincronización.

NOTA

En la interfaz de usuario optimizada para pantallas táctiles, consulte también Configuración de bloqueos MSM en Propiedades de la página (Interfaz de usuario optimizada para pantallas táctiles).

Acción de actualización de contenido de CQ MSM: exclusiones

Algunas propiedades y tipos de nodo se excluyen de forma predeterminada. Estos se definen en la configuración de OSGi de la acción de actualización de contenido de CQ MSM, en Propiedades de página excluidas.

De forma predeterminada, las propiedades que coinciden con las siguientes expresiones regulares se excluyen (es decir, no se actualizan) del lanzamiento:

chlimage_1

Puede cambiar las expresiones que definen la lista de exclusión según sea necesario.

Por ejemplo, si quiere que el título de la página se incluya en los cambios considerados para el lanzamiento, elimine jcr:title de las exclusiones. Por ejemplo, con la expresión regular:

jcr:(?!(title)$).*

Configuración de la sincronización de actualización de referencias

Puede configurar varios servicios de OSGi que admitan las acciones de sincronización correspondientes relacionadas con la actualización de referencias.

AEM Al trabajar con los servicios de correo electrónico, existen varios métodos para administrar los parámetros de configuración de dichos servicios; consulte Configurar OSGi para obtener más información y las prácticas recomendadas.

En la siguiente tabla se enumeran las acciones de sincronización para las que se puede especificar la actualización de referencia. La tabla proporciona los nombres de los servicios que se configuran mediante la consola web y el PID para configurar el uso de un nodo del repositorio.

Propiedad de la consola web/propiedad OSGi Descripción

Actualizar referencia en LiveCopies anidadas

cq.wcm.msm.impl.action.referencesupdate.prop_updateNested

Solo está disponible para la acción de actualización de referencias de CQ MSM. Seleccione esta opción (Consola web) o establezca esta propiedad boolean como true (configuración del repositorio) para reemplazar referencias que estén orientadas a cualquier recurso que se encuentre dentro de la rama de la LiveCopy más importante.

Actualizar páginas de referencia

cq.wcm.msm.impl.actions.pagemove.prop_referenceUpdate

Solo disponible para la acción de movimiento de página de CQ MSM. Seleccione esta opción (consola web) o establezca esta propiedad booleana en true (configuración del repositorio) para actualizar cualquier referencia y utilizar la página original para hacer referencia a la página de LiveCopy.

Especificación de las opciones de configuración de lanzamiento que se van a utilizar

MSM le permite especificar conjuntos de opciones de configuración de lanzamiento que se utilizan normalmente y, cuando sea necesario, puede invalidar determinadas Live Copy. MSM proporciona varias ubicaciones para especificar las opciones de configuración de lanzamiento que se deben utilizar. La ubicación determina si la configuración se aplica a una Live Copy específica.

En la siguiente lista de ubicaciones en la que se pueden especificar las opciones de configuración de lanzamiento que se deben utilizar, se describe cómo MSM determina qué opciones de configuración de lanzamiento se deben utilizar para una Live Copy:

  • Propiedades de la página de Live Copy: cuando una página de Live Copy está configurada para utilizar una o varias opciones de configuración de lanzamiento, MSM utiliza dichas opciones de configuración.
  • Propiedades de la página de modelo: cuando una página de Live Copy se basa en un modelo y la página de Live Copy no usa una configuración de lanzamiento, se utiliza la configuración de lanzamiento asociada a la página de origen del modelo.
  • Propiedades de la página principal de Live Copy: Cuando ni la página de Live Copy ni la página de origen del modelo tienen una configuración de despliegue, se utiliza la configuración de despliegue que se aplica a la página principal de la página de Live Copy.
  • Sistema predeterminado: Cuando no se puede determinar la configuración de despliegue de la página principal de Live Copy, se utiliza la configuración de despliegue predeterminada del sistema.

Por ejemplo, un modelo utiliza el sitio de referencia We.Retail como contenido de origen. Se crea un sitio a partir del modelo. Cada elemento de la lista siguiente describe un escenario diferente respecto al uso de las opciones de configuración de lanzamiento:

  • Ninguna de las páginas del modelo ni las páginas de Live Copy están configuradas para utilizar una configuración de lanzamiento. MSM utiliza la configuración de lanzamiento predeterminada del sistema para todas las páginas de Live Copy.
  • La página raíz del sitio de referencia We.Retail se configura con varias opciones de configuración de lanzamiento. MSM utiliza estas opciones de configuración de lanzamiento para todas las páginas de Live Copy.
  • La página raíz del sitio de referencia de We.Retail se configura con varias opciones de configuración de despliegue, mientras que la página raíz del sitio de Live Copy se configura con un conjunto diferente. MSM utiliza las opciones de configuración de lanzamiento que están en la página raíz del sitio de Live Copy.

Configuración de las opciones de configuración de lanzamiento para una página de Live Copy

Configure una página de Live Copy con las opciones de configuración de lanzamiento que se usarán cuando se lance la página de origen. Las páginas secundarias heredan la configuración de forma predeterminada. Al establecer la configuración de lanzamiento para su uso, se anula la configuración que la página de Live Copy hereda de su elemento principal.

También puede configurar las opciones de configuración de lanzamiento para una página de Live Copy al crear la Live Copy.

  1. Utilice la consola Sitios para seleccionar la página de Live Copy.

  2. En la barra de herramientas, seleccione Propiedades.

  3. Abra la pestaña Live Copy.

    La sección Configuración muestra las opciones de configuración de lanzamiento que hereda la página.

    chlimage_1-1

  4. Si es necesario, ajuste la marca de Herencia de Live Copy. Si se selecciona, la configuración de Live Copy es eficaz en todas las páginas secundarias.

  5. Desactive la propiedad Heredar configuración de lanzamiento del elemento principal y, a continuación, seleccione una o varias opciones de configuración de lanzamiento de la lista.

    Las opciones de configuración de lanzamiento seleccionadas se muestran debajo de la lista desplegable.

    chlimage_1-2

  6. Haga clic o pulse Guardar.

Opciones de la configuración de lanzamiento para una página de modelo

Configure una página de modelo con las opciones de configuración de lanzamiento que se usarán cuando se lance la página de modelo.

Tenga en cuenta que las páginas secundarias de la página de modelo heredan la configuración. Al establecer la configuración de lanzamiento para su uso, podría anular la configuración que la página hereda de su elemento principal.

  1. Utilice la consola Sitios para seleccionar la página de modelo.
  2. En la barra de herramientas, seleccione Propiedades.
  3. Abra la pestaña Modelo.
  4. Seleccione una o más opciones de configuración de lanzamiento con el selector desplegable.
  5. Para almacenar las actualizaciones, seleccione Guardar.

Opciones de la configuración de lanzamiento predeterminada del sistema

Especifique una configuración de lanzamiento para usar como valor predeterminado del sistema. Para especificar el valor predeterminado, configure el servicio de OSGi:

  • Administrador de relaciones dinámicas de CQ WCM por día; el servicio PID es
    com.day.cq.wcm.msm.impl.LiveRelationshipManagerImpl

Configure el servicio mediante las opciones Consola web o una nodo del repositorio.

  • En la consola web, el nombre de la propiedad que se va a configurar es Configuración de despliegue predeterminada.
  • Mediante un nodo del repositorio, el nombre de la propiedad que se va a configurar es liverelationshipmgr.relationsconfig.default.

Establezca este valor de la propiedad en la ruta de la configuración de lanzamiento que se utilizará como valor predeterminado del sistema. El valor predeterminado es /libs/msm/wcm/rolloutconfigs/default, que es la Configuración de despliegue estándar.

En esta página