Version von Adobe Experience Manager Guides as a Cloud Service vom Oktober 2023
In diesem Versionshinweis werden die Aktualisierungsanweisungen, die Kompatibilitätsmatrix und die in Version Oktober 2023 von Adobe Experience Manager Guides behobenen Probleme (später als AEM Guides as a Cloud Service bezeichnet) beschrieben.
Weitere Informationen zu den neuen Funktionen und Verbesserungen finden Sie unter Neue Funktionen in der AEM Guides as a Cloud Service-Version vom Oktober 2023.
Aktualisierung auf Version Oktober 2023
Führen Sie die folgenden Schritte aus, um Ihr aktuelles AEM Guides as a Cloud Service-Setup zu aktualisieren:
- Sehen Sie sich den Git-Code des Cloud Service an und wechseln Sie zu der Verzweigung, die in der Cloud Service-Pipeline entsprechend der Umgebung konfiguriert ist, die Sie aktualisieren möchten.
- Aktualisieren Sie die Eigenschaft
<dox.version>
in der Datei/dox/dox.installer/pom.xml
Ihres Cloud Service-Git-Codes auf 2023.10.0.373. - Nehmen Sie die Änderungen vor und führen Sie die Cloud Service-Pipeline aus, um auf die AEM Guides as a Cloud Service-Version vom Oktober 2023 zu aktualisieren.
Schritte zum Aktivieren des Triggers eines Skripts über ein Servlet
(Nur wenn Sie eine Version vor der AEM Guides as a Cloud Service-Version vom Juni 2023 verwenden)
Nachdem Sie die Installation abgeschlossen haben, können Sie den Trigger drücken, um den Übersetzungsauftrag zu starten:
POST:
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 Schlüssel lockNodePath
den Pfad zum Knoten, der im Repository erstellt wurde und auf den gesendeten Auftrag verweist. Er wird automatisch gelöscht, sobald der Auftrag abgeschlossen ist. Bis dahin können Sie den aktuellen Status des Auftrags in diesem Knoten nachlesen.
Warten Sie, bis dieser Auftrag abgeschlossen ist, bevor Sie mit den nächsten Schritten fortfahren.
GET
http://<aem_domain>/var/dxml/executor-locks/translation-map-upgrade/1683190032886.json
Schritte zum Nachbearbeiten des vorhandenen Inhalts zur Verwendung des Berichts über einen fehlerhaften Link
(Nur wenn Sie eine Version vor der AEM Guides as a Cloud Service-Version vom Juni 2023 verwenden)
Führen Sie die folgenden Schritte für die Nachbearbeitung des vorhandenen Inhalts und die Verwendung des neuen Berichts über fehlerhafte Links aus:
-
(Optional) Wenn mehr als 100.000 DITA-Dateien im System vorhanden sind, aktualisieren Sie den
queryLimitReads
unterorg.apache.jackrabbit.oak.query.QueryEngineSettingsService
auf einen größeren Wert (ein beliebiger 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 (Eigenschaft-)Details an, um die Option queryLimitReads zu konfigurieren:
table 0-row-3 1-row-3 PID Eigenschaftenschlüssel Eigenschaftswert org.apache.jackrabbit.oak.query.QueryEngineSettingsService queryLimitReads Wert: 200000 Standardwert: 100000
-
-
Führen Sie eine POST-Anfrage an den Server aus (mit der richtigen Authentifizierung) -
http://<server:port>//bin/guides/reports/upgrade
. -
Die API gibt eine jobId zurück. Um den Status des Auftrags 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
) -
Nach Abschluss des Auftrags antwortet die vorherige GET-Anfrage erfolgreich. Wenn der Auftrag aus irgendeinem Grund fehlschlägt, kann in den Serverprotokollen ein Fehler angezeigt werden.
-
Setzen Sie den Standardwert oder den vorherigen vorhandenen Wert von
queryLimitReads
zurück, wenn Sie ihn in Schritt 1 geändert haben.
Schritte zum Indexieren des vorhandenen Inhalts zur Verwendung der neuen Suchen- und Ersetzen- und Themenliste auf der Registerkarte Berichte :
(Nur wenn Sie eine Version vor der AEM Guides as a Cloud Service-Version vom Juni 2023 verwenden)
Führen Sie die folgenden Schritte aus, um den vorhandenen Inhalt zu indizieren und den neuen Text auf Zuordnungs- und Themenliste auf der Registerkarte Berichte zu finden und zu ersetzen:
-
Führen Sie eine POST-Anfrage an den Server aus (mit korrekter Authentifizierung) -
http://<server:port\>/bin/guides/map-find/indexing
. (Optional: Sie können bestimmte Pfade der Maps übergeben, um sie zu indizieren. Standardmäßig werden alle Maps 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-Maps 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. Um den Auftragsstatus zu überprüfen, können Sie eine GET-Anfrage mit Auftrags-ID an denselben Endpunkt senden -
http://<server:port\>/bin/guides/map-find/indexing?jobId=\{jobId\}
(z. B.http://localhost:8080/bin/guides/map-find/indexing?jobId=2022/9/15/7/27/7dfa1271-981e-4617-b5a4-c18379f11c42
) -
Nach Abschluss des Auftrags antwortet die vorherige GET-Anfrage mit Erfolg und gibt an, ob Zuordnungen fehlgeschlagen sind. Die erfolgreich indizierten Maps können über die Serverprotokolle bestätigt werden.
Kompatibilitätsmatrix
In diesem Abschnitt wird die Kompatibilitätsmatrix für die Softwareanwendungen aufgelistet, die von der AEM Guides as a Cloud Service-Version vom Oktober 2023 unterstützt werden.
FrameMaker und FrameMaker Publishing Server
Sauerstoffanschluss
Knowledgebase-Vorlagenversion
Behobene Probleme
Die in verschiedenen Bereichen behobenen Fehler sind unten aufgeführt:
Authoring
- Nachmittagsstunden werden nicht im Datum für die Erstellung von Grundlinien festgelegt. (12712)
- Der JSON-Code kann nicht in das Element
<codeblock>
des Web-Editors eingefügt werden. (12326) - Nicht gespeicherte Versionsänderungen und die zugehörigen Indikatoren werden nicht für große Dateien angezeigt. (11784)
- Bei der Bearbeitung in koreanischer Sprache wird das erste Zeichen in den Standard geändert. (10049)
Veröffentlichung
- Native PDF | Die Reihenfolge der Themen wird bei der Erzeugung der PDF-Ausgabe nicht festgelegt. (13157)
- Native PDF| Für das Element
<p>
ist kein standardmäßiges Stil-Tag verfügbar. (12559) - Native PDF | Inline-Stile, die auf den Inhaltsbereich angewendet werden, werden nicht auf die Themen in der Vordergrund- und in der Rückseite angewendet. (13510)
- Das Attribut
DeliveryTarget
wird beim Generieren der AEM Site-Ausgabe nicht übernommen. (13132) - Der Arbeitsablauf Publish hängt beim Generieren AEM Site-Ausgabe für Inhalte mit bestimmten Fehlern. (12000)
Verwaltung
- Der Versionsverlauf wird nicht angezeigt, selbst wenn die Eigenschaft
dc:format
für ein Asset nicht vorhanden ist. (10463)
Überprüfung
- Die Themenüberprüfung zeigt falsche Kommentare an. (13453)
Übersetzung
-
Die vom Dashboard Übersetzung exportierte Grundlinie schlägt fehl und wird nicht in der Zielsprache geöffnet. (13466)
-
Anstatt den ausgewählten Übersetzungsprojekten neue Aufträge hinzuzufügen, werden neue Übersetzungsprojekte erstellt. (10214)
Bekanntes Problem
Adobe hat das folgende bekannte Problem für die Version Oktober 2023 identifiziert.
- Das erneute Veröffentlichen von Inhaltsfragmenten schlägt fehl.