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 z.B. Kontakt- oder Anfrage-Formulare 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 z.B. ein Kontaktformular auf einer Seite einzubinden, über das Kunden eine Anfrage 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.
formId	Die ID des abzusendenden Formulars.

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.
createInquiryFailed	Die Anfrage konnte nicht erstellt werden.

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">
      <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
email	Die E-Mail-Adresse des Absenders.
formId	Die ID des zu prüfenden Formulars.

Fehlercodes

Fehlercode	Beschreibung
missingEmail	Es wurde keine E-Mail-Adresse angegeben.
emailCheckFailed	Die angegebene E-Mail-Adresse ist ungültig.
missingFormId	Es wurde keine Formular-ID übergeben.
invalidFormId	Die angegebene Formular-ID ist nicht gültig.
formCheckFailed	Die Formularprüfung ist fehlgeschlagen.

Zugehörige Module, Variablen & Methoden

• $wsForm
• $wsForm.loadType()

Beispiel folgt.