Importation et exportation

Importez vos Cartes dans The Wallet Crew

The Wallet Crew propose un puissant outil d’importation qui vous permet d’importer en masse ou de mettre à jour des Cartes à l’aide de fichiers XLSX. Ce guide vous accompagnera tout au long du processus et expliquera 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 de différents types de Carte
• Gestion des identifiants de Carte et des données supplémentaires
• Suivi de la progression et rapports 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 clairs et ne pas contenir de 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 les Cartes
2. Colonnes requises:

   • id (facultatif) : s’il est présent, il est utilisé pour identifier les Cartes existantes
   • passType (facultatif) : le type de Carte. Si aucun n’est 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 suivre les formats standard
   • Les dates doivent être dans un format cohérent

Processus d’importation

Étape 1 : accéder à l’outil d’importation

1. Accédez à la section Cartes dans votre compte Wallet Crew
2. Cliquez sur le Importer des Cartes bouton
3. Sélectionnez votre fichier XLSX

Étape 2 : configurer les paramètres d’importation

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

1. Colonne discriminante:

   • Si votre fichier contient une id colonne, elle sera sélectionnée automatiquement
   • 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 de passType colonne

Étape 3 : vérifier et importer

1. Vérifiez le nombre total de Cartes à importer
2. Vérifiez que les paramètres de la colonne discriminante et du type de Carte sont corrects
3. Cliquez sur Importer pour lancer le processus

Étape 4 : surveiller 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

Remarques importantes

1. Traitement par lot:

   • Les Cartes sont importées par lots de 16 pour des performances optimales
   • Le processus continue même si certaines Cartes échouent à l’importation
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 des noms de colonnes simples et clairs
   • Utilisez des formats de date standard
   • Incluez tous les champs obligatoires
3. Imports volumineux:

   • Pour les fichiers volumineux, envisagez de les diviser en lots plus petits
   • Surveillez la progression et vérifiez les erreurs
   • Laissez la fenêtre du navigateur ouverte pendant l’importation

Dépannage

Si vous rencontrez des problèmes :

1. Consultez le rapport d’erreurs pour identifier 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