Precompilazione di Forms con layout fluibili

Ultimo aggiornamento: 2023-12-07
  • Creato per:
  • Developer

Precompilazione di Forms con layout fluibili

La precompilazione dei moduli consente di visualizzare i dati agli utenti all’interno di un modulo di cui è stato eseguito il rendering. Ad esempio, supponiamo che un utente acceda a un sito web con un nome utente e una password. Se l'autenticazione ha esito positivo, l'applicazione client esegue una query su un database per ottenere informazioni sull'utente. I dati vengono uniti nel modulo, quindi il modulo viene sottoposto a rendering per l’utente. L’utente può quindi visualizzare dati personalizzati all’interno del modulo.

La precompilazione di un modulo presenta i seguenti vantaggi:

  • Consente all'utente di visualizzare dati personalizzati in un modulo.
  • Riduce la quantità di digitazioni che l’utente compila per compilare un modulo.
  • Garantisce l’integrità dei dati controllando dove vengono inseriti i dati.

Un modulo può essere precompilato dalle due origini dati XML seguenti:

  • Un’origine dati XDP, XML conforme alla sintassi XFA (o dati XFDF per precompilare un modulo creato utilizzando Acrobat).
  • Origine dati XML arbitraria contenente coppie nome/valore corrispondenti ai nomi dei campi del modulo. Gli esempi in questa sezione utilizzano un'origine dati XML arbitraria.

È necessario che esista un elemento XML per ogni campo modulo che si desidera precompilare. Il nome dell'elemento XML deve corrispondere al nome del campo. Un elemento XML viene ignorato se non corrisponde a un campo modulo o se il nome dell'elemento XML non corrisponde al nome del campo. Non è necessario che corrispondano all'ordine di visualizzazione degli elementi XML, purché siano specificati tutti gli elementi XML.

Quando si precompila un modulo che contiene già dati, è necessario specificare i dati già visualizzati nell'origine dati XML. Si supponga che un modulo contenente 10 campi contenga dati in quattro campi. Quindi, si supponga di voler precompilare i sei campi rimanenti. In questa situazione è necessario specificare 10 elementi XML nell'origine dati XML utilizzata per precompilare il modulo. Se specifichi solo sei elementi, i quattro campi originali sono vuoti.

Ad esempio, puoi precompilare un modulo come il modulo di conferma di esempio. (Consulta "Modulo di conferma" in Rendering dei PDF forms interattivi.)

Per precompilare il modulo di conferma di esempio, è necessario creare un'origine dati XML contenente tre elementi XML corrispondenti ai tre campi del modulo. Questo modulo contiene i tre campi seguenti: FirstName, LastName, e Amount. Il primo passaggio consiste nel creare un'origine dati XML contenente elementi XML corrispondenti ai campi della struttura del modulo. Il passaggio successivo consiste nell'assegnare valori di dati agli elementi XML, come illustrato nel codice XML riportato di seguito.

     <Untitled>
         <FirstName>Jerry</FirstName>
         <LastName>Johnson</LastName>
         <Amount>250000</Amount>
     </Untitled>

Dopo aver precompilato il modulo di conferma con questa origine dati XML e aver eseguito il rendering del modulo, vengono visualizzati i valori dei dati assegnati agli elementi XML, come illustrato nel diagramma seguente.

pf_pf_confirmxml3

Precompilazione dei moduli con layout scorrevoli

I Forms con layout scorrevoli sono utili per mostrare agli utenti una quantità indeterminata di dati. Poiché il layout del modulo viene regolato automaticamente in base alla quantità di dati uniti, non è necessario predeterminare un layout fisso o un numero di pagine per il modulo, come invece è necessario fare con un modulo con un layout fisso.

Un modulo viene generalmente compilato con i dati ottenuti durante la fase di esecuzione. È quindi possibile precompilare un modulo creando un'origine dati XML in memoria e inserendo i dati direttamente nell'origine dati XML in memoria.

Considera un’applicazione basata su web, ad esempio un negozio online. Al termine dell'acquisto, tutti gli articoli acquistati vengono inseriti in un'origine dati XML in memoria utilizzata per precompilare un modulo. Il diagramma seguente illustra questo processo, illustrato nella tabella che segue il diagramma.

pf_pf_finsrv_webapp_v1

Nella tabella seguente vengono descritti i passaggi del diagramma.

Passaggio

Descrizione

1

Un utente acquista articoli da un negozio online basato su Web.

2

Al termine dell'acquisto degli elementi e dopo aver fatto clic sul pulsante Invia, viene creata un'origine dati XML in memoria. Gli articoli acquistati e le informazioni utente vengono inseriti nell'origine dati XML in memoria.

3

L'origine dati XML viene utilizzata per precompilare un modulo dell'ordine di acquisto (un esempio di questo modulo è riportato in questa tabella).

4

Il modulo dell’ordine di acquisto viene inviato al browser web client.

Nel diagramma seguente viene illustrato un esempio di modulo ordine fornitore. Le informazioni contenute nella tabella possono essere modificate in base al numero di record nei dati XML.

pf_pf_poform

NOTA

È possibile precompilare un modulo con dati provenienti da altre origini, ad esempio un database aziendale o applicazioni esterne.

Considerazioni sulla progettazione dei moduli

I Forms con layout scorrevoli si basano sulle progettazioni dei moduli create in Designer. La progettazione di un modulo specifica un set di regole di layout, presentazione e acquisizione dati, inclusi i valori di calcolo basati su input dell'utente. Le regole vengono applicate quando i dati vengono immessi in un modulo. I campi aggiunti a un modulo sono sottomaschere incluse nella struttura del modulo. Ad esempio, nel modulo ordine fornitore visualizzato nel diagramma precedente, ogni linea è una sottomaschera. Per informazioni sulla creazione di una struttura di modulo contenente sottomaschere, vedere Creazione di un modulo ordine fornitore con un layout scorrevole.

Informazioni sui sottogruppi di dati

Un'origine dati XML viene utilizzata per precompilare i moduli con layout fissi e con layout scorrevoli. Tuttavia, la differenza consiste nel fatto che un'origine dati XML che precompila un modulo con un layout scorrevole contiene elementi XML ripetuti utilizzati per precompilare sottomaschere ripetute all'interno del modulo. Questi elementi XML ripetuti sono denominati sottogruppi di dati.

Un'origine dati XML utilizzata per precompilare il modulo dell'ordine di acquisto mostrato nel diagramma precedente contiene quattro sottogruppi di dati ripetuti. Ogni sottogruppo di dati corrisponde a un articolo acquistato. Gli articoli acquistati sono un monitor, una lampada da tavolo, un telefono e una rubrica.

Per precompilare il modulo dell'ordine fornitore viene utilizzata la seguente origine dati XML.

     <header>
         <!-- XML elements used to prepopulate non-repeating fields such as address
         <!and city
         <txtPONum>8745236985</txtPONum>
         <dtmDate>2004-02-08</dtmDate>
         <txtOrderedByCompanyName>Any Company Name</txtOrderedByCompanyName>
         <txtOrderedByAddress>555, Any Blvd.</txtOrderedByAddress>
         <txtOrderedByCity>Any City</txtOrderedByCity>
         <txtOrderedByStateProv>ST</txtOrderedByStateProv>
         <txtOrderedByZipCode>12345</txtOrderedByZipCode>
         <txtOrderedByCountry>Any Country</txtOrderedByCountry>
         <txtOrderedByPhone>(123) 456-7890</txtOrderedByPhone>
         <txtOrderedByFax>(123) 456-7899</txtOrderedByFax>
         <txtOrderedByContactName>Contact Name</txtOrderedByContactName>
         <txtDeliverToCompanyName>Any Company Name</txtDeliverToCompanyName>
         <txtDeliverToAddress>7895, Any Street</txtDeliverToAddress>
         <txtDeliverToCity>Any City</txtDeliverToCity>
         <txtDeliverToStateProv>ST</txtDeliverToStateProv>
         <txtDeliverToZipCode>12346</txtDeliverToZipCode>
         <txtDeliverToCountry>Any Country</txtDeliverToCountry>
         <txtDeliverToPhone>(123) 456-7891</txtDeliverToPhone>
         <txtDeliverToFax>(123) 456-7899</txtDeliverToFax>
         <txtDeliverToContactName>Contact Name</txtDeliverToContactName>
     </header>
     <detail>
         <!-- A data subgroup that contains information about the monitor>
         <txtPartNum>00010-100</txtPartNum>
         <txtDescription>Monitor</txtDescription>
         <numQty>1</numQty>
         <numUnitPrice>350.00</numUnitPrice>
     </detail>
     <detail>
         <!-- A data subgroup that contains information about the desk lamp>
         <txtPartNum>00010-200</txtPartNum>
         <txtDescription>Desk lamps</txtDescription>
         <numQty>3</numQty>
         <numUnitPrice>55.00</numUnitPrice>
     </detail>
     <detail>
         <!-- A data subgroup that contains information about the Phone>
             <txtPartNum>00025-275</txtPartNum>
             <txtDescription>Phone</txtDescription>
             <numQty>5</numQty>
             <numUnitPrice>85.00</numUnitPrice>
     </detail>
     <detail>
         <!-- A data subgroup that contains information about the address book>
         <txtPartNum>00300-896</txtPartNum>
         <txtDescription>Address book</txtDescription>
         <numQty>2</numQty>
         <numUnitPrice>15.00</numUnitPrice>
     </detail>

Si noti che ogni sottogruppo di dati contiene quattro elementi XML corrispondenti a queste informazioni:

  • Numero parte articoli
  • Descrizione elementi
  • Quantità di articoli
  • Prezzo unitario

Il nome dell'elemento XML padre di un sottogruppo di dati deve corrispondere al nome del sottomodulo incluso nella struttura del modulo. Ad esempio, nel diagramma precedente, il nome dell'elemento XML padre del sottogruppo di dati è detail. Corrisponde al nome della sottomaschera presente nella struttura della maschera su cui si basa la maschera dell'ordine fornitore. Se il nome dell'elemento XML padre del sottogruppo di dati e il sottomodulo non corrispondono, un modulo lato server non viene precompilato.

Ogni sottogruppo di dati deve contenere elementi XML corrispondenti ai nomi dei campi nel sottomodulo. Il detail la sottomaschera nella struttura del modulo contiene i campi riportati di seguito.

  • txtPartNum
  • txtDescription
  • numQtà
  • numUnitPrice
NOTA

Se si tenta di precompilare un modulo con un'origine dati contenente elementi XML ripetuti e si imposta RenderAtClient opzione per No, nel modulo viene unito solo il primo record di dati. Per garantire che tutti i record di dati vengano uniti nel modulo, impostare RenderAtClient a Yes. Per informazioni su RenderAtClient , vedere Rendering di Forms nel client.

NOTA

Per ulteriori informazioni sul servizio Forms, consulta Guida di riferimento dei servizi per AEM Forms.

Riepilogo dei passaggi

Per precompilare un modulo con un layout scorrevole, effettuare le seguenti operazioni:

  1. Includi file di progetto.
  2. Creare un'origine dati XML in memoria.
  3. Convertire l'origine dati XML.
  4. Eseguire il rendering di un modulo precompilato.

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.

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'origine dati XML in memoria

È possibile utilizzare org.w3c.dom classi per creare un'origine dati XML in memoria per precompilare un modulo con un layout scorrevole. Inserire i dati in un'origine dati XML conforme al modulo. Per informazioni sulla relazione tra un modulo con un layout scorrevole e l'origine dati XML, vedere Informazioni sui sottogruppi di dati.

Convertire l'origine dati XML

Origine dati XML in memoria creata mediante org.w3c.dom le classi possono essere convertite in com.adobe.idp.Document oggetto prima che possa essere utilizzato per precompilare un modulo. Un'origine dati XML in memoria può essere convertita utilizzando le classi di trasformazione XML Java.

NOTA

Se si utilizza il file WSDL del servizio Forms per precompilare un modulo, è necessario convertire org.w3c.dom.Document oggetto in un BLOB oggetto.

Rendering di un modulo precompilato

Si esegue il rendering di un modulo precompilato come di un altro modulo. L'unica differenza è che si utilizza com.adobe.idp.Document oggetto contenente l'origine dati XML per precompilare il modulo.

Consulta anche

Inclusione dei file della libreria Java di AEM Forms

Impostazione delle proprietà di connessione

Guida introduttiva all’API di servizio Forms

Rendering dei PDF forms interattivi

Creazione di applicazioni Web per il rendering di Forms

Precompilazione dei moduli tramite API Java

Per precompilare un modulo con un layout scorrevole utilizzando l’API Forms (Java), effettua le seguenti operazioni:

  1. Includi file di progetto

    Includi i file JAR client, ad esempio adobe-forms-client.jar, nel percorso di classe del progetto Java. Per informazioni sulla posizione di questi file, vedere Inclusione dei file della libreria Java di AEM Forms.

  2. Creare un'origine dati XML in memoria

    • Creare un Java DocumentBuilderFactory oggetto chiamando il DocumentBuilderFactory class' newInstance metodo.

    • Creare un Java DocumentBuilder oggetto chiamando il DocumentBuilderFactory dell'oggetto newDocumentBuilder metodo.

    • Chiama il DocumentBuilder dell'oggetto newDocument metodo per creare un'istanza di org.w3c.dom.Document oggetto.

    • Creare l'elemento principale dell'origine dati XML richiamando org.w3c.dom.Document dell'oggetto createElement metodo. Questo crea un Element oggetto che rappresenta l'elemento principale. Passa un valore stringa che rappresenta il nome dell’elemento al createElement metodo. Invia il valore restituito a Element. Quindi, aggiungi l’elemento principale al documento chiamando il Document dell'oggetto appendChild e passare l'oggetto elemento radice come argomento. Le seguenti righe di codice mostrano questa logica dell’applicazione:

       Element root = (Element)document.createElement("transaction");  document.appendChild(root);

    • Creare l'elemento header dell'origine dati XML chiamando Document dell'oggetto createElement metodo. Passa un valore stringa che rappresenta il nome dell’elemento al createElement metodo. Invia il valore restituito a Element. Quindi, aggiungi l’elemento header all’elemento root chiamando il root dell'oggetto appendChild e passare l'oggetto elemento intestazione come argomento. Gli elementi XML accodati all'elemento header corrispondono alla parte statica del modulo. Le seguenti righe di codice mostrano questa logica dell’applicazione:

       Element header = (Element)document.createElement("header");  root.appendChild(header);

    • Creare un elemento figlio appartenente all’elemento intestazione chiamando il Document dell'oggetto createElement e passare un valore stringa che rappresenta il nome dell'elemento. Invia il valore restituito a Element. Quindi, imposta un valore per l’elemento figlio chiamando il relativo appendChild e trasmettere il Document dell'oggetto createTextNode come argomento. Specifica un valore stringa che viene visualizzato come valore dell'elemento figlio. Infine, aggiungi l’elemento figlio all’elemento intestazione chiamando l’elemento intestazione appendChild e passare l'oggetto elemento figlio come argomento. Le seguenti righe di codice mostrano questa logica dell’applicazione:

       Element poNum= (Element)document.createElement("txtPONum");  poNum.appendChild(document.createTextNode("8745236985"));  header.appendChild(LastName);

    • Aggiungere tutti gli elementi rimanenti all'elemento header ripetendo l'ultimo passaggio secondario per ogni campo visualizzato nella parte statica del modulo (nel diagramma dell'origine dati XML questi campi sono illustrati nella sezione A). Informazioni sui sottogruppi di dati.)

    • Creare l'elemento dettaglio dell'origine dati XML chiamando Document dell'oggetto createElement metodo. Passa un valore stringa che rappresenta il nome dell’elemento al createElement metodo. Invia il valore restituito a Element. Quindi, aggiungi l’elemento di dettaglio all’elemento principale chiamando il root dell'oggetto appendChild e passare l'oggetto elemento dettaglio come argomento. Gli elementi XML accodati all'elemento dettaglio corrispondono alla parte dinamica del modulo. Le seguenti righe di codice mostrano questa logica dell’applicazione:

       Element detail = (Element)document.createElement("detail");  root.appendChild(detail);

    • Creare un elemento figlio che appartiene all'elemento dettaglio chiamando Document dell'oggetto createElement e passare un valore stringa che rappresenta il nome dell'elemento. Invia il valore restituito a Element. Quindi, imposta un valore per l’elemento figlio chiamando il relativo appendChild e trasmettere il Document dell'oggetto createTextNode come argomento. Specifica un valore stringa che viene visualizzato come valore dell'elemento figlio. Infine, aggiungere l'elemento figlio all'elemento dettaglio chiamando l'elemento di dettaglio appendChild e passare l'oggetto elemento figlio come argomento. Le seguenti righe di codice mostrano questa logica dell’applicazione:

       Element txtPartNum = (Element)document.createElement("txtPartNum");  txtPartNum.appendChild(document.createTextNode("00010-100"));  detail.appendChild(txtPartNum);

    • Ripetere l'ultimo passaggio secondario per tutti gli elementi XML da aggiungere all'elemento dettaglio. Per creare correttamente l'origine dati XML utilizzata per compilare il modulo dell'ordine di acquisto, è necessario aggiungere i seguenti elementi XML all'elemento dettaglio: txtDescription, numQty, e numUnitPrice.

    • Ripeti gli ultimi due passaggi secondari per tutti gli elementi di dati utilizzati per precompilare il modulo.

  3. Convertire l'origine dati XML

    • Creare un javax.xml.transform.Transformer oggetto richiamando il javax.xml.transform.Transformer statico dell'oggetto newInstance metodo.
    • Creare un Transformer oggetto richiamando il TransformerFactory dell'oggetto newTransformer metodo.
    • Creare un ByteArrayOutputStream mediante il costruttore.
    • Creare un javax.xml.transform.dom.DOMSource mediante il costruttore e passando il org.w3c.dom.Document oggetto creato nel passaggio 1.
    • Creare un javax.xml.transform.dom.DOMSource mediante il costruttore e passando il ByteArrayOutputStream oggetto.
    • Popolare Java ByteArrayOutputStream oggetto richiamando il javax.xml.transform.Transformer dell'oggetto transform e passando il javax.xml.transform.dom.DOMSource e javax.xml.transform.stream.StreamResult oggetti.
    • Creare una matrice di byte e allocare le dimensioni della ByteArrayOutputStream alla matrice di byte.
    • Popolare la matrice di byte richiamando ByteArrayOutputStream dell'oggetto toByteArray metodo.
    • Creare un com.adobe.idp.Document mediante il costruttore e passando la matrice di byte.
  4. Rendering di un modulo precompilato

    Richiama FormsServiceClient dell'oggetto renderPDFForm e trasmettere i seguenti valori:

    • Valore stringa che specifica il nome della struttura del modulo, inclusa l'estensione del nome file.
    • A com.adobe.idp.Document oggetto contenente dati da unire con il modulo. Assicurati di utilizzare com.adobe.idp.Document oggetto creato nei passaggi uno e due.
    • A PDFFormRenderSpec oggetto che memorizza le opzioni di runtime.
    • A URLSpec oggetto contenente valori URI richiesti dal servizio Forms.
    • A java.util.HashMap oggetto che memorizza gli allegati. Questo è un parametro facoltativo e puoi specificare null se non si desidera allegare file al modulo.

    Il renderPDFForm il metodo restituisce un FormsResult oggetto contenente un flusso di dati modulo che deve essere scritto nel browser web client.

    • Creare un javax.servlet.ServletOutputStream oggetto utilizzato per inviare un flusso di dati modulo al browser web client.
    • Creare un com.adobe.idp.Document oggetto richiamando il FormsResult dell'oggetto getOutputContent metodo.
    • Creare un java.io.InputStream oggetto richiamando il com.adobe.idp.Document dell'oggetto getInputStream metodo.
    • Creare una matrice di byte compilarla con il flusso di dati del modulo richiamando InputStream dell'oggetto read e passando la matrice di byte come argomento.
    • Richiama javax.servlet.ServletOutputStream dell'oggetto write metodo per inviare il flusso di dati del modulo al browser web client. Passare la matrice di byte al write metodo.

Consulta anche

Quick Start (modalità SOAP): precompilazione di Forms con layout accessibili tramite l’API Java

Inclusione dei file della libreria Java di AEM Forms

Impostazione delle proprietà di connessione

Precompilazione dei moduli tramite l’API del servizio web

Per precompilare un modulo con un layout scorrevole utilizzando l’API di Forms (servizio web), effettua le seguenti operazioni:

  1. Includi file di progetto

  2. Creare un'origine dati XML in memoria

    • Creare un Java DocumentBuilderFactory oggetto chiamando il DocumentBuilderFactory class' newInstance metodo.

    • Creare un Java DocumentBuilder oggetto chiamando il DocumentBuilderFactory dell'oggetto newDocumentBuilder metodo.

    • Chiama il DocumentBuilder dell'oggetto newDocument metodo per creare un'istanza di org.w3c.dom.Document oggetto.

    • Creare l'elemento principale dell'origine dati XML richiamando org.w3c.dom.Document dell'oggetto createElement metodo. Questo crea un Element oggetto che rappresenta l'elemento principale. Passa un valore stringa che rappresenta il nome dell’elemento al createElement metodo. Invia il valore restituito a Element. Quindi, aggiungi l’elemento principale al documento chiamando il Document dell'oggetto appendChild e passare l'oggetto elemento radice come argomento. Le seguenti righe di codice mostrano questa logica dell’applicazione:

       Element root = (Element)document.createElement("transaction");  document.appendChild(root);

    • Creare l'elemento header dell'origine dati XML chiamando Document dell'oggetto createElement metodo. Passa un valore stringa che rappresenta il nome dell’elemento al createElement metodo. Invia il valore restituito a Element. Quindi, aggiungi l’elemento header all’elemento root chiamando il root dell'oggetto appendChild e passare l'oggetto elemento intestazione come argomento. Gli elementi XML accodati all'elemento header corrispondono alla parte statica del modulo. Le seguenti righe di codice mostrano questa logica dell’applicazione:

       Element header = (Element)document.createElement("header");  root.appendChild(header);

    • Creare un elemento figlio appartenente all’elemento intestazione chiamando il Document dell'oggetto createElement e passare un valore stringa che rappresenta il nome dell'elemento. Invia il valore restituito a Element. Quindi, imposta un valore per l’elemento figlio chiamando il relativo appendChild e trasmettere il Document dell'oggetto createTextNode come argomento. Specifica un valore stringa che viene visualizzato come valore dell'elemento figlio. Infine, aggiungi l’elemento figlio all’elemento intestazione chiamando l’elemento intestazione appendChild e passare l'oggetto elemento figlio come argomento. Le seguenti righe di codice mostrano questa logica dell’applicazione:

       Element poNum= (Element)document.createElement("txtPONum");  poNum.appendChild(document.createTextNode("8745236985"));  header.appendChild(LastName);

    • Aggiungere tutti gli elementi rimanenti all'elemento header ripetendo l'ultimo passaggio secondario per ogni campo visualizzato nella parte statica del modulo (nel diagramma dell'origine dati XML questi campi sono illustrati nella sezione A). Informazioni sui sottogruppi di dati.)

    • Creare l'elemento dettaglio dell'origine dati XML chiamando Document dell'oggetto createElement metodo. Passa un valore stringa che rappresenta il nome dell’elemento al createElement metodo. Invia il valore restituito a Element. Quindi, aggiungi l’elemento di dettaglio all’elemento principale chiamando il root dell'oggetto appendChild e passare l'oggetto elemento dettaglio come argomento. Gli elementi XML accodati all'elemento dettaglio corrispondono alla parte dinamica del modulo. Le seguenti righe di codice mostrano questa logica dell’applicazione:

       Element detail = (Element)document.createElement("detail");  root.appendChild(detail);

    • Creare un elemento figlio che appartiene all'elemento dettaglio chiamando Document dell'oggetto createElement e passare un valore stringa che rappresenta il nome dell'elemento. Invia il valore restituito a Element. Quindi, imposta un valore per l’elemento figlio chiamando il relativo appendChild e trasmettere il Document dell'oggetto createTextNode come argomento. Specifica un valore stringa che viene visualizzato come valore dell'elemento figlio. Infine, aggiungere l'elemento figlio all'elemento dettaglio chiamando l'elemento di dettaglio appendChild e passare l'oggetto elemento figlio come argomento. Le seguenti righe di codice mostrano questa logica dell’applicazione:

       Element txtPartNum = (Element)document.createElement("txtPartNum");  txtPartNum.appendChild(document.createTextNode("00010-100"));  detail.appendChild(txtPartNum);

    • Ripetere l'ultimo passaggio secondario per tutti gli elementi XML da aggiungere all'elemento dettaglio. Per creare correttamente l'origine dati XML utilizzata per compilare il modulo dell'ordine di acquisto, è necessario aggiungere i seguenti elementi XML all'elemento dettaglio: txtDescription, numQty, e numUnitPrice.

    • Ripeti gli ultimi due passaggi secondari per tutti gli elementi di dati utilizzati per precompilare il modulo.

  3. Convertire l'origine dati XML

    • Creare un javax.xml.transform.Transformer oggetto richiamando il javax.xml.transform.Transformer statico dell'oggetto newInstance metodo.
    • Creare un Transformer oggetto richiamando il TransformerFactory dell'oggetto newTransformer metodo.
    • Creare un ByteArrayOutputStream mediante il costruttore.
    • Creare un javax.xml.transform.dom.DOMSource mediante il costruttore e passando il org.w3c.dom.Document oggetto creato nel passaggio 1.
    • Creare un javax.xml.transform.dom.DOMSource mediante il costruttore e passando il ByteArrayOutputStream oggetto.
    • Popolare Java ByteArrayOutputStream oggetto richiamando il javax.xml.transform.Transformer dell'oggetto transform e passando il javax.xml.transform.dom.DOMSource e javax.xml.transform.stream.StreamResult oggetti.
    • Creare una matrice di byte e allocare le dimensioni della ByteArrayOutputStream alla matrice di byte.
    • Popolare la matrice di byte richiamando ByteArrayOutputStream dell'oggetto toByteArray metodo.
    • Creare un BLOB oggetto utilizzando il relativo costruttore e richiamando il relativo setBinaryData e passare la matrice di byte.
  4. Rendering di un modulo precompilato

    Richiama FormsService dell'oggetto renderPDFForm e trasmettere i seguenti valori:

    • Valore stringa che specifica il nome della struttura del modulo, inclusa l'estensione del nome file.
    • A BLOB oggetto contenente dati da unire con il modulo. Assicurati di utilizzare BLOB oggetto creato nei passaggi uno e due.
    • A PDFFormRenderSpecc oggetto che memorizza le opzioni di runtime. Per ulteriori informazioni, consulta Riferimento API di AEM Forms.
    • A URLSpec oggetto contenente valori URI richiesti dal servizio Forms.
    • A java.util.HashMap oggetto che memorizza gli allegati. Questo è un parametro facoltativo e puoi specificare null se non si desidera allegare file al modulo.
    • Un campo vuoto com.adobe.idp.services.holders.BLOBHolder oggetto popolato dal metodo. Viene utilizzato per memorizzare il modulo PDF di cui è stato eseguito il rendering.
    • Un campo vuoto javax.xml.rpc.holders.LongHolder oggetto popolato dal metodo. Questo argomento consente di memorizzare il numero di pagine nel modulo.
    • Un campo vuoto javax.xml.rpc.holders.StringHolder oggetto popolato dal metodo. Questo argomento consente di memorizzare il valore delle impostazioni locali.
    • Un campo vuoto com.adobe.idp.services.holders.FormsResultHolder oggetto che conterrà i risultati dell'operazione.

    Il renderPDFForm il metodo compila com.adobe.idp.services.holders.FormsResultHolder oggetto passato come ultimo valore di argomento con un flusso di dati del modulo che deve essere scritto nel browser web client.

    • Creare un FormResult dell'oggetto ottenendo il valore del com.adobe.idp.services.holders.FormsResultHolder dell'oggetto value membro dati.
    • Creare un BLOB oggetto che contiene i dati del modulo richiamando FormsResult dell'oggetto getOutputContent metodo.
    • Ottieni il tipo di contenuto del BLOB oggetto richiamando il relativo getContentType metodo.
    • Imposta il javax.servlet.http.HttpServletResponse tipo di contenuto dell'oggetto richiamando il relativo setContentType e passando il tipo di contenuto del BLOB oggetto.
    • Creare un javax.servlet.ServletOutputStream oggetto utilizzato per scrivere il flusso di dati del modulo nel browser web client richiamando javax.servlet.http.HttpServletResponse dell'oggetto getOutputStream metodo.
    • Creare una matrice di byte e popolarla richiamando il BLOB dell'oggetto getBinaryData metodo. Questa attività assegna il contenuto del FormsResult alla matrice di byte.
    • Richiama javax.servlet.http.HttpServletResponse dell'oggetto write metodo per inviare il flusso di dati del modulo al browser web client. Passare la matrice di byte al write metodo.
    NOTA

    Il renderPDFForm il metodo compila com.adobe.idp.services.holders.FormsResultHolder oggetto passato come ultimo valore di argomento con un flusso di dati del modulo che deve essere scritto nel browser web client.

Consulta anche

Richiamare AEM Forms utilizzando la codifica Base64

In questa pagina