Calcolo dei dati del modulo

Esempi ed esempi 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 visualizzare i risultati. Per calcolare i dati del modulo, è necessario eseguire due attività. Innanzitutto, è necessario creare uno script della struttura del modulo che calcoli i dati del modulo. Una struttura del modulo supporta tre tipi di script. Un tipo di script viene eseguito sul client, un altro sul server e il terzo viene eseguito sia sul server che 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 Form Guide (obsoleto).

Come parte del processo di progettazione del modulo, è possibile utilizzare calcoli e script per migliorare l’esperienza utente. I calcoli e gli script possono essere aggiunti alla maggior parte dei campi e degli oggetti modulo. È necessario creare uno script della struttura del modulo per eseguire operazioni di calcolo sui dati immessi dall’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'applicazione di esempio 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.
  • La GetLoanForm servlet 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 valori nei campi del modulo e fa clic sul pulsante Calcola . Il modulo viene inviato al CalculateData Servlet Java in cui viene eseguito lo script. Il modulo viene inviato nuovamente all’utente con i risultati di calcolo visualizzati nel modulo.
  • L'utente continua a immettere e calcolare i valori finché non viene visualizzato un risultato soddisfacente. Una volta completato, 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 inviati.)

Il diagramma seguente mostra il flusso logico dell’applicazione.

cf_cf_finsrv_loancalcapp_v1

La tabella seguente descrive i passaggi descritti in questo diagramma.

Incremento

Descrizione

1

La GetLoanForm Java Servlet viene richiamato dalla pagina iniziale di HTML.

2

La GetLoanForm Java Servlet utilizza l’API client del servizio Forms per eseguire il rendering del modulo di prestito sul browser web del cliente. La differenza tra il rendering di un modulo contenente uno script configurato per l’esecuzione sul server e il rendering di un modulo che non contiene uno script è che è necessario specificare il percorso di destinazione utilizzato per eseguire lo script. Se non viene specificata una posizione di destinazione, non viene eseguito uno script configurato per l'esecuzione sul server. Ad esempio, considera l’applicazione introdotta in questa sezione. La CalculateData Java Servlet è la posizione di destinazione in cui viene eseguito lo script.

3

L’utente immette i dati in campi interattivi e fa clic sul pulsante Calcola . Il modulo viene inviato al CalculateData Servlet Java, in cui viene eseguito lo script.

4

Viene eseguito il rendering del modulo nel browser Web con i risultati di calcolo visualizzati nel modulo.

5

L’utente fa clic sul pulsante Invia quando i valori sono soddisfacenti. 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, è possibile eseguire anche calcoli sul lato server. Non è possibile 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 della struttura del modulo, in questa sezione viene esaminato un semplice modulo interattivo contenente uno script configurato per l’esecuzione sul server. Il diagramma seguente mostra una struttura del modulo contenente uno script che aggiunge valori immessi dall’utente nei primi due campi e visualizza il risultato nel terzo campo.

cf_cf_caldata

A. Un campo denominato NumericField1 B. Un campo denominato NumericField2 C. Un campo denominato NumericField3

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

     NumericField3 = NumericField2 + NumericField1

In questa struttura del modulo, il pulsante Calcola è un pulsante di comando e lo script si trova in questo pulsante Click evento. 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 esegue il rendering del modulo sul dispositivo client con i risultati del calcolo visualizzato nel campo NumericField3 .

NOTA

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

NOTA

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

Riepilogo dei passaggi

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

  1. Includi file di progetto.
  2. Creare un oggetto API client Forms.
  3. Recupera un modulo contenente uno script di calcolo.
  4. Riscrittura del 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, 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 FormsServiceClient oggetto. Se utilizzi l’API del servizio Web Forms, crea un FormsServiceService oggetto.

Recupera un modulo contenente uno script di calcolo

L’API client del servizio Forms consente di creare una logica applicativa 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 inviati.)

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

Riscrittura del flusso di dati del modulo nel browser Web client

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

Consulta anche

Inclusione dei file libreria Java di AEM Forms
Calcolare i dati del modulo utilizzando l’API Java
Calcolare i dati del modulo utilizzando l’API del servizio Web
Impostazione delle proprietà di connessione
Avvio rapido API di Forms Service
Rendering di 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):

  1. Includi file di progetto

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

  2. Creare un oggetto API client Forms

    • Crea un ServiceClientFactory oggetto contenente le proprietà di connessione.
    • Crea un FormsServiceClient utilizzando il relativo costruttore e passando ServiceClientFactory oggetto.
  3. Recupera un modulo contenente uno script di calcolo

    • Per recuperare i dati del modulo contenenti uno script di calcolo, creare un com.adobe.idp.Document utilizzando il relativo costruttore e richiamando il javax.servlet.http.HttpServletResponse dell’oggetto getInputStream dall'interno del costruttore.

    • Richiama il FormsServiceClient dell’oggetto processFormSubmission e passare i seguenti valori:

      • La com.adobe.idp.Document oggetto contenente i dati del modulo.
      • Valore stringa che specifica le variabili di ambiente, comprese tutte le intestazioni HTTP rilevanti. È necessario specificare il tipo di contenuto da gestire specificando uno o più valori per CONTENT_TYPE variabile di ambiente. Ad esempio, per gestire i dati XML e PDF, specificare il seguente valore stringa per questo parametro: CONTENT_TYPE=application/xml&CONTENT_TYPE=application/pdf
      • Un valore stringa che specifica la variabile HTTP_USER_AGENT valore di 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 esecuzione.

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

    • Verificare che lo stato di elaborazione associato a un modulo inviato sia 1 richiamando il FormsResult dell’oggetto getAction metodo . Se questo metodo restituisce il valore 1, il calcolo è stato eseguito e i dati possono essere riscritti nel browser Web client.

  4. Riscrittura del flusso di dati del modulo nel browser Web client

    • Crea un javax.servlet.ServletOutputStream oggetto utilizzato per inviare un flusso di dati del modulo al browser Web client.
    • Crea un com.adobe.idp.Document richiamando l'oggetto FormsResult oggetto ‘s getOutputContent metodo .
    • Crea un java.io.InputStream richiamando l'oggetto com.adobe.idp.Document dell’oggetto getInputStream metodo .
    • Creare un array di byte e compilarlo con il flusso di dati del modulo richiamando il InputStream dell’oggetto read e passare l'array di byte come argomento.
    • Richiama il javax.servlet.ServletOutputStream dell’oggetto write per inviare il flusso di dati del modulo al browser Web client. Passa l'array di byte al write metodo .

Consulta anche

Inclusione dei file 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 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

    Crea un FormsService e impostare i valori di autenticazione.

  3. Recupera un modulo contenente uno script di calcolo

    • Per recuperare i dati del modulo inviati a un servlet Java, crea un BLOB utilizzando il relativo costruttore.

    • Crea un java.io.InputStream utilizzando javax.servlet.http.HttpServletResponse dell’oggetto getInputStream metodo .

    • Crea un java.io.ByteArrayOutputStream utilizzando il relativo costruttore e passando la lunghezza del java.io.InputStream oggetto.

    • Copia il contenuto del java.io.InputStream nell'oggetto java.io.ByteArrayOutputStream oggetto.

    • Crea un array di byte richiamando il java.io.ByteArrayOutputStream dell’oggetto toByteArray metodo .

    • Popolare BLOB richiamandone l'oggetto setBinaryData e passare l'array di byte come argomento.

    • Crea un RenderOptionsSpec utilizzando il relativo costruttore. Imposta il valore delle impostazioni internazionali richiamando il RenderOptionsSpec dell’oggetto setLocale e passare un valore stringa che specifica il valore delle impostazioni internazionali.

    • Richiama il FormsServiceClient dell’oggetto processFormSubmission e passare i seguenti valori:

      • La BLOB oggetto contenente i dati del modulo.
      • Un valore stringa che specifica le variabili di ambiente include tutte le intestazioni HTTP pertinenti. Ad esempio, è possibile specificare il seguente valore stringa: HTTP_REFERER=referrer&HTTP_CONNECTION=keep-alive&CONTENT_TYPE=application/xml
      • Un valore stringa che specifica la variabile HTTP_USER_AGENT valore di 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 esecuzione. Per ulteriori informazioni, .
      • Un vuoto BLOBHolder oggetto popolato dal metodo .
      • Un vuoto javax.xml.rpc.holders.StringHolder oggetto popolato dal metodo .
      • Un vuoto BLOBHolder oggetto popolato dal metodo .
      • Un vuoto BLOBHolder oggetto popolato dal metodo .
      • Un vuoto javax.xml.rpc.holders.ShortHolder oggetto popolato dal metodo .
      • Un vuoto MyArrayOf_xsd_anyTypeHolder oggetto popolato dal metodo . Questo parametro viene utilizzato per memorizzare gli allegati dei file inviati insieme al modulo.
      • Un vuoto FormsResultHolder oggetto compilato dal metodo con il modulo inviato.

      La processFormSubmission popola il FormsResultHolder con i risultati dell’invio del modulo. La processFormSubmission restituisce un FormsResult oggetto contenente i risultati dell'invio del modulo.

    • Verificare che lo stato di elaborazione associato a un modulo inviato sia 1 richiamando il FormsResult dell’oggetto getAction metodo . Se questo metodo restituisce il valore 1, il calcolo è stato eseguito e i dati possono essere riscritti nel browser Web client.

  4. Riscrittura del flusso di dati del modulo nel browser Web client

    • Crea un javax.servlet.ServletOutputStream oggetto utilizzato per inviare un flusso di dati del modulo al browser Web client.
    • Crea un BLOB oggetto che contiene i dati del modulo richiamando il FormsResult dell’oggetto getOutputContent metodo .
    • Creare un array di byte e compilarlo richiamando il BLOB dell’oggetto getBinaryData metodo . Questa attività assegna il contenuto del FormsResult all'array di byte.
    • Richiama il javax.servlet.http.HttpServletResponse dell’oggetto write per inviare il flusso di dati del modulo al browser Web client. Passa l'array di byte al write metodo .

Vedi anche
Richiamo di AEM Forms con codifica Base64

In questa pagina