> ## Documentation Index
> Fetch the complete documentation index at: https://dokumentation.websale.de/llms.txt
> Use this file to discover all available pages before exploring further.

# actions - Formulare

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

export const TextbausteinHinweis = () => <>
    Dieser Text wird über einen Textbaustein realisiert.<br />
    Alles zu Textbausteinen in Konfigurationen finden Sie{" "}
    <a href="https://dokumentation.websale.de/konfiguration#verwendung-von-textbausteinen-in-konfigurationen">hier</a>.
  </>;

Diese Seite enthält alle Aktionen, die das Absenden von Formularen betreffen. Hier werden die zugehörigen Meldungen und E-Mail-Vorlagen dokumentiert, die beim Versenden von Formularen über den Shop ausgegeben werden – beispielsweise bei Kontakt-, Anfrage- oder Serviceformularen.

## `actions.inquirySend` - Formular absenden

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

#### Beispielkonfiguration `actions.inquirySend`

```json theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{
  "errorCodes": {
    "captchaFailed": "<Textbaustein>",
    "missingEmail": "<Textbaustein>",
    "emailCheckFailed": "<Textbaustein>",
    "emptyForm": "<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. <br /><br /><TextbausteinHinweis />                                                      |
| `missingEmail`        | string  | Fehlermeldung, die ausgegeben wird, wenn keine E-Mail-Adresse angegeben wurde, obwohl sie erforderlich ist. <br /><br /><TextbausteinHinweis />                    |
| `emailCheckFailed`    | string  | Fehlermeldung, die ausgegeben wird, wenn die angegebene E-Mail-Adresse als ungültig erkannt wird. <br /><br /><TextbausteinHinweis />                              |
| `emptyForm`           | string  | Fehlermeldung, die ausgegeben wird, wenn das abgesendete Formular leer ist. <br /><br /><TextbausteinHinweis />                                                    |
| `missingFormId`       | string  | Fehlermeldung, die ausgegeben wird, wenn keine Formular-ID übermittelt wurde. <br /><br /><TextbausteinHinweis />                                                  |
| `invalidFormId`       | string  | Fehlermeldung, die ausgegeben wird, wenn die angegebene Formular-ID ungültig ist oder das Formular nicht gefunden werden kann. <br /><br /><TextbausteinHinweis /> |
| `createInquiryFailed` | string  | Fehlermeldung, die ausgegeben wird, wenn die Anfrage technisch nicht gespeichert oder weitergeleitet werden konnte. <br /><br /><TextbausteinHinweis />            |

## `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](/konfiguration/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.