WebBox

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##
…

In den Nachrichteneigenschaften für das Steuerdokument sollten Sie das Attribut »Ausgeblendet« aktivieren. Damit wird diese Nachricht nicht im Browser angezeigt. Die Befehle LOCK und UNLOCK sind wichtig, um einenMissbrauch Ihrer WebBox zu verhindern.

Versenden von HTML-eMails aus Formularen
Neben reinem Text können auch HTML-formatierte eMails aus WebBox-Formularen heraus versendet werden. Hierzu muss der Inhalt der Steuerdatei einen bestimmten Aufbau haben.

Zunächst entspricht der Inhalt der CTRL Datei dem oben beschriebenen Aufbau. Hier ist also die zu versendende Information im reinen Textformat enthalten. Diese wird bei allen Empfängern angezeigt, die nicht über eine HTML eMail-Unterstützung verfügen, oder diese deaktiviert haben. Stellen Sie daherunbedingt sicher, dass auch dieser Teil sämtliche zu übertragende Informationen enthält.

Leiten Sie anschließend den HTML Teil der Steuerdatei über folgenden Befehl ein:

----HTML-MAIL-FORM-START----

Geben Sie nun den gewünschten HTML-Code an. Innerhalb dieses Codes können sowohl HTML Tags als auch WebBox Befehle verwendet werden. So können beispielsweise Grafiken eingebunden werden, die als Attachment an der Steuerdatei angehängt sind. Um den HTML-Teil des Mailformulars abzuschließen,geben Sie folgende Zeile ein:

----HTML-MAIL-FORM-STOP----