FORMMAIL

FormMail ist ein cgi-Skript, das die Nutzereingaben in ein vorzugebendes Formular an eine vorzugebende Email-Adresse verschickt. Das cgi-Skript läuft auf webapp5 und hat die URL:

 http://webapp5.rrz.uni-hamburg.de/cgi-bin/FormMail.pl

Das Formular kann auf einem der folgenden Server liegen:

www.uni-hamburg.de
www1.uni-hamburg.de
www.biologie.uni-hamburg.de
webapp5.rrz.uni-hamburg.de
webapp.rrz.uni-hamburg.de
tomcat.rrz.uni-hamburg.de
www.agora.uni-hamburg.de
quvion.rrz.uni-hamburg.de

Diese Server-Liste kann auf Wunsch erweitert werden.

Im Formular muss zumindest die Adresse des Mail-Empfängers angegeben werden, was in unterschiedlicher Weise erfolgen kann.

Beispiel:

Am Ende diese Dokumentes finden Sie einen Link zu einem Formular, mit dem Sie Fragen und Anmerkungen zu dieser Beschreibung abschicken können. Der HTML-Code zu diesem Formular lautet vereinfacht:

<form method="post" action="http://webapp5.rrz.uni-hamburg.de/cgi-bin/FormMail.pl">
<input type="hidden" value="donald.duck@entenhausen.de" name="recipient" />
Ihre EMail-Adresse (Angabe erforderlich):<br />
<input type="text" size="40" name="email" /><br /> 
Ihr Name (Angabe optional):<br />
<input type="text" size="40" name="realname" /><br />
<p>Fragen, Kritik und Kommentare zu dieser Beschreibung von FormMail geben Sie bitte
   in nachfolgendes Kommentar-Feld ein. Achten Sie bitte darauf, dass Sie Zeilenenden
   eingeben, damit die Mail nicht aus einer einzigen langen Zeile besteht.</p>

Ihr Kommentar (Eingabe erforderlich):
<textarea rows="12" cols="60" name="Kommentar"></textarea><br />
<input type="submit" class="lightgreen" value="Abschicken" />
</form>

Die Email-Adresse des Mail-Empfängers ist hier im hidden-Feld mit Namen recipient angegeben, ohne dieses Feld würde dieses Formular nicht angenommen werden und nach dem Abschicken eine Fehlermeldung liefern. Es gibt aber auch Alternativen zu einem solchen recipient-Feld, die weiter unten im Text angegeben werden.

Ein Leser mag nun das Formular wie folgt ausfüllen:

• EMail-Adresse: donald.duck@entenhausen.net
• Name: Donal Duck
• Kommentar: "find ich prima"

Der Absender sieht dann nach Abschicken des Formulares eine Bestätigung folgender Art:

Der Empfänger (recipient) erhält folgende Mail:

Mehrere Empfänger:

Es ist möglich mehrere Empfänger für die Mail anzugeben, die Anzahl ist bei unserer Installation jedoch auf maximal 5 Mail-Adressen beschränkt und alle Empfänger Adressen müssen Adressen der Universität Hamburg sein, also mit ".uni-hamburg.de" enden. Mehrere Empfänger-Adressen geben Sie im "recipient-Feld" einfach mit Kommata getrennt hintereinander ein:

<input type="hidden" value="donald.duck@orn.uni-hamburg.de, daisy.duck@rrz.uni-hamburg.de" name="recipient" />

Empfänger-Adresse verbergen:

Wenn die Empfänger-Adressen in einem recipient-Feld angegeben werden, können Sie im Internet und insbesondere von Robotern gelesen werden. Sofern das Formular auf webapp5 liegt, gibt es eine Möglichkeit dies zu vermeiden. Legen Sie dazu in Ihrem Home-Verzeichnis auf webapp5 im dort vorhandenen Unterverzeichnis pwFiles eine Datei mit Namen "allow_recipients" an. In dieser Datei tragen Sie ein die Email-Adressen der Empfänger in der Form:

  @allow_mail_to = qw(donald.duck@rrz.uni-hamburg.de);

ein. Mehrere Empfänger-Adressen in der Empfängerliste sind möglich, sie müssen jeweils durch ein Komma voneinander getrennt werden. Im Formular lassen Sie das recipient-Feld weg.

Achtung: Unsere Installation basiert zwar auf TFMail, weicht in diesem Punkt aber von TFMail ab. Die Implementation erlaubt zur Zeit auch nicht, dass unter einer webapp5-Kennung unterschiedliche Empfängerlisten für unterschiedliche Formulare angelegt werden. Sollte Bedarf danach bestehen, so kann dies nachgerüstet werden.

Obligatorische Felder:

Es ist nicht sinnvoll, dass ein Leser ein leeres Formular abschickt, zumindest ein Kommentar und die Email-Adresse des Absenders sollten vorhanden sein. Das kann man im Formular berücksichtigen, indem man die betreffenden Eingabefelder entsprechend markiert. In der Regel wird man "hidden-Felder" zu diesem Zwecke benutzen, diese lauten dann:

<input type=hidden name="required" value="email">
<input type=hidden name="required" value="Kommentar">

Die beiden Felder können irgendwo innerhalb des Formulares stehen, etwa nach dem "recipient-Feld".

Subject-Feld:

Im Beispiel wurde keine spezielle Angabe zum subject gemacht, als subject wurde deshalb in der Mail "WWW Form Submission" angegeben. Einen Wert für subject kann man z.B. mit:

<input type=hidden name="subject" value="Kommentar zur FormMail-Dokumentation">

vorgeben.

Kommentar schreiben:

Für Fragen, Anregungen, Kommentare oder Kritik zu dieser Seite verwenden Sie bitte das dafür vorgesehene Formular.