Lectures Bazar : Concevoir son formulaire (étape 1)

Durée estimée de l'activité en minutes 40

Licence CC-by-SA

Contenu

Les questions à se poser lors de la conception d'un formulaire Bazar

Lorsqu'on conçoit un formulaire, on se pose la question "qu'est-ce que je cherche à savoir ?", autrement dit, « quelles sont les questions auxquelles on souhaite que les utilisateurs répondent ? ».

Cohérence des objectifs

En tant que concepteur, la première question que l'on doit se poser dans ce type de démarche est la suivante : « quel est l'objectif de ce formulaire ? »
Cette question en amène quelques autres sur lesquelles il pourrait être constructif de se pencher.

Cet objectif, que j'imagine, a-t-il été validé par le groupe auquel le formulaire est destiné ?
Quel est mon objectif ?
Les réponses à ces différentes questions sont-elles cohérentes ?

Éviter de vouloir la perfection

Au risque d'enfoncer quelques portes ouvertes et en supposant que le perfection existe…
1 – Le formulaire parfait à vos yeux ne le sera pas nécessairement aux yeux des autres.
2 – Le formulaire parfait, aujourd'hui, ne le sera pas nécessairement demain (et oui, le monde change).

Au delà de ces considérations, voici deux aspects de la conception de formulaire pour lesquels il n'y a pas de bonne réponse absolue.

Le nombre de questions – Vaut-il mieux prévoir un fomulaire le plus complet possible afin d'éviter de solliciter trop souvent la participation ? A contrario, un individu normalement constitué ne risque-t-il pas de se décourager à la vue d'un questionnaire qu'il juge trop long ? Une réponse juste à ces interrogations se trouve peut-être dans les deux considérations suivantes.

Quels sont, pour le groupe, les objectifs de votre formulaire ? Vous y tenez-vous ?
Un individu est beaucoup plus enclin à produire un effort qu'il a décidé. Autrement dit, si vous avez conçu, de manière réellement coopérative, un formulaire, chacune des personnes partie prenante à cette conception sera plus volontiers volontaire pour le remplir.

Les informations obligatoires – Quand on y réfléchit bien, si on pose la question, c'est qu'on veut connaître la réponse. Une conséquence de cela est la tendance à rendre obligatoires beaucoup de questions de notre formulaire.
L'expérience montre que les formulaires comportant trop de questions obligatoires sont peu remplis. Les principales raisons en sont le découragement, d'une part, et, d'autre part, l'impossibilité, parfois, de remplir le formulaire en une fois, du fait de la nature de certaines questions.
Une bonne pratique consiste à se focaliser, pour les questions obligatoires, sur celles pour lesquelles l'absence de réponse priverait la fiche de tout son sens.
On évitera également de rendre obligatoire toute question dont la réponse peut demander une implication trop forte sauf si bien sûr c'est là l'objet du formulaire. Pour illustrer, demander aux gens ce qu'ils vont apporter est acceptable pour l'organisation du goûter de la semaine prochaine, mais risque de décourager quand il s'agit de l'encas de toutes les réunions du CA de l'an prochain (on y est pas encore et ça fait beaucoup).

Testez, corrigez, recommencez (itérations) – La conception du formulaire (1^re phase) va avoir un impact sur son comportement aussi bien lors de la saisie des différentes fiches (2^e phase) que lors de l'affichage de ses résultats (3^e phase). Vous allez donc probablement découvrir des choses en cour de route et devoir adapter votre formulaire (1^re phase).
Ce n'est pas grave !
Il sera donc judicieux de procéder à quelques tests de votre page de saisie et de votre page d'affichage des résultats avant de diffuser massivement les liens vers ces pages. Voire de le faire tester à des collègues qui apporteront leur regard neuf.

Prendre le contrôle sur son collectif

Enfermez vous tout seul chez vous.
Concevez le formulaire parfait.
Imposez à tous les autres de le remplir.
Obligez les à être heureux en consultant les résultats.

Si vous pensez ne pas être capable de réaliser au moins une des étapes ci-dessus, alors vous êtes face à une excellente occasion de mettre en œuvre de la coopération en co-élaborant votre formulaire.

La technique

Accéder à Bazar

Bazar est la partie base de données de YesWiki. On s'y rend de la manière suivante.

Menu roue crantée en haut à droite du wiki.
Entrée « Base de données ».

Notez qu'il faut être connecté avec un compte administrateur du wiki pour pouvoir utiliser certaines fonctionnalités Bazar.

L'écran qui se présente ressemble à ceci (image de droite).

Les différents onglets en haut de cette page permettent d'accéder aux différentes fonctions de Bazar.

« Formulaires » vous permet de gérer vos formulaires.

« Rechercher » vous permet de rechercher parmi les fiches déjà présentes dans vos formulaires.
Vous pouvez également trier vos fiches pour n'afficher que celles appartenant à un formulaire donné.

« Saisir » vous permet de saisir des fiches dans un de vos formulaires.

« Listes » vous permet de créer les listes (et leurs contenus) que vous utiliserez ensuite dans vos formulaires.

« Importer » vous permet d'importer des données en nombre (en provenance d'un tableur par exemple) directement dans un de vos formulaire.

« Exporter » vous permet d'exporter les données d'un de vos formulaire pour un usage externe (dans un tableur par exemple).

Création et modification d'un formulaire Bazar

Pour modifier un formulaire ou utilisera donc le petit bouton en forme de crayon (cf. 7 précédent).
Et, pour créer un nouveau formulaire, on utilisera le bouton « Saisir un nouveau formulaire ».
Les deux boutons envoient sur un écran similaire, vide dans le cas de la création et présentant les questions du formulaire dans le cas d'une modification.

Création d'un formulaire

Modification d'un formulaire

image formulaire_modification.png (75.2kB)

Nom du formulaire

Dans la première zone en haut de l'écran, on saisit (création), ou on trouve (modification), le nom du formulaire.

Ce nom peut être composé de plusieurs mots, comportant éventuellement des caractères accentués.
Il est possible de modifier ce nom par la suite.

Description du fomulaire

Cette zone permet de saisir des explications pour comprendre l'objectif du formulaire depuis l'écran de gestion des formulaires (cf. 1 précédent).

Ajout, suppression et réorganisation des champs du formulaire

Remarque concernant le vocabulaire – Nous appellerons « champ » la mise en œuvre technique d'une question.

Depuis la version Doryphore de YesWiki, la gestion des champs du formulaire se fait au moyen d'un constructeur graphique. Celui-ci permet d'ajouter, modifier, supprimer ou réorganiser des champs dans le formulaire.

image formulaire_constructeur.png (66.3kB)

Ce constructeur graphique se présente en deux parties. Les numéros sur l'image renvoient aux explications ci-dessous.
Dans la partie gauche de l'écran, sont montrés les champs (ou questions) déjà présents avec :

leur libellé (1),
une représentation de leur aspect dans le formulaire final (2),
un petit astérique rouge si le champ est obligatoire (3).

Lorsqu'on déplace le pointeur de la souris au dessus de la zone correspondant au champ, celui-ci devient une poignée (4) qui permet de déplacer le champ pour le positionner à un en autre endroit dans le formulaire.
Apparaissent également au survol de la souris,

un bouton de suppression du champ (5),
un bouton de modification du champ (6),
un bouton de duplication du champ (7).

Dans la partie de droite se trouvent les différents types de champs possibles (8).
En saisissant, dans la partie droite, l'icône d'un type de champs et en la glissant dans la partie gauche, on va ajouter un champ de ce type au formulaire.

image formulaire_constructeur_grab.png (20.0kB)

Une zone noire apparaît alors à l'endroit où le champ sera inséré. Dans l'exemple montré, cette zone est placée en dessous du champ prééxistant.

image formulaire_constructeur_drop_field.png (25.3kB)

En relachant le bouton de la souris, le champ se crée.

image formulaire_constructeur_champ_creation.png (25.2kB)

Modification d'un champ de formulaire

En cliquant sur le petit crayon correspondant à un champ, on peut modifier ses différents paramètres.

Enregistrer

Lorsque vous avez fini de modifier votre formulaire, vous devez valider au moyen du bouton du même nom en bas de page.

Types de champs Bazar

Bazar propose de nombreux types de champs. Voici ceux auxquels vous aurez le plus souvent recours.

DocBazarChampTitre

Lorsqu'on peut énumérer toutes les réponses possibles à une question

Il arrive fréquemment qu'on puisse énumérer (lister) toutes les réponses possibles à une question de notre formulaire, pour exemples : (oui, non) ou encore (sympathisant, adhérent, etc.).

À quoi cela peut-il servir ?

Dans Bazar, cette énumération des réponses possibles se matérialise sous la forme d'une liste ou d'un formulaire dont les différentes fiches constitueront les réponses possibles.

Lors de la phase 1 de conception du formulaire, ces énumérations (listes ou formulaires liés) vont permettre de poser les questions sous forme de :

Lors de la phase 3 d'affichage des résultats du formulaire, le recours à des énumérations permet de proposer des facettes afin que l'utilisateur puisse filtrer parmi les fiches remplies.

Les listes dans Bazar

Bazar permet de définir des listes que vous allez pouvoir utiliser ensuite dans des formulaires.

Gestion des listes

Pour gérer les listes, il faut se rendre sur l'onglet « Listes » de la partie base de données de YesWiki.

Menu roue crantée en haut à droite du wiki.
Entrée « Base de données ».
Onglet « Listes ».

Cet onglet se présente de la manière suivante (les nombres en rouge sur la capture d'écran correspondent aux numéros dans la liste ci-après).

1 – Le nom de la liste. C'est le nom sous lequel cette liste apparaîtra pour vous.
2 – Un aperçu de la liste. En cliquant sur la petite flêche descendante à droite, on peut faire apparaître l'ensemble des valeurs possibles.
3 – Le nom de la liste, vu du côté de YesWiki cette fois. Vous n'aurez a priori pas à utiliser ce nom.
4 – Ce petit bouton en forme de crayon permet d'accéder à la modification de la liste.
5 – Cette petite poubelle permet de supprimer la liste. Attention, il n'y a pas de moyen de récupérer une liste supprimée.
6 – Ce bouton permet de créer une nouvelle liste.
7 – Vous pouvez, si vous avez repéré sur un autre YesWiki une liste qui vous conviendrait, utiliser ce champ pour saisir l'adresse du wiki en question. Vous serez ensuite guidés pour récupérer la ou les listes qui vous intéressent sur ce wiki.

Création ou modification d'une liste

Pour modifier une liste ou utilisera donc le petit bouton en forme de crayon (cf. 4 précédent). Et, pour créer une nouvelle liste, on utilisera le bouton « Saisir une nouvelle liste ».
Les deux boutons envoient sur un écran similaire, vide dans le cas de la céation et chargé du contenu de la liste dans le cas d'une modification.

Création d'une liste

Modification d'une liste

Nom de la liste

Dans la première zone en haut de l'écran, on saisit (création), ou on trouve (modification), le nom de la liste (cf. 1 de la section précédente).

Ce nom peut être composé de plusieurs mots, comportant éventuellement des caractères accentués.
Il est possible de modifier ce nom par la suite.

Saisie ou modification d'une valeur de la liste

Chacune des valeurs de la liste sera saisie dans une ligne de ce type.

On y trouve deux valeurs à saisir et deux boutons.

Le libellé ou texte – C'est le texte ou la valeur qui va s'afficher. Cela peut être un ou plusieurs mots ou des nombres.
La clef ou identifiant unique – C'est le nom que YesWiki va utiliser pour cette valeur.
- Nous recommandons de n'utiliser pour cette clef que des suites de caractères sans accents et sans espaces.
- Même si vous n'en verrez rien, c'est cette clef que YesWiki va stocker dans les fiches de formulaire pour lesquelles les utilisateurs ont choisi cette valeur de liste.
Le bouton de suppression – Ce bouton permet de retirer cette valeur de la liste. Attention :
- une valeur supprimée ne peut pas être restaurée (pas d'annulation de la suppression). Si après avoir supprimé une valeur vous vous rendez compte qu'il s'agissait d'une erreur, vous devrez saisir à nouveau cette valeur.
- Quand vous supprimez une valeur d'une liste, cela ne change rien dans les différentes fiches de formulaires. Autrement dit, supposons que vous ayez une liste (oui, non), et que vous ayez un formulaire d'inscription dans lequel vous demandez au personnes si elles sont adhérentes au moyen de cette liste (oui, non). Si vous supprimer la valeur « oui » de la liste, toutes les fiches pour lesquelles les personnes ont répondu « oui » à la question « Avez-vous adhéré ? » vont conserver cette information.
La poignée de déplacement – Cette poignée permet de changer l'ordre des valeurs dans la liste. Vous pouvez ainsi ajouter des valeurs selon vos besoins, puis réordonner la liste pour qu'elle se présente comme vous le souhaitez (par exemple, dans l'ordre alphabétique).

Ajouter une nouvelle valeur à la liste

Si vous souhaitez ajouter une valeur à votre liste et qu'aucune ligne de saisie n'est vide, vous pouvez en ajouter une au moyen de ce bouton.

Enregistrer

Lorsque vous avez fini d'ajouter des valeurs à votre liste, vous pouvez cliquer sur ce bouton afin de sauvegarder votre liste.

DocBazarChampTexte

DocBazarChampZone

DocBazarChampImage

DocBazarChampUpload

DocBazarChampemail

Champ de type « sélectionner »

En premier lieu ce type de champs nécessite de pouvoir énumérer les différentes valeurs possibles Pour savoir comment faire.
Un champ de ce type permet de proposer à l'utilisateur une liste fermée de choix. Les choix possibles seront présentés sous forme d'une liste déroulante.
En outre, l'utisation de ce type de champ permet d'avoir recours à des facettes pour filtrer parmi les fiches remplies.

Voir l'image du champ en grand

Comme tous les champs celui-ci comporte des paramètres génériques et des paramètres spécifiques.

Paramètres génériques

Certains paramètres sont génériques à tous ou pratiquement tous les types de champs. Ils sont repris ici.

Obligatoire

Ce paramètre permet d'indiquer si répondre à cette question sera obligatoire. Le champ est obligatoire lorsque la case est cochée.

Identifiant unique

Ce paramètre permet de définir le nom du champ pour YesWiki. Ce nom sera utilisé par YesWiki pour identifier le champ et doit donc impérativement être unique. Si un autre champ avait le même identifiant dans votre formulaire, vous observeriez des dysfonctionnements.
Vous n'avez à intervenir sur ce paramètre que dans les rares cas où la documentation le spécifie.

Intitulé

Il s'agit du texte de votre question. YesWiki préremplit ce paramètre avec le type de champ, charge à vous de remplacer cela par un libellé pertinent.

Texte d'aide

Ce paramètre vous permet de saisir un texte d'aide afin d'aiguiller l'utilisateur si vous pensez qu'il peut en avoir besoin pour cette question.

✨ Peut être lu par

image champ_param_access_read.png (3.0kB)

Par défaut, chaque champ peut être lu par toute personne ayant le droit de visualiser une fiche du formulaire. Ce paramètre permet de modifier ce comportement pour le champ en question. On peut ainsi masquer un champ à certains utilisateurs.
Voir la liste des différentes valeurs possibles.

✨ Peut être saisi par

image champ_param_access_write.png (3.0kB)

Par défaut, chaque champ peut être saisi par toute personne ayant le droit de saisir une fiche du formulaire. Ce paramètre permet de modifier ce comportement pour le champ en question. On peut ainsi masquer un champ à certains utilisateurs.
Voir la liste des différentes valeurs possibles.

Paramètres spécifiques au type de champs « sélectionner »

Origine des données

Dans ce paramètre, pour permettre à l'utilisateur de choisir parmi les valeur d'une liste, sélectionnez « une liste ».
Si, au contraire, vous souhaitez permettre à l'utilisateur de choisir parmi des fiches d'un autre formulaire, sélectionnez « Un formulaire Bazar ».

Choix de la liste/du formulaire

Avec ce paramètre vous choisissez la liste (ou le formulaire) à partir de laquelle vous souhaitez que les utilisateurs choisissent.

Valeur par défaut

Ce paramètre vous permet de proposer une valeur par défaut. Si vous n'en précisez pas, c'est le mot « choisir » qui s'affichera jusqu'à ce qu'un choix soit effectué. Attention, pour préciser la valeur par défaut, il faut indiquer sa clef dans la liste (et non pas sa valeur).

Champ de type « groupe de cases à cocher »

En premier lieu ce type de champs nécessite de pouvoir énumérer les différentes valeurs possibles Pour savoir comment faire.
Un champ de ce type permet de proposer à l'utilisateur une liste fermée de choix. Les choix possibles seront présentés sous forme d'un groupe de cases à cocher.
En outre, l'utisation de ce type de champ permet d'avoir recours à des facettes pour filtrer parmi les fiches remplies.

Voir l'image du champ en grand

Comme tous les champs celui-ci comporte des paramètres génériques et des paramètres spécifiques.

Paramètres génériques

Certains paramètres sont génériques à tous ou pratiquement tous les types de champs. Ils sont repris ici.

Obligatoire

Ce paramètre permet d'indiquer si répondre à cette question sera obligatoire. Le champ est obligatoire lorsque la case est cochée.

Identifiant unique

Intitulé

Il s'agit du texte de votre question. YesWiki préremplit ce paramètre avec le type de champ, charge à vous de remplacer cela par un libellé pertinent.

Texte d'aide

Ce paramètre vous permet de saisir un texte d'aide afin d'aiguiller l'utilisateur si vous pensez qu'il peut en avoir besoin pour cette question.

✨ Peut être lu par

✨ Peut être saisi par

Paramètres spécifiques au type de champs « groupe de cases à cocher »

Origine des données

Choix de la liste/du formulaire

Avec ce paramètre vous choisissez la liste (ou le formulaire) à partir de laquelle vous souhaitez que les utilisateurs choisissent.

Valeur par défaut

Champ de type « groupe de boutons radio »

En premier lieu ce type de champs nécessite de pouvoir énumérer les différentes valeurs possibles Pour savoir comment faire.
Un champ de ce type permet de proposer à l'utilisateur une liste fermée de choix. Les choix possibles seront présentés sous forme d'un groupe de boutons radio.
En outre, l'utisation de ce type de champ permet d'avoir recours à des facettes pour filtrer parmi les fiches remplies.

Voir l'image du champ en grand

Comme tous les champs celui-ci comporte des paramètres génériques et des paramètres spécifiques.

Paramètres génériques

Certains paramètres sont génériques à tous ou pratiquement tous les types de champs. Ils sont repris ici.

Obligatoire

Ce paramètre permet d'indiquer si répondre à cette question sera obligatoire. Le champ est obligatoire lorsque la case est cochée.

Identifiant unique

Intitulé

Il s'agit du texte de votre question. YesWiki préremplit ce paramètre avec le type de champ, charge à vous de remplacer cela par un libellé pertinent.

Texte d'aide

Ce paramètre vous permet de saisir un texte d'aide afin d'aiguiller l'utilisateur si vous pensez qu'il peut en avoir besoin pour cette question.

✨ Peut être lu par

✨ Peut être saisi par

Paramètres spécifiques au type de champs « groupe de boutons radio »

Origine des données

Choix de la liste/du formulaire

Avec ce paramètre vous choisissez la liste (ou le formulaire) à partir de laquelle vous souhaitez que les utilisateurs choisissent.

Valeur par défaut

DocBazarChampDate

Champ de type « géolocalisation de l'adresse »

Ce champ n'est pas un vrai champ.
Il s'agit, de fait, d'un outil qui permet de transformer une adresse saisie par un humain en un jeu de coordonnées (longitude et latitude).
Son comportement est donc un peu différent de ce qu'on trouve dans les autres champs.

Notamment, pour trouver les coordonnées d'une adresse, il faut à YesWiki des informations sur celle-ci. Votre formulaire doit donc obligatoirement contenir au moins un des champs suivants (une bonne pratique étant d'en avoir plusieurs, voire tous).

un champ dont l'identifiant unique est « bf_adresse ». S'il n'existe pas, il est d'ailleurs inséré automatiquement lors de la création du champ « géolocalisation de l'adresse » ;
un champ dont l'identifiant unique est « bf_ville » ;
un champ dont l'identifiant unique est « bf_pays ».

Il est indispensable d'avoir un champ de ce type dans votre formulaire si vous souhaitez afficher vos résultats sous forme de carte.

Paramètres du type de champs « géolocalisation de l'adresse »

Obligatoire

Ce paramètre permet d'indiquer si répondre à cette question sera obligatoire. Le champ est obligatoire lorsque la case est cochée.

Nom du champ latitude

Avec ce champ, YesWiki va convertir l'adresse postale en coordonnées. Ce paramètre indique à YesWiki dans quel nom interne il doit donner à la valeur de latitude. Sauf besoin précis, conservez la valeur par défaut qui est « bf_latitude ».

Nom du champ longitude

Avec ce champ, YesWiki va convertir l'adresse postale en coordonnées. Ce paramètre indique à YesWiki dans quel nom interne il doit donner à la valeur de longitude. Sauf besoin précis, conservez la valeur par défaut qui est « bf_longitude ».

Champ de type « titre automatique »

image champ_titre_automatique.png (24.5kB)

Pour qu'un formulaire Bazar fonctionne, il doit contenir un champ titre.
Plus exactement, il doit contenir un champ de type « texte court » dont l'identifiant unique soit « bf_titre ».
Cependant, il n'est pas toujours pertinent de nommer les fiches d'un formulaire à partir du contenu d'un seul champ.
Le champ de type « titre automatique » permet de fabriquer un titre à partir de plusieurs champs. Ce titre sera rempli automatiquement lors de l'enregistrement de chaque fiche.

Comment faire

Laissez le paramètre « Intitulé » tel quel.
Tout se fait avec le paramètre « Valeur ».
Dans « Valeur », pour faire référence à un autre champ, vous devez encadrer son identifiant unique entre des doubles paires d'accolades (ex. : « {{bf_prenom}} », notez bien qu'il y a deux accolades ouvrantes avant l'identifiant unique du champ, et deux accolades fermantes après).
Dans « Valeur », vous pouvez également ajouter du texte, avant, après ou entre les différents champs référencés.
Supprimez le champ titre du formulaire (celui dont l'identifiant unique est « bf_titre »).

Exemples

Il y a très souvent plusieurs manières de faire la même chose. Ces exemples n'ont pour objectif que de faire comprendre le fonctionnement du champ.

Prenons le cas d'un formulaire dans lequel on demande prénom et nom. On peut utiliser le champ titre avec pour libellé « Prénon Nom ». C'est simple, mais outre le fait que cela ne garantit pas que tout le monde saisira son prénom, ou son nom, ou les saisira dans cet ordre, cela ne permet pas de trier les fiches par nom de famille.
Dans ce cas là, on peut :

demander le prénom dans un champ texte court obligatoire dont l'identifiant serait par exemple « bf_text » ;
demander le nom dans un champ texte court obligatoire dont l'identifiant serait par exemple « bf_text1 » ;
ajouter un champ de type « titre automatique » ;
dans le paramètre valeur de ce champ, saisir « {{bf_text}} {{bf_text1}} ».

Dans le cas d'un formulaire d'organisation de goûters, on pourrait souhaiter construire le titre à partir du prénom et de la date du goûter. On pourrait alors avoir un titre tel que : « Théo vient le 14/02/2022 ».
Dans ce cas là, on peut :

demander le prénom dans un champ texte court obligatoire dont l'identifiant serait par exemple « bf_text » ;
demander la date dans un champ date obligatoire dont l'identifiant serait par exemple « bf_date » ;
ajouter un champ de type « titre automatique » ;
dans le paramètre valeur de ce champ, saisir « {{bf_text}} vient le {{bf_date}} ».

Recommandations importantes

Assurez vous que les champs que vous allez utiliser pour construire votre titre sont bien obligatoires.
Il n'y a pas d'aide, ni de contrôle lors de la saisie du paramètre « valeur » du titre automatique. En conséquence, il vous appartient de saisir l'identifiant unique des champs correctement (accolades et identifiant unique correctement écrit).
Supprimez le champ titre du formulaire (celui dont l'identifiant unique est « bf_titre »).
Cela ne fonctionne pas avec tous les types de champs (par exemple, le contenu d'un champ zone de texte ou case à cocher peut difficilement être utilisé pour contruire un titre). Donc, faites des essais avant de demander à tout le monde de saisir.

Paramètres du type de champs « titre automatique »

Intitulé

Laissez ce paramètre en l'état.

Valeur

C'est dans ce paramètre que vous indiquez comment construire le titre.
La référence à un autre champ se fait en écrivant son identifiant unique entre doubles accolades (ex. : « {{bf_text}} ») :

deux accolades ouvrantes (« {{ »),
puis l'identifiant unique du champ,
puis deux accolades fermantes(« }} »).

Vous pouvez ajouter du texte entre les identifiants uniques des champs (espaces, tirets, etc.).

Champ de type « liste des fiches liées »

Ce type de champs permet dans le cas où on un autre formulaire est lié à celui-ci, d'afficher les fiches ainsi liées. Ce champ a donc un comportement un peu spécial, puisque son effet n'est visible que dans la phase 3 d'affichage des résultats du formulaire. Un certain nombre de ses paramètres ne visent d'ailleurs qu'à définir le comportement dans cette phase d'affichage des résultats.

Voir l'image du champ en grand

Comme tous les champs celui-ci comporte des paramètres génériques et des paramètres spécifiques.

Paramètres génériques

Ce type de champ ne reprend que peu des paramètres génériques.

Peut être lu par

Peut être saisi par

Paramètres spécifiques au type de champs « liste des fiches liées »

Id du formulaire lié

Ce paramètre, obligatoire, permet d'identifier le formulaire lié.
Le formulaire lié est celui dans lequel vous avez posé une question (sous forme de liste déroulante, de cases à cocher ou de boutons radio) faisant référence au formulaire courant.
On doit saisir ici l'identifiant Bazar du formulaire lié (point 5 sur cette page).

Query

Ce paramètre fait partie de ceux qui définissent le comportement dans la phase d'affichage des résultats. Ceci explique certaines similitudes. Cependant, ce qui se fait au moyen d'une interface graphique en phase 3 se fait ici avec du pseudo code.

Ce paramètre permet de n'afficher qu'une partie des fiches liées.
Vous trouverez plus d'information sur sa syntaxe ici.

Par défaut, si vous ne saisissez rien, toutes les fiches liées s'afficheront. C'est en général ce qu'on souhaite.

Params de l'action

Ce paramètre fait partie de ceux qui définissent le comportement dans la phase d'affichage des résultats. Ceci explique certaines similitudes. Cependant, ce qui se fait au moyen d'une interface graphique en phase 3 se fait ici avec du pseudo code.

Vous pouvez utiliser ce paramètres pour préciser comment afficher les résultats.
Le plus fréquemment, on veut changer l'ordre d'affichage des fiches liées.
On va, par exemple, les afficher non pas triées par titre, ce qui est le comportement par défaut, mais par ordre antechronologique (si elles comportent un champ date).
Dans cet exemple, on saisira dans ce paramètre : « champ=bf_date ordre=desc ».

« bf_date » est l'identifiant unique du champ date dans le formulaire lié.
« champ=bf_date » indique que l'on triera les fiches liées en utilisant ce champ date.
Et « ordre=desc » indique que le tri sera descendant, c'est à dire des dates les plus récentes aux dates les plus anciennes.
On notera que les deux paramètres sont séparés par un espace.

Vous trouverez plus d'information sur cette syntaxe et les différentes possiblités ici.

Par défaut, si vous ne saisissez rien, les fiches liées s'afficheront triées par ordre alphabétique croissant de leur titre.

Nombre de fiches à afficher

Ce paramètre fait partie de ceux qui définissent le comportement dans la phase d'affichage des résultats. Ceci explique certaines similitudes. Cependant, ce qui se fait au moyen d'une interface graphique en phase 3 se fait ici avec du pseudo code.

Si vous le désirez, vous pouvez préciser ici le nombre de fiches liées à afficher.

Par défaut, si vous ne saisissez rien, toutes les fiches liées s'afficheront. C'est en général ce qu'on souhaite.

Template de restitution

Ce paramètre fait partie de ceux qui définissent le comportement dans la phase d'affichage des résultats. Ceci explique certaines similitudes. Cependant, ce qui se fait au moyen d'une interface graphique en phase 3 se fait ici avec du pseudo code.

De même que dans la phase 3 on choisit la manière d'afficher les fiches, on peut déterminer ici comment montrer les fiches liées. Cependant, il n'y a pas de jolie boîte de dialogue dans laquelle choisir son template d'affichage. Il faut connaître son nom et le saisir.

Par défaut, si vous ne saisissez rien, les fiches liées s'afficheront sous forme de liste en accordéon. C'est en général ce qu'on souhaite.

Type de fiche liée (ou label du champ)

Vous devez préciser ici le type de champ utilisé dans le formulaire lié pour effectuer cette liaison.

« liste » pour une liste déroulante.
« checkbox » pour un groupe de cases à cocher.
« radio » pour un groupe de boutons radio.

Ajouter des onglets à son formulaire

Lorsqu'un formulaire comporte beaucoup de questions ou encore qu'on souhaite séparer les questions les unes des autres pour plus de clarté, on peut, avec Bazar, ajouter des onglets à son formulaire (voir l'exemple ci-contre).
Bazar met deux types de champs à disposition pour cela.

Le type de champs « navigation par onglets »
Le type de champs « passage à l'onglet suivant »

Le champ de type « navigation par onglets » permet de :

déclarer qu'on va utiliser des onglets dans ce formulaire (il n'en faut donc qu'un dans le formulaire),
préciser le nom desdits onglets.

Le champ de type « passage à l'onglet suivant » permet, quant à lui, de :

marquer la fin de chaque onglet (il en faut donc un à la fin de chaque onglet),
préciser le comportement de chaque onglet lors de la saisie et lors de l'affichage.

Champ de type « navigation par onglets »

(Clique sur l'image pour la voir en grand)

Ce champ n'est pas un vrai champ.
Il s'agit, dans les faits, d'un outil qui permet d'ajouter des onglets dans votre formulaire. Ces onglets peuvent être affichés lors de la saisie ou lors de l'affichage d'une fiche du formulaire.
Lorsque vous incorporez un tel champ dans votre formulaire, Bazar ajoute également automatiquement trois champs de type « passage à l'onglet suivant ». Vous pouvez, bien sûr, en ajouter d'autres ou en supprimer selon votre besoin. Il est cependant, très important que le nombre d'onglets soit cohérent avec la valeur des paramètres « Pour le formulaire » et « Pour la fiche » du champ « navigation par onglets ».

Paramètres du type de champs « navigation par onglets »

Pour le formulaire

Ce paramètre définit les onglets affichés lors de la saisie de la fiche.
Si vous ne saisissez rien, il n'y aura pas d'onglets lors de la saisie de la fiche.
Vous devez saisir les noms des différents onglets, dans l'ordre, et en les séparant par des virgules (« , »). Par exemple : « Présentation,Adresse,Produits,Vente ».

Pour la fiche

Ce paramètre définit les onglets affichés lors de l'affichage de la fiche.
Si vous ne saisissez rien, il n'y aura pas d'onglets lors de l'affichage de la fiche.
Vous devez saisir les noms des différents onglets, dans l'ordre, et en les séparant par des virgules (« , »). Par exemple : « Présentation,Adresse,Produits,Vente ».

Déplacer le bouton valider

Ce paramètre permet de déplacer le bouton de validation.

Couleur des boutons

Ce paramètre permet de choisir la couleur des boutons placés à la fin des onglets.
Par défaut, ils seront dans la couleur primaire du wiki. Vous avez le choix parmi la palette de couleurs du wiki.

Taille des boutons

Ce paramètre permet de réduire la taille des boutons des onglets.

Champ de type « passage à l'onglet suivant »

(Clique sur l'image pour la voir en grand)

Ce champ n'est pas un vrai champ.
Il s'agit, dans les faits, d'un outil qui permet délimiter un onglet en en marquant la fin tout en précisant quand cet onglet doit être affiché (saisie, affichage).
Lorsque vous incorporez un tel champ dans votre formulaire, Bazar comprend qu'il doit terminer, à l'emplacement du champ, l'onglet en cours.

Paramètres du type de champs « passage à l'onglet suivant »

Pour le formulaire

Ce paramètre définit si l'onglet est affiché lors de la saisie de la fiche.
Par défaut, l'onglet est affiché lors de la saisie de la fiche.
Attention à être cohérent avec ce que vous avez saisi pour le paramètre « Pour le formulaire » du champ de type « navigation par onglets ».

Pour la fiche

Ce paramètre définit si l'onglet est affiché lors de l'affichage de la fiche.
Par défaut, l'onglet n'apparaît pas lors de l'affichage de la fiche.
Attention à être cohérent avec ce que vous avez saisi pour le paramètre « Pour la fiche » du champ de type « navigation par onglets ».

Le code derrière les champs Bazar

Que se passe-t-il lorsque j'utilise le constructeur graphique de formulaire bazar ?

Lorsquʼon crée ou modifie un formulaire bazar, deux méthodes nous sont offertes. La méthode par défaut dans doryphore est le constructeur graphique.

Celui-ci permet de construire son formulaire de manière relativement intuitive sans avoir recours à du code puisque son rôle est justement dʼécrire le code pour vous.

Il est cependant parfois utile de comprendre ce qui se passe derrière. Nous allons donc lʼillustrer avec deux exemples, le cas dʼun champ texte, et celui dʼun groupe de cases à cocher.

Tout dʼabord, quelques petites règles simples :

à chaque champ placé dans le constructeur graphique, correspond une ligne dans lʼonglet « code » ;
lʼordre est le même dans les deux onglets (les champs dans le constructeur graphique sont dans le même ordre que les lignes correspondantes dans lʼonglet « code » ;
chaque ligne de code est composée de plusieurs paramètres et ces différents paramètres sont séparés par des groupes de trois astérisques (***) ;
le premier de ces paramètres indique toujours le type de champ.

Voyons maintenant ce qui se passe dans le cas dʼun champ texte.

Lʼimage ci-dessous montre la façon dont ce qui est rempli dans le constructeur graphique pour un champ texte se retrouve dans la ligne correspondante du code.

Si on regarde la ligne de code (on se rappelle que les différents paramètres sont délimités par « *** ») on constate, par exemple, que :

le 1^er paramètre contient bien le type de champ,
dans le 2^e on retrouve le nom du champ,
le libellé du champ est dans le 3^e paramètre,
les 4^e et 5^e paramètres contiennent les nombres de caractères affichés et maximum respectivement,
le 9^e paramètre indique que le champ est obligatoire (« 1 »),
le 11^e paramètre contient le texte dʼaide,
le 12^e paramètre indique que le champ peut être lu par tout le monde (« »). Tous ces détails et bien dʼautres encore se trouvent sur la page https://yeswiki.net/?ChampsPossibles Regardons à présent les différences dans le cas dʼun champ de type groupe de cases à cocher.*

Lʼimage ci-dessous montre la façon dont ce qui est rempli dans le constructeur graphique pour un groupe de cases à cocher se retrouve dans la ligne correspondante du code.

Le comportement est identique à celui que lʼon a vu pour un champ de type texte à la différence de :

le 1^er champ dans le constructeur graphique (intitulé «nom ») est vide et nʼa pas de correspondance dans la ligne de code ;
le 2^e paramètre de la ligne de code contient le nom de la liste utilisée pour ce groupe de cases à cocher ;

La page de référence pour retrouver le rôle de chacun des paramètres des codes de champ bazar est : https://yeswiki.net/?ChampsPossibles

Activer les commentaires ? Oui

Activer les réactions ? Oui

Lectures Bazar : Concevoir son formulaire (étape 1)

Les questions à se poser lors de la conception d'un formulaire Bazar

Cohérence des objectifs

Éviter de vouloir la perfection

Prendre le contrôle sur son collectif

La technique

Accéder à Bazar

Accéder à Bazar

Gestion des formulaires Bazar

Création et modification d'un formulaire Bazar

Création et modification d'un formulaire Bazar

Nom du formulaire

Description du fomulaire

Ajout, suppression et réorganisation des champs du formulaire

Modification d'un champ de formulaire

Enregistrer

Types de champs des formulaires Bazar

Types de champs Bazar

/!\ À ne jamais oublier – Le titre /!\

✨ Quand on connait déjà toutes les réponses possibles à une question

Lorsqu'on peut énumérer toutes les réponses possibles à une question

À quoi cela peut-il servir ?

Utiliser une liste

Les listes dans Bazar

Gestion des listes

Création ou modification d'une liste

Nom de la liste

Saisie ou modification d'une valeur de la liste

Ajouter une nouvelle valeur à la liste

Enregistrer

✨ Utiliser un autre formulaire en tant que liste

Texte court

Zone de texte

Image

Upload de fichier

Email

Sélectionner

Champ de type « sélectionner »

Paramètres génériques

Obligatoire

Identifiant unique

Intitulé

Texte d'aide

✨ Peut être lu par

✨ Peut être saisi par

Paramètres spécifiques au type de champs « sélectionner »

Origine des données

Choix de la liste/du formulaire

Valeur par défaut

Groupe de cases à cocher

Champ de type « groupe de cases à cocher »

Paramètres génériques

Obligatoire

Identifiant unique

Intitulé

Texte d'aide

✨ Peut être lu par

✨ Peut être saisi par

Paramètres spécifiques au type de champs « groupe de cases à cocher »

Origine des données

Choix de la liste/du formulaire

Valeur par défaut

Groupe de boutons radio

Champ de type « groupe de boutons radio »

Paramètres génériques

Obligatoire

Identifiant unique

Intitulé

Texte d'aide

✨ Peut être lu par

✨ Peut être saisi par

Paramètres spécifiques au type de champs « groupe de boutons radio »

Origine des données

Choix de la liste/du formulaire

Valeur par défaut

Champ date

Géolocalisation de l'adresse

Champ de type « géolocalisation de l'adresse »

Paramètres du type de champs « géolocalisation de l'adresse »

Obligatoire