💾Sauvegarder son fichier de données

Cette page propose une convention de nommage de fichiers, et dit comment formater les fichiers à sauvegarder

Noms de fichiers

Les fichiers doivent, autant que possible, respecter les règles de nommage suivantes :

<ARR_INSEE>_<COLL_NOM>_<ARR_DATE>.csv

• ARR_INSEE : Code INSEE relatif à l'arrêté (ex. 13001)

• COLL_NOM : Nom de la commune associée (ex. Aix-en-Provence)

• ARR_DATE : Date de l'arrêté (ex. 2001-04-12)

Exemple : 13001_Aix-en-Provence_2001-04-12.csv

Format de fichier

Le format de fichier retenu pour la publication des données est le CSV (Comma Separated Values, valeurs séparées par des virgules).

Les fichiers doivent, sauf exception et autant que possible, respecter les règles de formatage suivantes :

• l’encodage des caractères est UTF-8,

• le séparateur des colonnes est la virgule,

• le séparateur des nombres décimaux est le point,

• le séparateur de valeurs multiples dans un champ est le caractère |,

• si un champ contient une virgule, il doit être entouré de guillemets doubles,

• chaque ligne doit avoir le même nombre de champs,

• le type MIME ou Content-Type est text/csv.

Vous pouvez vous inspirer du fichier exemple https://github.com/CEREMA/schema-arrete-permanent-circulation/blob/master/exemple-valide.csv

Mise en conformité

Ces conseils reprennent ceux du Schéma des données locales publié par Open Data france

Les fichiers doivent comporter :

• Toutes les colonnes, y compris celles dont les cellules ne sont pas renseignées, dans le bon ordre, et avec des en-têtes correctement nommées sur la première ligne (nom correspondant strictement au schéma)

• Autant de lignes que nécessaire comprenant des cellules dont les valeurs peuvent être obligatoires (elles doivent être impérativement renseignées) ou optionnelles (elles sont seulement recommandées ou soumises à condition de disponibilité / pertinence)

• Traitement des cellules vides (absence de valeur ou valeur équivalente à 0) : ces cellules doivent être laissées vides.

• Les dates doivent être formées selon la norme ISO-8601 : YYYY-MM-DD.