AEM 6.4 hat das Ende der erweiterten Unterstützung erreicht und diese Dokumentation wird nicht mehr aktualisiert. Weitere Informationen finden Sie in unserer technische Unterstützung. Unterstützte Versionen suchen here.
Führen Sie die folgenden Schritte durch, um zu steuern, wie und wann Live Copies mit ihren Quellinhalten synchronisiert werden sollen.
Entscheiden Sie, ob vorhandene Rollout-Konfigurationen Ihren Anforderungen entsprechen oder ob Sie eine oder mehrere Konfigurationen erstellen müssen.
Legen Sie fest, welche Rollout-Konfigurationen für Ihre Live Copies verwendet werden sollen.
Installierte und benutzerdefinierte Rollout-Konfigurationen installed-and-custom-rollout-configurations
In diesem Abschnitt finden Sie Informationen zu den installierten Rollout-Konfigurationen und den von ihnen verwendeten Synchronisierungsaktionen. Außerdem erfahren Sie, wie Sie bei Bedarf benutzerdefinierte Konfigurationen erstellen.
CAUTION
Die Aktualisierung oder Änderung einer vordefinierten (installierten) Rollout-Konfiguration wird nicht empfohlen. Wenn eine benutzerdefinierte Live-Aktion erforderlich ist, sollte sie in einer benutzerdefinierten Rollout-Konfiguration hinzugefügt werden.
Rollout-Auslöser rollout-triggers
Jede Rollout-Konfiguration verwendet einen Rollout-Trigger, der den Rollout verursacht. Rollout-Konfigurationen können einen der folgenden Trigger verwenden:
Bei Rollout: Der Befehl Rollout wird auf der Blueprint-Seite genutzt oder der Befehl Synchronisieren wird auf der Live Copy-Seite verwendet.
Bei Modifizierung: Die Quellseite wird bearbeitet.
Bei Aktivierung: Die Quellseite wird aktiviert.
Bei Deaktivierung: Die Quellseite wird deaktiviert.
NOTE
Die Verwendung des Auslösers „Bei Modifizierung“ kann die Leistung beeinträchtigen. Weitere Informationen finden Sie in den Best Practices für MSM.
In der folgenden Tabelle sind die Rollout-Konfigurationen aufgeführt, die mit AEM installiert werden. Auslöser und Synchronisierungsaktionen jeder Rollout-Konfigurationen werden ebenfalls angegeben. Wenn die installierten Rollout-Konfigurationsaktionen Ihre Anforderungen nicht erfüllen, können Sie Erstellen einer neuen Rollout-Konfiguration.
Standard-Rollout-Konfiguration, die den Start des Rollout-Prozesses bei Rollout-Auslösern ermöglicht und Aktionen ausführt: Erstellen, Aktualisieren, Löschen von Inhalten und Sortierung untergeordneter Knoten.
Rollout-Konfiguration für Aktualisierung der Katalogseite
Wendet die Zieleigenschaften einer Katalog-Blueprint an. Muss nach der Rollout-Konfiguration des Katalogseiteninhalts ausgeführt werden.
Bei Rollout
catalogRolloutHooks
DPS-Rollout-Konfiguration für Veröffentlichungen
Rollout-Konfiguration für DPS-Veröffentlichung, die den Start des Rollout-Prozesses beim Rollout-Trigger ermöglicht, während FolioProducer-Bindungseigenschaften beim ersten Rollout ausgeschlossen werden
In der folgenden Tabelle sind die Synchronisierungsaktionen aufgeführt, die mit AEM installiert werden. Wenn die installierten Aktionen Ihre Anforderungen nicht erfüllen, können Sie eine neue Synchronisierungsaktion erstellen.
Aktionsname
Beschreibung
Eigenschaften
contentCopy
Wenn Knoten der Quelle in der Live Copy nicht vorhanden sind, kopieren Sie die Knoten in die Live Copy. Konfigurieren Sie den Service CQ MSM Content Copy Action, um die Knotentypen, Absatzelemente und Seiteneigenschaften zu definieren, die ausgeschlossen werden sollen.
contentDelete
Löscht Knoten der Live Copy, die in der Quelle nicht vorhanden sind. Konfigurieren Sie den Service CQ MSM Content Delete Action, um die Knotentypen, Absatzelemente und Seiteneigenschaften zu definieren, die ausgeschlossen werden sollen.
contentUpdate
Aktualisiert den Live Copy-Inhalt mit den Änderungen in der Quelle. Konfigurieren Sie den Service CQ MSM Content Update Action, um die Knotentypen, Absatzelemente und Seiteneigenschaften zu definieren, die ausgeschlossen werden sollen.
editProperties
Bearbeitet die Eigenschaften der Live Copy. Die editMap -Eigenschaft bestimmt, welche Eigenschaften bearbeitet werden und deren Wert. Der Wert der editMap -Eigenschaft muss das folgende Format verwenden:
Dieser Wert bearbeitet die Eigenschaften der Live Copy-Knoten wie folgt:
Die Eigenschaften sling:resourceType, die entweder auf contentpage oder homepage eingestellt sind, werden eingestellt auf mobilecontentpage.
Die cq:template-Eigenschaften, die auf contentpage eingestellt sind, werden eingestellt auf mobilecontentpage.
editMap: (String) Identifiziert die Eigenschaft, den aktuellen Wert und den neuen Wert. Weitere Informationen finden Sie in der Beschreibung .
notify
Sendet ein Seitenereignis, bei dem das Rollout der Seite erfolgt ist. Um Benachrichtigungen zu erhalten, müssen Benutzer zunächst Rollout-Ereignisse abonnieren.
orderChildren
Auf der Live Copy werden die untergeordneten Elemente (Knoten) basierend auf der Reihenfolge in der Blueprint sortiert
referencesUpdate
Auf der Live Copy aktualisiert diese Synchronisationsaktion Referenzen wie Links. Sie sucht in den Live Copy-Seiten Pfade, die auf eine Ressource in der Blueprint verweisen. Wenn sie solch einen Pfad gefunden hat, wird er so aktualisiert, dass er auf die zugehörige Ressource in der Live Copy (statt in der Blueprint) verweist. Verweise, die Ziele außerhalb der Blueprints aufweisen, werden nicht geändert.
Diese Aktion muss die einzige Synchronisierungsaktion in einer Rollout-Konfiguration sein.
targetActivate
Aktiviert die Live Copy.
Diese Aktion muss die einzige Synchronisierungsaktion in einer Rollout-Konfiguration sein.
targetDeactivate
Deaktiviert die Live Copy.
Diese Aktion muss die einzige Synchronisierungsaktion in einer Rollout-Konfiguration sein.
Workflow
Startet den Workflow, der durch die Zieleigenschaft definiert ist (nur für Seiten), und nutzt die Live Copy als Payload.
Der Zielpfad ist der Pfad des Modellknotens.
target: (String) Der Pfad zum Workflow-Modell.
mandatory
Legt die Berechtigung mehrerer ACLs auf der Live Copy-Seite für eine bestimmte Benutzergruppe auf schreibgeschützt fest. Die folgenden ACLs sind konfiguriert:
ActionSet.ACTION_NAME_REMOVE
ActionSet.ACTION_NAME_SET_PROPERTY
ActionSet.ACTION_NAME_ACL_MODIFY
Nutzen Sie diese Aktion nur für Seiten.
target: (String) Die ID der Gruppe, für die Sie Berechtigungen festlegen.
mandatoryContent
Legt die Berechtigung mehrerer ACLs auf der Live Copy-Seite für eine bestimmte Benutzergruppe auf schreibgeschützt fest. Die folgenden ACLs sind konfiguriert:
ActionSet.ACTION_NAME_SET_PROPERTY
ActionSet.ACTION_NAME_ACL_MODIFY
Nutzen Sie diese Aktion nur für Seiten.
target: (String) Die ID der Gruppe, für die Sie Berechtigungen festlegen.
mandatoryStructure
Legt die Berechtigung der ACL ActionSet.ACTION_NAME_REMOVE auf der Live Copy-Seite für eine bestimmte Benutzergruppe auf schreibgeschützt fest. Nutzen Sie diese Aktion nur für Seiten.
target: (String) Die ID der Gruppe, für die Sie Berechtigungen festlegen.
VersionCopyAction
Wenn die Blueprint/Quellseite mindestens einmal veröffentlicht wurde, wird eine Live Copy-Seite basierend auf der veröffentlichten Version erstellt. Anmerkung: Diese Aktion ist nur für das Erstellen einer Live Copy-Seite auf der Grundlage einer veröffentlichten Quellseite verfügbar, nicht für das Aktualisieren einer vorhandenen Live Copy-Seite.
PageMoveAction
PageMoveAction gilt, wenn eine Seite in die Blueprint verschoben wurde.
Die Aktion kopiert die (zugehörige) LiveCopy-Seite von der Position vor dem Verschieben an die Position nach, anstatt sie zu verschieben.
Die PageMoveAction ändert die LiveCopy-Seite am Speicherort vor dem Verschieben nicht. Daher hat RolloutConfigurations in Folge den Status einer LiveRelationship ohne Blueprint.
Diese Aktion muss die einzige Synchronisierungsaktion in einer Rollout-Konfiguration sein.
prop_referenceUpdate: (Boolesch) Auf true gesetzt, um Verweise zu aktualisieren. Der Standardwert ist "true".
productCreateUpdate
Erstellt oder aktualisiert Produktressourcen in einem Katalog. Diese Aktion sollte in einer der folgenden Situationen verwendet werden:
Erstellen oder Rollout eines Katalogs (oder Katalogabschnitts)
Ein Benutzer stellt die Synchronisierungsvererbung für eine Produktkomponente wieder her.
markLiveRelationship
Gibt an, dass eine Live-Beziehung für vom Launch erstellte Inhalte vorhanden ist.
catalogRolloutHooks
Führt Rollout-Hooks aus, die speziell für die Katalogerstellung ausgelegt sind. Ruft die Methoden executePageRolloutHooks und executeProductRolloutHooks des CatalogGenerator auf. Siehe com.adobe.cq.commerce.pim.api.CatalogGenerator in den AEM Javadocs.
productUpdate
Aktualisiert Produktseiten in einer Live Copy eines Produktkatalogs
Erstellen einer Rollout-Konfiguration creating-a-rollout-configuration
Die neue Rollout-Konfiguration steht dann zur Verfügung, wenn Sie die Rollout-Konfigurationen auf einer Blueprint oder einer Live Copy-Seite festlegen.
Ausschließen von Eigenschaften und Knotentypen von der Synchronisierung excluding-properties-and-node-types-from-synchronization
Sie können mehrere OSGi-Services konfigurieren, die die entsprechenden Synchronisierungsaktionen unterstützen, sodass sie sich nicht auf bestimmte Knotentypen und Eigenschaften auswirken. So sollten beispielsweise viele Eigenschaften und Unterknoten, die mit der internen Funktionstüchtigkeit von AEM zusammenhängen, nicht in einer Live Copy enthalten sein. Nur Inhalte, die für Benutzer der Seite relevant sind, sollten kopiert werden.
Beim Arbeiten mit AEM sind mehrere Methoden zum Verwalten der Konfigurationseinstellungen für solche Dienste verfügbar. Weitere Informationen und empfohlene Verfahren finden Sie unter Konfigurieren von OSGi.
In der folgenden Tabelle sind die Synchronisierungsaktionen aufgeführt, für die Sie die auszuschließenden Knoten angeben können. Die Tabelle enthält die Namen der Dienste, die mit der Web-Konsole konfiguriert werden sollen, und die PID für die Konfiguration mit einem Repository-Knoten.
In der folgenden Tabelle werden die Eigenschaften beschrieben, die Sie konfigurieren können:
Web-Konsoleneigenschaft/OSGi-Eigenschaft
Beschreibung
Ausgeschlossene Knotentypen
cq.wcm.msm.action.excludednodetypes
Ein regulärer Ausdruck, der die Knotentypen abgleicht, die von der Synchronisierungsaktion ausgeschlossen werden sollen.
Ausgeschlossene Absatzelemente
cq.wcm.msm.action.excludedparagraph.items
Ein regulärer Ausdruck, der die Absatzelemente abgleicht, die von der Synchronisierungsaktion ausgeschlossen werden sollen.
Ausgeschlossene Seiteneigenschaften
cq.wcm.msm.action.excludedprops
Ein regulärer Ausdruck, der die Seiteneigenschaften abgleicht, die von der Synchronisierungsaktion ausgeschlossen werden sollen.
Ignorierte Mixin-Knotentypen
cq.wcm.msm.action.ignoredMixin
Nur für die Aktion CQ MSM zum Aktualisieren von Inhalten verfügbar. Ein regulärer Ausdruck, der die Namen von Mixin-Knotentypen abgleicht, die von der Synchronisierungsaktion ausgeschlossen werden sollen.
NOTE
In der klassischen Benutzeroberfläche spiegelt das Sperrsymbol, das im Dialogfeld Seiteneigenschaften für Live Copy-Seiten angezeigt wird, nicht die Konfiguration der Eigenschaft Ausgeschlossene Seiteneigenschaften wider. Das Sperrsymbol wird auch für Eigenschaften angezeigt, die von der Synchronisierungsaktion ausgeschlossen sind.
Verschiedene Eigenschaften und Knotentypen sind standardmäßig ausgeschlossen. Sie werden in der OSGi-Konfiguration von CQ MSM Content Update Action, unter Ausgeschlossene Seiteneigenschaften.
Standardmäßig werden Eigenschaften, die den folgenden regulären Ausdrücken entsprechen, beim Rollout ausgeschlossen (d. h. nicht aktualisiert):
Sie können die Ausdrücke, die die Ausschlussliste definieren, bei Bedarf ändern.
Wenn Sie beispielsweise möchten, dass die Seite Title bei den Änderungen enthalten sein soll, die beim Rollout berücksichtigt werden, entfernen Sie jcr:title von den Ausschlüssen, z. B. mit dem regulären Ausdruck:
jcr:(?!(title)$).*
Konfigurieren der Synchronisierung für die Aktualisierung von Verweisen configuring-synchronization-for-updating-references
Sie können mehrere OSGi-Services konfigurieren, die die entsprechenden Synchronisierungsaktionen im Zusammenhang mit der Aktualisierung von Verweisen unterstützen.
Beim Arbeiten mit AEM sind mehrere Methoden zum Verwalten der Konfigurationseinstellungen für solche Dienste verfügbar. Weitere Informationen und empfohlene Verfahren finden Sie unter Konfigurieren von OSGi.
In der folgenden Tabelle sind die Synchronisierungsaktionen aufgeführt, für die Sie die Referenz-Aktualisierung angeben können. Die Tabelle enthält die Namen der Dienste, die mit der Web-Konsole konfiguriert werden sollen, und die PID für die Konfiguration mit einem Repository-Knoten.
Web-Konsoleneigenschaft/OSGi-Eigenschaft
Beschreibung
Referenz über verschachtelte Live Copies aktualisieren
Nur für die Aktion CQ MSM zum Aktualisieren von Verweisen verfügbar. Wählen Sie diese Option aus (Web-Konsole) oder legen Sie diese boolesche Eigenschaft auf „true“ fest (Repository-Konfiguration), um Verweise zu ersetzen, die auf eine Ressource verweisen, die sich in der Verzweigung der höchsten Live Copy befindet.
Nur für die Aktion CQ MSM zum Verschieben von Seiten verfügbar. Wählen Sie diese Option aus (Web-Konsole) oder legen Sie diese boolesche Eigenschaft auf true fest (Repository-Konfiguration), um alle Verweise so zu aktualisieren, dass sie die Originalseite nutzen, anstatt auf die Live Copy-Seite zu verweisen.
Festlegen der zu verwendenden Rollout-Konfigurationen specifying-the-rollout-configurations-to-use
Bei MSM können Sie Sätze von Rollout-Konfigurationen festlegen, die allgemein genutzt werden, und sie bei Bedarf für bestimmte Live Copies überschreiben. MSM bietet mehrere Orte, an denen Sie die zu verwendenden Rollout-Konfigurationen festlegen können. Der Speicherort bestimmt, ob die Konfiguration für eine bestimmte Live Copy gilt.
In der folgenden Liste der Orte, an denen Sie die zu verwendenden Rollout-Konfigurationen angeben können, wird beschrieben, wie MSM bestimmt, welche Rollout-Konfigurationen für eine Live Copy verwendet werden sollen:
Eigenschaften der Live Copy-Seite: Wenn eine Live Copy-Seite so konfiguriert ist, dass sie mindestens eine Rollout-Konfiguration verwenden soll, nutzt MSM diese Rollout-Konfigurationen.
Eigenschaften der Blueprint-Seiten: Wenn eine Live Copy auf einer Blueprint basiert und die Live Copy-Seite nicht mit einer Rollout-Konfiguration konfiguriert ist, wird die Rollout-Konfiguration genutzt, die mit der Blueprint-Quellseite verknüpft ist.
Eigenschaften der übergeordneten Live Copy-Seite: Wenn weder die Live Copy-Seite noch die Blueprint-Quellseite mit einer Rollout-Konfiguration konfiguriert ist, wird die Rollout-Konfiguration genutzt, die für die übergeordnete Live Copy-Seite gilt.
Systemstandard: Wenn die Rollout-Konfiguration der übergeordneten Live Copy-Seite nicht ermittelt werden kann, wird die standardmäßige Rollout-Konfiguration verwendet.
Beispielsweise nutzt eine Blueprint die We.Retail-Referenzwebsite als Quellinhalt. Aus der Blueprint wird eine Website erstellt. Jedes Element in der folgenden Liste beschreibt ein anderes Szenario in Bezug auf die Verwendung von Rollout-Konfigurationen:
Keine der Blueprint-Seiten oder die Live Copy-Seiten sind für die Verwendung einer Rollout-Konfiguration konfiguriert. MSM verwendet die standardmäßige Rollout-Konfiguration des Systems für alle Live Copy-Seiten.
Die Stammseite der Referenz-Site "We.Retail"ist mit mehreren Rollout-Konfigurationen konfiguriert. MSM verwendet diese Rollout-Konfigurationen für alle Live Copy-Seiten.
Die Stammseite der We.Retail-Referenz-Website ist für mehrere Rollout-Konfigurationen konfiguriert und die Stammseite der Live Copy-Website ist für einen anderen Satz an Rollout-Konfigurationen konfiguriert. MSM verwendet die Rollout-Konfigurationen, die auf der Stammseite der Live Copy-Site konfiguriert sind.
Festlegen der Rollout-Konfigurationen für eine Live Copy-Seite setting-the-rollout-configurations-for-a-live-copy-page
Konfigurieren Sie eine Live Copy-Seite mit den Rollout-Konfigurationen, die beim Rollout der Quellseite verwendet werden sollen. Untergeordnete Seiten erben diese Konfiguration standardmäßig. Wenn Sie die zu verwendende Rollout-Konfiguration konfigurieren, überschreiben Sie die Konfiguration, die die Live Copy-Seite von der übergeordneten Seite übernimmt.
Sie können die Rollout-Konfigurationen für eine Live Copy-Seite auch konfigurieren, wenn Sie die Live Copy erstellen.
Wählen Sie über die Sites-Konsole die Live Copy-Seite aus.
Wählen Sie in der Symbolleiste Eigenschaften aus.
Öffnen Sie die Registerkarte Live Copy.
Im Bereich Konfigurationen werden die Rollout-Konfigurationen angezeigt, die die Seite erbt.
Passen Sie bei Bedarf die Markierung Live Copy-Vererbung an. Bei Auswahl dieser Option gilt die Life Copy-Konfiguration für alle untergeordneten Elemente.
Löschen Sie die Rollout-Konfiguration von übergeordnetem Element übernehmen -Eigenschaft und wählen Sie dann eine oder mehrere Rollout-Konfigurationen aus der Liste aus.
Die ausgewählten Rollout-Konfigurationen werden unter der Dropdown-Liste angezeigt.
Klicken oder tippen Sie auf Speichern.
Festlegen der Rollout-Konfiguration für eine Blueprint-Seite setting-the-rollout-configuration-for-a-blueprint-page
Konfigurieren Sie eine Blueprint-Seite mit den Rollout-Konfigurationen, die beim Rollout der Blueprint-Seite genutzt werden sollen.
Beachten Sie, dass die untergeordneten Seiten der Blueprint-Seite die Konfiguration übernehmen. Wenn Sie die zu verwendende Rollout-Konfiguration konfigurieren, überschreiben Sie möglicherweise die Konfiguration, die die Seite von der übergeordneten Seite erbt.
Wählen Sie über die Sites-Konsole die Stammseite der Blueprint aus.
Wählen Sie in der Symbolleiste Eigenschaften aus.
Öffnen Sie die Registerkarte Blueprint.
Wählen Sie mit dem Dropdown-Selektor mindestens eine Rollout-Konfigurationen aus.
Übernehmen Sie die Aktualisierungen mit Speichern.
Festlegen der standardmäßigen Rollout-Konfiguration setting-the-system-default-rollout-configuration
Geben Sie eine Rollout-Konfiguration an, die als Systemstandard verwendet werden soll. Um den Standard anzugeben, konfigurieren Sie den OSGi-Dienst:
Day CQ WCM Live Relationship Manager Die Dienst-PID ist com.day.cq.wcm.msm.impl.LiveRelationshipManagerImpl
In der Web-Konsole ist der Name der zu konfigurierenden Eigenschaft Standardmäßige Rollout-Konfiguration.
Bei Verwendung eines Repository-Knotens ist der Name der zu konfigurierenden Eigenschaft liverelationshipmgr.relationsconfig.default.
Legen Sie diesen Eigenschaftswert auf den Pfad der Rollout-Konfiguration fest, die als Systemstandard genutzt werden soll. Der Standardwert ist /libs/msm/wcm/rolloutconfigs/default, was der Standard-Rollout-Konfiguration entspricht.
