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

CAUTION
AEM 6.4 heeft het einde van de uitgebreide ondersteuning bereikt en deze documentatie wordt niet meer bijgewerkt. Raadpleeg voor meer informatie onze technische ondersteuningsperioden. Ondersteunde versies zoeken hier.

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

Als u formulieren vooraf invult, worden gegevens weergegeven voor gebruikers in een gegenereerd formulier. Stel bijvoorbeeld dat een gebruiker zich aanmeldt bij een website met een gebruikersnaam en wachtwoord. Als de verificatie is gelukt, vraagt de clienttoepassing een database om gebruikersgegevens. De gegevens worden samengevoegd in het formulier en het formulier wordt vervolgens weergegeven aan de gebruiker. Hierdoor kan de gebruiker gepersonaliseerde gegevens weergeven in het formulier.

Het vooraf invullen van een formulier heeft de volgende voordelen:

  • Hiermee kan de gebruiker aangepaste gegevens in een formulier bekijken.
  • Hiermee vermindert u de hoeveelheid die de gebruiker invoert om een formulier in te vullen.
  • Zorgt voor gegevensintegriteit door controle te hebben over waar de gegevens worden geplaatst.

De volgende twee XML-gegevensbronnen kunnen een formulier vooraf invullen:

  • Een XDP-gegevensbron, te weten XML die voldoet aan de XFA-syntaxis (of XFDF-gegevens voor het vooraf invullen van een formulier dat is gemaakt met Acrobat).
  • Een willekeurige XML-gegevensbron die naam/waardeparen bevat die overeenkomen met de veldnamen van het formulier (in de voorbeelden in deze sectie wordt een willekeurige XML-gegevensbron gebruikt).

Er moet een XML-element aanwezig zijn voor elk formulierveld dat u vooraf wilt invullen. De naam van het XML-element moet overeenkomen met de veldnaam. Een XML-element wordt genegeerd als het niet overeenkomt met een formulierveld of als de naam van het XML-element niet overeenkomt met de veldnaam. Het is niet nodig de volgorde aan te passen waarin de XML-elementen worden weergegeven, zolang alle XML-elementen zijn opgegeven.

Wanneer u een formulier invult dat al gegevens bevat, moet u opgeven welke gegevens al in de XML-gegevensbron worden weergegeven. Stel dat een formulier met tien velden gegevens bevat in vier velden. Ga er vervolgens van uit dat u de resterende zes velden vooraf wilt invullen. In dit geval moet u 10 XML-elementen opgeven in de XML-gegevensbron die wordt gebruikt om het formulier vooraf in te vullen. Als u slechts zes elementen opgeeft, zijn de oorspronkelijke vier velden leeg.

U kunt bijvoorbeeld een formulier zoals het voorbeeldbevestigingsformulier vooraf invullen. (Zie "Bevestigingsformulier" in Interactieve PDF forms renderen.)

Als u het voorbeeldbevestigingsformulier vooraf wilt invullen, moet u een XML-gegevensbron maken die drie XML-elementen bevat die overeenkomen met de drie velden in het formulier. Dit formulier bevat de volgende drie velden: FirstName, LastName, en Amount. De eerste stap bestaat uit het maken van een XML-gegevensbron die XML-elementen bevat die overeenkomen met de velden in het formulierontwerp. De volgende stap bestaat uit het toewijzen van gegevenswaarden aan de XML-elementen, zoals in de volgende XML-code wordt getoond.

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

Nadat u het bevestigingsformulier vooraf hebt ingevuld met deze XML-gegevensbron en het formulier hebt gegenereerd, worden de gegevenswaarden weergegeven die u aan de XML-elementen hebt toegewezen, zoals in het volgende diagram wordt getoond.

pf_pf_confirmxml3

Formulieren vooraf invullen met stroombare indelingen prepopulating_forms_with_flowable_layouts-1

Forms met stroombare indelingen is handig om een onbepaalde hoeveelheid gegevens weer te geven aan gebruikers. Omdat de indeling van het formulier automatisch wordt aangepast aan de hoeveelheid samengevoegde gegevens, hoeft u niet vooraf een vaste indeling of een vast aantal pagina's voor het formulier vast te stellen, zoals u moet doen met een formulier met een vaste indeling.

Een formulier wordt meestal gevuld met gegevens die tijdens runtime worden verkregen. Hierdoor kunt u een formulier vooraf invullen door een XML-gegevensbron in het geheugen te maken en de gegevens rechtstreeks in de XML-gegevensbron in het geheugen te plaatsen.

Overweeg een webtoepassing, zoals een onlinewinkel. Nadat een online winkelier de aanschaf van items heeft voltooid, worden alle aangeschafte items in een XML-gegevensbron in het geheugen geplaatst die wordt gebruikt om een formulier vooraf in te vullen. Het volgende diagram toont dit proces, dat in de lijst na het diagram wordt verklaard.

pf_pf_finsrv_webapp_v1

In de volgende tabel worden de stappen in dit diagram beschreven.

Stap
Beschrijving
1
Een gebruiker koopt objecten aan in een online winkel op internet.
2
Nadat de gebruiker klaar is met het aanschaffen van items en op de knop Verzenden klikt, wordt een XML-gegevensbron in het geheugen gemaakt. Aangeschafte items en gebruikersgegevens worden in de XML-gegevensbron in het geheugen geplaatst.
3
De XML-gegevensbron wordt gebruikt om een inkooporderformulier vooraf in te vullen (een voorbeeld van dit formulier wordt in deze tabel weergegeven).
4
Het inkooporderformulier wordt weergegeven in de webbrowser van de client.

In het volgende diagram ziet u een voorbeeld van een inkooporderformulier. De informatie in de tabel kan worden aangepast aan het aantal records in de XML-gegevens.

pf_pf_poform

NOTE
Een formulier kan vooraf worden ingevuld met gegevens uit andere bronnen, zoals een ondernemingsdatabase of externe toepassingen.

Overwegingen bij het ontwerpen van formulieren form-design-considerations

Forms met stroombare indelingen is gebaseerd op formulierontwerpen die zijn gemaakt in Designer. Een formulierontwerp bevat een set regels voor de indeling, presentatie en gegevensvastlegging, inclusief het berekenen van waarden op basis van de gebruikersinvoer. De regels worden toegepast wanneer gegevens in een formulier worden ingevoerd. Velden die aan een formulier worden toegevoegd, zijn subformulieren die zich binnen het formulierontwerp bevinden. In het inkooporderformulier dat in het vorige diagram wordt weergegeven, is elke regel bijvoorbeeld een subformulier. Voor informatie over het maken van een formulierontwerp dat subformulieren bevat, raadpleegt u Een inkooporderformulier maken met een stroombare indeling.

Werken met gegevenssubgroepen understanding-data-subgroups

Een XML-gegevensbron wordt gebruikt om formulieren vooraf in te vullen met vaste indelingen en stroombare indelingen. Het verschil is echter dat een XML-gegevensbron die een formulier met een stroombare indeling vooraf invult, herhalende XML-elementen bevat die worden gebruikt om vooraf subformulieren in te vullen die in het formulier worden herhaald. Deze herhaalde XML-elementen worden gegevenssubgroepen genoemd.

Een XML-gegevensbron die wordt gebruikt om de inkoopordervorm die in het vorige diagram wordt weergegeven, vooraf in te vullen, bevat vier herhalende gegevenssubgroepen. Elke gegevenssubgroep komt overeen met een aangeschaft item. De aangeschafte items zijn een monitor, een bureaulamp, een telefoon en een adresboek.

De volgende XML-gegevensbron wordt gebruikt om het inkooporderformulier vooraf in te vullen.

     <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>

Elke gegevenssubgroep bevat vier XML-elementen die overeenkomen met deze informatie:

  • Artikelonderdeelnummer
  • Objectbeschrijving
  • Aantal objecten
  • Eenheidsprijs

De naam van het bovenliggende XML-element van een gegevenssubgroep moet overeenkomen met de naam van het subformulier dat zich in het formulierontwerp bevindt. In het vorige diagram ziet u bijvoorbeeld dat de naam van het bovenliggende XML-element van de gegevenssubgroep bestaat uit detail. Dit komt overeen met de naam van het subformulier in het formulierontwerp waarop het inkooporderformulier is gebaseerd. Als de naam van het bovenliggende XML-element van de gegevenssubgroep en het subformulier niet overeenkomen, wordt een formulier op de server niet vooraf ingevuld.

Elke gegevenssubgroep moet XML-elementen bevatten die overeenkomen met de veldnamen in het subformulier. De detail Het subformulier in het formulierontwerp bevat de volgende velden:

  • txtPartNum
  • txtDescription
  • numQty
  • numUnitPrice
NOTE
Als u probeert een formulier vooraf te vullen met een gegevensbron die herhalende XML-elementen bevat, stelt u de RenderAtClient optie voor No, wordt alleen de eerste gegevensrecord in het formulier samengevoegd. Als u alle gegevensrecords in het formulier wilt samenvoegen, stelt u de opdracht RenderAtClient tot Yes. Voor informatie over de RenderAtClient optie, zie Forms renderen op de client.
NOTE
Ga voor meer informatie over de Forms-service naar Services Reference for AEM Forms.

Overzicht van de stappen summary-of-steps

Als u een formulier vooraf wilt invullen met een stroombare indeling, voert u de volgende taken uit:

  1. Inclusief projectbestanden.
  2. Maak een XML-gegevensbron in het geheugen.
  3. Zet de XML-gegevensbron om.
  4. Een vooraf ingevuld formulier weergeven.

Projectbestanden opnemen

Neem de benodigde bestanden op in uw ontwikkelingsproject. Als u een clienttoepassing maakt met Java, neemt u de benodigde JAR-bestanden op. Als u webservices gebruikt, dient u de proxybestanden op te nemen.

Projectbestanden opnemen

Neem de benodigde bestanden op in uw ontwikkelingsproject. Als u een clienttoepassing maakt met Java, neemt u de benodigde JAR-bestanden op. Als u webservices gebruikt, dient u de proxybestanden op te nemen.

Een XML-gegevensbron in het geheugen maken

U kunt org.w3c.dom klassen om een XML-gegevensbron in het geheugen te maken om een formulier vooraf in te vullen met een stroombare indeling. U moet gegevens in een XML-gegevensbron plaatsen die voldoet aan het formulier. Voor informatie over de relatie tussen een formulier met een stroombare indeling en de XML-gegevensbron raadpleegt u Werken met gegevenssubgroepen.

De XML-gegevensbron converteren

Een XML-gegevensbron in het geheugen die is gemaakt met org.w3c.dom kunnen worden omgezet in een com.adobe.idp.Document object voordat u het kunt gebruiken om een formulier vooraf in te vullen. Een XML-gegevensbron in het geheugen kan worden geconverteerd met Java XML-transformatieklassen.

NOTE
Als u de WSDL van de Forms-service gebruikt om een formulier vooraf in te vullen, moet u een org.w3c.dom.Document in een BLOB object.

Een vooraf ingevuld formulier renderen

U kunt een vooraf ingevuld formulier net als een ander formulier weergeven. Het enige verschil is dat je de com.adobe.idp.Document -object dat de XML-gegevensbron bevat om het formulier vooraf in te vullen.

Zie ook

Inclusief AEM Forms Java-bibliotheekbestanden

Verbindingseigenschappen instellen

Forms Service API Quick Start

Interactieve PDF forms renderen

Webtoepassingen maken die Forms renderen

Formulieren vooraf invullen met de Java API prepopulating-forms-using-the-java-api

Voer de volgende stappen uit om een formulier met een stroombare indeling vooraf in te vullen met de Forms API (Java):

  1. 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.

  2. 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.

  3. 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.
  4. 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.

Zie ook

Snel starten (SOAP-modus): Forms vooraf vullen met stroombare indelingen met de Java API

Inclusief AEM Forms Java-bibliotheekbestanden

Verbindingseigenschappen instellen

Formulieren vooraf invullen met de webservice-API prepopulating-forms-using-the-web-service-api

Voer de volgende stappen uit om een formulier met een stroombare indeling vooraf in te vullen met de Forms API (webservice):

  1. Projectbestanden opnemen

  2. 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.

  3. 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.
  4. 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.
    note note
    NOTE
    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.

Zie ook

AEM Forms aanroepen met Base64-codering

recommendation-more-help
a6ebf046-2b8b-4543-bd46-42a0d77792da