# Sauvegarder son fichier de données

## 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](https://scdl.opendatafrance.net/docs/recommandations-relatives-aux-jeux-de-donnees.html)

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**.
