Skip to content

IGNF/validator

Repository files navigation

Validator

CI License: CeCILL-B

Description

This program validates a dataset (a folder containing geodata files and other documents) according to a schema describing the folder structure and the feature catalog. It outputs a report containing validation errors and warnings, and normalized data ready for database integration.

It has been originally developed for the Géoportail de l'Urbanisme to check urban planning documents against CNIG standards in order to produce a nationwide database.

Ce programme permet de valider et de normaliser les données présentes dans une arborescence de fichiers. Ces données peuvent être :

  • Des tables, géographiques ou non, aux formats CSV, GML, Shapefile ou MapInfo
  • Des fiches de métadonnées
  • Des fichiers PDF
  • Des dossiers (principalement pour contrôle de présence)

Le paramétrage s'effectue à l'aide de fichiers JSON décrivant des arborescences de fichiers et des tables.

Cas d'usage

Principe de fonctionnement

Le schéma suivant illustre le Principe de fonctionnement du validateur :

Working principle

Principales fonctionnalités

  • Validation d'une arborescence de fichiers en fonction d'un modèle de document.
  • Validation des tables en fonction d'un modèle de table.
  • Validation des fiches de métadonnées.
  • Production d'un rapport d'erreur au format JSON.
  • Production de données normalisées (pour agrégation et diffusion).
  • Validation métier à l'aide de plugins (CNIG pour GpU, DGPR pour TRI,...) pour les contrôles qui sont pas formalisés dans le modèle de validation.

Utilisation

Le validateur se présente sous la forme d'un exécutable java (validator-cli.jar) utilisable en ligne de commande. Il n'offre pas d'interface graphique car il a vocation à être utilisé pour la mise en œuvre de services web tel le Géoportail de l'Urbanisme offrant ces interfaces.

Les techniciens peuvent se référer à la documentation utilisation du validateur en ligne de commande.

Dépendances

Les exécutables systèmes ci-après sont requis pour l'exécution du programme :

  • java >= 11
  • ogr2ogr >= v2.3.0 : Utilisé pour lire et convertir les données en entrée dans un format pivot avant validation (CSV)

Les dépendances java telle GeoTools sont décrites dans les fichiers pom.xml et intégrées dans l'exécutable JAVA.

Documentation technique

Les principaux documents sont les suivants :

Les documents ci-après traitent des problématiques particulières :