Grundlagen für Anfrageformulare

Ein Anfrageformular besteht aus mehreren Dateien, die an festen Orten liegen und deren Eingabefelder bestimmten Namensregeln folgen. Diese Seite beschreibt diese Grundlagen. Die Parameter der Konfigurationsdatei folgen auf der nächsten Seite.

Benötigte Dateien für ein Formular

Je Formular benötigen Sie:

ein HTML-Formular-Template (*.htm)
ein HTML-Antwort-Template (*.htm)
ein HTML-Antwort-Template für die Erzeugung eines PDFs (*.htm)
eine Konfigurationsdatei (*.config)
ein HTML-E-MailTemplate (*.hmail)
Definitionsdateien für Anrede, Titel und Länderauswahl (*.dat)

Üblicherweise gehört zu einem Formular immer ein kompletter Satz mit den oben genannten Dateien. Sie können auch für unterschiedliche Anfrageformulare beispielsweise stets das gleiche Antwort-Template und/oder die gleiche Anrede-Definition usw. verwenden. Ob und welche Dateien jeweils verwendet werden, legen Sie nach Ihrem Ermessen in der dem Formular zugehörigen Konfigurationsdatei (.config) fest. Dieser Dokumentation liegen folgende Beispiele bei:


Fallbeispiel	Beispieldateien
Standardanfrage in eigener Seite mit Download der Anfrage als PDF, Popup oder iFrame	anfrage.config anfrage.htm anfrage.hmail antwort.htm antwort_pdf.htm antwort.hmail
Standardanfrage integriert in WEBSALE E-Commerce mit WS-ExternInclude	externinclude_anfrage.config externinclude_anfrage.htm externinclude_antwort.htm tpl_externinclude_anfrage.htm antwort.hmail anfrage.hmail
Standardanfrage in eigener Seite, Popup oder iFrame mit CAPTCHA-Funktion Rechenaufgabe zur SPAM-Vermeidung	anfrage_captcha_rechnen.config anfrage_captcha_rechnen.htm antwort.htm antwort.hmail anfrage.hmail

Erläuterung der einzelnen Beispieldateien:


Datei	Beschreibung
`anfrage.config`	Konfigurationsdatei einer Standardanfrage
`anfrage.htm`	Anfrageseite einer Standardanfrage
`antwort.htm`	Antwortseite einer Standardanfrage
`antwort_pdf.htm`	HTML-Template für die Erzeugung der PDF-Datei
`antwort.hmail`	HTML-E-Mail-Template an den Anfragenden einer Standardanfrage
`anfrage.hmail`	HTML-E-Mail-Template an den Angefragten einer Standardanfrage
`externinclude_anfrage.htm`	Anfrageseite einer Standardanfrage, welche mit ExternInclude eingebunden wird
`externinclude_anfrage.config`	Konfigurationsdatei einer Standardanfrage, welche mit ExternInclude eingebunden wird
`externinclude_antwort.htm`	Antwortseite einer Standardanfrage, welche mit ExternInclude eingebunden wird
`tpl_externinclude_anfrage.htm`	Shoptemplate auf dem eine Standardanfrage mit ExternInclude eingebunden wird
`anfrage_captcha_rechnen.config`	Konfigurationsdatei einer Standardanfrage mit CAPTCHA-Funktion Rechenaufgabe
`anfrage_captcha_rechnen.htm`	Anfrageseite einer Standardanfrage mit CAPTCHA-Funktion Rechenaufgabe

Speicherort der benötigten Dateien

Die benötigten Dateien müssen innerhalb des WEBSALE E-Commerce Shops abgelegt werden. Alle Konfigurationsdateien (config-Dateien, Länder-, Titel- und Anredeauswahldateien sowie Blacklist-Dateien) müssen im zugehörigen Konfigurationsverzeichnis des Subshops im Unterverzeichnis inquiry gespeichert werden:

/websale8_shop-<ihre-shopid>/konfiguration/<ihre-subshopid>/inquiry/

Alle Template-Dateien (E-Mail- und Formular-Templates) müssen im zugehörigen Template-Verzeichnis des Subshops gespeichert werden:

/websale8_shop-<ihre-shopid>/benutzer/templates/<ihre-subshopid>/

Eingabefelder für Formulare

Ein Template für ein Anfrageformular können Sie mit einem HTML-Editor Ihrer Wahl erstellen. INQUIRY4 verarbeitet und kontrolliert folgende Eingabefelder:

Checkboxen
Radio Buttons
Listboxen
einzeilige Textfelder
mehrzeilige Textfelder (max. 4048 Zeichen)

Wie bereits erwähnt, bleiben alle gemachten Eingaben voll erhalten. Um dies zu erreichen, muss INQUIRY4 die bereits gemachten Eingaben in die entsprechenden Felder auf dem Template integrieren. Es ist daher notwendig, dass die HTML-Syntax im Formular einigen Regeln entspricht, die im Folgenden erläutert werden. Diese Regeln werden üblicherweise auch von allen gängigen HTML-Editoren eingehalten.

Syntax-Regeln für die Eingabefelder

Feldname

Alle Feldnamen müssen in Anführungszeichen stehen. Es darf kein Leerzeichen zwischen “name=” und Feldname sein. <input type=“text” name=“Feldname” …> <input type=“text” name= “Feldname” …> <input type=“text” name=Feldname …>

Feldwert

Alle Feldwerte müssen in Anführungszeichen stehen. Es darf kein Leerzeichen zwischen “value=” und Feldwert sein. <input type=“text” … value=“Feldwert”> <input type=“text” … value= “Feldwert”> <input type=“text” … value=Feldwert>

Listboxen mit und ohne Feldwert

Listboxen können mit und ohne Feldwert (value=“…“) angegeben werden. INQUIRY4 unterstützt beide Methoden. Wenn ein Feldwert vorhanden ist, wird der entsprechende Eintrag ausgewählt, ansonsten der passende Eintrag ohne Feldwert gesucht und ausgewählt. Ohne Feldwert:

<select name="Feldname">
  <option></option>
  <option>Herr</option>
  <option>Frau</option>
</select>

Mit Feldwert:

<select name="Feldname">
  <option value=""></option>
  <option value="Herr">Herr</option>
  <option value="Frau">Frau</option>
</select>

Verwenden Sie Listboxen mit Feldwert, dies erleichtert die Arbeit insbesondere bei fremdsprachigen Formularseiten, da Sie dann stets den gleichen value (beispielsweise value=“Herr“) verwenden können und lediglich im lesbaren Text die Übersetzung (beispielsweise “Monsieur“)

Wegweiser

Grundlagen für Anfrageformulare