Frappe Framework
Web Form Request
La demande crée une clé privée pour un formulaire web. Le répondant n’a pas besoin de compte. Certaines valeurs ne partent pas dans le navigateur.
À quoi sert la demande
Une demande de formulaire web (Web Form Request) crée un lien privé vers un Web Form. Le formulaire n’est pas entièrement public, et le répondant peut quand même l’envoyer sans compte. Exemple : un lien d’enquête de satisfaction, des valeurs déjà remplies pour le client, et des champs internes invisibles dans le navigateur.
Le formulaire lui-même se crée comme indiqué dans Web Form : présentation.
Quand l’utiliser
- Le répondant ouvre le formulaire par un lien privé.
- Il n’a pas forcément de compte.
- Le formulaire contient des valeurs qui lui sont propres.
- Le document cible a des valeurs cachées, absentes de la page.
Créer
Créez une Web Form Request et choisissez le Web Form. Une clé sûre pour une URL est générée. On peut définir :
| Champ | Effet |
|---|---|
| Expires On | Date et heure de fin de validité de la clé |
| Web Form Values | JSON affiché dans le formulaire, modifiable par le répondant |
| Doc Values | JSON appliqué au document à la soumission, non envoyé au navigateur |
L’adresse est /your-web-form-route/new?web_form_request_key=<key>. On la copie depuis le formulaire de la demande.
Clé obligatoire
Key required sur le Web Form exige une clé valide. Sans clé valide, le formulaire ne s’ouvre pas et ne s’envoie pas. Si Login required est aussi coché, il faut être connecté et fournir une clé valide.
Valeurs
Web Form Values vise les champs visibles. Ils doivent figurer dans la table des champs du Web Form. Doc Values vise les champs du document qui restent invisibles. Ils doivent exister sur le DocType cible. Les clés JSON sont les noms de champs, par exemple customer et survey_source.
Expiration et réemploi
Après Expires On, la clé ne sert plus. Sur un formulaire à réponse unique, la demande est marquée utilisée après l’envoi et liée au document créé. La même clé peut ensuite modifier ou supprimer cette réponse si les réglages du Web Form le permettent. Avec Allow multiple responses, la clé sert plusieurs fois et n’est pas liée à un seul document.
| Réglage | Effet sur la demande |
|---|---|
| Allow Multiple Responses | La même clé envoie plusieurs réponses. La demande ne peut pas avoir de Reference Docname. |
| Allow Editing After Submit | Une clé liée à une réponse peut la rouvrir et la modifier. |
| Allow Delete | Une clé liée à une réponse peut la supprimer. |
