Configurare il servizio di conversione automatica dei moduli (AFCS)
- Argomenti:
- Moduli adattivi
Creato per:
- Principiante
- Intermedio
- Amministratore
- Sviluppatore
- Utente
Questo articolo descrive come un amministratore di AEM può configurare il servizio AFCS (Automated Forms Conversion Service) per automatizzare la conversione del proprio PDF forms in Forms adattivo. Questo articolo è destinato agli amministratori IT e AEM della tua organizzazione. Le informazioni fornite si basano sul presupposto che chiunque legga questo articolo abbia familiarità con le seguenti tecnologie:
-
Installazione, configurazione e amministrazione di pacchetti Adobe Experience Manager e AEM,
-
Utilizzo di sistemi operativi Linux® e Microsoft® Windows®
Onboarding
Il servizio è disponibile gratuitamente per i clienti AEM 6.5 Forms On-Premise e per i clienti aziendali Adobe Managed Service. Per richiedere l’accesso al servizio, puoi contattare il team di vendita Adobe o il tuo rappresentante Adobe. Il servizio è disponibile anche gratuitamente e preabilitato per i clienti AEM Forms as a Cloud Service.
Adobe abilita l’accesso per la tua organizzazione e fornisce i privilegi richiesti alla persona designata come amministratore dell’organizzazione. L’amministratore può concedere agli sviluppatori di AEM Forms (utenti) dell’organizzazione l’accesso al servizio.
Prerequisiti
Per utilizzare il servizio di conversione automatica dei moduli (AFCS, Automated Forms Conversion Service) è necessario quanto segue:
- Il servizio di conversione automatica dei moduli (AFCS) è abilitato per la tua organizzazione
- Un account Adobe ID con privilegi di amministratore per il servizio di conversione
- AEM 6.5 in esecuzione con il Service Pack di AEM o l’istanza Autore di AEM Forms as a Cloud Service più recente con gli aggiornamenti più recenti.
- Un utente AEM (nell’istanza AEM) che è membro del gruppo di utenti Forms
Configurare l’ambiente
Prima di utilizzare il servizio, prepara l’istanza di authoring di AEM per la connessione al servizio in esecuzione su Adobe Cloud. Per preparare l’istanza per il servizio, effettua le seguenti operazioni nella sequenza elencata:
1. Scarica e installa AEM 6.5 o AEM Forms as a Cloud Service integrato
Il servizio di conversione automatica dei moduli (AFCS) viene eseguito sull’istanza di authoring di AEM. Per configurare un’istanza di authoring AEM è necessario AEM 6.5 o AEM Forms as a Cloud Service.
-
Se AEM 6.5 non è ancora operativo, scaricalo dalle seguenti posizioni. Dopo aver scaricato AEM, per istruzioni su come configurare un'istanza di AEM Author, vedi distribuzione e manutenzione.:
-
Se sei già un cliente di AEM, scarica AEM 6.5 dal sito Web Adobe Licensing.
-
Se sei un partner Adobe, utilizza il Programma di formazione per i partner Adobe per richiedere AEM 6.5.
-
-
Se utilizzi AEM Forms as a Cloud Service, consulta onboarding per AEM Forms as a Cloud Service e configurare un ambiente di sviluppo locale.
2. Scarica e installa AEM l’ultimo Service Pack (solo per AEM 6.5)
Scarica e installa il Service Pack più recente di AEM. Per istruzioni dettagliate, consulta Note sulla versione di AEM 6.5 Service Pack.
3. Scarica e installa il pacchetto del componente aggiuntivo AEM Forms (solo per AEM 6.5)
Un’istanza di AEM contiene funzionalità di base per i moduli. Il servizio di conversione richiede le funzionalità complete di AEM Forms. Scarica e installa il pacchetto del componente aggiuntivo AEM Forms per usufruire di tutte le funzionalità di AEM Forms. Il pacchetto è necessario per configurare ed eseguire il servizio di conversione. Per istruzioni dettagliate, vedere Installare e configurare le funzionalità di acquisizione dati.
https://adminconsole.adobe.com/
NOTE4. Creare temi e modelli personalizzati
I pacchetti di riferimento contengono temi e modelli di esempio. Il servizio di conversione automatica dei moduli (AFCS) richiede almeno un tema e un modello per convertire un modulo PDF in un modulo adattivo. Crea un tema e un modello personalizzato e punta alla configurazione del servizio per utilizzare modelli e temi personalizzati prima di utilizzare il servizio.
Puoi anche scaricare e installare il pacchetto AEM Forms Reference Assets nell'istanza Autore. Crea alcuni temi e modelli di riferimento.
Configurare l’accesso e le autorizzazioni
Prima di procedere alla configurazione del servizio e connettere l’istanza al servizio in esecuzione su Adobe Cloud, scopri gli utenti tipo e i privilegi necessari per connettersi al servizio. Il servizio utilizza due diversi tipi di utenti tipo, amministratori e sviluppatori:
- Amministratori: gli amministratori sono responsabili della gestione del software e dei servizi Adobe per la propria organizzazione. Gli amministratori consentono agli sviluppatori della propria organizzazione di connettersi al servizio AFCS (Automated Forms Conversion Service) in esecuzione su Adobe Cloud. Quando viene eseguito il provisioning di un amministratore per un'organizzazione, l'amministratore riceve un messaggio e-mail con il titolo ‘You now have administrator rights to manage Adobe software and services for your organization’. Se sei un amministratore, controlla la tua casella di posta elettronica con il titolo precedentemente menzionato e procedi a concedere l'accesso agli sviluppatori della tua organizzazione.
- Sviluppatori: uno sviluppatore connette un'istanza Autore AEM Forms al servizio di conversione automatica dei moduli (AFCS) in esecuzione su Adobe Cloud. Quando un amministratore concede a uno sviluppatore i diritti per connettersi al servizio di conversione automatica dei moduli (AFCS), allo sviluppatore viene inviata un’e-mail con il titolo Ora disponi dell’accesso per sviluppatori per gestire le integrazioni API di Adobe per la tua organizzazione. Se sei uno sviluppatore, controlla la tua casella di posta elettronica con il titolo menzionato in precedenza e procedi a Connetti la tua istanza AEM locale al servizio di conversione automatica dei moduli su Adobe Cloud.
Concedere l’accesso agli sviluppatori dell’organizzazione
Dopo che Adobe abilita l’accesso per la tua organizzazione e fornisce i privilegi richiesti all’amministratore, quest’ultimo può accedere ad Admin Console (istruzioni dettagliate di seguito), creare un profilo e aggiungere sviluppatori al profilo. Gli sviluppatori possono collegare un’istanza di AEM Forms al servizio di conversione automatica dei moduli (AFCS) su Adobe Cloud.
Gli sviluppatori sono membri dell’organizzazione designati per eseguire il servizio di conversione. Solo gli sviluppatori che vengono aggiunti al profilo AFCS (Automated Forms Conversion Service) di Adobe possono utilizzare il servizio AFCS (Automated Forms Conversion Service).
Per creare un profilo e aggiungervi sviluppatori, effettua le seguenti operazioni. È necessario almeno un profilo per concedere l’accesso richiesto agli sviluppatori dell’organizzazione:
-
Accedi a Admin Console. Utilizza Adobe ID dell'amministratore predisposto per l'utilizzo del servizio di conversione automatica dei moduli (AFCS) per l'accesso.
-
Fare clic sull'opzione Automated Forms Conversion.
-
Fare clic su New Profile nella scheda Products.
-
Specificare Name, Display Name e Description per il profilo. Fai clic su Done. Ad esempio, crea un profilo come AFC_Flamingo_Test_Dev.
-
Aggiungi uno sviluppatore al profilo. Per aggiungere gli sviluppatori:
- In Admin Console, passa alla scheda Panoramica.
- Fai clic su Assign Developers sulla scheda prodotto richiesta.
- Immetti l’indirizzo e-mail degli sviluppatori e, facoltativamente, il nome e il cognome.
- Seleziona i profili di prodotto. Fare clic su Save.
Ripeti i passaggi precedenti per tutti gli utenti. Per ulteriori dettagli sull'aggiunta di sviluppatori, vedere Gestione sviluppatori.
Quando un amministratore aggiunge sviluppatori al profilo di Adobe I/O, gli sviluppatori ricevono una notifica tramite e-mail (se configurata).
Aggiungi utente al gruppo forms-users
Specifica un indirizzo e-mail nel profilo dell’utente di AEM designato per eseguire il servizio. Assicurati che l'utente sia membro del gruppo forms-users. Le e-mail vengono inviate all’indirizzo e-mail dell’utente che esegue la conversione. Per specificare un indirizzo e-mail per l'utente e aggiungere l'utente al gruppo di utenti dei moduli:
-
Accedi all’istanza di authoring di AEM Forms come amministratore AEM. Utilizza le credenziali AEM locali per accedere.
-
Fare clic su Adobe Experience Manager > Tools > Security > Users.
-
Selezionare un utente designato per eseguire il servizio di conversione e fare clic su Properties. Viene visualizzata la pagina Modifica impostazioni utente.
-
Specificare un indirizzo di posta elettronica nel campo Email e fare clic su Save. Le e-mail vengono inviate all’indirizzo e-mail specificato al completamento o al fallimento della conversione.
-
Fare clic sulla scheda Gruppi. Nella scheda Seleziona gruppo, digita e seleziona il gruppo utenti-moduli.
-
Fai clic su Salva e chiudi. L'utente è ora membro del gruppo utenti di Forms.
Connettere la tua istanza di AEM Forms al servizio di conversione automatica dei moduli (AFCS) su Adobe Cloud
Se un amministratore ti fornisce l’accesso come sviluppatore, puoi collegare la tua istanza di AEM Forms al servizio di conversione automatica dei moduli (AFCS) in esecuzione su Adobe Cloud.
Per connettere l’istanza di AEM Forms al servizio di conversione automatica dei moduli, effettua le seguenti operazioni:
1. Configurare le API del servizio su Adobe Developer Console
2. Creare configurazioni Adobe IMS
3. Creare una configurazione di conversione moduli automatica
1. Configurare le API del servizio su Adobe Developer Console
Per utilizzare il servizio di conversione automatica dei moduli (AFCS), creare un progetto e aggiungere l'API Servizio di configurazione automatica di Forms al progetto in Adobe Developer Console. L’integrazione genera la chiave API, il segreto client, l’ID account tecnico, gli ambiti e l’ID organizzazione.
Per configurare l’API del servizio di conversione automatica dei moduli su Adobe Developer Console, effettua le seguenti operazioni:
-
Accedi a https://developer.adobe.com/console . Per accedere, utilizza l’account Adobe ID per sviluppatori fornito dall’amministratore per accedere alla console Adobe I/O.
-
Seleziona la tua organizzazione dall’angolo in alto a destra. Se non sai qual è la tua organizzazione, contatta l’amministratore.
-
Fai clic su Create new project. Viene visualizzata una schermata per iniziare a utilizzare il nuovo progetto.
-
Fai clic su Add API. Viene visualizzata una schermata con l’elenco di tutte le API abilitate per l’account.
-
Selezionare Automated Forms Conversion service e fare clic su Next. Viene visualizzata una schermata per configurare l’API.
-
Selezionare il metodo di autenticazione da server a server OAuth.
-
Specificare Credential Name e fare clic su Next.
-
Seleziona un profilo prodotto. Ad esempio, seleziona un profilo come AFC_Flamingo_Test_Dev.
-
Fai clic su Save configured API.
NOTESeleziona il profilo creato concedendo l’accesso agli sviluppatori dell’organizzazione. Se non conosci il profilo da selezionare, contatta l’amministratore. -
Fare clic su OAuth Server-to-Server per visualizzare la chiave API, il segreto client e altre informazioni necessarie per connettere l'istanza AEM al servizio di conversione automatica dei moduli (AFCS).
Le informazioni contenute nella pagina vengono utilizzate per creare la configurazione IMS, come spiegato nella sezione Creare la configurazione tecnica IMS nell'istanza Autore AEM.
2. Creare configurazioni Adobe IMS
Accedi all’istanza di authoring per creare le configurazioni Adobe IMS. Utilizza Dettagli credenziali OAuth per recuperare la chiave API, il segreto client, l'ID account tecnico, gli ambiti e l'ID organizzazione.
-
Accedi all’istanza Autore di AEM Forms. Passa a Tools> Security > Adobe IMS Configurations.
-
Fai clic su Create.
-
Viene visualizzata la pagina Adobe IMS Technical Account Configuration.
-
Seleziona Automated Forms Conversion Service in Soluzione cloud.
-
Specifica quanto segue:
-
Titolo: specifica un titolo.
-
Server autorizzazioni: https://ims-na1.adobelogin.com
-
Recupera quanto segue dalla sezione Configurare le API del servizio in Adobe Developer Console:
- ID client: copia e incolla Chiave API(ID client).
- Segreto client: copia e incolla Segreto client.
- Ambito: copia e incolla Ambiti.
- ID organizzazione: copia e incolla ID account tecnico.
-
-
Fai clic su Save. Viene creata la configurazione Adobe IMS.
CAUTIONCrea una sola configurazione IMS. Non creare più di una configurazione IMS. -
Seleziona la configurazione Adobe IMS e fai clic su Check Health. Viene visualizzata una finestra di dialogo.
Viene visualizzata una finestra di dialogo Controlla.
-
Fai clic su Check.
Una volta stabilita la connessione, viene visualizzato il messaggio Token recuperato correttamente.
-
Fai clic su Chiudi.
3. Creare una configurazione di conversione moduli automatica
Crea una configurazione di conversione automatica dei moduli per connettere la tua istanza di AEM al servizio di conversione. Consente inoltre di specificare un modello, un tema e frammenti di modulo per una conversione. Puoi creare più configurazioni del servizio cloud separate per ciascun set di moduli.
Ad esempio, è possibile avere una configurazione separata per i moduli del reparto vendite e una distinta per i moduli dell'assistenza clienti. Per creare una configurazione del servizio cloud, effettua le seguenti operazioni:
-
Nell'istanza di AEM Forms, fare clic su Adobe Experience Manager > Tools> Cloud Services > Automate Forms Conversion Configuration.
-
Selezionare la cartella Global e fare clic su Create.
Viene visualizzata la pagina per Creare la configurazione di conversione automatica dei moduli. La configurazione viene creata nella cartella Global. Puoi anche creare la configurazione in un’altra cartella esistente o creare una cartella per le configurazioni.
-
Nella pagina Create Automated Forms Conversion Configuration, specificare il valore per i campi seguenti e fare clic su Next.
CampoDescrizioneTitoloTitolo univoco per la configurazione. Il titolo viene visualizzato nell’interfaccia utente utilizzata per avviare la conversione.NomeNome univoco per la configurazione. La configurazione viene salvata nel CRX-Repository con il nome specificato. Il nome può corrispondere al titolo.Posizione miniaturePosizione della miniatura per la configurazione.URL del servizioURL del servizio di conversione automatica dei moduli (AFCS) su Adobe Cloud. Utilizza l'URLhttps://aemformsconversion.adobe.io/.ModelloModello predefinito da applicare ai moduli convertiti. Puoi sempre specificare un modello diverso prima di iniziare la conversione. Un modello contiene la struttura di base e il contenuto iniziale di un modulo adattivo. Puoi scegliere un modello tra quelli forniti come standard. Puoi anche creare un modello personalizzato.TemaTema predefinito da applicare ai moduli convertiti. Puoi sempre specificare un tema diverso prima di iniziare la conversione. Puoi fare clic sull’icona per scegliere un tema fornito con il prodotto. Puoi anche creare un tema personalizzato.Frammenti esistentiPosizione di eventuali frammenti esistenti.Metamodello personalizzatoPercorso del file .schema.json del metamodello personalizzato. Puoi creare metamodelli separati per le lingue inglese, francese, tedesco, spagnolo, italiano e portoghese. -
Nella scheda Advanced della pagina Create Automated Forms Conversion Configuration, specificare il valore per il campo seguente:
CampoDescrizioneGenera documento di recordSelezionare l'opzione per generare automaticamente il documento di record per i moduli convertiti. L’opzione è disponibile solo per i moduli basati su XFA (XDP e PDF forms). Se si abilita l'opzione, dopo aver inviato un modulo è possibile consentire ai clienti di conservare una registrazione, in formato cartaceo o in formato documento, delle informazioni che hanno compilato nel modulo per riferimento futuro. Tale documento è denominato documento di record.Abilita Analytics(Per AEM 6.5) Seleziona l’opzione per abilitare Adobe Analytics su tutti i moduli convertiti. Prima di utilizzare l’opzione, accertati che Adobe Analytics sia abilitato per la tua istanza di AEM Forms.- Quando l’origine è un modulo basato su XFA con estensione .XDP, il DOR di output mantiene il layout XFA, altrimenti il servizio di conversione utilizza un modello preconfigurato per generare DOR per altri moduli basati su XFA.
- Quando si invia un modulo XFA, i dati di invio del modulo vengono salvati come un elemento XML o un attributo. Ad esempio,
<Amount currency="USD"> 10.00 </Amount>. La valuta viene salvata come attributo e come importo della valuta; 10.00 viene salvato come elemento. I dati di invio di un modulo adattivo non dispongono di attributi, ma solo di elementi. Pertanto, quando un modulo basato su XFA viene convertito in modulo adattivo, i dati di invio del modulo adattivo contengono un elemento per ciascun attributo di questo tipo. Ad esempio,
{ "Type": "Principal", "Amount": "10.00", "currency": "USD" } -
Fai clic su Create. Viene creata la configurazione cloud. La tua istanza di AEM Forms è pronta per iniziare a convertire i moduli legacy in Forms adattivo.