aus Tobit KB importiert - vom 27.10.2006 - Beitrag bei Tobit
Problem
Auto-Formulare sind eine besondere Formular-Handling-Methode der WebBox.
Antwort
Um die Auto-Formulare nutzen zu können, müssen im Formular-Root-Archiv mindestens die beiden Dokumente mit dem Betreff »DefOK« und »DefError« vorhanden sein. Wurden die Daten eines Formulars von der WebBox korrekt bearbeitet, so wird im Browser das Dokument »DefOK« angezeigt. Ist ein Fehler aufgetreten oder wurden die Check-Variablen nicht vollständig ausgefüllt, wird die »DefError« automatisch aufgerufen.
Auto Formular für Versand
Sowohl das Formular selbst als auch die Steuerdatei (Steuerdokument, das ausgefüllt zurückgesendet wird) müssen als einfache Dokumente im gleichen Archive liegen und können mit dem Nachrichten Editor des David InfoCenters erstellt werden. Der Name des Steuerdokumentes wird direkt im Formular mit dem Befehl »NAME=AUTO-Name des Steuerdokumentes« übergeben (AUTO immer in Großbuchstaben). Dahinter können durch Leerzeichen getrennt Check-Variablenangegeben werden, die das Ausfüllen bestimmter Felder erzwingt, damit der korrekte Versand des Formulars gewährleistet wird. Um eine eindeutige Trennung zu den Check-Variablen zu erreichen, darf der Name des Steuerdokumentes keine Leerzeichen enthalten.
Soll nach dem Ausfüllen und Absenden des Formulars direkt ein Download folgen, kann zusätzlich der Parameter DOWNLOAD=Dateiname angegeben werden. Auf diese Weise kann die Beantwortung von Fragen erzwungen werden, bevor ein Download ermöglicht wird. Dabei wird stets das erste Attachment der Steuerdatei als Download-Datei versendet, unabhängig vom angegebenen Dateinamen. Dieser wird ausschließlich als Defaultname zum Abspeichern der Datei auf Seiten des Users verwendet.
< INPUT TYPE=submit VALUE=senden NAME=AUTO-Form NAME=5 MAIL=8DOWNLOAD=program.exe >
Bei diesem Beispiel dient das Dokument in dem Archive mit dem Betreff »Form« als Steuerdokument für das Formular. Als Check-Variablen werden »NAME« (mind. 5 Zeichen) und »MAIL« (mind. 8 Zeichen) verwendet. Dabei müssen für einen ordnungsgemäßen Versand des Formulars beide Check-Bedingungen erfüllt sein (UND-Verknüpfung). Ist das Formular korrekt ausgefüllt und abgesendet worden, so wird nun der Download gestartet und die als erstes Attachment an die Steuerdatei angehängte Datei unter dem Namen PROGRAM.EXE an den User übertragen.
Im Steuerdokument können nun die Variablen ausgelesen werden. Dabei müssen die im Formular benutzten Variablen mit »##« eingeschlossen werden (##Variable##). Wurde das Formular korrekt versendet, so wird das Steuerdokument als Job an den DvISE Service Layer übergeben. Es können also alle @@-Befehle verwendet werden (z.B. @@NUMMER, @@eMAIL, @@ARCHIVE, etc.).
Zusätzlich kann man im Steuerdokument noch den Befehl ##DISTANTIP## angeben, welcher die IP-Adresse des Absenders mit versendet. Diesen WebBox-Befehl müssen Sie in Ihrer Steuerdatei mit angeben.
Beispiel für eine Bestellung per Web-Formular:
< H3 >Angebot der Woche< /H3 >
< FORM METHOD="GET" ENCTYPE="application/x-www-form-urlencoded" >
ODER
< FORM METHOD=Post NAME=Formularname >
Firma:< INPUT NAME="firma" MAXLENGTH=80 SIZE=46 >< BR >
Straße:< INPUT NAME="strasse" MAXLENGTH=80 SIZE=46 >< BR >
< B >Bestellung:< /B >< BR >
...
< INPUT NAME="menge" MAXLENGTH="80" SIZE=3 > Stck.
< B >Pakete zu je 1500,-< /B >< /SELECT >< BR >
< INPUT NAME="menge" MAXLENGTH="80" SIZE=3 > Stck.
< B >Erweiterungen zu je 500,-< /B >< /SELECT >< BR >
< /BLOCKQUOTE >< P >< BR >Alles geprüft? Dann Bestellung
< INPUT TYPE=SUBMIT VALUE="Abschicken" NAME="AUTO-Angebot_CTRL">< BR >
< /FORM >
Das Steuerdokument Angebot_CTRL wird in dem gleichen Archive erstellt und könnte die folgende Struktur haben:
@@EMAIL vertrieb@example.com
(oder z.B. @@archive => Archive-Pfad)
@@REFERENZ Angebot
@@SENDERNAME webmaster@example.com
@@FROM ##EMAIL##
@@LOCK
+++ Angebot +++
Firma: ##firma##
Straße: ##strasse##
| Bestellung: |