DokumentationAEM 6.5Benutzerhandbuch

Migration der Assets und Dokumente von AEM Forms migrate-aem-forms-assets-and-documents

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Erstellt für:

  • Admin
  • Benutzende

Das Migrationsdienstprogramm konvertiert die Assets von adaptiven Formularen, Cloud-Konfigurationen und Correspondence Management-Assets von dem in früheren Versionen verwendeten Format in das in Adobe Experience Manager (AEM) 6.5 Forms verwendete Format. Wenn Sie das Migrationsdienstprogramm ausführen, werden folgende Elemente migriert:

  • Benutzerdefinierte Komponenten für adaptive Formulare
  • Adaptive Formulare und Correspondence Management-Vorlagen
  • Cloud-Konfigurationen
  • Assets für Correspondence Management und adaptive Formulare
NOTE
Bei einem nicht ersetzenden Upgrade können Sie die Migration für Correspondence Management-Assets jedes Mal ausführen, wenn Sie die Assets importieren. Für die Correspondence Management-Migration muss das Forms-Kompatibilitätspaket installiert worden sein.

Migrationsansatz approach-to-migration

Sie können ein Upgrade auf die neueste Version von AEM Forms 6.5 von AEM Forms 6.4, 6.3 oder 6.2 oder eine Neuinstallation durchführen. Je nachdem, ob Sie die vorherige Installation aktualisiert oder eine Neuinstallation durchgeführt haben, müssen Sie einen der folgenden Schritte ausführen:

Wenn eine ersetzende Aktualisierung erfolgt

Wenn Sie ein ersetzendes Upgrade durchgeführt haben, verfügt die aktualisierte Instanz bereits über die Assets und Dokumente. Bevor Sie die Assets und Dokumente verwenden können, müssen Sie jedoch das AEMFD-Kompatibilitätspaket installieren (enthält das Correspondence-Management-Kompatibilitätspaket).

Dann müssen Sie die Assets und Dokumente aktualisieren, indem Sie das Migrationsprogramm ausführen.

Bei einer nicht ersetzenden Installation

Wenn es sich um eine nicht ersetzende (neue) Installation handelt, bevor Sie die Assets und Dokumente verwenden können, müssen Sie das AEMFD-Kompatibilitätspaket (einschließlich des Correspondence Management-Kompatibilitätspakets) installieren.

Dann müssen Sie Ihr Asset-Paket (zip oder cmp) in das neue Setup importieren und anschließend die Assets und Dokumente aktualisieren, indem Sie das Migrationsdienstprogramm ausführen. Adobe empfiehlt, erst nach Ausführung des Migrationsdienstprogramms neue Assets im neuen Setup zu erstellen.

Aufgrund von Änderungen im Zusammenhang mit der Abwärtskompatibilität haben sich die Speicherorte einiger Ordner im CRX-Repository geändert. Sie müssen Abhängigkeiten (benutzerdefinierte Bibliotheken und Assets) manuell vom vorherigen Setup in eine neue Umgebung exportieren und importieren.

Vor dem Start der Migration prerequisites

Für Correspondence Management-Assets:

  • Für die Assets, die von der vorherigen Plattform importiert werden, wird eine Eigenschaft hinzugefügt: fd:version=1.0.
  • Seit AEM 6.1 Forms sind Kommentare nicht standardmäßig verfügbar. Die zuvor hinzugefügten Kommentare stehen in den Assets zur Verfügung, sind jedoch nicht automatisch auf der Oberfläche sichtbar. Sie müssen die Eigenschaft „extendedProperties“ in der AEM Forms-Benutzeroberfläche anpassen, um die Kommentare sichtbar zu machen.
  • In einigen früheren Versionen wie LiveCycle ES4 wurde Text mit dem Flex RichTextEditor bearbeitet, aber seit AEM 6.1 Forms wird der HTML-Editor verwendet. Dadurch können sich das Rendern und das Erscheinungsbild der Schriftarten, Schriftgrößen und Schriftartränder von früheren Versionen in der Autorenbenutzeroberfläche unterscheiden. Die gerenderten Briefe sehen jedoch gleich aus.
  • Listen in Textmodulen wurden verbessert und werden jetzt anders gerendert. Es kann visuelle Unterschiede geben. Adobe empfiehlt, dass Sie die Buchstaben rendern und sie betrachten, wo Sie Listen in Textmodulen verwenden.
  • Da Bildinhaltsmodule in DAM-Assets konvertiert und Layouts und Fragmente während der Migration zu Formularen hinzugefügt werden, wird die Eigenschaft „Aktualisiert von“ bei diesen Moduländerungen in „admin“ geändert.
  • Der Versionsverlauf der Assets wird nicht migriert und steht nach der Migration nicht zur Verfügung. Der nachfolgende Versionsverlauf wird nach der Migration beibehalten.
  • Der Status „Veröffentlichungsbereit“ wird seit AEM 6.1 Forms nicht mehr unterstützt, sodass alle Assets mit dem Status „Veröffentlichungsbereit“ den Status „Geändert“ erhalten.
  • Da die Benutzeroberfläche auf AEM Forms 6.3 aktualisiert wird, sind die Schritte für die Anpassung ebenfalls unterschiedlich. Wiederholen Sie die Anpassung, wenn Sie von einer älteren Version als 6.3 migrieren.
  • Layout-Fragmente werden von /content/apps/cm/layouts/fragmentlayouts/1001 nach /content/apps/cm/modules/fragmentlayouts verschoben. Der Datenwörterbuchverweis in Assets zeigt Pfad des Datenwörterbuchs anstatt dessen Namens an.
  • Alle Tabulatorzeichen, die für die Ausrichtung in Textmodulen verwendet werden, müssen angepasst werden. Weitere Informationen finden Sie unter Correspondence Management: Anordnen von Text mit Tabulatorabständen.
  • Die Asset Composer-Konfigurationen ändern sich zu Correspondence Management-Konfigurationen.
  • Assets werden in Ordner mit einem Namen wie „Existing Text“ oder „Existing List“ verschoben.

Verwenden des Migrationsdienstprogramms using-the-migration-utility

Ausführen des Migrationsdienstprogramms runningmigrationutility

Führen Sie das Migrationsdienstprogramm aus, bevor Sie Änderungen an den Assets vornehmen oder Assets erstellen. Adobe empfiehlt, das Dienstprogramm erst dann auszuführen, wenn Änderungen an den Assets vorgenommen oder Assets erstellt wurden. Stellen Sie sicher, dass die Benutzeroberfläche von Correspondence Management oder Adaptive Forms-Assets nicht geöffnet ist, während die Migration ausgeführt wird.

Wenn Sie das Migrationsdienstprogramm zum ersten Mal ausführen, wird ein Protokoll unter dem folgenden Pfad und mit dem folgenden Namen erstellt: \[aem-installation-directory]\cq-quickstart\logs\aem-forms-migration.log. Dieses Protokoll wird fortlaufend mit Informationen zu Correspondence Management und adaptiven Formularen aktualisiert, beispielsweise zum Verschieben von Assets.

NOTE
Stellen Sie vor dem Ausführen des Migrationsdienstprogramms sicher, dass Sie ein Backup Ihres CRX-Repositorys erstellt haben.

  1. Melden Sie sich in einer Browser-Sitzung bei der AEM-Autoreninstanz als Admin an.

  2. Öffnen Sie die folgende URL im Browser:

    https://[hostname]:[port]/[context_path]/libs/fd/foundation/gui/content/migration.html

    Der Browser zeigt vier Optionen an:

    • AEM Forms-Assets-Migration
    • Migration von benutzerdefinierten adaptiven Formularkomponenten
    • Migration von adaptiven Formularvorlagen
    • Migration von AEM Forms-Cloud-Konfigurationen

  3. Führen Sie die folgenden Schritte aus, um die Migration durchführen:

    • Um Assets zu migrieren, wählen Sie „AEM Forms – Asset-Migration“ und auf dem nächsten Bildschirm Migration beginnen aus. Die folgenden Elemente werden migriert:

      • Adaptive Formulare
      • Dokumentfragmente
      • Designs
      • Briefe
      • Datenwörterbücher
    note note
    NOTE
    Während der Asset-Migration treten möglicherweise Warnungen ähnlich der folgenden auf: „Konflikt aufgetreten bei …“. Solche Benachrichtigungen bedeuten, dass Regeln für einige Komponenten in adaptiven Formularen nicht migriert werden konnten. Beispiel: Wenn bei einer Komponente ein Ereignis auftritt, das sowohl Regeln als auch Skripte umfasst und wenn die Regeln nach einem Skript angewendet werden, wird keine der Regeln für die Komponente migriert. Allerdings können Sie diese Regeln migrieren, indem Sie den Regeleditor für das Authoring von adaptiven Formularen öffnen.

    • Um benutzerdefinierte Komponenten für adaptive Formulare zu migrieren, wählen Sie Migration benutzerdefinierter Komponenten für adaptive Formulare und auf der Seite „Migration von benutzerdefinierten Komponenten“ Migration beginnen aus. Die folgenden Elemente werden migriert:

      • benutzerdefinierte Komponenten für adaptive Formulare
      • Komponentenüberlagerungen, falls vorhanden

    • Um Vorlagen für adaptive Formulare zu migrieren, wählen Sie Migration von Vorlagen für adaptive Formulare und auf der Seite „Migration von benutzerdefinierten Komponenten“ Migration beginnen aus. Die folgenden Elemente werden migriert:

      • Adaptive Formularvorlagen, die unter /apps oder /conf mit dem AEM-Vorlageneditor erstellt wurden.

    • Migrieren Sie die Cloud-Konfigurations-Services von AEM Forms, um das neue kontextbezogene Cloud-Service-Paradigma zu nutzen, das die Touch-optimierte Benutzeroberfläche (unter /conf) umfasst. Wenn Sie Services der Cloud-Konfiguration von AEM Forms migrieren, werden die Cloud-Services in /etc nach /conf verschoben. Wenn keine Cloud-Service-Anpassungen vorliegen, die von den veralteten Pfaden (/etc) abhängen, empfiehlt Adobe, das Migrationsdienstprogramm direkt nach dem Upgrade auf 6.5 auszuführen und für alle weiteren Arbeiten die Touch-optimierte Cloud-Konfigurationsbenutzeroberfläche zu verwenden. Wenn Sie über Anpassungen für die bereits vorhandenen Cloud-Services verfügen, setzen Sie die Verwendung der klassischen Benutzeroberfläche bei der Aktualisierung so lange fort, bis die Anpassungen für die migrierten Pfade (/conf) abgeschlossen sind, und führen Sie erst dann das Migrationsdienstprogramm aus.

    Um Cloud-Dienste von AEM Forms zu migrieren, die Folgendes enthalten, wählen Sie „Migration von AEM Forms-Cloud-Konfigurationen“ aus (die Migration von Cloud-Konfigurationen ist unabhängig vom AEMFD-Kompatibilitätspaket). Wählen Sie „Migration von AEM Forms-Cloud-Konfigurationen“ aus und wählen Sie dann auf der Seite „Migration von Konfigurationen“ Migration beginnen aus.

    • Cloud-Services für das Formulardatenmodell

      • Quellpfad: /etc/cloudservices/fdm
      • Zielpfad: /conf/global/settings/cloudconfigs/fdm

    • reCAPTCHA

      • Quellpfad: /etc/cloudservices/recaptcha
      • Zielpfad: /conf/global/settings/cloudconfigs/recaptcha

    • Adobe Sign

      • Quellpfad: /etc/cloudservices/echosign
      • Zielpfad: /conf/global/settings/cloudconfigs/echosign

    • Cloud-Services für Typekit

      • Quellpfad: /etc/cloudservices/typekit
      • Zielpfad: /conf/global/settings/cloudconfigs/typekit

    Im Browser-Fenster wird während der Migration Folgendes angezeigt:

    • Wenn die Assets aktualisiert werden: Assets werden erfolgreich aktualisiert.
    • Wenn die Migration abgeschlossen ist: Die Migration für Assets wurde abgeschlossen.

    Wenn das Migrationsdienstprogramm ausgeführt wird, tut es Folgendes:

    • Fügt den Assets die Tags hinzu: Fügt das Tag „Correspondence Management: Migrierte Assets“/„Adaptive Formulare: Migrierte Assets“ zu den migrierten Assets hinzu, damit Benutzende die migrierten Assets ermitteln können. Wenn Sie das Migrationsdienstprogramm ausführen, werden alle im System vorhandenen Assets mit „Migriert“ markiert.
    • Erstellt Tags: Die Kategorien und Unterkategorien, die im Vorgängersystem vorhanden sind, werden als Tags erstellt, und dann werden diese Tags den entsprechenden Correspondence Management-Assets in AEM zugeordnet. Beispielsweise werden eine Kategorie (Schadensmeldungen) und eine Unterkategorie (Schadensmeldungen) einer Briefvorlage als Tags generiert.

  4. Fahren Sie nach der Ausführung des Migrationsdienstprogramms mit den Systemverwaltungsaufgaben fort.

Migrieren von Regeln mithilfe des Regeleditors migrate-rules

Diese Komponenten können migriert werden, indem sie im Regeleditor im Editor für adaptive Formulare geöffnet werden.

  • Um Regeln und Skripte (für die Aktualisierung von 6.3 nicht erforderlich) in benutzerdefinierten Komponenten zu migrieren, wählen Sie „Migration von benutzerdefinierten Komponenten für adaptive Formulare“ und auf dem nächsten Bildschirm „Migration beginnen“ aus. Die folgenden Elemente werden migriert:

    • Regeln und Skripten, erstellt mithilfe des Regel-Editors (6.1 FP1 und höher)

    • Skripte, erstellt mithilfe der Skript-Registerkarte in der Benutzeroberfläche von Version 6.1 oder niedriger

  • Um Vorlagen (für die Aktualisierung von 6.3 und 6.4 nicht erforderlich) zu migrieren, wählen Sie „Migration von Vorlagen für adaptive Formulare“ und auf dem nächsten Bildschirm „Migration beginnen“ aus. Die folgenden Elemente werden migriert:

    • Alte Vorlagen – Vorlagen für adaptive Formulare, erstellt unter /apps mithilfe von AEM 6.1 Forms oder niedriger. Dazu gehören die Skripten, die in den Vorlagenkomponenten definiert wurden.

    • Neue Vorlagen: Vorlagen für adaptive Formulare, die mithilfe des Vorlageneditors unter /conf erstellt werden. Das umfasst die Migration von Regeln und Skripten, die mithilfe des Regeleditors erstellt wurden.

Systemverwaltungsaufgaben nach Ausführung des Migrationsdienstprogramms housekeepingtasks

Nachdem Sie das Migrationsdienstprogramm ausgeführt haben, führen Sie folgende Systemverwaltungsaufgaben durch:

  1. Stellen Sie sicher, dass XFA-Version 3.3 oder eine spätere Version von Layouts und Fragment-Layouts verwendet wird. Wenn Sie Layouts und Fragment-Layouts einer älteren Version benutzen, könnte es Probleme beim Rendern des Briefs geben. Um älteres XFA auf die neueste Version zu aktualisieren, führen Sie folgende Schritte aus:

    1. Herunterladen von XFA- als ZIP-Datei aus der Forms-Benutzeroberfläche.
    2. Extrahieren Sie die Datei.
    3. Öffnen Sie die XFA-Datei im neuesten Designer und speichern Sie sie. Die Version der XFA wird auf die neueste Version aktualisiert.
    4. Laden Sie die XFA in der Forms-Benutzeroberfläche hoch.

  2. Veröffentlichen Sie alle Assets, die im vorherigen System vor der Migration veröffentlicht wurden. Das Migrationsdienstprogramm aktualisiert die Assets nur in der Autoreninstanz. Um die Assets in den Veröffentlichungsinstanzen zu aktualisieren, müssen Sie die Assets veröffentlichen.

  3. In AEM Forms 6.4 und 6.5 haben sich einige Rechte der Forms-Benutzergruppen geändert. Wenn Sie möchten, dass Ihre Benutzenden XDPs und adaptive Forms mit Skripten hochladen oder einen Code-Editor verwenden können, müssen Sie diese zur Gruppe „forms-power-users“ hinzufügen. Ebenso können Vorlagenautorinnen und -autoren den Code-Editor im Regeleditor nicht mehr verwenden. Damit Benutzende den Code-Editor verwenden können, fügen Sie sie der Gruppe „af-template-script-writers“ hinzu. Anweisungen zum Hinzufügen von Benutzenden zu Gruppen finden Sie unter Verwalten von Benutzern und Benutzergruppen.

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2