Erstellen von HTML-Formularen

Wenn ein Formularentwurf Teilformulare enthält, die erweitert werden, lässt sich kaum vorhersehen, wie viele Seiten im Formular zur Laufzeit ausgegeben werden. Die Seitengrößeneinstellung wird für den Seitenumbruch bei PDF-Formularen verwendet, doch bei der Wiedergabe eines HTML-Formulars wird sie ignoriert, da HTML-Seiten beliebig lang sein können.

Um ein mehrseitiges HTML-Formular zu erzielen, können Sie Ihrem Formularentwurf ein Teilformular auf Seitenniveau hinzufügen. Sie benötigen für jede Seite, die im Formular wiedergegeben werden soll, ein Teilformular. Für Formulare mit flexiblen Elementen sollte jedes Teilformular mit flexiblem Inhalt innerhalb eines Teilformulars auf Seitenniveau verschachtelt sein. Wenn das Formular dann wiedergegeben wird, werden alle Inhalte, die zum gleichen Teilformular auf Seitenniveau gehören, auf derselben HTML-Seite angezeigt.

Betrachten Sie zum Beispiel den Formularentwurf in der folgenden Abbildung. Dieser Formularentwurf enthält drei Teilformulare auf Seitenniveau: „Subform_Page0“, „Subform_Page1“ und „Subform_LastPage“. Wenn Forms  ein HTML-Formular auf Basis dieses Formularentwurfs wiedergibt, wird automatisch für jedes Teilformular auf Seitenniveau eine HTML-Seite erstellt.

A.

„Subform_Page0“ positioniert Inhalt und ist so eingerichtet, dass seine Objekte einmal auf der ersten Seite des Formulars unter Verwendung des Layouts der Masterseite „Seite1“ angezeigt wird.

B.

„Subform_Page1“ enthält ein Teilformular mit fließendem Inhalt. „Expanding_subform“ kann seine Objekte als Reaktion auf zusammengeführte Daten beliebig oft wiedergeben. Der Inhalt von „Subform_Page1“ wird auf einer oder mehreren Seiten unter Verwendung des Layouts der Masterseite „Page2_etc“ angezeigt.

C.

„Subform_LastPage“ positioniert Inhalt und ist so eingerichtet, dass seine Objekte auf der letzten wiedergegebenen Seite unter Verwendung des Layouts der Masterseite „Seite3“ angezeigt werden.

Wenn Forms  das HTML-Formular zur Laufzeit wiedergibt, wird das erste Teilformular auf Seitenniveau auf der ersten Seite angezeigt. Für den Zweck dieses Beispiels kann die erste Seite ähnlich wie die hier gezeigte Seite aussehen. Beachten Sie, dass die Schaltfläche „Nächste Seite“ eingefügt werden muss, um Benutzern den Wechsel zur nächsten Seite des Formulars zu ermöglichen.

Vorausgesetzt, dass mindestens ein Datensatz zum Zusammenführen mit „Expanding_subform“ zur Laufzeit verfügbar ist, kann die zweite Seite ähnlich aussehen wie die folgende Beispielseite. Wieder wird eine „Nächste Seite“-Schaltfläche benötigt, damit Benutzer zur nächsten Seite des Formulars wechseln können. Sie sollten Ihrem Formular außerdem eine Schaltfläche „Vorherige Seite“ hinzufügen.

Das dritte Teilformular auf Seitenniveau, „Subform_LastPage“, wird auf der letzten Seite des wiedergegebenen Formulars angezeigt. In diesem Beispiel wird Benutzern auf der letzten Seite für das Ausfüllen des Formulars gedankt und es wird eine Schaltfläche für die Übermittlung der eingegebenen Daten an Forms angezeigt.

Weitere Informationen zum Schreiben eines Skripts, das Benutzern den Wechsel zwischen HTML-Seiten ermöglicht, finden Sie unter Schreiben von Skripten für die Handhabung von HTML-Seiten.

Die folgenden Punkte sollen Ihnen bei der Erstellung von HTML-Formularen helfen, die visuell ansprechend und leicht lesbar sind:

• Verwenden Sie keine Objektbegrenzungseigenschaften, um Linien, Felder oder Raster auf dem Formular zu zeichnen. In einigen Browsern werden die Ränder vielleicht anders dargestellt als in der Designer-Vorschau. Die Objekte erscheinen eventuell übereinander oder schieben andere Objekte von ihren vorgesehenen Positionen.

• Wenn Benutzer Microsoft Internet Explorer verwenden, können Sie den Hintergrund des Formulars anhand von Linien, Rechtecken und Kreisen gestalten. Alle anderen Webbrowser unterstützen nur vertikale und horizontale Linien, wodurch Rechtecke und Kreise im Formularentwurf zur Laufzeit nicht angezeigt werden.

• Verwenden Benutzer Opera-Browser, erstellen Sie Felder, die etwas größer sind, als Sie es eigentlich möchten. Felder haben in Opera immer einen vertieften inneren Rand. Die von Ihnen gewählten Begrenzungsattribute werden außerhalb dieses Rands platziert. Da der vertiefte Rand im Feld Raum einnimmt, wird der ausfüllbare Bereich verringert.

• Erstellen Sie statischen Text etwas größer als es erforderlich scheint, um den Text unterzubringen. Designer und Acrobat verwenden unter Umständen andere Kerning-Einstellungen als ein bestimmter Webbrowser, und einige Textstellen werden möglicherweise nicht korrekt angezeigt.

Beim Hinzufügen von Bildern zu Formularentwürfen, die im HTML-Format ausgegeben werden, sollten Sie folgende Punkte beachten.

Unterstützte Bildformate

Sie können jede Bilddatei (außer animierte GIF-Dateien) einfügen. Die Bilddateien unterliegen den Beschränkungen der Webbrowser, in denen Benutzer die HTML-Formulare anzeigen.

Hinweis: Denken Sie daran, dass Internet Explorer die Kombination aus Schaltflächen- und Bildobjekten anders als andere Webbrowser verarbeitet. Beispiel: Wenn Sie ein Schaltflächenobjekt mit einem angepassten transparenten Erscheinungsbild erstellen und auf einem Bildobjekt platzieren, gibt Internet Explorer den resultierenden HTML-Code eventuell nicht ordnungsgemäß wieder. Die Benutzer können in diesem Fall nicht mit der Maus auf die Schaltfläche klicken. Siehe Webbrowser-Beschränkungen umgehen.

Betten Sie keine Bilder in das Formular ein.

Forms  bietet keine Unterstützung für eingebettete Bilder. Verwenden Sie stattdessen relative Pfadnamen, um Bilddateien einzufügen. Beispielsweise kann der Pfad relativ zum Stammverzeichnis für Formulare in Forms  sein (standardmäßig der als Formular-Repository vorgesehene Ordner). Der Bildordner im folgenden Pfad befindet sich auf der gleichen Ebene wie der Formularordner:

../images/graphic.jpg

Wenn Sie damit rechnen, dass einige Benutzer Browser mit eingeschränkter Funktionalität verwenden, sollten Sie vom kleinsten gemeinsamen Nenner ausgehen und Ihre Formulare entsprechend erstellen. Wenn Ihre Organisation jedoch Browser verwendet, die XHTML unterstützen, stehen Ihnen mehr Optionen für die Erstellung Ihres Formularentwurfs zur Verfügung.

Berücksichtigen Sie bei der Erstellung von Formularen, die in unterschiedlichen Browsern angezeigt werden, folgende Punkte:

• Geben Sie eine Seitengröße an, um sicherzustellen, dass die HTML4-Konvertierung (für Netscape Navigator 4.7.x) alle statischen Objekte ordnungsgemäß anzeigt. Andernfalls wird für die Felder nur bei Wiedergabe des Formulars genügend Platz reserviert.

• Lassen Sie oben und links auf dem Formular einen mindestens 1/4-Zoll breiten Rand. Elemente, die oberhalb und links dieses Randes liegen, sind nicht sichtbar.

• Objekte oder Teile von Objekten, die auf negativen Rasterkoordinaten gezeichnet wurden, werden nicht angezeigt. Wenn Sie etwa ein Objekt von der vertikalen Rasterkoordinate -0,50 aus zeichnen, wird der Teil des Objekts, der zwischen -0,50 und der inneren Kante eines 1/4-Zoll-Randes liegt, nicht angezeigt.

• Lassen Sie um die Felder herum genügend Platz, um visuelle Einbußen in einem Browser mit stark eingeschränkter Funktionalität zu kompensieren. Beispielsweise werden in einigen Browsern Kontrollkästchen und Optionsfelder größer angezeigt, als sie konzipiert wurden.

• Beim Anzeigen des Formulars in einem Browser mit stark eingeschränkter Funktionalität kann jede Linksausrichtung von Daten verloren gehen, insbesondere, wenn Benutzer die mit ihren Browsern verknüpften Standardschriftarten ändern.

• Internet Explorer verarbeitet die Kombination aus Schaltflächen- und Bildobjekten anders als andere Webbrowser. Beispiel: Wenn Sie ein Schaltflächenobjekt mit einem angepassten transparenten Erscheinungsbild erstellen und auf einem Bildobjekt platzieren, gibt Internet Explorer den resultierenden HTML-Code eventuell nicht ordnungsgemäß wieder. Die Benutzer können in diesem Fall nicht mit der Maus auf die Schaltfläche klicken. Sie können jedoch mit der Tabulatortaste zur Schaltfläche wechseln und die Auswahl mit der Eingabetaste oder Leertaste bestätigen. Dieser Verarbeitungsfehler tritt auf, weil die Größe des Schaltflächenobjekts von der Länge seiner Beschriftung abhängig ist. Der Leerraum im Beschriftungsbereich muss ausreichend groß sein, so dass die Schaltflächengröße die Bildgröße übersteigt. Beheben Sie das Problem, indem Sie den Beschriftungstext mit ausreichend Leerstellen ersetzen, damit die Benutzer mit der Maus auf die Schaltfläche klicken können.

Um die Funktion Ihres Formularentwurfs mit Forms zu testen und Befehlsschaltflächen im Formularentwurf korrekt einzurichten, muss Ihnen die URL bekannt sein, die mit den Anfragen an Forms  verknüpft ist. Der Entwickler der benutzerdefinierten Anwendung kennt die URL.

Zum Anzeigen einer HTML-Formularvorschau müssen Sie den Formularentwurf für Forms verfügbar machen, damit der Formularentwurf gespeichert werden kann. Dann können Sie das Formular über die mit Forms verknüpfte URL anfordern. Verwenden Sie einen Webbrowser oder eine Zielclientanwendung wie etwa ein Sprachausgabeprogramm, um das Formular zu öffnen.

Sie können Berechnungen und Skripten in einen Formularentwurf einbetten, um Berechnungen, Methoden oder Operationen auszuführen, wenn Objektereignisse zur Laufzeit auftreten. Beispielsweise tritt ein Ereignis zur Laufzeit ein, wenn der Benutzer die durch das Ereignis angegebene Aktion durchführt. Durch Definieren eines Skripts können Sie eines der vom Objekt unterstützten Verfahren aufrufen und Eigenschaften prüfen oder festlegen.

In Designer sind Skripten und Berechnungen standardmäßig für eine Ausführung auf dem Client-Gerät vorgesehen. Der standardmäßige Verarbeitungsort wird auf der Registerkarte „Vorschau“ des Dialogfelds „Formulareigenschaften“ („Datei“ > „Formulareigenschaften“) definiert. Um den standardmäßigen Verarbeitungsort zu ändern, können Sie explizit einen anderen Verarbeitungsort angeben, indem Sie die Option „Ausführen am“ im Skript-Editor verwenden, wenn Sie ein Skript oder eine Berechnung an ein Objekt anhängen.

Wenn Sie Forms  verwenden, kann die Verarbeitung auf dem Client und/oder auf dem Server stattfinden. Wenn Sie angeben, dass ein Skript/eine Berechnung auf dem Client und auf dem Server ausgeführt werden soll, kann es vorkommen, dass sowohl der Client als auch der Server versuchen, das Skript/die Berechnung auszuführen. Von Forms  wird stets versucht, das Skript bzw. die Berechnung auszuführen, wenn der Client nicht dazu in der Lage ist. Wenn Skripten/Berechnungen für eine Ausführung auf dem Server vorgesehen sind, führt Forms  die Skripten und/oder Berechnungen aus, führt die Ergebnisse im Formular zusammen und gibt beides an den Client zurück.

Client-seitige Skripten und Berechnungen werden auf dem Client-Gerät ausgeführt. Beim Erstellen von PDF-Formularen für Acrobat oder Adobe Reader muss die gesamte Verarbeitung auf dem Client erfolgen. Wenn jedoch der Client das Skript oder die Berechnung nicht ausführen kann, versucht Forms , das Skript oder die Berechnung auszuführen.

Um ein clientseitiges Skript in einem HTML-Formular erfolgreich auszuführen, müssen bestimmte Bedingungen erfüllt sein:

• Bei der Clientanwendung muss es sich um Microsoft Internet Explorer 5.x, Netscape 6.0 oder höher oder Opera 5 oder höher handeln.

• JavaScript kann nur zum Schreiben von Skripten verwendet werden. (Sie können keine FormCalc-Berechnungen in den Formularentwurf einbeziehen.)

• JavaScript muss in der Clientanwendung aktiviert sein.

Die Verarbeitung kann auf dem Client, Server oder auf beiden ausgeführt werden. Skripten und Berechnungen verhalten sich bei Ausführung auf dem Client anders als auf dem Server.

Wenn Sie einen einzelnen Formularentwurf verwenden, um sowohl PDF-Formulare als auch HTML-Formulare zu erstellen, werden Ihre Skripten möglicherweise einen Teil der unterstützten Eigenschaften, Methoden und Ereignisse referenzieren.

Die folgenden Tabellen fassen zusammen, welche Client-Anwendungen die verschiedenen Eigenschaften, Methoden und Ereignisse erkennen, die Sie in client- und/oder serverseitigen Skripten referenzieren können.

Hinweis 1: Bei Listenfeldern gibt „formattedValue“ nicht den Anzeigetext zurück.

Hinweis 2: Das „click“-Ereignis wird für Senden-Schaltflächen in PDF- oder HTML-Formularen nicht unterstützt. Verwenden Sie stattdessen „preSubmit“.

Hinweis 3: Das ScriptObject-Objekt kann mit jedem anderen Skript erstellt und verwendet werden. Siehe Erstellen eines Skriptobjekts.

Hinweis 1: Bei Listenfeldern gibt „formattedValue“ nicht den Anzeigetext zurück.

Hinweis 2: Das „click“-Ereignis wird für Senden-Schaltflächen in PDF-Formularen nicht unterstützt. Verwenden Sie stattdessen „preSubmit“.

Hinweis 3: Das ScriptObject-Objekt kann mit jedem anderen Skript erstellt und verwendet werden. Siehe Erstellen eines Skriptobjekts.

Eine vereinfachte Teilmenge von Ausdrücken der Referenzsyntax wird von HTML-Clients unterstützt:

• FormCalc-Berechnungen sind in HTML-Browsern nicht gültig und werden vor der Wiedergabe in HTML aus dem Formular entfernt.

• Die Syntax der Auslassungspunkte (...) wird nicht unterstützt.

• Beim Schreiben von clientseitigen Skripten für HTML-Formulare müssen Sie den JavaScript-Ausdruck „resolveNode“ verwenden, um Nodes in der Hierarchie aufzufinden. Das Skript kann die Hierarchie nicht unter Verwendung der Objektnotation durchlaufen. Beispielsweise wird der folgende Ausdruck nicht unterstützt:

      xfa.form.subform1.TextEdit1

Der folgende Ausdruck wird unterstützt:

xfa.form.resolveNode("subform1.TextEdit1")

Nicht qualifizierte Feldreferenzen können verwendet werden, um nebengeordnete Felder in der Hierarchie aufzufinden.

Wenn für die Wiedergabe von PDF- und HTML-Formularen der gleiche Formularentwurf verwendet wird, erfolgt der Seitenumbruch im PDF-Formular aufgrund der Seitengrößeneinstellung. Diese wird bei der Wiedergabe des HTML-Formulars jedoch ignoriert. Um die Unterschiede zwischen PDF- und HTML-Seiten auszugleichen, können Formularverfasser Teilformulare auf Seitenniveau verwenden, um künstliche HTML-Seiten einzurichten. Wenn HTML-Seiten auf diese Weise eingerichtet werden, muss Benutzern mit Hilfe von JavaScript zur Laufzeit der Wechsel zwischen den HTML-Seiten ermöglicht werden.

Sie können die Methoden pageUp() und pageDown() verwenden, um Benutzern das Wechseln zwischen HTML-Seiten über eine normale Befehlsschaltfläche zu ermöglichen, die die Verarbeitung auslöst, wenn sich das click-Ereignis der Schaltfläche ereignet. Sowohl für PDF- als auch für HTML-Formulare muss die Verarbeitung auf dem Client und dem Server ausgeführt werden.

Die Methoden pageUp() und pageDown() operieren auf dem Seitenniveau der Teilformulare. Angenommen, der Formularentwurf weist folgende Struktur auf:

A.

Dieses Unterformular auf Seitenniveau entspricht der ersten Seite.

B.

Dieses Unterformular auf Seitenniveau entspricht der zweiten Seite.

C.

Dieses Teilformular auf Seitenniveau entspricht der dritten Seite.

Wenn Benutzer die HTML-Seite anzeigen, die „Subform_Page0“ entspricht, bewirkt der Aufruf von „xfa.host.pageDown()“, dass „Subform_Page1“ im Browser angezeigt wird. Entsprechend bewirkt der Aufruf von „xfa.host.pageUp()“ auf dem Teilformular „Subform_Page1“, dass „Subform_Page0“ im Browser angezeigt wird. Seitenzahlen werden den folgenden Eigenschaften zugeordnet, um diese HTML-Seiten zu manipulieren:

xfa.host.currentPage = 0     //moves to the first page 
xfa.host.currentPage = 1     //moves to the second page 
xfa.host.currentPage = 2     //moves to the third page 
xfa.host.currentPage = xfa.host.numPages -1     //moves to the last page

Während Benutzer zwischen den HTML-Seiten wechseln, bleibt der Status der Daten erhalten, doch die Darstellung eines Objekts wie etwa die Hintergrundfarbe eines Felds kann sich von Seite zu Seite ändern. Sie können die Darstellungseinstellungen zwischen den Seiten beibehalten, indem Sie ausgeblendete Felder verwenden, die Statuswerte für die verschiedenen Einstellungen und Befehlsschaltflächen enthalten, die Benutzern das Zurück- und Vorwärtsblättern in einem Formular ermöglichen. Ihr Skript aktualisiert die Darstellungsstatus der Felder auf Grundlage der Werte in den ausgeblendeten Feldern. Wenn Benutzer auf eine der Befehlsschaltflächen klicken, kann das calculate-Ereignis der Schaltfläche zum Ausführen des Skripts verwendet werden.

Beispielsweise wird durch das folgende JavaScript auf Grundlage des Werts im Feld „hiddenField“ die Füllfarbe beibehalten. Das Skript wird ausgelöst, wenn das calculate-Ereignis eintritt.

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