Återger Forms som HTML rendering-forms-as-html

Exempel och exempel i det här dokumentet gäller endast för AEM Forms i JEE-miljö.

Forms-tjänsten återger formulär som HTML som svar på en HTTP-begäran från en webbläsare. En fördel med att återge ett formulär som HTML är att den dator där klientwebbläsaren finns inte kräver Adobe Reader, Acrobat eller Flash Player (för formulärguider (borttagen)).

Om du vill återge ett formulär som HTML måste formulärdesignen sparas som en XDP-fil. En formulärdesign som sparas som en PDF-fil kan inte återges som HTML. När du utvecklar en formulärdesign i Designer som ska återges som HTML bör du tänka på följande kriterier:

HTML sidor html-pages

När en formulärdesign återges som ett HTML-formulär återges varje delformulär på andra nivån som en HTML-sida (panel). Du kan visa ett delformulärs hierarki i Designer. Underordnade delformulär som tillhör rotdelformuläret (standardnamnet för ett rotdelformulär är formulär1) är paneldelformulär. I följande exempel visas delformulären för en formulärdesign.

     form1
         Master Pages
         PanelSubform1
             NestedDynamicSubform
                 TextEdit1
         PanelSubform2
             TextEdit1
         PanelSubform3
             TextEdit1
         PanelSubform4
             TextEdit1

När formulärdesigner återges som HTML-formulär begränsas inte panelerna till någon viss sidstorlek. Om du har dynamiska delformulär bör de vara kapslade i paneldelformuläret. Dynamiska delformulär kan expandera till ett obegränsat antal HTML-sidor.

När ett formulär återges som ett HTML-formulär har sidstorlekar (som krävs för att numrera formulär som återges som PDF) ingen betydelse. Eftersom ett formulär med flödeslayout kan utvidgas till ett obegränsat antal HTML-sidor är det viktigt att undvika sidfötter på mallsidan. En sidfot under innehållsområdet på en mallsida kan skriva över HTML-innehåll som flödar förbi en sidgräns.

Du måste gå från panel till panel med metoderna xfa.host.pageUp och xfa.host.pageDown. Du ändrar sidor genom att skicka ett formulär till Forms och låta Forms-tjänsten återge formuläret till klientenheten, vanligtvis en webbläsare.

.fsc-ds-ssb: Den här formatmallen kan användas om det finns ett tomt teckenfält.

.fsc-ds-ssv: Den här formatmallen kan användas om det finns ett giltigt signaturfält.

.fsc-ds-ssc: Den här formatmallen kan användas om det finns ett giltigt signaturfält men data har ändrats.

.fsc-ds-ssi: Den här formatmallen kan användas om det finns ett ogiltigt teckenfält.

.fsc-ds-popup-bg: Den här formatmallsegenskapen används inte.

.fsc-ds-popup-btn: Den här formatmallsegenskapen används inte.

Köra skript running-scripts

En formulärförfattare anger om ett skript ska köras på servern eller på klienten. Forms-tjänsten skapar en distribuerad händelsebearbetningsmiljö för att köra formulärintelligens som kan distribueras mellan klienten och servern med attributet runAt. Mer information om det här attributet och hur du skapar skript i formulärdesigner finns i Forms Designer

Forms-tjänsten kan köra skript medan formuläret återges. Det innebär att du kan förifylla ett formulär med data genom att ansluta till en databas eller till webbtjänster som kanske inte är tillgängliga på klienten. Du kan också ange att en knapps Click-händelse ska köras på servern så att klienten skickar data till servern. Detta gör att klienten kan köra skript som kan kräva serverresurser, t.ex. en företagsdatabas, medan en användare interagerar med ett formulär. För HTML-formulär kan formulärskript endast köras på servern. Därför måste du markera de här skripten så att de körs vid server eller both.

Du kan utforma formulär som rör sig mellan sidor (paneler) genom att anropa metoderna xfa.host.pageUp och xfa.host.pageDown. Det här skriptet placeras i en knapps Click-händelse och attributet runAt är inställt på Both. Anledningen till att du väljer Both är att Adobe Reader eller Acrobat (för formulär som återges som PDF) kan ändra sidor utan att gå till servern, och HTML kan ändra sidor genom att skicka beskärningsdata till servern. Det innebär att ett formulär skickas till Forms och att ett formulär återges som HTML när den nya sidan visas.

Vi rekommenderar att du inte ger skriptvariabler och formulärfält samma namn, till exempel objekt. I vissa webbläsare, t.ex. Internet Explorer, går det inte att initiera en variabel med samma namn som ett formulärfält, vilket resulterar i ett skriptfel. Det är god praxis att ge formulärfält och skriptvariabler olika namn.

När du återger HTML-formulär som innehåller både sidnavigeringsfunktioner och formulärskript (t.ex. förutsätter att ett skript hämtar fältdata från en databas varje gång formuläret återges), ska du se till att formulärskriptet är i händelsen form:calculate i stället för i formen:readyevent.

Formulärskript som finns i formen:ready-händelsen körs bara en gång under den inledande återgivningen av formuläret och inte körs för efterföljande sidhämtningar. Händelsen form:calculate körs däremot för varje sidnavigering där formuläret återges.

Du kan anropa egna skript innan du skickar in ett formulär. Den här funktionen fungerar i alla tillgängliga webbläsare. Den kan dock bara användas när användare återger det HTML-formulär som har egenskapen Output Type inställd på Form Body. Det fungerar inte när Output Type är Full HTML. Mer information om hur du konfigurerar den här funktionen finns i Konfigurera formulär i administrationshjälpen.

Definiera först en callback-funktion som anropas innan formuläret skickas, där funktionens namn är _user_onsubmit. Det antas att funktionen inte genererar något undantag, eller att undantaget ignoreras om det gör det. Du rekommenderas att placera JavaScript-funktionen i huvudsektionen i html, men du kan deklarera den var som helst före slutet av skripttaggarna som innehåller xfasubset.js.

När formserver återger en XDP-fil som innehåller en nedrullningsbar lista skapas även två dolda textfält förutom att listrutan skapas. Dessa textfält lagrar data i den nedrullningsbara listan (ett lagrar alternativens visningsnamn och andra lagrar alternativens värden). Därför skickas alla data i den nedrullningsbara listan varje gång en användare skickar formuläret. Om du inte vill skicka så mycket data varje gång kan du skriva ett eget skript som inaktiverar det. Till exempel: Listrutans namn är drpOrderedByStateProv och det omsluts av delformulärsrubriken. HTML-indataelementets namn blir header[0].drpOrderedByStateProv[0]. Namnet på de dolda fält som lagrar och skickar data i listrutan har följande namn: header[0].drpOrderedByStateProv_DISPLAYITEMS_[0] header[0].drpOrderedByStateProv_VALUEITEMS_[0]

Du kan inaktivera dessa indataelement på följande sätt om du inte vill publicera data. 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-delmängder xfa-subsets

När du skapar formulärdesigner som ska återges som HTML måste du begränsa skripten till XFA-delmängden för skript i JavaScript-språket.

Skript som körs på klienten eller körs både på klienten och servern måste skrivas i XFA-delmängden. Skript som körs på servern kan använda den fullständiga XFA-skriptmodellen och även FormCalc. Mer information om hur du använder JavaScript finns i Forms Designer.

När du kör skript på klienten kan bara den aktuella panelen som visas använda skript. Du kan till exempel inte skriva skript mot fält som finns på panel A när panel B visas. När du kör skript på servern är alla paneler tillgängliga.

Var försiktig när du använder SOM-uttryck (Scripting Object Model) i skript som körs på klienten. Endast en förenklad delmängd av SOM-uttryck stöds av skript som körs på klienten.

Tidsinställning för händelser event-timing

XFA-delmängden definierar XFA-händelser som mappas till HTML-händelser. Det finns en liten skillnad i beteendet när det gäller tidpunkten för beräkning och validering av händelser. I en webbläsare körs en fullständig calculate-händelse när du avslutar ett fält. Beräkningshändelser körs inte automatiskt när du ändrar ett fältvärde. Du kan tvinga fram en calculate-händelse genom att anropa metoden xfa.form.execCalculate.

I en webbläsare körs valideringshändelser bara när ett fält avslutas eller när ett formulär skickas. Du kan tvinga fram en validate-händelse med metoden xfa.form.execValidate.

Forms som visas i en webbläsare (till skillnad från Adobe Reader eller Acrobat) följer XFA null-testet (fel eller varningar) för obligatoriska fält.

Mer information om ett null-test finns i Forms Designer.

Formulärknappar form-buttons

När du klickar på en skicka-knapp skickas formulärdata till Forms-tjänsten och anger att formulärbearbetningen är slutförd. Händelsen preSubmit kan ställas in för att köras på klienten eller servern. Händelsen preSubmit körs före formuläröverföringen om den är konfigurerad att köras på klienten. Annars körs händelsen preSubmit på servern när formuläret skickas. Mer information om händelsen preSubmit finns i Forms Designer.

Om en knapp inte har något klientskript kopplat till sig, skickas data till servern, beräkningar utförs på servern och HTML-formuläret genereras om. Om en knapp innehåller ett klientskript skickas inga data till servern och klientskriptet körs i webbläsaren.

HTML 4.0 html-4-0-web-browser

En webbläsare som bara har stöd för HTML 4.0 kan inte hantera XFA-deluppsättningens klientskriptmodell. När du skapar en formulärdesign som ska fungera i både HTML 4.0 och MSDHTML eller CSS2HTML kommer ett skript som är markerat för att köras på klienten att köras på servern. Anta till exempel att en användare klickar på en knapp som finns i ett formulär som visas i webbläsaren HTML 4.0. I sådana fall skickas formulärdata till servern där skriptet på klientsidan körs.

Vi rekommenderar att du placerar formulärlogiken i calculate-händelser som körs på servern i HTML 4.0 och på klienten för MSDHTML eller CSS2HTML.

Underhåll presentationsändringar maintaining-presentation-changes

När du förflyttar dig mellan HTML-sidor (paneler) behålls endast datastatus. Inställningar som bakgrundsfärg eller obligatoriska fältinställningar bevaras inte (om de skiljer sig från de ursprungliga inställningarna). Om du vill behålla presentationstillståndet måste du skapa fält (vanligen dolda) som representerar presentationstillståndet för fält. Om du lägger till ett skript i ett fälts Calculate-händelse som ändrar presentationen baserat på dolda fältvärden, kan du bevara presentationstillståndet när du går fram och tillbaka mellan HTML-sidor (paneler).

Följande skript bevarar fillColor för ett fält baserat på värdet hiddenField. Anta att det här skriptet finns i ett fälts Calculate-händelse.

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

Signera HTML-formulär digitalt digitally-signing-html-forms

Du kan inte signera ett HTML-formulär som innehåller ett fält för elektronisk underskrift om formuläret återges som en av följande HTML-omformningar:

Mer information om att signera ett dokument digitalt finns i Signera och certifiera dokument digitalt

Rendera ett hjälpmedelsanpassat XHTML-formulär rendering-an-accessibility-guidelines-compliant-xhtml-form

Du kan återge ett fullständigt HTML-formulär som är kompatibelt med riktlinjerna för hjälpmedel. Det innebär att formuläret återges med fullständiga HTML-taggar i motsats till HTML som återges med body-taggar (inte en fullständig HTML-sida).

Validerar formulärdata validating-form-data

Vi rekommenderar att du begränsar användningen av valideringsregler för formulärfält när du återger formuläret som ett HTML-formulär. Vissa valideringsregler kanske inte stöds för HTML-formulär. Om du till exempel använder valideringsmönstret MM-DD-YYY för ett Date/Time-fält i en formulärdesign som återges som ett HTML-formulär, fungerar det inte korrekt, även om datumet har angetts korrekt. Det här valideringsmönstret fungerar emellertid korrekt för formulär som återges som PDF.

Sammanfattning av steg summary-of-steps

Så här återger du ett HTML-formulär:

Inkludera projektfiler

Inkludera nödvändiga filer i utvecklingsprojektet. Om du skapar ett klientprogram med Java, inkluderar du de JAR-filer som behövs. Om du använder webbtjänster måste du inkludera proxyfilerna.

Skapa ett Forms Client API-objekt

Innan du programmässigt kan importera data till ett PDF formClient-API måste du skapa en tjänstklient för integrering av formulärdata. När du skapar en tjänstklient definierar du de anslutningsinställningar som krävs för att anropa en tjänst.

Ange körningsalternativ för HTML

Du anger körningsalternativ för HTML när du återger ett HTML-formulär. Du kan till exempel lägga till ett verktygsfält i ett HTML-formulär så att användare kan välja bifogade filer på klientdatorn eller hämta bifogade filer som återges med formuläret HTML. Som standard är verktygsfältet HTML inaktiverat. Om du vill lägga till ett verktygsfält i ett HTML-formulär måste du programmässigt ange körningsalternativ. Som standard består verktygsfältet HTML av följande knappar:

När verktygsfältet HTML visas i ett HTML-formulär kan användaren välja högst tio filer att skicka tillsammans med formulärdata. När filerna har skickats kan Forms-tjänsten hämta filerna.

När du återger ett formulär som HTML kan du ange ett användaragentvärde. Ett användaragentvärde ger information om webbläsare och system. Detta är ett valfritt värde och du kan skicka ett tomt strängvärde. När du återger ett HTML-formulär med Java API-snabbstarten visas hur du får ett användaragentvärde och använder det för att återge ett formulär som HTML.

HTTP-URL:er dit formulärdata skickas kan anges genom att ange mål-URL:en med hjälp av Forms Service Client-API:t eller anges i knappen Skicka i XDP-formulärdesignen. Om mål-URL:en anges i formulärdesignen ska du inte ange något värde med Forms Service Client API.

Återge ett HTML-formulär

Om du vill återge ett HTML-formulär anger du en formulärdesign som har skapats i Designer och sparats som en XDP-fil. Markera en omformningstyp för HTML. Du kan till exempel ange HTML-omformningstypen som återger ett dynamiskt HTML för Internet Explorer 5.0 eller senare.

Återgivning av ett HTML-formulär kräver också värden, t.ex. URI-värden som krävs för att återge andra formulärtyper.

Skriv formulärdataströmmen till klientwebbläsaren

När Forms-tjänsten återger ett HTML-formulär returneras ett formulärdataflöde som du måste skriva till klientens webbläsare. När formuläret HTML skrivs till webbläsaren visas det för användaren.

Se även

Återge ett formulär som HTML med Java API

Återge ett formulär som HTML med hjälp av webbtjänstens API

Inkludera AEM Forms Java-biblioteksfiler

Ange anslutningsegenskaper

Snabbstart för Forms Service API

Återger interaktiv PDF forms

Återge HTML Forms med anpassade verktygsfält

Skapa webbprogram som återger Forms

Återge ett formulär som HTML med Java API render-a-form-as-html-using-the-java-api

Återge ett HTML-formulär med Forms API (Java):

Se även

Återger Forms som HTML

Snabbstart (SOAP): Återge ett HTML-formulär med Java API

Inkludera AEM Forms Java-biblioteksfiler

Ange anslutningsegenskaper

Återge ett formulär som HTML med hjälp av webbtjänstens API render-a-form-as-html-using-the-web-service-api

Återge ett HTML-formulär med Forms API (webbtjänst):

Se även

Återger Forms som HTML

Anropa AEM Forms med Base64-kodning