L'utility Migrazione converte le risorse Forms adattive, configurazioni cloud e Risorse per la gestione della corrispondenza dal formato utilizzato nelle versioni precedenti al formato utilizzato in AEM 6.5 Forms. Quando si esegue l'utility di migrazione, vengono migrati i seguenti elementi:
In caso di aggiornamento non aggiornato, per le risorse di Gestione della corrispondenza potete eseguire la migrazione ogni volta che importate le risorse. Per la migrazione alla gestione della corrispondenza è necessario che sia installato il pacchetto di compatibilità Forms.
È possibile aggiornare alla versione più recente di AEM Forms 6.5 da AEM Forms 6.4, 6.3 o 6.2 oppure eseguire una nuova installazione. A seconda se avete aggiornato l’installazione precedente o eseguito una nuova installazione, dovete effettuare una delle seguenti operazioni:
In caso di aggiornamento locale
Se avete eseguito un aggiornamento locale, l’istanza aggiornata dispone già delle risorse e dei documenti. Tuttavia, prima di poter utilizzare le risorse e i documenti, dovrete installare pacchetto di compatibilità AEMFD (compreso il pacchetto di compatibilità per la gestione della corrispondenza)
Quindi devi aggiornare le risorse e i documenti eseguendo l'utility di migrazione.
In caso di installazione fuori luogo
Se si tratta di un'installazione obsoleta (fresca), prima di poter utilizzare le risorse e i documenti, dovrete installare pacchetto di compatibilità AEMFD (compreso il pacchetto di compatibilità per la gestione della corrispondenza).
Quindi è necessario importare il pacchetto di risorse (zip o cmp) nella nuova configurazione e aggiornare le risorse e i documenti eseguendo l'utility Migrazione. Adobe consiglia di creare nuove risorse nella nuova configurazione solo dopo l’esecuzione dell’utility di migrazione.
A causa di modifiche relative alla compatibilità precedente, le posizioni di alcune cartelle nell'archivio crx vengono modificate. Esportate e importate manualmente le dipendenze (librerie e risorse personalizzate) dalla configurazione precedente all’ambiente nuovo.
Per le risorse Gestione corrispondenza:
Eseguite l’utility di migrazione prima di apportare modifiche alle risorse o di crearle. È consigliabile non eseguire l'utility dopo aver apportato modifiche o creato risorse. Accertatevi che l’interfaccia utente Gestione corrispondenza o Risorse Forms adattive non sia aperta durante il processo di migrazione.
Quando si esegue l'utility di migrazione per la prima volta, viene creato un registro con il percorso e il nome seguenti: [directory-installazione-aem]\cq-quickstart\logs\aem-forms-migration.log. Questo registro continua ad essere aggiornato con le informazioni di gestione della corrispondenza e di migrazione Forms adattiva, come lo spostamento delle risorse.
Prima di eseguire l'utility di migrazione, assicurarsi di aver eseguito un backup del repository crx.
In una sessione del browser, accedete a AEM’istanza di creazione come Amministratore.
Aprite il seguente URL nel browser:
https://[hostname]:[port]/[context_path]/libs/fd/foundation/gui/content/migration.html
Il browser presenta quattro opzioni:
Per eseguire la migrazione, effettuate le seguenti operazioni:
Per migrare risorse, tocca migrazione risorse AEM Forms e, nella schermata successiva, tocca Avvia migrazione. Viene eseguita la migrazione dei seguenti elementi:
Durante la migrazione delle risorse, è possibile che vengano visualizzati messaggi di avviso come "Conflitto trovato per…". Tali messaggi indicano che non è stato possibile migrare le regole per alcuni componenti nei moduli adattivi. Ad esempio, se il componente ha un evento con regole e script, se le regole si verificano dopo uno script nessuna delle regole per il componente viene migrata. Tuttavia, tali regole possono essere migrate aprendo l’editor delle regole nella creazione di moduli adattivi.
Per migrare questi componenti, apriteli in Editor regole nell’editor Forms adattivo.
Per migrare regole e script (non richiesti se si esegue l'aggiornamento dalla versione 6.3) in componenti personalizzati, toccate Migrazione adattata dei componenti personalizzati Forms e, nella schermata successiva, toccate Avvia migrazione. Viene eseguita la migrazione dei seguenti elementi: >
Regole e script creati con 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 migrare i modelli (non richiesti se si esegue l'aggiornamento dalla versione 6.3 e 6.4), toccate Migrazione modelli Forms adattivi e, nella schermata successiva, toccate Avvia migrazione. Viene eseguita la migrazione dei seguenti elementi:
Vecchi modelli: i modelli di moduli adattivi creati in /apps con AEM 6.1 Forms o versioni precedenti. Sono inclusi gli script definiti nei componenti modello.
Nuovi modelli: modelli di moduli adattivi creati utilizzando l'editor modelli in /conf. Ciò include la migrazione di regole e script creati utilizzando l'editor di regole.
Per migrare i componenti personalizzati per moduli adattivi, toccare Migrazione adattata dei componenti personalizzati Forms e nella pagina Migrazione dei componenti personalizzati, toccare Avvia migrazione. Viene eseguita la migrazione dei seguenti elementi:
Per migrare i modelli di modulo adattivo, toccare Migrazione adattata dei modelli Forms e nella pagina Migrazione dei componenti personalizzati toccare Avvia migrazione. Viene eseguita la migrazione dei seguenti elementi:
Migra servizi di configurazione di AEM Forms Cloud per sfruttare il nuovo paradigma del servizio cloud basato sul contesto, che include l’interfaccia touch (in /conf). Quando si esegue la migrazione servizi di configurazione di AEM Forms Cloud, i servizi cloud in /etc vengono spostati in /conf. Se non disponete di personalizzazioni dei servizi cloud che dipendono dai percorsi legacy (/etc?lang=it), è consigliabile eseguire l'utility di migrazione subito dopo l'aggiornamento alla versione 6.5 e utilizzare l'interfaccia utente touch della configurazione cloud per qualsiasi ulteriore lavoro. Se disponete di personalizzazioni dei servizi cloud esistenti, continuate a utilizzare l'interfaccia classica durante l'aggiornamento fino a quando le personalizzazioni non vengono aggiornate in modo da allinearsi ai percorsi migrati (/conf?lang=it) ed eseguire l'utility di migrazione.
Per migrare servizi cloud AEM Forms, che includono quanto segue, toccate migrazione alla configurazione di AEM Forms Cloud (la migrazione alla configurazione cloud è indipendente dal pacchetto di compatibilità AEMFD), toccate Migrazione alle configurazioni di AEM Forms Cloud e, nella pagina Migrazione alla configurazione, toccate Avvia migrazione:
Servizi cloud per il modello dati modulo
Recaptcha
Adobe Sign
Servizi cloud di Typekit
La finestra del browser visualizza quanto segue durante il processo di migrazione:
Una volta eseguita, l'utilità di migrazione effettua le seguenti operazioni:
Al termine dell'esecuzione dell'utility di migrazione, passare alle attività di pulizia.
Dopo aver eseguito l'utility Migrazione, effettua le seguenti operazioni di pulizia:
Verificate che la versione XFA di layout e layout di frammenti sia 3.3 o successiva. Se si utilizzano layout e layout di frammenti di una versione precedente, potrebbero verificarsi problemi durante il rendering della lettera. Per aggiornare la versione di un XFA precedente all'ultima versione, effettua i seguenti passaggi:
Pubblicate tutte le risorse pubblicate nel sistema precedente prima della migrazione. L’utility di migrazione aggiorna le risorse solo nell’istanza di creazione e per aggiornare le risorse nell’istanza o nelle istanze di pubblicazione, è necessario pubblicare le risorse.
In AEM Forms 6.4 e 6.5, alcuni dei diritti dei gruppi di utenti dei moduli vengono modificati. Se si desidera che gli utenti siano in grado di caricare gli script XDP e Forms adattivo o di utilizzare l'editor di codice, è necessario aggiungerli al gruppo di utenti che alimentano i moduli. Analogamente, gli autori dei modelli non possono più utilizzare l'editor di codice nell'Editor regole. Per consentire agli utenti di utilizzare l’editor di codice, aggiungili al gruppo af-template-script-writers. Per istruzioni sull'aggiunta di utenti ai gruppi, consultate Gestione di utenti e gruppi di utenti.