Adobe Experience Manager Guides as a Cloud Service-Version vom Dezember 2023
In diesem Versionshinweis werden die Aktualisierungsanweisungen, die Kompatibilitätsmatrix und die in Version Dezember 2023 von Adobe Experience Manager Guides as a Cloud Service behobenen Probleme (später als Experience Manager Guides as a Cloud Service bezeichnet) beschrieben.
Weitere Informationen zu den neuen Funktionen und Verbesserungen finden Sie unter Neue Funktionen in der Experience Manager Guides as a Cloud Service-Version vom Dezember 2023.
Aktualisierung auf Version Dezember 2023
Führen Sie die folgenden Schritte aus, um Ihr aktuelles Experience Manager 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.xmlIhres Cloud Service-Git-Codes auf 2023.12.0.16. - Vergeben Sie die Änderungen und führen Sie die Cloud Service-Pipeline aus, um auf die Experience Manager Guides as a Cloud Service-Version vom Dezember 2023 zu aktualisieren.
Schritte zum Aktivieren des Triggers eines Skripts über ein Servlet
(Nur wenn Sie eine Version vor der Experience Manager 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. Sobald der Auftrag abgeschlossen ist, wird er automatisch gelöscht. In diesem Knoten können Sie den Status des Auftrags 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 Experience Manager 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 die
queryLimitReadsundqueryLimitInMemoryunterorg.apache.jackrabbit.oak.query.QueryEngineSettingsServiceauf 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 Optionen
queryLimitReadsundqueryLimitInMemoryzu konfigurieren:table 0-row-3 1-row-3 2-row-3 PID Eigenschaftenschlüssel Eigenschaftswert org.apache.jackrabbit.oak.query.QueryEngineSettingsService queryLimitReads Wert: 200000 Standardwert: 100000 org.apache.jackrabbit.oak.query.QueryEngineSettingsService queryLimitInMemory Wert: 200000 Standardwert: 100000
-
-
Führen Sie eine POST-Anfrage an den Server aus (mit der richtigen Authentifizierung) -
http://<server>//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>/bin/guides/reports/upgrade?jobId= {jobId}
(Beispiel:http://localhost:8080/bin/guides/reports/upgrade?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
queryLimitReadszurü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 Experience Manager 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 der richtigen 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_678) -
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.
Schritte zur Handhabung des 'fmdita rewriter'-Konflikts
Experience Manager Guides verfügt über ein benutzerdefinierter Sling-Rewriter -Modul für die Verarbeitung der im Fall von Querverweisen generierten Links (Links zwischen den Themen zweier verschiedener Maps).
Wenn Sie in Ihrer Codebasis über einen anderen benutzerdefinierten Sling-Rewriter verfügen, verwenden Sie einen 'order' -Wert größer als 50, da der Experience Manager Guides Sling-Rewriter 'order' 50 verwendet. Um dies zu überschreiben, benötigen Sie einen Wert > 50. Weitere Informationen finden Sie unter Pipelines zum Neuschreiben der Ausgabe.
Da während dieses Upgrades der Wert 'order' von 1000 auf 50 geändert wird, müssen Sie die vorhandene benutzerdefinierte Rewriter, falls vorhanden, mit 'fmdita-rewriter' zusammenführen.
Kompatibilitätsmatrix
In diesem Abschnitt wird die Kompatibilitätsmatrix für die Softwareanwendungen aufgelistet, die von der Experience Manager Guides as a Cloud Service-Version vom Dezember 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
- Der Titel auf der Registerkarte "Web Editor"wird nach einem Punkt(.) abgeschnitten. Zeichen. (14372)
- Fehlermeldungen für doppelte Zuordnungsnamen in der Assets-Benutzeroberfläche werden nicht aktualisiert. (14320)
- Bei der Versionserstellungslogik tritt beim Ziehen und Ablegen von Assets ein Fehler auf. (14291)
- Wiederverwendbare Inhalte überspringen die Element-IDs. (14213)
- Das Einstellungssteuerelement zum Ausblenden des Bereichs Sprachvariablen auf der Registerkarte Ausgabe fehlt. (14194)
- Der Web Editor gibt Anwendungsfehler aus, wenn ein neuer Verweis oder Thema mithilfe eines speziellen Schemas in der Layout-Ansicht hinzugefügt wird. (14094)
- Ein Ankerlink zum Element
<dlentry>oder<dt>zeigt den Link-Text nicht an. (13543) - Die Sammlung Favoriten im Web Editor kann nicht geladen werden. (13495)
- Zitate zeigen nicht anklickbare Links an, wenn sie mit einer eindeutigen ID mit Leerzeichen erstellt werden. (13447)
- In der Ansicht Layout für eine Lesekarte funktioniert die Verwendung von Nach rechts verschieben, um ein ausgewähltes Kapitel so zu gestalten, dass ein Unterelement nicht funktioniert. (12567)
- Das Vorschaufenster des XML-Editors wird in Google Chrome- und Microsoft Edge-Browsern abgeschnitten. (10755)
- Der Web Editor kann ein Element nicht in die möglichen übergeordneten Elemente einschließen. (8791)
Veröffentlichung
- Fmdita-Komponenten haben einen fest programmierten Pfad von
delegator.jsp, wodurch die Überlagerung von AEM Sites-Komponenten verhindert wird. (13993) - Die getaggte Ansicht des PDF-Reaktors in der Ausgabe der nativen PDF-Veröffentlichung funktioniert nicht erwartungsgemäß. (13622)
- AEM Site-Veröffentlichung tritt beim Übertragen an den Datenspeicher für große Maps mit Perimeter-Peer-Links auf ein Problem auf. (13531)
- Eine Site kann nicht über das Dashboard für die Massenveröffentlichung von Experience Manager Guides aktiviert werden. (13439)
- Die Lokalisierung der Elementbeschriftungen funktioniert in der AEM Sites-Ausgabe nicht ordnungsgemäß. (12144)
- Fehlende Option ditaval in Ausgabevorgaben auf Ordnerprofilebene, die über die Web Editor-Benutzeroberfläche erstellt wurden. (1903)
Verwaltung
- AEM Cloud-Umgebungen stoßen aufgrund von großen Knoten auf eine MongoWrite-Ausnahme. (13509)
Übersetzung
- Die Schaltflächen Akzeptieren/Ablehnen werden fälschlicherweise für die automatische menschliche Übersetzung angezeigt. (14318)
- Internationalisierungsprobleme (i18n) treten während der Transformation nicht-englischer DITA-Dateien auf AEM Seiten auf. (14286)
- Übersetzte Inhalte können nicht mit temporären Übersetzungsprojekten synchronisiert werden. Der DITA XML-Editor-Übersetzungs-Assistent zeigt fälschlicherweise den Status Gestartet für genehmigte Aufträge an. (9938)
Barrierefreiheit
- Die Benutzeroberfläche der Autorenarbeitsfläche kann nicht durchsucht werden, da der Fokus im Themeneditor gefangen wird. (13517)
Bekanntes Problem
Adobe hat das folgende bekannte Problem für die Version Dezember 2023 identifiziert:
- Beim Upgrade auf die Version vom Dezember 2023 tritt zeitweise der Fehler "Ungültige DTD-Fehler erhalten"auf.