Rechercher
Saisissez au moins deux caractères, sans donnée personnelle.

    BibliothèqueArticles et FAQ Votre projetDemander un devis
    LangueFR
    Guides pratiques

    Préparer un import ou un export de données fiable

    Un fichier qui s’ouvre n’est pas nécessairement exploitable. Un échange fiable conserve le sens des champs, distingue l’inconnu du zéro et permet de rapprocher les lignes sans transformer un libellé en identifiant fragile.

    Voir la méthode

    Deux ordinateurs, disque externe et feuilles de données
    Illustration générée par IA

    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.

    CSV à virgules : quatre fragments indépendants ; [CRLF] note un retour à la ligne réel
    Fragment de démonstrationNombre de champsChamps 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.

    Bilan d’un premier import fictif de six enregistrements
    RésultatNombreEnregistrements concernés
    Créations200120 et 00124
    Mise à jour100121 : valeur différente de la cible
    Sans changement100122 : valeur déjà identique
    Refus2Occurrence 3 : doublon de 00120 ; occurrence 5 : relation manquante pour 00123

    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

    Disque de stockage et câble USB entre deux ordinateurs
    Illustration générée par IA · Comparer les champs après un aller-retour d’export et d’import.

    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

    Documents de référence

    Contenu mis à jour le

    Repères documentaires pour ce sujet

    Repères documentaires pour ce sujet
    RéférenceValeur ou syntaxePorté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-8JSON 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:00Le 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é.

    Matrice de recette à adapter au projet

    Ces contrôles proposés utilisent des cas fictifs. Décidez du comportement attendu avec l’équipe, notez le résultat et attribuez les écarts non résolus avant publication.

    Faites défiler le tableau horizontalement pour lire toutes les colonnes. Au clavier, placez le focus sur le tableau puis utilisez les flèches.

    Cas de test, résultats attendus et preuves utiles
    CasRésultat attenduPreuve à conserver
    Accents, séparateurs et texte multiligneLes valeurs conservent leur sens après export puis import.Jeu témoin avec accents, séparateur dans un champ et retour à la ligne ; valeurs relues après reprise.
    Zéro, vide, null et absenceLes quatre situations suivent des règles distinctes lorsque le contrat le demande.Dictionnaire de données et valeurs réellement reçues.
    Identifiant répétéLa règle choisie distingue doublon, mise à jour et variante légitime.Journal des lignes acceptées ou refusées et justification.
    Échec au milieu du fichierL’équipe sait ce qui a été appliqué et comment reprendre.État final, lignes concernées et procédure de reprise testée.

    Questions fréquentes

    Pourquoi conserver certains codes sous forme de texte ?

    Parce qu’ils identifient une entité au lieu de représenter une quantité. Une conversion automatique peut perdre des zéros initiaux ou changer leur présentation. Définissez leur type dans le contrat et vérifiez un exemple limite.

    Un total de lignes identique prouve-t-il que l’import est correct ?

    Non. Le total peut rester identique malgré des champs perdus, des relations cassées ou un remplacement erroné. Comparez aussi identifiants, valeurs, unités et erreurs avec un lot représentatif.