Precompilazione di Forms con layout fluidi prepopulating-forms-with-flowable-layouts1

Includi file di progetto

Includi file JAR client, come adobe-forms-client.jar, nel percorso di classe del progetto Java. Per informazioni sulla posizione di questi file, vedi Inclusione dei file libreria Java di AEM Forms.

Creare un’origine dati XML in memoria

• Creare un Java DocumentBuilderFactory chiamando DocumentBuilderFactory classe" newInstance metodo .

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

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

• Crea l’elemento principale dell’origine dati XML richiamando il 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 . Imposta il valore restituito su Element. Quindi, aggiungi l'elemento principale al documento chiamando il Document dell’oggetto appendChild e passare l'oggetto elemento principale come argomento. Le seguenti righe di codice mostrano questa logica di applicazione:

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

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

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

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

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

• Aggiungi tutti gli elementi rimanenti all’elemento intestazione ripetendo l’ultimo passaggio secondario per ciascun campo visualizzato nella parte statica del modulo (nel diagramma dell’origine dati XML, questi campi sono visualizzati nella sezione A. (Vedere Informazioni sui sottogruppi di dati.)

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

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

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

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

• Ripeti l’ultimo passaggio secondario affinché tutti gli elementi XML vengano aggiunti 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, numQtye numUnitPrice.

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

Convertire l’origine dati XML

• Crea un javax.xml.transform.Transformer richiamando l'oggetto javax.xml.transform.Transformer statico dell’oggetto newInstance metodo .
• Crea un Transformer richiamando l'oggetto TransformerFactory dell’oggetto newTransformer metodo .
• Crea un ByteArrayOutputStream utilizzando il relativo costruttore.
• Crea un javax.xml.transform.dom.DOMSource utilizzando il relativo costruttore e passando org.w3c.dom.Document oggetto creato al passaggio 1.
• Crea un javax.xml.transform.dom.DOMSource utilizzando il relativo costruttore e passando ByteArrayOutputStream oggetto.
• Popolare Java ByteArrayOutputStream richiamando l'oggetto javax.xml.transform.Transformer dell’oggetto transform e passare javax.xml.transform.dom.DOMSource e javax.xml.transform.stream.StreamResult oggetti.
• Creare un array di byte e allocare le dimensioni del ByteArrayOutputStream all'array di byte.
• Compilare l’array di byte richiamando il ByteArrayOutputStream dell’oggetto toByteArray metodo .
• Crea un com.adobe.idp.Document utilizzando il relativo costruttore e passando l'array di byte.

Rendering di un modulo precompilato

Richiama il FormsServiceClient dell’oggetto renderPDFForm e passare 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 i dati da unire al modulo. Assicurati di utilizzare com.adobe.idp.Document oggetto creato nei passaggi uno e due.
• A PDFFormRenderSpec oggetto che memorizza le opzioni di esecuzione.
• A URLSpec oggetto che contiene i valori URI richiesti dal servizio Forms.
• A java.util.HashMap oggetto che memorizza gli allegati di file. Si tratta di un parametro facoltativo ed è possibile specificare null se non si desidera allegare file al modulo.

La renderPDFForm restituisce un FormsResult oggetto che contiene un flusso di dati del modulo che deve essere scritto 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 popolarlo 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 .

Includi file di progetto

• Creare classi proxy Java che utilizzano il servizio WSDL di Forms. (Vedi Creazione di classi proxy Java utilizzando Apache Axis.)
• Includi le classi proxy Java nel percorso della classe.

Creare un’origine dati XML in memoria

• Creare un Java DocumentBuilderFactory chiamando DocumentBuilderFactory classe" newInstance metodo .

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

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

• Crea l’elemento principale dell’origine dati XML richiamando il 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 . Imposta il valore restituito su Element. Quindi, aggiungi l'elemento principale al documento chiamando il Document dell’oggetto appendChild e passare l'oggetto elemento principale come argomento. Le seguenti righe di codice mostrano questa logica di applicazione:

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

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

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

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

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

• Aggiungi tutti gli elementi rimanenti all’elemento intestazione ripetendo l’ultimo passaggio secondario per ciascun campo visualizzato nella parte statica del modulo (nel diagramma dell’origine dati XML, questi campi sono visualizzati nella sezione A. (Vedere Informazioni sui sottogruppi di dati.)

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

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

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

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

• Ripeti l’ultimo passaggio secondario affinché tutti gli elementi XML vengano aggiunti 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, numQtye numUnitPrice.

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

Convertire l’origine dati XML

• Crea un javax.xml.transform.Transformer richiamando l'oggetto javax.xml.transform.Transformer statico dell’oggetto newInstance metodo .
• Crea un Transformer richiamando l'oggetto TransformerFactory dell’oggetto newTransformer metodo .
• Crea un ByteArrayOutputStream utilizzando il relativo costruttore.
• Crea un javax.xml.transform.dom.DOMSource utilizzando il relativo costruttore e passando org.w3c.dom.Document oggetto creato al passaggio 1.
• Crea un javax.xml.transform.dom.DOMSource utilizzando il relativo costruttore e passando ByteArrayOutputStream oggetto.
• Popolare Java ByteArrayOutputStream richiamando l'oggetto javax.xml.transform.Transformer dell’oggetto transform e passare javax.xml.transform.dom.DOMSource e javax.xml.transform.stream.StreamResult oggetti.
• Creare un array di byte e allocare le dimensioni del ByteArrayOutputStream all'array di byte.
• Compilare l’array di byte richiamando il ByteArrayOutputStream dell’oggetto toByteArray metodo .
• Crea un BLOB utilizzando il relativo costruttore e richiamandone il setBinaryData e passare l'array di byte.

Rendering di un modulo precompilato

Richiama il FormsService dell’oggetto renderPDFForm e passare i seguenti valori:

• Valore stringa che specifica il nome della struttura del modulo, inclusa l'estensione del nome file.
• A BLOB oggetto contenente i dati da unire al modulo. Assicurati di utilizzare BLOB oggetto creato nei passaggi uno e due.
• A PDFFormRenderSpecc oggetto che memorizza le opzioni di esecuzione. Per ulteriori informazioni, consulta Riferimento API di AEM Forms.
• A URLSpec oggetto che contiene i valori URI richiesti dal servizio Forms.
• A java.util.HashMap oggetto che memorizza gli allegati di file. Si tratta di un parametro facoltativo ed è possibile specificare null se non si desidera allegare file al modulo.
• Un 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 vuoto javax.xml.rpc.holders.LongHolder oggetto popolato dal metodo . Questo argomento memorizza il numero di pagine nel modulo.
• Un vuoto javax.xml.rpc.holders.StringHolder oggetto popolato dal metodo . (Questo argomento memorizza il valore delle impostazioni internazionali).
• Un vuoto com.adobe.idp.services.holders.FormsResultHolder oggetto che conterrà i risultati dell'operazione.

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

• Crea un FormResult ottenendo il valore del com.adobe.idp.services.holders.FormsResultHolder dell’oggetto value membro dati.
• Crea un BLOB oggetto che contiene i dati del modulo richiamando il FormsResult dell’oggetto getOutputContent metodo .
• Ottieni il tipo di contenuto del BLOB richiamandone l'oggetto getContentType metodo .
• Imposta la javax.servlet.http.HttpServletResponse tipo di contenuto dell’oggetto richiamandone il tipo setContentType e passare il tipo di contenuto BLOB oggetto.
• Crea un javax.servlet.ServletOutputStream oggetto utilizzato per scrivere il flusso di dati del modulo nel browser Web client richiamando il javax.servlet.http.HttpServletResponse dell’oggetto getOutputStream 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 .