DokumentationAEM GuidesDokumentation zu AEM Guides

Adobe Experience Manager Guides as a Cloud Service-Version Juli 2023

Last update: Sun Jul 14 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Themen:

Erstellt für:

  • Führungskraft

In diesem Versionshinweis werden die Aktualisierungsanweisungen, die Kompatibilitätsmatrix und die in Version Juli 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 Juli 2023.

Aktualisierung auf Version Juli 2023

Führen Sie die folgenden Schritte aus, um Ihr aktuelles AEM Guides as a Cloud Service-Setup zu aktualisieren:

  1. 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.
  2. Aktualisieren Sie die Eigenschaft <dox.version> in der Datei /dox/dox.installer/pom.xml Ihres Cloud Service-Git-Codes auf 2023.7.0.314.
  3. 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 Juli 2023 zu aktualisieren.

Schritte zum Aktivieren des Triggers eines Skripts über ein Servlet

(Nur wenn Sie eine Version verwenden, die vor der AEM Guides as a Cloud Service-Version vom Juni 2023 lag)

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.

NOTE
Sie sollten überprüfen, ob der Knoten noch vorhanden ist, und den Status des Auftrags überprüfen.
GET
http://<aem_domain>/var/dxml/executor-locks/translation-map-upgrade/1683190032886.json

(Nur wenn Sie eine Version verwenden, die vor der AEM Guides as a Cloud Service-Version vom Juni 2023 lag)

Führen Sie die folgenden Schritte aus, um den vorhandenen Inhalt nachzubearbeiten und den neuen Bericht zu fehlerhaften Links zu verwenden:

  1. (Optional) Wenn mehr als 100.000 Datendateien im System vorhanden sind, aktualisieren Sie den queryLimitReads unter org.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

  2. Führen Sie eine POST-Anfrage an den Server aus (mit der richtigen Authentifizierung) - http://<server:port>//bin/guides/reports/upgrade.

  3. 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)

  4. Sobald der Auftrag abgeschlossen ist, antwortet die vorherige GET-Anfrage erfolgreich. Wenn der Auftrag aus irgendeinem Grund fehlschlägt, kann in den Serverprotokollen ein Fehler angezeigt werden.

  5. Kehren Sie zurück zum standardmäßigen oder 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 verwenden, die vor der AEM Guides as a Cloud Service-Version vom Juni 2023 lag)

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:

  1. 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\>)

  2. 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.

  3. 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)

  4. Sobald der Auftrag abgeschlossen ist, 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 Juli 2023 unterstützt werden.

FrameMaker und FrameMaker Publishing Server

AEM Guides as a Cloud-Version
FMPS
FrameMaker
2023,07,0
Nicht kompatibel
2022 oder höher

Sauerstoffanschluss

AEM Guides as a Cloud-Version
Sauerstoff Connector Windows
Sauerstoff Connector Mac
In Oxygen Windows bearbeiten
In Oxygen Mac bearbeiten
2023,07,0
2.9-uuid-2
2.9-uuid-2
2,3
2,3

Behobene Probleme

Die in verschiedenen Bereichen behobenen Fehler sind unten aufgeführt:

Authoring

  • Inline-/Display-Attribute werden nicht in der Layout-Ansicht des Web-Editors angezeigt. (12498)
  • Hochladen von Dateien im Sauerstoff-Plugin für AEM Guides funktioniert nicht in Cloud-Services, wenn Sie haben ! im Dateinamen. (12207)
  • Die DITA-Map-Veröffentlichung ist mit bearbeitbaren Vorlagen sehr langsam. (12075)
  • Die Konfiguration der globalen Profil-Benutzeroberfläche stimmt nicht mit dem Ordnerprofil überein. (11970)
  • Inhaltsreferenzen sind beim Kopieren und Einfügen von DITA-Dateien fehlerhaft. (1959)
  • Inhaltsfragment kann nicht in der Spaltenansicht bearbeitet werden, wenn AEM Guides installiert ist. (7342)
  • Der Inhalt geht verloren, wenn sich eine entpackte xref unter einem untergeordneten Element-Tag befindet. (12532)

Veröffentlichung

  • Der Genehmigungs-Workflow funktioniert nicht, wenn in den Dateieigenschaften des rechten Bedienfelds document in "end state"geändert wird. (11026)
recommendation-more-help
11125c99-e1a1-4369-b5d7-fb3098b9b178