Das Migrationsdienstprogramm konvertiert die Adaptive Forms-Assets, Cloud-Konfigurationen, und Correspondence Management-Assets von dem Format, das in früheren Versionen verwendet wurde, bis zum Format, das in Adobe Experience Manager (AEM) 6.5 Forms verwendet wird. Wenn Sie das Migrationsdienstprogramm ausführen, werden die folgenden Elemente migriert:
Bei einer nicht ersetzenden Aktualisierung für Correspondence Management-Assets können Sie 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 Upgrade auf die neueste Version von AEM Forms 6.5 von AEM Forms 6.4, 6.3 oder 6.2 oder eine Neuinstallation. Je nachdem, ob Sie Ihre 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 eine ersetzende Aktualisierung 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 die AEMFD-Kompatibilitätspaket (enthält das Correspondence Management-Kompatibilitätspaket)
Anschließend müssen Sie die Assets und Dokumente durch Ausführen des Migrationsdienstprogramms.
Bei einer nicht ersetzenden Installation
Wenn es sich um eine nicht ersetzende (neue) Installation handelt, müssen Sie die AEMFD-Kompatibilitätspaket (enthält das Correspondence Management-Kompatibilitätspaket).
Anschließend müssen Sie Ihr Asset-Paket (zip oder cmp) in das neue Setup importieren und dann die Assets und Dokumente aktualisieren, indem Sie Ausführen des Migrationsdienstprogramms. Adobe empfiehlt die Erstellung von Assets in der neuen Einrichtung erst nach Ausführung des Migrationsdienstprogramms.
Aufgrund von Abwärtskompatibilität geändert wurde, werden die Speicherorte einiger Ordner im CRX-Repository geändert. Exportieren und importieren Sie Abhängigkeiten (benutzerdefinierte Bibliotheken und Assets) manuell von der vorherigen Einrichtung in eine neue Umgebung.
Für Correspondence Management-Assets:
/content/apps/cm/layouts/fragmentlayouts/1001
nach /content/apps/cm/modules/fragmentlayouts
. Die Datenwörterbuchreferenz in Assets zeigt den Pfad des Datenwörterbuchs anstelle des Namens an.Führen Sie das Migrationsdienstprogramm aus, bevor Sie die Assets ändern oder Assets erstellen. Adobe empfiehlt, das Dienstprogramm nicht auszuführen, nachdem Sie Änderungen vorgenommen oder Assets erstellt haben. 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 weiterhin mit Correspondence Management- und Adaptive Forms-Migrationsinformationen aktualisiert, z. B. zum Verschieben von Assets.
Bevor Sie das Migrationsdienstprogramm ausführen, stellen Sie sicher, dass Sie eine Sicherung Ihres CRX-Repositorys durchgeführt haben.
Melden Sie sich in einer Browsersitzung bei Ihrer 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 durchzufü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 AEM Forms Cloud Configuration Services, um das neue kontextabhängige Cloud Service-Paradigma zu verwenden, das die Touch-optimierte Benutzeroberfläche enthält (unter /conf
). Wenn Sie Services der Cloud-Konfiguration von AEM Forms migrieren, werden die Cloud-Services in /etc
nach /conf
verschoben. Wenn Sie über keine Cloud Services-Anpassungen verfügen, die von den veralteten Pfaden (/etc
), empfiehlt Adobe, das Migrationsdienstprogramm nach der Aktualisierung auf 6.5 auszuführen. Verwenden Sie die Touch-optimierte Cloud-Konfiguration für alle weiteren Arbeiten. 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.
Migrieren AEM Forms Cloud Services, die Folgendes enthalten, tippen Sie auf AEM Forms Cloud-Konfigurationsmigration (die Cloud-Konfigurationsmigration ist unabhängig vom AEMFD-Kompatibilitätspaket). Tippen Sie auf die Migration zu AEM Forms Cloud-Konfigurationen und dann auf der Seite "Konfigurationsmigration" 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 das Migrationsdienstprogramm ausgeführt wird, führt es Folgendes aus:
Fahren Sie nach der Ausführung des Migrationsdienstprogramms mit den Systemverwaltungsaufgaben fort.
Diese Komponenten können migriert werden, indem sie im Regeleditor im adaptiven Forms-Editor 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, die mithilfe des Vorlageneditors 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 die folgenden Systemverwaltungsaufgaben durch:
Stellen Sie sicher, dass die XFA-Version der Layouts und Fragmentlayouts 3.3 oder höher ist. Wenn Sie Layouts und Fragment-Layouts einer älteren Version benutzen, könnte es Probleme beim Rendern des Briefs geben. Führen Sie die folgenden Schritte aus, um eine Version eines älteren XFA auf die neueste Version zu aktualisieren:
Veröffentlichen Sie alle Assets, die vor der Migration im vorherigen System veröffentlicht wurden. Das Migrationsdienstprogramm aktualisiert die Assets nur auf der Autoreninstanz. Um die Assets auf den Veröffentlichungsinstanzen 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 Forms mit Skripten hochladen oder einen Code-Editor verwenden können, müssen Sie diese zur Gruppe der Formular-Hauptbenutzer hinzufügen. Ebenso können Vorlagenautoren den Code-Editor im Regeleditor nicht mehr verwenden. Damit Benutzer einen Code-Editor verwenden können, fügen Sie ihn zur Gruppe af-template-script-writers hinzu. Anweisungen zum Hinzufügen von Benutzern zu Gruppen finden Sie unter Verwalten von Benutzern und Benutzergruppen.