
Qualité et circulation des données
CSV voyage : préserver types, colonnes et références
Un fichier peut s’ouvrir correctement tout en altérant un identifiant, une date ou un montant. L’échange doit préciser la structure attendue et contrôler ce qui a réellement été importé. Le fichier source, le résultat et les rejets sont à conserver avec leur version pour permettre la reprise sans rejouer toutes les lignes.
Décrire le format avant de lire les valeurs
La RFC 4180 décrit un format CSV avec champs séparés par des virgules, guillemets pour certains champs et doublement d’un guillemet interne. Les outils utilisent aussi d’autres conventions. Indiquez séparateur, encodage, présence d’en-tête et règles de retour à la ligne au lieu de supposer qu’un nom de fichier suffit.
Une adresse ou un commentaire peut contenir virgule, guillemet ou saut de ligne. Compter les séparateurs à la main ne remplace pas un lecteur adapté. Vérifiez le nombre et le nom des colonnes, puis utilisez un petit échantillon couvrant accents, texte long et champs vides. Le fichier accepté doit produire la même structure dans l’outil destinataire.
Préserver les identifiants, dates et montants
Traitez un identifiant comme du texte lorsque le format du système le prévoit. Exemple pédagogique : 00127 et 127 peuvent désigner des références différentes ; un tableur peut effacer les zéros initiaux. Le rapprochement doit utiliser la valeur source plutôt qu’un affichage converti. Un numéro long n’est pas forcément un nombre destiné au calcul.
Déclarez devise, unité et séparateur décimal des montants, ainsi que le format des dates et le fuseau des heures lorsque nécessaire. Distinguez valeur absente, zéro et code de statut. Ne laissez pas une détection automatique de type décider qu’une référence de chambre est une date ou qu’une valeur vide signifie stock nul.
Tester le mapping et les lignes rejetées
Associez chaque colonne au champ destinataire avec une règle explicite. Les colonnes facultatives, doublons d’identifiant et valeurs inconnues demandent une décision documentée. Un import partiel doit produire un bilan : lignes lues, acceptées, rejetées et ignorées, avec références retrouvables. Un total général « traité » masque ces différences.
Avant de modifier le catalogue maître, comparez des lignes témoins avant et après import. Vérifiez aussi un fichier contenant un identifiant déjà présent et un champ vide. La mise à jour d’un champ doit suivre la règle prévue ; elle ne doit pas effacer une donnée fiable simplement parce que la colonne source était absente.
Prévoir la lecture du fichier dans un tableur
OWASP décrit le risque de CSV Injection : un tableur peut interpréter une cellule provenant de données non fiables comme une formule. Les guillemets du format CSV ne constituent pas à eux seuls une protection contre cette interprétation. La mesure retenue doit être testée dans les logiciels destinataires du fichier.
Séparez un export destiné à la relecture humaine d’un export destiné à un import automatisé si leurs transformations diffèrent. Préservez les données originales et documentez les protections appliquées à la version de consultation. Une modification silencieuse de toutes les cellules peut empêcher un rapprochement ultérieur ou transformer une référence valide.
Relier le résultat au fichier et à sa version
Le journal conserve source, version de mapping, heure, destination et bilan. Pour reprendre après un rejet, identifiez les lignes déjà appliquées et les lignes à corriger. Une nouvelle tentative sur tout le fichier peut créer des doublons si l’outil ne remplace pas les enregistrements par leur identifiant. La stratégie dépend des garanties réelles de l’importateur.
Utilisez la fiche de contrôle CSV et le registre des échanges CSV. La recette inclut fichier mal encodé, guillemet interne, identifiant avec zéros, date ambiguë et import partiel. L’objectif est de retrouver les valeurs appliquées et les actions restantes, pas seulement d’obtenir une fenêtre sans erreur.
Vérifier le passage entre formats
Un export CSV transformé en JSON ne reçoit pas automatiquement des types métier corrects. Définissez références, quantités et montants avant de convertir ; la forme d’un identifiant ne doit pas être changée parce qu’un outil le reconnaît comme nombre. Les champs vides demandent une règle explicite.
Rejouez un aller-retour avec zéro initial, caractère non latin et valeur inconnue. Comparez les objets et les références plutôt que la seule présentation du fichier. Les écarts doivent être suivis au point de transformation pour éviter de corriger séparément les mêmes lignes à chaque import.
JSON et Unicode : préserver les identifiants et textes du catalogue voyage : méthode, cas de contrôle et limites.
Rapprocher ce sujet du dossier suivant
Avant de lire un export CSV, rapprochez le fichier reçu de sa référence de livraison et de son manifeste. Une empreinte identique peut montrer l’intégrité de l’objet comparé, puis la lecture doit encore vérifier colonnes, encodage et contenu métier. Archive et fichier extrait doivent rester explicitement distingués.
Intégrité des fichiers : contrôler la livraison d’un catalogue · Vérifier les preuves de ce dossier
Cas à rapprocher : Archives de catalogue : contrôler le contenu extrait et ses limites
Un fichier CSV reçu dans une archive doit être rapproché du manifeste et du résultat d’extraction avant sa lecture. Gardez la liste des objets attendus et le motif des différences. Un transfert correct ne dispense pas de vérifier le périmètre des fichiers réellement appliqués.
Archives de catalogue : contrôler le contenu extrait et ses limites · Vérifier les preuves de ce dossier
Approfondir le parcours : JSON Lines : lignes de catalogue, rejets et reprise d’un export
Le choix de JSON Lines change le découpage, mais ne remplace pas le contrat d’import. Une valeur par ligne doit encore être rapprochée du produit attendu. Les rejets gardent lot, localisation et règle de reprise plutôt qu’un simple total de lignes.
JSON Lines : lignes de catalogue, rejets et reprise d’un export · Rapprocher les preuves du parcours
CSV : protéger la lecture sans déformer les données d’import
Un fichier destiné à une lecture humaine dans un tableur et un fichier destiné à une API peuvent demander des traitements différents. La recette doit conserver cette distinction au lieu d’ajouter silencieusement des caractères à toutes les valeurs.
| Point documenté | Ce que la source précise | Conséquence pour votre contrôle |
|---|---|---|
| Enregistrement puis réouverture | OWASP indique qu’Excel peut retirer guillemets ou caractères d’échappement lors d’un nouvel enregistrement ; une protection supposée peut alors ne plus fonctionner. | Testez aussi le fichier enregistré puis rouvert dans le logiciel destinataire. |
| Début réel d’une cellule | Un séparateur ou un guillemet dans une entrée peut déplacer une partie du texte au début d’une nouvelle cellule. | Contrôlez le découpage CSV et les cellules produites, pas seulement le premier caractère du texte source. |
| Variantes de caractères | OWASP cite les formes pleine chasse =, +, - et @, susceptibles d’être interprétées comme des débuts de formule dans certains environnements linguistiques. | Incluez la langue et le tableur dans le périmètre des essais. |
| Transformation conservée dans les données | Le préfixe de tabulation décrit pour Excel reste dans la valeur sous-jacente et peut affecter un import programmatique. | Séparez version de consultation et version d’échange, avec les transformations expliquées. |
Trois cellules fictives à lire avant de convertir
Les exemples sont affichés comme du texte. [TAB] désigne ici une tabulation, pas les cinq caractères à ajouter à une donnée.
Les guillemets CSV ne transforment pas seuls une formule en texte
Un champ de test contient une expression arithmétique inoffensive.
Champ CSV : "=1+2"
Valeur après lecture CSV : =1+2Lecture du cas. Les guillemets délimitent le champ. L’interprétation de la valeur par le tableur reste une étape distincte.
La version de consultation contient un caractère ajouté
Un export de test destiné au tableur préfixe une valeur par une tabulation.
Valeur source : =1+2
Version de consultation : [TAB]=1+2Lecture du cas. La valeur contient un caractère de plus. Avant une réutilisation par import, retrouvez la version et la transformation prévues.
Un montant négatif ne doit pas perdre son signe sans règle
Une colonne de montant fictive contient une valeur négative.
Champ attendu : montant signé
Valeur source : -12.50Lecture du cas. Supprimer le signe changerait le montant. Le type attendu, la lecture du destinataire et le traitement de la version de consultation doivent être qualifiés séparément.
Analyse OWASP consultée le 22 octobre 2026. Elle souligne l’absence de transformation CSV universelle adaptée à tous les tableurs et destinataires. Les exemples ci-dessous servent à lire le format et les valeurs, sans exécuter de formule.
OWASP — CSV Injection · consultée le . Les contrôles proposés sont une lecture éditoriale de cette référence.
Sources et périmètre des faits documentés
La date de consultation figure avec chaque référence. Les méthodes d’essai et recommandations de ce guide sont éditoriales ; les conditions d’accès et d’usage se vérifient dans la documentation actuelle.
- RFC 4180 : format CSV : Séparateurs, en-tête, champs entre guillemets et échappement des guillemets ; les variantes nécessitent un accord explicite. (consultée le )
- OWASP : CSV Injection : Risque d’interprétation de cellules non fiables par un tableur ; les mesures dépendent du lecteur et de l’usage. (consultée le )
- OWASP — CSV Injection : Analyse OWASP consultée le 22 octobre 2026. Elle souligne l’absence de transformation CSV universelle adaptée à tous les tableurs et destinataires. Les exemples ci-dessous servent à lire le format et les valeurs, sans exécuter de formule. (consultée le )
Questions fréquentes
Questions utiles avant de décider
Un CSV lisible dans un tableur est-il prêt à être importé ?
Pas forcément. Une ouverture peut convertir des identifiants, des dates ou des nombres. Dans un outil interne autorisé, contrôlez le schéma attendu puis comparez des valeurs témoins avant et après lecture. La conformité du séparateur et des guillemets ne garantit pas le sens métier des colonnes.
Les guillemets CSV empêchent-ils une interprétation en formule ?
Non. Les guillemets décrivent la structure CSV ; l’interprétation des cellules par le tableur relève d’un autre contrôle. OWASP documente ce risque pour des données non fiables. Définissez les lecteurs et usages autorisés, puis testez leur traitement sans supposer qu’un simple encadrement du champ neutralise une formule.
Faut-il renvoyer tout le fichier après un import partiel ?
Seulement si le contrat de reprise le prévoit. Retrouvez les lignes déjà appliquées, rejetées et encore inconnues, ainsi que la clé de rapprochement. Rejouer toutes les lignes peut créer des doublons ou écraser une correction. Préparez une reprise ciblée dans l’outil interne et comparez le bilan final au lot attendu.
Le passage en JSON résout-il les types d’un fichier CSV ?
Non. Le contrat métier doit définir les types et le sens des valeurs manquantes ; la conversion se contrôle sur un aller-retour.
Une tabulation de protection est-elle invisible pour l’import suivant ?
Pas nécessairement : OWASP précise qu’elle reste dans les données sous-jacentes. Vérifiez le consommateur et le rôle de l’export ; une version de consultation ne doit pas remplacer silencieusement la valeur maître.





