# Formulaire - Déclencheur de workflow | Docs - nodulz

Source: https://nodulz.com/fr/docs/nodes/form

Language: fr

Recevoir des réponses via un formulaire personnalisable, en plusieurs étapes, intégrable dans un site.

## Utilisation et spécificités

Définissez les champs et leur validation, puis publiez pour exposer le formulaire. Configurez ses restrictions d’accès et son message de confirmation. Un test local ne prouve pas l’accès au formulaire public.

Type technique : `form`. Runtime : `nodulz`.

## Identifiants et prérequis

Aucun identifiant externe dédié n’est défini par ce nœud. Les sources distantes ou la cible d’exécution peuvent néanmoins nécessiter leurs propres accès.

Consultez le [guide des identifiants](/docs/credentials) si une source distante ou une cible d’exécution nécessite un accès.

## Paramètres

Les noms ci-dessous correspondent aux clés techniques. Les valeurs par défaut ne constituent pas une configuration prête à exécuter : renseignez les champs requis par votre opération. Les chemins contenant [] décrivent les éléments d’une liste ; certains champs dépendent du mode sélectionné.

| Paramètre | Type | Par défaut | Valeurs / limites |
| --- | --- | --- | --- |
| `title` | `string` | `""` | -; max 300 |
| `description` | `string` | `""` | -; max 5000 |
| `submitLabel` | `string` | `""` | -; max 100 |
| `successTitle` | `string` | `""` | -; max 300 |
| `successMessage` | `string` | `""` | -; max 5000 |
| `logoUrl` | `union` | `""` | - |
| `coverUrl` | `union` | `""` | - |
| `primaryColor` | `string` | `"#181818"` | - |
| `buttonTextColor` | `string` | `"#ffffff"` | - |
| `backgroundColor` | `string` | `"#f4f4f4"` | - |
| `surfaceColor` | `string` | `"#ffffff"` | - |
| `textColor` | `string` | `"#181818"` | - |
| `font` | `enum` | `"sans"` | `sans`, `serif`, `mono` |
| `radius` | `number` | `12` | -; ≥ 0, ≤ 32 |
| `maxWidth` | `number` | `680` | -; ≥ 320, ≤ 1200 |
| `alignment` | `enum` | `"left"` | `left`, `center` |
| `showProgress` | `boolean` | `true` | - |
| `steps` | `array` | `[""]` | -; min 1, max 20 |
| `fields` | `array` | `[]` | -; max 100 |
| `fields[].name` | `string` | - | - |
| `fields[].label` | `string` | - | -; min 1, max 300 |
| `fields[].type` | `enum` | `"text"` | `text`, `textarea`, `email`, `number`, `tel`, `url`, `date`, `select`, `radio`, `multiselect`, `checkbox` |
| `fields[].placeholder` | `string` | `""` | -; max 300 |
| `fields[].help` | `string` | `""` | -; max 2000 |
| `fields[].required` | `boolean` | `false` | - |
| `fields[].step` | `number` | `0` | -; ≥ 0 |
| `fields[].width` | `enum` | `"full"` | `full`, `half` |
| `fields[].options` | `array` | `[]` | -; max 100 |
| `fields[].min` | `number` | - | - |
| `fields[].max` | `number` | - | - |
| `fields[].minLength` | `number` | - | -; ≥ 0, ≤ 10000 |
| `fields[].maxLength` | `number` | - | -; ≥ 1, ≤ 10000 |
| `fields[].condition` | `object` | - | - |
| `fields[].condition.field` | `string` | - | - |
| `fields[].condition.operator` | `enum` | `"equals"` | `equals`, `not_equals`, `contains`, `is_empty`, `is_not_empty` |
| `fields[].condition.value` | `string` | `""` | -; max 10000 |
| `rateLimitEnabled` | `boolean` | - | - |
| `rateLimitMax` | `number` | - | -; > 0 |
| `rateLimitWindowMs` | `number` | - | -; > 0 |
| `allowedIps` | `array` | - | -; max 256 |
| `blockedIps` | `array` | - | -; max 256 |
| `path` | `string` | `""` | -; max 64 |
| `publicEnabled` | `boolean` | `false` | - |
| `embedEnabled` | `boolean` | `false` | - |

## Aide de configuration

| Réglage | Rôle et conseils |
| --- | --- |
| `path`<br>Adresse du formulaire | Identifiant unique : 3 à 64 lettres minuscules, chiffres ou tirets. |
| `embedEnabled`<br>Code d’intégration | Coller ce code dans votre site. La largeur et la hauteur de l’iframe sont modifiables. L’accès public doit aussi être activé. |

## Configuration initiale

Exemple de configuration initiale du catalogue, à adapter avant exécution. Les secrets doivent rester dans les identifiants.

```json
{
  "path": "",
  "publicEnabled": false,
  "embedEnabled": false,
  "steps": [
    ""
  ],
  "fields": []
}
```

## Vérification

Testez le nœud avec des données représentatives. Contrôlez sa sortie dans l’inspecteur et les logs, puis utilisez le mapping de l’éditeur pour les champs des nœuds suivants. Un test de déclencheur avec payload simulé ne valide pas la livraison du service externe.

Voir aussi : [Expressions et données](/docs/expressions), [Exécutions](/docs/executions), [Catalogue des nœuds](/docs/nodes).

## Pour aller plus loin

- [Fonctionnalités - nodulz](https://nodulz.com/fr/product/overview)
- [Catalogue des nœuds - nodulz](https://nodulz.com/fr/product/catalog)
- [Serveur MCP - nodulz](https://nodulz.com/fr/product/mcp)
- [Tarifs - nodulz](https://nodulz.com/fr/pricing)
- [Cas d’usage et automatisations - nodulz](https://nodulz.com/fr/use-cases)
- [Choisissez ce que vos workflows peuvent faire. - nodulz](https://nodulz.com/fr/compare)
- [Documentation - nodulz](https://nodulz.com/fr/docs)