> For the complete documentation index, see [llms.txt](https://docs.thewalletcrew.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.thewalletcrew.io/configure/fr/advanced-configuration/wallet/import-and-export.md). # 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\ ![Passes List](/files/ba4ef1f44845c30a8a84c8fad3f214644cc545e1) #### É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\ ![Import Modal](/files/9d6919bb895a9d3ef1ff0883912873db7e60929c) #### É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\ ![Import Progress](/files/8e844e1bae2c2fa5d86623d5e0ccc905a91f4079) ### 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 --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## 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, and the optional `goal` query parameter: ``` GET https://docs.thewalletcrew.io/configure/fr/advanced-configuration/wallet/import-and-export.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.