Inquiry

Inquiry-Aktionen für Anfragen: Kontakt- und Anfrageformulare sowie Frage-zum-Produkt-Formulare im Frontend absenden und auswerten.

In diesem Abschnitt werden die verfügbaren Aktionen im Bereich Inquiry beschrieben. Mit diesen Aktionen können beispielsweise Kontakt- oder Anfrageformulare abgesendet werden.

---

​

Aktionen im Überblick

Aktion	Beschreibung
InquirySend	Sendet ein Anfrage-Formular mit den angegebenen Parametern ab.
InquiryCheck	Prüft die Eingaben eines Formulars, ohne es abzusenden.

---

​

Aktionen

​

InquirySend

Mit dieser Aktion wird ein Anfrage-Formular abgesendet. Dabei werden die übermittelten Eingaben geprüft und die Anfrage verarbeitet. Schlägt die Verarbeitung fehl, wird ein entsprechender Fehler zurückgegeben, sodass der Nutzer seine Eingaben korrigieren kann.

Anwendungsbeispiel
Nutzbar, um beispielsweise ein Kontaktformular auf einer Seite einzubinden, über das Kunden Anfragen stellen können. Nach dem Klick auf “Absenden” wird das Formular validiert und die Anfrage übermittelt.

Parameter

Parameter	Beschreibung
email	Die E-Mail-Adresse des Absenders. Pflichtangabe.
formId	Die ID des abzusendenden Formulars.
form.(fieldname)	Die Werte der Formularfelder. Die Feldnamen entsprechen den Feldern des Formulars in der Formularkonfiguration, beispielsweise form.comment. Werden keine Felder übergeben, gibt die Aktion den Fehlercode emptyForm zurück.

Fehler

Fehlercode	Beschreibung
missingEmail	Es wurde keine E-Mail-Adresse angegeben.
emailCheckFailed	Die angegebene E-Mail-Adresse ist ungültig oder konnte nicht geprüft werden.
emptyForm	Das Formular enthält keine Eingaben.
missingFormId	Es wurde keine Formular-ID übergeben.
invalidFormId	Die angegebene Formular-ID ist nicht gültig.
formCheckFailed	Die Formularprüfung ist fehlgeschlagen. Ist ein Pflichtfeld leer, lautet der Sub-Code des Feldes formCheck.required. Der Fehlertext dazu stammt aus missingField in actions - Formulare.
createInquiryFailed	Die Anfrage konnte nicht erstellt werden.

Wenn für das Formular eine Captcha-Prüfung konfiguriert ist und diese fehlschlägt, gibt die Aktion den Fehlercode captchaFailed zurück. Weitere Feldprüfungen des Formulars (beispielsweise die maximale Länge) melden ebenfalls formCheckFailed mit dem jeweiligen Sub-Code, beispielsweise dataChecker.maxLength.

Zugehörige Module, Variablen & Methoden

• $wsForm
• $wsForm.inquiryId
• $wsForm.loadType()
• $wsForm.load()

Beispiel, das die Aktion erstellt, per Hidden-Input an das Formular bindet und nach dem Absenden auf Erfolg oder Fehler prüft.

{{ var $cMyInquirySendAction = $wsActions.create('InquirySend') }}

<form method="post" data-ws-ajax-form>
   <input type="hidden" name="wscsrf" value="{{= $cMyInquirySendAction.csrf }}">
   <input type="hidden" name="wsact"  value="{{= $cMyInquirySendAction.id }}">
   <input type="hidden" name="formId" value="productQuestion">

   {{ if $cMyInquirySendAction.success }}
      <div class="alert alert-success">%%InquirySuccessTxt%%</div>
   {{ else }}
      <input type="email" name="email" class="form-control">
      <textarea name="form.comment" class="form-control"></textarea>
      <button type="submit" class="btn btn-primary">%%InquirySendButtonTxt%%</button>
   {{ /if }}
</form>

---

​

InquiryCheck

Mit dieser Aktion werden die Eingaben eines Formulars geprüft, ohne die Anfrage tatsächlich abzusenden. Die geprüften Feldwerte werden dabei in $myField.value zurückgeschrieben und können im Frontend wiederverwendet werden.

Anwendungsbeispiel
Nutzbar, um Formulareingaben bereits vor dem endgültigen Absenden zu validieren und dem Nutzer direktes Feedback zu seinen Eingaben zu geben.

Parameter

Name	Beschreibung
form.(fieldname)	Die aktuellen Werte der Formularfelder, anhand derer die Regeln des Formulars ausgewertet werden.

Fehlercodes

Die Aktion selbst gibt keine Fehlercodes zurück. Sie speichert die übermittelten Feldwerte lediglich zur Auswertung der Regeln im Template ab. Die eigentliche Prüfung samt Fehlercodes erfolgt erst beim Absenden mit der Aktion InquirySend.

Zugehörige Module, Variablen & Methoden

• $wsForm
• $wsForm.loadType()

Beispiel folgt.