Guides pratiques approfondis

Lire une fiche de catalogue et choisir la bonne ressource

Distinguer jeu, distribution, service et notice avant de télécharger ou citer des données publiques.

Mise à jour :

Contrôle de fichiers et de tableaux sur un poste de travail organisé.

Illustration générée par IA

Quelle ressource a réellement servi à votre analyse ?

Un catalogue peut décrire un jeu sans héberger ses fichiers. DCAT fournit un vocabulaire pour relier les objets ; tous les portails ne renseignent pas toutes ses propriétés. La fiche sert à découvrir la ressource, puis à retrouver le producteur et la version analysée.

  1. Séparer les objets

    Identifier le jeu, sa notice de catalogue, chaque distribution et les services d’accès. Un CSV et une API ne désignent pas automatiquement la même extraction.

  2. Choisir une distribution

    Vérifier format, couverture, unité, langue et période. Distinguer page d’accès et lien direct de téléchargement ; consigner la ressource exacte choisie.

  3. Lire les dates et les droits

    Séparer modification de la notice, publication du jeu et révision du fichier. Lire licence et restrictions à leur niveau ; ne pas déduire une licence du seul accès public.

  4. Conserver la filiation

    Relier fichier, producteur, extraction et transformations. Garder l’empreinte du fichier et les paramètres ; attribuer l’opération de nettoyage à son auteur.

Atelier de lecture

Choisir une ressource dans le jeu DEMO-D12

Ce catalogue est entièrement fictif. Quatre objets liés ne portent ni la même période ni le même rôle documentaire.

Données et traces fictives pour apprendre : aucun résultat présenté ici ne provient d’un service interrogé en direct.

Étudier mars sans remplacer l’histoire par le présent

La fiche du jeu DEMO-D12 relie un CSV de mars, un ZIP annuel et une API courante. Sa description est corrigée en juin. L’objectif est de documenter l’état publié pour mars, pas le dernier état disponible.

Si le tableau dépasse l’écran, faites-le défiler horizontalement ; les flèches du clavier fonctionnent lorsque la zone est sélectionnée.

Étudier mars sans remplacer l’histoire par le présent
Objet fictifContenu ou rôleUsage possibleVérification distincte
CSV de mars 2026Distribution mensuelleCandidat pour l’étude de marsContrôler version, champs et licence de cette distribution.
ZIP annuel 2025Distribution d’une autre périodeContexte historique seulement iciNe pas le sommer avec le CSV ; lire ses propres droits.
API couranteService donnant l’état courantSuivi actuel, selon ses paramètresConserver requête et réponse ; vérifier couverture et droits du service.
Notice modifiée en juinDescription du catalogueExpliquer le changement de métadonnéesNe prouve pas une révision du CSV de mars.

Quelle ressource convient d’abord à la question historique ?

Ouvrir chaque proposition pour comparer son diagnostic. Plusieurs contrôles peuvent rester nécessaires.

L’API, parce qu’elle est plus récente

Pas sans vérifier qu’elle restitue la version recherchée. Une réponse courante peut inclure des révisions postérieures.

Le CSV de mars, après contrôle de sa couverture et de sa version

Oui comme candidat documenté. Identifier exactement le fichier et vérifier les droits applicables avant sa réutilisation.

Le ZIP annuel et le CSV additionnés

Non : les périodes et l’agrégation diffèrent. Leur présence dans le même jeu ne rend pas la somme pertinente.

Trace fictive de sélection

Jeu : DEMO-D12
Question : état publié pour mars 2026
Ressource retenue : distribution CSV de mars
Notice : description corrigée en juin
Version du fichier : à contrôler
Licence de la distribution : non encore vérifiée

Le statut « non vérifiée » est une action ouverte, pas une autorisation de réutiliser. Une date de notice et une version de fichier restent deux champs.

Documentation des règles, distincte des exemples fictifs

Comparer avec les autres situations et exercices

Deux fichiers sur une même fiche

Dans un cas fictif, un CSV mensuel et une archive annuelle portent le même titre. Choisir la période et conserver l’identifiant de distribution ; ne pas sommer les deux versions.

Métadonnées mises à jour

Une notice illustrative change de date après correction de sa description. Ce changement ne suffit pas à affirmer que les observations du fichier ont été révisées.

Lecture guidée d’un extrait

Une notice récente peut décrire une ressource ancienne

Le catalogue fictif relie un jeu, une distribution d’avril et un service courant. La date de modification de la notice ne rend pas ces ressources interchangeables.

Exercice fictif : les identifiants, valeurs et dates illustrent le contrôle. Cet extrait n’est pas une réponse collectée en direct.

  1. Identifier le jeu

    D-42 désigne le sujet d’ensemble. Il ne suffit pas à identifier la version effectivement analysée.

  2. Choisir la période

    D-42-2026-04 annonce une distribution d’avril. Vérifier sa couverture et son contenu, pas seulement son nom.

  3. Distinguer le service

    API-live donne un accès courant. Une analyse historique demande un instantané ou des paramètres documentés adaptés.

Relations fictives dans une fiche de catalogue

dataset: D-42
distribution: D-42-2026-04
mediaType: text/csv
period: 2026-04
service: API-live

Ce qu’il faut examiner

Date de la notice
Une correction de description ne prouve pas une révision des observations.
Version utilisée
Conserver distribution ou requête, période, consultation et transformations.
Le service le plus récent est-il forcément le meilleur pour étudier avril ?

Raisonnement

Non. La ressource doit correspondre à la période et à la version recherchées. Un service courant peut avoir révisé les données ; une ancienne distribution doit aussi être contrôlée avant utilisation.

Références officielles : W3C — DCAT 3

Exercice corrigé

Une fiche récente pour des observations anciennes

Exemple fictif : les valeurs et documents servent à apprendre la méthode, sans décrire un organisme réel.

Aucun nouveau millésime d’observations n’est annoncé. Vous cherchez des données pour répondre à une question portant sur 2026.

Si le tableau dépasse l’écran, faites-le défiler horizontalement ; les flèches du clavier fonctionnent lorsque la zone est sélectionnée.

Données de départ
ObjetRepère temporelNature du repère
Notice de catalogue2026Modification de notice
CSV2015–2020Période des observations
Documentation2026Correction de documentation

À vous de vérifier

  1. Lire période du fichier et rôle de chaque distribution.
  2. Séparer mise à jour de notice et d’observations.
  3. Choisir la ressource selon la période recherchée.
Lire le corrigé

Corrigé et décision

La modification de 2026 ne rend pas les observations actuelles. Le CSV couvre six années, jusqu’à 2020. Pour une question sur 2026, chercher une distribution appropriée ou annoncer la lacune. La documentation corrigée peut changer l’interprétation sans ajouter d’observations.

Si le cas change

Si un CSV 2026 existe sur la même notice, comparer son identifiant, ses dimensions et sa couverture avant de remplacer l’ancien.

Trace à conserver

Garder identifiant de distribution, couverture, date du fichier, documentation et motif du choix.

Référence documentaire : W3C — DCAT 3, temporal coverage · Consultée le

Preuve à conserver

  • Identifiants du jeu et de la distribution
  • Producteur et licence citée
  • URL d’accès et fichier téléchargé
  • Période, version, empreinte et transformations

Références officielles

Fiches de sources associées

Protocoles connexes

Points à vérifier avant de conclure

  • Le fichier exact est-il identifié ?
  • La licence porte-t-elle sur cette ressource ?
  • La date citée décrit-elle le bon objet ?
  • Les transformations sont-elles documentées ?

Une fiche de travail reliant les métadonnées au fichier exact et à ses conditions de réutilisation.

Questions fréquentes

Une page d’accès est-elle un lien direct de fichier ?

Pas nécessairement. Elle peut présenter plusieurs distributions ou un service. Garder la page et la ressource réellement obtenue.

Une empreinte prouve-t-elle la qualité du jeu ?

Non. Elle permet de reconnaître les mêmes octets. Définition des champs, couverture et exactitude demandent d’autres contrôles.

Quelle date citer pour un jeu de données ?

Préciser son rôle : période observée, version, publication ou téléchargement. Plusieurs dates peuvent être nécessaires pour permettre au lecteur de comprendre l’état utilisé et la temporalité du phénomène mesuré.

OUTILS / REGISTRES

Informations à relever

Relier fichier, producteur, extraction et transformations. Garder l’empreinte du fichier et les paramètres ; attribuer l’opération de nettoyage à son auteur.

  • Date de consultation et fuseau
  • URL exacte
  • Identifiant du document
  • Producteur / éditeur
  • Version / révision
  • Période étudiée
  • Licence / droits de réutilisation
  • Type logique et format
  • Méthode / définition
  • Limite / incertitude
  • Décision / prochaine action
  • Responsable du contrôle
  • Prochain contrôle

REPÈRES DOCUMENTÉS

Distinguer le jeu, sa distribution et son service

Quand deux liens semblent désigner les mêmes données, comparez leurs objets avant de compter deux sources. Organisez la collecte pour pouvoir revenir de la valeur utilisée à la représentation réellement consultée.

DatasetDistributionDataServicedcat:distributiondcat:accessService
Distinguer le jeu, sa distribution et son service
RepèreValeur ou formeCe que cela désigne
dcat:Datasetdcat:distributionJeu de données.
dcat:Distributiondcat:accessServiceReprésentation accessible du jeu.
dcat:DataServicedcat:endpointURLService donnant accès aux données.

À retenir pour le dossier

Dans votre relevé, associez la notice, la représentation, la requête éventuelle et la licence applicable. Deux formats d’un même jeu ne constituent pas deux confirmations indépendantes. Une date de notice ne suffit pas à dater chaque observation.

Documentation primaire

Documentation consultée le .

REPÈRES DOCUMENTÉS

Europeana EDM : l’objet décrit, le fichier et ses droits sont trois lectures distinctes

Le modèle de données Europeana sépare l’objet patrimonial décrit de ses représentations accessibles sur le Web. Cette distinction aide à ne pas prendre une page de notice pour un fichier image, ni les droits d’une représentation pour ceux de toutes les autres. Les noms de classes et propriétés ci-dessous sont ceux de la documentation EDM consultée le 22 octobre 2026.

edm:ProvidedCHOore:AggregationWebResourceaggregatedCHOisShownBy / hasView
Europeana EDM : l’objet décrit, le fichier et ses droits sont trois lectures distinctes
RepèreValeur ou formeCe que cela désigne
edm:ProvidedCHOCultural heritage objectL’objet patrimonial fourni : livre, tableau, enregistrement ou objet né numérique selon la notice. Sa date de création ne devient pas automatiquement la date du fichier numérisé.
edm:WebResourceDigital representationUne représentation numérique accessible par une URL. Plusieurs ressources peuvent représenter le même objet ; chacune peut porter ses caractéristiques et ses droits.
ore:AggregationProvider aggregationL’agrégation réunit les liens et les informations de provenance apportés autour de l’objet. Ce n’est pas un nouveau fichier image ni une nouvelle œuvre.
edm:isShownAtContextual pageLien vers une vue de l’objet dans son contexte documentaire, généralement une page de présentation. Il ne garantit pas un contenu binaire utilisable comme image.
edm:isShownByDigital objectLien vers l’objet numérique accessible en ligne. Vérifier le type de média et la réponse effective avant de le traiter comme un JPEG ou de l’intégrer à une page.
edm:hasViewAdditional viewVue supplémentaire, par exemple un détail ou une autre représentation. La multiplicité des vues ne justifie pas de compter plusieurs objets patrimoniaux.
edm:rightsResource / aggregationUne ressource peut avoir ses propres droits ; la documentation explique le recours aux droits de l’agrégation lorsqu’aucun droit spécifique ne s’applique à la représentation affichée.
edm:dataProviderContributing institutionDésigne l’institution qui contribue les données, éventuellement via un agrégateur. Ne pas la confondre systématiquement avec le fournisseur technique direct ou le créateur de l’objet.

À retenir pour le dossier

Pour réutiliser une image, conserver l’URL de la représentation précise, ses droits, le crédit et les éventuelles modifications. La documentation donne le cas de versions à résolutions différentes avec des conditions différentes : un droit affiché pour une miniature ne se propage pas automatiquement au fichier haute définition. Ouvrir aussi la notice du fournisseur si le contexte est incomplet.

Peut-on utiliser edm:isShownAt comme URL dans une balise image ?

Pas sans vérifier la ressource : ce lien peut mener à une page HTML de contexte. Identifier la représentation appropriée, contrôler son type et ses droits, puis citer l’objet et le fournisseur.

Documentation primaire

Documentation consultée le .

REPÈRES DOCUMENTÉS

OAI-PMH : reprendre une moisson sans perdre dates et suppressions

Le protocole OAI-PMH 2.0 distingue l’item, ses formats de métadonnées et les enregistrements diffusés. La version documentaire du 8 janvier 2015 décrit la sélection par dates et la reprise des listes partielles. Les chiffres du schéma proviennent d’un exemple du protocole : ils ne sont pas des effectifs mesurés sur HAL, OpenAIRE ou un autre dépôt.

100resumptionToken ≠ ""75resumptionToken = ""175 = 100 + 75
OAI-PMH : reprendre une moisson sans perdre dates et suppressions
RepèreValeur ou formeCe que cela désigne
datestampMetadata creation / change / deletionDate utilisée pour la création, la modification ou la suppression de l’enregistrement de métadonnées. Ce n’est pas automatiquement la date de publication du document décrit.
from · untilInclusive boundsLes bornes sont inclusives : au moins from et au plus until. Reprendre une collecte sur la même borne peut donc recouvrir des enregistrements déjà reçus ; contrôler les identifiants.
granularityDay / optional secondTous les dépôts doivent prendre en charge la granularité au jour. Le support facultatif à la seconde est indiqué par Identify ; ne pas inventer une précision supérieure à celle du dépôt.
resumptionTokenExclusive argument, with verbÀ la reprise d’une liste, transmettre le jeton avec le verbe, sans lui ajouter les autres arguments de sélection de la requête initiale. Il est opaque et peut devenir invalide ou expirer.
completeListSizeOptional estimateCet attribut facultatif peut estimer la taille de la liste complète et évoluer pendant le parcours. Son absence n’est pas zéro et sa présence ne remplace pas le comptage reçu.
header status="deleted"No metadata or aboutUne réponse à un enregistrement supprimé conserve l’en-tête et n’inclut pas les parties metadata ou about. Ne pas remplacer cet état par une fiche contenant des champs vides.
deletedRecordno · transient · persistentIdentify déclare la politique de suivi des suppressions. no ne conserve pas cette information, transient ne garantit pas sa persistance, persistent en conserve durablement l’historique.
Protocol example175 = 100 + 75L’exemple officiel répartit une liste de 175 enregistrements en réponses de 100 puis 75. Le jeton final est vide : une page courte seule n’est pas une règle universelle de fin OAI-PMH.

À retenir pour le dossier

Conserver l’identifiant, le metadataPrefix et le datestamp avec chaque état. La suppression d’un enregistrement dans un format ne prouve pas que tous les autres formats de l’item ont disparu. Pour les reprises incrémentales, documenter le recouvrement des bornes et la politique de déduplication ; un dépôt sans historique de suppression ne permet pas de reconstituer cet historique par magie.

Peut-on ajouter from au prochain appel contenant resumptionToken ?

Non pour ces requêtes de reprise : le jeton est un argument exclusif, accompagné du verbe. Si la sélection doit changer, démarrer une nouvelle requête et conserver la distinction entre les deux parcours.

Documentation primaire

Documentation consultée le .

REPÈRES DOCUMENTÉS

Version corrigée ou nouvelle période : deux relations distinctes

Une livraison annuelle et la correction d’un même fichier n’ont pas le même rôle. DCAT 3 permet de décrire explicitement les versions d’une ressource et les jeux appartenant à une série ; ces liens ne remplacent pas la lecture de la méthode.

Version corrigée ou nouvelle période : deux relations distinctes
RepèreValeur ou formeCe que cela désigne
dcat:hasVersionresource → versionRelie une ressource à une de ses versions. Relever l’identifiant de la version réellement consultée, et pas seulement l’adresse du catalogue.
dcat:previousVersionnew → previousRelie une version à la précédente. Une révision peut modifier des observations anciennes : comparer les notes de version avant de calculer une évolution.
dcat:inSeriesdataset → seriesRattache un jeu à une série. Deux millésimes successifs peuvent être deux jeux de la série sans être deux versions correctives du même jeu.

À retenir pour le dossier

Exemple de lecture : une livraison portant sur 2024 puis une livraison portant sur 2025 forment une séquence temporelle ; un fichier 2024 corrigé reste relatif à 2024. Vérifier séparément période observée, date de publication, révision et format de distribution.

Documentation primaire

Documentation consultée le .

APPROFONDISSEMENT / PRATIQUE

Passer des métadonnées au fichier réellement disponible

Un catalogue décrit un jeu, mais les ressources téléchargées peuvent avoir des formats ou versions différents. La lecture doit rapprocher fiche descriptive et fichiers accessibles.

Mis à jour le .

Vérifications prioritaires

Relever producteur, dates, ressources, formats, licence et documentation. Ouvrir les fichiers pour vérifier champs, couverture et correspondance avec la description.

Pièges d’interprétation

Une date de mise à jour du catalogue ne garantit pas une nouvelle mesure. Une ressource peut être indisponible ou ne couvrir qu’une partie du jeu décrit.

Document de travail à conserver

La fiche de catalogue conserve métadonnées, ressource choisie, date de téléchargement et écarts. Elle sert de point de départ à l’évaluation des données.