Gestione dei Forms inviati handling-submitted-forms
Gli esempi e gli esempi contenuti in questo documento sono solo per l’ambiente AEM Forms su 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, un'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. (vedere Creazione di documenti PDF con i 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.
Nella tabella seguente vengono illustrati i passaggi del diagramma.
HandleData
Java Servlet come dati XML.HandleData
Java Servlet 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.
Nella figura seguente vengono illustrati i dati XML corrispondenti recuperati mediante l'API client del servizio Forms.
I campi nel modulo del prestito. Questi valori possono essere recuperati utilizzando le classi XML Java.
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.
Nella tabella seguente vengono descritti i passaggi del diagramma.
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 Invia. La finestra di progettazione non fornisce questa funzionalità.
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 utilizzi l’API Java, crea un’ FormsServiceClient
oggetto. Se utilizzi l’API del servizio web Forms, crea un’ FormsService
oggetto.
Recupera dati modulo
Per recuperare i dati del modulo inviati, è necessario richiamare FormsServiceClient
dell'oggetto processFormSubmission
metodo. 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:
- Passa il seguente valore a
processFormSubmission
come parametro del tipo di contenuto:CONTENT_TYPE=application/pdf
. - Imposta il
RenderOptionsSpec
dell'oggettoPDFToXDP
valore pertrue
- Imposta il
RenderOptionsSpec
dell'oggettoExportDataFormat
valore perXMLData
È possibile specificare il tipo di contenuto del modulo inviato quando si richiama processFormSubmission
metodo. 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.
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 (Invia): I dati inviati sono pronti per l’elaborazione.
- 1 (Calcola): 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 è cambiata con risultati che devono essere scritti nell'applicazione client.
- 4 (precedente): la pagina corrente è cambiata con risultati che devono essere scritti nell'applicazione client.
Determinare se l'invio del modulo contiene 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.
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 org.w3c.dom
classi.
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
ServiceClientFactory
oggetto che contiene proprietà di connessione. - Creare un
FormsServiceClient
mediante il costruttore e passando ilServiceClientFactory
oggetto.
- Creare un
-
Recupera dati modulo
- Per recuperare i dati del modulo inviati a un servlet Java, crea un
com.adobe.idp.Document
mediante il costruttore e richiamando l'oggettojavax.servlet.http.HttpServletResponse
dell'oggettogetInputStream
metodo dall'interno del costruttore. - Creare un
RenderOptionsSpec
mediante il costruttore. Impostare il valore locale richiamandoRenderOptionsSpec
dell'oggettosetLocale
e passando un valore stringa che specifica il valore locale.
note note NOTE È possibile indicare al servizio Forms di creare dati XDP o XML dal contenuto PDF inviato richiamando il RenderOptionsSpec
dell'oggettosetPDF2XDP
metodo e passaggiotrue
e anche chiamandosetXMLData
e superamentotrue
. È quindi possibile richiamareFormsResult
dell'oggettogetOutputXML
per recuperare i dati XML corrispondenti ai dati XDP/XML. (IlFormsResult
l'oggetto viene restituito daprocessFormSubmission
che viene spiegato nel passaggio successivo.)-
Richiama
FormsServiceClient
dell'oggettoprocessFormSubmission
e trasmettere i seguenti valori:- Il
com.adobe.idp.Document
oggetto che contiene 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 questo parametro:
CONTENT_TYPE=text/xml
. Per gestire i dati di PDF, specifica il seguente valore stringa per questo parametro:CONTENT_TYPE=application/pdf
. - Un valore stringa che specifica il
HTTP_USER_AGENT
valore dell’intestazione, 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. - A
RenderOptionsSpec
oggetto che memorizza le opzioni di runtime.
Il
processFormSubmission
il metodo restituisce unFormsResult
oggetto contenente i risultati dell’invio del modulo. - Il
-
Determinare se il servizio Forms ha terminato l'elaborazione dei dati del modulo richiamando
FormsResult
dell'oggettogetAction
metodo. Se questo metodo restituisce il valore0
, i dati sono pronti per l’elaborazione.
- Per recuperare i dati del modulo inviati a un servlet Java, crea un
-
Determinare se l'invio del modulo contiene allegati
- Richiama
FormsResult
dell'oggettogetAttachments
metodo. Questo metodo restituisce unjava.util.List
oggetto contenente i file inviati con il modulo. - Effettua iterazione attraverso
java.util.List
per determinare se sono presenti allegati. Se sono presenti file allegati, ogni elemento è uncom.adobe.idp.Document
dell'istanza. È possibile salvare i file allegati richiamandocom.adobe.idp.Document
dell'oggettocopyToFile
e il passaggio di unjava.io.File
oggetto.
note note NOTE Questo passaggio è applicabile solo se il modulo viene inviato come PDF. - Richiama
-
Elabora i dati inviati
-
Se il tipo di contenuto dei dati è
application/vnd.adobe.xdp+xml
otext/xml
, crea una logica di applicazione per recuperare i valori dei dati XML.- Creare un
com.adobe.idp.Document
oggetto richiamando ilFormsResult
dell'oggettogetOutputContent
metodo. - Creare un
java.io.InputStream
oggetto richiamando iljava.io.DataInputStream
costruttore e passaggiocom.adobe.idp.Document
oggetto. - Creare un
org.w3c.dom.DocumentBuilderFactory
oggetto chiamando l'oggetto staticoorg.w3c.dom.DocumentBuilderFactory
dell'oggettonewInstance
metodo. - Creare un
org.w3c.dom.DocumentBuilder
oggetto richiamando ilorg.w3c.dom.DocumentBuilderFactory
dell'oggettonewDocumentBuilder
metodo. - Creare un
org.w3c.dom.Document
oggetto richiamando ilorg.w3c.dom.DocumentBuilder
dell'oggettoparse
e passando iljava.io.InputStream
oggetto. - 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:
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, questo metodo personalizzato viene chiamatogetNodeText
. Viene visualizzato il corpo di questo metodo.
- Creare un
-
Se il tipo di contenuto dei dati è
application/pdf
, crea una logica di applicazione per salvare i dati PDF inviati come file PDF.- Creare un
com.adobe.idp.Document
oggetto richiamando ilFormsResult
dell'oggettogetOutputContent
metodo. - Creare un
java.io.File
mediante il costruttore pubblico. Assicurati di specificare PDF come estensione del nome file. - Popola il file PDF richiamando
com.adobe.idp.Document
dell'oggettocopyToFile
e passando iljava.io.File
oggetto.
- Creare un
-
Consulta anche
Quick Start (modalità SOAP): gestione dei PDF forms inviati come XML tramite l’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
FormsService
e impostare i valori di autenticazione. -
Recupera dati modulo
-
Per recuperare i dati del modulo inviati a un servlet Java, crea un
BLOB
mediante il costruttore. -
Creare un
java.io.InputStream
oggetto richiamando iljavax.servlet.http.HttpServletResponse
dell'oggettogetInputStream
metodo. -
Creare un
java.io.ByteArrayOutputStream
dell'oggetto utilizzando il relativo costruttore e passando la lunghezza deljava.io.InputStream
oggetto. -
Copia il contenuto del
java.io.InputStream
oggetto injava.io.ByteArrayOutputStream
oggetto. -
Creare una matrice di byte richiamando
java.io.ByteArrayOutputStream
dell'oggettotoByteArray
metodo. -
Popolare il
BLOB
oggetto richiamando il relativosetBinaryData
e passando la matrice di byte come argomento. -
Creare un
RenderOptionsSpec
mediante il costruttore. Impostare il valore locale richiamandoRenderOptionsSpec
dell'oggettosetLocale
e passando un valore stringa che specifica il valore locale. -
Richiama
FormsService
dell'oggettoprocessFormSubmission
e trasmettere i seguenti valori:- Il
BLOB
oggetto che contiene 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 questo parametro:
CONTENT_TYPE=text/xml
. Per gestire i dati di PDF, specifica il seguente valore stringa per questo parametro:CONTENT_TYPE=application/pdf
. - Un valore stringa che specifica il
HTTP_USER_AGENT
valore intestazione; ad esempio,Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1; SV1; .NET CLR 1.1.4322)
. - A
RenderOptionsSpec
oggetto che memorizza le opzioni di runtime. - Un campo vuoto
BLOBHolder
oggetto popolato dal metodo. - Un campo vuoto
javax.xml.rpc.holders.StringHolder
oggetto popolato dal metodo. - Un campo vuoto
BLOBHolder
oggetto popolato dal metodo. - Un campo vuoto
BLOBHolder
oggetto popolato dal metodo. - Un campo vuoto
javax.xml.rpc.holders.ShortHolder
oggetto popolato dal metodo. - Un campo vuoto
MyArrayOf_xsd_anyTypeHolder
oggetto popolato dal metodo. Questo parametro viene utilizzato per memorizzare gli allegati dei file inviati insieme al modulo. - Un campo vuoto
FormsResultHolder
oggetto popolato dal metodo con il modulo inviato.
Il
processFormSubmission
il metodo compilaFormsResultHolder
con i risultati dell'invio del modulo. - Il
-
Determinare se il servizio Forms ha terminato l'elaborazione dei dati del modulo richiamando
FormsResult
dell'oggettogetAction
metodo. Se questo metodo restituisce il valore0
, i dati del modulo sono pronti per l’elaborazione. Puoi ottenere unFormsResult
dell'oggetto ottenendo il valore delFormsResultHolder
dell'oggettovalue
membro dati.
-
-
Determinare se l'invio del modulo contiene allegati
Ottieni il valore di
MyArrayOf_xsd_anyTypeHolder
dell'oggettovalue
membro dati (ilMyArrayOf_xsd_anyTypeHolder
l'oggetto è stato passato alprocessFormSubmission
metodo). Questo membro dati restituisce un array diObjects
. Ogni elemento all’interno delObject
array è unObject
che corrisponde ai file inviati insieme al modulo. È possibile ottenere ogni elemento all’interno dell’array ed eseguirne il cast in unBLOB
oggetto. -
Elabora i dati inviati
-
Se il tipo di contenuto dei dati è
application/vnd.adobe.xdp+xml
otext/xml
, crea una logica di applicazione per recuperare i valori dei dati XML.- Creare un
BLOB
oggetto richiamando ilFormsResult
dell'oggettogetOutputContent
metodo. - Creare una matrice di byte richiamando
BLOB
dell'oggettogetBinaryData
metodo. - Creare un
java.io.InputStream
oggetto richiamando iljava.io.ByteArrayInputStream
costruttore e il passaggio della matrice di byte. - Creare un
org.w3c.dom.DocumentBuilderFactory
oggetto chiamando l'oggetto staticoorg.w3c.dom.DocumentBuilderFactory
dell'oggettonewInstance
metodo. - Creare un
org.w3c.dom.DocumentBuilder
oggetto richiamando ilorg.w3c.dom.DocumentBuilderFactory
dell'oggettonewDocumentBuilder
metodo. - Creare un
org.w3c.dom.Document
oggetto richiamando ilorg.w3c.dom.DocumentBuilder
dell'oggettoparse
e passando iljava.io.InputStream
oggetto. - 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:
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, questo metodo personalizzato viene chiamatogetNodeText
. Viene visualizzato il corpo di questo metodo.
- Creare un
-
Se il tipo di contenuto dei dati è
application/pdf
, crea una logica di applicazione per salvare i dati PDF inviati come file PDF.- Creare un
BLOB
oggetto richiamando ilFormsResult
dell'oggettogetOutputContent
metodo. - Creare una matrice di byte richiamando
BLOB
dell'oggettogetBinaryData
metodo. - Creare un
java.io.File
mediante il costruttore pubblico. Assicurati di specificare PDF come estensione del nome file. - Creare un
java.io.FileOutputStream
mediante il costruttore e passando iljava.io.File
oggetto. - Popola il file PDF richiamando
java.io.FileOutputStream
dell'oggettowrite
e passando la matrice di byte.
- Creare un
-
Consulta anche
Richiamare AEM Forms utilizzando la codifica Base64