Inquiry

This section describes the available actions in the Inquiry area. With these actions, contact or inquiry forms, for example, can be submitted.

Actions overview

Action	Description
`InquirySend`	Submits an inquiry form with the specified parameters.
`InquiryCheck`	Checks the inputs of a form without submitting it.

Actions

InquirySend

This action submits an inquiry form. The submitted entries are checked and the inquiry is processed. If processing fails, a corresponding error is returned so the user can correct their entries. Usage example
Useful for embedding a contact form on a page through which customers can submit inquiries. After clicking “Submit”, the form is validated and the inquiry is transmitted. Parameters

Parameter	Description
`email`	The sender’s email address. Required.
`formId`	The ID of the form to be submitted.
`form.(fieldname)`	The values of the form fields. The field names correspond to the fields of the form in the form configuration, for example `form.comment`. If no fields are passed, the action returns the error code `emptyForm`.

Errors

Error code	Description
`missingEmail`	No email address was specified.
`emailCheckFailed`	The specified email address is invalid or could not be verified.
`emptyForm`	The form contains no entries.
`missingFormId`	No form ID was passed.
`invalidFormId`	The specified form ID is not valid.
`formCheckFailed`	The form check failed. If a required field is empty, the field’s sub-code is `formCheck.required`. The corresponding error text comes from `missingField` in actions - Forms.
`createInquiryFailed`	The inquiry could not be created.

If a captcha check is configured for the form and it fails, the action returns the error code captchaFailed. Other field checks of the form (for example, the maximum length) also report formCheckFailed with the respective sub-code, for example dataChecker.maxLength. Related modules, variables & methods

Example that creates the action, binds it to the form via a hidden input, and checks for success or error after submission.

{{ 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

This action checks the inputs of a form without actually submitting the inquiry. The checked field values are written back to $myField.value and can be reused in the frontend. Usage example
Useful for validating form inputs before final submission and giving the user direct feedback on their entries. Parameters

Name	Description
`form.(fieldname)`	The current values of the form fields, based on which the form’s rules are evaluated.

Error codes The action itself does not return any error codes. It merely stores the submitted field values for evaluating the rules in the template. The actual check, including error codes, only takes place on submission with the InquirySend action. Related modules, variables & methods

Example to follow.

Frontend

The basics

Getting started

Feature overview

Examples

Reference – Actions

Reference – Language

Reference – Modules

Actions overview

Actions

InquirySend

InquiryCheck

​Actions overview

​Actions

​InquirySend

​InquiryCheck

Actions overview

Actions

InquirySend

InquiryCheck