Importer des cartes depuis CSV ou Excel

Vue d'ensemble

Vous pouvez importer des cartes depuis des fichiers CSV ou Excel (XLSX) directement dans un tableau. Le processus d'import valide vos données avant de créer les cartes, pour que vous puissiez corriger les problèmes en amont.

Le flux fonctionne ainsi : Upload → Prévisualisation (dry-run) → Import → Terminé.

Étape 1 : Ouvrir la boîte de dialogue d'import

1. Naviguez vers le tableau où vous souhaitez importer des cartes
2. Ouvrez le menu du tableau et cliquez sur Import
3. Choisissez Excel ou CSV comme format

Si vous avez déjà sauvegardé des configurations d'import, elles apparaissent aussi dans ce menu — cliquez sur l'une d'elles pour réutiliser ses paramètres.

Étape 2 : Télécharger un template (optionnel)

Avant de préparer votre fichier, vous pouvez télécharger un template qui correspond à la structure du tableau :

• Cliquez sur Download CSV template ou Download XLSX template
• Le template contient des en-têtes de colonnes correspondant aux labels de dimensions du tableau
• Remplissez vos données sous ces en-têtes et sauvegardez

Utiliser un template évite les problèmes de mapping puisque les noms de colonnes correspondent déjà à vos dimensions.

Étape 3 : Télécharger votre fichier

Glissez-déposez votre fichier sur la zone de téléchargement, ou cliquez pour parcourir. Le système accepte :

• Fichiers CSV (.csv, séparés par des virgules)
• Fichiers Excel (.xlsx, format Excel moderne)

Une fois téléchargé, le système effectue immédiatement un dry-run — il lit votre fichier, mappe les colonnes aux dimensions et valide chaque ligne sans rien créer.

Étape 4 : Examiner les résultats du dry-run

L'écran de prévisualisation vous montre exactement ce qui va se passer :

• Nouvelles cartes à créer — lignes qui ne correspondent à aucune carte existante
• Cartes à mettre à jour — lignes qui correspondent à des cartes existantes (par identifiant)
• Nouvelles valeurs de dimension — valeurs qui n'existent pas encore et seront créées automatiquement
• Erreurs — lignes qui ne peuvent pas être importées, avec les détails

Comprendre les erreurs

Si certaines lignes ont des problèmes, vous verrez un tableau d'erreurs indiquant :

Causes d'erreur courantes :

• Valeur de dimension inconnue — votre fichier contient une valeur qui n'existe pas pour cette dimension (par ex. « Urgent » alors que seuls « Low », « Medium », « High » sont définis). Si la dimension autorise le tagging, les nouvelles valeurs sont créées automatiquement ; sinon, c'est une erreur.
• Incompatibilité de type — une colonne de date contient quelque chose qui n'est pas une date, ou une colonne numérique contient du texte.
• Champ requis vide — une dimension obligatoire (comme le titre de la carte) est vide pour cette ligne.

Import partiel

Si certaines lignes sont valides et d'autres ont des erreurs, vous pouvez choisir d'importer uniquement les lignes valides et ignorer les lignes problématiques. Ou revenir en arrière, corriger votre fichier et réessayer.

Étape 5 : Confirmer et importer

Cliquez sur Import everything (ou Import valid lines s'il y a des erreurs). Le système crée ou met à jour les cartes en masse.

Après l'import, cliquez sur Refresh board to see the changes pour charger les nouvelles cartes sur votre tableau.

Comment fonctionne le mapping des colonnes

Le système mappe automatiquement les colonnes de votre tableur aux dimensions en recherchant :

1. Les labels de dimension — le nom lisible (par ex. « Priority », « Due Date »)
2. Les codes de dimension — le nom technique (par ex. « priority », « due_date »)

La première correspondance trouvée l'emporte. Les colonnes qui ne correspondent à aucune dimension sont silencieusement ignorées.

Colonnes spéciales

• Titre de carte — mappé depuis les colonnes nommées « Card title », « title », « Card summary » ou « summary ». Si plusieurs sont trouvées, elles sont combinées.
• Identifiant — si votre tableau a une dimension Identifier et que votre fichier inclut une colonne d'identifiant, le système l'utilise pour mettre à jour les cartes existantes plutôt que de créer des doublons.

Valeurs multiples

Pour les dimensions qui supportent plusieurs valeurs (par ex. Tags, Assignees), séparez les valeurs par des virgules dans une seule cellule :

Alice, Bob, Charlie

Chaque valeur est nettoyée, mappée à sa valeur de dimension et validée indépendamment.

Mettre à jour des cartes existantes

L'import peut mettre à jour des cartes au lieu d'en créer de nouvelles. Cela se produit quand :

1. Votre tableau a une dimension Identifier
2. Votre fichier inclut une colonne pour cet identifiant
3. La valeur de l'identifiant correspond à une carte existante

Les lignes correspondantes mettent à jour les dimensions de la carte existante. Les lignes non correspondantes créent de nouvelles cartes.

Valeurs par défaut issues des filtres

Quand vous importez dans un tableau qui a des filtres actifs, ces valeurs de filtre sont appliquées par défaut à chaque carte importée. Par exemple, si votre tableau est filtré pour n'afficher que Status = To Do, toutes les cartes importées recevront automatiquement Status = To Do.

Vous pouvez désactiver ce comportement dans les Options avancées.

Options avancées

Cliquez sur Advanced options avant d'importer pour accéder à :

• Don't enforce required dimensions — ignorer la validation des champs obligatoires, utile pour les imports partiels
• Ignore unsaved board filters for default values — appliquer uniquement les filtres sauvegardés (permanents) comme valeurs par défaut, pas les filtres temporaires
• Custom data transformer — télécharger un fichier YAML (au format Monolens) pour transformer vos données avant l'import. Pour les utilisateurs avancés qui ont besoin de mappings de colonnes ou de transformations de valeurs personnalisés.

Sauvegarder une configuration d'import

Si vous prévoyez d'importer régulièrement avec les mêmes paramètres, vous pouvez sauvegarder la configuration d'import après un import réussi :

1. Après l'import, entrez un nom pour la configuration (jusqu'à 25 caractères)
2. Cliquez sur Save

La configuration sauvegardée apparaît dans le menu déroulant Import pour une utilisation future. Elle mémorise vos options et tout transformer personnalisé.

Conseils pour un import réussi

• Commencez par le template — téléchargez le template CSV ou XLSX pour obtenir les bons en-têtes de colonnes
• Vérifiez vos formats de date — les dates doivent suivre un format standard (par ex. 2026-04-15)
• Attention aux fautes de frappe dans les valeurs de catégorie — si une dimension n'est pas taggable, les valeurs doivent correspondre exactement
• Utilisez le dry-run — examinez toujours la prévisualisation avant d'importer ; il détecte les problèmes en amont
• Utilisez les identifiants pour les mises à jour — incluez une colonne d'identifiant si vous voulez mettre à jour des cartes existantes plutôt que créer des doublons