Zum Hauptinhalt springen
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

AktionBeschreibung
InquirySendSendet ein Anfrage-Formular mit den angegebenen Parametern ab.
InquiryCheckPrü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
ParameterBeschreibung
emailDie E-Mail-Adresse des Absenders.
formIdDie ID des abzusendenden Formulars.
Fehler
FehlercodeBeschreibung
missingEmailEs wurde keine E-Mail-Adresse angegeben.
emailCheckFailedDie angegebene E-Mail-Adresse ist ungültig oder konnte nicht geprüft werden.
emptyFormDas Formular enthält keine Eingaben.
missingFormIdEs wurde keine Formular-ID übergeben.
invalidFormIdDie angegebene Formular-ID ist nicht gültig.
formCheckFailedDie Formularprüfung ist fehlgeschlagen.
createInquiryFailedDie Anfrage konnte nicht erstellt werden.
Zugehörige Module, Variablen & Methoden 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
NameBeschreibung
emailDie E-Mail-Adresse des Absenders.
formIdDie ID des zu prüfenden Formulars.
Fehlercodes
FehlercodeBeschreibung
missingEmailEs wurde keine E-Mail-Adresse angegeben.
emailCheckFailedDie angegebene E-Mail-Adresse ist ungültig.
missingFormIdEs wurde keine Formular-ID übergeben.
invalidFormIdDie angegebene Formular-ID ist nicht gültig.
formCheckFailedDie Formularprüfung ist fehlgeschlagen.
Zugehörige Module, Variablen & Methoden Beispiel folgt.