Configurazione della sincronizzazione di una Live Copy

ATTENZIONE

AEM 6.4 ha raggiunto la fine del supporto esteso e questa documentazione non viene più aggiornata. Per maggiori dettagli, consulta la nostra periodi di assistenza tecnica. Trova le versioni supportate qui.

Esegui le seguenti operazioni per controllare come e quando vengono sincronizzate le Live Copy con il relativo contenuto sorgente.

  • Decidi se le configurazioni di rollout esistenti soddisfano le tue esigenze o se devi crearne una o più.
  • Specifica le configurazioni di rollout da utilizzare per le Live Copy.

Configurazioni di rollout installate e personalizzate

Questa sezione fornisce informazioni sulle configurazioni di rollout installate e sulle azioni di sincronizzazione che utilizzano, nonché su come creare configurazioni personalizzate, se necessario.

ATTENZIONE

L'aggiornamento o la modifica di una configurazione di rollout predefinita (installata) è not consigliato. Se è necessaria un’azione live personalizzata, questa deve essere aggiunta in una configurazione di rollout personalizzata.

Attivatori di rollout

Ogni configurazione di rollout utilizza un attivatore (o trigger) di rollout che determina l’esecuzione dell’implementazione. Le configurazioni di rollout possono utilizzare uno dei seguenti attivatori:

  • Al rollout: La Rollout viene utilizzato nella pagina di stampa blu, oppure Sincronizza viene utilizzato nella pagina Live Copy.

  • In caso di modifica: quando la pagina sorgente viene modificata.

  • Al momento dell’attivazione: quando la pagina sorgente viene attivata.

  • Alla disattivazione: quando la pagina sorgente viene disattivata.

NOTA

L’utilizzo del trigger Durante la modifica può influire sulle prestazioni. Per ulteriori informazioni, consulta la sezione sulle best practice per MSM.

Configurazioni di rollout installate

Nella tabella seguente sono elencate le configurazioni di rollout installate con AEM. La tabella contiene le azioni di attivazione e sincronizzazione per ciascuna configurazione di rollout. Se le azioni di configurazione di rollout installate non soddisfano le tue esigenze, puoi creare una nuova configurazione di rollout.

Nome Descrizione Attivatore Azioni di sincronizzazione

vedi anche Azioni di sincronizzazione installate
Configurazione di rollout standard Configurazione di rollout standard che consente di avviare il processo di rollout all’attivazione del rollout ed esegue le seguenti azioni: crea, aggiorna, elimina contenuto e ordina nodi figlio. Al momento del rollout contentUpdate
contentCopy
contentDelete
referencesUpdate
productUpdate
orderChildren
Attiva in caso di attivazione Blueprint Pubblica la Live Copy quando l’origine viene pubblicata. Al momento dell’attivazione targetActivate
Disattiva in caso di disattivazione Blueprint Disattiva la Live Copy quando l’origine viene disattivata. Alla disattivazione targetDeactivate
Invia dopo modifica

Invia il contenuto alla Live Copy quando l’origine viene modificata.

Utilizza questa configurazione di rollout con moderazione in quanto utilizza l’attivatore Al momento della modifica.

 In caso di modifica contentUpdate
contentCopy
contentDelete
referencesUpdate
orderChildren
Invia dopo modifica (superficiale)

Invia il contenuto alla Live Copy quando la pagina blueprint viene modificata, senza aggiornare i riferimenti (ad esempio, per le copie superficiali).

Utilizza questa configurazione di rollout con moderazione in quanto utilizza l’attivatore Al momento della modifica.

 In caso di modifica contentUpdate
contentCopy
contentDelete
orderChildren
Promuovi lancio Configurazione rollout standard per la promozione di pagine di lanci. Al momento del rollout contentUpdate
contentCopy
contentDelete
referencesUpdate
orderChildren
markLiveRelationship
Configurazione di rollout del contenuto della pagina del catalogo Applica i modelli pagina da una blueprint del catalogo. Al momento del rollout contentUpdate
contentCopy
contentDelete
referencesUpdate
productCreateUpdate
orderChildren
Configurazione rollout dell'aggiornamento pagina del catalogo Applica le proprietà di destinazione da una blueprint del catalogo. Deve essere eseguito dopo la configurazione di rollout del contenuto della pagina del catalogo. Al momento del rollout catalogRolloutHooks
Configurazione rollout pubblicazioni DPS Configurazione di rollout della pubblicazione DPS che consente di avviare il processo di rollout all'attivazione del rollout escludendo le proprietà di binding FolioProducer al rollout iniziale Al momento del rollout contentUpdate
contentCopy
contentDelete
referencesUpdate
orderChildren
dpsMetadataFilter
Configurazione rollout catalogo legacy (5.6.0) Obsoleto. Utilizza Catalog Generator invece di MSM per i rollout di cataloghi. Al momento del rollout editProperties

Azioni di sincronizzazione installate

Nella tabella seguente sono elencate le azioni di sincronizzazione installate con AEM. Se le azioni installate non soddisfano le tue esigenze, puoi Creare una nuova azione di sincronizzazione.

Nome azione Descrizione Proprietà
contentCopy Quando i nodi dell’origine non esistono nella Live Copy, copia i nodi nella Live Copy. Configura il servizio CQ MSM Content Copy Action per specificare i tipi di nodo, gli elementi di paragrafo e le proprietà di pagina da escludere.
contentDelete

Elimina i nodi della Live Copy che non esistono nell’origine. Configura il servizio CQ MSM Content Delete Action per specificare i tipi di nodo, gli elementi di paragrafo e le proprietà di pagina da escludere.

contentUpdate Aggiorna il contenuto della Live Copy con le modifiche dall’origine. Configura il servizio CQ MSM Content Update Action per specificare i tipi di nodo, gli elementi di paragrafo e le proprietà di pagina da escludere.
editProperties

Modifica le proprietà della Live Copy. La proprietà editMap determina le proprietà modificate e il relativo valore. Il valore della proprietà editMap deve utilizzare il formato seguente:

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

La current_value e new_value gli elementi sono espressioni regolari.

Ad esempio, considera il seguente valore per editMap:

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

Questo valore modifica le proprietà dei nodi della Live Copy come segue:

  • La sling:resourceType proprietà impostate su contentpage o homepage sono impostati su mobilecontentpage.
  • Le proprietà cq:template impostate su contentpage vengono impostate su mobilecontentpage.

editMap: (Stringa) Identifica la proprietà, il valore corrente e il nuovo valore. Per informazioni, consulta Descrizione .
notify Invia un evento di pagina per segnalare che la pagina è stata implementata. Per ricevere una notifica, è necessario innanzitutto iscriversi a eventi di rollout.
orderChildren Nella Live Copy, ordina gli elementi secondari (nodi), in base all’ordine della blueprint
referencesUpdate

Nella Live Copy, questa azione di sincronizzazione aggiorna i riferimenti come i collegamenti.
Cerca i percorsi nelle pagine Live Copy che puntano a una risorsa all’interno della blueprint. Quando viene trovato, aggiorna il percorso in modo che punti alla risorsa correlata all’interno della Live Copy (invece della blueprint). I riferimenti che hanno destinazioni esterne alla blueprint non vengono modificati.

Configure il servizio CQ MSM References Update Action per specificare i tipi di nodo, gli elementi di paragrafo e le proprietà di pagina da escludere.

targetVersion

Crea una versione della Live Copy.

Questa deve essere l’unica azione di sincronizzazione inclusa in una configurazione di rollout.
targetActivate

Attiva la Live Copy.

Questa deve essere l’unica azione di sincronizzazione inclusa in una configurazione di rollout.
targetDeactivate

Disattiva la Live Copy.

Questa deve essere l’unica azione di sincronizzazione inclusa in una configurazione di rollout.
flusso di lavoro

Avvia il flusso di lavoro definito dalla proprietà target (solo per le pagine) e considera la Live Copy come payload.

Il percorso di destinazione è il percorso del nodo modello.

 target: (Stringa) Il percorso del modello di flusso di lavoro.
obbligatorio

Imposta l'autorizzazione di diversi ACL nella pagina Live Copy in sola lettura per un gruppo di utenti specifico. Le seguenti ACL sono configurate:

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

Usa questa azione solo per le pagine.

 target: (Stringa) L'ID del gruppo per il quale stai impostando le autorizzazioni.
mandatoryContent

Imposta l'autorizzazione di diversi ACL nella pagina Live Copy in sola lettura per un gruppo di utenti specifico. Le seguenti ACL sono configurate:

  • ActionSet.ACTION_NAME_SET_PROPERTY
  • ActionSet.ACTION_NAME_ACL_MODIFY

Usa questa azione solo per le pagine.

 target: (Stringa) L'ID del gruppo per il quale stai impostando le autorizzazioni.
mandatoryStructure Imposta l'autorizzazione dell'ACL ActionSet.ACTION_NAME_REMOVE nella pagina Live Copy in sola lettura per un gruppo di utenti specifico. Usa questa azione solo per le pagine. target: (Stringa) L'ID del gruppo per il quale stai impostando le autorizzazioni.
VersionCopyAction Se la pagina blueprint/sorgente è stata pubblicata almeno una volta, crea una pagina Live Copy utilizzando la versione pubblicata. Nota: questa azione è disponibile solo per creare una pagina Live Copy basata su una pagina sorgente pubblicata e non per aggiornare una pagina Live Copy esistente.
PageMoveAction

PageMoveAction si applica quando una pagina è stata spostata nella blueprint.

L’azione copia invece di spostare la pagina Live Copy (correlata) dalla posizione prima dello spostamento alla posizione successiva.

PageMoveAction non modifica la pagina LiveCopy nella posizione precedente allo spostamento. Pertanto, per configurazioni rollout consecutive ha lo stato di un LiveRelationship senza Blueprint.

Configura il servizio Azione di spostamento di pagine di CQ MSM per specificare i tipi di nodo, gli elementi di paragrafo e le proprietà di pagina da escludere.

Questa deve essere l’unica azione di sincronizzazione inclusa in una configurazione di rollout.

prop_referenceUpdate: (Booleano) Imposta su true per aggiornare i riferimenti. Il valore predefinito è true.
productCreateUpdate Crea o aggiorna le risorse Prodotto all’interno di un catalogo. Questa azione è destinata a essere utilizzata in una delle situazioni seguenti:
  • Generazione o rollout di un catalogo (o sezione di catalogo)
  • Un utente ripristina l’ereditarietà di sincronizzazione per un componente di prodotto.
markLiveRelationship Indica una relazione live per il contenuto creato da un lancio.
catalogRolloutHooks Esegue gli hook di rollout specifici per la generazione del catalogo. Chiama i metodi executePageRolloutHooks ed executeProductRolloutHooks del di CatalogGenerator.
Consulta com.adobe.cq.commerce.pim.api.CatalogGenerator in Javadocs AEM.
productUpdate Aggiorna le pagine di prodotto in una Live Copy di un catalogo di prodotti

Creazione di una configurazione di rollout

È possibile creare una configurazione di rollout quando le configurazioni di rollout installate non soddisfano i requisiti dell'applicazione:

La nuova configurazione di rollout è quindi disponibile quando imposti le configurazioni di rollout su una pagina blueprint o Live Copy.

Esclusione delle proprietà e dei tipi di nodo dalla sincronizzazione

Puoi configurare diversi servizi OSGi che supportano le azioni di sincronizzazione corrispondenti in modo che non influiscano su proprietà e tipi di nodo specifici. Ad esempio, molte proprietà e sottonodi relativi al funzionamento interno di AEM non devono essere inclusi in una Live Copy. Deve essere copiato solo il contenuto rilevante per l’utente della pagina.

Quando si lavora con AEM esistono diversi metodi per gestire le impostazioni di configurazione di tali servizi; vedere Configurazione di OSGi per ulteriori dettagli e procedure consigliate.

Nella tabella seguente sono elencate le azioni di sincronizzazione per le quali è possibile specificare i nodi da escludere. La tabella fornisce i nomi dei servizi da configurare utilizzando la console Web e il PID per la configurazione tramite un nodo di archivio.

Azione di sincronizzazione Nome del servizio nella console Web Servizio PID
contentCopy CQ MSM Content Copy Action com.day.cq.wcm.msm.impl.actions.ContentCopyActionFactory
contentDelete CQ MSM Content Delete Action com.day.cq.wcm.msm.impl.actions.ContentDeleteActionFactory
contentUpdate CQ MSM Content Update Action com.day.cq.wcm.msm.impl.actions.ContentUpdateActionFactory
PageMoveAction CQ MSM Page Move Action com.day.cq.wcm.msm.impl.actions.PageMoveActionFactory
referencesUpdate CQ MSM References Update Action com.day.cq.wcm.msm.impl.actions.ReferencesUpdateActionFactory

La tabella seguente descrive le proprietà che puoi configurare:

Proprietà Console web / Proprietà OSGi Descrizione

Tipi di nodi esclusi

cq.wcm.msm.action.excludednodetypes

 Un’espressione regolare che corrisponde ai tipi di nodo che devono essere esclusi dall’azione di sincronizzazione.

Elementi di paragrafo esclusi

cq.wcm.msm.action.excludedparagraphitems

 Un'espressione regolare che corrisponde agli elementi di paragrafo da escludere dall’azione di sincronizzazione.

Proprietà pagina escluse

cq.wcm.msm.action.excludedprops

 Un’espressione regolare che corrisponde alle proprietà della pagina da escludere dall’azione di sincronizzazione.

Tipi di nodi Mixin ignorati

cq.wcm.msm.action.ignoredMixin

 Disponibile solo per l’azione di aggiornamento dei contenuti di CQ MSM. Un'espressione regolare che corrisponde ai nomi dei tipi di nodo mixin da escludere dall'azione di sincronizzazione.
NOTA

Nell’interfaccia classica, l’icona di blocco visualizzata nella finestra di dialogo Proprietà pagina per le pagine LiveCopy non riflette la configurazione della proprietà Proprietà pagina escluse. L’icona a forma di lucchetto viene visualizzata anche per le proprietà escluse dall’azione di sincronizzazione.

NOTA

Nell’interfaccia touch vedi anche Configurazione dei blocchi MSM nelle proprietà di pagina).

Azione di aggiornamento dei contenuti di CQ MSM - Esclusioni

Diverse proprietà e tipi di nodo sono esclusi per impostazione predefinita, questi sono definiti nella configurazione OSGi di Azione di aggiornamento dei contenuti di CQ MSM, Proprietà pagina escluse.

Per impostazione predefinita, le proprietà che corrispondono alle seguenti espressioni regolari vengono escluse (cioè non aggiornate) durante il rollout:

chlimage_1-18

Puoi modificare le espressioni che definiscono l’elenco di esclusione secondo le tue esigenze.

Ad esempio, se desideri includere il Titolo della pagina nelle modifiche considerate per il rollout, rimuovi jcr:title dalle esclusioni. Ad esempio, con il codice regex:

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

Configurazione della sincronizzazione per l’aggiornamento dei riferimenti

Puoi configurare diversi servizi OSGi che supportano le azioni di sincronizzazione corrispondenti, relative all’aggiornamento dei riferimenti.

Quando si lavora con AEM esistono diversi metodi per gestire le impostazioni di configurazione di tali servizi; vedere Configurazione di OSGi per ulteriori dettagli e procedure consigliate.

Nella tabella seguente sono elencate le azioni di sincronizzazione per cui è possibile specificare l’aggiornamento dei riferimenti. La tabella fornisce i nomi dei servizi da configurare utilizzando la console Web e il PID per la configurazione tramite un nodo di archivio.

Proprietà Console web / Proprietà OSGi Descrizione

Aggiornare il riferimento tra LiveCopy nidificate

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

 Disponibile solo per l’azione di aggiornamento dei riferimenti di CQ MSM. Seleziona questa opzione (Console web) o imposta questa proprietà booleana su true (configurazione archivio) per sostituire i riferimenti a qualsiasi risorsa all’interno del ramo della Live Copy principale.

Aggiornare le pagine di riferimento

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

 Disponibile solo per l’azione Sposta pagina di CQ MSM. Seleziona questa opzione (Console web) o imposta questa proprietà booleana su true (configurazione archivio) per aggiornare tutti i riferimenti per utilizzare la pagina originale per fare riferimento invece alla pagina LiveCopy.

Specifica delle configurazioni di rollout da utilizzare

MSM consente di specificare set di configurazioni di rollout che vengono utilizzate in genere e, quando necessario, è possibile sostituirle per specifiche Live Copy. MSM fornisce diverse posizioni per specificare le configurazioni di rollout da utilizzare. La posizione determina se la configurazione si applica a una Live Copy specifica.

Il seguente elenco di posizioni in cui è possibile specificare le configurazioni di rollout da utilizzare descrive come MSM determina quali configurazioni di rollout utilizzare per una Live Copy:

  • Proprietà pagina Live Copy: Quando una pagina Live Copy è configurata per l’utilizzo di una o più configurazioni di rollout, MSM utilizza tali configurazioni di rollout.
  • Proprietà pagina blueprint: Quando una Live Copy è basata su una blueprint e la pagina Live Copy non è configurata con una configurazione di rollout, viene utilizzata la configurazione di rollout associata alla pagina blueprint sorgente.
  • Proprietà della pagina padre della Live Copy: Quando né la pagina Live Copy né la pagina sorgente blueprint sono configurate con una configurazione di rollout, viene utilizzata la configurazione di rollout che si applica alla pagina padre della pagina Live Copy.
  • Impostazione predefinita del sistema: Quando non è possibile determinare la configurazione di rollout della pagina padre della Live Copy, viene utilizzata la configurazione di rollout predefinita del sistema.

Ad esempio, una blueprint utilizza il sito di riferimento We.Retail come contenuto sorgente. Un sito viene creato dalla blueprint. Ogni voce nell’elenco seguente descrive uno scenario diverso per quanto riguarda l’utilizzo delle configurazioni di rollout:

  • Nessuna delle pagine blueprint o Live Copy è configurata per l’utilizzo di una configurazione di rollout. MSM utilizza la configurazione di rollout predefinita del sistema per tutte le pagine Live Copy.
  • La pagina principale del sito di riferimento We.Retail è configurata con diverse configurazioni di rollout. MSM utilizza queste configurazioni di rollout per tutte le pagine Live Copy.
  • La pagina principale del sito di riferimento We.Retail è configurata con diverse configurazioni di rollout e la pagina principale del sito Live Copy è configurata con un diverso set di configurazioni di rollout. MSM utilizza le configurazioni di rollout configurate nella pagina principale del sito Live Copy.

Impostazione delle configurazioni di rollout per una pagina Live Copy

Configura una pagina Live Copy con le configurazioni di rollout da utilizzare quando la pagina sorgente viene soggetta a rollout. Per impostazione predefinita, le pagine secondarie ereditano la configurazione. Quando configuri la configurazione di rollout da utilizzare, sovrascrivi la configurazione che la pagina Live Copy eredita dal relativo elemento padre.

Puoi anche configurare le configurazioni di rollout per una pagina Live Copy quando crea la Live Copy.

  1. Utilizza la Sites per selezionare la pagina Live Copy.

  2. Seleziona Proprietà nella barra degli strumenti.

  3. Apri la scheda Live Copy.

    La sezione Configurazione mostra le configurazioni di rollout ereditate dalla pagina.

    chlimage_1-19

  4. Se necessario, regola il flag Ereditarietà Live Copy. Se questa opzione è selezionata, la configurazione Live Copy ha effetto su tutti gli elementi figlio.

  5. Elimina Eredita configurazione di rollout da padre , quindi seleziona una o più configurazioni di rollout dall'elenco.

    Le configurazioni di rollout selezionate vengono visualizzate sotto l’elenco a discesa.

    chlimage_1-20

  6. Tocca o fai clic su Salva.

Impostazione della configurazione di rollout per una pagina Blueprint

Configura una pagina blueprint con le configurazioni di rollout da utilizzare quando la pagina blueprint viene implementata.

Le pagine figlie della pagina blueprint ereditano la configurazione. Quando configuri la configurazione di rollout da utilizzare, potresti sovrascrivere la configurazione che la pagina eredita dal suo elemento padre.

  1. Utilizza la console Sites per selezionare la pagina principale della blueprint.
  2. Seleziona Proprietà nella barra degli strumenti.
  3. Apri la scheda Blueprint.
  4. Seleziona una o più Configurazioni di rollout con il selettore a discesa.
  5. Per confermare gli aggiornamenti, seleziona Salva.

Impostazione della configurazione di rollout predefinita del sistema

Specifica una configurazione di rollout da utilizzare come impostazione predefinita del sistema. Per specificare il valore predefinito, configura il servizio OSGi:

  • Day CQ WCM Live Relationship Manager
    il PID del servizio è
    com.day.cq.wcm.msm.impl.LiveRelationshipManagerImpl

Configura il servizio utilizzando Console web o nodo del repository.

  • Nella console web, il nome della proprietà da configurare è Default rollout config.
  • Utilizzando un nodo di archivio, il nome della proprietà da configurare è liverelationshipmgr.relationsconfig.default.

Imposta il valore di questa proprietà sul percorso della configurazione di rollout da utilizzare come impostazione predefinita del sistema. Il valore predefinito è /libs/msm/wcm/rolloutconfigs/default, che corrisponde alla Configurazione di rollout standard.

In questa pagina