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 AEM 6.5 Forms verwendete Format. Wenn Sie das Migrationsdienstprogramm ausführen, werden folgende Elemente migriert:
Bei einem fehlgeschlagenen Upgrade können Sie für den Fall von Correspondence Management-Assets die Migration jedes Mal ausführen, wenn Sie die Assets importieren. Für die Correspondence Management-Migration muss das Forms-Kompatibilitätspaket installiert sein.
Sie können ein Upgrade auf die neueste Version von AEM Forms 6.5 von AEM Forms 6.4, 6.3 oder 6.2 durchführen oder eine Neuinstallation vornehmen. Je nachdem, ob Sie die vorherige Installation aktualisiert oder eine Neuinstallation durchgeführt haben, müssen Sie einen der folgenden Schritte ausführen:
Im Falle eines direkten Upgrades
Wenn Sie eine ersetzende Aktualisierung durchgeführt haben, verfügt die aktualisierte Instanz bereits über die Assets und Dokumente. Bevor Sie jedoch die Assets und Dokumente verwenden können, müssen Sie 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 nicht ersetzender Installation
Bevor Sie die Assets und Dokumente verwenden können, müssen Sie das AEMFD-Kompatibilitätspaket (einschließlich des Correspondence Management-Kompatibilitätspakets) installieren, wenn es sich um eine dezentrale (neue) Installation handelt.
Dann müssen Sie Ihr Asset-Paket (zip oder cmp) in das neue Setup importieren und dann die Assets und Dokumente aktualisieren, indem Sie das Migrationsprogramm ausführen. Adobe empfiehlt, neue Assets auf der neuen Installation erst nach Ausführung des Migrationsprogramms zu erstellen.
Aufgrund der Abwärtskompatibilität-bezogenen Änderungen werden Speicherorte von einigen Ordnern im CRX-Repository geändert. Exportieren und importieren Sie Abhängigkeiten (benutzerdefinierte Bibliotheken und Assets) vom vorherigen Setup in eine neue Umgebung manuell.
Für Correspondence Management-Assets:
Führen Sie die Migration aus, bevor Sie Änderungen an den Assets vornehmen oder Assets erstellen. Wir empfehlen, das Dienstprogramm erst dann auszuführen, wenn Änderungen an den Assets vorgenommen wurden 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 enthält aktualisierte Correspondence Management- und Adaptive Forms-Migrationsinformationen, beispielsweise zum Verschieben von Assets.
Stellen Sie vor dem Ausführen des Migrationsdienstprogramms sicher, dass Sie eine Sicherungskopie Ihres crx-Repositorys erstellt haben.
Melden Sie sich in einer Browsersitzung bei der AEM-Autoreninstanz als Administrator an.
Ö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:
Führen Sie die folgenden Schritte aus, um die Migration durchführen:
Um Assets zu migrieren, tippen Sie auf „AEM Forms – Asset-Migration“ und auf dem nächsten Bildschirm auf Migration beginnen. Die folgenden Elemente werden migriert:
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, tippen Sie auf Migration benutzerdefinierter Komponenten für adaptive Formulare und auf der Seite „Migration von benutzerdefinierten Komponenten“ auf Migration beginnen. Die folgenden Elemente werden migriert:
Um Vorlagen für adaptive Formulare zu migrieren, tippen Sie auf Migration von Vorlagen für adaptive Formulare und auf der Seite „Migration von benutzerdefinierten Komponenten“ auf Migration beginnen. Die folgenden Elemente werden migriert:
/apps
oder /conf
mit dem AEM-Vorlageneditor erstellt wurden.Migrieren Sie die AEM Forms Cloud-Konfigurations-Services, um das neue kontextbezogene Cloud-Service-Paradigma zu nutzen, das die Benutzeroberfläche mit Touch-Funktion (unter /conf
) umfasst. Wenn Sie Services der Cloud-Konfiguration von AEM Forms migrieren, werden die Cloud-Services in /etc
nach /conf
verschoben. Wenn Sie keine Anpassungen von Cloud-Services haben, die von den veralteten Pfaden (/etc
) abhängen, wird empfohlen, dass Sie das Migrationsdienstprogramm direkt nach dem Upgrade auf 6.5 ausführen und für alle weiteren Arbeiten die Cloud-Konfigurations-Benutzeroberfläche mit Touch-Funktion 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 fort, bis die Anpassungen für die migrierten Pfade (/conf
) abgeschlossen sind, und führen Sie erst dann das Migrationsdienstprogramm aus.
Um AEM Forms-Cloud-Dienste zu migrieren, die Folgendes umfassen, tippen Sie auf „AEM Forms-Cloud-Konfigurationsmigration“ (die Cloud-Konfigurationsmigration ist unabhängig vom AEMFD-Kompatibilitätspaket) und dann auf der Seite „Konfigurationsmigration“ auf Migration starten:
Cloud-Services für das Formulardatenmodell
/etc/cloudservices/fdm
/conf/global/settings/cloudconfigs/fdm
reCAPTCHA
/etc/cloudservices/recaptcha
/conf/global/settings/cloudconfigs/recaptcha
Adobe Sign
/etc/cloudservices/echosign
/conf/global/settings/cloudconfigs/echosign
Cloud-Services für Typekit
/etc/cloudservices/typekit
/conf/global/settings/cloudconfigs/typekit
Im Browserfenster wird während der Migration Folgendes ausgeführt:
Wenn ausgeführt, geht das Migrationsdienstprogramm wie folgt vor:
Fahren Sie nach der Ausführung des Migrationsdienstprogramms mit den Systemverwaltungsaufgaben fort.
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, tippen Sie auf „Migration von benutzerdefinierten Adaptive Forms-Komponenten“ und auf dem nächsten Bildschirm auf „Migration beginnen“. 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, tippen Sie auf „Migration von Adaptive Forms-Vorlagen“ und auf dem nächsten Bildschirm auf „Migration beginnen“. 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, erstellt mithilfe des Vorlagen-Editors unter /conf. Das umfasst die Migration von Regeln und Skripten, die mithilfe des Regel-Editors erstellt wurden.
Nachdem Sie das Migrationsdienstprogramm ausgeführt haben, führen Sie folgende Systemverwaltungsaufgaben durch:
Stellen Sie sicher, dass die 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 ein älteres XFA auf die neueste Version zu aktualisieren, führen Sie folgende Schritte aus:
Veröffentlichen Sie alle Assets, die im vorherigen System vor der Migration veröffentlicht wurden. Das Migrationsdienstprogramm aktualisiert die Assets nur im Autorenmodus. Um die Assets in der Veröffentlichungsinstanz (s) zu aktualisieren, müssen Sie die Assets veröffentlichen.
In AEM Forms 6.4 werden einige Rechte der Forms-Benutzergruppen geändert. Wenn Sie möchten, dass Ihre Benutzer XDPs und adaptive Formulare hochladen können, die Skripte enthalten oder den Code-Editor verwenden, müssen Sie sie der Gruppe der Forms-Power-User hinzufügen. Ebenso können Vorlagen-Autoren den Code-Editor im Regel-Editor nicht mehr verwenden. Damit Benutzer den Code-Editor verwenden können, fügen Sie sie der Gruppe „af-template-script-writers“ hinzu. Anweisungen zum Hinzufügen von Benutzern zu Gruppen finden Sie unter Verwalten von Benutzern und Benutzergruppen.