Version de développement
Cette documentation décrit la version « next » (develop), non encore publiée. Pour la version stable, basculez sur « v5 » dans l'en-tête.
Site web

Créer et partager un formulaire web

Collectez des informations dans Dokos avec un formulaire web, choisissez son accès et testez les réponses avant de partager le lien.

Créer et partager un formulaire web

Un formulaire web recueille des informations depuis le portail et les enregistre dans un type de document choisi. Il peut être public, demander une connexion ou exiger un lien avec une clé.

Choisissez d'abord les informations à recueillir et les personnes autorisées à répondre. La création d'un formulaire web et d'une demande de formulaire web demande le rôle Responsable du site web.

Choisir où enregistrer les réponses

Le formulaire web utilise les données d'un type de document existant. Si aucun ne correspond à votre besoin, faites créer un formulaire personnalisé avant de publier la collecte.

Par exemple, une enquête doit enregistrer ses réponses dans le formulaire prévu pour l'enquête. Elle ne doit pas donner accès à la fiche client pour identifier le répondant.

Consultez Créer un type de document pour préparer une structure personnalisée.

Créer le formulaire

  1. Ouvrez la recherche (Ctrl+K) et saisissez « Formulaire web ».
  2. Créez un formulaire et indiquez son titre.
  3. Dans Sélectionner un type de document, choisissez le type de document qui recevra les réponses.
  4. Définissez la Route, qui forme l'adresse du formulaire sur votre site.
  5. Ajoutez une introduction qui explique le but de la collecte.
  6. Sélectionnez les informations à demander.
  7. Configurez l'accès et le message de confirmation.
  8. Enregistrez. Cochez Publié quand vos contrôles sont terminés.

L'option de formulaire standard sert aux formulaires livrés par une application. Conservez un formulaire personnalisé pour vos propres collectes.

Organiser les informations avec l'éditeur visuel

L'onglet Formulaire de l'éditeur visuel organise les informations en pages, sections et colonnes. Ajoutez uniquement les données nécessaires à la collecte.

Le sélecteur de champs permet de rechercher les informations du type de document source et de choisir celles à ajouter. Les champs déjà présents ou incompatibles ne peuvent pas être ajoutés une seconde fois.

Déplacez les éléments dans l'éditeur pour modifier leur ordre. Le tableau de configuration des champs et l'éditeur décrivent le même formulaire.

Exemple — Maison Verte SARL L'équipe prépare une enquête avec une page pour les coordonnées et une autre pour le retour du client. Elle teste ensuite le formulaire sur le portail.

Vous pouvez marquer les informations indispensables comme obligatoires. L'option autorisant les formulaires incomplets change cette contrainte et doit être choisie en fonction du traitement prévu.

Les tableaux permettent de saisir plusieurs lignes. Vérifiez l'ajout, la modification et la suppression des lignes sur le portail. Pour les pièces jointes, ajoutez un champ adapté et vérifiez la taille maximale autorisée.

Un formulaire vide peut être enregistré pendant sa préparation. Il doit être testé avec ses informations définitives avant diffusion. L'éditeur signale les limites de pages lorsque vous les atteignez.

Le panneau de propriétés d'un champ affiche en premier le Libellé personnalisé, car c'est la propriété la plus fréquemment modifiée. Les autres propriétés suivent dans leur ordre habituel.

Lorsque vous sélectionnez une page, une section ou une colonne, le panneau de propriétés n'affiche que les propriétés utilisées par ces éléments de mise en page : le libellé, la description, le masquage et la condition d'affichage. Les propriétés propres aux champs de saisie, comme le caractère obligatoire ou les options, ne sont pas affichées pour ces éléments.

Présenter un formulaire en plusieurs pages

Lorsque le formulaire comporte plusieurs pages, un indicateur de progression compact s'affiche en haut du formulaire, au-dessus des champs. Il porte le nom de la page en cours et sa position dans le formulaire. Il est visible en saisie comme en consultation d'une réponse.

Le nom d'une page provient du libellé de son saut de page. Une page sans libellé est nommée d'après sa position : « Page 1 », « Page 2 », etc. Un saut de page placé en première ligne nomme la première page.

La navigation entre les pages se fait avec les boutons « Précédent » et « Suivant ». L'indicateur n'est pas cliquable.

Puisque l'indicateur affiche déjà le nom de la page, le titre de la page n'est pas répété au-dessus des champs. Les titres des sections à l'intérieur d'une page restent visibles.

Sur un formulaire d'une seule page, aucun indicateur n'apparaît. Si cette page porte un nom, ce nom reste affiché comme titre au-dessus des champs.

Choisir qui peut répondre

L'accès dépend des options du formulaire. Une connexion et une clé peuvent être exigées ensemble.

OptionEffet
Connexion obligatoireRefuse l'envoi par un visiteur non connecté. Masquée si Réponses anonymes est cochée.
Clé requiseExige une clé de Demande de formulaire web dans l'adresse.
Réponses anonymesEnregistre la réponse au nom de l'invité (Guest), même si le répondant est connecté.
Autoriser la réception de réponses multiplesPermet plusieurs réponses par répondant. Visible avec une connexion ou une clé.
Autoriser les modification après la validationPermet de modifier une réponse envoyée. Visible avec une connexion ou une clé.
Autoriser les suppressionsPermet de supprimer une réponse. Visible avec les réponses multiples.
Afficher la listeAffiche au répondant la liste de ses réponses. Visible avec une connexion ou une clé.
Appliquer les autorisations du documentApplique les autorisations du type de document aux réponses existantes.
BesoinConfiguration
Collecte ouverteNe pas exiger de connexion ni de clé. Toute personne disposant de l'adresse peut envoyer une réponse.
Collecte réservée aux utilisateurs connectésExiger une connexion, puis vérifier les autorisations adaptées au public concerné.
Invitation par lien individuelActiver Clé requise et créer une Demande de formulaire web.

N'accordez pas des droits généraux d'écriture au rôle Guest pour rendre un formulaire public. Les soumissions passent par les contrôles du formulaire web.

L'option qui applique les autorisations du document concerne l'accès aux documents existants. Testez séparément la création, la consultation et la modification avec le profil du destinataire.

Envoyer un lien avec une clé

Une Demande de formulaire web associe une clé au formulaire choisi. Elle peut définir une expiration et des valeurs préremplies.

  1. Activez Clé requise sur le formulaire web.
  2. Créez une Demande de formulaire web pour ce formulaire.
  3. Définissez une date d'expiration dans le futur si l'invitation doit être limitée dans le temps. Une date passée est refusée.
  4. Faites configurer les valeurs préremplies si nécessaire.
  5. Enregistrez la demande. Dokos génère une clé en lecture seule.
  6. Partagez le lien avec son destinataire.

Le paramètre de l'adresse est web_form_request_key :

https://votre-site.example/<route-du-formulaire>?web_form_request_key=<cle-generee>

La clé donne accès selon les options du formulaire. Toute personne qui reçoit ce lien peut l'utiliser dans ces limites. Ne le publiez pas dans une page ouverte à tous.

Les champs Valeurs du formulaire web et Doc Values acceptent un objet JSON indexé par le nom technique des champs.

Valeurs du formulaire web définit les valeurs préremplies dans le formulaire. Le répondant peut les modifier avant l'envoi. Exemple : {"first_name": "Jane"}.

Doc Values définit les valeurs appliquées au document lors de la soumission, côté serveur. Elles ne sont pas préremplies dans le formulaire et sont renvoyées avec le document enregistré. Exemple : {"status": "Open"}.

Leur configuration utilise les noms techniques des données et nécessite l'aide d'un administrateur.

Une valeur cachée dans la présentation n'est pas une protection d'accès. Évitez de placer des données confidentielles dans les paramètres de l'URL.

Demander la modification d'un document

Vous pouvez générer un lien de modification depuis la fiche d'un document. Le type de document doit avoir un formulaire web Publié, avec Clé requise et Autoriser les modification après la validation cochées.

  1. Ouvrez le document concerné dans Dokos.
  2. Dans le menu du formulaire, sélectionnez Demander via un formulaire web (libellé non traduit). Ce menu apparaît pour un document enregistré, si vous avez la permission d'écriture sur le document et le droit de créer une demande de formulaire web.
  3. Dans la boîte de dialogue, choisissez le formulaire web à utiliser.
  4. Dans Expire le, gardez la date proposée (dans sept jours) ou choisissez une autre date future.
  5. Cliquez sur Copier le lien pour copier l'adresse. Vous pouvez aussi cliquer sur Lien par e-mail (libellé non traduit) : Dokos ouvre l'éditeur d'email avec le lien.
  6. La boîte de dialogue liste les demandes antérieures du document, par pages de 20, avec leur statut : « Utilisé », « Expiré » ou « Non utilisé ». Seules les demandes non expirées ont un bouton pour copier le lien.

Le lien a la forme https://votre-site.example/<route>/<nom-du-document>/edit?web_form_request_key=<cle>. Il permet au destinataire de modifier ce document.

Exemple fictif : vous demandez à un client de compléter sa fiche. Le formulaire web « Mise à jour client » porte sur le type Client, avec Clé requise et la modification autorisée. Depuis la fiche du client, vous envoyez le lien par email. Le client a sept jours pour l'utiliser.

Suivre et modifier les réponses

Les réponses sont enregistrées dans le type de document sélectionné. Consultez sa liste dans Dokos pour les traiter.

Les options du formulaire déterminent si le destinataire peut consulter une liste, modifier une réponse, la supprimer ou en créer plusieurs. Ces actions restent soumises aux contrôles d'accès du formulaire.

Avec une clé, l'accès aux documents existants est limité aux références de la demande correspondante. Les références sont suivies par Dokos. Elles ne permettent pas de consulter un autre type de document, comme une fiche client depuis une enquête.

Une clé expirée est refusée. Une demande déjà utilisée ne permet pas une nouvelle création si les soumissions multiples sont désactivées. La consultation ou la modification d'une réponse reste liée aux options du formulaire.

La date de première utilisation est enregistrée lors d'une opération sur un document, pas à la simple ouverture du lien.

Préparer la présentation et la confirmation

Ajoutez une image de bannière, une introduction et un Message de succès adaptés à la collecte. Pour rediriger le visiteur après l'envoi, renseignez le Lien de succès.

Les métadonnées définissent le titre, la description et l'image utilisés pour présenter la page. Pour insérer le formulaire dans un autre site, listez ce site dans Domaines dans lequel le formulaire est autorisé.

Les styles CSS et les scripts clients répondent à des besoins de personnalisation avancée. Faites-les vérifier par un développeur, puis testez de nouveau le formulaire sur le portail.

Les options de paiement dépendent des applications installées. Si votre formulaire en propose, configurez la passerelle, le montant fixe ou sa donnée source, puis testez le parcours de paiement.

Tester avant de partager

Testez le formulaire avec le même mode d'accès que les destinataires. Un essai connecté comme administrateur ne valide pas le parcours d'un visiteur.

  1. Ouvrez le lien dans une session correspondant au public prévu.
  2. Envoyez une réponse et contrôlez le document créé dans Dokos.
  3. Vérifiez les informations obligatoires, les pièces jointes et le message de confirmation.
  4. Si l'accès utilise une clé, testez une clé valide et une clé expirée.
  5. Testez les options de consultation, modification et suppression que vous avez activées.

Voir aussi