Konfigurerar Live Copy-synkronisering

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

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.

FÖRSIKTIGHET

Uppdatering eller ändring av en körklar (installerad) utrullningskonfiguration är inte rekommenderas. 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

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 ​Rolloutanvänds på den blå utskriftssidan eller så används kommandot ​Synkronisera på den aktiva kopieringssidan.

  • Vid ändring: Källsidan ändras.

  • Vid aktivering: Källsidan aktiveras.

  • Vid inaktivering: Källsidan är inaktiverad.

OBSERVERA

Om du använder On Modification-utlösaren kan det påverka prestandan. Mer information finns i MSM best practices.

Installerade utrullningskonfigurationer

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 ny 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 det möjligt att 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 targetActivate
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)

Överför innehåll till live-kopian när ritningssidan ändras, utan att uppdatera referenser (t.ex. 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 Standardutrullningskonfiguration för att marknadsföra 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-konfiguration som gör att du kan starta en utrullningsprocess vid utlösare för utrullning samtidigt som FolioProducer-bindningsegenskaper utesluts vid den första utrullningen Vid utrullning contentUpdate
contentCopy
contentDelete
referencesUpdate
orderChildren
dpsMetadataFilter
Konfiguration för äldre katalog (5.6.0) Ersatta. Använd Kataloggenerator i stället för MSM för kataloglanseringar. Vid utrullning editProperties

Installerade synkroniseringsåtgärder

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:

  • sling:resourceType-egenskaperna som antingen är inställda på contentpage eller på homepage är inställda på mobilecontentpage.
  • cq:template-egenskaperna som är inställda på contentpage är inställda på mobilecontentpage.

editMap: (String) Identifierar 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 du först prenumerera på utrullningshändelser.
orderChildren I den publicerade kopian ordnas 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 References Update Action Service 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.

targetActivate

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.

mål: (String) Sökvägen till arbetsflödesmodellen.
mandatory

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.

mål: (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.

mål: (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. mål: (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 CQ MSM Page Move Action- tjänsten 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 om du vill 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

Skapar en utrullningskonfiguration

Du kan skapa en rollout-konfiguration när de installerade rollout-konfigurationerna 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.

Exkluderar egenskaper och nodtyper från synkronisering

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 metoder 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 NodeTypes

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.
OBSERVERA

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.

OBSERVERA

I det pekoptimerade användargränssnittet finns även Konfigurera MSM-lås i Sidegenskaper (Touch-optimerat användargränssnitt).

CQ MSM Content Update Action - Exclusions

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

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

chlimage_1

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

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 metoder 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 till originalsidan så att de i stället refererar till LiveCopy-sidan.

Ange vilka utrullningskonfigurationer som ska användas

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:

  • Live copy-sidegenskaper: När en live copy-sida har konfigurerats för att använda en eller flera rollout-konfigurationer använder MSM dessa rollout-konfigurationer.
  • Egenskaper för designsidor:När en live-kopia baseras på en ritning, och den aktiva kopieringssidan inte har konfigurerats med en utrullningskonfiguration, används den utrullningskonfiguration 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 utrullningskonfiguration används den utrullningskonfiguration som gäller för den aktiva kopieringssidans överordnade sida.
  • Systemstandard: När utrullningskonfigurationen för den aktiva kopians överordnade sida inte kan bestämmas, används systemets standardkonfiguration för utrullning.

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 för alla live-kopieringssidor.
  • Rotsidan för referenswebbplatsen för Vi.Retail har konfigurerats med flera utrullningskonfigurationer. MSM använder dessa utrullningskonfigurationer 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.

Ange utrullningskonfigurationer för en Live Copy-sida

Konfigurera en sida med en live-kopia med de utrullningskonfigurationer som ska användas när källsidan rullas ut. 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-kopieringssida när du skapar live-kopian.

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

  2. Välj Egenskaper i verktygsfältet.

  3. Öppna fliken Live Copy.

    Avsnittet Konfiguration visar de rollout-konfigurationer som sidan ärver.

    chlimage_1-1

  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.

    chlimage_1-2

  6. Klicka eller tryck på Spara.

Ställa in utrullningskonfiguration för en blå sida

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

Observera att de underordnade sidorna för den blå sidan ä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 Blå.
  4. Välj en eller flera utrullningskonfigurationer med den nedrullningsbara väljaren.
  5. Behåll uppdateringarna med Spara.

Anger systemets standardkonfiguration för utrullning

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

  • Dag CQ WCM Live Relationship
    ManagerTjänst-PID är
    com.day.cq.wcm.msm.impl.LiveRelationshipManagerImpl

Konfigurera tjänsten med antingen webbkonsolen eller en databasnod.

  • I webbkonsolen är namnet på egenskapen som ska konfigureras som standardkonfiguration för utrullning.
  • Med hjälp av 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.

På denna sida