Konfigurera Live Copy-synkronisering configuring-live-copy-synchronization

Utför följande uppgifter för att kontrollera hur och när live-kopior synkroniseras med källinnehållet.

  • Bestäm om befintliga utrullningskonfigurationer uppfyller dina krav eller om du behöver skapa en eller flera.
  • Ange de utrullningskonfigurationer som ska användas för dina livekopior.

Installerade och anpassade utrullningskonfigurationer installed-and-custom-rollout-configurations

I det här avsnittet finns information om de installerade rollout-konfigurationerna och de synkroniseringsåtgärder som de använder samt hur du skapar anpassade konfigurationer om det behövs.

CAUTION
Uppdatering eller ändring av en körklar (installerad) utrullningskonfiguration rekommenderas inte. Om det finns ett krav på en anpassad live-åtgärd bör den läggas till i en anpassad rollout-konfiguration.

Utlösare för utrullning rollout-triggers

Varje utrullningskonfiguration använder en utlösare som gör att utrullningen sker. Utrullningskonfigurationer kan använda någon av följande utlösare:

  • Vid utrullning: Kommandot Rollout används på den blå utskriftssidan, eller så används kommandot Synkronisera på den aktiva kopieringssidan.

  • Vid ändring: Källsidan har ändrats.

  • Vid aktivering: Källsidan är aktiverad.

  • Vid inaktivering: Källsidan är inaktiverad.

NOTE
Om du använder On Modification-utlösaren kan det påverka prestandan. Mer information finns i Bästa praxis för MSM.

Installerade utrullningskonfigurationer installed-rollout-configurations

I följande tabell visas de utrullningskonfigurationer som har installerats med AEM. Tabellen innehåller utlösar- och synkroniseringsåtgärderna för varje utrullningskonfiguration. Om de installerade rollout-konfigurationsåtgärderna inte uppfyller dina krav kan du skapa en rollout-konfiguration.

Namn
Beskrivning
Utlösare
Synkroniseringsåtgärder

, se även Installerade synkroniseringsåtgärder
Standardkonfiguration för utrullning
Standardkonfiguration för utrullning som gör att du kan starta en process vid utlösare för utrullning och kör åtgärder: skapa, uppdatera, ta bort innehåll och beställa underordnade noder.
Vid utrullning
contentUpdate
contentCopy
contentDelete
referencesUpdate
productUpdate
orderChildren
Aktivera vid aktivering av utkast
Publicerar live-kopian när källan publiceras.
Vid aktivering
targetActive
Inaktivera vid inaktivering av utkast
Inaktiverar live-kopian när källan inaktiveras.
Vid inaktivering
targetDeactivate
Skjut vid ändring

Flyttar innehållet till live-kopian när källan ändras.

Använd den här utrullningskonfigurationen sparsamt när den använder utlösaren Vid ändring.

Vid ändring
contentUpdate
contentCopy
contentDelete
referencesUpdate
orderChildren
Skjut på ändring (grund)

Flyttar innehåll till live-kopian när ritningssidan ändras, utan att uppdatera referenser (till exempel för tunna kopior).

Använd den här utrullningskonfigurationen sparsamt när den använder utlösaren Vid ändring.

Vid ändring
contentUpdate
contentCopy
contentDelete
orderChildren
Promote Launch
Standardkonfiguration för lansering av startsidor.
Vid utrullning
contentUpdate
contentCopy
contentDelete
referencesUpdate
orderChildren
markLiveRelationship
Konfiguration för innehållsållning för katalogsida
Använder sidmallar från en katalogplan.
Vid utrullning
contentUpdate
contentCopy
contentDelete
referencesUpdate
productCreateUpdate
orderChildren
Katalogsidans uppdateringskonfiguration
Använder målegenskaper från en katalogplan. Måste köras efter konfiguration för att visa innehåll på katalogsidan.
Vid utrullning
catalogRolloutHooks
DPS-publikationer, utrullningskonfiguration
DPS Publication-konfigurering som gör att du kan starta en utrullningsprocess vid utlösare för utrullning samtidigt som du exkluderar FolioProducer-bindningsegenskaper vid den första utrullningen
Vid utrullning
contentUpdate
contentCopy
contentDelete
referencesUpdate
orderChildren
dpsMetadataFilter
Konfiguration för äldre katalog (5.6.0)
Föråldrat. Använd Kataloggenerator i stället för MSM för kataloglanseringar.
Vid utrullning
editProperties

Installerade synkroniseringsåtgärder installed-synchronization-actions

I följande tabell visas de synkroniseringsåtgärder som har installerats med AEM. Om de installerade åtgärderna inte uppfyller dina krav kan du skapa en ny synkroniseringsåtgärd.

Åtgärdsnamn
Beskrivning
Egenskaper
contentCopy
När det inte finns några noder i källan på den aktiva kopian kopieras noderna till den aktiva kopian. Konfigurera CQ MSM Content Copy Action Service för att ange vilka nodtyper, styckeobjekt och sidegenskaper som ska uteslutas.
contentDelete
Tar bort noder i live-kopian som inte finns i källan. Konfigurera CQ MSM Content Delete Action-tjänsten för att ange vilka nodtyper, styckeobjekt och sidegenskaper som ska uteslutas.
contentUpdate
Uppdaterar innehållet i live-kopian med ändringarna från källan. Konfigurera CQ MSM Content Update Action-tjänsten för att ange vilka nodtyper, styckeobjekt och sidegenskaper som ska uteslutas.
editProperties

Redigerar egenskaper för live-kopian. Egenskapen editMap avgör vilka egenskaper som redigeras och deras värde. Värdet för egenskapen editMap måste ha följande format:

[property_name_1]#[current_value]#[nytt_värde],
[property_name_2]#[current_value]#[nytt_värde],
...,
[property_name_n]#[current_value]#[nytt_värde]

Objekten current_value och new_value är reguljära uttryck.

Ta till exempel följande värde för editMap:

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

Det här värdet redigerar egenskaperna för live-kopieringsnoderna enligt följande:

  • Egenskaperna sling:resourceType som antingen är inställda på contentpage eller homepage är inställda på mobilecontentpage.
  • Egenskaperna cq:template som är inställda på contentpage är inställda på mobilecontentpage.
editMap: (String) Anger egenskapen, det aktuella värdet och det nya värdet. Mer information finns i beskrivningen.
meddela
Skickar en sidhändelse om att sidan har rullats ut. För att kunna meddelas måste man först prenumerera på utrullningshändelser.
orderChildren
På live-kopian beställer den underordnade (noder), baserat på ordningen i ritningen
referencesUpdate

På den aktiva kopian uppdaterar den här synkroniseringsåtgärden referenser som länkar.
Söker efter sökvägar på live-kopieringssidorna som pekar på en resurs i planen. När den hittas uppdateras sökvägen till den relaterade resursen inuti live-kopian (i stället för ritningen). Referenser som har mål utanför planen ändras inte.

Konfigurera CQ MSM-referensuppdateringstjänsten för att ange vilka nodtyper, styckeobjekt och sidegenskaper som ska uteslutas.

targetVersion

Skapar en version av den aktiva kopian.

Den här åtgärden måste vara den enda synkroniseringsåtgärden som ingår i en utrullningskonfiguration.

targetActive

Aktiverar live-kopian.

Den här åtgärden måste vara den enda synkroniseringsåtgärden som ingår i en utrullningskonfiguration.

targetDeactivate

Inaktiverar live-kopian.

Den här åtgärden måste vara den enda synkroniseringsåtgärden som ingår i en utrullningskonfiguration.

arbetsflöde

Startar arbetsflödet som definieras av egenskapen target (endast för sidor) och tar live-kopian som nyttolast.

Målsökvägen är modellnodens sökväg.

target: (String) Sökvägen till arbetsflödesmodellen.
obligatoriskt

Anger behörighet för flera åtkomstkontrollistor på live-kopieringssidan som skrivskyddad för en viss användargrupp. Följande åtkomstkontrollistor är konfigurerade:

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

Använd den här åtgärden endast för sidor.

target: (String) ID:t för gruppen som du anger behörigheter för.
mandatoryContent

Anger behörighet för flera åtkomstkontrollistor på live-kopieringssidan som skrivskyddad för en viss användargrupp. Följande åtkomstkontrollistor är konfigurerade:

  • ActionSet.ACTION_NAME_SET_PROPERTY
  • ActionSet.ACTION_NAME_ACL_MODIFY

Använd den här åtgärden endast för sidor.

target: (String) ID:t för gruppen som du anger behörigheter för.
mandatoryStructure
Anger behörigheten för ACTIONSet.ACTION_NAME_REMOVE ACL på den aktiva kopieringssidan som skrivskyddad för en viss användargrupp. Använd den här åtgärden endast för sidor.
target: (String) ID:t för gruppen som du anger behörigheter för.
VersionCopyÅtgärd
Om utkast-/källsidan har publicerats minst en gång skapar en live-kopieringssida med den publicerade versionen. Obs! Den här åtgärden är bara tillgänglig för att skapa en live-kopia baserad på en publicerad källsida, inte för att uppdatera en befintlig live-kopia-sida.
PageMoveAction

PageMoveAction används när en sida har flyttats i utkastet.

Åtgärden kopierar i stället för att flytta (relaterad) LiveCopy-sidan från platsen före flytten till platsen efter.

PageMoveAction ändrar inte LiveCopy-sidan på platsen före flyttningen. Därför har den statusen LiveRelationship utan utkast för efterföljande RolloutConfigurations.

Konfigurera tjänsten CQ MSM Page Move Action för att ange vilka nodtyper, styckeobjekt och sidegenskaper som ska uteslutas.

Den här åtgärden måste vara den enda synkroniseringsåtgärden som ingår i en utrullningskonfiguration.

prop_referenceUpdate: (Boolean) Ange som true för att uppdatera referenser. Standardvärdet är true.
productCreateUpdate

Skapar eller uppdaterar produktresurser i en katalog. Den här åtgärden är avsedd att användas i följande situationer:

  • Generera eller distribuera en katalog (eller katalogavsnitt)
  • En användare återställer synkroniseringsarv för en produktkomponent.
markLiveRelationship
Anger att det finns en aktiv relation för startskapat innehåll.
catalogRolloutHooks
Kör kataloggenereringsspecifika rollout-hooks. Anropar metoderna executePageRolloutHooks och executeProductRolloutHooks i CatalogGenerator.
Se com.adobe.cq.commerce.pim.api.CatalogGenerator i AEM Javadocs.
productUpdate
Uppdaterar produktsidor i en live-kopia av en produktkatalog

Skapa en utrullningskonfiguration creating-a-rollout-configuration

Du kan skapa en utrullningskonfiguration när de installerade utrullningskonfigurationerna inte uppfyller dina programkrav:

Den nya utrullningskonfigurationen är sedan tillgänglig för dig när du ställer in utrullningskonfigurationer på en ritnings- eller Live copy-sida.

Exkludera egenskaper och nodtyper från synkronisering excluding-properties-and-node-types-from-synchronization

Du kan konfigurera flera OSGi-tjänster som stöder motsvarande synkroniseringsåtgärder så att de inte påverkar specifika nodtyper och egenskaper. Många egenskaper och delnoder som rör AEM interna funktion ska till exempel inte tas med i en live-kopia. Endast det innehåll som är relevant för sidans användare ska kopieras.

När du arbetar med AEM finns det flera metoder för att hantera konfigurationsinställningarna för sådana tjänster. Mer information och rekommenderade tillvägagångssätt finns i Konfigurera OSGi.

I följande tabell visas de synkroniseringsåtgärder som du kan ange vilka noder som ska uteslutas för. Tabellen innehåller namnen på tjänsterna som ska konfigureras med webbkonsolen och PID:t för konfigurering med en databasnod.

Synkroniseringsåtgärd
Tjänstnamn i webbkonsolen
Tjänst-PID
contentCopy
CQ MSM Content Copy-åtgärd
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 Sidflyttningsåtgärd
com.day.cq.wcm.msm.impl.actions.PageMoveActionFactory
referencesUpdate
Uppdateringsåtgärd för CQ MSM-referenser
com.day.cq.wcm.msm.impl.actions.ReferencesUpdateActionFactory

I följande tabell beskrivs egenskaperna som du kan konfigurera:

Egenskapen Web Console/OSGi
Beskrivning

Undantagna nodtyper

cq.wcm.msm.action.excludednodetypes

Ett reguljärt uttryck som matchar de nodtyper som ska uteslutas från synkroniseringsåtgärden.

Exkluderade styckeobjekt

cq.wcm.msm.action.excludedparagraphitems

Ett reguljärt uttryck som matchar styckeobjekten som ska uteslutas från synkroniseringsåtgärden.

Uteslutna sidegenskaper

cq.wcm.msm.action.excludedprops

Ett reguljärt uttryck som matchar sidegenskaperna som ska uteslutas från synkroniseringsåtgärden.

Ignorerade Mixin NodeType

cq.wcm.msm.action.ignoredMixin

Finns endast för CQ MSM Content Update Action. Ett reguljärt uttryck som matchar namnen på de mixin-nodtyper som ska uteslutas från synkroniseringsåtgärden.
NOTE
I det klassiska användargränssnittet återspeglar låsikonen som visas i dialogrutan Sidegenskaper för LiveCopy-sidor inte konfigurationen för egenskapen Uteslutna sidegenskaper. Låsikonen visas även för egenskaper som har undantagits från synkroniseringsåtgärden.
NOTE
I det pekoptimerade användargränssnittet visas även Konfigurera MSM-lås på sidegenskaper (pekoptimerat användargränssnitt).

CQ MSM Content Update Action - Exclusions cq-msm-content-update-action-exclusions

Flera egenskaper och nodtyper exkluderas som standard, de definieras i OSGi-konfigurationen för CQ MSM Content Update Action under Exkluderade sidegenskaper.

Som standard är egenskaper som matchar följande reguljära uttryck exkluderade (d.v.s. inte uppdaterade) vid utrullning:

CQ MSM-innehållsuppdateringsåtgärd

Du kan ändra uttrycken som definierar exkluderingslistan efter behov.

Om du till exempel vill att sidan Rubrik ska inkluderas i ändringarna som gäller för utrullning tar du bort jcr:title från undantagen. Med regex:

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

Konfigurerar synkronisering för uppdatering av referenser configuring-synchronization-for-updating-references

Du kan konfigurera flera OSGi-tjänster som stöder motsvarande synkroniseringsåtgärder som är relaterade till uppdatering av referenser.

När du arbetar med AEM finns det flera metoder för att hantera konfigurationsinställningarna för sådana tjänster. Mer information och rekommenderade tillvägagångssätt finns i Konfigurera OSGi.

I följande tabell visas de synkroniseringsåtgärder som du kan ange referensuppdatering för. Tabellen innehåller namnen på tjänsterna som ska konfigureras med webbkonsolen och PID:t för konfigurering med en databasnod.

Egenskapen Web Console/OSGi
Beskrivning

Uppdatera referens i kapslade LiveCopies

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

Endast tillgängligt för CQ MSM Reference Update Action. Välj det här alternativet (Webbkonsol) eller ange den här booleska egenskapen till true (databaskonfiguration) för att ersätta referenser som är avsedda för alla resurser som finns i grenen i den översta LiveCopy.

Uppdatera referenssidor

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

Endast tillgängligt för CQ MSM Sidflyttningsåtgärd. Välj det här alternativet (Webbkonsol) eller ange den här booleska egenskapen till true (databaskonfiguration) för att uppdatera referenser som använder originalsidan till att i stället referera till LiveCopy-sidan.

Ange vilka utrullningskonfigurationer som ska användas specifying-the-rollout-configurations-to-use

Med MSM kan du ange uppsättningar av utrullningskonfigurationer som används generellt, och när det behövs kan du åsidosätta dem för specifika live-kopior. MSM erbjuder flera platser för att ange vilka utrullningskonfigurationer som ska användas. Platsen avgör om konfigurationen gäller för en specifik live-kopia.

I följande lista över platser där du kan ange vilka rollout-konfigurationer som ska användas beskrivs hur MSM avgör vilka rollout-konfigurationer som ska användas för en live-kopia:

  • Egenskaper för Live-kopieringssida: När en live-kopieringssida har konfigurerats för att använda en eller flera rollout-konfigurationer använder MSM dessa rollout-konfigurationer.
  • Egenskaper för designsida: När en live-kopia baseras på en ritning, och live-kopieringssidan inte har konfigurerats med en utrullningskonfiguration, används den rollout-konfiguration som är associerad med den blå källsidan.
  • Egenskaper för överordnad sida för Live-kopia: När varken den aktiva kopieringssidan eller den blå källsidan har konfigurerats med en rollout-konfiguration används den rollout-konfiguration som gäller för den aktiva kopieringssidans överordnade sida.
  • Systemstandard: När det inte går att fastställa rollout-konfigurationen för Live-kopians överordnade sida, används systemets standardkonfiguration för rollout.

I en plan används till exempel referensplatsen We.Retail som källinnehåll. En webbplats skapas utifrån planen. Varje post i följande lista beskriver olika scenarier för användning av utrullningskonfigurationer:

  • Ingen av sidorna för utkast eller live-kopia är konfigurerad att använda en rollout-konfiguration. MSM använder systemets standardkonfiguration för utrullning av alla live-kopieringssidor.
  • Rotsidan för referenswebbplatsen för Vi.Retail har konfigurerats med flera utrullningskonfigurationer. MSM använder dessa rollout-konfigurationer för alla live-kopieringssidor.
  • Rotsidan för referenswebbplatsen We.Retail konfigureras med flera rollout-konfigurationer och rotsidan för den aktiva kopieringswebbplatsen konfigureras med en annan uppsättning rollout-konfigurationer. MSM använder de utrullningskonfigurationer som är konfigurerade på den aktiva kopians rotsida.

Ställa in utrullningskonfigurationer för en Live Copy-sida setting-the-rollout-configurations-for-a-live-copy-page

Konfigurera en live-kopieringssida med de utrullningskonfigurationer som ska användas när källsidan distribueras. Underordnade sidor ärver konfigurationen som standard. När du konfigurerar utrullningskonfigurationen att använda åsidosätter du konfigurationen som den aktiva kopieringssidan ärver från sin överordnade.

Du kan också konfigurera utrullningskonfigurationerna för en live-kopia-sida när du skapar live-kopian.

  1. Använd konsolen Webbplatser för att välja live-kopieringssidan.

  2. Välj Egenskaper i verktygsfältet.

  3. Öppna fliken Live-kopia.

    Avsnittet Konfiguration visar de utrullningskonfigurationer som sidan ärver.

    Konfiguration

  4. Justera flaggan Live Copy Arv om det behövs. Om det här alternativet är markerat gäller konfigurationen för live-kopian alla underordnade.

  5. Rensa egenskapen Ärv utrullningskonfiguration från överordnad och välj sedan en eller flera utrullningskonfigurationer i listan.

    De valda rollout-konfigurationerna visas under listrutan.

    Markerade utrullningskonfigurationer

  6. Klicka på Spara.

Ställa in utrullningskonfiguration för en blåtryckssida setting-the-rollout-configuration-for-a-blueprint-page

Konfigurera en ritningssida med de utrullningskonfigurationer som ska användas när ritningssidan rullas ut.

De underordnade sidorna för ritningssidan ärver konfigurationen. När du konfigurerar utrullningskonfigurationen att använda kan du åsidosätta konfigurationen som sidan ärver från sin överordnade.

  1. Använd konsolen Platser för att välja rotsidan i planen.
  2. Välj Egenskaper i verktygsfältet.
  3. Öppna fliken Utskrift.
  4. Välj en eller flera utrullningskonfigurationer med den nedrullningsbara väljaren.
  5. Behåll uppdateringarna med Spara.

Ställa in systemets standardkonfiguration för utrullning setting-the-system-default-rollout-configuration

Ange en utrullningskonfiguration som ska användas som systemstandard. Konfigurera OSGi-tjänsten om du vill ange standardvärdet:

  • Day CQ WCM Live Relationship Manager
    tjänstens PID är com.day.cq.wcm.msm.impl.LiveRelationshipManagerImpl

Konfigurera tjänsten med webbkonsolen eller en databasnod.

  • I webbkonsolen är namnet på egenskapen som ska konfigureras som standardkonfiguration för utrullning.
  • Med en databasnod är namnet på egenskapen som ska konfigureras liverelationshipmgr.relationsconfig.default.

Ange det här egenskapsvärdet som sökvägen till den utrullningskonfiguration som ska användas som systemstandard. Standardvärdet är /libs/msm/wcm/rolloutconfigs/default, som är standardkonfigurationen för utrullning.

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2