Dans ce tutoriel, nous allons découvrir comment configurer un connecteur de catalogue uData pour importer des données dans Data Fair ou publier des métadonnées sur uData(data.gouv.fr).

Ce cours vous guidera pour récupérer un jeu de données depuis data.gouv.fr et partager vos données à l'aide de votre clé d'API data.gouv.fr

Pour ce faire, vous devrez :

1. Créer une clé d'API sur data.gouv.fr (obligatoire pour publier des jeux de données au nom de votre organisation)
2. Configurer un catalogue
3. Publier un jeu de données
4. Importer un jeu de données
5. Planifier une mise à jour automatique

Pour obtenir votre clé d'API :

1. Connectez-vous sur data.gouv.fr.
2. Accédez à la page de votre profil.
3. En bas de page, vous pourrez :
   • Générer une nouvelle clé (ou en régénérer une existante) [1],
   • Copier votre clé actuelle [2].

Cette clé d'API vous donne accès à l’ensemble des jeux de données pour lesquels vous disposez des droits sur data.gouv.fr.
Copiez la valeur de cette clé, elle sera nécessaire pour configurer votre catalogue dans Data Fair.

Les connecteurs sont configurables sur la page catalogue.

1. Page des connecteurs
2. Configurer 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 uData.

Vous êtes ensuite invité à choisir le propriétaire du connecteur si vous appartenez à plusieurs organisations ou départements.

Ensuite, remplissez les informations concernant votre catalogue, notamment le titre du connecteur [1], l'adresse du portail [2] auquel vous souhaitez vous connecter et renseignez la clé d'API générée précédemment [3].
Dans la barre des organisations [4], recherchez celle où vous souhaitez publier vos données, puis cliquez sur Créer pour générer votre catalogue.

Votre connecteur au portail https://www.data.gouv.fr/ est alors disponible.
Vous pouvez publier ou importer des données.

Pour publier un jeu de données Data Fair dans un catalogue uData, commencez par vous assurer qu’il est préalablement publié sur un portail Data Fair.

Vous pouvez vérifier cette condition directement depuis la page d’édition du jeu de données.

Une fois que votre jeu de données est publié sur un de vos portails, vous pouvez le publier les metadonnées sur un catalogue uData.

Sur la page de votre connecteur, cliquez sur Créer une nouvelle publication.

1. Commencez par sélectionner votre jeu de données sur Data Fair
2. Séléctionnez Créer un nouveau jeu de données sur le catalogue distant
3. Indiquez le portail surlequel vous diffusez votre jeu de données

Après avoir créé votre publication, une fiche récapitulative s’affiche.

Elle inclut :

1. L’accès à la page de publication sur le catalogue distant
2. Un bouton de republication du jeu de données
3. La possibilité de supprimer la publication du catalogue distant

Dans notre exemple, nous avons publié un jeu de données privé de Data Fair (via le compte de l’organisation Koumoul), avec les caractéristiques suivantes :

1. Visibilité : Le jeu de données, privé sur Data Fair, apparaît en brouillon sur data.gouv.fr. Il deviendra public automatiquement si vous modifiez sa visibilité en public sur Data Fair
2. Métadonnées : Elles sont automatiquement synchronisées avec le catalogue distant (une modification des métadonnées sur Data Fair est propagée sur uData).
3. Liens inclus dans la publication : un lien vers votre portail Data Fair d’origine, un lien de téléchargement direct (pour les jeux de données sous forme de fichiers) et lien vers l’API du jeu de données. Un lien vers les pièces jointes est aussi disponible, si vous les avez paramétrées pour une publication sur le catalogue.

Les métadonnées synchronisées incluent :

1. Titre
2. Description
3. Licence
4. Mots-clés
5. Fréquence de mise à jour
6. Couverture temporelle

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 du portail distant.

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 le portail uData distant, qui comprend plus de 69 000 jeux de données sur https://www.data.gouv.fr/.

Nous allons effectuer une recherche sur la ville de rennes [1] et sélectionner les Prénoms à Rennes [2]. Une peublication d'un jeu de donnée sur uData est sous forme d'un dossier. Dans ce dossier plusieurs ressources sont disponibles. Nous allons selectionner le fichier CSV [3]. Une fois le jeu de données sélectionné, cliquez sur le bouton Suivant [4].

Pour cette dernière étape, vous avez la possibilité d'utiliser le titre/la description de la publication distante, forcer la mise à jour des métaonnées ou du schéma, ou encore de planifier une mise à jour automatique.

Ces étapes ne seront pas abordées dans ce chapitre, vous pouvez donc cliquer sur le bouton Importer.

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 le portail distant [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. Touts les mois
2. le 4 du mois
3. A 5h du matin
4. et 6 minutes

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

Avec cette planification, le jeu de données sera mis à jour les 4 de chaque mois à 5h06 du matin.

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