Configurer un connecteur DCAT

Dans ce cours, nous allons configurer un connecteur DCAT et importer un jeu de données depuis un catalogue au standard DCAT.

Le connecteur fonctionne en import seul : il liste les jeux de données exposés par un catalogue DCAT et importe leurs ressources (distributions) comme jeux de données.

1. Prérequis

Vous avez besoin de l'URL d'un catalogue exposant un flux DCAT (RDF / JSON-LD).

Dans ce cours, nous utilisons le catalogue DCAT du portail open data de Koumoul : https://opendata.koumoul.com/data-fair/api/v1/catalog/dcat.

2. Configuration du connecteur

Renseignez les champs suivants :

  • le Titre [1] du catalogue, pour l'identifier dans Data Fair ;
  • l'URL [2] du flux DCAT ;
  • éventuellement un Template des URLs de provenance [3] pour générer le lien vers la source de chaque jeu (peut contenir {id}).
Configuration du connecteur DCAT
Les champs de configuration du connecteur DCAT

Cliquez sur Créer : la connexion au catalogue est vérifiée (la création est bloquée si l'URL est invalide), puis le catalogue est créé et prêt à être utilisé.

3. Import des données

3.1 Sélection de la ressource

Depuis votre catalogue, créez un nouvel import. Le catalogue DCAT est organisé par jeux de données : entrez dans le jeu voulu — le fil d'Ariane [1] indique votre position — sélectionnez la distribution [2] à importer (par exemple le fichier CSV), puis cliquez sur Suivant [3].

Sélection d’une distribution DCAT
Entrez dans un jeu de données puis sélectionnez la distribution à importer

3.2 Configuration de l'import

Le connecteur DCAT propose une configuration d'import spécifique. Un jeu DCAT pouvant contenir plusieurs fichiers (distributions), ces options choisissent la provenance des métadonnées du jeu importé :

  • Utiliser le titre du jeu distant [1] : reprend le titre du jeu (ex. « Calendrier scolaire ») plutôt que celui de la distribution (ex. « Fichier csv ») ;
  • Utiliser la description du jeu distant [2] : idem pour la description.

Activées par défaut, elles évitent d'hériter d'un nom de fichier technique. Les autres options (jeu de données à mettre à jour, planification…) sont communes à tous les connecteurs et décrites dans le cours général.

Configuration de l'import DCAT
Reprise du titre et de la description du jeu distant (spécifique à DCAT)

Cliquez sur Importer. Une fois l'import terminé [1], le journal d'exécution [2] récapitule les étapes ; vous pouvez ouvrir le jeu de données importé [3] dans Data Fair (un lien vers la source distante est aussi disponible).

Import terminé
Le journal confirme l’import et le jeu de données créé

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