Show Menu
ARGOMENTI×

Configurazione del servizio di conversione automatica dei moduli

Questa guida descrive come un amministratore AEM può configurare il servizio di conversione automatizzata di Forms per automatizzare la conversione dei PDF forms nei moduli adattivi. Questa guida è destinata agli amministratori IT e AEM della vostra azienda. Le informazioni fornite si basano sul presupposto che chiunque legga la presente Guida 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,
  • Configurazione dei server di posta SMTP

Onboarding

Il servizio è disponibile gratuitamente per i clienti AEM 6.4 Forms e AEM 6.5 Forms On-Premise 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.
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.

Prerequisiti

Per utilizzare il servizio di conversione Forms automatizzato è necessario disporre di quanto segue:
  • Servizio di conversione Forms automatizzato abilitato per l'azienda
  • Un account Adobe ID con privilegi di amministratore per il servizio di conversione
  • Un’istanza di authoring AEM 6.4 o AEM 6.5 con AEM Service Pack più recente
  • Un utente AEM (nell’istanza AEM) membro del gruppo forms-user

Configurazione dell’ambiente

Prima di utilizzare il servizio, preparate l'istanza AEM autore per collegarvi al servizio in esecuzione su Adobe Cloud. Per preparare l’istanza per il servizio, eseguite i seguenti passaggi nella sequenza elencata:

Scaricare e installare AEM 6.4 o AEM 6.5

Il servizio di conversione Forms automatizzata viene eseguito sull'istanza AEM autore. È necessario AEM 6.4 o AEM 6.5 per impostare un’istanza AEM di creazione. Se non disponete di AEM pronti, scaricatelo dalle seguenti posizioni:
  • Se siete già clienti AEM, scaricate AEM 6.4 o AEM 6.5 dal sito Web delle licenze dei Adobi di .
  • Se siete un partner Adobe, utilizzate programma di formazione per i partner di Adobe per richiedere AEM 6.4 o AEM 6.5.
Dopo aver scaricato AEM, per istruzioni su come impostare un’istanza AEM di creazione, consultate Implementazione e manutenzione .

Download e installazione AEM Service Pack più recente

Scarica e installa AEM Service Pack più recente. Per istruzioni dettagliate, consultate AEM Note sulla versione di Service Pack 6.4 o AEM Note sulla versione di Service Pack 6.5.

Download e installazione pacchetto aggiuntivo AEM Forms

Un'istanza AEM contiene funzionalità di base dei moduli. Il servizio di conversione richiede funzionalità complete di AEM Forms. Scaricate e installate pacchetto aggiuntivo AEM Forms per sfruttare tutte le funzionalità di AEM Forms. Il pacchetto è necessario per configurare ed eseguire il servizio di conversione. Per istruzioni dettagliate, consultate Installare e configurare le funzionalità di acquisizione dei dati.
Dopo aver installato il pacchetto del componente aggiuntivo, accertatevi di eseguire le configurazioni obbligatorie per il post-installazione.

(Facoltativo) Scaricare e installare il pacchetto del connettore

Il pacchetto del connettore permette di accedere rapidamente alle funzioni di rilevamento automatico delle sezioni logiche e ai miglioramenti introdotti nella release AFC-2020.03.1. Non installate il pacchetto se non avete bisogno di funzionalità e miglioramenti implementati in AFC-2020.03.1. Potete scaricare il pacchetto del connettore da AEM Package Share .

Creare temi e modelli personalizzati

Se avviate AEM in modalità di produzione (nosamplecontent runmode), i pacchetti di riferimento non vengono installati. I pacchetti di riferimento contengono temi e modelli di esempio. Il servizio di conversione Forms automatizzata richiede almeno un tema e un modello per convertire un PDF forms in un modulo adattivo. Create un tema e un modello personalizzati con la configurazione del vostro e del vostro servizio per utilizzare modelli e temi personalizzati prima di usare il servizio.

Configurazione del servizio

Prima di configurare il servizio e collegare l'istanza locale al servizio in esecuzione Adobe Cloud, è necessario conoscere le persone e i privilegi necessari per connettersi al servizio. Il servizio utilizza due diversi tipi di personalità, amministratori e sviluppatori:
  • Amministratori : Gli amministratori sono responsabili della gestione software e servizi di Adobe per la propria organizzazione. Gli amministratori concedono l'accesso agli sviluppatori della propria organizzazione per connettersi al servizio di conversione Forms automatizzato in esecuzione su Adobe Cloud. Quando un amministratore effettua il provisioning per un'organizzazione, l'amministratore riceve un messaggio e-mail con titolo 'You now have administrator rights to manage Adobe software and services for your organization' . Se siete un amministratore, controllate la casella di posta elettronica con il titolo sopra indicato e continuate a concedere l'accesso agli sviluppatori della vostra organizzazione .
  • Sviluppatori : Uno sviluppatore collega un'istanza di autore AEM Forms locale al servizio di conversione automatizzata di Forms in esecuzione Cloud. Quando un amministratore concede i diritti a uno sviluppatore per connettersi al servizio di conversione Forms automatizzata, un'e-mail con titolo L'utente dispone ora dell'accesso sviluppatore per gestire integrazioni API Adobe per la propria azienda viene inviata allo sviluppatore. Se siete uno sviluppatore, controllate la casella di posta elettronica con il titolo sopraindicato e passate a Connect l'istanza AEM locale al servizio di conversione automatizzata di Forms su Adobe cloud.

(Solo per amministratori) Concedi l'accesso agli sviluppatori della tua organizzazione

Dopo che Adobe consente l’accesso all’organizzazione e fornisce all’amministratore i privilegi necessari, l’amministratore può accedere 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 di conversione automatizzata di Forms su Adobe Cloud.
Gli sviluppatori sono membri dell'organizzazione designata per eseguire il servizio di conversione. Solo gli sviluppatori che vengono aggiunti al profilo servizio di conversione automatizzata Forms di Adobe hanno diritto a utilizzare il servizio di conversione automatizzata Forms. Per creare un profilo e aggiungervi degli sviluppatori, effettuate le seguenti operazioni. È necessario un minimo di un profilo per concedere l'accesso necessario agli sviluppatori dell'organizzazione:
  1. Accedete al Admin Console . Utilizza Adobe ID dell'amministratore appositamente predisposto per utilizzare il servizio di conversione Forms automatizzata per effettuare l'accesso. Non utilizzare altri ID o Federated ID per effettuare l'accesso.
  2. Fate clic sull’ Automated Forms Conversion opzione.
  3. Fate clic New Profile nella Products scheda.
  4. Specificate Name , Display Name e Description per il profilo. Clic Done . Viene creato un profilo.
  5. Aggiungi lo sviluppatore al profilo. Per aggiungere gli sviluppatori:
    1. Nel Admin Console enterprise , passare alla scheda Panoramica.
    2. Fate clic Assign Developers sulla scheda prodotto richiesta.
    3. Immettete l’indirizzo e-mail e, facoltativamente, il nome e il cognome degli sviluppatori.
    4. Seleziona profili di prodotto. Toccare Save .
Ripetete i passaggi indicati sopra per tutti gli utenti. Per ulteriori dettagli sull'aggiunta di sviluppatori, consultate Gestire gli sviluppatori .
Dopo che un amministratore aggiunge gli sviluppatori profilo I/O del Adobe, gli sviluppatori ricevono una notifica via e-mail. Dopo aver ricevuto l'e-mail, gli sviluppatori possono procedere a collegare un'istanza di AEM Forms locale con il servizio di conversione Forms automatizzata in Adobe Cloud .

(Solo per sviluppatori) Collegate l'istanza locale AEM Forms al servizio di conversione automatizzata di Forms in Adobe cloud

Dopo che un amministratore vi fornisce l'accesso per sviluppatori, potete collegare l'istanza locale AEM Forms al servizio di conversione automatizzato di Forms in esecuzione su Adobe Cloud. Per collegare l’istanza di AEM Forms al servizio, eseguite i seguenti passaggi nella sequenza elencata:

Configurare la notifica e-mail

Il servizio di conversione Forms automatizzata utilizza il servizio di posta di Day CQ per inviare le notifiche e-mail. Queste notifiche e-mail contengono informazioni sulle conversioni riuscite o non riuscite. Se scegliete di non ricevere la notifica, saltate questi passaggi. Per configurare Day CQ Mail Service, effettuate le seguenti operazioni:
  1. Vai a AEM gestore di configurazione all'indirizzo http://localhost:4502/system/console/configMgr
  2. Aprire la configurazione Day CQ Mail Service. Specificate un valore per i campi SMTP server host name , SMTP server port e From address . Clic Save .
    È possibile contattare il provider di servizi e-mail o l'amministratore IT per informazioni sul nome host e sulla porta del server SMTP. Potete utilizzare qualsiasi indirizzo e-mail valido nel campo da. Ad esempio, notification@example.com o donotreply@example.com .
  3. Aprite la Day CQ Link Externalizer configurazione. Nel Domains campo, specificate il nome host o l'indirizzo IP effettivo e il numero di porta per le istanze locali, di creazione e di pubblicazione. Clic Save .

Aggiunta di un utente al gruppo di utenti dei moduli

Specificate un indirizzo e-mail nel profilo dell'utente AEM designato per eseguire il servizio. Assicurarsi che l'utente sia il membro del gruppo di 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`e moduli:
  1. Accedete all’istanza di creazione AEM Forms come amministratore AEM. Utilizzate le credenziali AEM locali per accedere. Non utilizzate Adobe ID per effettuare l'accesso. Tap Adobe Experience Manager > Tools > Security > Users .
  2. Selezionate un utente designato per eseguire il servizio di conversione e toccate Properties . Viene visualizzata la pagina Modifica impostazioni utente.
  3. Specificate un indirizzo e-mail nel Email campo e toccate Save . Le e-mail vengono inviate all'indirizzo e-mail specificato al completamento o all'esito negativo della conversione.
  4. Toccate la scheda Gruppi . Nella scheda del gruppo di selezione, digitare e selezionare il gruppo moduli-utenti . Toccate Salva e chiudi . L'utente ora è membro del gruppo form-users.

Ottenere certificati pubblici

Un certificato pubblico consente di autenticare il profilo su Adobe I/O.
  1. Accedete all’istanza di creazione AEM Forms. Accedi a Tools > Security > Adobe IMS Configurations . Toccare Create . Viene Adobe IMS Technical Account Configuration visualizzata la pagina.
  2. Seleziona Automated Forms Conversion Service in Cloud Solution.
  3. Selezionare la Create new certificate casella di controllo 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.
  4. Toccate Download Public Key e salvate il file di certificato AEM--IMS.crt sul computer. Il file del certificato viene utilizzato per configurare le API del servizio console sviluppatore di Adobi. Toccare Next .
  5. Specificate quanto segue:
    Lascia vuoti gli altri campi per il momento (dovranno essere riempiti successivamente). Tenete la pagina aperta.

Configurare le API del servizio console Sviluppo Adobe

Per utilizzare il servizio di conversione Forms automatizzata, create un progetto e aggiungete al progetto l'API del servizio di configurazione Forms automatizzata in Developer Console di Adobe. L'integrazione genera Chiave API, Segreto cliente, Payload (JWT).
  1. Effettuate l'accesso a https://console.adobe.io/ . Utilizzate l'account sviluppatore Adobe ID fornito dall'amministratore per accedere console I/O del Adobe a cui accedere.
  2. Seleziona la tua organizzazione dall’angolo in alto a destra. Se non sai qual è la tua organizzazione, contatta l’amministratore.
  3. 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.
  4. Seleziona Automated Forms Conversion service e tocca Next . Viene visualizzata una schermata per configurare l'API.
  5. Selezionate l' Upload your public key opzione, caricate il file AEM- Adobe-IMS.crt scaricato nella sezione Ottieni certificati pubblici e toccate Next . Viene visualizzata l'opzione Crea una nuova credenziale JWT (Service Account). Toccare Next .
  6. Selezionate un profilo di prodotto e toccate Save configured API . Selezionate il profilo creato durante la concessione dell'accesso agli sviluppatori dell'organizzazione . Se non conosci il profilo da selezionare, contatta l’amministratore.
  7. Toccate Service Account (JWT) per visualizzare la chiave API, il Segreto cliente e altre informazioni necessarie per collegare l'istanza AEM locale al servizio di conversione automatizzata di Forms. Le informazioni presenti nella pagina vengono utilizzate per creare la configurazione IMS sul computer locale.
  8. Aprite la pagina Configurazione IMS nell’istanza locale. Hai tenuto aperta questa pagina alla fine della sezione Recuperare il certificato pubblico .
  9. Nella pagina tecnica IMS del Adobe , specificate Chiave API e Segreto cliente. Utilizzate i valori specificati in Account servizio (JWT) della pagina della console Sviluppatore di Adobi .
    Per il payload, utilizzate il codice fornito nella scheda Generate JWT della pagina Service Account (JWT) Adobe Developer Console.
  10. Toccare Save . Viene creata la configurazione IMS.
    Create una sola configurazione IMS. Non create più configurazioni IMS.
  11. Selezionate la configurazione IMS e toccate Check Health . Viene visualizzata una finestra di dialogo. Toccare Check . Una volta stabilita la connessione, viene visualizzato il messaggio Token recuperato correttamente .

Configure the cloud service

Crea una configurazione del servizio cloud per collegare l’istanza AEM al servizio di conversione. Consente inoltre di specificare un modello, un tema e frammenti di modulo per una conversione. È possibile creare più configurazioni del servizio cloud distinte per ciascun set di moduli. Ad esempio, è possibile disporre di una configurazione separata per i moduli del reparto vendite e di una configurazione separata per i moduli di assistenza clienti. Per creare una configurazione di servizio cloud, effettuate le seguenti operazioni:
  1. Sull’istanza AEM Forms , toccate Adobe Experience Manager > Tools > Cloud Services > Automate Forms Conversion Configuration .
  2. Toccate la Global cartella e toccate Create . Viene visualizzata la pagina per la creazione della configurazione di conversione automatica Forms. La configurazione viene creata nella cartella Globale. Potete anche creare la configurazione in un'altra cartella già esistente o creare una nuova cartella per le configurazioni.
  3. Nella Create Automated Forms Conversion Configuration pagina, 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 miniatura
    Posizione della miniatura per la configurazione.
    URL servizio
    URL del servizio di conversione Forms automatizzata su Adobe Cloud. Utilizzate l' https://aemformsconversion.adobe.io/ URL.
    Modello
    Modello predefinito da applicare ai moduli convertiti. È sempre possibile specificare un modello diverso prima di avviare la conversione. Un modello contiene la struttura di base e il contenuto iniziale per un modulo adattivo. Potete scegliere un modello dai modelli forniti out-of-the-box. Potete anche creare un modello personalizzato.
    Tema
    Tema predefinito da applicare ai moduli convertiti. È sempre possibile specificare un tema diverso prima di avviare la conversione. Potete fare clic sull'icona per scegliere un tema fornito out-of-the-box. Potete anche creare un tema personalizzato.
    Frammenti esistenti
    Posizione degli eventuali frammenti esistenti.
    Meta-modello personalizzato
    Percorso del file .schema.json del meta-modello personalizzato.
  4. Nella Advanced scheda della Create Automated Forms Conversion Configuration pagina, specificate il valore per il campo seguente:
    Campo Descrizione
    Genera documento di record Selezionare l'opzione per generare automaticamente il documento di registrazione per i moduli convertiti. L'opzione è disponibile solo per i moduli basati su XFA (XDP e PDF forms). Quando si abilita 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 Selezionare l'opzione per attivare Adobe Analytics su tutti i moduli convertiti. Prima di utilizzare l'opzione, verificate che Adobe Analytics sia attivato per l'istanza di AEM Forms .
    • Se 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 predefinito per generare DOR per altri moduli basati su XFA.
    • Quando viene inviato un modulo XFA, i dati di invio del modulo vengono salvati come elemento XML o come attributo. Esempio, <Amount currency="USD"> 10.00 </Amount> . La valuta viene salvata come attributo e l'importo della valuta, 10.00 viene salvato come elemento. I dati di invio di un modulo adattivo non hanno attributi, ma solo 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. Esempio,
       {
          "Type": "Principal",
    
          "Amount": "10.00",
    
          "currency": "USD"
       }
    
    
  5. Toccare Create . Viene creata la configurazione cloud. L'istanza di AEM Forms è pronta per iniziare a convertire moduli legacy in moduli adattivi.