Version Oktober 2023 von Adobe Experience Manager Guides as a Cloud Service
Diese Versionshinweise enthalten die Upgrade-Anweisungen, die Kompatibilitätsmatrix und behobene Probleme in Version Oktober 2023 von Adobe Experience Manager Guides (später als AEM Guides as a Cloud Service bezeichnet).
Weitere Informationen zu den neuen Funktionen und Verbesserungen finden Sie unter Neue Funktionen in der Version vom Oktober 2023 von AEM Guides as a Cloud Service.
Upgrade auf Version Oktober 2023
Führen Sie ein Upgrade Ihres aktuellen AEM Guides as a Cloud Service-Setups durch, indem Sie die folgenden Schritte ausführen:
- Checken Sie den Git-Code der Cloud Services aus und wechseln Sie zu der Verzweigung, die in der Cloud Services-Pipeline konfiguriert ist und der Umgebung entspricht, die Sie aktualisieren möchten.
- Aktualisieren Sie
<dox.version>Eigenschaft in/dox/dox.installer/pom.xmlDatei Ihres Cloud Services-Git-Codes auf 2023.10.0.373. - Übernehmen Sie die Änderungen und führen Sie die Cloud Services-Pipeline aus, um auf die Version Oktober 2023 von AEM Guides as a Cloud Service zu aktualisieren.
Schritte zum Aktivieren des Triggers eines Skripts über ein Servlet
(Nur bei Versionen vor der Version Juni 2023 von AEM Guides as a Cloud Service)
Nach Abschluss der Installation können Sie den Trigger drücken, um den Übersetzungsauftrag zu starten:
BEITRAG:
http://localhost:4503/bin/guides/script/start?jobType=translation-map-upgrade
Antwort:
{
"msg": "Job is successfully submitted and lock node is created for future reference",
"lockNodePath": "/var/dxml/executor-locks/translation-map-upgrade/1683190032886",
"status": "SCHEDULED"
}
In der vorherigen Antwort-JSON enthält der lockNodePath den Pfad zum Knoten , der im Repository erstellt wurde und auf den gesendeten Auftrag verweist. Sie wird automatisch gelöscht, sobald der Auftrag abgeschlossen ist. Bis dahin können Sie in diesem Knoten den aktuellen Status des Auftrags abrufen.
Warten Sie, bis dieser Vorgang abgeschlossen ist, bevor Sie mit den nächsten Schritten fortfahren.
GET
http://<aem_domain>/var/dxml/executor-locks/translation-map-upgrade/1683190032886.json
Schritte zur Nachbearbeitung des vorhandenen Inhalts, um den Bericht über fehlerhafte Links zu verwenden
(Nur bei Versionen vor der Version Juni 2023 von AEM Guides as a Cloud Service)
Führen Sie die folgenden Schritte aus, um den vorhandenen Inhalt nachzuverarbeiten und den neuen Bericht „Beschädigter Link“ zu verwenden:
-
(Optional) Wenn mehr als 100.000 DITA-Dateien im System vorhanden sind, aktualisieren Sie die
queryLimitReadsunterorg.apache.jackrabbit.oak.query.QueryEngineSettingsServiceauf einen größeren Wert (einen beliebigen Wert, der größer ist als die Anzahl der vorhandenen Assets, z. B. 200.000) und stellen Sie dann erneut bereit.-
Verwenden Sie die Anweisungen im Abschnitt Konfigurationsüberschreibungen unter Installieren und Konfigurieren von Adobe Experience Manager Guides as a Cloud Service , um die Konfigurationsdatei zu erstellen.
-
Geben Sie in der Konfigurationsdatei die folgenden (Eigenschafts-)Details an, um die Option queryLimitReads zu konfigurieren:
table 0-row-3 1-row-3 PID Eigenschaftsschlüssel Eigenschaftswert org.apache.jackrabbit.oak.query.QueryEngineSettingsService queryLimitReads Wert: 200000 Standardwert: 100000
-
-
Ausführen einer POST-Anfrage an den Server (mit korrekter Authentifizierung) -
http://<server:port>//bin/guides/reports/upgrade. -
Die API gibt eine jobId zurück. Um den Auftragsstatus zu überprüfen, können Sie eine GET-Anfrage mit Auftrags-ID an denselben Endpunkt senden -
http://<server:port>/bin/guides/reports/upgrade?jobId= {jobId}
(Beispiel:http://localhost:8080/bin/guides/map-find/indexing?jobId=2022/9/15/7/27/7dfa1271-981e-4617-b5a4-c18379f11c42_678) -
Sobald der Auftrag abgeschlossen ist, antwortet die vorherige GET-Anfrage erfolgreich. Wenn der Vorgang aus irgendeinem Grund fehlschlägt, kann der Fehler in den Serverprotokollen angezeigt werden.
-
Setzen Sie den Standardwert oder den vorherigen vorhandenen Wert von
queryLimitReadszurück, wenn Sie ihn in Schritt 1 geändert haben.
Schritte zum Indizieren des vorhandenen Inhalts, um die neue Themenliste „Suchen und Ersetzen“ auf der Registerkarte „Berichte“ zu verwenden:
(Nur bei Versionen vor der Version Juni 2023 von AEM Guides as a Cloud Service)
Führen Sie die folgenden Schritte aus, um den vorhandenen Inhalt zu indizieren und den neuen Text „Suchen und Ersetzen“ auf Zuordnungsebene und in der Themenliste auf der Registerkarte „Berichte“ zu verwenden:
-
Führen Sie eine POST-Anfrage an den Server (mit korrekter Authentifizierung) -
http://<server:port\>/bin/guides/map-find/indexingaus. (Optional) Sie können bestimmte Pfade der Zuordnungen übergeben, um sie zu indizieren. Standardmäßig werden alle Zuordnungen indiziert || Beispiel:https://<Server:port\>/bin/guides/map-find/indexing?paths=<map\_path\_in\_repository\>) -
Sie können auch einen Stammordner übergeben, um die DITA-Zuordnungen eines bestimmten Ordners (und seiner Unterordner) zu indizieren. Beispiel:
http://<server:port\>/bin/guides/map-find/indexing?root=/content/dam/test. Beachten Sie, dass nur der Pfadparameter berücksichtigt wird, wenn sowohl der Pfadparameter als auch der Stammparameter übergeben werden. -
Die API gibt eine jobId zurück. Zur Überprüfung des Auftragsstatus können Sie eine GET-Anfrage mit Auftrags-ID an denselben Endpunkt senden -
http://<server:port\>/bin/guides/map-find/indexing?jobId=\{jobId\}(Beispiel:http://localhost:8080/bin/guides/map-find/indexing?jobId=2022/9/15/7/27/7dfa1271-981e-4617-b5a4-c18379f11c42) -
Sobald der Auftrag abgeschlossen ist, antwortet die vorherige GET-Anfrage mit Erfolg und gibt an, ob Zuordnungen fehlgeschlagen sind. Die erfolgreich indizierten Zuordnungen können aus den Serverprotokollen bestätigt werden.
Kompatibilitätsmatrix
In diesem Abschnitt finden Sie die Kompatibilitätsmatrix für die Softwareanwendungen, die von AEM Guides as a Cloud Service Version Oktober 2023 unterstützt werden.
FrameMaker und FrameMaker Publishing Server
Sauerstoffanschluss
Version der Wissensdatenbankvorlage
Behobene Probleme
Die in verschiedenen Bereichen behobenen Fehler sind unten aufgeführt:
Authoring
- Nachmittagsstunden sind in der Datum) nicht die Erstellung von Baselines festgelegt. 12712)
- Der JSON-Code kann nicht in das
<codeblock>des Web-Editors eingefügt werden. 12326) - Nicht gespeicherte Versionsänderungen und die zugehörigen Indikatoren werden bei großen Dateien nicht angezeigt. 11784)
- Beim Bearbeiten in koreanischer Sprache wird das erste Zeichen in die Standardeinstellung geändert. 10049)
Publishing
- Native PDF | Die Reihenfolge der Themen wird beim Generieren der PDF-Ausgabe nicht festgelegt. 13157)
- Native PDF| Für das Element
<p>ist kein Standardstil-Tag verfügbar. 12559) - Native PDF | Inline-Stile, die auf den Inhaltsbereich angewendet werden, werden nicht auf die Themen in Vorder- und Rückseite angewendet. 13510)
- Das
DeliveryTarget-Attribut wird beim Generieren der AEM-Site-Ausgabe nicht weitergegeben. 13132) - Der Veröffentlichen-Workflow bleibt beim Generieren der AEM-Site-Ausgabe für Inhalte mit bestimmten Fehlern stecken. 12000)
Verwaltung
- Der Versionsverlauf wird nicht angezeigt, auch wenn die
dc:format-Eigenschaft für ein Asset nicht vorhanden ist. 10463)
Überprüfung
- Die Überprüfung eines Themas zeigt falsche Kommentare an. 13453)
Übersetzung
-
Die vom Dashboard Übersetzung exportierte Baseline schlägt fehl und wird nicht in der Zielsprache geöffnet. 13466)
-
Neue Übersetzungsprojekte werden erstellt, anstatt neue Aufträge zu den ausgewählten vorhandenen Übersetzungsprojekten hinzuzufügen. 10214)
Bekanntes Problem
Adobe hat das folgende bekannte Problem für die Version vom Oktober 2023 identifiziert.
- Die erneute Veröffentlichung von Inhaltsfragmenten schlägt fehl.