Forms renderen als HTML rendering-forms-as-html

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:

HTML pagina's html-pages

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 tot 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 tot 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 opdracht xfa.host.pageUp en xfa.host.pageDown methoden. 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.

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

Scripts uitvoeren running-scripts

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 tussen de client en de server kan worden gedistribueerd met behulp van de runAt kenmerk. Voor informatie over dit kenmerk of het maken van scripts in formulierontwerpen raadpleegt u Forms Designer

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 knoppen instellen Click gebeurtenis die op de server moet worden uitgevoerd zodat de client gegevens voor retournering naar de server doorvoert. 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 server of both.

U kunt formulieren ontwerpen die tussen pagina's (deelvensters) bewegen door xfa.host.pageUp en xfa.host.pageDown methoden. Dit script wordt in de knop geplaatst Click en de runAt kenmerk is ingesteld op Both. De reden die u kiest Both is zo dat Adobe Reader of Acrobat (voor formulieren die worden weergegeven als PDF) pagina's kan wijzigen zonder naar de server te gaan. HTML-formulieren kunnen pagina's 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 paginanavigatiefuncties als formulierscripts bevatten (bijvoorbeeld, neem aan dat een script veldgegevens ophaalt 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.

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 met de bijbehorende Output Type eigenschap ingesteld op Form Body. Het werkt niet als de Output Type is Full HTML. 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 u het formulier verzendt, waarbij de naam van de functie _user_onsubmit. 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 omvatten xfasubset.js.

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 de subformulierkoptekst wordt ingepakt. De naam van het HTML-invoerelement wordt 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;
    }

XFA-subsets xfa-subsets

Wanneer u formulierontwerpen maakt die moeten worden weergegeven als HTML, 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. Voor informatie over het gebruik van JavaScript raadpleegt u Forms Designer.

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.

Gebeurtenistiming event-timing

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 Calculate-gebeurtenis afdwingen door de xfa.form.execCalculate methode.

In een webbrowser worden validatiegebeurtenissen alleen uitgevoerd wanneer een veld wordt gesloten of een formulier wordt verzonden. U kunt een validatiegebeurtenis afdwingen met de opdracht xfa.form.execValidate methode.

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.

Voor meer informatie over een ongeldige test, zie Forms Designer.

Formulierknoppen form-buttons

Als u op een knop Verzenden klikt, worden formuliergegevens naar de Forms-service verzonden en wordt het einde van de formulierverwerking aangegeven. De preSubmit -gebeurtenis kan zo worden ingesteld dat deze op de client of server wordt uitgevoerd. De preSubmit De gebeurtenis wordt uitgevoerd voordat het formulier wordt verzonden als dit is geconfigureerd om op de client te worden uitgevoerd. Anders wordt preSubmit De gebeurtenis wordt tijdens het verzenden van het formulier op de server uitgevoerd. Voor meer informatie over de preSubmit gebeurtenis, zie Forms Designer.

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.

HTML 4.0 webbrowser html-4-0-web-browser

Een webbrowser die alleen HTML 4.0 ondersteunt, kan het scriptmodel van de XFA-subset voor 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 webbrowser van HTML 4.0 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, die op de server in HTML 4.0 en op de client voor MSDHTML of CSS2HTML worden uitgevoerd.

Presentatiewijzigingen behouden maintaining-presentation-changes

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 opdrachten van een veld Calculate Als u de presentatie wijzigt 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 het fillColor van een veld op basis van de waarde van hiddenField. Stel dat dit script zich in de map van een veld bevindt Calculate gebeurtenis.

     If (hiddenField.rawValue == 1)
         this.fillColor = "255,0,0"
     else
         this.fillColor = "0,255,0"

HTML-formulieren digitaal ondertekenen digitally-signing-html-forms

U kunt geen HTML-formulier ondertekenen dat een digitaal handtekeningveld bevat als het formulier wordt weergegeven als een van de volgende HTML-transformaties:

Voor informatie over het digitaal ondertekenen van een document raadpleegt u Documenten digitaal ondertekenen en certificeren

Een XHTML-formulier dat voldoet aan toegankelijkheidsrichtlijnen weergeven rendering-an-accessibility-guidelines-compliant-xhtml-form

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

Formuliergegevens valideren validating-form-data

Het wordt aanbevolen om het gebruik van validatieregels voor formuliervelden te beperken bij het weergeven van het formulier 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 Date/Time Het veld dat zich bevindt in een formulierontwerp dat wordt weergegeven als een HTML-formulier, werkt niet correct, zelfs niet als de datum op de juiste wijze is ingevoerd. Dit validatiepatroon werkt echter goed voor formulieren die worden weergegeven als PDF.

Overzicht van de stappen summary-of-steps

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 voor de integratie van formuliergegevens maken. Wanneer u een serviceclient maakt, definieert u verbindingsinstellingen die vereist zijn om een service aan te roepen.

Opties voor HTML bij uitvoering instellen

U stelt HTML-uitvoeringsopties in wanneer u een HTML-formulier weergeeft. 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 werkbalk HTML is standaard uitgeschakeld. Als u een werkbalk wilt toevoegen aan een HTML-formulier, moet u via programmacode uitvoeringsopties instellen. Een werkbalk HTML bestaat standaard uit de volgende knoppen:

Wanneer een werkbalk HTML 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 gebruikersagent-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 behulp van de Java API Quick start laat zien hoe u een gebruikersagent-waarde ophaalt en gebruikt 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.

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 HTML selecteren. U kunt bijvoorbeeld het transformatietype HTML opgeven waarmee een dynamische HTML wordt weergegeven voor Internet Explorer 5.0 of hoger.

Voor het weergeven van een HTML-formulier zijn ook waarden vereist, zoals URI-waarden die vereist zijn om andere formuliertypen te genereren.

De formuliergegevensstroom naar de webbrowser van de client schrijven

Wanneer de Forms-service een HTML-formulier weergeeft, wordt een formuliergegevensstroom geretourneerd die u naar de webbrowser van de client moet schrijven. Wanneer het formulier naar de clientwebbrowser wordt geschreven, is het HTML-formulier zichtbaar voor de gebruiker.

Zie ook

Een formulier weergeven als HTML met de Java API

Een formulier als HTML weergeven met de API voor webservices

Inclusief AEM Forms Java-bibliotheekbestanden

Verbindingseigenschappen instellen

Forms Service API Quick Start

Interactieve PDF forms renderen

HTML Forms renderen met aangepaste werkbalken

Webtoepassingen maken die Forms renderen

Een formulier weergeven als HTML met de Java API render-a-form-as-html-using-the-java-api

Een HTML-formulier renderen met de Forms API (Java):

Zie ook

Forms renderen als HTML

Snel starten (SOAP-modus): Een HTML-formulier weergeven met de Java API

Inclusief AEM Forms Java-bibliotheekbestanden

Verbindingseigenschappen instellen

Een formulier als HTML weergeven met de API voor webservices render-a-form-as-html-using-the-web-service-api

Een HTML-formulier renderen met de Forms API (webservice):

Zie ook

Forms renderen als HTML

AEM Forms aanroepen met Base64-codering