Gestione di Forms inviati

Esempi ed esempi in questo documento sono solo per AEM Forms in ambiente JEE.

Per le applicazioni basate sul Web che consentono all’utente di compilare moduli interattivi è necessario che i dati vengano inviati nuovamente al server. Utilizzando il servizio Forms, è possibile recuperare i dati immessi dall’utente in un modulo interattivo. Dopo aver recuperato i dati, puoi elaborarli per soddisfare le tue esigenze aziendali. Ad esempio, è possibile memorizzare i dati in un database, inviare i dati a un’altra applicazione, inviare i dati a un altro servizio, unire i dati in una struttura del modulo, visualizzare i dati in un browser Web e così via.

I dati modulo vengono inviati al servizio Forms come dati XML o PDF, opzione impostata in Designer. Un modulo inviato come XML consente di estrarre singoli valori di dati di campo. In altre parole, è possibile estrarre il valore di ciascun campo modulo immesso dall’utente. Un modulo inviato come dati PDF è costituito da dati binari, non da dati XML. È possibile salvare il modulo come file PDF o inviarlo a un altro servizio. Se si desidera estrarre i dati da un modulo inviato come XML e quindi utilizzare i dati del modulo per creare un documento PDF, avviare un'altra operazione AEM Forms. (Vedere 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_handlesubmit

Nella tabella seguente sono descritti i passaggi del diagramma.

Incremento

Descrizione

1

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

2

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

3

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

Gestione dei dati XML inviati

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 dei nodi corrispondono ai valori inseriti dall'utente. Si consideri un modulo di prestito in cui ogni campo del modulo viene visualizzato come un nodo all’interno dei dati XML. Il valore di ogni nodo corrisponde al valore che un utente compila. Supponiamo che un utente compili il modulo di prestito con i dati mostrati nel seguente modulo.

hs_loanformdata

L’illustrazione seguente mostra i dati XML corrispondenti recuperati utilizzando l’API client del servizio Forms.

hs_loandata

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

NOTA

La struttura del modulo deve essere configurata correttamente in Designer per consentire l’invio dei dati come dati XML. Per configurare in modo appropriato la struttura del modulo per l’invio dei dati XML, assicurarsi che il pulsante Invia presente nella struttura del modulo sia impostato per l’invio dei dati XML. Per informazioni sull'impostazione del pulsante Invia per l'invio di dati XML, vedere AEM Forms Designer.

Gestione dei dati PDF inviati

Considera un'applicazione web che richiama il servizio Forms. Dopo che il servizio Forms esegue il rendering di un modulo PDF interattivo 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, può inviarli a un altro servizio o salvarli come file PDF. Il diagramma seguente mostra il flusso logico dell’applicazione.

hs_savingforms

La tabella seguente descrive i passaggi descritti in questo diagramma.

Incremento

Descrizione

3

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

2

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

3

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.

4

Il servizio Forms salva i dati PDF come file PDF.

Gestione dei dati UTF-16 dell'URL inviato

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. Anche se la struttura del modulo contiene un pulsante di invio con dati codificati tramite URL (HTTP Post) e l’opzione di codifica dei dati è UTF-16, la struttura 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à.

NOTA

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

Riepilogo dei passaggi

Per gestire i moduli inviati, eseguire le operazioni seguenti:

  1. Includi file di progetto.
  2. Creare un oggetto API client Forms.
  3. Recupera i dati del modulo.
  4. Determinare se l’invio del modulo contiene allegati di file.
  5. 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, assicurati di includere i file proxy.

Creare un oggetto API client Forms

Prima di poter eseguire programmaticamente un’operazione API client del servizio Forms, è necessario creare un client di servizio Forms. Se utilizzi l’API Java, crea un oggetto FormsServiceClient. Se utilizzi l’API del servizio Web Forms, crea un oggetto FormsService.

Recupera dati modulo

Per recuperare i dati del modulo inviati, è necessario richiamare il metodo FormsServiceClient dell’oggetto processFormSubmission. 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 esecuzione:

  • Passa 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

È possibile specificare il tipo di contenuto del modulo inviato quando si richiama il metodo processFormSubmission . Nell'elenco seguente sono specificati i valori del tipo di contenuto applicabili:

  • text/xml: Rappresenta il tipo di contenuto da utilizzare quando un modulo PDF invia 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 PDF invia dati come PDF.
NOTA

Noterai che sono presenti tre avvii rapidi corrispondenti associati alla sezione Gestione del Forms inviato . La guida rapida alla gestione dei PDF forms inviati come PDF tramite l’API Java illustra come gestire i dati PDF inviati. Il tipo di contenuto specificato in questo avvio rapido è application/pdf. Il rapido avvio di Gestione dei PDF forms inviati come XML tramite l’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, il rapido avvio della gestione dei moduli HTML inviati come XML tramite l’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 .

È possibile recuperare i dati del modulo inviati al servizio Forms e determinarne 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, viene eseguito il rendering del modulo all’utente con i risultati del calcolo visualizzati. Prima di elaborare i dati inviati, è consigliabile determinare se il servizio Forms ha terminato l’elaborazione dei dati.

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

  • 0 (Invia): i dati inviati sono pronti per essere elaborati.
  • 1 (Calculate): il servizio Forms ha eseguito un’operazione di calcolo sui dati e i risultati devono essere restituiti all’utente.
  • 2 (Convalida): il servizio Forms ha convalidato i dati del modulo e i risultati devono essere resi nuovamente all’utente.
  • 3 (Successivo): la pagina corrente è cambiata con i risultati che devono essere scritti nell'applicazione client.
  • 4 (Precedente): La pagina corrente è cambiata con risultati che devono essere scritti nell’applicazione client.
NOTA

È necessario eseguire nuovamente il rendering dei calcoli e delle convalide per l'utente. (Vedere Calcolo dei dati del modulo.

Determinare se l’invio del modulo contiene allegati di file

Forms inviato al servizio Forms può contenere allegati di file. Ad esempio, utilizzando il riquadro allegato integrato di Acrobat, un utente può selezionare file allegati da inviare insieme al modulo. Inoltre, un utente può anche selezionare file allegati utilizzando una barra degli strumenti HTML di cui viene eseguito il rendering con un file HTML.

Dopo aver determinato se un modulo contiene allegati ai file, è possibile elaborare i dati. Ad esempio, è possibile salvare l'allegato al file system locale.

NOTA

Per recuperare gli allegati ai file, è necessario inviare il modulo come dati PDF. Se il modulo viene inviato come dati XML, gli allegati di file non vengono inviati.

Elaborazione dei dati inviati

A seconda del tipo di contenuto dei dati inviati, è possibile estrarre singoli valori dei campi modulo dai dati XML inviati o salvare i dati PDF inviati come file PDF (o inviarli a un altro servizio). Per estrarre singoli campi del 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 libreria Java di AEM Forms

Impostazione delle proprietà di connessione

Avvio rapido API di Forms Service

Trasmissione di documenti al servizio Forms

Creazione di applicazioni Web per il rendering di Forms

Gestire i moduli inviati utilizzando l’API Java

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

  1. Includi file di progetto

    Includi file JAR client, come adobe-forms-client.jar, nel percorso di classe del progetto Java.

  2. Creare un oggetto API client Forms

    • Creare un oggetto ServiceClientFactory contenente le proprietà di connessione.
    • Creare un oggetto FormsServiceClient utilizzando il relativo costruttore e passando l'oggetto ServiceClientFactory.

  3. 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 richiamare il metodo javax.servlet.http.HttpServletResponse dell'oggetto getInputStream dall'interno del costruttore.
    • Creare un oggetto RenderOptionsSpec utilizzando il relativo costruttore. Impostare il valore delle impostazioni internazionali richiamando il metodo setLocale dell'oggetto RenderOptionsSpec e passando un valore di stringa che specifica il valore delle impostazioni internazionali.
    NOTA

    È possibile istruire il servizio Forms per creare dati XDP o XML dal contenuto PDF inviato richiamando il metodo setPDF2XDP dell’oggetto RenderOptionsSpec e passando true, richiamando setXMLData e passando true. È quindi possibile richiamare il metodo getOutputXML dell'oggetto FormsResult per recuperare i dati XML che corrispondono 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:

      • L'oggetto com.adobe.idp.Document che contiene i dati del modulo.
      • Valore stringa che specifica le variabili di ambiente, comprese tutte le intestazioni HTTP rilevanti. Specifica il tipo di contenuto da gestire. Per gestire i dati XML, specificare il seguente valore di stringa per questo parametro: CONTENT_TYPE=text/xml. Per gestire i dati 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). Questo valore del parametro è facoltativo.
      • Un oggetto RenderOptionsSpec che memorizza le opzioni di esecuzione.

      Il metodo processFormSubmission restituisce un oggetto FormsResult contenente i risultati dell'invio del modulo.

    • Determinare se il servizio Forms ha completato 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.

  4. Determinare se l’invio del modulo contiene allegati di file

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

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

  5. Elaborazione dei dati inviati

    • Se il tipo di contenuto dati è application/vnd.adobe.xdp+xml o text/xml, creare la logica dell'applicazione per recuperare i valori dei dati XML.

      • Creare un oggetto com.adobe.idp.Document richiamando il metodo FormsResult dell'oggetto getOutputContent.
      • 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 org.w3c.dom.DocumentBuilderFactory statico dell'oggetto newInstance.
      • Creare un oggetto org.w3c.dom.DocumentBuilder richiamando il metodo org.w3c.dom.DocumentBuilderFactory dell'oggetto newDocumentBuilder.
      • Creare un oggetto org.w3c.dom.Document richiamando il metodo org.w3c.dom.DocumentBuilder dell'oggetto parse e passando l'oggetto java.io.InputStream.
      • Recupera il valore di ogni nodo all'interno del documento XML. Un modo per eseguire questa attività consiste nel creare un metodo personalizzato che accetta 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, questo metodo personalizzato è denominato getNodeText. Viene mostrato il corpo di questo metodo.

    • Se il tipo di contenuto dei dati è application/pdf, creare una logica di applicazione per salvare i dati PDF inviati come file PDF.

      • Creare un oggetto com.adobe.idp.Document richiamando il metodo FormsResult dell'oggetto getOutputContent.
      • 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 java.io.File e passando l’oggetto com.adobe.idp.Document.

Consulta anche

Avvio rapido (modalità SOAP): Gestione dei PDF forms inviati come XML tramite l’API Java

Avvio rapido (modalità SOAP): Gestione dei moduli HTML inviati come XML tramite l’API Java

Avvio rapido (modalità SOAP): Gestione dei PDF forms inviati come PDF tramite l’API Java

Inclusione dei file libreria Java di AEM Forms

Impostazione delle proprietà di connessione

Gestire i dati PDF inviati utilizzando l'API del servizio Web

Gestire un modulo inviato utilizzando l’API Forms (servizio Web):

  1. Includi file di progetto

    • Creare classi proxy Java che utilizzano il servizio WSDL di Forms.
    • Includi le classi proxy Java nel percorso della classe.

  2. Creare un oggetto API client Forms

    Creare un oggetto FormsService e impostare i valori di autenticazione.

  3. 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 javax.servlet.http.HttpServletResponse dell'oggetto getInputStream.

    • 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 dei byte come argomento.

    • Creare un oggetto RenderOptionsSpec utilizzando il relativo costruttore. Impostare il valore delle impostazioni internazionali richiamando il metodo setLocale dell'oggetto RenderOptionsSpec e passando un valore di stringa che specifica il valore delle impostazioni internazionali.

    • Richiama il metodo processFormSubmission dell'oggetto FormsService e passa i seguenti valori:

      • L'oggetto BLOB che contiene i dati del modulo.
      • Valore stringa che specifica le variabili di ambiente, comprese tutte le intestazioni HTTP rilevanti. Specifica il tipo di contenuto da gestire. Per gestire i dati XML, specificare il seguente valore di stringa per questo parametro: CONTENT_TYPE=text/xml. Per gestire i dati 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).
      • Un oggetto RenderOptionsSpec che memorizza le opzioni di esecuzione.
      • Un oggetto BLOBHolder vuoto compilato dal metodo .
      • Un oggetto javax.xml.rpc.holders.StringHolder vuoto compilato dal metodo .
      • Un oggetto BLOBHolder vuoto compilato dal metodo .
      • Un oggetto BLOBHolder vuoto compilato dal metodo .
      • Un oggetto javax.xml.rpc.holders.ShortHolder vuoto compilato dal metodo .
      • Un oggetto MyArrayOf_xsd_anyTypeHolder vuoto compilato dal metodo . Questo parametro viene utilizzato per memorizzare gli allegati dei file inviati insieme al modulo.
      • Un oggetto FormsResultHolder vuoto compilato 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 completato 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 essere elaborati. È possibile ottenere un oggetto FormsResult ottenendo il valore del membro dati FormsResultHolder dell'oggetto value.

  4. Determinare se l’invio del modulo contiene allegati di file

    Ottenere 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 una matrice di Objects. Ogni elemento all’interno della matrice Object è un elemento Objectche corrisponde ai file inviati insieme al modulo. È possibile ottenere ogni elemento all’interno dell’array e inviarlo a un oggetto BLOB.

  5. Elaborazione dei dati inviati

    • Se il tipo di contenuto dati è application/vnd.adobe.xdp+xml o text/xml, creare la logica dell'applicazione per recuperare i valori dei dati XML.

      • Creare un oggetto BLOB richiamando il metodo FormsResult dell'oggetto getOutputContent.
      • 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 dei byte.
      • Creare un oggetto org.w3c.dom.DocumentBuilderFactory chiamando il metodo org.w3c.dom.DocumentBuilderFactory statico dell'oggetto newInstance.
      • Creare un oggetto org.w3c.dom.DocumentBuilder richiamando il metodo org.w3c.dom.DocumentBuilderFactory dell'oggetto newDocumentBuilder.
      • Creare un oggetto org.w3c.dom.Document richiamando il metodo org.w3c.dom.DocumentBuilder dell'oggetto parse e passando l'oggetto java.io.InputStream.
      • Recupera il valore di ogni nodo all'interno del documento XML. Un modo per eseguire questa attività consiste nel creare un metodo personalizzato che accetta 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, questo metodo personalizzato è denominato getNodeText. Viene mostrato il corpo di questo metodo.

    • Se il tipo di contenuto dei dati è application/pdf, creare una logica di applicazione per salvare i dati PDF inviati come file PDF.

      • Creare un oggetto BLOB richiamando il metodo FormsResult dell'oggetto getOutputContent.
      • 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 dei byte.

Consulta anche

Richiamo di AEM Forms con codifica Base64

In questa pagina