L'utility di migrazione converte Risorse Forms adattive, configurazioni cloud, e Risorse di gestione della corrispondenza dal formato utilizzato nelle versioni precedenti al formato utilizzato in Adobe Experience Manager (AEM) 6.5 Forms. Quando si esegue l'utilità di migrazione, viene eseguita la migrazione dei seguenti elementi:
In caso di aggiornamento fuori sede, per le risorse di Gestione della corrispondenza puoi eseguire la migrazione ogni volta che importi le risorse. Per la migrazione di Gestione corrispondenza, è necessario che sia installato il pacchetto di compatibilità di Forms.
È possibile aggiornamento alla versione più recente di AEM Forms 6.5 da AEM Forms 6.4, 6.3 o 6.2, o a una nuova installazione. A seconda che sia stata aggiornata l'installazione precedente o sia stata eseguita una nuova installazione, è necessario eseguire una delle operazioni seguenti:
In caso di aggiornamento sul posto
Se hai eseguito un aggiornamento sul posto, l’istanza aggiornata dispone già delle risorse e dei documenti. Tuttavia, prima di poter utilizzare le risorse e i documenti, è necessario installare Pacchetto di compatibilità per AEMFD (include il pacchetto di compatibilità per la gestione della corrispondenza)
Quindi devi aggiornare risorse e documenti in base a esecuzione dell'utilità di migrazione.
In caso di installazione fuori sede
Se si tratta di un’installazione fuori sede (nuova), prima di poter utilizzare le risorse e i documenti è necessario installare Pacchetto di compatibilità per AEMFD (include il pacchetto di compatibilità per la gestione della corrispondenza).
Quindi devi importare il pacchetto di risorse (zip o cmp) nella nuova configurazione e aggiornare risorse e documenti in base a esecuzione dell'utilità di migrazione. L’Adobe consiglia di creare le risorse nella nuova configurazione solo dopo aver eseguito l’utility di migrazione.
Dovuto a compatibilità con le versioni precedenti modifiche, vengono modificate le posizioni di alcune cartelle nell’archivio crx. Esportare e importare manualmente le dipendenze (librerie e risorse personalizzate) dalla configurazione precedente a un nuovo ambiente.
Per le risorse di Gestione della corrispondenza:
/content/apps/cm/layouts/fragmentlayouts/1001
a /content/apps/cm/modules/fragmentlayouts
. Il riferimento del dizionario dati nelle risorse visualizza il percorso del dizionario dati anziché il nome.Esegui l’utility di migrazione prima di modificare le risorse o crearle. L’Adobe consiglia di non eseguire l’utility dopo aver apportato modifiche o creato risorse. Assicurati che l’interfaccia utente per la gestione della corrispondenza o per le risorse di Forms adattive non sia aperta mentre il processo di migrazione è in esecuzione.
Quando si esegue l'utilità di migrazione per la prima volta, viene creato un registro con il percorso e il nome seguenti: \[aem-installation-directory]\cq-quickstart\logs\aem-forms-migration.log
. Questo registro viene costantemente aggiornato con le informazioni sulla migrazione di Gestione della corrispondenza e Forms adattivo, ad esempio lo spostamento delle risorse.
Prima di eseguire l’utility di migrazione, accertati di aver eseguito un backup dell’archivio crx.
In una sessione del browser, accedi all’istanza Autore AEM come Amministratore.
Apri il seguente URL nel browser:
https://[nome host]:[porta]/[context_path]/libs/fd/foundation/gui/content/migration.html
Il browser visualizza quattro opzioni:
Per eseguire la migrazione, effettuare le seguenti operazioni:
Per eseguire la migrazione risorse, seleziona Migrazione risorse AEM Forms e, nella schermata successiva, seleziona Avvia migrazione. Viene eseguita la migrazione dei seguenti elementi:
Durante la migrazione delle risorse, potresti trovare messaggi di avviso come "Conflitto trovato per…". Questi messaggi indicano che non è stato possibile migrare le regole per alcuni dei componenti nei moduli adattivi. Ad esempio, se il componente aveva un evento con sia regole che script, se le regole si verificano dopo uno script, nessuna delle regole per il componente viene migrata. È possibile migrazione di tali regole aprendo l’editor di regole nell’authoring di moduli adattivi.
Per migrare i componenti personalizzati del modulo adattivo, seleziona Migrazione dei componenti personalizzati di Forms adattivi e nella pagina Migrazione componenti personalizzati, seleziona Avvia migrazione. Viene eseguita la migrazione dei seguenti elementi:
Per migrare i modelli di moduli adattivi, seleziona Migrazione modello Forms adattivo e nella pagina Migrazione componenti personalizzati, seleziona Avvia migrazione. Viene eseguita la migrazione dei seguenti elementi:
/apps
o /conf
utilizzo dell’Editor modelli per AEM.Migra i servizi di configurazione cloud di AEM Forms per utilizzare il nuovo paradigma del servizio cloud in base al contesto, che include l’interfaccia utente touch (sotto /conf
). Quando esegui la migrazione dei servizi di configurazione cloud di AEM Forms, i servizi cloud in /etc
vengono spostati in /conf
. Se non disponi di personalizzazioni dei servizi cloud che dipendono dai percorsi legacy (/etc
), l’Adobe consiglia di eseguire l’utility di migrazione dopo l’aggiornamento alla versione 6.5; per ulteriori informazioni, utilizza l’interfaccia utente touch della configurazione cloud. Se disponi di personalizzazioni di Cloud Services esistenti, continua a utilizzare l’interfaccia classica nelle impostazioni aggiornate fino a quando le personalizzazioni non vengono aggiornate in modo da allinearsi ai percorsi migrati (/conf
) ed eseguire l'utility di migrazione.
Per eseguire la migrazione Servizi cloud AEM Forms, che includono quanto segue, seleziona Migrazione configurazione cloud di AEM Forms (la migrazione della configurazione cloud è indipendente dal pacchetto di compatibilità AEMFD). Seleziona Migrazione configurazioni AEM Forms Cloud, quindi nella pagina Migrazione configurazione seleziona Avvia migrazione:
Servizi cloud del modello dati modulo
/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
Servizi cloud Typekit
/etc/cloudservices/typekit
/conf/global/settings/cloudconfigs/typekit
La finestra del browser mostra quanto segue durante il processo di migrazione:
Quando viene eseguita, l'utilità Migration esegue le operazioni seguenti:
Al termine dell'esecuzione dell'utilità di migrazione, passare alla mansioni di manutenzione.
Questi componenti possono essere migrati aprendoli nell’editor di regole nell’editor di Forms adattivo.
Per migrare regole e script (non necessari se si esegue l’aggiornamento da 6.3) nei componenti personalizzati, seleziona Migrazione componenti personalizzati di Forms adattivi e nella schermata successiva seleziona Avvia migrazione. Viene eseguita la migrazione dei seguenti elementi:
Regole e script creati utilizzando l’editor di regole (6.1 FP1 e versioni successive)
Script creati utilizzando la scheda Script nell’interfaccia utente di 6.1 e versioni precedenti
Per eseguire la migrazione dei modelli (non richiesto per l’aggiornamento da 6.3 e 6.4), seleziona Migrazione modello Forms adattivo e nella schermata successiva seleziona Avvia migrazione. Viene eseguita la migrazione dei seguenti elementi:
Modelli precedenti: i modelli di moduli adattivi creati in /apps utilizzando AEM 6.1 Forms o versioni precedenti. Sono inclusi gli script definiti nei componenti del modello.
Nuovi modelli: modelli di moduli adattivi creati utilizzando l’editor di modelli in /conf
. Ciò include la migrazione di regole e script creati utilizzando l’editor di regole.
Dopo aver eseguito l'utilità Migration, eseguire le seguenti operazioni di manutenzione:
Assicurati che la versione XFA dei layout e dei layout dei frammenti sia la 3.3 o successiva. Se utilizzi layout e layout di frammenti di una versione precedente, potrebbero esserci problemi nel rendering della lettera. La procedura seguente illustra come aggiornare una versione di un XFA precedente alla versione più recente:
Pubblica tutte le risorse pubblicate nel sistema precedente prima della migrazione. L’utility di migrazione aggiorna le risorse solo nell’istanza di authoring e, per aggiornare le risorse nelle istanze di pubblicazione, devi pubblicare le risorse.
In AEM Forms 6.4 e 6.5, alcuni dei diritti dei gruppi di utenti di Forms vengono modificati. Se desideri consentire a uno degli utenti di caricare XDP e Forms adattivi contenenti script o utilizzare un editor di codice, devi aggiungerli al gruppo forms-power-users. Analogamente, gli autori di modelli non possono più utilizzare l’editor di codice nell’editor di regole. Per consentire agli utenti di utilizzare un editor di codice, aggiungerli al gruppo af-template-script-writer. Per istruzioni sull’aggiunta di utenti ai gruppi, consulta Gestione di utenti e gruppi di utenti.