Gestione dei Forms inviati handling-submitted-forms

Last update: Sun Jul 14 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Argomenti:

Creato per:

Sviluppatore

Gli esempi e gli esempi contenuti in questo documento sono solo per AEM Forms in ambiente JEE.

Le applicazioni basate sul Web che consentono a un utente di compilare moduli interattivi richiedono l'invio dei dati al server. Tramite il servizio Forms è possibile recuperare i dati immessi dall'utente in un modulo interattivo. Dopo aver recuperato i dati, è possibile elaborarli per soddisfare i requisiti aziendali. È ad esempio possibile memorizzare i dati in un database, inviarli a un'altra applicazione, inviarli a un altro servizio, unire i dati in una struttura di modulo, visualizzarli in un browser Web e così via.

I dati del modulo vengono inviati al servizio Forms come dati XML o PDF, opzione impostata in Designer. Un modulo inviato come XML consente di estrarre i singoli valori dei dati dei campi. In altre parole, è possibile estrarre il valore di ogni campo modulo immesso dall'utente nel modulo. Un modulo inviato come dati PDF è costituito da dati binari e non da dati XML. È possibile salvare il modulo come file PDF o inviarlo a un altro servizio. Se si desidera estrarre dati da un modulo inviato come XML e quindi utilizzare i dati del modulo per creare un documento PDF, richiamare un'altra operazione AEM Forms. (Vedi Creazione di documenti PDF con dati XML inviati)

Il diagramma seguente mostra i dati inviati a un servlet Java denominato HandleData da un modulo interattivo visualizzato in un browser Web.

hs_hs_handlesubmit

Nella tabella seguente vengono illustrati i passaggi del diagramma.

Passaggio

Descrizione

Un utente compila un modulo interattivo e fa clic sul pulsante Invia del modulo.

I dati vengono inviati al servlet Java HandleData come dati XML.

Il servlet Java HandleData contiene la logica dell'applicazione per recuperare i dati.

Gestione dei dati XML inviati handling-submitted-xml-data

Quando i dati del modulo vengono inviati come XML, è possibile recuperare i dati XML che rappresentano i dati inviati. Tutti i campi modulo vengono visualizzati come nodi in uno schema XML. I valori del nodo corrispondono ai valori inseriti dall'utente. Considerare un modulo prestito in cui ogni campo del modulo viene visualizzato come un nodo all'interno dei dati XML. Il valore di ciascun nodo corrisponde al valore inserito da un utente. Supponiamo che un utente riempia il modulo del prestito con i dati mostrati nel seguente modulo.

hs_hs_loanformdata

Nella figura seguente vengono illustrati i dati XML corrispondenti recuperati mediante l'API client del servizio Forms.

hs_loandata

I campi nel modulo del prestito. Questi valori possono essere recuperati
utilizzo delle classi XML Java.

NOTE

La struttura del modulo deve essere configurata correttamente in Designer affinché i dati vengano inviati come dati XML. Per configurare correttamente la struttura del modulo per l'invio di dati XML, verificare che il pulsante Invia disponibile nella struttura del modulo sia impostato per l'invio di dati XML. Per informazioni sull'impostazione del pulsante Invia per inviare dati XML, vedere AEM Forms Designer.

Gestione dei dati PDF inviati handling-submitted-pdf-data

Considera un’applicazione web che richiama il servizio Forms. Dopo che il servizio Forms esegue il rendering di un modulo interattivo PDF in un browser Web client, l'utente compila il modulo e lo invia nuovamente come dati PDF. Quando il servizio Forms riceve i dati PDF PDF, può inviarli a un altro servizio o salvarli come file PDF. Il diagramma seguente mostra il flusso logico dell’applicazione.

hs_hs_savingforms

Nella tabella seguente vengono descritti i passaggi del diagramma.

Passaggio

Descrizione

Una pagina web contiene un collegamento che accede a un servlet Java che richiama il servizio Forms.

Il servizio Forms esegue il rendering di un modulo PDF interattivo nel browser Web client.

L’utente compila un modulo interattivo e fa clic su un pulsante di invio. Il modulo viene inviato nuovamente al servizio Forms come dati PDF. Questa opzione è impostata in Designer.

Il servizio Forms salva i dati PDF come file PDF.

Gestione dei dati URL UTF-16 inviati handling-submitted-url-utf-16-data

Se i dati del modulo vengono inviati come dati URL UTF-16, il computer client richiede Adobe Reader o Acrobat 8.1 o versione successiva. Inoltre, se la progettazione del modulo contiene un pulsante di invio con dati codificati in URL (HTTP Post) e l’opzione di codifica dei dati è UTF-16, la progettazione del modulo deve essere modificata in un editor di testo come Blocco note. È possibile impostare l'opzione di codifica su UTF-16LE o UTF-16BE per il pulsante di invio. Designer non fornisce questa funzionalità.

NOTE

Per ulteriori informazioni sul servizio Forms, vedere Riferimento ai servizi per AEM Forms.

Riepilogo dei passaggi summary-of-steps

Per gestire i moduli inviati, eseguire le operazioni seguenti:

Includi file di progetto.
Crea un oggetto API client di Forms.
Recuperare i dati del modulo.
Determinare se l'invio del modulo contiene file allegati.
Elabora i dati inviati.

Includi file di progetto

Includi i file necessari nel progetto di sviluppo. Se stai creando un’applicazione client utilizzando Java, includi i file JAR necessari. Se utilizzi i servizi web, accertati di includere i file proxy.

Creare un oggetto API client di Forms

Prima di poter eseguire a livello di programmazione un'operazione API client del servizio Forms, è necessario creare un client del servizio Forms. Se si utilizza l'API Java, creare un oggetto FormsServiceClient. Se si utilizza l'API del servizio Web Forms, creare un oggetto FormsService.

Recupera dati modulo

Per recuperare i dati del modulo inviati, è necessario richiamare il metodo processFormSubmission dell'oggetto FormsServiceClient. Quando si richiama questo metodo, è necessario specificare il tipo di contenuto del modulo inviato. Quando i dati vengono inviati da un browser Web client al servizio Forms, possono essere inviati come dati XML o PDF. Per recuperare i dati immessi nei campi modulo, è possibile inviare i dati come dati XML.

È inoltre possibile recuperare i campi modulo da un modulo inviato come dati PDF impostando le seguenti opzioni di runtime:

Passare il seguente valore al metodo processFormSubmission come parametro del tipo di contenuto: CONTENT_TYPE=application/pdf.
Imposta il valore PDFToXDP dell'oggetto RenderOptionsSpec su true
Imposta il valore ExportDataFormat dell'oggetto RenderOptionsSpec su XMLData

Specificare il tipo di contenuto del modulo inviato quando si richiama il metodo processFormSubmission. L'elenco seguente specifica i valori dei tipi di contenuto applicabili:

text/xml: rappresenta il tipo di contenuto da utilizzare quando un modulo di PDF invia i dati del modulo come XML.
application/x-www-form-urlencoded: rappresenta il tipo di contenuto da utilizzare quando un modulo HTML invia dati come XML.
application/pdf: rappresenta il tipo di contenuto da utilizzare quando un modulo di PDF invia dati come PDF.

NOTE

Nella sezione Gestione degli invii di Forms sono disponibili tre avvii rapidi corrispondenti. La sezione Gestione dei PDF forms inviati come PDF con la Guida introduttiva all’API Java illustra come gestire i dati PDF inviati. Il tipo di contenuto specificato in questo avvio rapido è application/pdf. La sezione Gestione dei PDF forms inviati come XML mediante l'avvio rapido API Java illustra come gestire i dati XML inviati da un modulo PDF. Il tipo di contenuto specificato in questo avvio rapido è text/xml. Analogamente, la gestione dei moduli HTML inviati come XML mediante l'avvio rapido API Java illustra come gestire i dati XML inviati da un modulo HTML. Il tipo di contenuto specificato in questo avvio rapido è application/x-www-form-urlencoded.

Recuperi i dati del modulo pubblicati nel servizio Forms e ne determini lo stato di elaborazione. In altre parole, quando i dati vengono inviati al servizio Forms, non significa necessariamente che il servizio Forms abbia terminato l’elaborazione dei dati e che i dati siano pronti per essere elaborati. Ad esempio, i dati possono essere inviati al servizio Forms in modo da poter eseguire un calcolo. Una volta completato il calcolo, il modulo viene riprodotto all’utente con i risultati del calcolo visualizzati. Prima di elaborare i dati inviati, è consigliabile determinare se il servizio Forms ha completato l'elaborazione dei dati.

Il servizio Forms restituisce i seguenti valori per indicare se ha completato l’elaborazione dei dati:

0 (invio): I dati inviati sono pronti per l'elaborazione.
1 (calcolo): Il servizio Forms ha eseguito un'operazione di calcolo sui dati e i risultati devono essere restituiti all'utente.
2 (Convalida): I dati del modulo convalidati dal servizio Forms e i risultati devono essere restituiti all'utente.
3 (successivo): La pagina corrente è stata modificata con risultati che devono essere scritti nell'applicazione client.
4 (Precedente): la pagina corrente è cambiata con risultati che devono essere scritti nell'applicazione client.

NOTE

È necessario restituire all’utente i calcoli e le convalide. (Vedi Calcolo dei dati del modulo.

Determinare se l'invio del modulo contiene file allegati

Forms inviato al servizio Forms può contenere allegati. Ad esempio, utilizzando il riquadro degli allegati integrato di Acrobat, un utente può selezionare i file allegati da inviare insieme al modulo. L’utente può inoltre selezionare i file allegati utilizzando una barra degli strumenti di HTML sottoposta a rendering con un file di HTML.

Dopo aver determinato se un modulo contiene file allegati, è possibile elaborare i dati. È ad esempio possibile salvare l'allegato nel file system locale.

NOTE

Il modulo deve essere inviato come dati PDF per recuperare gli allegati. Se il modulo viene inviato come dati XML, gli allegati non vengono inviati.

Elabora i dati inviati

A seconda del tipo di contenuto dei dati inviati, è possibile estrarre singoli valori dei campi modulo dai dati XML inviati oppure salvare i dati PDF inviati come file PDF (o inviarli a un altro servizio). Per estrarre singoli campi modulo, convertire i dati XML inviati in un'origine dati XML e quindi recuperare i valori dell'origine dati XML utilizzando le classi org.w3c.dom.

Consulta anche

Inclusione dei file della libreria Java di AEM Forms

Impostazione delle proprietà di connessione

Guida introduttiva all’API di servizio Forms

Trasmissione di documenti al servizio Forms

Creazione di applicazioni Web per il rendering di Forms

Gestire i moduli inviati tramite l’API Java handle-submitted-forms-using-the-java-api

Gestisci un modulo inviato utilizzando l’API Forms (Java):

Includi file di progetto

Includi i file JAR client, ad esempio adobe-forms-client.jar, nel percorso di classe del progetto Java.
Creare un oggetto API client di Forms
- Creare un oggetto ServiceClientFactory contenente le proprietà di connessione.
- Creare un oggetto FormsServiceClient utilizzando il relativo costruttore e passando l'oggetto ServiceClientFactory.

Recupera dati modulo

Per recuperare i dati del modulo inviati a un servlet Java, creare un oggetto com.adobe.idp.Document utilizzando il relativo costruttore e richiamando il metodo getInputStream dell'oggetto javax.servlet.http.HttpServletResponse dal costruttore.
Creare un oggetto RenderOptionsSpec utilizzando il relativo costruttore. Impostare il valore delle impostazioni locali richiamando il metodo setLocale dell'oggetto RenderOptionsSpec e passando un valore stringa che specifica il valore delle impostazioni locali.

note note

NOTE

È possibile indicare al servizio Forms di creare dati XDP o XML dal contenuto PDF inviato richiamando il metodo setPDF2XDP dell'oggetto RenderOptionsSpec e passando true, chiamando anche setXMLData e passando true. È quindi possibile richiamare il metodo getOutputXML dell'oggetto FormsResult per recuperare i dati XML corrispondenti ai dati XDP/XML. (L'oggetto FormsResult viene restituito dal metodo processFormSubmission, illustrato nel passaggio successivo).

Richiama il metodo processFormSubmission dell'oggetto FormsServiceClient e passa i seguenti valori:
- Oggetto com.adobe.idp.Document contenente i dati del modulo.
- Valore stringa che specifica le variabili di ambiente, incluse tutte le intestazioni HTTP rilevanti. Specifica il tipo di contenuto da gestire. Per gestire i dati XML, specificare il valore stringa seguente per il parametro: CONTENT_TYPE=text/xml. Per gestire i dati di PDF, specificare il seguente valore stringa per questo parametro: CONTENT_TYPE=application/pdf.
- Valore stringa che specifica il valore di intestazione HTTP_USER_AGENT, ad esempio. Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1; SV1; .NET CLR 1.1.4322). Il valore di questo parametro è facoltativo.
- Un oggetto RenderOptionsSpec che memorizza le opzioni di runtime.
Il metodo processFormSubmission restituisce un oggetto FormsResult contenente i risultati dell'invio del modulo.
Determinare se il servizio Forms ha terminato l'elaborazione dei dati del modulo richiamando il metodo getAction dell'oggetto FormsResult. Se questo metodo restituisce il valore 0, i dati sono pronti per essere elaborati.

Determinare se l'invio del modulo contiene allegati

Richiama il metodo getAttachments dell'oggetto FormsResult. Questo metodo restituisce un oggetto java.util.List contenente i file inviati con il modulo.
Scorrere l'oggetto java.util.List per determinare se sono presenti allegati. Se sono presenti file allegati, ogni elemento è un'istanza com.adobe.idp.Document. È possibile salvare i file allegati richiamando il metodo copyToFile dell'oggetto com.adobe.idp.Document e passando un oggetto java.io.File.

note note
NOTE
Questo passaggio è applicabile solo se il modulo viene inviato come PDF.

Elabora i dati inviati
- Se il tipo di contenuto dei dati è application/vnd.adobe.xdp+xml o text/xml, creare una logica dell'applicazione per recuperare i valori dei dati XML.
  - Creare un oggetto com.adobe.idp.Document richiamando il metodo getOutputContent dell'oggetto FormsResult.
  - Creare un oggetto java.io.InputStream richiamando il costruttore java.io.DataInputStream e passando l'oggetto com.adobe.idp.Document.
  - Creare un oggetto org.w3c.dom.DocumentBuilderFactory chiamando il metodo newInstance dell'oggetto org.w3c.dom.DocumentBuilderFactory statico.
  - Creare un oggetto org.w3c.dom.DocumentBuilder richiamando il metodo newDocumentBuilder dell'oggetto org.w3c.dom.DocumentBuilderFactory.
  - Creare un oggetto org.w3c.dom.Document richiamando il metodo parse dell'oggetto org.w3c.dom.DocumentBuilder e passando l'oggetto java.io.InputStream.
  - Recuperate il valore di ciascun nodo all'interno del documento XML. Un modo per eseguire questa attività consiste nel creare un metodo personalizzato che accetti due parametri: l'oggetto org.w3c.dom.Document e il nome del nodo di cui si desidera recuperare il valore. Questo metodo restituisce un valore stringa che rappresenta il valore del nodo. Nell'esempio di codice che segue questo processo, il metodo personalizzato è denominato getNodeText. Viene visualizzato il corpo di questo metodo.
- Se il tipo di contenuto dei dati è application/pdf, creare la logica dell'applicazione per salvare i dati PDF inviati come file PDF.
  - Creare un oggetto com.adobe.idp.Document richiamando il metodo getOutputContent dell'oggetto FormsResult.
  - Creare un oggetto java.io.File utilizzando il relativo costruttore pubblico. Assicurati di specificare PDF come estensione del nome file.
  - Compilare il file PDF richiamando il metodo copyToFile dell'oggetto com.adobe.idp.Document e passando l'oggetto java.io.File.

Consulta anche

Quick Start (modalità SOAP): gestione dei PDF forms inviati come XML tramite API Java

Quick Start (modalità SOAP): gestione dei moduli HTML inviati come XML tramite l’API Java

Quick Start (modalità SOAP): gestione dei PDF forms inviati come PDF tramite l’API Java

Inclusione dei file della libreria Java di AEM Forms

Impostazione delle proprietà di connessione

Gestire i dati PDF inviati tramite l’API del servizio web handle-submitted-pdf-data-using-the-web-service-api

Gestisci un modulo inviato utilizzando l’API Forms (servizio web):

Includi file di progetto
- Creare classi proxy Java che utilizzano il servizio Forms WSDL.
- Includi le classi proxy Java nel percorso della classe.
Creare un oggetto API client di Forms

Creare un oggetto FormsService e impostare i valori di autenticazione.
Recupera dati modulo
- Per recuperare i dati del modulo inviati a un servlet Java, creare un oggetto BLOB utilizzando il relativo costruttore.
- Creare un oggetto java.io.InputStream richiamando il metodo getInputStream dell'oggetto javax.servlet.http.HttpServletResponse.
- Creare un oggetto java.io.ByteArrayOutputStream utilizzando il relativo costruttore e passando la lunghezza dell'oggetto java.io.InputStream.
- Copiare il contenuto dell'oggetto java.io.InputStream nell'oggetto java.io.ByteArrayOutputStream.
- Creare una matrice di byte richiamando il metodo toByteArray dell'oggetto java.io.ByteArrayOutputStream.
- Compilare l'oggetto BLOB richiamando il relativo metodo setBinaryData e passando la matrice di byte come argomento.
- Creare un oggetto RenderOptionsSpec utilizzando il relativo costruttore. Impostare il valore delle impostazioni locali richiamando il metodo setLocale dell'oggetto RenderOptionsSpec e passando un valore stringa che specifica il valore delle impostazioni locali.
- Richiama il metodo processFormSubmission dell'oggetto FormsService e passa i seguenti valori:
  - Oggetto BLOB contenente i dati del modulo.
  - Valore stringa che specifica le variabili di ambiente, incluse tutte le intestazioni HTTP rilevanti. Specifica il tipo di contenuto da gestire. Per gestire i dati XML, specificare il valore stringa seguente per il parametro: CONTENT_TYPE=text/xml. Per gestire i dati di PDF, specificare il seguente valore stringa per questo parametro: CONTENT_TYPE=application/pdf.
  - Valore stringa che specifica il valore dell'intestazione HTTP_USER_AGENT, ad esempio Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1; SV1; .NET CLR 1.1.4322).
  - Un oggetto RenderOptionsSpec che memorizza le opzioni di runtime.
  - Oggetto BLOBHolder vuoto popolato dal metodo.
  - Oggetto javax.xml.rpc.holders.StringHolder vuoto popolato dal metodo.
  - Oggetto BLOBHolder vuoto popolato dal metodo.
  - Oggetto BLOBHolder vuoto popolato dal metodo.
  - Oggetto javax.xml.rpc.holders.ShortHolder vuoto popolato dal metodo.
  - Oggetto MyArrayOf_xsd_anyTypeHolder vuoto popolato dal metodo. Questo parametro viene utilizzato per memorizzare gli allegati dei file inviati insieme al modulo.
  - Oggetto FormsResultHolder vuoto popolato dal metodo con il modulo inviato.
  Il metodo processFormSubmission compila il parametro FormsResultHolder con i risultati dell'invio del modulo.
- Determinare se il servizio Forms ha terminato l'elaborazione dei dati del modulo richiamando il metodo getAction dell'oggetto FormsResult. Se questo metodo restituisce il valore 0, i dati del modulo sono pronti per l'elaborazione. È possibile ottenere un oggetto FormsResult ottenendo il valore del membro dati value dell'oggetto FormsResultHolder.
Determinare se l'invio del modulo contiene allegati

Ottiene il valore del membro dati value dell'oggetto MyArrayOf_xsd_anyTypeHolder (l'oggetto MyArrayOf_xsd_anyTypeHolder è stato passato al metodo processFormSubmission). Questo membro dati restituisce un array di Objects. Ogni elemento all'interno dell'array Object è un Object che corrisponde ai file inviati insieme al modulo. È possibile ottenere ogni elemento all'interno dell'array e eseguirne il cast in un oggetto BLOB.
Elabora i dati inviati
- Se il tipo di contenuto dei dati è application/vnd.adobe.xdp+xml o text/xml, creare una logica dell'applicazione per recuperare i valori dei dati XML.
  - Creare un oggetto BLOB richiamando il metodo getOutputContent dell'oggetto FormsResult.
  - Creare una matrice di byte richiamando il metodo getBinaryData dell'oggetto BLOB.
  - Creare un oggetto java.io.InputStream richiamando il costruttore java.io.ByteArrayInputStream e passando la matrice di byte.
  - Creare un oggetto org.w3c.dom.DocumentBuilderFactory chiamando il metodo newInstance dell'oggetto org.w3c.dom.DocumentBuilderFactory statico.
  - Creare un oggetto org.w3c.dom.DocumentBuilder richiamando il metodo newDocumentBuilder dell'oggetto org.w3c.dom.DocumentBuilderFactory.
  - Creare un oggetto org.w3c.dom.Document richiamando il metodo parse dell'oggetto org.w3c.dom.DocumentBuilder e passando l'oggetto java.io.InputStream.
  - Recuperate il valore di ciascun nodo all'interno del documento XML. Un modo per eseguire questa attività consiste nel creare un metodo personalizzato che accetti due parametri: l'oggetto org.w3c.dom.Document e il nome del nodo di cui si desidera recuperare il valore. Questo metodo restituisce un valore stringa che rappresenta il valore del nodo. Nell'esempio di codice che segue questo processo, il metodo personalizzato è denominato getNodeText. Viene visualizzato il corpo di questo metodo.
- Se il tipo di contenuto dei dati è application/pdf, creare la logica dell'applicazione per salvare i dati PDF inviati come file PDF.
  - Creare un oggetto BLOB richiamando il metodo getOutputContent dell'oggetto FormsResult.
  - Creare una matrice di byte richiamando il metodo getBinaryData dell'oggetto BLOB.
  - Creare un oggetto java.io.File utilizzando il relativo costruttore pubblico. Assicurati di specificare PDF come estensione del nome file.
  - Creare un oggetto java.io.FileOutputStream utilizzando il relativo costruttore e passando l'oggetto java.io.File.
  - Compilare il file PDF richiamando il metodo write dell'oggetto java.io.FileOutputStream e passando la matrice di byte.

Consulta anche

Richiamare AEM Forms utilizzando la codifica Base64

recommendation-more-help

19ffd973-7af2-44d0-84b5-d547b0dffee2