> ## Documentation Index
> Fetch the complete documentation index at: https://dokumentation.websale.de/llms.txt
> Use this file to discover all available pages before exploring further.

# Konfigurationsdatei

> Alle Parameter der Formular-Konfigurationsdatei: allgemeine Angaben, Bestätigungs- und Anfrage-E-Mail, PDF-Download, Upload-Modul, CAPTCHA-Systeme, Blacklisting und Fehlermeldungen.

Jedes Formular hat eine eigene Konfigurationsdatei. Sie legt fest, welches Template verwendet wird, wohin die Anfrage geht, wie die Bestätigungsmail aussieht und welche Schutzfunktionen greifen. Diese Seite beschreibt alle Parameter. Die shopweiten Schutzregeln stehen dagegen in der [globalen Konfigurationsdatei](https://dokumentation.websale.de/v8s/upload-modul/formulare-mit-inquiry4/globale-konfiguration.md).

### Konfigurationsdatei

In der Konfigurationsdatei wird angegeben,

* an welche E-Mail-Adresse die Anfragen gesendet werden,
* welche Templates verwendet werden sollen,
* welche Fehlermeldungen ausgegeben werden,
* welche Formularfelder von INQUIRY4 abgefragt und kontrolliert werden sollen.

Code-Beispiele finden Sie in diesem Dokument unter „Fehler: Verweis nicht gefunden“

#### Allgemeine Angaben

Die allgemeinen Angaben finden Sie in der Sektion `<Basic>`.

```
<Basic>
   InquiryPage        		   = anfrage.htm
   ConfirmPage       		   = antwort.htm
   CommonInputRequired 		   = yes
   Language        			   = DEU
   EMailCheckMethod    		   = domain	      # [none][syntax][domain]
   CountryDat    			   = ../country.dat
   SalutationDat 			   = ../salutation.dat
   TitleDat      			   = ../title.dat
   Referer             		   = www.ihr-shop.de
   WSOMAllow           		   = yes
   TransferEmptyValues		   = no           # [yes][no], Std: no
   Charset				       = ISO-8859-1
   TextAreaWrap			       = 30
   NoEmptyCountryListboxEntry  = no           # [yes|no], Std: no
   PresetSTC			       = yes          # [yes|no], Std: yes
   VS4Allow			           = yes          # [yes|no], Std: yes
   InquiryFormatMinorVersion   =              # Std: 1
</Basic>
```

#### Beschreibung der Parameter:

| Parameter | Beschreibung | Werte |
| - | - | - |
| `InquiryPage` | Name der HTML-Anfrageseite. | Dateiname beispielsweise anfrage.htm |
| `ConfirmPage` | Name der HTML-Antwortseite. | Dateiname beispielsweise antwort.htm |
| `CommonInputRequired` | Wenn Sie diesen Parameter auf "yes" setzen, dann muß mindestens ein allgemeines Anfragefeld vom Anfragenden ausgefüllt worden sein, ansonsten erfolgt eine entsprechende Fehlermeldung. | \[yes]\[no] |
| `Language` | Die gewünschte Sprache für Anrede und Titel im ISO-Code. | 3-stelliger Länder ISO-Code, beispielsweise DEU |
| `CountryDat` | Optionaler Parameter  Hier können Sie die Länder-Konfigurationsdatei aus ihrem WEBSALE-Shop verwenden. | Dateiname, beispielsweise country.dat |
| `SalutationDat` | Optionaler Parameter  Hier können Sie die Anrede-Konfigurationsdatei aus ihrem WEBSALE-Shop verwenden. | Dateiname, beispielsweise salutation.dat |
| `TitleDat` | Optionaler Parameter  Hier können Sie die Titel-Konfigurationsdateiaus ihrem Websale-Shop verwenden. | Dateiname, beispielsweise title.dat |
| `Referer` | Optionaler Parameter  Hier können Sie verschiedeneURLs, jeweils durch Komma getrennt, angeben. Eine Referer-URL dient dem Schutz vor unerwünschten automatisierten Anfragen und ist von der Behandlung her einzustufen wie ein Passwort, das heißt ein Referer ist vertraulich zu behandeln. (siehe Kapitel “Refererschutz“)  Durch Angabe einer oder mehrerer URLs wird der Refererschutz eingeschaltet. Wenn nichts angegeben wird, nimmt INQUIRY4 alle übergebenen Parameter an, der Refererschutz ist damit ausgeschaltet! | URL, [www.ihr-shop.de](http://www.ihr-shop.de) |
| `WSOMAllow` | Wenn Sie diesen Parameter auf „yes“ setzen, dann werden alle erzeugten Anfragen vom WSOM (WEBSALE Order Manager) verarbeitet und können somit über den WSOM in Warenwirtschaftssysteme automatisiert eingelesen werden.  Anwendungsbeispiel: Anfrage zur Zusendung eines Katalogs. | \[yes]\[no] |
| `TransferEmptyValues` | Wenn Sie diesen Parameter auf „yes“ setzen werden alle leeren Felder der Anfrage mit übergeben. Steht dieser Parameter auf "no" so werden leere Felder nicht mit übergeben. Dies betrifft die Tags AUTOGENERATE-Full, AUTOGENERATE-Addr, AUTOGENERATE-Common, AUTOGENERATE-Readable und AUTOGENERATE-Technical sowie die Datenübergabe an den WSOM.  Wenn die Anfragedaten durch den WSOM abgeholt werden und optionale Felder in dem Anfrageformular vorhanden sind kann durch die Übertragung der leeren Felder eine einheitliche Felderdefinition erreicht werden. | \[yes]\[no] |
| `Charset` | Hier geben Sie den Zeichensatz der Anfrage an. Dieser Zeichensatz wird auch für die erzeugten E-Mails verwendet, wenn in den entsprechenden Sektionen kein anderer Zeichensatz angegeben ist. Der Parameter muss vorhanden sein, um Konvertierungen in UTF-8 per Tag durchführen zu können. | Zeichensatz, beispielsweise ISO-8859-1 |
| `TextAreaWrap` | Hier können Sie angeben nach wie vielen Zeichen die Ausgabe einer Textarea in den E-Mails umgebrochen werden soll. Ist dieser Wert 0 erfolgt kein automatischer Umbruch. | Zeichenanzahl, beispielsweise 30 Standard: 30 |
| `NoEmptyCountryListboxEntry` | Hier können Sie festlegen ob der erste Eintrag in der Listbox zur Länderauswahl ein leerer Eintrag sein soll.  yes: Es wird kein leerer Eintrag erzeugt, der erste Eintrag ist "vorausgewählt".  no: Der erste Eintrag wird als leerer (nicht ausgewählter) Eintrag erzeugt. | \[yes]\[no] Standard: no |
| `PresetSTC` | Hier können Sie festlegen ob Anrede, Titel und Land vorausgefüllt sein sollen, wenn INQUIRY per ExternInclude eingebunden wird. | \[yes]\[no] Standard: yes |
| `VS4Allow` | Hier können Sie festlegen ob Anfragen an das VS/4 weitergeleitet werden sollen. | \[yes]\[no] Standard: yes |
| `InquiryFormatMinorVersion` | Parameter zur Beeinflussung von nicht abwärtskompatiblen Änderungen des technischen Ausgabeformats.  Momentan max. verwendet: Wert 2. Für Werte >= 2 gilt: In der technischen Übergabe von Textarea-Daten wird als Sektionsname \<Value> anstelle von \<value> verwendet. | \[1]\[2] Standard: 1 |

#### Angaben zur Bestätigungs-E-Mail an den Anfragenden

Alle Definitionen zur E-Mail an den Anfragenden finden Sie in der Sektion `<ConfirmEmail>`.

```
<ConfirmEmail>
  SendEmail           	= yes
  EmailSubject        	= Ihre Anfrage
  SenderEmail          	= abc@domain.de
  SenderName          	= Firma XYZ
  charset             	= ISO-8859-1
  EmailTemplate       	= confirm.hmail
  UseExternMailSystem	= no
  ExternMailTemplate	=
</ConfirmEmail>
```

| Parameter | Beschreibung | Werte |
| - | - | - |
| `SendEmail` | Legt fest, ob an den Anfragenden eine Bestätigungsemail geschickt wird.  Wenn der Wert von SendEmail userselect ist, muss die Sektion \<SendUserEmail> vorhanden sein, in welcher das zugehörige HTML-Element zur Auswahl definiert ist. | \[yes]\[no]\[userselect] |
| `EmailSubject` | Der Betreff der E-Mail. | Text, beispielsweise Ihre Anfrage |
| `SenderEmail` | Die E-Mail-Adresse des Absenders. | E-Mail-Adresse\*\*,\*\* [**abc@domain.de**](mailto:abc@domain.de) |
| `SenderName` | Der Name des Absenders. | Text, beispielsweise Firma XYZ |
| `Charset` | Optionaler Parameter  Der in der E-Mail verwendete Zeichensatz. Wichtig für die sprachabhängig korrekte Darstellung der Mailtexte beim Empfänger. Ist der Parameter nicht angegeben wird der globale Zeichensatz (Parameter Charset in der Sektion Basic) verwendet. | ISO-Zeichensatz, beispielsweise ISO-8859-1 |
| `EmailTemplate` | Das HTML-Template der E-Mail.  Weitere Informationen zu “Tags und Templates“ finden Sie im entsprechenden Abschnitt dieses Dokuments. | Dateiname, beispielsweise confirm.hmail |
| `UseExternMailSystem` | Bei Verwendung eines Drittanbieters für den E-Mail-Versand wird dieser Anbieter hier angegeben. Standard ist „no“, das heißt, das Shop-eigene Mail-System wird verwendet. | \[no]\[InxMail], Standard: no |
| `ExternMailTemplate` | Template, auf dem das JSON-Objekt zur Übergabe an den externen Mail-Anbieter, beispielsweise InxMail, angelegt wird | Dateiname |

#### Angaben zur Anfrage-E-Mail

Alle Angaben zur E-Mail an den Angefragten finden Sie in der Sektion `<InquiryEmail>`.

```
<InquiryEmail>
  SendEMail          	= yes
  EmailSubject       	= Anfrage
  EmailAddress        	= ihreAdresse@ihre-domain.de
  charset	            = ISO-8859-1
  EmailTemplate       	= templates/request.hmail
  SenderAddress	        = optionaleAnfrageadresse@ihre-domain.de
  UseExternMailSystem	= no
  ExternMailTemplate	=
</InquiryEmail>
```

| Parameter | Beschreibung | Werte |
| - | - | - |
| `SendEmail` | Legt fest, ob an den Angefragten eine Bestätigungs-E-Mail geschickt wird. | \[yes]\[no] |
| `EmailSubject` | Der Betreff der E-Mail. | Text, beispielsweise Ihre Anfrage |
| `EmailAddress` | Die E-Mail-Adresse zu der die Anfrage gesendet wird. Es können auch mehrere Adressen, durch Komma getrennt, angegeben werden. | E-Mail-Adresse\*\*,\*\* [**abc@domain.de**](mailto:abc@domain.de) |
| `Charset` | Optionaler Parameter  Der in der E-Mail verwendete Zeichensatz. Ist der Parameter nicht angegeben, so wird der globale Zeichensatz (Parameter Charset in der Sektion „Basic“) verwendet. | ISO-Zeichensatz, beispielsweise ISO-8859-1 |
| `EmailTemplate` | Das HTML-Template der E-Mail.  Weitere Informationen zu Tags und Templates finden Sie in dieser Dokumentation. | Dateiname, beispielsweise confirm.hmail |
| `SenderAddress` | Optionale Absenderadresse.  Ist diese Adresse angegeben, so wird sie als Absenderadresse verwendet. Die vom Benutzer eingegebene Adresse wird dann als Antwortadresse verwendet. | E-Mail-Adresse\*\*,\*\* [**abc@domain.de**](mailto:abc@domain.de) |
| `UseExternMailSystem` | Bei Verwendung eines Drittanbieters für den E-Mail-Versand wird dieser Anbieter hier angegeben. Standard ist „no“, das heißt, das Shop-eigene Mail-System wird verwendet. | \[no]\[InxMail],  Standard: no |
| `ExternMailTemplate` | Template, auf dem das JSON-Objekt zur Übergabe an den externen Mail-Anbieter, beispielsweise InxMail, angelegt wird | Dateiname |

#### PDF-Download der Anfrage

Alle Einstellungen zur PDF-Erzeugung sind in der Sektion \<PDF> zu finden.

```
<PDF>
  Allow      = yes
  Template   = antwort_pdf.htm
  Filename   = anfrage.pdf
</PDF>
```

| Parameter | Beschreibung | Werte |
| - | - | - |
| `Allow` | Legt fest ob die Anfrage als PDF heruntergeladen werden kann. | \[yes]\[no],  Standard: no |
| `Template` | Name des HTML-Templates welches für die PDF-Erzeugung verwendet wird. | Dateiname, beispielsweise antwort\_pdf.htm |
| `Filename` | Der Dateiname der erzeugten PDF-Datei. | Dateiname, beispielsweise anfrage.pdf |

#### Konfiguration des WEBSALE-Upload-Moduls

Alle Einstellungen zur Verwendung des WEBSALE-Upload-Moduls sind in der Sektion `<Upload>` zu finden.

```
<Upload>
  Allow		                        = yes
  UploadIni	                        = upload.config
  UploadDescr	                    = Anhänge
  AttachUploadsToInquiryEMail-Allow = yes
</Upload>
```

| Parameter | Beschreibung | Werte |
| - | - | - |
| `Allow` | Legt fest, ob die Uploadfunktion verwendet werden soll | \[yes]\[no],  Standard: no |
| `UploadIni` | Konfigurationsdatei des WEBSALE-Upload-Moduls | Dateiname,  beispielsweise upload.config |
| `UploadDescr` | Dieser Text erscheint in den automatisch erzeugten Anfragedaten als Text über der Liste der hochgeladenen/angehängten Dateien. | Text, beispielsweise Anhänge |
| `AttachUploadsToInquiryEMail-Allow` | Erlaubt Datei-Anhänge an Mails | \[yes]\[no],  Standard: no |

Ein ausführliches Beispiel für ein Anmeldeformular mit Datei-Upload finden Sie in der Frontend-Dokumentation:

[https://doku.websale.net/index.html?guide\_uploadmodulfuerformulareinquiry.html](https://doku.websale.net/index.html?guide_uploadmodulfuerformulareinquiry.html)

#### Konfiguration der CAPTCHA-Funktionalität

##### Konfiguration

Die Einstellungen zur CAPTCHA-Funktion sind in der Sektion \<Captcha> zu finden.

```
<Captcha>
  UseArithmeticCaptcha		=	yes
  UseReCaptchaV3		    =	yes
  CaptchaDescription		=	Eine kleine Rechenaufgabe
  CaptchaNotFilledIn		=	Bitte lösen Sie die Rechenaufgabe
  CaptchaError			    =	Die Rechenaufgabe wurde nicht gelöst
</Captcha>
```

Sie können als CAPTCHA-Funktionalität entweder die Rechenaufgabe, das ReCaptcha- oder das Friendly-Captcha-Verfahren verwenden.

| Parameter | Beschreibung | Werte |
| - | - | - |
| `UseArithmeticCaptcha` | Legt fest ob die CAPTCHA-Funktion in Form einer Rechenaufgabe verwendet werden soll. | \[yes]\[no],  Standard: no |
| `UseRecaptchaCaptcha` | Wenn Sie als CAPTCHA-Funktion die Rechenaufgabe verwenden möchten, muss dieser Parameter auf "no" stehen! | \[yes]\[no],  Standard: no |
| `CaptchaDescription` | Dieser String beschreibt die CAPTCHA-Funktionalität und kann auf dem Template ausgegeben werden. | Text, beispielsweise Eine kleine Rechenaufgabe |
| `CaptchaNotFilledIn` | Dieser Fehlerstring wird angezeigt, wenn das CAPTCHA-Eingabefeld nicht ausgefüllt wurde. | Text, beispielsweise Bitte lösen Sie die Rechenaufgabe |
| `CaptchaError` | Dieser Fehlerstring wird angezeigt, wenn das CAPTCHA-Eingabefeld falsch ausgefüllt wurde. | Text, beispielsweise Die Rechenaufgabe wurde nicht gelöst |

Die CAPTCHA-Funktion in Form einer Rechenaufgabe stellt die drei Grundrechenarten Addition, Subtraktion und Multiplikation zur Verfügung. Diese drei Grundrechenarten werden standardmäßig mit vorgegebenen Wertebereichen verwendet. Sie können allerdings die Einstellungen für jede dieser Grundrechenarten individuell konfigurieren. Dazu können Sie folgende drei Sektionen verwenden:

| Parameter | Beschreibung | Werte |
| - | - | - |
| `CaptchaOperation+` | Addition | |
| `CaptchaOperation-` | Subtraktion | |
| **CaptchaOperation**\* | Multiplikation | |

Beispiel:

```
<CaptchaOperation+>
  Allow			        =	yes
  Operand1RangeStart	=	1
  Operand1RangeEnd	    =	9
  Operand2RangeStart	=	1
  Operand2RangeEnd	    =	9
  +Sign			        =	plus
  +Sign			        =	+
  +Sign			        =	und
</CaptchaOperation+>
```

| Parameter | Beschreibung | Werte |
| - | - | - |
| `Allow` | Legt fest ob diese Grundrechenart verwendet wird. | \[yes]\[no],  Standard: yes |
| `Operand1RangeStart` | Legt den kleinsten Wert des ersten Operanden fest. (optional) | Zeichenanzahl, beispielsweise 1 |
| `Operand1RangeEnd` | Legt den größten Wert des ersten Operanden fest. (optional) | Zeichenanzahl, beispielsweise 9 |
| `Operand2RangeStart` | Legt den kleinsten Wert des zweiten Operanden fest. (optional) | Zeichenanzahl, beispielsweise 1 |
| `Operand2RangeEnd` | Legt den größten Wert des zweiten Operanden fest. (optional) | Zeichenanzahl, beispielsweise 9 |
| **+Sign** | Bis zu 10 Einträge je Grundrechenart werden unterstützt. Ist mindestens ein Eintrag einer Grundrechenart vorhanden werden die standardmäßig konfigurierten Strings nicht mehr verwendet!  Eine textuelle Repräsentation der Rechenoperation. | Text, beispielsweise plus |

##### Konfiguration Google ReCaptcha (Version 3)

Google ReCaptcha Version 2 wurde deaktiviert und funktioniert daher nicht mehr. INQUIRY4 unterstützt derzeit Google ReCaptcha Version 3.

```
<Captcha>
  ...
  UseReCaptchaV3 	        = yes
  Site-Key                  =    # z. B. 6Le0SJsUxxxxxxxxxxxxxxxxx_xxxxxxxxxxxxxx
  Secret-Key                =    # z. B. 6Le0SJsUxxxxxx_xxxxxxxxxxxxxxxxxx_xxxxxx
  Api-Url 	                = https://www.google.com/recaptcha/api.js
  Verify-Url 	            = https://www.google.com/recaptcha/api/siteverify
  CaptchaV3EmptyToken 	    = Token ist leer	            #
  CaptchaV3EmptySecretKey 	= Secret-Key ist nicht gesetzt	#
  CaptchaV3ResponseError 	= Recaptcha Response ist false	#
  CaptchaV3ScoreError 	    = Score ist weniger als 0.5 	#
  CaptchaV3ActionName 	    =    # z. B. kontakt
  CaptchaV3TechnicalProblem = Techn. Problem, keine Verbindung
  CustomScore	            =    # Wert von 0.1 – 1.0; Standard: 0.5
  ...
</Captcha>
```

| Parameter | Beschreibung | Werte | |
| - | - | - | - |
| `UseReCaptchaV3` | | \[yes | no];  Standard: no |
| `Site-Key` | Site-Key, wird von Google bezogen | | |
| `Secret-Key` | Secret-Key, wird von Google bezogen | | |
| `Api-Url` | Standardwert von Google | \<[https://www.google.com/recaptcha/api.js>](https://www.google.com/recaptcha/api.js>) | |
| `Verify-Url` | Standardwert von Google | \<[https://www.google.com/recaptcha/api/siteverify>](https://www.google.com/recaptcha/api/siteverify>) | |
| `CaptchaV3EmptyToken` | Fehlermeldung, wenn Token leer ist | Text, beispielsweise Token ist leer | |
| `CaptchaV3EmptySecretKey` | Fehlermeldung, wenn Secret-Key nicht gesetzt ist | Text, beispielsweise Secret-Key ist nicht gesetzt | |
| `CaptchaV3ResponseError` | „Success“-Parameter in Response ist "false" | Text, beispielsweise Recaptcha Response ist false | |
| `CaptchaV3ScoreError` | „Score“-Parameter in Response ist weniger als 0.5 | Text, beispielsweise Score ist weniger als 0.5 | |
| `CaptchaV3ActionName` | ActionName für Seite (z. B homepage, login ...) | Text, beispielsweise Kontakt | |
| `CaptchaV3TechnicalProblem` | Fehlermeldung bei technischem Problem | Text, beispielsweise Techn. Problem, keine Verbindung | |
| `CustomScore` | Recaptcha Custom Score (0.1 bis 1.0), wir vergleichen diesen Wert mit der Response von Google, um zu prüfen, ob Form gültig ist | Zeichenanzahl, beispielsweise 30  Standard: 0.5. | |

##### Konfiguration Friendly Captcha

Friendly Captcha sendet dem Benutzer ein kryptografisches Rätsel, das Gerät des Benutzers benötigt einige Sekunden, um dieses zu lösen, der Benutzer muss nichts tun.

```
<Captcha>
  ...
  UseFriendlyCaptchaV1              = yes
  FriendlyCaptchaV1ApplicationID    =  #ApplicationID aus FriendlyCaptcha Backend
  FriendlyCaptchaV1APIKey           = #API-Key aus FriendlyCaptcha
  FriendlyCaptchaV1ApiUrl           = https://eu-api.friendlycaptcha.eu/api/v1/puzzle   #Endpoint (bei FC dokumentiert, global oder EU Endpoint)
  FriendlyCaptchaV1VerifyUrl        = https://eu-api.friendlycaptcha.eu/api/v1/siteverify #Endpoint (bei FC dokumentiert, global oder EU Endpoint)
  FriendlyCaptchaV1TechnicalProblem = #
  FriendlyCaptchaV1Denied           = #
  FriendlyCaptchaV1EmptySolution    = #
  ...
</Captcha>
```

| Parameter | Beschreibung | Werte | |
| - | - | - | - |
| `UseFriendlyCaptchaV1` | | \[yes | no];  Standard: no |
| `FriendlyCaptchaV1ApplicationID` | ApplicationID, wird von FriendlyCaptcha bezogen | | |
| `FriendlyCaptchaV1APIKey` | API-Key, wird von FriendlyCaptcha bezogen | | |
| `FriendlyCaptchaV1ApiUrl` | Standardwert von FriendlyCaptcha | \<[https://eu-api.friendlycaptcha.eu/api/v1/puzzle>](https://eu-api.friendlycaptcha.eu/api/v1/puzzle>) | |
| `FriendlyCaptchaV1VerifyUrl` | Standardwert von FriendlyCaptcha | \<[https://eu-api.friendlycaptcha.eu/api/v1/siteverify>](https://eu-api.friendlycaptcha.eu/api/v1/siteverify>) | |
| `FriendlyCaptchaV1TechnicalProblem` | Fehlermeldung bei technischem Problem | Text, beispielsweise Techn. Problem, keine Verbindung | |
| `FriendlyCaptchaV1Denied` | Fehlermeldung, wenn Zugriff verweigert wird | Text | |
| `FriendlyCaptchaV1EmptySolution` | Fehlermeldung, wenn Captcha nicht gelöst wurde | Text | |

##### Konfiguration des CAPTCHA-Systems captcha.eu

```
<Captcha>
  ...
  UseCaptchaEu =
  CaptchaEuPublic-Key =
  CaptchaEuREST-Key =
  CaptchaEuValidation-Url =
  CaptchaEuJS-Url =
  CaptchaEuEmptySolution =
  CaptchaEuTechnicalProblem =
  CaptchaEuResponseError =
  ...
</Captcha>
```

| Parameter | Beschreibung | Werte |
| - | - | - |
| `UseCaptchaEu` | Aktiverung / Deaktivierung für die Verwendung des CAPTCHA-Systems captcha.eu | \* yes \* no \* Standard: no |
| `CaptchaEuPublic-Key` | Public-Key für das Captcha, der von captcha.eu bezogen werden muss | \* Gültiger Key |
| `CaptchaEuREST-Key` | REST-API-Key für das Captcha, der von captcha.eu bezogen werden muss | \* Gültiger Key |
| `CaptchaEuValidation-Url` | Standardwert von captcha.eu | \<[https://w19.captcha.at/validate>](https://w19.captcha.at/validate>) |
| `CaptchaEuJS-Url` | Standardwert von captcha.eu | \<[https://w19.captcha.at/sdk.js>](https://w19.captcha.at/sdk.js>) |
| `CaptchaEuEmptySolution` | Hinweismeldung, wenn keine Lösung des Captchas übergeben werden konnte, das heißt das Captcha konnte nicht gelöst werden | Text |
| `CaptchaEuTechnicalProblem` | Fehlermeldung, wenn ein technisches Problem vorliegt, zum Beispiel captcha.eu ist nicht erreichbar oder der Zugriff verweigert wird | Text |
| `CaptchaEuResponseError` | Hinweismeldung, wenn das Captcha der Menung ist, dass der Nutzer ein “robot” ist. | Text |

Nach der Konfiguration müssen Sie noch die entsprechenden [Anpassungen am InquiryPage-Template](https://dokumentation.websale.de/v8s/upload-modul/formulare-mit-inquiry4/tags-und-templates.md#tags-fur-das-captcha-system-captcha-eu) vornehmen. Die entsprechende Anleitung dazu finden Sie [hier](https://dokumentation.websale.de/v8s/upload-modul/formulare-mit-inquiry4/tags-und-templates.md#tags-fur-das-captcha-system-captcha-eu).

#### Konfiguration des Blacklisting

Alle Einstellungen zu verwendeten Blacklists sind in der Sektion \<Filter> zu finden.

Wenn eigene, lokale Blacklists verwendet werden sollen, werden diese im Online-Servicebereich (OSB) in der INQUIRY-Konfiguration als eigenen config-Dateien angelegt (Format siehe unten).

```
<Filter>
  IP-Blacklisting	=	both
  IP-Blacklist		=	ip.blacklist.config
  MX-Blacklisting	=	both
  MX-Blacklist		=	mx.blacklist.config
  ErrorMessage		=	Ihre IP-Adresse ist gesperrt
</Filter>
```

| Parameter | Beschreibung | Werte |
| - | - | - |
| `IP-Blacklisting` | Legt fest ob geprüft werden soll, ob die IP-Adresse des Anfragenden auf einer Blacklist steht. Ist dies der Fall, kann der Anfragende die Anfrage nicht absenden:  none: keine Prüfung  global: Es wird nur die globale, von der WEBSALE AG gepflegte Blacklist verwendet  (Für weitere Informationen kontaktieren Sie bitte WEBSALE AG)  local: Es wird nur die lokal angegebene Blacklist verwendet  both: Es wird die lokale und die globale Blacklist verwendet | \[none]\[global]\[local]\[both] Standard: none |
| `IP-Blacklist` | Name der lokalen Blacklist-Datei für IP-Adressen  Wird verwendet, wenn für den Parameter IP-Blacklisting "both" oder "local" gesetzt ist. | Beispiel: ip.blacklist.config |
| `MX-Blacklisting` | Legt fest, ob geprüft werden soll, ob einer der MX-Einträge der E-Mail-Adressen des Anfragenden (soweit vorhanden) auf einer Blacklist steht. Ist dies der Fall, kann der Anfragende die Anfrage nicht absenden.  Dies ist vor allem gegen sogenannte "Gewinnspielclubs" ein Ansatz, Spam zu vermeiden!  none: keine Prüfung  global: Es wird nur die globale, von der WEBSALE AG gepflegte Blacklist verwendet  (Für weitere Informationen kontaktieren Sie bitte WEBSALE AG)  local: Es wird nur die lokal angegebene Blacklist verwendet  both: Es wird die lokale und die globale Blacklist verwendet | \[none]\[global]\[local]\[both] Standard: none |
| `MX-Blacklist` | Name der lokalen Blacklist mit MX-Einträgen,  wird verwendet, wenn für den Parameter MX-Blacklisting "both" oder "local" gesetzt ist. Sie kann sowohl Domains als auch IP-Adressen beinhalten. | Beispiel: mx.blacklist.config |
| `ErrorMessage` | Dieser Fehlerstring wird angezeigt, wenn der Anfragende aufgrund einer Blacklist die Anfrage nicht absenden kann. | Text, beispielsweise Ihre IP-Adresse ist gesperrt |

**Format der Blacklist-Dateien**
Pro Zeile kann ein Eintrag stehen, Kommentarzeichen ist #.

**Domains**
Für Domaineinträge kann ein beliebiger Teil der zu sperrenden Domain angegeben werden.

**IP-Adressen**
Es können sowohl Bereiche als auch einzelne IP-Adressen angegeben werden.

**Beispiel:**

```
##########################
# Blacklist für MX-Records
##########################

##########################
# Sperren von Domains:
##########################
# Sperre der Domain xyz.de (Achtung hier wird auch abcxyz.de mit gesperrt!):
xyz.de

# Sperren der Subdomains von xyz.de (Achtung xyz.de wird nicht mitgesperrt, aber z. B. mx0.xyz.de):
.xyz.de

# Sperren von *.abc.xyz.de
.abc.xyz.de

#######################
# Sperren von IP-Adressen
#######################

# Sperre des IP-Bereichs von 13.0.0.0 - 13.255.255.255
13.

# Sperre des IP-Bereichs von 172.16.1.0 - 172.16.1.255
172.16.1.

# Sperren der einzelnen IP-Adresse 172.16.1.10
172.16.1.10

# Teilbereichssperren wie z. B. 172.16.5.12 - 172.16.7.22 sind nicht möglich!
```

#### Fehlermeldungen für den Anwender

Alle konfigurierbaren Fehlermeldungen sind in der Sektion \<ErrorMessages> zu finden.

```
<ErrorMessages>
  Error    			  = Um Ihre Anfrage bearbeiten zu können, prüfen Sie bitte folgende Angaben:
  AddressEmailError   = Rechnungsanschrift: Ungültige E-Mail-Adresse
  DeliverEmailError   = Lieferanschrift: Ungültige E-Mail-Adresse
  CommonInputMissing  = Treffen Sie bitte ihre Wahl / machen Sie folgende Angaben
  NoInput     		  = Füllen sie bitte mindestens ein Feld aus
</ErrorMessages>
```

| Parameter | Beschreibung | Werte |
| - | - | - |
| `Error` | Dieser Fehlerstring wird immer angezeigt, wenn mindestens eine Eingabe fehlt oder falsch ist. Darunter werden dann die Details zu dem (den) Fehler(n) gezeigt. | Text, beispielsweise Um Ihre Anfrage bearbeiten zu können, prüfen Sie bitte folgende Angaben: |
| `AddressEmailError` | Dieser Fehlerstring wird angezeigt, wenn die Überprüfung der E-Mail-Adresse der Rechnungsadresse fehlschlug. | Text, beispielsweise Rechnungsanschrift: Ungültige E-Mail-Adresse |
| `DeliverEmailError` | Dieser Fehlerstring wird angezeigt, wenn die Überprüfung der E-Mail-Adresse der Lieferadresse fehlschlug. | Text, beispielsweise Lieferanschrift: Ungültige E-Mail-Adresse |
| `CommonInputMissing` | Dieser Fehlerstring wird angezeigt, wenn der Benutzer keine Eingaben in einem allgemeinen Anfragefeld (keine Adressdaten) gemacht hat und die Option  `<Basic>   ...   CommonInputRequired = yes   ... </Basic>`  gesetzt ist. Dieser Fehlerstring kann auch leer sein. Die Fehlermeldung wird dann nie angezeigt. | Text, beispielsweise Treffen Sie bitte ihre Wahl / machen Sie folgende Angaben |
| `NoInput` | Dieser Fehlerstring wird angezeigt, wenn überhaupt keine Eingabe gemacht wurde, weder in allgemeinen Feldern noch in Adressfeldern. Dieser Fehlerstring kann auch leer sein. Die Fehlermeldung wird dann nie angezeigt. | Text, beispielsweise Füllen Sie bitte mindestens ein Feld aus |

#### Allgemeine Anfragefelder

INQUIRY4 kann in einem Formular bis zu 1000 allgemeine Anfragefelder bearbeiten. Ein allgemeines Anfragefeld hat folgende Form:

```
<+CommonInput>
  Allow		 = yes
  Type       = CheckBox
  Name       = beratung
  Descr      = Ich möchte Beratung
  Required   = no
  Hide		 = yes
  Max	     = 100
</+CommonInput>
```

| Parameter | Beschreibung | Werte | |
| - | - | - | - |
| `Allow` | Wenn Sie diesen Parameter auf "yes" setzen, dann wird das Feld von INQUIRY4 bearbeitet und kontrolliert. Bei "no" wird das Eingabefeld nicht bearbeitet bzw. ignoriert. | \[yes | no];  Standard: yes |
| `Type` | Typ des Eingabefeldes. | \* Text (einzeilige Textfelder) \* TextArea (Mehrzeilige Textfelder) \* CheckBox \* RadioButton \* ListBox | |
| `Name` | Name des Eingabefeldes, welches Sie im HTML-Formular vergeben.  Bitte beachten Sie:  Die Namen der Eingabefelder müssen für das gesamte Formular eindeutig sein. Ein Feldname, beispielsweise "beratung", darf somit nicht mehrmals vorkommen. Die Namen der allgemeinen Anfragefelder dürfen nicht mi **„A-“** oder **„D-“** beginnen. | Text, beispielsweise beratung | |
| `Descr` | Textuelle Beschreibung des Feldes. Dieser Text erscheint in den E-Mails. | Text, beispielsweise Ich möchte Beratung | |
| `Required` | Wenn Sie diesen Parameter auf "yes" setzen, dann muß dieses Feld vom Anfragenden ausgefüllt oder markiert werden. | \[yes]\[no];  Standard: no | |
| `Hide` | Wenn dieser Parameter auf „yes“ gesetzt wird, wird dieses Feld NICHT in einer automatisch generierten E-Mail erzeugt. | \[yes]\[no];  Standard: no | |
| `Max` | Optional, maximale Länge der Eingabe Wenn dieser Parameter gesetzt ist wird für dieses Eingabefeld maximal die angegebene Anzahl an Zeichen aufgenommen. Der angegebene Wert kann auch per Tag ausgegeben werden um beispielsweise den HTML-Parameter "maxlength" des Eingabefelds anzugeben. | Zeichenanzahl, beispielsweise 100 | |

#### Adressfelder

Adressfelder werden prinzipiell wie die allgemeinen Anfragefelder behandelt, besitzen jedoch jeweils eine eigene, fest definierte Sektion. Der Grund hierfür liegt unter anderem darin, dass INQUIRY4 diese Felder der Adresse bzw. einer optionalen Lieferadresse zuordnet und diese gesondert behandelt.

Felder der Adressdaten beginnen mit „A-“, die der Lieferadresse mit „D-“ (für Delivery). Es werden dabei alle von WEBSALE V8 verwendeten Felder von INQUIRY4 unterstützt.

beispielsweise

| Wert | Feld |
| - | - |
| `Vorname` | `<A-FirstName> ... </A-FirstName>` |
| **Nachname (Lieferadresse)** | `<D-LastName> ... </D-LastName>` |
| `Anrede` | `<A-Salutation> ... </A-Salutation>` |

usw.

Spezialfeld: Das Feld `<A-MerchantEmail>` verhält sich wie ein normales Eingabefeld. Der eingegebene/übergebene Wert wird allerdings als Liste von E-Mail-Adressen (die einzelnen E-Mail-Adressen müssen durch ein Komma voneinander getrennt sein) interpretiert. An diese E-Mail-Adressen wird zusätzlich zu der konfigurierten E-Mail-Adresse die Anfrage-E-Mail gesendet.

#### Sektion SendUserEmail

Dies ist ein spezielles, fest definiertes Feld, welches vorhanden sein muss, wenn der Parameter SendEmail in der Sektion `<ConfirmEmail>` den Wert userselect hat.

Mit diesem Feld wird definiert, über welches HTML-Element der Benutzer steuern kann, ob er eine E-Mail erhält oder nicht.

Das Feld hat die Form:

```
<SendUserEmail>
  Type          	= CheckBox
  Name         	    = confirmemail
  Descr         	= Ich möchte eine Bestätigungsemail erhalten
  UseInput      	= A
</SendUserEmail>
```

| Parameter | Beschreibung | Werte |
| - | - | - |
| `Type` | Typ des Eingabefeldes. | \* CheckBox \* RadioButton \* ListBox |
| `Name` | Name des Eingabefeldes, welches Sie im HTML-Formular vergeben haben. | Text, beispielsweise confirmemail |
| `Descr` | Textuelle Beschreibung des Feldes. | Text, beispielsweiseIch möchte eine Bestätigungs-E-Mail erhalten |
| `UseInput` | Wenn dieser Parameter „A“ ist, wird die E-Mail-Adresse zwingend benötigt, wenn der Benutzer eine Bestätigungsemail wünscht.  Wenn dieser Parameter „D“ ist, wird die optionale E-Mail-Adresse der Lieferadresse zwingend benötigt, wenn der Benutzer eine Bestätigungsemail wünscht.  Wenn dieser Parameter „AD“ ist wird sowohl die E-Mail-Adresse als auch die optionale E-Mail-Adresse der Lieferadresse zwingend benötigt, wenn der Benutzer eine Bestätigungsemail wünscht. | \[A]\[D]\[AD]  Standard: A |

## Verwandte Themen

* [Formulare mit INQUIRY4](https://dokumentation.websale.de/v8s/upload-modul/formulare-mit-inquiry4.md)


## Related topics

- [Globale Konfigurationsdatei](https://dokumentation.websale.de/v8s/upload-modul/formulare-mit-inquiry4/globale-konfiguration.md)
- [Formulare mit INQUIRY4](https://dokumentation.websale.de/v8s/upload-modul/formulare-mit-inquiry4.md)
- [Anhang: Nicht mehr unterstützte Parameter und Tags](https://dokumentation.websale.de/v8s/upload-modul/formulare-mit-inquiry4/anhang.md)
- [FAQ - Häufig gestellte Fragen](https://dokumentation.websale.de/faq-haufig-gestellte-fragen.md)
- [Tags und Templates](https://dokumentation.websale.de/v8s/upload-modul/formulare-mit-inquiry4/tags-und-templates.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.