Führen Sie die folgenden Schritte durch, um zu steuern, wie und wann Live Copies mit ihren Quellinhalten synchronisiert werden sollen.
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.
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.
Jede Rollout-Konfiguration nutzt einen Rollout-Auslöser, der den Rollout auslöst. Rollout-Konfigurationen können einen der folgenden Auslöser 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.
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 Aktionen der installierten Rollout-Konfigurationen Ihre Anforderungen nicht erfüllen, können Sie eine neue Rollout-Konfiguration erstellen.
Name | Beschreibung | Auslöser | Synchronisierungsaktionen siehe Installierte Synchronisierungsaktionen |
---|---|---|---|
Standard-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. | Bei Rollout | contentUpdate contentCopy contentDelete referencesUpdate productUpdate orderChildren |
Bei Blueprint-Aktivierung aktivieren | Veröffentlicht die Live Copy, wenn die Quelle veröffentlicht wird. | Bei Aktivierung | targetActivate |
Bei Blueprint-Deaktivierung deaktivieren | Deaktiviert die Live Copy, wenn die Quelle deaktiviert wird. | Bei Deaktivierung | targetDeactivate |
Push bei Bearbeitung | Pusht die Inhalte zur Live Copy, wenn die Quelle bearbeitet wird. Nutzen Sie diese Rollout-Konfiguration möglichst selten, da sie den Auslöser „Bei Modifizierung“ verwendet. |
Bei Modifizierung | contentUpdate contentCopy contentDelete referencesUpdate orderChildren |
Push bei Bearbeitung (leicht) | Pusht Inhalte bei einer Änderung der Blueprint-Seite zur Live Copy, ohne die Verweise zu aktualisieren (z. B. für leichte Kopien). Nutzen Sie diese Rollout-Konfiguration möglichst selten, da sie den Auslöser „Bei Modifizierung“ verwendet. |
Bei Modifizierung | contentUpdate contentCopy contentDelete orderChildren |
Launch bewerben | Standard-Rollout-Konfigurationen zur Veröffentlichung von Startseiten. | Bei Rollout | contentUpdate contentCopy contentDelete referencesUpdate orderChildren markLiveRelationship |
Rollout-Konfiguration für Inhalt der Katalogseite | Wendet Seitenvorlagen aus einer Katalog-Blueprint an. | Bei Rollout | contentUpdate contentCopy contentDelete referencesUpdate productCreateUpdate orderChildren |
Rollout-Konfiguration für Aktualisierung der Katalogseite | Wendet die Zieleigenschaften einer Katalog-Blueprint an. Muss nach „Rollout-Konfiguration für Inhalt der Katalogseite“ ausgeführt werden. | Bei Rollout | catalogRolloutHooks |
DPS-Rollout-Konfiguration für Veröffentlichungen | DPS-Rollout-Konfiguration, die den Start eines Rollout-Prozesses auf den Rollout-Auslöser hin ermöglicht, während FolioProducer-Bindungseigenschaften beim anfänglichen Rollout ausgeschlossen werden. | Bei Rollout | contentUpdate contentCopy contentDelete referencesUpdate orderChildren dpsMetadataFilter |
Veraltete (5.6.0) Katalog-Rollout-Konfiguration | Entfernt. Verwenden Sie für Katalog-Rollouts Catalog Generator anstelle von MSM. | Bei Rollout | editProperties |
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 legt ihren Wert fest. Der Wert der editMap-Eigenschaft muss das folgende Format verwenden:
Die Elemente Betrachten Sie beispielsweise den folgenden Wert für editMap:
Dieser Wert bearbeitet die Eigenschaften der Live Copy-Knoten wie folgt:
|
editMap: (String) Identifiziert die Eigenschaft, den aktuellen Wert und den neuen Wert. Weitere Informationen finden Sie in der Beschreibung. |
Benachrichtigen | Sendet ein Seitenereignis, dass 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 | In der Live Copy werden durch diese Synchronisierung Verweise wie Links aktualisiert. Konfigurieren Sie den Service CQ MSM References Update Action, um die Knotentypen, Absatzelemente und Seiteneigenschaften zu definieren, die ausgeschlossen werden sollen. |
|
targetVersion | Erstellt eine Version der Live Copy. 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 Berechtigungen mehrerer ACLs auf der Live Copy-Seite für eine bestimmte Benutzergruppe auf Schreibzugriff fest. Die folgenden ACLs sind konfiguriert:
Nutzen Sie diese Aktion nur für Seiten. |
target: (String) Die ID der Gruppe, für die Sie Berechtigungen festlegen. |
mandatoryContent | Legt die Berechtigungen mehrerer ACLs auf der Live Copy-Seite für eine bestimmte Benutzergruppe auf Schreibzugriff fest. Die folgenden ACLs sind konfiguriert:
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 Schreibzugriff 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 (nicht: verschiebt) die zugehörige Live Copy-Seite vom Ort vor dem Verschieben zum Ort nach dem Verschieben. Die Aktion PageMoveAction ändert dabei die Live Copy-Seite am Ort vor dem Verschieben nicht. Für die nachfolgenden Rollout-Konfigurationen weist diese Seite daher den Status der Live-Beziehung ohne Blueprint auf. Konfigurieren Sie den Service CQ MSM Page Move Action, um die Knotentypen, Absatzelemente und Seiteneigenschaften festzulegen, die ausgeschlossen werden sollen. Diese Aktion muss die einzige Synchronisierungsaktion in einer Rollout-Konfiguration sein. |
prop_referenceUpdate: (boolescher Wert) Aktualisiert bei „true“ die Verweise. Der Standardwert ist „true“.
|
productCreateUpdate | Erstellt oder aktualisiert Produktressourcen in einem Katalog. Diese Aktion soll in einer der folgenden Situationen verwendet werden:
|
|
markLiveRelationship | Gibt an, dass eine Live-Beziehung für Inhalt vorhanden ist, der für den Launch erstellt wurde. | |
catalogRolloutHooks | Führt Rollout-Hooks aus, die speziell für die Katalogerstellung ausgelegt sind. Ruft die Methoden executePageRolloutHooks und executeProductRolloutHooks vom Catalog Generator ab. Siehe com.adobe.cq.commerce.pim.api.CatalogGenerator in den AEM-Javadocs. |
|
productUpdate | Aktualisiert Produktseiten in einer Live Copy eines Produktkatalogs |
Sie können eine Rollout-Konfiguration erstellen, wenn die installierten Rollout-Konfigurationen Ihre Anwendungsanforderungen nicht erfüllen:
Die neue Rollout-Konfiguration steht dann zur Verfügung, wenn Sie die Rollout-Konfigurationen auf einer Blueprint oder einer Live Copy-Seite festlegen.
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, von denen Sie Knoten ausschließen können. Die Tabelle führt die Namen der Services an, die mit der Web-Konsole und der PID mit Repository-Knoten konfiguriert werden.
Synchronisierungsaktion | Service-Name in der Web-Konsole | Service-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 |
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. |
In der klassischen Benutzeroberfläche spiegelt das Schlosssymbol, das im Dialogfeld „Seiteneigenschaften“ für Live Copy-Seiten angezeigt wird, nicht die Konfiguration der Eigenschaft „Ausgeschlossene Seiteneigenschaften“ wider. Dieses Symbol wird auch für Eigenschaften angezeigt, die von der Synchronisierungsaktion ausgeschlossen sind.
Informationen zur Touch-optimierten Benutzeroberfläche finden Sie unter Konfigurieren von MSM-Sperren für Seiteneigenschaften (Touch-optimierte Benutzeroberfläche).
Einige Eigenschaften und Knotentypen sind standardmäßig ausgeschlossen. Sie sind in der OSGi-Konfiguration der Aktion CQ MSM Content Update Action unter Ausgeschlossene Seiteneigenschaften definiert.
Standardmäßig werden Eigenschaften, die mit den folgenden regulären Ausdrücken übereinstimmen, 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)$).*
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 Verweisaktualisierung festlegen können. Die Tabelle führt die Namen der Services an, die mit der Web-Konsole und der PID mit Repository-Knoten konfiguriert werden.
Web-Konsoleneigenschaft/OSGi-Eigenschaft | Beschreibung |
---|---|
Referenz über verschachtelte Live Copies aktualisieren cq.wcm.msm.impl.action.referencesupdate.prop_updateNested |
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. |
Verweisende Seiten aktualisieren cq.wcm.msm.impl.actions.pagemove.prop_referenceUpdate |
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. |
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 Ort bestimmt, ob eine Konfiguration für eine bestimmte Live Copy gilt.
Die folgende Liste der Orte, unter denen Sie die zu verwendenden Rollout-Konfigurationen festlegen können, beschreibt, wie MSM bestimmt, welche Rollout-Konfigurationen für eine Live Copy genutzt werden:
Beispielsweise nutzt eine Blueprint die We.Retail-Referenzwebsite als Quellinhalt. Aus der Blueprint wird eine Website erstellt. Jedes Element der folgenden Liste beschreibt ein anderes Szenario hinsichtlich der Nutzung von Rollout-Konfigurationen:
Konfigurieren Sie eine Live Copy-Seite mit den Rollout-Konfigurationen, die beim Rollout der Quellseite genutzt 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 erbt.
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 Eigenschaft Rollout-Konfiguration aus übergeordnetem Element übernehmen und wählen Sie dann mindestens eine Rollout-Konfiguration aus der Liste aus.
Die ausgewählten Rollout-Konfigurationen werden unter der Dropdown-Liste angezeigt.
Klicken oder tippen Sie auf Speichern.
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 erben. Wenn Sie die zu verwendende Rollout-Konfiguration konfigurieren, überschreiben Sie die Konfiguration, die die Seite von der übergeordneten Seite erbt.
Legen Sie eine Rollout-Konfiguration fest, die als Systemstandard genutzt werden soll. Um die Standardkonfiguration festzulegen, konfigurieren Sie den OSGi-Dienst:
com.day.cq.wcm.msm.impl.LiveRelationshipManagerImpl
Konfigurieren Sie den Dienst entweder über die Web-Konsole oder einen Repository-Knoten.
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.