Configurazione della sincronizzazione di una Live Copy configuring-live-copy-synchronization
Last update: Sun Jul 14 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
Argomenti:
Creato per:
Amministratore
Per controllare come e quando le Live Copy vengono sincronizzate con il loro contenuto sorgente, esegui le seguenti attività.
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 installed-and-custom-rollout-configurations
Questa sezione fornisce informazioni sulle configurazioni di rollout installate e sulle azioni di sincronizzazione da esse utilizzate, nonché su come creare configurazioni personalizzate, se necessario.
CAUTION
L'aggiornamento o la modifica di una configurazione di rollout preconfigurata (installata) è non consigliato. Se è necessaria un’azione live personalizzata, questa deve essere aggiunta in una configurazione di rollout personalizzata.
Attivatori di rollout rollout-triggers
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 momento del rollout: il comando Rollout è utilizzato nella pagina blueprint oppure il comando Sincronizza è 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.
NOTE
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 installed-rollout-configurations
Nella tabella seguente sono elencate le configurazioni di rollout installate con AEM. La tabella include le azioni di attivazione e sincronizzazione di ogni configurazione di rollout. Se le azioni di configurazione rollout installate non soddisfano i requisiti, puoi creare una configurazione di rollout.
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.
Configurazione rollout dell'aggiornamento pagina del catalogo
Applica le proprietà di destinazione da una blueprint del catalogo. Deve essere eseguito dopo la configurazione del rollout del contenuto della pagina del catalogo.
Al momento del rollout
catalogRolloutHooks
Configurazione rollout pubblicazioni DPS
Configurazione rollout della pubblicazione DPS che consente di avviare il processo di rollout all’attivazione del rollout ed escludere le proprietà di associazione FolioProducer al rollout iniziale
Obsoleto. Utilizza Catalog Generator invece di MSM per i rollout del catalogo.
Al momento del rollout
editProperties
Azioni di sincronizzazione installate installed-synchronization-actions
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 apportate dal sorgente. 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 quali proprietà vengono modificate e il relativo valore. Il valore della proprietà editMap deve utilizzare il formato seguente:
Questo valore modifica le proprietà dei nodi Live Copy come segue:
Le proprietà sling:resourceType impostate su contentpage o homepage sono impostate su mobilecontentpage.
Le proprietà cq:template impostate su contentpage sono impostate su mobilecontentpage.
editMap: (String) identifica la proprietà, il valore corrente e il nuovo valore. Per informazioni, vedere la descrizione.
notifica
Invia un evento di pagina per indicare che è stato eseguito il rollout della pagina. 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. Una volta trovato, aggiorna il percorso in modo che punti alla risorsa correlata all’interno della Live Copy (anziché alla blueprint). I riferimenti che hanno destinazioni esterne alla blueprint non vengono modificati.
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 accetta la Live Copy come payload.
Il percorso di destinazione è il percorso del nodo del modello.
destinazione: (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 determinato gruppo di utenti. Sono configurate le seguenti ACL:
ActionSet.ACTION_NAME_REMOVE
ActionSet.ACTION_NAME_SET_PROPERTY
ActionSet.ACTION_NAME_ACL_MODIFY
Utilizza questa azione solo per le pagine.
target: (stringa) ID del gruppo per il quale si stanno impostando le autorizzazioni.
mandatoryContent
Imposta l’autorizzazione di diversi ACL nella pagina Live Copy in sola lettura per un determinato gruppo di utenti. Sono configurate le seguenti ACL:
ActionSet.ACTION_NAME_SET_PROPERTY
ActionSet.ACTION_NAME_ACL_MODIFY
Utilizza questa azione solo per le pagine.
target: (stringa) ID del gruppo per il quale si stanno 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. Utilizza questa azione solo per le pagine.
target: (stringa) ID del gruppo per il quale si stanno 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 la creazione di una pagina Live Copy basata su una pagina sorgente pubblicata e non per l’aggiornamento di una pagina Live Copy esistente.
PageMoveAction
La proprietà PageMoveAction si applica quando una pagina è stata spostata nella blueprint.
L’azione copia e non sposta la pagina Live Copy (correlata) dalla posizione prima dello spostamento a quella successiva.
PageMoveAction non modifica la pagina LiveCopy nella posizione in cui si trovava prima dello spostamento. Pertanto, per configurazioni di rollout consecutive ha lo stato di LiveRelationship senza blueprint.
Questa deve essere l’unica azione di sincronizzazione inclusa in una configurazione di rollout.
prop_referenceUpdate: (booleano) Impostare 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 seguenti situazioni:
Generazione o rollout di un catalogo (o di una sezione di catalogo)
Un utente ripristina l’ereditarietà della sincronizzazione per un componente prodotto.
markLiveRelationship
Indica che esiste una relazione live per il contenuto creato da un lancio.
catalogRolloutHooks
Esegue gli hook di rollout specifici della generazione del catalogo. Chiama i metodi executePageRolloutHooks e executeProductRolloutHooks di CatalogGenerator. Consulta com.adobe.cq.commerce.pim.api.CatalogGenerator nei documenti Java AEM.
productUpdate
Aggiorna le pagine dei prodotti in una Live Copy di un catalogo dei prodotti
Creazione di una configurazione di rollout creating-a-rollout-configuration
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 excluding-properties-and-node-types-from-synchronization
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 dell’AEM non devono essere inclusi in una Live Copy. Deve essere copiato solo il contenuto rilevante all’utente della pagina.
Quando si lavora con AEM, esistono diversi metodi per gestire le impostazioni di configurazione per tali servizi; vedere Configurazione di OSGi per ulteriori dettagli e le 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 con un nodo dell’archivio.
La tabella seguente descrive le proprietà che puoi configurare:
Proprietà Console Web / proprietà OSGi
Descrizione
Tipi di nodo esclusi
cq.wcm.msm.action.excludednodetypes
Un’espressione regolare che corrisponde ai tipi di nodo da escludere dall’azione di sincronizzazione.
Elementi di paragrafo esclusi
cq.wcm.msm.action.excludedparagraphitems
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 CQ MSM Content Update. Un’espressione regolare che corrisponde ai nomi dei tipi di nodo mixin che devono essere esclusi dall’azione di sincronizzazione.
NOTE
Nell'interfaccia classica, l'icona del lucchetto visualizzata nella finestra di dialogo Proprietà pagina per le pagine Live Copy non riflette la configurazione della proprietà Proprietà pagina escluse. L'icona di blocco viene visualizzata anche per le proprietà escluse dall'azione di sincronizzazione.
Azione di aggiornamento dei contenuti di CQ MSM - Esclusioni cq-msm-content-update-action-exclusions
Per impostazione predefinita sono escluse diverse proprietà e tipi di nodo definiti nella configurazione OSGi di Azione di aggiornamento dei contenuti di CQ MSM, in Proprietà pagina esclusa.
Per impostazione predefinita le proprietà che corrispondono alle seguenti espressioni regolari sono escluse (ovvero non aggiornate) al momento del rollout:
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 configuring-synchronization-for-updating-references
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 per tali servizi; vedere Configurazione di OSGi per ulteriori dettagli e le 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 con un nodo dell’archivio.
Disponibile solo per CQ MSM References Update Action. Seleziona questa opzione (Console web) o imposta questa proprietà booleana su true (configurazione archivio) per sostituire i riferimenti relativi a qualsiasi risorsa all’interno del ramo della Live Copy superiore.
Disponibile solo per l’azione di spostamento pagina di CQ MSM. Seleziona questa opzione (Console Web) o imposta questa proprietà booleana su true (configurazione archivio) per aggiornare eventuali riferimenti per utilizzare la pagina originale per fare riferimento invece alla pagina LiveCopy.
Specifica delle configurazioni di rollout da utilizzare specifying-the-rollout-configurations-to-use
MSM consente di specificare i set di configurazioni di rollout utilizzati in genere e, quando necessario, puoi eseguirne l’override 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 puoi specificare le configurazioni di rollout descrive come MSM determina quali usare 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.
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à pagina genitore della Live Copy: Quando né la pagina Live Copy né la pagina sorgente blueprint presentano una configurazione di rollout, viene utilizzata la configurazione di rollout che si applica alla pagina genitore della Live Copy.
Impostazione predefinita del sistema: Quando non è possibile determinare la configurazione di rollout della pagina genitore della Live Copy, viene utilizzata la configurazione predefinita del sistema.
Ad esempio, una blueprint utilizza il sito di riferimento We.Retail come contenuto sorgente. Viene creato un sito dalla blueprint. Ogni elemento nel seguente elenco descrive uno scenario diverso relativo all’utilizzo delle configurazioni di rollout:
Nessuna delle pagine blueprint o delle 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 root 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 root del sito di riferimento We.Retail è configurata con diverse configurazioni di rollout e la pagina root del sito Live Copy è configurata con un diverso set di configurazioni di rollout. MSM utilizza le configurazioni di rollout configurate nella pagina root del sito Live Copy.
Impostazione delle configurazioni di rollout per una pagina Live Copy setting-the-rollout-configurations-for-a-live-copy-page
Configura una pagina Live Copy con le configurazioni di rollout da utilizzare quando viene eseguito il rollout della pagina sorgente. 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 dalla pagina genitore.
Puoi anche configurare le configurazioni di rollout per una pagina Live Copy quando crei la Live Copy.
Utilizza la console Sites per selezionare la pagina Live Copy.
Seleziona Proprietà nella barra degli strumenti.
Apri la scheda Live Copy.
La sezione Configurazione mostra le configurazioni di rollout ereditate dalla pagina.
Se necessario, regola il flag Ereditarietà Live Copy. Se selezionato, la configurazione della Live Copy ha effetto su tutti gli elementi secondari.
Deseleziona la proprietà Eredita configurazione di rollout dall’elemento principale, quindi seleziona una o più configurazioni di rollout dall’elenco.
Le configurazioni di rollout selezionate vengono visualizzate sotto l’elenco a discesa.
Fai clic su Salva.
Impostazione della configurazione di rollout per una pagina blueprint setting-the-rollout-configuration-for-a-blueprint-page
Configura una pagina blueprint con le configurazioni di rollout da utilizzare quando la pagina blueprint è soggetta a rollout.
Le pagine figlie della pagina blueprint ereditano la configurazione. Quando imposti la configurazione di rollout da utilizzare, potresti sovrascrivere la configurazione che la pagina eredita dalla sua pagina principale.
Utilizza la console Sites per selezionare la pagina principale della blueprint.
Seleziona Proprietà nella barra degli strumenti.
Apri la scheda Blueprint.
Seleziona una o più Configurazioni di rollout con il selettore a discesa.
Per confermare gli aggiornamenti, seleziona Salva.
Impostazione della configurazione di rollout predefinita del sistema setting-the-system-default-rollout-configuration
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
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.
