Mettre en place un moissonneur entre DataSud et Data.gouv

La procédure est relativement simple et elle se décompose en plusieurs étapes :

1. Vous créez une organisation sur data.gouv.fr avec un compte utilisateur administrateur de l’organisation.

2. Vous créez un moissonneur depuis l’interface d’administration de data.gouv.fr qui vient se brancher sur les données de votre organisation présente au catalogue de Datasud.fr ;

3. Vous demandez la validation de votre moissonneur en écrivant un mail à [email protected] ;

4. La configuration du moissonneur est validée par les équipes de DataSud qui en assure la communication auprès de l'équipe support en charge de data.gouv.fr ;

5. Le moissonneur de data.gouv.fr vient automatiquement récupérer quotidiennement les données de votre plateforme ;

6. Les données de votre plateforme sont référencées et visibles sur data.gouv.fr. 🎉

Si vous souhaitez tester la mise en place d'un moissonneur et observer le résultat du moissonnage avant une mise en production sur data.gouv.fr, vous pouvez le créer sur la plateforme de démo https://demo.data.gouv.fr/ pour effectuer vos tests dans un premier temps. L'ensemble des étapes sont les mêmes que celles décrites sur cette page.

Créer un moissonneur

La création d’un moissonneur sur data.gouv.fr nécessite la création d’un compte gratuit.

Pour créer un nouveau moissonneur :

1. Connectez-vous à votre compte ;

2. Rendez-vous sur votre tableau de bord, en cliquant sur Administration en haut à droite de votre écran ;

3. Cliquez sur l’icône en forme de plus (+) qui se trouve à gauche de votre avatar ;

4. Cliquez sur Un moissonneur.

À partir de là, la création du moissonneur se déroule en 3 étapes.

1. Définir qui publie les données moissonnées

Une fois moissonnées, c’est-à-dire récupérées sur votre plateforme, vos données sont publiées sur data.gouv.fr. L’étape 1 vous permet de choisir le compte qui sera associé à la publication sur data.gouv.fr des données moissonnées sur votre site.

Il peut s’agir de :

• votre propre compte, pour une publication à titre individuel, sous votre propre nom ;

• le compte d’une organisation dont vous êtes membre, pour une publication à titre collectif.

Si vous êtes membre d’une organisation, nous vous conseillons de publier vos jeux de données en son nom. Une fois votre choix effectué, cliquez sur le bouton Suivant pour accéder à l’étape 2.

2. Configurer le moissonneur

Cette étape est importante pour que les données de votre organisation récupérées par data.gouv.fr soient aussi complètes que celles que vous publiez sur le portail Datasud à l’origine.

Nom

Donnez un nom à votre moissonneur est obligatoire.

Il s’agit d’une référence interne, qui vous permet de vous y retrouver si vous créez plusieurs moissonneurs. Le nom de votre moissonneur ne sera pas public.

• Mauvais nom : Moissonneur de mon portail

• Bon nom : Département de Vaucluse - DataSud

Description

La description est facultative.

Vous pouvez ajouter des précisions sur votre moissonneur dans le champ description. Il s’agit d’une référence interne qui n’a de valeur que pour vous.

URL

L’URL est obligatoire.

Saisissez ici l’URL du portail DataSud https://www.datasud.fr/fr/indexer/service/ckan/qui permet au moissonneur de parcourir et récupérer tous vos jeux de données.

Implémentation

Le type d’implémentation est obligatoire.

Choisissez ici le format Ckan Ce format permet au moissonneur de savoir comment lire et interpréter vos métadonnées, pour bien les retranscrire sur data.gouv.fr.

Filtres

Bien veiller à mettre le nom de votre organisation entre "guillemet", sans espace, sans accent ni apostrophe, dans le but d’inclure ou uniquement les jeux de données appartenant à votre organisation au sein du portail DataSud. Exemple ci dessus "communaute-dagglomeration-var-esterel-mediterranee"

Actif et archivage automatique

Ce champ est obligatoire.

Cochez la case pour que votre moissonneur se mette au travail dès qu’il aura été validé par l’équipe en charge de data.gouv.fr. Si vous souhaitez activer votre moissonneur manuellement, alors laissez là décochée.

Archivage automatique est une option pour que vos données soient archivées dans Data.gouv.fr, meme en cas de rutpture de lien avec le catalogue d'origine. Cet archivage présente aussi un risque de doublonnage de vos données. Nous déconseillons de décocher cette option d'archivage automatique

Une fois tous les champs obligatoires remplis, cliquez sur le bouton Enregistrer pour terminer la création de votre moissonneur.

3. Demander la validation du moissonneur

Une fois votre moissonneur configuré, demandez validation de votre moissonneur par mail à l'équipe de DataSud par mail à l'adresse [email protected]. Votre demande sera relayé par nos soins auprès de l’équipe en charge de data.gouv.fr, pour vérifier qu’il est bien réglé. Si c’est le cas, le moissonneur sera validé et vous recevrez une notification.

De votre côté, vous pouvez vérifier que votre moissonneur moissonne correctement votre site. Pour ce faire :

1. Cliquez sur le bouton Voir dans l’administration une fois votre moissonneur créé ;

2. Cliquez sur le bouton Prévisualiser ;

3. Vérifiez que le moissonneur récupère bien des jeux de données.

Tant que votre moissonneur n’est pas validé, il ne référence aucun des jeux de données que vous publiez sur DataSud sur data.gouv.fr.