Configurare il servizio di Automated forms conversion (AFCS) about-this-help
Questa guida descrive come un amministratore AEM può configurare il servizio di Automated forms conversion (AFCS) per automatizzare la conversione dei PDF forms in moduli adattivi. Questa guida è rivolta agli amministratori IT e AEM della tua organizzazione. Le informazioni fornite si basano sul presupposto che chiunque legga questa Guida conosca le seguenti tecnologie:
-
Installazione, configurazione e amministrazione di pacchetti Adobe Experience Manager e AEM,
-
Utilizzo di sistemi operativi Linux® e Microsoft® Windows®
-
Configurazione dei server di posta SMTP
Onboarding onboarding
Il servizio è disponibile gratuitamente per i clienti Forms AEM 6.4 e AEM 6.5 Forms On-Premise e per i clienti aziendali Adobe Managed Service. Puoi contattare il team di vendita Adobe o il tuo rappresentante Adobe per richiedere l’accesso al servizio. Il servizio è disponibile anche gratuitamente e preabilitato per i clienti as a Cloud Service di AEM Forms.
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 prerequisites
Per utilizzare il servizio di Automated forms conversion (AFCS) è necessario quanto segue:
- Il servizio di automated forms conversion (AFCS) è abilitato per la tua organizzazione
- Un account Adobe ID con privilegi di amministratore per il servizio di conversione
- Un’istanza AEM 6.4, AEM 6.5 o AEM Forms as a Cloud Service Author funzionante con il Service Pack dell’AEM più recente o con gli aggiornamenti più recenti.
- Un utente AEM (nell’istanza AEM) che è membro del gruppo di utenti forms
Configurare l’ambiente setuptheservice
Prima di utilizzare il servizio, prepara l’istanza di authoring AEM a connettersi al servizio in esecuzione su Adobe Cloud. Per preparare l’istanza per il servizio, effettua le seguenti operazioni nella sequenza elencata:
- Scarica e installa AEM 6.4, AEM 6.5 o AEM Forms as a Cloud Service a bordo
- Scarica e installa il Service Pack AEM più recente
- Scarica e installa l’ultimo pacchetto del componente aggiuntivo AEM Forms
- (facoltativo) Scarica e installa il pacchetto del connettore più recente
- Creare temi e modelli personalizzati
Scarica e installa AEM 6.4 o AEM 6.5 o AEM Forms as a Cloud Service a bordo aemquickstart
Il servizio di automated forms conversion (AFCS) viene eseguito sull’istanza di authoring AEM. Per configurare un’istanza Autore AEM è necessario disporre di AEM 6.4, AEM 6.5 o AEM Forms as a Cloud Service.
-
Se non hai AEM 6.4 o AEM 6.5 funzionanti, scaricalo dalle seguenti posizioni. Dopo aver scaricato l'AEM, per istruzioni su come configurare un'istanza di creazione dell'AEM, vedere distribuzione e manutenzione.:
-
Se sei già un cliente AEM, scarica AEM 6.4 o AEM 6.5 dal sito Web Adobe Licensing.
-
Se sei un partner Adobe, utilizza il Programma di formazione per partner Adobe per richiedere AEM 6.4 o AEM 6.5.
-
-
Se utilizzi AEM Forms as a Cloud Service onboard per AEM Forms as a Cloud Service e configurare un ambiente di sviluppo locale.
(Solo per AEM 6.4 e AEM 6.5) Scarica e installa il Service Pack più recente per AEM servicepack
Scarica e installa il Service Pack AEM più recente. Per istruzioni dettagliate, consulta o Note sulla versione del Service Pack AEM 6.4 o Note sulla versione del Service Pack AEM 6.5.
(Solo per AEM 6.4 e AEM 6.5) Scarica e installa il pacchetto del componente aggiuntivo AEM Forms downloadaemformsaddon
Un’istanza 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.
Creare temi e modelli personalizzati referencepackage
Se si avvia AEM 6.4 o AEM 6.5 in modalità di produzione (modalità di esecuzione nosamplecontent), i pacchetti di riferimento non vengono installati. I pacchetti di riferimento contengono temi e modelli di esempio. Il servizio di automated forms conversion (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 il servizio configure-the-service
Prima di procedere alla configurazione del servizio e collegare l’istanza locale con il 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 concedono agli sviluppatori della propria organizzazione l’accesso per connettersi al servizio di Automated forms conversion (AFCS) 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 locale al servizio di Automated forms conversion (AFCS) in esecuzione su Adobe Cloud. Quando un amministratore concede a uno sviluppatore i diritti per connettersi al servizio di Automated forms conversion (AFCS), allo sviluppatore viene inviata un’e-mail con il titolo Ora disponi dell’accesso per sviluppatori per gestire le integrazioni API 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 Automated forms conversion su Adobe Cloud.
(Solo per amministratori di AEM 6.4 e AEM 6.5) Concedi l’accesso agli sviluppatori della tua organizzazione adduseranddevs
Dopo l’Adobe di abilita l’accesso per la tua organizzazione e fornisce i privilegi richiesti all’amministratore, quest’ultimo può accedere a Admin Console (istruzioni dettagliate di seguito), creare un profilo e aggiungere sviluppatori al profilo. Gli sviluppatori possono collegare un’istanza locale di AEM Forms al servizio Automated forms conversion (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 del servizio Automated forms conversion Adobe (AFCS) sono autorizzati a utilizzare il servizio Automated forms conversion (AFCS). 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 Automated forms conversion (AFCS) per l'accesso. Non utilizzare altri ID o Federated ID per effettuare 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. Viene creato un profilo.
-
Aggiungi uno sviluppatore al profilo. Per aggiungere gli sviluppatori:
- Nell'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. Toccare 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. Dopo aver ricevuto l'e-mail, gli sviluppatori possono procedere a collegare un'istanza AEM Forms locale con il servizio di Automated forms conversion su Adobe Cloud.
Connetti l’istanza AEM Forms locale al servizio Automated forms conversion (AFCS) su Adobe Cloud (solo per sviluppatori) connectafcadobeio
Se un amministratore ti fornisce l’accesso come sviluppatore, puoi collegare la tua istanza AEM Forms locale al servizio di Automated forms conversion (AFCS) in esecuzione su Adobe Cloud. Per connettere l’istanza AEM Forms al servizio, effettua le seguenti operazioni nella sequenza elencata:
Configurare le notifiche e-mail configureemailnotification
Il servizio di automated forms conversion (AFCS) utilizza il servizio di posta Day CQ per inviare le notifiche e-mail. Queste notifiche e-mail contengono informazioni sulle conversioni riuscite o non riuscite. Se scegli di non ricevere le notifiche, ignora questi passaggi. Per configurare il servizio e-mail Day CQ, effettua le seguenti operazioni:
-
Per i Forms AEM 6.4 Forms o AEM 6.5:
-
Vai a Gestione configurazione AEM in
http://localhost:4502/system/console/configMgr -
Apri la configurazione Day CQ Mail Service (Servizio posta Day CQ). Specificare un valore per i campi SMTP server host name, SMTP server port e From address. Fai clic su Save.
È possibile contattare il provider di servizi di posta elettronica o l'amministratore IT per informazioni sul nome host e sulla porta del server SMTP. Puoi utilizzare qualsiasi indirizzo e-mail valido nel campo da. Ad esempio, notification@example.com o donotreply@example.com.
-
Apri la configurazione Day CQ Link Externalizer. Nel campo Domains, specificare il nome host o l'indirizzo IP effettivo e il numero di porta per le istanze locali, di authoring e di pubblicazione. Fai clic su Save.
-
-
Per AEM Forms as a Cloud Service, registra un ticket di supporto per abilitare il servizio e-mail.
Aggiungi utente al gruppo forms-users adduserstousergroup
Specifica un indirizzo e-mail nel profilo dell’utente AEM designato per l’esecuzione del servizio. Verificare che l'utente sia membro del gruppo utenti dei moduli. 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. Non utilizzare Adobe ID per accedere. Tocca Adobe Experience Manager > Tools > Security > Users.
-
Selezionare un utente designato per eseguire il servizio di conversione e toccare Properties. Viene visualizzata la pagina Modifica impostazioni utente.
-
Specifica un indirizzo e-mail nel campo Email e tocca Save. Le e-mail vengono inviate all’indirizzo e-mail specificato al completamento o al fallimento della conversione.
-
Toccare la scheda Gruppi. Nella scheda Seleziona gruppo, digita e seleziona il gruppo utenti-moduli. Tocca Salva e chiudi. L'utente è ora membro del gruppo utenti di Forms.
Ottenere certificati pubblici (solo per AEM 6.4 e AEM 6.5) obtainpubliccertificates
Un certificato pubblico consente di autenticare il profilo su Adobe I/O.
-
Accedi all’istanza Autore di AEM Forms. Passa a Tools> Security > Adobe IMS Configurations. Toccare Create. Viene visualizzata la pagina Adobe IMS Technical Account Configuration.
-
Selezionare Automated Forms Conversion Service nella soluzione cloud.
-
Selezionare la casella di controllo Create new certificate e specificare un alias. L’alias funge da nome della finestra di dialogo. Toccare Create certificate. Viene visualizzata una finestra di dialogo. Fai clic su OK. Il certificato viene creato.
-
Tocca Download Public Key e salva il file di certificato AEM-Adobe-IMS.crt nel computer. Il file di certificato viene utilizzato per configurare le API del servizio in Adobe Developer Console. Toccare Next.
-
Specifica quanto segue:
- Title (Titolo): specifica un titolo.
- Server autorizzazioni: https://ims-na1.adobelogin.com\
Lascia vuoti gli altri campi per il momento (dovranno essere riempiti successivamente). Tieni aperta la pagina.
(Solo per AEM 6.4 e AEM 6.5) Configura le API del servizio su Adobe Developer Console createintegration
Per utilizzare il servizio di Automated forms conversion (AFCS), crea un progetto e aggiungi l’API del servizio Configurazione automatica Forms al progetto su Adobe Developer Console. L’integrazione genera la chiave API, il segreto client, il payload (JWT).
-
Accedi a https://console.adobe.io/. Utilizza l’account Adobe ID per sviluppatori fornito dall’amministratore per accedere alla console Adobe I/O e accedervi.
-
Seleziona la tua organizzazione dall’angolo in alto a destra. Se non sai qual è la tua organizzazione, contatta l’amministratore.
-
Toccare Create new project. Viene visualizzata una schermata per iniziare a utilizzare il nuovo progetto. Toccare Add API. Viene visualizzata una schermata con l’elenco di tutte le API abilitate per l’account.
-
Seleziona Automated Forms Conversion service e tocca Next. Viene visualizzata una schermata per configurare l’API.
-
Seleziona l'opzione Upload your public key, carica il file AEM-Adobe-IMS.crt scaricato nella sezione Ottieni certificati pubblici e tocca Next. Viene visualizzata l’opzione Create a new Service Account (JWT) credential (Crea una nuova credenziale account di servizio (JWT)). Toccare Next.
-
Selezionare un profilo di prodotto e toccare Save configured API. Seleziona il profilo creato durante la concessione dell'accesso agli sviluppatori dell'organizzazione. Se non conosci il profilo da selezionare, contatta l’amministratore.
-
Tocca Service Account (JWT) per visualizzare la chiave API, il segreto client e altre informazioni necessarie per connettere l'istanza AEM locale al servizio di Automated forms conversion (AFCS). Le informazioni contenute nella pagina vengono utilizzate per creare la configurazione IMS sul computer locale.
-
Apri la pagina Configurazione IMS nell’istanza locale. Hai tenuto aperta questa pagina alla fine della sezione Recuperare il certificato pubblico.
-
Nella pagina Tecnica Adobe IMS, specifica Chiave API e Segreto client. Utilizza i valori specificati in Service Account (JWT) (Account di servizio (JWT)) nella pagina della console Adobe Developer.
note note NOTE Per il payload, utilizza il codice fornito nella scheda Genera JWT della pagina Account di servizio (JWT) di Adobe Developer Console. -
Toccare Save. Viene creata la configurazione IMS.
note caution CAUTION Crea una sola configurazione IMS. Non creare più di una configurazione IMS. -
Seleziona la configurazione IMS e tocca Check Health. Viene visualizzata una finestra di dialogo. Toccare Check. Una volta stabilita la connessione, viene visualizzato il messaggio Token recuperato correttamente.
Configurare il Cloud Service configure-the-cloud-service
Crea una configurazione di Cloud Service per collegare l’istanza 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, toccare Adobe Experience Manager > Tools> Cloud Services > Automate Forms Conversion Configuration.
-
Tocca la cartella Global e tocca Create. Viene visualizzata la pagina per la creazione della configurazione del Automated forms conversion. La configurazione viene creata nella cartella Globale. Puoi anche creare la configurazione in un’altra cartella esistente o creare una cartella per le configurazioni.
-
Nella pagina Create Automated Forms Conversion Configuration, specifica il valore per i campi seguenti e tocca Next.
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 Campo Descrizione Titolo Titolo univoco per la configurazione. Il titolo viene visualizzato nell’interfaccia utente utilizzata per avviare la conversione. Nome Nome univoco per la configurazione. La configurazione viene salvata nel CRX-Repository con il nome specificato. Il nome può corrispondere al titolo. Posizione miniature Posizione della miniatura per la configurazione. URL del servizio URL del servizio di Automated forms conversion (AFCS) su Adobe Cloud. Utilizza l'URL https://aemformsconversion.adobe.io/.Modello Modello 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. Tema Tema 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 esistenti Posizione di eventuali frammenti esistenti. Metamodello personalizzato Percorso 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:
table 0-row-2 1-row-2 2-row-2 Campo Descrizione Genera documento di record Selezionare 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 (Solo per AEM 6.4 e 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:
code language-css { "Type": "Principal", "Amount": "10.00", "currency": "USD" } -
Toccare Create. Viene creata la configurazione cloud. La tua istanza di AEM Forms è pronta per iniziare a convertire i moduli legacy in moduli adattivi.