Identifiants des enregistrements

TID et séquence

Chaque enregistrement dans Goupile dispose de deux identifiants uniques :

• L'identifiant TID, qui est une chaîne de 26 caractères encodant le moment de l'enregistrement et une partie aléatoire (ex : 01K5EY3SCEM1D1NBABXXDZW7XP).
• L'identifiant de séquence, qui est un nombre incrémenté à chaque enregistrement, en commençant par 1.

Pour chaque page du formulaire, il est possible de définir un identifiant supplémentaire dit summary, qui sera affiché à la place de la date dans le tableau récapitulatif des enregistements (voir capture ci-dessous).

XXX: CAPTURES

Pour ce faire, assignez une valeur à meta.summary comme illustré dans l'example ci-dessous :

form.number("num_inclusion", "Numero d'inclusion")
meta.summary = values.num_inclusion

Compteurs personnalisés

TODO

Randomisation

TODO

Erreurs et annotations

Contrôles de saisie

Les options mandatory, ainsi que min et max présents sur le widget form.number sont simplement des raccourcis pour gérer les erreurs les plus courantes. Cependant, comme le formulaire est programmé en JavaScript, vous pouvez utiliser programmer détecter toutes sortes de conditions d'erreur en les programmant !

Prenons l'exemple du widget de texte suivant : form.text("*num_inclusion", "N° d'inclusion"). Celui-ci enregistre une chaine de caractères JavaScript (ou string). Vous pouvez par exemple utiliser l'ensemble des méthodes présentes ici : https://developer.mozilla.org/fr/docs/Web/JavaScript/Reference/Global_Objects/String pour déclencher une erreur.

L'example ci-dessous valide la valeur d'un numéro d'inclusion à l'aide d'une expression régulière :

// Les valeurs sont mises à undefined quand elles sont vides. Il faut donc vérifier qu'il y a une valeur avant d'appeler une méthode sur celle-ci pour éviter une erreur JavaScript, c'est ce que nous faisons dans la condition ci-dessous.

if (values.num_inclusion && !values.num_inclusion.match(/^[0-9]{5}$/))
    form.error("num_inclusion", "Format incorrect, 5 chiffres sont attendus")

Voici un autre exemple dans lequel le numéro d'inclusion suit une logique différente :

if (values.inclusion_num && !values.inclusion_num.match(/^(REN|GRE|CFD|LRB|STE)[A-Z][a-z][A-Z]$/))
    form.error("inclusion_num", html`Format incorrect.<br/> Renseigner le code centre (REN, GRE, CFD, LRB, STE)  puis les 2 premières lettres du Nom puis la première lettre du Prénom.<br/>Exemple : Mr Philippe DURAND à Rennes : 'RENDuP'`)

Par défaut, l'erreur est affichée immédiatement pendant la saisie. Il est possible de faire en sorte que l'erreur ne s'affiche qu'après une tentative d'enregistrement en ajoutant un troisième paramètre lors de l'appel à form.error() :

// L'option { delayed: true } à la fin de form.error() indique que l'erreur est retardée à la validation

if (values.num_inclusion && !values.num_inclusion.match(/^[0-9]{5}$/))
    form.error("num_inclusion", "Format incorrect (5 chiffres attendus)", { delayed: true })

Annotations de saisie

Rédaction en cours

Manipulation des valeurs

Données d'autres pages

thread

Profil de l'utilisateur

profile

Ajout de fichiers et d'images

Il est possible d'intégrer des images, des vidéos, des PDF et tous types de fichiers, qui seront directement hébergés par Goupile. Pour cela, ouvrez le panneau de publication (accessible au-dessus de l'éditeur), puis cliquez sur le lien « Ajouter un fichier » [1].

Vous pouvez ensuite sélectionner un fichier à ajouter depuis votre ordinateur, et le renommer si vous le souhaitez. Vous pouvez également le mettre en arborescence en lui donnant un nom tel que « images/alpes/montblanc.png ».

Une fois le fichier ajouté, vous pouvez directement y faire référence dans vos pages à l'aide du widget form.output. Le code HTML suivant vous explique comment afficher le logo Apple, à partir d'un fichier images/apple.png ajouté au projet :

form.output(html`
    <img src=${ENV.urls.files + 'images/apple.png'} alt="Logo Apple" />
`)

L'utilisation de ENV.urls.files pour construire l'URL vous garantit une URL qui changera à chaque publication du projet, pour éviter des problèmes liés au cache des navigateurs. Cependant, chaque fichier est aussi accessible via /projet/files/images/alpes/montagne.png, et cette URL est stable depuis l'extérieur de Goupile.