La plateforme Koumoul permet de définir des règles de saisie des données afin de limiter les valeurs des colonnes de vos jeux de données.

Dans ce cours, nous expliquons d'abord comment limiter les valeurs d'une colonne numérique pour que les utilisateurs ne puissent renseigner que des nombres entiers entre 1 et 99 999.
Dans une seconde partie, nous utiliserons une expression régulière de codes postaux que l'on peut retrouver dans les schémas du gouvernement, comme le schéma des jeux de données des Défibrillateurs Automatisés Externes (DAE) :

Commençons par créer un jeu de données éditable avec une colonne de type nombre.

Sur la page des jeux de données de votre compte, cliquez sur créer un jeu de données.
Choisissez le type éditable.
Renseignez un titre à votre jeu de données et cliquez plusieurs fois sur continuer pour le créer.

Dans le schéma de votre jeu de données, cliquez sur le bouton (+) pour ajouter une colonne.

Renseignez la clé de votre colonne (2) (ici, nous avons choisi le nom de clé num) et le type de la colonne (3) (ici, nombre entier, car nous ne souhaitons que des entiers dans la colonne).

Cliquez sur valider.

À présent, ajoutons une règle sur l'intervalle des nombres entiers.

Cliquez sur la colonne que vous venez d'ajouter (4). Cliquez ensuite sur le bouton des règles de la colonne (5) (configuration de la validation des données).
Renseignez les valeurs minimale et maximale (6).
Enfin, cliquez sur le bouton appliquer (7) pour valider l'ajout de votre colonne avec ses règles.

Pour vérifier que votre règle est bien définie sur votre colonne, vous pouvez faire un test d'ajout d'une ligne sur les données.

Dans la section données de votre page, cliquez sur le bouton (+) pour ajouter une ligne.
Renseignez une valeur supérieure à 99 999 dans le champ => Un message d'erreur sera affiché sous la section.

Le bouton enregistrer n'est disponible que pour une valeur comprise entre 1 et 99 999.

Le parcours pour ajouter une expression régulière sur une colonne est très similaire au parcours que réalisé dans la première partie de ce cours.

Dans cette seconde partie, nous allons :

1. Ajouter une colonne de type texte à notre jeu de données éditable,
2. Rechercher l'expression régulière sur un schéma de schema.data.gouv.fr,
3. Ajouter l'expression régulière sur notre colonne textuelle.

Sur l'image, nous avons ajouté la colonne code à l'aide du bouton (+) de la section du schéma.
Il s'agit d'une colonne de type texte.

Nous recherchons ensuite l'expression régulière d'un code postal sur le site de schema.data.gouv.fr.

Dans la section de recherche du site schema.data.gouv.fr, renseignez DAE, puis cliquez sur la fiche.

Cliquez ensuite sur l'onglet documentation et recherchez le champ d'un code postal sur la page.

Copiez l'expression régulière ^\d{5}$.

À présent, ajoutons l'expression régulière aux règles de notre colonne.

Sur la page de votre jeu de données sur Koumoul, cliquez sur votre colonne (1), puis sur le bouton des règles de la colonne (2), renseignez l'expression régulière (3), enfin, appliquez les changements (4).

Une nouvelle colonne est disponible dans vos données ; si vous ajoutez une valeur qui ne correspond pas à 5 chiffres, un message d'erreur s'affichera.

Si vous ajoutez la valeur 56000 (code postal de la ville de Vannes) et que vous enregistrez votre ligne, elle apparaîtra alors dans la section des données de votre jeu de données.

Dans ce cours, nous avons utilisé des jeux de données éditables pour restreindre les valeurs des données.

Il est également possible de renseigner des règles par colonne sur des jeux de données créés à l'aide de fichiers. Le jeu de données sera réindexé au moment de valider la règle et les lignes qui ne la respectent pas seront indiquées dans le message d'erreur.

Par exemple, nous avons coché la case information obligatoire sur la colonne parcellede notre jeu de données.
Après réindexation du jeu de données, le journal nous informe que 98 lignes de notre jeu de données n'ont pas de valeur renseignée pour la colonne parcelle :

Si vous avez des remarques sur ce cours, n'hésitez pas à nous contacter pour nous en faire part.