Forms vooraf vullen met stroombare indelingen prepopulating-forms-with-flowable-layouts1

Projectbestanden opnemen

Neem client-JAR-bestanden, zoals adobe-forms-client.jar, op in het klassenpad van uw Java-project. Voor informatie over de locatie van deze bestanden raadpleegt u Inclusief AEM Forms Java-bibliotheekbestanden.

Een XML-gegevensbron in het geheugen maken

• Een Java maken DocumentBuilderFactory object aanroepen DocumentBuilderFactory klasse" newInstance methode.

• Een Java maken DocumentBuilder object aanroepen DocumentBuilderFactory object newDocumentBuilder methode.

• Roep de DocumentBuilder object newDocument methode om een instantie te maken org.w3c.dom.Document object.

• Maak het basiselement van de XML-gegevensbron door het org.w3c.dom.Document object createElement methode. Hiermee maakt u een Element object dat het basiselement vertegenwoordigt. Geef een tekenreekswaarde die de naam van het element vertegenwoordigt, door aan de createElement methode. De geretourneerde waarde omzetten in Element. Voeg vervolgens het hoofdelement aan het document toe door het Document object appendChild en geeft het hoofdelement-object door als een argument. Deze toepassingslogica wordt in de volgende coderegels getoond:

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

• Maak het koptekstelement van de XML-gegevensbron door het aanroepen van Document object createElement methode. Geef een tekenreekswaarde die de naam van het element vertegenwoordigt, door aan de createElement methode. De geretourneerde waarde omzetten in Element. Voeg vervolgens het koptekstelement aan het hoofdelement toe door het aanroepen van de root object appendChild en geeft u het kopelement-object door als een argument. De XML-elementen die aan het koptekstelement worden toegevoegd, komen overeen met het statische gedeelte van het formulier. De volgende coderegels tonen deze toepassingslogica:

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

• Maak een onderliggend element dat tot het koptekstelement behoort door het aanroepen van de Document object createElement en geeft u een tekenreekswaarde door die de naam van het element vertegenwoordigt. De geretourneerde waarde omzetten in Element. Stel vervolgens een waarde in voor het onderliggende element door de bijbehorende appendChild en geeft u de Document object createTextNode als een argument. Geef een tekenreekswaarde op die als waarde van het onderliggende element wordt weergegeven. Voeg ten slotte het onderliggende element toe aan het koptekstelement door het koptekstelement aan te roepen appendChild en geeft u het onderliggende-elementobject door als een argument. De volgende coderegels tonen deze toepassingslogica:

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

• Voeg alle resterende elementen aan het koptekstelement toe door de laatste substap te herhalen voor elk veld in het statische gedeelte van het formulier (in het XML-gegevensbrondiagram worden deze velden weergegeven in sectie A. (Zie Werken met gegevenssubgroepen.)

• Maak het detailelement van de XML-gegevensbron door het Document object createElement methode. Geef een tekenreekswaarde die de naam van het element vertegenwoordigt, door aan de createElement methode. De geretourneerde waarde omzetten in Element. Voeg vervolgens het detailelement toe aan het basiselement door het root object appendChild en geeft u het detailelementobject door als een argument. De XML-elementen die aan het detailelement worden toegevoegd, komen overeen met het dynamische gedeelte van het formulier. De volgende coderegels tonen deze toepassingslogica:

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

• Maak een onderliggend element dat tot het detailelement behoort door het Document object createElement en geeft u een tekenreekswaarde door die de naam van het element vertegenwoordigt. De geretourneerde waarde omzetten in Element. Stel vervolgens een waarde in voor het onderliggende element door de bijbehorende appendChild en geeft u de Document object createTextNode als een argument. Geef een tekenreekswaarde op die als waarde van het onderliggende element wordt weergegeven. Voeg ten slotte het onderliggende element toe aan het detailelement door het detailelement aan te roepen appendChild en geeft u het onderliggende-elementobject door als een argument. De volgende coderegels tonen deze toepassingslogica:

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

• Herhaal de laatste substap voor alle XML-elementen die aan het detailelement moeten worden toegevoegd. Als u de XML-gegevensbron correct wilt maken die wordt gebruikt om het inkooporderformulier te vullen, moet u de volgende XML-elementen aan het detailelement toevoegen: txtDescription, numQty, en numUnitPrice.

• Herhaal de laatste twee substappen voor alle gegevensitems die worden gebruikt om het formulier vooraf in te vullen.

De XML-gegevensbron converteren

• Een javax.xml.transform.Transformer door het object aan te roepen javax.xml.transform.Transformer statisch object newInstance methode.
• Een Transformer door het object aan te roepen TransformerFactory object newTransformer methode.
• Een ByteArrayOutputStream object met behulp van de constructor.
• Een javax.xml.transform.dom.DOMSource object door de constructor ervan te gebruiken en door te geven org.w3c.dom.Document object dat is gemaakt in stap 1.
• Een javax.xml.transform.dom.DOMSource object door de constructor ervan te gebruiken en door te geven ByteArrayOutputStream object.
• Java vullen ByteArrayOutputStream door het object aan te roepen javax.xml.transform.Transformer object transform en het doorgeven van de javax.xml.transform.dom.DOMSource en de javax.xml.transform.stream.StreamResult objecten.
• Maak een bytearray en wijs de grootte van de array toe ByteArrayOutputStream object naar de bytearray.
• De bytearray vullen door de ByteArrayOutputStream object toByteArray methode.
• Een com.adobe.idp.Document object door de constructor ervan te gebruiken en de bytearray door te geven.

Een vooraf ingevuld formulier renderen

De FormsServiceClient object renderPDFForm en geeft de volgende waarden door:

• Een tekenreekswaarde die de naam van het formulierontwerp opgeeft, inclusief de bestandsnaamextensie.
• A com.adobe.idp.Document object dat gegevens bevat die met het formulier moeten worden samengevoegd. Zorg ervoor dat u de com.adobe.idp.Document object gemaakt in de stappen 1 en 2.
• A PDFFormRenderSpec -object dat uitvoeringsopties opslaat.
• A URLSpec object dat URI-waarden bevat die door de Forms-service worden vereist.
• A java.util.HashMap object waarin bestandsbijlagen zijn opgeslagen. Dit is een optionele parameter en u kunt null als u geen bestanden aan het formulier wilt koppelen.

De renderPDFForm methode retourneert een FormsResult object dat een formuliergegevensstroom bevat die naar de webbrowser van de client moet worden geschreven.

• Een javax.servlet.ServletOutputStream object dat wordt gebruikt om een formuliergegevensstroom naar de webbrowser van de client te verzenden.
• Een com.adobe.idp.Document door het object aan te roepen FormsResult object 's getOutputContent methode.
• Een java.io.InputStream door het object aan te roepen com.adobe.idp.Document object getInputStream methode.
• Maak een bytearray die deze met de formuliergegevensstroom vult door de InputStream object read en de bytearray doorgeven als een argument.
• De javax.servlet.ServletOutputStream object write methode om de formuliergegevensstroom naar de webbrowser van de client te verzenden. Geef de bytearray door aan de write methode.

Projectbestanden opnemen

• Maak Java-proxyklassen die gebruikmaken van de Forms-service WSDL. (Zie Java-proxyklassen maken met Apache Axis.)
• Neem de Java-proxyklassen op in het klassepad.

Een XML-gegevensbron in het geheugen maken

• Een Java maken DocumentBuilderFactory object aanroepen DocumentBuilderFactory klasse" newInstance methode.

• Een Java maken DocumentBuilder object aanroepen DocumentBuilderFactory object newDocumentBuilder methode.

• Roep de DocumentBuilder object newDocument methode om een instantie te maken org.w3c.dom.Document object.

• Maak het basiselement van de XML-gegevensbron door het org.w3c.dom.Document object createElement methode. Hiermee maakt u een Element object dat het basiselement vertegenwoordigt. Geef een tekenreekswaarde die de naam van het element vertegenwoordigt, door aan de createElement methode. De geretourneerde waarde omzetten in Element. Voeg vervolgens het hoofdelement aan het document toe door het Document object appendChild en geeft het hoofdelement-object door als een argument. De volgende coderegels tonen deze toepassingslogica:

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

• Maak het koptekstelement van de XML-gegevensbron door het aanroepen van Document object createElement methode. Geef een tekenreekswaarde die de naam van het element vertegenwoordigt, door aan de createElement methode. De geretourneerde waarde omzetten in Element. Voeg vervolgens het koptekstelement aan het hoofdelement toe door het aanroepen van de root object appendChild en geeft u het kopelement-object door als een argument. De XML-elementen die aan het koptekstelement worden toegevoegd, komen overeen met het statische gedeelte van het formulier. De volgende coderegels tonen deze toepassingslogica:

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

• Maak een onderliggend element dat tot het koptekstelement behoort door het aanroepen van de Document object createElement en geeft u een tekenreekswaarde door die de naam van het element vertegenwoordigt. De geretourneerde waarde omzetten in Element. Stel vervolgens een waarde in voor het onderliggende element door de bijbehorende appendChild en geeft u de Document object createTextNode als een argument. Geef een tekenreekswaarde op die als waarde van het onderliggende element wordt weergegeven. Voeg ten slotte het onderliggende element toe aan het koptekstelement door het koptekstelement aan te roepen appendChild en geeft u het onderliggende-elementobject door als een argument. Deze toepassingslogica wordt in de volgende coderegels getoond:

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

• Voeg alle resterende elementen aan het koptekstelement toe door de laatste substap te herhalen voor elk veld in het statische gedeelte van het formulier (in het XML-gegevensbrondiagram worden deze velden weergegeven in sectie A. (Zie Werken met gegevenssubgroepen.)

• Maak het detailelement van de XML-gegevensbron door het Document object createElement methode. Geef een tekenreekswaarde die de naam van het element vertegenwoordigt, door aan de createElement methode. De geretourneerde waarde omzetten in Element. Voeg vervolgens het detailelement toe aan het basiselement door het root object appendChild en geeft u het detailelementobject door als een argument. De XML-elementen die aan het detailelement worden toegevoegd, komen overeen met het dynamische gedeelte van het formulier. Deze toepassingslogica wordt in de volgende coderegels getoond:

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

• Maak een onderliggend element dat tot het detailelement behoort door het Document object createElement en geeft u een tekenreekswaarde door die de naam van het element vertegenwoordigt. De geretourneerde waarde omzetten in Element. Stel vervolgens een waarde in voor het onderliggende element door de bijbehorende appendChild en geeft u de Document object createTextNode als een argument. Geef een tekenreekswaarde op die als waarde van het onderliggende element wordt weergegeven. Voeg ten slotte het onderliggende element toe aan het detailelement door het detailelement aan te roepen appendChild en geeft u het onderliggende-elementobject door als een argument. Deze toepassingslogica wordt in de volgende coderegels getoond:

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

• Herhaal de laatste substap voor alle XML-elementen die aan het detailelement moeten worden toegevoegd. Als u de XML-gegevensbron correct wilt maken die wordt gebruikt om het inkooporderformulier te vullen, moet u de volgende XML-elementen aan het detailelement toevoegen: txtDescription, numQty, en numUnitPrice.

• Herhaal de laatste twee substappen voor alle gegevensitems die worden gebruikt om het formulier vooraf in te vullen.

De XML-gegevensbron converteren

• Een javax.xml.transform.Transformer door het object aan te roepen javax.xml.transform.Transformer statisch object newInstance methode.
• Een Transformer door het object aan te roepen TransformerFactory object newTransformer methode.
• Een ByteArrayOutputStream object met behulp van de constructor.
• Een javax.xml.transform.dom.DOMSource object door de constructor ervan te gebruiken en door te geven org.w3c.dom.Document object dat is gemaakt in stap 1.
• Een javax.xml.transform.dom.DOMSource object door de constructor ervan te gebruiken en door te geven ByteArrayOutputStream object.
• Java vullen ByteArrayOutputStream door het object aan te roepen javax.xml.transform.Transformer object transform en het doorgeven van de javax.xml.transform.dom.DOMSource en de javax.xml.transform.stream.StreamResult objecten.
• Maak een bytearray en wijs de grootte van de array toe ByteArrayOutputStream object naar de bytearray.
• De bytearray vullen door de ByteArrayOutputStream object toByteArray methode.
• Een BLOB object door de constructor ervan te gebruiken en aan te roepen setBinaryData en geeft u de bytearray door.

Een vooraf ingevuld formulier renderen

De FormsService object renderPDFForm en geeft de volgende waarden door:

• Een tekenreekswaarde die de naam van het formulierontwerp opgeeft, inclusief de bestandsnaamextensie.
• A BLOB object dat gegevens bevat die met het formulier moeten worden samengevoegd. Zorg ervoor dat u de BLOB object dat in stap 1 en 2 is gemaakt.
• A PDFFormRenderSpecc -object dat uitvoeringsopties opslaat. Zie voor meer informatie AEM Forms API-naslag.
• A URLSpec object dat URI-waarden bevat die door de Forms-service worden vereist.
• A java.util.HashMap object waarin bestandsbijlagen zijn opgeslagen. Dit is een optionele parameter en u kunt null als u geen bestanden aan het formulier wilt koppelen.
• Een leeg com.adobe.idp.services.holders.BLOBHolder object dat door de methode wordt gevuld. Hiermee slaat u het gerenderde PDF formulier op.
• Een leeg javax.xml.rpc.holders.LongHolder object dat door de methode wordt gevuld. (In dit argument wordt het aantal pagina's in het formulier opgeslagen).
• Een leeg javax.xml.rpc.holders.StringHolder object dat door de methode wordt gevuld. (In dit argument wordt de waarde van de landinstelling opgeslagen.)
• Een leeg com.adobe.idp.services.holders.FormsResultHolder -object dat de resultaten van deze bewerking bevat.

De renderPDFForm wordt de com.adobe.idp.services.holders.FormsResultHolder object dat wordt doorgegeven als de laatste argumentwaarde met een formuliergegevensstroom die naar de webbrowser van de client moet worden geschreven.

• Een FormResult object door de waarde van het object op te halen com.adobe.idp.services.holders.FormsResultHolder object value lid.
• Een BLOB object dat formuliergegevens bevat door het FormsResult object getOutputContent methode.
• Hiermee wordt het inhoudstype van het dialoogvenster BLOB object aanroepen getContentType methode.
• Stel de javax.servlet.http.HttpServletResponse inhoudstype van object aanroepen setContentType en geeft u het inhoudstype van het dialoogvenster door BLOB object.
• Een javax.servlet.ServletOutputStream object dat wordt gebruikt om de formuliergegevensstroom naar de webbrowser van de client te schrijven door het aanroepen van de javax.servlet.http.HttpServletResponse object getOutputStream methode.
• Maak een bytearray en vul deze door het BLOB object getBinaryData methode. Deze taak wijst de inhoud van toe FormsResult object naar de bytearray.
• De javax.servlet.http.HttpServletResponse object write methode om de formuliergegevensstroom naar de webbrowser van de client te verzenden. Geef de bytearray door aan de write methode.