Grist permet, entre autre, de créer des tableurs collaboratifs. Vous pouvez ainsi éditer vos données à plusieurs et en temps réél pour créer vos jeux de données.

Dans ce tutoriel, nous allons découvrir comment configurer un connecteur de Grist pour importer des données dans Data Fair en suivant ces étapes :

1. Créer votre catalogue
2. Importer le jeu de données
3. Planifier une mise à jour automatique

Les connecteurs de catalogues permettent de lister l'ensemble des jeux de données d'un catalogue distant pour les importer sur votre compte Data Fair.

Les connexteurs sont configurables sur le Back-Office Data Fair, sur la page catalogues.

1. Page des connecteurs
2. Créer votre connecteur

Après avoir cliqué sur le bouton pour créer votre connecteur [2], vous êtes redirigé vers la page de choix du catalogue distant.
Pour notre cours, nous allons choisir le catalogue Grist.

Une fois que vous avez sélectionné le catalogue Grist, vous serez invité à spécifier le propriétaire du connecteur si vous faites partie de plusieurs organisations ou départements.

Pour configurer un connecteur Grist, la première étape consiste à créer clé d'API dans les paramètres de votre compte Grist. Cette clé servira d'authentification pour permettre au connecteur d'interagir avec vos jeux de données Grist.

Pour configurer votre connecteur, commencez par indiquer son titre [1].
Ensuite, renseignez l'URL de Grist (ici https://grist.numerique.gouv.fr ) [2].
Puis, insérez la valeur de votre clé d'API dans l'espace dédié à cet effet [3] et enfin, finalisez la création de votre connecteur en cliquant sur le bouton "Créer".

Votre connecteur est maintenant opérationnel et lié à votre compte Grist.
Nous pouvons à présent procéder à l'importation d'un jeu de données.

L'import d'un jeu de données est réaliser en quelque clics, le téléchargement dépendra de la taille du fichier et du temps de réponse de l'API Grist.

Sur la page des imports de votre nouveau connecteur, cliquez sur le bouton pour créer un nouvel import.

Vous êtes redirigé vers la liste des jeux de données disponibles sur compte Grist.

Sur notre compte Grist, vous aurez accès aux données de votre équipe, ou aux données "Personal (@votrenom)" et aux templates. Dans notre dossier "Personal (@votrenom)" nous avons créé un table nouveau JDD.

Accédez au répertoire souhaité [1] et choisissez la table qui vous intéresse [2].

Cliquez sur le bouton "Suivant" et enfin "Importer" pour lancer l'import de votre jeu de données.

L'import se lance au moment de cliquer sur le bouton importer. L'import peut etre assez long si vous avez choisir un fichier de plusieurs Mo ou Go.

Une fois l'import términé, les étapes d'execution[1] sont disponibles sur la page.
Les boutons pour acceder au jeu de données sur Data Fair [2] et ainsi que la page du jeu de données sur votre compte Grist [3] sont disponibles.

Le jeu de données que vous avez importé sur Data Fair est disponible après la phase de finalisation.

Nous allons configurer une mise à jour automatique à intervalles réguliers, toutes les heures précisément. Cela permettra de maintenir les données constamment à jour sans intervention manuelle.

Cliquez sur le bouton de plannification et renseignez les informations suivantes :

Sur l'image, nous avons planifié la mise à jour comme suit :

1. Toutes les heures
2. Intervalle d'une heure et à la 30e minute

Le bouton crayon [3] vous permet de finaliser l'édition de la planification et d'enregistrer.

Avec cette planification, le jeu de données sera mis à jour toutes les heures à la 30e minute.

La planification s'est bien déroulée et le dernier import a été réalisé à 16h30.

Si vous avez des remarques sur ce cours, n'hésitez pas à nous les communiquer.