Questa guida descrive come un amministratore AEM può configurare il servizio Automated forms conversion per automatizzare la conversione dei propri 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 abbia familiarità con le seguenti tecnologie:
Installazione, configurazione e amministrazione dei pacchetti Adobe Experience Manager e AEM,
utilizzando sistemi operativi Linux® e Microsoft® Windows®,
Configurazione dei server di posta SMTP
Il servizio è disponibile gratuitamente per AEM i clienti Forms 6.4 e Forms On-Premise 6.5 e per i clienti aziendali di Adobe-Managed Service. È possibile contattare il team di vendita Adobe o il proprio rappresentante Adobe per richiedere l’accesso al servizio. Il servizio è disponibile 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 AEM Forms (utenti) dell’organizzazione l’accesso al servizio.
Per utilizzare il servizio Automated forms conversion è necessario quanto segue:
Prima di utilizzare il servizio, prepara la tua istanza di autore AEM per connetterti al servizio in esecuzione su Adobe Cloud. Esegui i seguenti passaggi nella sequenza elencata per preparare l'istanza per il servizio:
Il servizio di automated forms conversion viene eseguito su AEM’istanza di authoring. È necessario AEM 6.4, AEM 6.5 o AEM Forms come Cloud Service per impostare un'istanza di authoring AEM.
Se non hai AEM 6.4 o AEM 6.5 in esecuzione, scaricalo dalle posizioni seguenti. Dopo aver scaricato AEM, per istruzioni su come impostare un'istanza AEM dell'autore, consulta distribuzione e manutenzione:
Se sei un cliente AEM esistente, scarica AEM 6.4 o AEM 6.5 dal sito web relativo alle licenze di Adobe.
Se sei un partner di Adobe, utilizza Adobe Partner Training Program per richiedere AEM 6.4 o AEM 6.5.
Se utilizzi AEM Forms as a Cloud Service, consulta onboard in AEM Forms as a Cloud Service e configura un ambiente di sviluppo locale.
Scarica e installa AEM Service Pack più recente. Per istruzioni dettagliate, consulta le AEM Note sulla versione 6.4 Service Pack o AEM Note sulla versione 6.5 Service Pack.
Un’istanza AEM contiene funzionalità di base dei moduli. Il servizio di conversione richiede funzionalità complete di AEM Forms. Scarica e installa il pacchetto aggiuntivo di AEM Forms per sfruttare tutte le funzionalità di AEM Forms. Il pacchetto è necessario per configurare ed eseguire il servizio di conversione. Per istruzioni dettagliate, consulta Installare e configurare le funzionalità di acquisizione dati.
Assicurati di eseguire le configurazioni obbligatorie post-installazione dopo l'installazione del pacchetto aggiuntivo.
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 Automated forms conversion richiede almeno un tema e un modello per convertire un modulo PDF in un modulo adattivo. Crea un tema e un modello personalizzati e specifica la configurazione del servizio per utilizzare modelli e temi personalizzati prima di utilizzare il servizio.
Puoi anche scaricare e installare il pacchetto Risorse di riferimento AEM Forms sulla tua istanza di authoring. Crea alcuni temi e modelli di riferimento.
Prima di procedere alla configurazione del servizio e di collegare l’istanza locale 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:
Dopo l’Adobe che abilita l’accesso per la tua organizzazione e fornisce all’amministratore i privilegi necessari, l’amministratore può accedere all’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 su Adobe Cloud.
Gli sviluppatori sono membri dell’organizzazione designata per l’esecuzione del servizio di conversione. Solo gli sviluppatori che vengono aggiunti al profilo del servizio Adobe Automated forms conversion possono utilizzare il servizio di Automated forms conversion. Esegui i passaggi seguenti per creare un profilo e aggiungervi sviluppatori. Per concedere agli sviluppatori dell’organizzazione l’accesso richiesto è necessario almeno un profilo:
Accedi a Admin Console. Utilizza Adobe ID dell'amministratore predisposto per utilizzare il servizio Automated forms conversion per l'accesso. Non effettuare l'accesso con altri ID o Federated ID.
Fai clic sull’opzione Automated Forms Conversion .
Fare clic su New Profile nella scheda Products.
Specifica Name, Display Name e Description per il profilo. Clic Done. Viene creato un profilo.
Aggiungi lo sviluppatore al profilo. Per aggiungere gli sviluppatori:
Ripeti i passaggi precedenti per tutti gli utenti. Per ulteriori dettagli sull’aggiunta di sviluppatori, consulta Gestire gli sviluppatori.
Una volta che un amministratore aggiunge sviluppatori al profilo di Adobe I/O, gli sviluppatori vengono informati via e-mail. Dopo aver ricevuto l'e-mail, gli sviluppatori possono procedere alla connessione di un'istanza AEM Forms locale con il servizio Automated forms conversion su Adobe Cloud.
Dopo che un amministratore ti fornisce l’accesso per sviluppatori, puoi collegare la tua istanza AEM Forms locale al servizio Automated forms conversion in esecuzione su Adobe Cloud. Esegui i seguenti passaggi nella sequenza elencata per collegare l’istanza AEM Forms al servizio:
Il servizio di automated forms conversion utilizza il servizio di posta Day CQ per inviare notifiche e-mail. Queste notifiche e-mail contengono informazioni sulle conversioni riuscite o non riuscite. Se scegli di non ricevere la notifica, salta questi passaggi. Esegui i seguenti passaggi per configurare Day CQ Mail Service:
Per Forms 6.4 Forms o AEM 6.5:
Vai a AEM gestione configurazione all'indirizzo http://localhost:4502/system/console/configMgr
Apri la configurazione Day CQ Mail Service . Specificare un valore per i campi SMTP server host name, SMTP server port e From address. Clic Save.
Per informazioni sul nome host e la porta del server SMTP, contattare il provider di servizi e-mail o l'amministratore IT. 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 , specifica il nome host o l’indirizzo IP effettivo e il numero di porta per le istanze locali, di authoring e di pubblicazione. Clic Save.
Per AEM Forms as a Cloud Service, registra un ticket di supporto per abilitare il servizio e-mail.
Specifica un indirizzo e-mail nel profilo dell’utente AEM designato per eseguire il servizio. Assicurati che l'utente sia il membro del gruppo forms user . 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 alla tua istanza di authoring di AEM Forms come amministratore AEM. Utilizza le tue credenziali AEM locali per accedere. Non utilizzare Adobe ID per l'accesso. Tocca Adobe Experience Manager > Tools > Security > Users.
Seleziona un utente designato per eseguire il servizio di conversione e tocca 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 all’errore della conversione.
Tocca la scheda Gruppi . Nella scheda seleziona gruppo, digita e seleziona il gruppo forms-users . Tocca Salva e chiudi. L’utente è ora membro del gruppo utenti moduli.
Un certificato pubblico consente di autenticare il profilo su Adobe I/O.
Accedi alla tua istanza di authoring di AEM Forms. Accedi a Tools> Security > Adobe IMS Configurations. Toccare Create. Viene visualizzata la pagina Adobe IMS Technical Account Configuration .
Seleziona Automated Forms Conversion Service in 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. Clic OK. Il certificato viene creato.
Tocca Download Public Key e salva il file di certificato AEM-Adobe-IMS.crt sul computer. Il file del certificato viene utilizzato per configurare le API del servizio in Adobe Developer Console. Toccare Next.
Specifica quanto segue:
Lascia vuoti gli altri campi per il momento (dovranno essere riempiti successivamente). Tieni aperta la pagina.
Per utilizzare il servizio Automated forms conversion, crea un progetto e aggiungi l’API Servizio di configurazione Forms automatizzata al progetto in Adobe Developer Console. L’integrazione genera Chiave API, Segreto client, Payload (JWT).
Accedi a https://console.adobe.io/. Utilizza il tuo account sviluppatore Adobe ID 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 il tuo 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 Crea una nuova credenziale dell’account di servizio (JWT). Toccare Next.
Seleziona un profilo di prodotto e tocca Save configured API. Seleziona il profilo creato mentre concedi l'accesso agli sviluppatori della tua 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 collegare l’istanza AEM locale al servizio di Automated forms conversion. Le informazioni presenti 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 Account di servizio (JWT) della pagina Adobe Developer Console.
Per il payload, utilizza il codice fornito nella scheda Genera JWT della pagina Service Account (JWT) di Adobe Developer Console.
Toccare Save. Viene creata la configurazione IMS.
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.
Crea una configurazione di Cloud Service per collegare la tua 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 di servizi cloud separate per ciascun set di moduli. Ad esempio, è possibile disporre di una configurazione separata per i moduli del reparto vendite e una separata per i moduli di assistenza clienti. Esegui i seguenti passaggi per creare una configurazione del servizio cloud:
Nell’istanza di AEM Forms, tocca 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.
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ò essere identico al titolo. |
Posizione della miniatura | Posizione della miniatura per la configurazione. |
URL servizio | URL del servizio Automated forms conversion 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 avviare la conversione. Un modello contiene la struttura di base e il contenuto iniziale di un modulo adattivo. Puoi scegliere un modello dai modelli forniti come predefiniti. Puoi anche creare un modello personalizzato. |
Tema | Tema predefinito da applicare ai moduli convertiti. Puoi sempre specificare un tema diverso prima di avviare la conversione. Puoi fare clic sull’icona per scegliere un tema fornito come predefinito. Puoi anche creare un tema personalizzato. |
Frammenti esistenti | Posizione dei frammenti esistenti, se presenti. |
Meta-modello personalizzato | Percorso del file .schema.json del metamodello personalizzato. È possibile creare metamodello separati per le lingue inglese, francese, tedesco, spagnolo, italiano e portoghese. |
Nella scheda Advanced della pagina Create Automated Forms Conversion Configuration , specifica il valore per il campo seguente:
Campo | Descrizione |
---|---|
Genera documento di record | Selezionare l’opzione per generare automaticamente Documento di record per i moduli convertiti. L’opzione è disponibile solo per i moduli basati su XFA (XDP e PDF forms). Quando si attiva l’opzione, dopo l’invio di un modulo è possibile consentire ai clienti di conservare un record, in formato cartaceo o in formato documento, delle informazioni che hanno compilato nel modulo per il riferimento futuro. Tale documento è denominato documento di registrazione. |
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 l’istanza AEM Forms. |
<Amount currency="USD"> 10.00 </Amount>
. La valuta viene salvata come attributo e importo della valuta, 10.00 viene salvato come elemento. I dati di invio di un modulo adattivo non hanno attributi, dispone 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. Ad esempio, {
"Type": "Principal",
"Amount": "10.00",
"currency": "USD"
}
Toccare Create. Viene creata la configurazione cloud. L’istanza AEM Forms è pronta per iniziare a convertire i moduli legacy in moduli adattivi.