Temps de lecture estimé : 6 min · Publié le
Décrire le contrat de données
Écrivez un dictionnaire des champs avec sens, type, unité, caractère obligatoire et valeur absente. Précisez les identifiants stables et les relations entre lignes. Le code postal, un numéro de produit ou un code administratif peut nécessiter une représentation textuelle pour conserver son sens.
Indiquez l’encodage, le séparateur, le format des dates, les fuseaux et les règles de décimales. La documentation Python CSV montre que les dialectes doivent être décrits ; une extension de fichier ne suffit pas à imposer une convention identique chez tous les producteurs.
Décrivez le dialecte CSV et testez ses champs avant de compter les lignes. Dans le format à virgules documenté par la RFC 4180, un champ contenant une virgule, un guillemet ou un retour à la ligne est entouré de guillemets doubles ; un guillemet interne est doublé. La notation [CRLF] du tableau représente une vraie paire retour chariot et saut de ligne dans le fichier d’essai. Le champ qui la contient reste un seul champ d’un enregistrement logique.
Exemple de contrôle : un en-tête et deux enregistrements de données, dont le second contient un CRLF dans un champ cité, occupent quatre lignes physiques, pas quatre enregistrements. Utilisez un parseur CSV et comparez les champs. Avec le lecteur Python par défaut, les valeurs sont des chaînes ; les zéros de 00120 peuvent ainsi être conservés tant qu’aucune conversion ultérieure ne les retire. Définissez séparément le sens d’un champ vide et l’ouverture dans un tableur : les guillemets CSV ne suffisent pas à neutraliser une formule.
Faites défiler le tableau horizontalement pour lire toutes les colonnes. Au clavier, placez le focus sur le tableau puis utilisez les flèches.
| Fragment de démonstration | Nombre de champs | Champs lus, représentés en texte |
|---|---|---|
| "Paris, France" | 1 | ["Paris, France"] |
| "A ""B""" | 1 | ["A \"B\""] |
| "A[CRLF]B" | 1 | ["A[CRLF]B"] |
| 00120, | 2 | ["00120", ""] |
Constituer un lot qui met les limites à l’épreuve
Incluez un nom accentué, une ligne sans valeur facultative, un identifiant à zéro initial, une description avec retour à la ligne et une relation manquante. Ajoutez un doublon et un format volontairement invalide. Ce lot doit rester fictif et être reconnaissable comme jeu d’essai.
Décidez le comportement attendu : rejet d’une ligne, rejet du fichier ou import avec rapport d’anomalies. Évitez un résultat « réussi » qui masque la disparition silencieuse de champs. Un rapport de traitement doit indiquer les lignes acceptées, refusées et laissées à vérifier.
Prévoir droits et sécurité de l’échange
Déterminez qui peut exporter, importer et supprimer un lot. Ne placez pas un export confidentiel dans un dossier public par défaut. Lorsque le fichier sera ouvert dans un tableur, examinez les champs pouvant être interprétés comme formules avec une méthode adaptée au logiciel destinataire.
Séparez les données autorisées du contexte interne qui ne doit pas être transmis : commentaires privés, coordonnées non nécessaires ou clés techniques. Une copie de test doit être nettoyée ou synthétique. Documentez l’emplacement, la durée de conservation et la personne qui retire les exports temporaires.
Rapprocher les données après traitement
Comparez les identifiants, les relations, les totaux et un échantillon de valeurs avant et après l’opération. Si le service promet un aller-retour, exportez, réimportez dans un environnement d’essai et comparez le sens des données plutôt que seulement la taille des fichiers.
Conservez une sauvegarde et un compte rendu avant un import destructif. Distinguez mise à jour, ajout et suppression : l’absence d’une ligne dans un export partiel ne signifie pas automatiquement que cette ligne doit être supprimée. Faites valider ces règles avant de traiter toute la base.
Documentation primaire : Python : CSV File Reading and Writing.
Lot fictif : six enregistrements portent, dans cet ordre, les identifiants textuels 00120, 00121, 00120, 00122, 00123 et 00124. Avant import, 00121 existe avec une valeur à modifier et 00122 existe sans changement. La règle choisie accepte la première occurrence d’une clé, refuse sa répétition dans le lot et refuse 00123 dont la relation obligatoire manque. Le bilan du premier passage est donc 2 créations + 1 mise à jour + 1 inchangée + 2 refus = 6 enregistrements examinés.
Après ce passage, la cible contient quatre identifiants : 00120, 00121, 00122 et 00124. Rejouer exactement le même lot, avec les mêmes règles et sans autre modification, doit donner 0 création, 0 mise à jour, 4 inchangées et 2 refus. Cette reprise repose sur le contrat d’import choisi, pas sur une propriété automatique du CSV. Conservez les zéros initiaux et comptez les enregistrements logiques lus par le parseur ; un champ entre guillemets peut contenir un retour à la ligne.
Faites défiler le tableau horizontalement pour lire toutes les colonnes. Au clavier, placez le focus sur le tableau puis utilisez les flèches.
| Résultat | Nombre | Enregistrements concernés |
|---|---|---|
| Créations | 2 | 00120 et 00124 |
| Mise à jour | 1 | 00121 : valeur différente de la cible |
| Sans changement | 1 | 00122 : valeur déjà identique |
| Refus | 2 | Occurrence 3 : doublon de 00120 ; occurrence 5 : relation manquante pour 00123 |
- Python : CSV File Reading and Writing
Python CSV, consulté le 22 octobre 2026 : lecture et formats. Les données et les règles d’acceptation sont un exemple fictif.
Livrer un export dont le nom et le contenu restent compréhensibles dans les langues publiées.
Cas fictif : un export porte un nom contenant des accents. Testez les paramètres filename et filename* appropriés, le type de contenu et le fichier réellement enregistré. Nettoyez les noms issus d’une entrée utilisateur avant de construire l’en-tête. Cet en-tête ne protège pas l’accès au document et ne remplace pas une vérification des autorisations.
- Le nom téléchargé est lisible, le type correspond au contenu et aucune entrée ne peut injecter un en-tête supplémentaire.
- MDN Content-Disposition
Référence de l’en-tête qui indique une présentation dans le navigateur ou un téléchargement, avec les paramètres de nom de fichier.
Tester un aller-retour de données

Cas proposé : un export puis un import change des codes avec zéros initiaux et des dates. Le nombre de lignes reste identique, mais des valeurs ont été altérées.
Préparez un jeu fictif avec accents, cellules vides et formats sensibles. Comparez chaque champ après aller-retour et gardez le rapport ; une importation sans erreur ne garantit pas la fidélité des données.
- Définir types et encodage
- Inclure des valeurs sensibles au format
- Comparer les champs après import
- Distinguer les variantes de produit
Préparer un catalogue de produits utile avant de créer la boutique
Documents de référence
- MDN Content-Disposition · Source consultée
- W3C WAI : Tables Tutorial · Source consultée
- MDN : URLSearchParams · Source consultée
- IETF : RFC 4180: CSV format · Source consultée
- Python : CSV File Reading and Writing · Source consultée
- OWASP : CSV Injection · Source consultée
Contenu mis à jour le
Repères documentaires pour ce sujet
| Référence | Valeur ou syntaxe | Portée du repère |
|---|---|---|
| RFC 4180 · CSV | text/csv · "a,b" | Les champs avec virgule, guillemet ou saut de ligne sont protégés ; les guillemets internes sont doublés. |
| RFC 8259 · JSON | application/json · UTF-8 | JSON standard n’autorise ni commentaires ni virgule finale ; les chaînes utilisent des guillemets doubles. |
| RFC 3339 · Date-time | 2026-10-22T09:00:00+02:00 | Le décalage explicite relie l’heure locale à UTC ; cet exemple n’est pas un rendez-vous. |
Les dates indiquent la consultation des références. Ces repères ne constituent ni un audit du site ni une déclaration globale de conformité.
