Intégration avec schema.data.gouv.fr

schema.data.gouv.fr est l’initiative de data.gouv.fr de référencement des schémas de données publiques pour la France. Cette plateforme de référencement nationale permet un accès aux schémas produits par différents acteurs et facilite l’intégration avec des systèmes informatiques par le biais de standards, d’URLs stables, de processus de validation et d’API.

Vous trouverez ci-dessous une capture d’écran de l’interface de schema.data.gouv.fr pour le schéma dédié aux lieux de covoiturage.

Qui peut référencer des schémas ?

Tout acteur est libre de proposer le référencement de schémas.

Concrètement, vous pouvez être une administration, une entreprise privée, une association, un citoyen etc.

Quels schémas de données sont acceptés ?

schema.data.gouv.fr accepte des schémas de données décrivant des données publiques.

Les schémas de données sont acceptés dès lors que leur l’existence est justifiée par voie :

• réglementaire : c'est une disposition réglementaire qui est à l'origine de la définition du schéma de données ;
• d’usage : la réutilisation des données décrites par le schéma bénéficie à un grand nombre ou de nombreux producteurs sont amenés à utiliser ce schéma de données.

Etalab se réserve le droit de refuser l’ajout de schémas en motivant son refus. Nous vous encourageons à initier une discussion préalablement à l’ouverture d’une pull request.

Quand référencer son schéma de données ?

Nous vous invitions à référencer votre schéma de données le plus tôt possible, dès la phase d’investigation. En référençant celui-ci en amont, vous bénéficierez de l’accompagnement d’Etalab et de partenaires tout au long de la création de votre schéma de données : de l'investigation à la publication sur schema.data.gouv.fr.

Vous pouvez référencer votre schéma de données en ouvrant un ticket sur GitHub ou en entrant en contact avec notre équipe par e-mail. Nous avons créé une page dédiée pour détailler la procédure. Nous tenons à jour une liste de schémas actuellement en phase d’investigation ou de construction sur cette même page.

Quels schémas de données sont acceptés ?

schema.data.gouv.fr accepte des schémas de données décrit par un standard technique (voir la page "Phase de construction" de ce présent guide). Les schémas de données décrits uniquement par de la documentation textuelle ou des tableaux ne sont pas acceptés.

Standards techniques supportés

Les standards techniques de schémas de données actuellement supportés sont les suivants :

• Table Schema : adapté pour la description de données tabulaires (sous forme de tableurs ou de CSV). Ce standard technique utilise le format JSON
• JSON Schema : adapté pour la description de données avec une notion de hiérarchie. Ce standard utilise le format JSON
• XML Schema Definition (XSD) : adapté pour la description de données avec une notion de hiérarchie. Ce standard utilise le format XML

Prérequis de validation des schémas de données

Lexique : Validation d’un schéma de données

La validation d’un schéma de données est l’étape qui permet de vérifier si celui-ci est conforme au standard technique sélectionné et aux prérequis de schema.data.gouv.fr. Cette étape s’intéresse uniquement au schéma de données et à la façon dont il est publié.

Il ne faut pas confondre la validation d’un schéma avec le fait de vérifier que des données correspondent à un schéma.

Pour tous les types de schéma de données, il faut que :

• votre schéma de données soit sur un dépôt Git, à raison d’un dépôt par schéma. Ce dépôt doit pouvoir être cloné depuis Internet sans authentification préalable ;
• votre dépôt Git doit comporter des tags indiquant les versions de votre schéma de données. Ces versions doivent respecter la gestion sémantique de version semver, sous la forme 1.3.2 par exemple ;
• votre dépôt doit comporter un fichier README.md à la racine contenant une documentation du schéma de données indiquant par exemple le contexte de production, la gouvernance ;
• passer avec succès les tests spécifiques au type de schéma de données que votre dépôt contient.

Critères complets de validation

Cette page présente les grands principes de validation des schémas de données. Pour connaître en détail les prérequis propres à chaque type de schéma de données et accéder à des exemples, consultez la page dédiée à la validation des schémas de données.

Points de sortie

À l’issue de cette phase, vous devriez :

• Avoir pris connaissance des procédures de validation en place sur schema.data.gouv.fr ;
• Avoir un dépôt Git conforme aux prérequis de schema.data.gouv.fr ;
• Avoir effectué votre demande de référencement.