synthèse basé sur les sources que vous avez fournies, rédigé en français.
Document de Synthèse: Importation et Exportation de Données (CSV et Excel) dans Tabletop Creator
Introduction
Ce document résume les principaux thèmes et informations clés concernant l'importation et l'exportation de données en utilisant les formats CSV et Excel dans Tabletop Creator. Il met en évidence les options de configuration, de filtrage, de formatage des données et de cartographie (mapping), ainsi que les aspects à considérer pour assurer une importation/exportation réussie.
- Localisation des Options d'Import/Export
CSV: Les options d'importation et d'exportation CSV se trouvent dans la zone "Set/Item Properties", accessible via le menu "More Options". Excel: Les options d'importation et d'exportation Excel se trouvent dans l'écran "Components". 2. Exportation de Données
2.1. Options de Contenu des Données
Les deux formats offrent des options similaires pour sélectionner les propriétés à inclure dans l'export:
Quantité de l'élément ("Item amount"). Valeur principale du panneau ("panel main value"). Visibilité du panneau ("panel visible property"). Couleur du panneau ("panel color"). Couleur de fond/remplissage du panneau ("panel background / fill color"). Propriétés avancées du panneau ("panel advanced properties"). 2.2. Options de Filtrage des Données
Les deux formats permettent de filtrer les données exportées :
Inclusion des valeurs du blueprint ("Include blueprint values"). Inclusion des valeurs par défaut du blueprint ("Include blueprint default property values"). Inclusion des panneaux non éditables du blueprint ("Include non-editable blueprint panels"). Inclusion des détails non référencés par le blueprint ("Include details not referenced by the blueprint"). Suppression des propriétés de détail de colonne inutilisées ("Skip unused column detail properties"), pour réduire la redondance. 2.3. Options de Formatage des Données
Les options de formatage des données comprennent :
Inclusion des noms de détails dans la première ligne (en-tête) : "Include detail names in the first row" Tri des colonnes par nom de détail : "Sort columns by detail name" Forcer le panneau principal à être trié comme première colonne : "Force main panel to be sorted as the first column" (Excel seulement) Formatage des cellules NULL avec une couleur gris clair : "Format NULL cells with light gray color" 3. Importation de Données
3.1. Configuration Générale
Les deux formats nécessitent une configuration avant l'importation :
Indiquer si la première ligne contient les noms de colonnes ("First row contains the column names"). Cette information est essentielle pour le fonctionnement de la fonctionnalité d'auto-mapping. Choisir si l'on doit supprimer tous les éléments existants avant l'importation (mode remplacement) : "Delete all Items before importing (replace mode)". Définir si les éléments existants doivent être mis à jour en utilisant la valeur du panneau principal du blueprint comme identifiant d'élément : "Update existing items in the set using the blueprint main panel as item ID". Spécifier si toutes les valeurs des propriétés doivent être écrasées, y compris les valeurs NULL du fichier (CSV ou Excel) : "Override all property values, including null values from the CSV" / "Override all property values including null values from the Excel". 3.2. Auto-Mapping
Tabletop Creator offre une fonctionnalité d'auto-mapping qui tente de faire correspondre automatiquement les colonnes du fichier importé aux données du Set. Pour que l'auto-mapping fonctionne correctement :
CSV: Les noms des colonnes doivent suivre un certain format ( [Item Amount], detail_name, detail_name:property_name). Excel: Les feuilles Excel doivent être nommées selon le format set_name@blueprint_name, et les colonnes doivent respecter les mêmes formats que pour le CSV. Il est possible de réinitialiser l'auto-mapping si nécessaire.
3.3. Data Mapping Manuel
L'utilisateur a la possibilité d'ajuster manuellement les correspondances pour chaque colonne, en spécifiant le panneau cible et la propriété concernée. Des icônes d'avertissement ⚠️ signalent les erreurs potentielles.
Exemples d'avertissements courants :
CSV:Nombre irrégulier de colonnes. Colonnes non mappées. Noms de détails inexistants (ils seront créés). Propriétés non utilisées (elles seront importées). Mappage dupliqué. Excel:Feuille Excel non mappée à aucun set. Nom de Set inexistant (sera créé). Les mêmes erreurs que CSV. 4. Format de Données Compris
CSV: "Comma-Separated Values". Chaque ligne représente un enregistrement, et les valeurs sont séparées par des virgules. Les caractères spéciaux doivent être entourés de guillemets doubles. Excel: Format XLSX (OOXML). Les formats plus anciens comme XLS ne sont pas pris en charge. An important consideration is that when a cell in Excel contains no data (an empty string), it is treated as NULL. If you need to override a property in your item with an empty string as its value, the cell must contain the Unicode character U+200B (Zero width space). Conclusion
L'importation et l'exportation de données via CSV et Excel dans Tabletop Creator offrent une grande flexibilité. Il est crucial de comprendre les options de configuration, de filtrage et de mapping pour garantir l'intégrité des données. La résolution des avertissements avant l'importation est fortement conseillée.