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

Includi file di progetto

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

Creare un'origine dati XML in memoria

• Creare un oggetto Java DocumentBuilderFactory chiamando il metodo newInstance della classe DocumentBuilderFactory.

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

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

• Creare l'elemento radice dell'origine dati XML richiamando il metodo createElement dell'oggetto org.w3c.dom.Document. Viene creato un oggetto Element che rappresenta l'elemento radice. Passa un valore stringa che rappresenta il nome dell'elemento al metodo createElement. Eseguire il cast del valore restituito in Element. Aggiungere quindi l'elemento radice al documento chiamando il metodo appendChild dell'oggetto Document 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 di intestazione dell'origine dati XML chiamando il metodo createElement dell'oggetto Document. Passa un valore stringa che rappresenta il nome dell'elemento al metodo createElement. Eseguire il cast del valore restituito in Element. Aggiungere quindi l'elemento header all'elemento root chiamando il metodo appendChild dell'oggetto root e passare l'oggetto header 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 header chiamando il metodo createElement dell'oggetto Document e passare un valore string che rappresenta il nome dell'elemento. Eseguire il cast del valore restituito in Element. Impostare quindi un valore per l'elemento figlio chiamando il relativo metodo appendChild e passare il metodo createTextNode dell'oggetto Document come argomento. Specifica un valore stringa che viene visualizzato come valore dell'elemento figlio. Infine, accodare l'elemento figlio all'elemento header chiamando il metodo appendChild dell'elemento header 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 origine dati XML questi campi sono visualizzati nella sezione A. Vedere Informazioni sui sottogruppi di dati.)

• Creare l'elemento dettaglio dell'origine dati XML chiamando il metodo createElement dell'oggetto Document. Passa un valore stringa che rappresenta il nome dell'elemento al metodo createElement. Eseguire il cast del valore restituito in Element. Aggiungere quindi l'elemento di dettaglio all'elemento radice chiamando il metodo appendChild dell'oggetto root e passare l'oggetto elemento di 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 il metodo createElement dell'oggetto Document e passare un valore stringa che rappresenta il nome dell'elemento. Eseguire il cast del valore restituito in Element. Impostare quindi un valore per l'elemento figlio chiamando il relativo metodo appendChild e passare il metodo createTextNode dell'oggetto Document come argomento. Specifica un valore stringa che viene visualizzato come valore dell'elemento figlio. Infine, aggiungere l'elemento figlio all'elemento dettaglio chiamando il metodo appendChild dell'elemento dettaglio 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 fornitore, è 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.

Convertire l'origine dati XML

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

Rendering di un modulo precompilato

Richiama il metodo renderPDFForm dell'oggetto FormsServiceClient e passa i seguenti valori:

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

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

Includi file di progetto

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

Creare un'origine dati XML in memoria

• Creare un oggetto Java DocumentBuilderFactory chiamando il metodo newInstance della classe DocumentBuilderFactory.

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

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

• Creare l'elemento radice dell'origine dati XML richiamando il metodo createElement dell'oggetto org.w3c.dom.Document. Viene creato un oggetto Element che rappresenta l'elemento radice. Passa un valore stringa che rappresenta il nome dell'elemento al metodo createElement. Eseguire il cast del valore restituito in Element. Aggiungere quindi l'elemento radice al documento chiamando il metodo appendChild dell'oggetto Document 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 di intestazione dell'origine dati XML chiamando il metodo createElement dell'oggetto Document. Passa un valore stringa che rappresenta il nome dell'elemento al metodo createElement. Eseguire il cast del valore restituito in Element. Aggiungere quindi l'elemento header all'elemento root chiamando il metodo appendChild dell'oggetto root e passare l'oggetto header 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 header chiamando il metodo createElement dell'oggetto Document e passare un valore string che rappresenta il nome dell'elemento. Eseguire il cast del valore restituito in Element. Impostare quindi un valore per l'elemento figlio chiamando il relativo metodo appendChild e passare il metodo createTextNode dell'oggetto Document come argomento. Specifica un valore stringa che viene visualizzato come valore dell'elemento figlio. Infine, accodare l'elemento figlio all'elemento header chiamando il metodo appendChild dell'elemento header 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 origine dati XML questi campi sono visualizzati nella sezione A. Vedere Informazioni sui sottogruppi di dati.)

• Creare l'elemento dettaglio dell'origine dati XML chiamando il metodo createElement dell'oggetto Document. Passa un valore stringa che rappresenta il nome dell'elemento al metodo createElement. Eseguire il cast del valore restituito in Element. Aggiungere quindi l'elemento di dettaglio all'elemento radice chiamando il metodo appendChild dell'oggetto root e passare l'oggetto elemento di 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 il metodo createElement dell'oggetto Document e passare un valore stringa che rappresenta il nome dell'elemento. Eseguire il cast del valore restituito in Element. Impostare quindi un valore per l'elemento figlio chiamando il relativo metodo appendChild e passare il metodo createTextNode dell'oggetto Document come argomento. Specifica un valore stringa che viene visualizzato come valore dell'elemento figlio. Infine, aggiungere l'elemento figlio all'elemento dettaglio chiamando il metodo appendChild dell'elemento dettaglio 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 fornitore, è 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.

Convertire l'origine dati XML

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

Rendering di un modulo precompilato

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

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

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

• Creare un oggetto FormResult ottenendo il valore del membro dati value dell'oggetto com.adobe.idp.services.holders.FormsResultHolder.
• Creare un oggetto BLOB contenente dati del modulo richiamando il metodo getOutputContent dell'oggetto FormsResult.
• Ottenere il tipo di contenuto dell'oggetto BLOB richiamando il relativo metodo getContentType.
• Impostare il tipo di contenuto dell'oggetto javax.servlet.http.HttpServletResponse richiamando il relativo metodo setContentType e passando il tipo di contenuto dell'oggetto BLOB.
• Creare un oggetto javax.servlet.ServletOutputStream utilizzato per scrivere il flusso di dati del modulo nel browser Web client richiamando il metodo getOutputStream dell'oggetto javax.servlet.http.HttpServletResponse.
• 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.