De Forms-service geeft formulieren als HTML weer in reactie op een HTTP-aanvraag van een webbrowser. Een voordeel van het weergeven van een formulier als HTML is dat de computer waarop de webbrowser van de client zich bevindt geen Adobe Reader, Acrobat of Flash Player vereist (voor formulierhulplijnen (afgekeurd)).
Als u een formulier wilt weergeven als HTML, moet het formulierontwerp worden opgeslagen als een XDP-bestand. Een formulierontwerp dat is opgeslagen als een PDF-bestand, kan niet worden weergegeven als HTML. Houd rekening met de volgende criteria wanneer u een formulierontwerp ontwikkelt in Designer dat wordt weergegeven als HTML:
Als u een formulier met TIFF-afbeeldingen weergeeft met de methoden (Deprecated) renderHTMLForm
en renderHTMLForm2
van het object FormServiceClient
, zijn de TIFF-afbeeldingen niet zichtbaar in het weergegeven HTML-formulier dat wordt weergegeven in Internet Explorer- of Mozilla Firefox-browsers. Deze browsers bieden geen native ondersteuning voor TIFF-afbeeldingen.
Wanneer een formulierontwerp wordt weergegeven als een HTML-formulier, wordt elk subformulier op het tweede niveau weergegeven als een HTML-pagina (deelvenster). U kunt de hiërarchie van een subformulier weergeven in Designer. Onderliggende subformulieren die tot het basissubformulier behoren (de standaardnaam van een basissubformulier is form1), zijn de deelvenstersubformulieren. In het volgende voorbeeld worden de subformulieren van een formulierontwerp weergegeven.
form1
Master Pages
PanelSubform1
NestedDynamicSubform
TextEdit1
PanelSubform2
TextEdit1
PanelSubform3
TextEdit1
PanelSubform4
TextEdit1
Wanneer formulierontwerpen worden weergegeven als HTML-formulieren, blijven de deelvensters beperkt tot een bepaald paginaformaat. Als u dynamische subformulieren hebt, moeten deze in het deelvenstersubformulier worden genest. Dynamische subformulieren kunnen worden uitgebreid naar een oneindig aantal HTML-pagina's.
Wanneer een formulier wordt weergegeven als een HTML-formulier, hebben paginaformaten (vereist voor paginering van formulieren die worden weergegeven als PDF) geen betekenis. Omdat een formulier met een stroombare indeling kan worden uitgebreid naar een oneindig aantal HTML-pagina's, is het belangrijk dat u geen voetteksten op de master pagina plaatst. Een voettekst onder het inhoudsgebied op een master pagina kan HTML-inhoud overschrijven die voorbij een paginagrens loopt.
U moet expliciet van deelvenster naar deelvenster gaan met de methoden xfa.host.pageUp
en xfa.host.pageDown
. U wijzigt pagina's door een formulier naar de Forms-service te verzenden en het formulier door de Forms-service terug te sturen naar het clientapparaat, meestal een webbrowser.
Het proces waarbij een formulier naar de Forms-service wordt verzonden en het formulier vervolgens door de Forms-service naar het clientapparaat wordt teruggestuurd, wordt ook wel 'round tripping data' naar de server genoemd.
Als u de weergave van de knop Digitale HTML-handtekening op een HTML-formulier wilt aanpassen, moet u de volgende eigenschappen wijzigen in het bestand fscdigsig.css (in het bestand adobe-forms-ds.ear > adobe-forms-ds.war):
.fsc-ds-ssb: Dit stijlblad is van toepassing in het geval van een leeg tekenveld.
.fsc-ds-ssv: Dit stijlblad is van toepassing in het geval van een geldig tekenveld.
.fsc-ds-ssc: Dit stijlblad is van toepassing in het geval van een geldig handtekeningveld, maar er zijn gegevens gewijzigd.
.fsc-ds-ssi: Dit stijlblad is van toepassing in het geval van een ongeldig handtekeningveld.
.fsc-ds-popup-bg: Deze stijlbladeigenschap wordt niet gebruikt.
.fsc-ds-popup-btn: Deze stijlbladeigenschap wordt niet gebruikt.
Een auteur van een formulier geeft aan of een script op de server of de client wordt uitgevoerd. De Forms-service maakt een gedistribueerde, gebeurtenisverwerkingsomgeving voor de uitvoering van formulierintelligentie die kan worden gedistribueerd tussen de client en de server met behulp van het runAt
-kenmerk. Zie Forms Designer voor informatie over dit kenmerk of het maken van scripts in formulierontwerpen.
De Forms-service kan scripts uitvoeren terwijl het formulier wordt gegenereerd. Hierdoor kunt u een formulier vooraf invullen met gegevens door verbinding te maken met een database of met webservices die mogelijk niet beschikbaar zijn op de client. U kunt ook de Click
-gebeurtenis van een knop instellen om op de server te worden uitgevoerd, zodat de client gegevens voor retournering naar de server verzendt. Hierdoor kan de client scripts uitvoeren waarvoor mogelijk serverbronnen nodig zijn, zoals een ondernemingsdatabase, terwijl een gebruiker communiceert met een formulier. Voor HTML-formulieren kunnen formele scripts alleen op de server worden uitgevoerd. Als gevolg hiervan moet u deze scripts markeren om te worden uitgevoerd op server
of both
.
U kunt formulieren ontwerpen die tussen pagina's (deelvensters) worden verplaatst door de methoden xfa.host.pageUp
en xfa.host.pageDown
aan te roepen. Dit script wordt in de gebeurtenis Click
van een knop geplaatst en het kenmerk runAt
is ingesteld op Both
. De reden dat u Both
kiest, is zo dat Adobe Reader of Acrobat (voor formulieren die als PDF worden gerenderd) pagina's kan wijzigen zonder naar de server te gaan en dat HTML-formulieren pagina's kunnen wijzigen door gegevens naar de server af te snijden. Een formulier wordt dus naar de Forms-service verzonden en een formulier wordt als HTML weergegeven met de nieuwe pagina.
U wordt aangeraden scriptvariabelen en formuliervelden niet dezelfde namen te geven, zoals item. Sommige webbrowsers, zoals Internet Explorer, initialiseren een variabele met dezelfde naam als een formulierveld, waardoor een scriptfout optreedt. Het is een goede gewoonte om formuliervelden en scriptvariabelen verschillende namen te geven.
Wanneer u HTML-formulieren weergeeft die zowel paginanavigatiefunctionaliteit als formulierscripts bevatten (neem bijvoorbeeld aan dat met een script veldgegevens worden opgehaald uit een database telkens wanneer het formulier wordt gegenereerd), moet u ervoor zorgen dat het formulierscript zich in de gebeurtenis form:calculate bevindt in plaats van in de gebeurtenis form:readyevent.
Formulierscripts die zich in de gebeurtenis form:ready bevinden, worden slechts eenmaal uitgevoerd tijdens de eerste weergave van het formulier en worden niet uitgevoerd voor volgende opvragingen van pagina's. De gebeurtenis form:calculate wordt daarentegen uitgevoerd voor elke paginanavigatie waarin het formulier wordt gegenereerd.
Op een formulier met meerdere pagina's blijven wijzigingen die door JavaScript in een pagina zijn aangebracht, niet behouden als u naar een andere pagina gaat.
U kunt aangepaste scripts aanroepen voordat u een formulier verzendt. Deze functie werkt op alle beschikbare browsers. Deze kan echter alleen worden gebruikt wanneer gebruikers het HTML-formulier weergeven waarvoor de eigenschap Output Type
is ingesteld op Form Body
. Het werkt niet wanneer Output Type
Full HTML
is. Zie Formulieren configureren in de Help voor het beheer voor stappen om deze functie te configureren.
U moet eerst een callback-functie definiëren die wordt aangeroepen voordat het formulier wordt verzonden, waarbij de naam van de functie _user_onsubmit
is. Er wordt aangenomen dat de functie geen uitzondering genereert of dat de uitzondering wordt genegeerd als dit het geval is. Het wordt aanbevolen de JavaScript-functie in de kopsectie van de HTML te plaatsen. nochtans, kunt u het overal vóór het eind van de manuscriptmarkeringen verklaren die xfasubset.js
omvatten.
Wanneer de formserver een XDP teruggeeft die een drop-down lijst bevat, naast het creëren van de drop-down lijst, leidt het ook tot twee verborgen tekstgebieden. In deze tekstvelden worden de gegevens van de vervolgkeuzelijst opgeslagen (in de ene tekstveld wordt de weergavenaam van de opties opgeslagen en in de andere tekstveld wordt de waarde voor de opties opgeslagen). Daarom wordt elke keer dat een gebruiker het formulier verzendt, het volledige gegeven van de vervolgkeuzelijst verzonden. Ervan uitgaande dat u niet zoveel gegevens elke keer wilt verzenden, kunt u een aangepast script schrijven om dat uit te schakelen. Bijvoorbeeld: De naam van de vervolgkeuzelijst is drpOrderedByStateProv
en wordt ondergebracht onder de koptekst van het subformulier. De naam van het HTML-invoerelement is header[0].drpOrderedByStateProv[0]
. De naam van de verborgen velden waarin de gegevens van het vervolgkeuzemenu worden opgeslagen en verzonden, heeft de volgende namen: header[0].drpOrderedByStateProv_DISPLAYITEMS_[0] header[0].drpOrderedByStateProv_VALUEITEMS_[0]
U kunt deze invoerelementen op de volgende manier uitschakelen als u de gegevens niet wilt posten. var __CUSTOM_SCRIPTS_VERSION = 1; //enabling the feature function _user_onsubmit() { var elems = document.getElementsByName("header[0].drpOrderedByStateProv_DISPLAYITEMS_[0]"); elems[0].disabled = true; elems = document.getElementsByName("header[0].drpOrderedByStateProv_VALUEITEMS_[0]"); elems[0].disabled = true; }
header[0].drpOrderedByStateProv_DISPLAYITEMS_[0] header[0].drpOrderedByStateProv_VALUEITEMS_[0]
var __CUSTOM_SCRIPTS_VERSION = 1; //enabling the feature
function _user_onsubmit() {
var elems = document.getElementsByName("header[0].drpOrderedByStateProv_DISPLAYITEMS_[0]");
elems[0].disabled = true;
elems = document.getElementsByName("header[0].drpOrderedByStateProv_VALUEITEMS_[0]");
elems[0].disabled = true;
}
Wanneer u formulierontwerpen maakt om als HTML te worden gerenderd, moet u het script beperken tot de XFA-subset voor scripts in de javascript-taal.
Scripts die op de client worden uitgevoerd of op zowel de client als de server worden uitgevoerd, moeten binnen de XFA-subset worden geschreven. Scripts die op de server worden uitgevoerd, kunnen het volledige XFA-scriptmodel gebruiken en ook FormCalc gebruiken. Zie Forms Designer voor informatie over het gebruik van JavaScript.
Bij het uitvoeren van scripts op de client kan alleen het deelvenster dat momenteel wordt weergegeven, scripts gebruiken. U kunt bijvoorbeeld geen script uitvoeren op velden die zich in deelvenster A bevinden wanneer deelvenster B wordt weergegeven. Wanneer scripts op de server worden uitgevoerd, zijn alle deelvensters toegankelijk.
U moet ook voorzichtig zijn wanneer het gebruiken van de uitdrukkingen van het Model van Objecten Scripting (SOM) binnen manuscripten die op de cliënt lopen. Alleen een vereenvoudigde subset van SOM-expressies wordt ondersteund door scripts die op de client worden uitgevoerd.
De XFA-subset definieert de XFA-gebeurtenissen die zijn toegewezen aan HTML-gebeurtenissen. Er is een klein verschil in gedrag met betrekking tot de timing van de gebeurtenissen calculate and validate. In een webbrowser wordt een volledige gebeurtenis calculate uitgevoerd wanneer u een veld verlaat. Gebeurtenissen berekenen worden niet automatisch uitgevoerd wanneer u een wijziging in een veldwaarde aanbrengt. U kunt een berekeningsgebeurtenis dwingen door de methode xfa.form.execCalculate
te roepen.
In een webbrowser worden validatiegebeurtenissen alleen uitgevoerd wanneer een veld wordt gesloten of een formulier wordt verzonden. U kunt een validate gebeurtenis dwingen door de xfa.form.execValidate
methode te gebruiken.
Forms die wordt weergegeven in een webbrowser (in tegenstelling tot Adobe Reader of Acrobat), voldoet aan de XFA null-test (fouten of waarschuwingen) voor verplichte velden.
Zie Forms Designer voor meer informatie over een null-test.
Als u op een knop Verzenden klikt, worden formuliergegevens naar de Forms-service verzonden en wordt het einde van de formulierverwerking aangegeven. De gebeurtenis preSubmit
kan worden ingesteld om op de client of server te worden uitgevoerd. De gebeurtenis preSubmit
wordt uitgevoerd voordat het formulier wordt verzonden als dit is geconfigureerd om op de client te worden uitgevoerd. Anders wordt de gebeurtenis preSubmit
tijdens het verzenden van het formulier op de server uitgevoerd. Zie Forms Designer voor meer informatie over de gebeurtenis preSubmit
.
Als er aan een knop geen clientscript is gekoppeld, worden gegevens naar de server verzonden, worden berekeningen op de server uitgevoerd en wordt het HTML-formulier opnieuw gegenereerd. Als een knop een clientscript bevat, worden er geen gegevens naar de server verzonden en wordt het clientscript in de webbrowser uitgevoerd.
Een webbrowser die alleen HTML 4.0 ondersteunt, kan het scriptmodel van de XFA-subset client-side niet ondersteunen. Wanneer u een formulierontwerp maakt dat zowel in HTML 4.0 als in MSDHTML of CSS2HTML werkt, wordt een script dat is gemarkeerd om op de client te worden uitgevoerd, daadwerkelijk op de server uitgevoerd. Stel dat een gebruiker op een knop klikt die zich op een formulier bevindt dat in een HTML 4.0-webbrowser wordt weergegeven. In dit geval worden de formuliergegevens verzonden naar de server waar het clientscript wordt uitgevoerd.
U wordt aangeraden de formulierlogica in Calculate-gebeurtenissen te plaatsen. Deze gebeurtenissen worden uitgevoerd op de server in HTML 4.0 en op de client voor MSDHTML of CSS2HTML.
Bij het schakelen tussen HTML-pagina's (deelvensters) blijft alleen de status van de gegevens behouden. Instellingen zoals achtergrondkleur of verplichte veldinstellingen blijven niet behouden (als deze afwijken van de oorspronkelijke instellingen). Als u de presentatiestatus wilt behouden, moet u (gewoonlijk verborgen) velden maken die de presentatiestatus van velden aangeven. Als u een script toevoegt aan de gebeurtenis Calculate
van een veld waarmee de presentatie wordt gewijzigd op basis van verborgen veldwaarden, kunt u de presentatiestatus behouden wanneer u heen en weer gaat tussen HTML-pagina's (deelvensters).
In het volgende script wordt fillColor
van een veld onderhouden op basis van de waarde van hiddenField
. Stel dat dit script zich in de gebeurtenis Calculate
van een veld bevindt.
If (hiddenField.rawValue == 1)
this.fillColor = "255,0,0"
else
this.fillColor = "0,255,0"
Statische objecten worden niet weergegeven in een gerenderd HTML-formulier wanneer ze in een tabelcel zijn genest. Een cirkel en rechthoek die in een tabelcel zijn genest, worden bijvoorbeeld niet weergegeven in een HTML-renderformulier. Dezelfde statische objecten worden echter correct weergegeven wanneer deze zich buiten de tabel bevinden.
U kunt geen HTML-formulier ondertekenen dat een digitaal handtekeningveld bevat als het formulier wordt weergegeven als een van de volgende HTML-transformaties:
Zie Documenten digitaal ondertekenen en certificeren voor meer informatie over het digitaal ondertekenen van een document
U kunt een volledig HTML-formulier weergeven dat voldoet aan toegankelijkheidsrichtlijnen. Het formulier wordt dus gegenereerd binnen volledige HTML-tags, in tegenstelling tot het HTML-formulier dat wordt weergegeven binnen body-tags (geen volledige HTML-pagina).
Het wordt aanbevolen het gebruik van validatieregels voor formuliervelden te beperken wanneer u het formulier weergeeft als een HTML-formulier. Sommige validatieregels worden mogelijk niet ondersteund voor HTML-formulieren. Wanneer bijvoorbeeld een validatiepatroon van DD-MM-JJJJ wordt toegepast op een veld Date/Time
dat zich bevindt in een formulierontwerp dat als HTML-formulier wordt weergegeven, werkt het niet correct, zelfs als de datum correct is getypt. Dit validatiepatroon werkt echter goed voor formulieren die als PDF worden gegenereerd.
Zie Referentiehandleiding voor services voor AEM Forms voor meer informatie over de Forms-service.
Voer de volgende stappen uit om een HTML-formulier te genereren:
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 Forms Client API-object maken
Voordat u gegevens via programmacode kunt importeren in een PDF formClient API, moet u een service-client maken voor de integratie van formuliergegevens. Wanneer u een serviceclient maakt, definieert u verbindingsinstellingen die vereist zijn om een service aan te roepen.
Opties voor HTML-runtime instellen
U stelt HTML-runtime-opties in wanneer u een HTML-formulier rendert. U kunt bijvoorbeeld een werkbalk toevoegen aan een HTML-formulier, zodat gebruikers bestandsbijlagen kunnen selecteren op de clientcomputer of bestandsbijlagen kunnen ophalen die met het HTML-formulier worden gegenereerd. Een HTML-werkbalk is standaard uitgeschakeld. Als u een werkbalk wilt toevoegen aan een HTML-formulier, moet u via programmacode opties voor de runtime instellen. Een HTML-werkbalk bestaat standaard uit de volgende knoppen:
Home
: Koppelt naar de hoofdmap van de toepassing.Upload
: Biedt een gebruikersinterface voor het selecteren van bestanden die u wilt bijvoegen bij het huidige formulier.Download
: Biedt een gebruikersinterface voor het weergeven van de bijgevoegde bestanden.Wanneer een HTML-werkbalk op een HTML-formulier wordt weergegeven, kan een gebruiker maximaal tien bestanden selecteren die samen met de formuliergegevens moeten worden verzonden. Nadat de bestanden zijn verzonden, kan de Forms-service de bestanden ophalen.
Bij het weergeven van een formulier als HTML kunt u een user-agent-waarde opgeven. Een gebruiker-agent waarde verstrekt browser en systeeminformatie. Dit is een optionele waarde en u kunt een lege tekenreekswaarde doorgeven. De weergave van een HTML-formulier met de snelle start van de Java API laat zien hoe u een gebruikersagent-waarde kunt verkrijgen en gebruiken om een formulier te genereren als HTML.
HTTP-URL's waarnaar formuliergegevens worden verzonden, kunnen worden opgegeven door de doel-URL in te stellen met de Forms Service Client API of kunnen worden opgegeven in de knop Verzenden in het XDP-formulierontwerp. Als het doel-URL is opgegeven in het formulierontwerp, moet u geen waarde instellen met de Forms Service Client API.
Het weergeven van een HTML-formulier met een werkbalk is optioneel.
Als u een AHTML-formulier genereert, wordt u aangeraden geen werkbalk aan het formulier toe te voegen.
Een HTML-formulier renderen
Als u een HTML-formulier wilt genereren, moet u een formulierontwerp opgeven dat in Designer is gemaakt en als XDP-bestand is opgeslagen. U moet ook een transformatietype voor HTML selecteren. U kunt bijvoorbeeld het transformatietype HTML opgeven dat een dynamische HTML voor Internet Explorer 5.0 of hoger rendert.
Voor het weergeven van een HTML-formulier zijn ook waarden vereist, zoals URI-waarden die vereist zijn voor het weergeven van andere formuliertypen.
De formuliergegevensstroom naar de webbrowser van de client schrijven
Wanneer de Forms-service een HTML-formulier genereert, wordt een formuliergegevensstroom geretourneerd die u naar de webbrowser van de client moet schrijven. Wanneer het HTML-formulier naar de clientwebbrowser wordt geschreven, is het zichtbaar voor de gebruiker.
Zie ook
Een formulier weergeven als HTML met de Java API
Een formulier weergeven als HTML met de webservice-API
Inclusief AEM Forms Java-bibliotheekbestanden
Verbindingseigenschappen instellen
Interactieve PDF forms renderen
HTML Forms renderen met aangepaste werkbalken
Webtoepassingen maken die Forms renderen
Een HTML-formulier renderen met de Forms API (Java):
Projectbestanden opnemen
Neem client-JAR-bestanden, zoals adobe-forms-client.jar, op in het klassenpad van uw Java-project.
Een Forms Client API-object maken
ServiceClientFactory
-object dat verbindingseigenschappen bevat.FormsServiceClient
-object door de constructor ervan te gebruiken en het object ServiceClientFactory
door te geven.Opties voor HTML-runtime instellen
HTMLRenderSpec
-object met de constructor ervan.setHTMLToolbar
van het object HTMLRenderSpec
aan en geeft u een opsommingswaarde HTMLToolbar
door. Als u bijvoorbeeld een verticale HTML-werkbalk wilt weergeven, geeft u HTMLToolbar.Vertical
door.setLocale
van het object HTMLRenderSpec
aan en geeft u een tekenreekswaarde door die de landinstellingswaarde opgeeft. (Dit is een optionele instelling.)setOutputType
van het object HTMLRenderSpec
aan en geeft u OutputType.FullHTMLTags
door. (Dit is een optionele instelling.)Forms wordt niet met succes weergegeven in HTML wanneer de optie StandAlone
true
is en ApplicationWebRoot
verwijst naar een andere server dan de J2EE-toepassingsserver die als host fungeert voor AEM Forms (de waarde ApplicationWebRoot
wordt opgegeven met het URLSpec
-object dat wordt doorgegeven aan de methode FormsServiceClient
van het (Deprecated) renderHTMLForm
-object). Wanneer ApplicationWebRoot
* een andere server is van de server die als host fungeert voor AEM Forms, moet de waarde van de URI van de webhoofdmap in de beheerconsole worden ingesteld als de URI-waarde van de webtoepassing van het formulier. U doet dit door u aan te melden bij de beheerconsole, op Services > Forms te klikken en de Web Root URI in te stellen als https://server-name:port/FormServer. Sla vervolgens uw instellingen op.*
Een HTML-formulier renderen
Roep de methode (Deprecated) renderHTMLForm
van het object FormsServiceClient
aan en geef de volgende waarden door:
Applications/FormsApplication/1.0/FormsFolder/Loan.xdp
.TransformTo
die het HTML-voorkeurstype aangeeft. Als u bijvoorbeeld een HTML-formulier wilt genereren dat compatibel is met dynamische HTML voor Internet Explorer 5.0 of hoger, geeft u TransformTo.MSDHTML
op.com.adobe.idp.Document
dat gegevens bevat die met het formulier moeten worden samengevoegd. Als u geen gegevens wilt samenvoegen, geeft u een leeg com.adobe.idp.Document
-object door.HTMLRenderSpec
-object waarin de HTML-runtime-opties zijn opgeslagen.HTTP_USER_AGENT
opgeeft; bijvoorbeeld Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1; SV1; .NET CLR 1.1.4322)
.URLSpec
dat URI-waarden opslaat die vereist zijn om een HTML-formulier te genereren.java.util.HashMap
-object dat bestandsbijlagen opslaat. Dit is een optionele parameter en u kunt null
opgeven als u geen bestanden aan het formulier wilt koppelen.De methode (Deprecated) renderHTMLForm
retourneert een FormsResult
-object dat een formuliergegevensstroom bevat die naar de webbrowser van de client kan worden geschreven.
De formuliergegevensstroom naar de webbrowser van de client schrijven
com.adobe.idp.Document
-object door de methode getOutputContent
van het object aan te roepen.FormsResult
com.adobe.idp.Document
opgehaald door de methode getContentType
ervan aan te roepen.javax.servlet.http.HttpServletResponse
in door de methode setContentType
ervan aan te roepen en het inhoudstype van het object com.adobe.idp.Document
door te geven.javax.servlet.ServletOutputStream
-object dat wordt gebruikt om de formuliergegevensstroom naar de webbrowser van de client te schrijven door de methode javax.servlet.http.HttpServletResponse
van het object getOutputStream
aan te roepen.java.io.InputStream
-object door de methode getInputStream
van het object com.adobe.idp.Document
aan te roepen.read
van het object InputStream
aan te roepen en de bytearray als een argument door te geven.javax.servlet.ServletOutputStream
van het object write
aan om de gegevensstroom van het formulier naar de webbrowser van de client te verzenden. Geef de bytearray door aan de methode write
.Zie ook
Snel starten (SOAP-modus): HTML-formulieren renderen met de Java API
Inclusief AEM Forms Java-bibliotheekbestanden
Verbindingseigenschappen instellen
Een HTML-formulier renderen met de Forms API (webservice):
Projectbestanden opnemen
Een Forms Client API-object maken
Maak een FormsService
-object en stel de verificatiewaarden in.
Opties voor HTML-runtime instellen
HTMLRenderSpec
-object met de constructor ervan.setHTMLToolbar
van het object HTMLRenderSpec
aan en geeft u een opsommingswaarde HTMLToolbar
door. Als u bijvoorbeeld een verticale HTML-werkbalk wilt weergeven, geeft u HTMLToolbar.Vertical
door.setLocale
van het object HTMLRenderSpec
aan en geeft u een tekenreekswaarde door die de landinstellingswaarde opgeeft. Zie AEM Forms API Reference voor meer informatie.setOutputType
van het object HTMLRenderSpec
aan en geeft u OutputType.FullHTMLTags
door.Forms wordt niet met succes weergegeven in HTML wanneer de optie StandAlone
true
is en ApplicationWebRoot
verwijst naar een andere server dan de J2EE-toepassingsserver die als host fungeert voor AEM Forms (de waarde ApplicationWebRoot
wordt opgegeven met het URLSpec
-object dat wordt doorgegeven aan de methode FormsServiceClient
van het (Deprecated) renderHTMLForm
-object). Wanneer ApplicationWebRoot
* een andere server is van de server die als host fungeert voor AEM Forms, moet de waarde van de URI van de webhoofdmap in de beheerconsole worden ingesteld als de URI-waarde van de webtoepassing van het formulier. U doet dit door u aan te melden bij de beheerconsole, op Services > Forms te klikken en de Web Root URI in te stellen als https://server-name:port/FormServer. Sla vervolgens uw instellingen op. *
Een HTML-formulier renderen
Roep de methode (Deprecated) renderHTMLForm
van het object FormsService
aan en geef de volgende waarden door:
Applications/FormsApplication/1.0/FormsFolder/Loan.xdp
.TransformTo
die het HTML-voorkeurstype aangeeft. Als u bijvoorbeeld een HTML-formulier wilt genereren dat compatibel is met dynamische HTML voor Internet Explorer 5.0 of hoger, geeft u TransformTo.MSDHTML
op.BLOB
dat gegevens bevat die met het formulier moeten worden samengevoegd. Als u geen gegevens wilt samenvoegen, geeft u null
door. (Zie Forms vooraf vullen met stroombare layouts.)HTMLRenderSpec
-object waarin de HTML-runtime-opties zijn opgeslagen.HTTP_USER_AGENT
opgeeft; bijvoorbeeld Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1; SV1; .NET CLR 1.1.4322)
. U kunt een lege tekenreeks doorgeven als u deze waarde niet wilt instellen.URLSpec
dat URI-waarden opslaat die vereist zijn om een HTML-formulier te genereren. (Zie URI-waarden opgeven.)java.util.HashMap
-object dat bestandsbijlagen opslaat. Dit is een optionele parameter en u kunt null
opgeven als u geen bestanden aan het formulier wilt koppelen. (Zie Bestanden bijvoegen bij het formulier.)com.adobe.idp.services.holders.BLOBHolder
dat door de methode is gevuld. Met deze parameterwaarde wordt het gerenderde formulier opgeslagen.com.adobe.idp.services.holders.BLOBHolder
dat door de methode is gevuld. In deze parameter worden de XML-uitvoergegevens opgeslagen.javax.xml.rpc.holders.LongHolder
dat door de methode is gevuld. In dit argument wordt het aantal pagina's in het formulier opgeslagen.javax.xml.rpc.holders.StringHolder
dat door de methode is gevuld. In dit argument wordt de waarde van de landinstelling opgeslagen.javax.xml.rpc.holders.StringHolder
dat door de methode is gevuld. In dit argument wordt de gebruikte HTML-renderwaarde opgeslagen.com.adobe.idp.services.holders.FormsResultHolder
-object dat de resultaten van deze bewerking zal bevatten.Met de methode (Deprecated) renderHTMLForm
wordt het object com.adobe.idp.services.holders.FormsResultHolder
dat als laatste argumentwaarde is doorgegeven, gevuld met een formuliergegevensstroom die naar de webbrowser van de client moet worden geschreven.
De formuliergegevensstroom naar de webbrowser van de client schrijven
FormResult
-object door de waarde op te halen van het com.adobe.idp.services.holders.FormsResultHolder
-gegevenslid van het object.value
BLOB
-object dat formuliergegevens bevat door de methode getOutputContent
van het object FormsResult
aan te roepen.BLOB
opgehaald door de methode getContentType
ervan aan te roepen.javax.servlet.http.HttpServletResponse
in door de methode setContentType
ervan aan te roepen en het inhoudstype van het object BLOB
door te geven.javax.servlet.ServletOutputStream
-object dat wordt gebruikt om de formuliergegevensstroom naar de webbrowser van de client te schrijven door de methode javax.servlet.http.HttpServletResponse
van het object getOutputStream
aan te roepen.getBinaryData
van het object BLOB
aan te roepen. Deze taak wijst de inhoud van het FormsResult
voorwerp aan de byteserie toe.javax.servlet.http.HttpServletResponse
van het object write
aan om de gegevensstroom van het formulier naar de webbrowser van de client te verzenden. Geef de bytearray door aan de methode write
.Zie ook
AEM Forms aanroepen met Base64-codering