actions - Formulare

Shopaktionen zum Absenden von Formularen: Konfiguration von Fehlertexten und E-Mail-Vorlagen für Kontakt-, Anfrage- und Serviceformulare im Shop.

Auf dieser Seite sind alle Aktionen zum Absenden von Formularen aufgeführt. Hier werden die entsprechenden Meldungen und E-Mail-Vorlagen dokumentiert, die beim Absenden von Formularen über den Shop ausgegeben werden. Dies betrifft beispielsweise Meldungen bei Kontakt-, Anfrage- oder Serviceformularen.

**Fehlertexte sind schreibgeschützt.** Die Fehlercode-Felder auf dieser Seite enthalten den Namen eines Textbausteins (ws.error.<configId>.<errorCode>), nicht den Fehlertext. Gepflegt wird der Text ausschließlich im Textbaustein-Dienst des Admin-Interface – Änderungen an der Konfiguration werden beim Speichern abgewiesen, auch über die [REST API](/schnittstellen/admin-interface-api/api-referenz-konfiguration). E-Mail-Vorlagen sind nicht betroffen.

​

actions.inquirySend - Formular absenden

Mithilfe der Aktion inquirySend werden die Fehlermeldungen beim Absenden eines Kontakt- oder Anfrageformulars gesteuert.

​

Beispielkonfiguration actions.inquirySend

{
  "errorCodes": {
    "captchaFailed": "<Textbaustein>",
    "missingEmail": "<Textbaustein>",
    "emailCheckFailed": "<Textbaustein>",
    "emptyForm": "<Textbaustein>",
    "missingField": "<Textbaustein>",
    "missingFormId": "<Textbaustein>",
    "invalidFormId": "<Textbaustein>",
    "createInquiryFailed": "<Textbaustein>"
  }
}

​

Parameterübersicht

Parameter	Typ	Beschreibung
errorCodes	object	Konfiguriert die Fehlercodes, die bei Problemen während der Aktion verwendet werden.
captchaFailed	string	Fehlermeldung, die ausgegeben wird, wenn die Captcha-Prüfung fehlschlägt. Dieser Text wird über einen Textbaustein realisiert. Alles zu Textbausteinen in Konfigurationen finden Sie hier.
missingEmail	string	Fehlermeldung, die ausgegeben wird, wenn keine E-Mail-Adresse angegeben wurde, obwohl sie erforderlich ist. Dieser Text wird über einen Textbaustein realisiert. Alles zu Textbausteinen in Konfigurationen finden Sie hier.
emailCheckFailed	string	Fehlermeldung, die ausgegeben wird, wenn die angegebene E-Mail-Adresse als ungültig erkannt wird. Dieser Text wird über einen Textbaustein realisiert. Alles zu Textbausteinen in Konfigurationen finden Sie hier.
emptyForm	string	Fehlermeldung, die ausgegeben wird, wenn das abgesendete Formular leer ist. Dieser Text wird über einen Textbaustein realisiert. Alles zu Textbausteinen in Konfigurationen finden Sie hier.
missingField	string	Fehlermeldung, die ausgegeben wird, wenn ein Pflichtfeld des Formulars nicht ausgefüllt wurde. Der Shop gibt sie für jedes leere Pflichtfeld aus. Dieser Text wird über einen Textbaustein realisiert. Alles zu Textbausteinen in Konfigurationen finden Sie hier.
missingFormId	string	Fehlermeldung, die ausgegeben wird, wenn keine Formular-ID übermittelt wurde. Dieser Text wird über einen Textbaustein realisiert. Alles zu Textbausteinen in Konfigurationen finden Sie hier.
invalidFormId	string	Fehlermeldung, die ausgegeben wird, wenn die angegebene Formular-ID ungültig ist oder das Formular nicht gefunden werden kann. Dieser Text wird über einen Textbaustein realisiert. Alles zu Textbausteinen in Konfigurationen finden Sie hier.
createInquiryFailed	string	Fehlermeldung, die ausgegeben wird, wenn die Anfrage technisch nicht gespeichert oder weitergeleitet werden konnte. Dieser Text wird über einen Textbaustein realisiert. Alles zu Textbausteinen in Konfigurationen finden Sie hier.

In der Antwort der Aktion InquirySend wird für das betroffene Feld die Meldung missingFields mit dem Fehlercode formCheckFailed und dem Sub-Code formCheck.required ausgegeben. Die Meldung captchaFailed erscheint nur, wenn für das Formular eine Captcha-Prüfung konfiguriert ist.

​

actions.inquiryCheck - Formular prüfen

Die Aktion inquiryCheck überprüft den aktuellen Formularinhalt, ohne das Formular abzusenden. Dabei werden die im verknüpften RuleSet (siehe inquiry - Formulare) definierten Regeln ausgewertet und die Feld-Attribute ($field.required, $field.label, $field.defaultValue, $field.value, $field.visible) entsprechend aktualisiert. Beispielsweise können Felder ein- oder ausgeblendet, als Pflichtfeld markiert oder mit einem Standardwert vorbelegt werden.

Die Aktion kann als Autosubmit auf dem <form>-Element verwendet werden, sodass bei jeder Eingabeänderung automatisch eine neue Prüfung ausgelöst wird. Das Formular kann sich so dynamisch an die Eingaben des Nutzers anpassen.