Documentation Frappe Framework

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.

2 min de lectureMis à jour le Source : docs.frappe.io

À 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

  1. Le répondant ouvre le formulaire par un lien privé.
  2. Il n’a pas forcément de compte.
  3. Le formulaire contient des valeurs qui lui sont propres.
  4. 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 :

ChampEffet
Expires OnDate et heure de fin de validité de la clé
Web Form ValuesJSON affiché dans le formulaire, modifiable par le répondant
Doc ValuesJSON 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églageEffet sur la demande
Allow Multiple ResponsesLa même clé envoie plusieurs réponses. La demande ne peut pas avoir de Reference Docname.
Allow Editing After SubmitUne clé liée à une réponse peut la rouvrir et la modifier.
Allow DeleteUne clé liée à une réponse peut la supprimer.