Formulaire
Publie un formulaire web et démarre le workflow à chaque envoi.
Fonctionnement
Page publique servie par Orkyvo, sans compte. Les réponses sont validées par le serveur (champs requis, e-mail, nombre, date, choix proposés, fichiers de 2 Mo, 4 Mo au total), débit limité par formulaire. Avec « Attendre la fin du workflow », la page suit l'exécution : pages suivantes (bloc « Formulaire : page suivante »), puis page de fin ou message par défaut.
Paramètres
| Paramètre | Type | Détail |
|---|---|---|
| Chemin de la pageobligatoire | texte | Minuscules, chiffres, tirets. Adresse : /formulaire/<workflow>/<chemin>, active après publication. |
| Titreobligatoire | texte | — |
| Texte d'introduction | texte long | — |
| Champsobligatoire | champs de formulaire | — |
| Libellé du bouton | texte | — |
| Après l'envoi | choix | Valeurs : Afficher aussitôt le message de confirmation, Attendre la fin du workflow (pages suivantes, page de fin). |
| Titre de confirmationselon les autres paramètres | texte | — |
| Message de confirmationselon les autres paramètres | texte long | — |
| Exemple de réponse (exécution manuelle) | JSON | — |
Données reçues et renvoyées
- EntréeAucune entrée.
- SortieUn élément : { …champs, submittedAt, formMode }, fichiers en propriétés binaires (nom du champ, ou nom_0, nom_1… pour un champ multiple).
Erreurs
Réponse refusée (erreurs affichées par champ dans la page), formulaire inconnu ou workflow inactif (404), débit dépassé (429), quota atteint.
À savoir. Les champs cachés reprennent le paramètre d'URL de même nom : /formulaire/…/contact?source=salon.
À savoir. Le formulaire est servi dans l'environnement par défaut de l'organisation.
Exemple
Paramètres d'un bloc prêt à l'emploi. Dans l'éditeur, l'onglet Aide du bloc applique cet exemple en un clic.
{
"path": "inscription",
"title": "Inscription à l'atelier",
"fields": [
{
"id": "a",
"name": "nom",
"label": "Nom",
"type": "text",
"required": true
},
{
"id": "b",
"name": "email",
"label": "E-mail",
"type": "email",
"required": true
},
{
"id": "c",
"name": "session",
"label": "Session",
"type": "radio",
"options": "Matin\nAprès-midi",
"required": true
}
],
"respondWhen": "submitted"
}Voir aussi
- Déclencheur manuelDémarre le workflow depuis le bouton « Exécuter », avec une entrée JSON facultative.
- PlanificationDémarre le workflow selon un intervalle, chaque jour, chaque semaine ou une expression cron, dans le fuseau choisi.
- WebhookDémarre le workflow à la réception d'une requête HTTP sur une URL propre à ce déclencheur.