# Importation et exportation

## 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](https://3097111101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWLc8AHXW4tdrAXUBfrYF%2Fuploads%2Fgit-blob-9b4da63f56be675465ae930e3a77be0162234747%2Freadme_1.png?alt=media)

#### É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](https://3097111101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWLc8AHXW4tdrAXUBfrYF%2Fuploads%2Fgit-blob-712b3ab91ccd553682111349056cc75f79e0fba7%2Freadme_2.png?alt=media)

#### É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](https://3097111101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWLc8AHXW4tdrAXUBfrYF%2Fuploads%2Fgit-blob-703387aecb3f18b34fedfc8ffd222f01a4a0739c%2Freadme_3.png?alt=media)

### 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