La Documentation du validateur BAL
Documentation Validateur
Le Validateur BAL vérifie qu'un fichier soit conforme au format Base Adresse Locale.
Il est utilisé pour s'assurer avant la publication que toutes les adresses d'une BAL remonteront correctement dans la Base Adresse Nationale.
Il existe deux profils sur le validateur :- BAL 1.3 est le profil par défaut. Il assure une conformité complète avec la spécification de l'AITF.
- BAL 1.3 Relax est un profil exceptionnel déprécié. Il permet plus de tolérance tout en assurant une intégrité minimale de la donnée adresse.
Si le fichier est invalide, le validateur BAL affiche un rapport en deux parties.
Tout d'abord une validation générale sur tout le fichier qui renvoie les éléments suivants :- Les erreurs sont bloquantes et entraînent un rejet du fichier BAL. Il sera considéré comme non valide.
- Les alertes n'empêchent pas la publication et le fichier BAL sera donc accepté, mais ces dernières peuvent être corrigées pour une meilleure intégrité des données.
BAL 1.3
row | |
row.incoherence_numero | Le numéro ne correspond pas à la valeur présente dans la clé |
row.commune_manquante | Aucun code commune valide n’est renseigné |
row.longlat_vides | Les coordonnées long/lat ne sont pas renseignées |
row.longlat_invalides | Les coordonnées long/lat sont en dehors du territoire ou invalides |
row.adresse_incomplete | L’adresse est incomplète (numéro ou nom de la voie non renseignés) |
field | |
field.commune_insee.missing | La colonne commune_insee n’existe pas |
field.voie_nom.missing | La colonne voie_nom n’existe pas |
field.numero.missing | La colonne numero n’existe pas |
field.commune_nom.long | field.commune_nom.long |
field.commune_nom.lat | field.commune_nom.lat |
file | |
file.encoding.non_standard | file.encoding.non_standard |
file.delimiter.non_standard | file.delimiter.non_standard |
file.linebreak.non_standard | file.linebreak.non_standard |
rows | |
rows.empty | Aucune ligne détecté |
voie_nom_@@ (code régional en 3 lettres) | |
voie_nom_@@.casse_incorrecte | Le nom de la voie est en majuscules [eus] |
voie_nom_@@.contient_tiret_bas | Le nom de la voie contient un caractère tiret bas [eus] |
voie_nom_@@.trop_court | Le nom de la voie est trop court (3 caractères minimum) [eus] |
voie_nom_@@.trop_long | Le nom de la voie est trop long (200 caractères maximum) [eus] |
voie_nom_@@.caractere_invalide | Le champ voie_nom contient des caractères non valides |
voie_nom_@@.espaces_debut_fin | La valeur du champ voie_nom ne doit pas avoir d’espaces en début ou en fin de chaîne de caractère |
row | |
row.position_manquante | Position nulle |
row.chef_lieu_invalide | La code INSEE de la commune courante ne correspond pas au chef lieu de la commune disparue renseignée |
row.longlat_xy_incoherents | Les coordonnées long/lat et x/y ne sont pas cohérentes |
field | |
field.suffixe.missing | La colonne suffixe n’existe pas |
field.cle_interop.missing | La colonne cle_interop n’existe pas |
field.position.missing | La colonne position n’existe pas |
field.long.missing | La colonne long n’existe pas |
field.lat.missing | La colonne lat n’existe pas |
field.x.missing | La colonne x n’existe pas |
field.y.missing | La colonne y n’existe pas |
field.source.missing | La colonne source n’existe pas |
field.date_der_maj.missing | La colonne date_der_maj n’existe pas |
field.certification_commune.missing | La colonne certification_commune n’existe pas |
lieudit_complement_nom_@@ (code régional en 3 lettres) | |
lieudit_complement_nom_@@.espaces_debut_fin | La valeur du champ lieudit_complement_nom ne doit pas avoir d’espaces en début ou en fin de chaîne de caractère |
BAL 1.3 Relax
row | |
row.incoherence_numero | Le numéro ne correspond pas à la valeur présente dans la clé |
row.commune_manquante | Aucun code commune valide n’est renseigné |
row.longlat_vides | Les coordonnées long/lat ne sont pas renseignées |
row.longlat_invalides | Les coordonnées long/lat sont en dehors du territoire ou invalides |
row.adresse_incomplete | L’adresse est incomplète (numéro ou nom de la voie non renseignés) |
field | |
field.voie_nom.missing | La colonne voie_nom n’existe pas |
field.numero.missing | La colonne numero n’existe pas |
rows | |
rows.empty | Aucune ligne détecté |
voie_nom_@@ (code régional en 3 lettres) | |
voie_nom_@@.casse_incorrecte | Le nom de la voie est en majuscules [eus] |
voie_nom_@@.contient_tiret_bas | Le nom de la voie contient un caractère tiret bas [eus] |
voie_nom_@@.trop_court | Le nom de la voie est trop court (3 caractères minimum) [eus] |
voie_nom_@@.trop_long | Le nom de la voie est trop long (200 caractères maximum) [eus] |
voie_nom_@@.caractere_invalide | Le champ voie_nom contient des caractères non valides |
voie_nom_@@.espaces_debut_fin | La valeur du champ voie_nom ne doit pas avoir d’espaces en début ou en fin de chaîne de caractère |
row | |
row.position_manquante | Position nulle |
row.chef_lieu_invalide | La code INSEE de la commune courante ne correspond pas au chef lieu de la commune disparue renseignée |
row.longlat_xy_incoherents | Les coordonnées long/lat et x/y ne sont pas cohérentes |
field | |
field.suffixe.missing | La colonne suffixe n’existe pas |
field.cle_interop.missing | La colonne cle_interop n’existe pas |
field.commune_insee.missing | La colonne commune_insee n’existe pas |
field.position.missing | La colonne position n’existe pas |
field.long.missing | La colonne long n’existe pas |
field.lat.missing | La colonne lat n’existe pas |
field.x.missing | La colonne x n’existe pas |
field.y.missing | La colonne y n’existe pas |
field.source.missing | La colonne source n’existe pas |
field.date_der_maj.missing | La colonne date_der_maj n’existe pas |
field.certification_commune.missing | La colonne certification_commune n’existe pas |
lieudit_complement_nom_@@ (code régional en 3 lettres) | |
lieudit_complement_nom_@@.espaces_debut_fin | La valeur du champ lieudit_complement_nom ne doit pas avoir d’espaces en début ou en fin de chaîne de caractère |
Puis une validation adresse par adresse qui renvoie les éléments suivants :
- Les erreurs sont bloquantes et entraînent un rejet de l'adresse concernée. La BAL publiée sera alors incomplète.
- Les alertes n'empêchent pas la publication et l'adresse sera donc acceptée, mais les informations rattachées à l'adresse seront dégradées.
BAL 1.3
cle_interop | |
cle_interop.structure_invalide | La clé d’interopérabilité doit contenir au moins 3 segments |
cle_interop.commune_invalide | Clé d’interopérabilité invalide (commune) |
cle_interop.numero_invalide | Clé d’interopérabilité invalide (numéro) |
cle_interop.valeur_manquante | Le champ cle_interop ne doit pas être vide |
cle_interop.numero_prefixe_manquant | La partie numéro de la clé d’interopérabilité doit contenir 5 caractères |
cle_interop.casse_invalide | La clé d’interopérabilité doit être en minuscules |
voie_nom | |
voie_nom.valeur_manquante | Le champ voie_nom ne doit pas être vide |
voie_nom.trop_court | Le nom de la voie est trop court (3 caractères minimum) |
voie_nom.trop_long | Le nom de la voie est trop long (200 caractères maximum) |
voie_nom.caractere_invalide | Le champ voie_nom contient des caractères non valides |
numero | |
numero.valeur_manquante | Le champ numero ne doit pas être vide |
numero.type_invalide | La valeur du champ numéro doit être un nombre entier |
numero.trop_grand | Le numéro doit être compris entre 0 et 9999 (sauf toponyme) |
numero.contient_prefixe | La valeur du champ numéro ne doit pas être préfixée par des zéros |
suffixe | |
suffixe.debut_invalide | La valeur du champ suffixe doit commencer par un caractère alphanumérique. |
suffixe.trop_long | La valeur du champ suffixe est trop longue |
suffixe.espaces_debut_fin | La valeur du champ suffixe ne doit pas avoir d’espaces en début ou en fin de chaîne de caractère |
date_der_maj | |
date_der_maj.date_invalide | Date invalide |
commune_insee | |
commune_insee.commune_invalide | Le code INSEE de la commune n’est pas un code ayant existé |
commune_insee.valeur_manquante | Le champ commune_insee ne doit pas être vide |
commune_insee.espaces_debut_fin | La valeur du champ commune_insee ne doit pas avoir d’espaces en début ou en fin de chaîne de caractère |
x | |
x.valeur_invalide | La valeur du champ x est incorrecte |
x.separateur_decimal_invalide | Le séparateur des décimales du champ x doit être le point |
y | |
y.valeur_invalide | La valeur du champ y est incorrecte |
y.separateur_decimal_invalide | Le séparateur des décimales du champ y doit être le point |
long | |
long.valeur_invalide | La valeur du champ long est incorrecte |
long.separateur_decimal_invalide | Le séparateur des décimales du champ long doit être le point |
lat | |
lat.valeur_invalide | La valeur du champ lat est incorrecte |
lat.separateur_decimal_invalide | Le séparateur des décimales du champ lat doit être le point |
cle_interop | |
cle_interop.voie_invalide | Clé d’interopérabilité invalide (voie) |
cle_interop.commune_ancienne | La commune référencée est une commune ancienne |
cle_interop.espaces_debut_fin | La valeur du champ cle_interop ne doit pas avoir d’espaces en début ou en fin de chaîne de caractère |
voie_nom | |
voie_nom.casse_incorrecte | Le nom de la voie est en majuscules |
voie_nom.contient_tiret_bas | Le nom de la voie contient un caractère tiret bas |
voie_nom.espaces_debut_fin | La valeur du champ voie_nom ne doit pas avoir d’espaces en début ou en fin de chaîne de caractère |
commune_insee | |
commune_insee.commune_ancienne | Le code INSEE de la commune est le code d’une commune ancienne |
commune_deleguee_insee | |
commune_deleguee_insee.commune_invalide | Le code INSEE renseigné n’est pas un code valide ou n’a jamais existé |
commune_deleguee_insee.commune_actuelle_non_deleguee | Le code INSEE renseigné correspond au code d’une commune actuelle dont le chef lieu n’est pas une commune déléguée |
commune_deleguee_insee.commune_ancienne_non_deleguee | Le code INSEE renseigné correspond au code d’une commune ancienne qui n’a pas le statut de commune déléguée |
commune_deleguee_insee.espaces_debut_fin | La valeur du champ commune_deleguee_insee ne doit pas avoir d’espaces en début ou en fin de chaîne de caractère |
position | |
position.enum_fuzzy | La valeur du champ position a été acceptée mais n’est pas conforme à la spécification |
position.valeur_invalide | La valeur du champ position est incorrecte |
position.espaces_debut_fin | La valeur du champ position ne doit pas avoir d’espaces en début ou en fin de chaîne de caractère |
cad_parcelles | |
cad_parcelles.valeur_invalide | La valeur du champ cad_parcelles est incorrecte |
cad_parcelles.pipe_debut_fin | Le symbole | ne doit pas être utilisé en début ou fin de chaîne |
cad_parcelles.espaces_debut_fin | La valeur du champ cad_parcelles ne doit pas avoir d’espaces en début ou en fin de chaîne de caractère |
source | |
source.valeur_manquante | Le champ source ne doit pas être vide |
source.espaces_debut_fin | La valeur du champ source ne doit pas avoir d’espaces en début ou en fin de chaîne de caractère |
date_der_maj | |
date_der_maj.valeur_manquante | Le champ date_der_maj ne doit pas être vide |
date_der_maj.date_ancienne | Date trop ancienne |
date_der_maj.date_future | Date dans le futur |
date_der_maj.espaces_debut_fin | La valeur du champ date_der_maj ne doit pas avoir d’espaces en début ou en fin de chaîne de caractère |
certification_commune | |
certification_commune.valeur_invalide | La valeur du champ certification_commune est incorrecte |
commune_nom | |
commune_nom.espaces_debut_fin | La valeur du champ commune_nom ne doit pas avoir d’espaces en début ou en fin de chaîne de caractère |
commune_deleguee_nom | |
commune_deleguee_nom.espaces_debut_fin | La valeur du champ commune_deleguee_nom ne doit pas avoir d’espaces en début ou en fin de chaîne de caractère |
uid_adresse | |
uid_adresse.espaces_debut_fin | La valeur du champ uid_adresse ne doit pas avoir d’espaces en début ou en fin de chaîne de caractère |
lieudit_complement_nom | |
lieudit_complement_nom.espaces_debut_fin | La valeur du champ lieudit_complement_nom ne doit pas avoir d’espaces en début ou en fin de chaîne de caractère |
numero | |
numero.espaces_debut_fin | La valeur du champ numero ne doit pas avoir d’espaces en début ou en fin de chaîne de caractère |
long | |
long.espaces_debut_fin | La valeur du champ long ne doit pas avoir d’espaces en début ou en fin de chaîne de caractère |
lat | |
lat.espaces_debut_fin | La valeur du champ lat ne doit pas avoir d’espaces en début ou en fin de chaîne de caractère |
x | |
x.espaces_debut_fin | La valeur du champ x ne doit pas avoir d’espaces en début ou en fin de chaîne de caractère |
y | |
y.espaces_debut_fin | La valeur du champ y ne doit pas avoir d’espaces en début ou en fin de chaîne de caractère |
BAL 1.3 Relax
cle_interop | |
cle_interop.structure_invalide | La clé d’interopérabilité doit contenir au moins 3 segments |
cle_interop.commune_invalide | Clé d’interopérabilité invalide (commune) |
cle_interop.numero_invalide | Clé d’interopérabilité invalide (numéro) |
voie_nom | |
voie_nom.valeur_manquante | Le champ voie_nom ne doit pas être vide |
voie_nom.trop_court | Le nom de la voie est trop court (3 caractères minimum) |
voie_nom.trop_long | Le nom de la voie est trop long (200 caractères maximum) |
voie_nom.caractere_invalide | Le champ voie_nom contient des caractères non valides |
numero | |
numero.valeur_manquante | Le champ numero ne doit pas être vide |
numero.type_invalide | La valeur du champ numéro doit être un nombre entier |
numero.trop_grand | Le numéro doit être compris entre 0 et 9999 (sauf toponyme) |
suffixe | |
suffixe.debut_invalide | La valeur du champ suffixe doit commencer par un caractère alphanumérique. |
suffixe.trop_long | La valeur du champ suffixe est trop longue |
commune_insee | |
commune_insee.commune_invalide | Le code INSEE de la commune n’est pas un code ayant existé |
x | |
x.valeur_invalide | La valeur du champ x est incorrecte |
y | |
y.valeur_invalide | La valeur du champ y est incorrecte |
long | |
long.valeur_invalide | La valeur du champ long est incorrecte |
lat | |
lat.valeur_invalide | La valeur du champ lat est incorrecte |
cle_interop | |
cle_interop.valeur_manquante | Le champ cle_interop ne doit pas être vide |
cle_interop.casse_invalide | La clé d’interopérabilité doit être en minuscules |
cle_interop.voie_invalide | Clé d’interopérabilité invalide (voie) |
cle_interop.numero_prefixe_manquant | La partie numéro de la clé d’interopérabilité doit contenir 5 caractères |
cle_interop.commune_ancienne | La commune référencée est une commune ancienne |
cle_interop.espaces_debut_fin | La valeur du champ cle_interop ne doit pas avoir d’espaces en début ou en fin de chaîne de caractère |
numero | |
numero.contient_prefixe | La valeur du champ numéro ne doit pas être préfixée par des zéros |
numero.espaces_debut_fin | La valeur du champ numero ne doit pas avoir d’espaces en début ou en fin de chaîne de caractère |
voie_nom | |
voie_nom.casse_incorrecte | Le nom de la voie est en majuscules |
voie_nom.contient_tiret_bas | Le nom de la voie contient un caractère tiret bas |
voie_nom.espaces_debut_fin | La valeur du champ voie_nom ne doit pas avoir d’espaces en début ou en fin de chaîne de caractère |
commune_insee | |
commune_insee.commune_ancienne | Le code INSEE de la commune est le code d’une commune ancienne |
commune_insee.espaces_debut_fin | La valeur du champ commune_insee ne doit pas avoir d’espaces en début ou en fin de chaîne de caractère |
commune_deleguee_insee | |
commune_deleguee_insee.commune_invalide | Le code INSEE renseigné n’est pas un code valide ou n’a jamais existé |
commune_deleguee_insee.commune_actuelle_non_deleguee | Le code INSEE renseigné correspond au code d’une commune actuelle dont le chef lieu n’est pas une commune déléguée |
commune_deleguee_insee.commune_ancienne_non_deleguee | Le code INSEE renseigné correspond au code d’une commune ancienne qui n’a pas le statut de commune déléguée |
commune_deleguee_insee.espaces_debut_fin | La valeur du champ commune_deleguee_insee ne doit pas avoir d’espaces en début ou en fin de chaîne de caractère |
position | |
position.enum_fuzzy | La valeur du champ position a été acceptée mais n’est pas conforme à la spécification |
position.valeur_invalide | La valeur du champ position est incorrecte |
position.espaces_debut_fin | La valeur du champ position ne doit pas avoir d’espaces en début ou en fin de chaîne de caractère |
x | |
x.separateur_decimal_invalide | Le séparateur des décimales du champ x doit être le point |
x.espaces_debut_fin | La valeur du champ x ne doit pas avoir d’espaces en début ou en fin de chaîne de caractère |
y | |
y.separateur_decimal_invalide | Le séparateur des décimales du champ y doit être le point |
y.espaces_debut_fin | La valeur du champ y ne doit pas avoir d’espaces en début ou en fin de chaîne de caractère |
long | |
long.separateur_decimal_invalide | Le séparateur des décimales du champ long doit être le point |
long.espaces_debut_fin | La valeur du champ long ne doit pas avoir d’espaces en début ou en fin de chaîne de caractère |
lat | |
lat.separateur_decimal_invalide | Le séparateur des décimales du champ lat doit être le point |
lat.espaces_debut_fin | La valeur du champ lat ne doit pas avoir d’espaces en début ou en fin de chaîne de caractère |
cad_parcelles | |
cad_parcelles.valeur_invalide | La valeur du champ cad_parcelles est incorrecte |
cad_parcelles.pipe_debut_fin | Le symbole | ne doit pas être utilisé en début ou fin de chaîne |
cad_parcelles.espaces_debut_fin | La valeur du champ cad_parcelles ne doit pas avoir d’espaces en début ou en fin de chaîne de caractère |
source | |
source.valeur_manquante | Le champ source ne doit pas être vide |
source.espaces_debut_fin | La valeur du champ source ne doit pas avoir d’espaces en début ou en fin de chaîne de caractère |
date_der_maj | |
date_der_maj.valeur_manquante | Le champ date_der_maj ne doit pas être vide |
date_der_maj.date_invalide | Date invalide |
date_der_maj.date_ancienne | Date trop ancienne |
date_der_maj.date_future | Date dans le futur |
date_der_maj.espaces_debut_fin | La valeur du champ date_der_maj ne doit pas avoir d’espaces en début ou en fin de chaîne de caractère |
certification_commune | |
certification_commune.valeur_invalide | La valeur du champ certification_commune est incorrecte |
commune_nom | |
commune_nom.espaces_debut_fin | La valeur du champ commune_nom ne doit pas avoir d’espaces en début ou en fin de chaîne de caractère |
commune_deleguee_nom | |
commune_deleguee_nom.espaces_debut_fin | La valeur du champ commune_deleguee_nom ne doit pas avoir d’espaces en début ou en fin de chaîne de caractère |
uid_adresse | |
uid_adresse.espaces_debut_fin | La valeur du champ uid_adresse ne doit pas avoir d’espaces en début ou en fin de chaîne de caractère |
lieudit_complement_nom | |
lieudit_complement_nom.espaces_debut_fin | La valeur du champ lieudit_complement_nom ne doit pas avoir d’espaces en début ou en fin de chaîne de caractère |
suffixe | |
suffixe.espaces_debut_fin | La valeur du champ suffixe ne doit pas avoir d’espaces en début ou en fin de chaîne de caractère |