Verwalten von freigegebenen DITA-Themenaktualisierungen und betroffenen Zuordnungsveröffentlichungen in Adobe Experience Manager Guides
In diesem Artikel werden die verfügbaren Ansätze zum Identifizieren und Verwalten von DITA-Zuordnungen erläutert, die betroffen sind, wenn ein freigegebenes Thema in Adobe Experience Manager (AEM)-Handbüchern aktualisiert wird, einschließlich manueller und benutzerdefinierter Automatisierungsoptionen.
Beschreibung description
Umgebung
- Handbücher zu Adobe Experience Manager (AEM)
Problem/Symptome
- Wenn ein freigegebenes DITA-Thema in mehreren DITA-Zuordnungen in AEM Guides wiederverwendet wird, werden bei einer Aktualisierung des Themas nicht automatisch alle betroffenen Zuordnungen identifiziert.
- Durch die Aktualisierung des Themas wird nicht automatisch Trigger für die Neuerstellung und erneute Veröffentlichung der betroffenen Karten erzeugt.
- Das Bedienfeld „Verweise“ (
>„Verweise“ in verwendet) kann zum Anzeigen von Referenzbeziehungen zwischen Themen und Zuordnungen verwendet werden. Es gibt jedoch keine integrierte API oder einen integrierten Workflow, um alle betroffenen Karten nach einer Themenaktualisierung automatisch zu identifizieren, neu zu generieren und erneut zu veröffentlichen. - Benutzerdefinierte Entwicklung ist erforderlich, um eine vollständige Automatisierung für dieses Szenario zu erreichen.
Lösung resolution
Gehen Sie wie folgt vor, um betroffene DITA-Zuordnungen nach einer Aktualisierung des freigegebenen Themas zu identifizieren und erneut zu veröffentlichen:
-
Verwenden Sie das Bedienfeld Verweise in AEM Guides, um alle DITA-Zuordnungen, die auf ein geändertes Thema verweisen, manuell zu identifizieren.
-
Um den Veröffentlichungsstatus der betroffenen Karten zu ermitteln, überprüfen Sie die Veröffentlichungsprotokolle für jede Karte oder verwenden Sie verfügbare APIs, um den Veröffentlichungsstatus zu überprüfen.
-
Implementieren Sie zur Automatisierung einen benutzerdefinierten Workflow oder Ereignis-Handler in AEM:
a. Konfigurieren Sie einen Backend-Listener (z. B. einen OSGi-
ResourceChangeListener, eine JCR-Beobachtung oder einen Workflow-Starter), um Speicherereignisse in DITA-Themen zu erkennen.B. Wenn ein Thema aktualisiert wird, fragen Sie das Repository ab, um alle referenzierenden Zuordnungen mithilfe der Referenzdaten zu finden.
C. Für jede betroffene Zuordnung wird mithilfe der verfügbaren Veröffentlichungs-APIs oder Workflows eine Trigger-Ausgabe generiert und veröffentlicht.
d. Implementieren Sie Logik, um doppelte oder sich überschneidende Veröffentlichungsaufträge zu verhindern, z. B. durch Überprüfen von Auftragswarteschlangen oder Verwenden eindeutiger Auftragskennungen.
-
Stellen Sie nach der Implementierung der Automatisierung sicher, dass beim Aktualisieren eines freigegebenen Themas die Regenerierung und erneute Veröffentlichung aller betroffenen Trigger erwartungsgemäß erfolgt.