Calcolo dati modulo

Ultimo aggiornamento: 14 luglio 2024

Si applica a:
Experience Manager 6.5

Argomenti:

Creato per:

Sviluppatore

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

Il servizio Forms può calcolare i valori immessi da un utente in un modulo e visualizzarne i risultati. Per calcolare i dati del modulo, è necessario eseguire due attività. Innanzitutto, è possibile creare uno script di progettazione del modulo che calcola i dati del modulo. La progettazione di un modulo supporta tre tipi di script. Un tipo di script viene eseguito sul client, un altro sul server e il terzo sul server e sul client. Il tipo di script descritto in questo argomento viene eseguito sul server. I calcoli lato server sono supportati per le trasformazioni HTML, PDF e guida ai moduli (obsolete).

Come parte del processo di progettazione del modulo, è possibile utilizzare calcoli e script per fornire un’esperienza utente più ricca. È possibile aggiungere calcoli e script alla maggior parte dei campi e degli oggetti del modulo. Creare uno script di progettazione del modulo per eseguire operazioni di calcolo sui dati immessi da un utente in un modulo interattivo.

L’utente immette i valori nel modulo e fa clic sul pulsante Calcola per visualizzare i risultati. Il processo seguente descrive un esempio di applicazione che consente a un utente di calcolare i dati:

L'utente accede a una pagina HTML denominata StartLoan.html che funge da pagina iniziale dell'applicazione Web. Questa pagina richiama un servlet Java denominato GetLoanForm.
Il servlet GetLoanForm esegue il rendering di un modulo di prestito. Questo modulo contiene uno script, campi interattivi, un pulsante di calcolo e un pulsante di invio.
L’utente immette i valori nei campi del modulo e fa clic sul pulsante Calcola. Il modulo viene inviato al servlet Java CalculateData in cui viene eseguito lo script. Il modulo viene inviato nuovamente all’utente con i risultati del calcolo visualizzati nel modulo.
L’utente continua a immettere e calcolare i valori fino a quando non viene visualizzato un risultato soddisfacente. Al termine dell’operazione, l’utente fa clic sul pulsante Invia per elaborare il modulo. Il modulo viene inviato a un altro servlet Java denominato ProcessForm responsabile del recupero dei dati inviati. (Vedi Gestione di Forms inviato.)

Il diagramma seguente mostra il flusso logico dell'applicazione.

cf_cf_finsrv_loancalcapp_v1

Nella tabella seguente vengono descritti i passaggi del diagramma.

Passaggio	Descrizione
1	Il servlet Java `GetLoanForm` viene richiamato dalla pagina iniziale di HTML.
2	Il servlet Java `GetLoanForm` utilizza l'API client del servizio Forms per eseguire il rendering del modulo di prestito al browser Web client. La differenza tra il rendering di un modulo che contiene uno script configurato per l'esecuzione sul server e il rendering di un modulo che non contiene uno script consiste nel fatto che è necessario specificare la posizione di destinazione utilizzata per eseguire lo script. Se non si specifica un percorso di destinazione, non viene eseguito uno script configurato per l'esecuzione sul server. Ad esempio, considera l’applicazione introdotta in questa sezione. Il servlet Java `CalculateData` è il percorso di destinazione in cui viene eseguito lo script.
3	L’utente immette i dati nei campi interattivi e fa clic sul pulsante Calcola. Il modulo viene inviato al servlet Java `CalculateData`, dove viene eseguito lo script.
4	Viene eseguito il rendering del modulo nel browser web con i risultati del calcolo visualizzati nel modulo.
5	Quando i valori sono soddisfacenti, l’utente fa clic sul pulsante Invia. Il modulo viene inviato a un altro servlet Java denominato `ProcessForm`.

In genere, un modulo inviato come contenuto PDF contiene script eseguiti sul client. Tuttavia, è anche possibile eseguire calcoli lato server. Impossibile utilizzare un pulsante Invia per calcolare gli script. In questa situazione, i calcoli non vengono eseguiti perché il servizio Forms considera l’interazione completa.

Per illustrare l'utilizzo di uno script di progettazione di un modulo, in questa sezione viene esaminato un semplice modulo interattivo contenente uno script configurato per l'esecuzione sul server. Nel diagramma seguente viene illustrata una struttura di modulo contenente uno script che consente di aggiungere valori immessi da un utente nei primi due campi e di visualizzare il risultato nel terzo campo.

cf_cf_caldata

A. Campo denominato NumericField1 B. Campo denominato NumericField2 C. Campo denominato NumericField3

La sintassi dello script in questa struttura di modulo è la seguente:

     NumericField3 = NumericField2 + NumericField1

In questa struttura di modulo il pulsante Calcola è un pulsante di comando e lo script si trova nell'evento Click del pulsante. Quando un utente immette valori nei primi due campi (NumericField1 e NumericField2) e fa clic sul pulsante Calcola, il modulo viene inviato al servizio Forms, dove viene eseguito lo script. Il servizio Forms restituisce il modulo al dispositivo client con i risultati del calcolo visualizzati nel campo NumericField3.

NOTA

Per informazioni sulla creazione di uno script di progettazione del modulo, vedere Forms Designer.

NOTA

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

Riepilogo dei passaggi

Per calcolare i dati del modulo, effettuare le seguenti operazioni:

Includi file di progetto.
Crea un oggetto API client di Forms.
Recuperare un modulo contenente uno script di calcolo.
Riscrivere il flusso di dati del modulo nel browser Web client

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

Recuperare un modulo contenente uno script di calcolo

Utilizzare l'API client del servizio Forms per creare una logica dell'applicazione che gestisce un modulo contenente uno script configurato per l'esecuzione sul server. Il processo è simile alla gestione di un modulo inviato. (Vedi Gestione di Forms inviato.)

Verificare che lo stato di elaborazione associato al modulo inviato sia 1 (Calculate). Il servizio Forms sta eseguendo un'operazione di calcolo sui dati del modulo e i risultati devono essere riscritti all'utente. In questa situazione, uno script configurato per l'esecuzione sul server viene eseguito automaticamente.

Riscrivere il flusso di dati del modulo nel browser Web client

Dopo aver verificato che lo stato di elaborazione associato a un modulo inviato è 1, è necessario riscrivere i risultati nel browser Web client. Quando viene visualizzato il modulo, il valore calcolato viene visualizzato nel campo o nei campi appropriati.

Consulta anche

Inclusione dei file della libreria Java di AEM Forms
Calcola i dati del modulo utilizzando l'API Java
Calcola i dati del modulo utilizzando l'API del servizio Web
Impostazione delle proprietà di connessione
Guida introduttiva all'API di servizio Forms
Rendering PDF forms interattivi
Creazione di applicazioni Web per il rendering di Forms

Calcolare i dati del modulo utilizzando l’API Java

Calcola i dati del modulo 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.
Recuperare un modulo contenente uno script di calcolo
- Per recuperare i dati del modulo che contengono uno script di calcolo, creare un oggetto com.adobe.idp.Document utilizzando il relativo costruttore e richiamando il metodo getInputStream dell'oggetto javax.servlet.http.HttpServletResponse dall'interno del costruttore.
- 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. Specificare il tipo di contenuto da gestire specificando uno o più valori per la variabile di ambiente CONTENT_TYPE. Per gestire i dati XML e PDF, ad esempio, specificare il seguente valore stringa per questo parametro: CONTENT_TYPE=application/xml&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.
  Il metodo processFormSubmission restituisce un oggetto FormsResult contenente i risultati dell'invio del modulo.
- Verificare che lo stato di elaborazione associato a un modulo inviato sia 1 richiamando il metodo getAction dell'oggetto FormsResult. Se questo metodo restituisce il valore 1, il calcolo è stato eseguito e i dati possono essere riscritti nel browser Web client.
Riscrivere il flusso di dati del modulo nel browser Web client
- Creare un oggetto javax.servlet.ServletOutputStream utilizzato per inviare un flusso di dati modulo al browser Web client.
- Creare un oggetto com.adobe.idp.Document richiamando il metodo getOutputContent dell'oggetto FormsResult.
- Creare un oggetto java.io.InputStream richiamando il metodo getInputStream dell'oggetto com.adobe.idp.Document.
- Creare una matrice di byte e popolarla con il flusso di dati del modulo richiamando il metodo read dell'oggetto InputStream e passando la matrice di byte come argomento.
- Richiama il metodo write dell'oggetto javax.servlet.ServletOutputStream per inviare il flusso di dati del modulo al browser Web client. Passare la matrice di byte al metodo write.

Consulta anche

Inclusione dei file della libreria Java di AEM Forms
Impostazione delle proprietà di connessione

Calcolare i dati del modulo utilizzando l’API del servizio web

Calcola i dati del modulo utilizzando l’API di 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.
Recuperare un modulo contenente uno script di calcolo
- 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 utilizzando 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 FormsServiceClient e passa i seguenti valori:
  - Oggetto BLOB contenente i dati del modulo.
  - Valore stringa che specifica che le variabili di ambiente includono tutte le intestazioni HTTP pertinenti. Ad esempio, è possibile specificare il seguente valore stringa: HTTP_REFERER=referrer&HTTP_CONNECTION=keep-alive&CONTENT_TYPE=application/xml
  - 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. Per ulteriori informazioni, .
  - 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. Il metodo processFormSubmission restituisce un oggetto FormsResult contenente i risultati dell'invio del modulo.
- Verificare che lo stato di elaborazione associato a un modulo inviato sia 1 richiamando il metodo getAction dell'oggetto FormsResult. Se questo metodo restituisce il valore 1, il calcolo è stato eseguito e i dati possono essere riscritti nel browser Web client.
Riscrivere il flusso di dati del modulo nel browser Web client
- Creare un oggetto javax.servlet.ServletOutputStream utilizzato per inviare un flusso di dati modulo al browser Web client.
- Creare un oggetto BLOB contenente dati del modulo richiamando il metodo getOutputContent dell'oggetto FormsResult.
- Creare una matrice di byte e popolarla richiamando il metodo getBinaryData dell'oggetto BLOB. Questa attività assegna il contenuto dell'oggetto FormsResult alla matrice di byte.
- Richiama il metodo write dell'oggetto javax.servlet.http.HttpServletResponse per inviare il flusso di dati del modulo al browser Web client. Passare la matrice di byte al metodo write.

Vedere anche
Richiamo di AEM Forms tramite la codifica Base64

recommendation-more-help