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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://opendatafrance.gitbook.io/fablog/espace-arretes/tutoriels/sauvegarder-son-fichier-de-donnees.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
