# Import & Export

## Importez vos cartes dans The Wallet Crew

The Wallet Crew fournit un outil d'importation puissant qui vous permet d'importer en masse ou de mettre à jour des cartes à l'aide de fichiers XLSX. Ce guide vous expliquera le processus et indiquera les points importants à prendre en compte.

### Aperçu

L'outil d'importation prend en charge :

* Création en masse de nouvelles cartes
* Mise à jour des cartes existantes
* Gestion des différents types de cartes
* Gestion des identifiants de carte et des données supplémentaires
* Suivi de la progression et rapport d'erreurs

### Avant de commencer

1. **Format du fichier**: Préparez votre fichier XLSX en tenant compte des éléments suivants :
   * Les noms de colonnes doivent être propres et éviter les caractères spéciaux
   * Les données doivent être correctement formatées selon les types attendus
   * Le fichier doit contenir toutes les informations nécessaires sur la carte
2. **Colonnes requises**:
   * `id` (optionnel) : S'il est présent, il est utilisé pour identifier les cartes existantes
   * `passType` (optionnel) : Le type de carte. S'il n'est pas spécifié, vous devrez sélectionner un type par défaut
   * Les autres colonnes seront traitées comme des données supplémentaires
3. **Validation des données**:
   * Les adresses e-mail doivent être correctement formatées
   * Les numéros de téléphone doivent respecter des formats standard
   * Les dates doivent suivre un format cohérent

### Processus d'importation

#### Étape 1 : Accédez à l'outil d'importation

1. Accédez à la **Passes** section de votre compte Wallet Crew
2. Cliquez sur le **Importer des cartes** bouton
3. Sélectionnez votre fichier XLSX\
   ![Passes List](/files/bb6864a0669e1a47b8c65ff15f164edac50111c0)

#### Étape 2 : Configurez les paramètres d'importation

La fenêtre d'importation vous montrera deux paramètres importants :

1. **Colonne discriminateur**:
   * Si votre fichier contient une `id` colonne, elle sera automatiquement sélectionnée
   * Sinon, choisissez une colonne qui identifie de manière unique chaque carte
   * Cette colonne sera utilisée pour déterminer si une carte doit être créée ou mise à jour
2. **Type de carte par défaut**:
   * Sélectionnez le type de carte par défaut pour les cartes qui n'en spécifient pas
   * Ceci est requis si votre fichier n'inclut pas une `passType` colonne

#### Étape 3 : Examiner et importer

1. Vérifiez le nombre total de cartes à importer
2. Assurez-vous que les paramètres de colonne discriminante et de type de carte sont corrects
3. Cliquez sur **Importer** pour commencer le processus\
   ![Import Modal](/files/72d8fd98f23d0bcbc136bdc54a25be73c2547dcc)

#### Étape 4 : Surveillez la progression

Pendant l'importation :

* Une barre de progression affiche l'état actuel
* Vous pouvez voir le nombre de cartes créées et mises à jour
* Toutes les erreurs sont affichées en temps réel
* Vous pouvez annuler l'importation à tout moment\
  ![Import Progress](/files/79a5bfa7e286ce5d49b16a459d30b285e4fb88f1)

### Remarques importantes

1. **Traitement par lots**:
   * Les cartes sont importées par lots de 16 pour des performances optimales
   * Le processus continue même si certaines cartes n'ont pas pu être importées
2. **Gestion des erreurs**:
   * Les formats de données invalides sont signalés
   * Les champs obligatoires manquants sont mis en évidence
   * Vous pouvez examiner les erreurs et apporter des corrections
3. **Annulation**:
   * Vous pouvez annuler l'importation à tout moment
   * La fenêtre du navigateur doit rester ouverte pendant le processus
4. **Traitement des données**:
   * Les valeurs vides sont converties en `null`
   * Les colonnes spéciales (id, secret, creationDate, etc.) sont exclues des données supplémentaires
   * Les champs de métadonnées sont traités séparément

### Après l'importation

1. La page se rafraîchira automatiquement pour afficher les cartes mises à jour une fois que vous aurez fermé la fenêtre modale
2. Vous pouvez consulter le rapport d'importation indiquant :
   * Nombre de cartes créées
   * Nombre de cartes mises à jour
   * Toutes les erreurs survenues

### Bonnes pratiques

1. **Préparation des données**:
   * Nettoyez vos données avant l'importation
   * Utilisez un formatage cohérent
   * Validez les adresses e-mail et les numéros de téléphone
2. **Structure du fichier**:
   * Gardez les noms de colonnes simples et clairs
   * Utilisez des formats de date standard
   * Incluez tous les champs requis
3. **Importations volumineuses**:
   * Pour les fichiers volumineux, envisagez de les diviser en lots plus petits
   * Surveillez la progression et vérifiez les erreurs
   * Gardez la fenêtre du navigateur ouverte pendant l'importation

### Dépannage

Si vous rencontrez des problèmes :

1. Consultez le rapport d'erreurs pour connaître les problèmes spécifiques
2. Vérifiez le format de votre fichier et vos données
3. Assurez-vous que tous les champs obligatoires sont présents
4. Essayez d'importer un lot plus petit pour tester


---

# 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://docs.thewalletcrew.io/fr/configurer/wallet/import-and-export.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.