Configurazione del servizio di conversione automatica dei moduli

Questa guida descrive come un amministratore AEM può configurare il servizio di Automated forms conversion per automatizzare la conversione dei propri 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 Automated forms conversion è necessario disporre dei seguenti requisiti:

  • Il servizio automated forms conversion è abilitato per l'organizzazione
  • 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:

  1. Scaricare e installare AEM 6.4 o AEM 6.5
  2. Download e installazione della versione più recente di AEM Service Pack
  3. Download e installazione della versione più recente pacchetto aggiuntivo AEM Forms
  4. (facoltativo) Scaricare e installare l'ultimo pacchetto di connettori
  5. Creare temi e modelli personalizzati

Download e installazione AEM 6.4 o AEM 6.5

Il servizio di automated forms conversion viene eseguito AEM’istanza di creazione. È 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:

Dopo aver scaricato AEM, per istruzioni su come impostare un'istanza AEM di creazione, vedere implementazione e manutenzione.

Download e installazione AEM Service Pack più recente

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

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, vedere Installare e configurare le funzionalità di acquisizione dei dati.

NOTA

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 consente di accedere in anticipo alle funzionalità 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. È possibile scaricare il pacchetto del connettore da AEM Package Share.

Creare temi e modelli personalizzati

Se iniziate AEM in modalità di produzione (nessuna modalità di esecuzione del contenuto di esempio), 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 PDF forms in un modulo adattivo. Crea un tema e un modello personalizzati con la tua configurazione del servizio per utilizzare i modelli e i temi personalizzati prima di utilizzare 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 nella propria organizzazione per connettersi al servizio di Automated forms conversion in esecuzione su Adobe Cloud. Quando un amministratore effettua il provisioning per un’organizzazione, l’amministratore riceve un’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 passate a concedere l’accesso agli sviluppatori della vostra organizzazione.

email di concessione di accesso amministratore

  • Sviluppatori: Uno sviluppatore collega un’istanza di creazione AEM Forms locale al servizio di Automated forms conversion in esecuzione Adobe Cloud. Quando un amministratore concede i diritti a uno sviluppatore per la connessione al servizio Automated forms conversion, un messaggio e-mail con titolo L'utente dispone ora dell'accesso sviluppatore per gestire integrazioni API Adobe per l'organizzazione viene inviato allo sviluppatore. Se siete uno sviluppatore, controllate la casella di posta elettronica con il titolo sopra indicato e andate a Collegare l'istanza AEM locale al servizio di Automated forms conversion in Adobe cloud.

email di concessione accesso sviluppatore

(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 Automated forms conversion Adobe Cloud.

Gli sviluppatori sono membri dell'organizzazione designata per eseguire il servizio di conversione. Solo gli sviluppatori che vengono aggiunti profilo di servizio Automated forms conversion Adobe possono utilizzare il servizio di Automated forms conversion. 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 a Admin Console. Utilizzate Adobe ID dell'amministratore fornito per utilizzare il servizio di Automated forms conversion per effettuare l'accesso. Non utilizzare altri ID o Federated ID per effettuare l'accesso.

  2. Fare clic sull'opzione Automated Forms Conversion.

  3. Fare clic su New Profile nella scheda Products.

  4. Specificare Name, Display Name e Description per il profilo. Clic Done. Viene creato un profilo.

    Specificate i dettagli per il nuovo profilo.

  5. Aggiungi lo sviluppatore al profilo. Per aggiungere gli sviluppatori:

    1. Nel Admin Console , passare alla scheda Panoramica.
    2. Fate clic su Assign Developers nella 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 informazioni sull'aggiunta di sviluppatori, vedere Gestione di sviluppatori.

Dopo che un amministratore aggiunge gli sviluppatori profilo Adobe I/O, gli sviluppatori ricevono una notifica via e-mail. Dopo aver ricevuto l'e-mail, gli sviluppatori possono continuare a collegare un'istanza AEM Forms locale con il servizio di Automated forms conversion in Cloud.

(Solo per sviluppatori) Collegate l'istanza locale AEM Forms al servizio Automated forms conversion in Adobe cloud

Dopo che un amministratore vi fornisce l'accesso per sviluppatori, potete collegare l'istanza locale AEM Forms al servizio di Automated forms conversion in esecuzione 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 automated forms conversion utilizza il servizio e-mail 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. Andate AEM gestore di configurazione all'indirizzo http://localhost:4502/system/console/configMgr

  2. Aprire la configurazione Day CQ Mail Service. Specificare 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 configurazione Day CQ Link Externalizer. Nel campo Domains, specificate il nome host o l'indirizzo IP effettivo e il numero di porta per le istanze locali, di autori 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 moduli utente. 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. Toccate 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 campo Email 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 selezionare, digitare e selezionare il gruppo forms-users. Toccate Save and Close (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 visualizzata la pagina Adobe IMS Technical Account Configuration.

    Pagina Configurazione account tecnico IMS del Adobe

  2. Seleziona Automated Forms Conversion Service nella soluzione cloud.

  3. 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.

  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 sviluppatore Adobe

Per utilizzare il servizio di Automated forms conversion, create un progetto e aggiungete al progetto l'API del servizio di configurazione Forms automatizzata in Adobe Developer Console. L'integrazione genera Chiave API, Segreto cliente, Payload (JWT).

  1. Accedete a https://console.adobe.io/. Utilizzate l'account sviluppatore Adobe ID fornito dall'amministratore per accedere console Adobe I/O e accedervi.

  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. Selezionare Automated Forms Conversion service e toccare Next. Viene visualizzata una schermata per configurare l'API.

  5. Selezionate l'opzione Upload your public key, caricate il file AEM- Adobe-IMS.crt scaricato nella sezione Acquisisci 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. Selezionare 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 Automated forms conversion. 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.

    Specificare titolo, chiave API, segreto cliente e payload

  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 .

    NOTA

    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.

    ATTENZIONE

    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.

    In caso di connessione riuscita, viene visualizzato il messaggio di recupero token completato.



Configurare il servizio cloud

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. Nell'istanza AEM Forms , toccare Adobe Experience Manager > Tools Cloud Services > Automate Forms Conversion Configuration.

  2. Toccate la cartella Global e toccate Create. Viene visualizzata la pagina per la creazione della configurazione del Automated forms conversion. 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 pagina Create Automated Forms Conversion Configuration, specificate il valore per i seguenti campi e toccate 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 Automated forms conversion in Adobe Cloud. Utilizzate l'URL https://aemformsconversion.adobe.io/.
    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 scheda Advanced della pagina Create Automated Forms Conversion Configuration, specificare 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.

In questa pagina