Documentation · Référence
Format de fichier XLSX et CSV
Le schéma du classeur d'aller-retour : une feuille par culture, les colonnes que Daxlate relit, et quand une ligne est importée.
Dernière mise à jour :
Daxlate exporte les traductions en XLSX (via ClosedXML) ou en CSV (via
CsvHelper). Un fichier doté d’une couche rapport exporte deux feuilles,
Modèle et Rapport (ou la paire .model.csv et .report.csv) ; un
fichier sans couche rapport n’exporte que la couche modèle. Cette page documente
d’abord la feuille du modèle en détail, puis la feuille du rapport.
Structure de la feuille du modèle #
La feuille de calcul du modèle s’appelle Model (les exports à une seule
couche des versions antérieures la nommaient Translations). Ses lignes :
| Ligne | Contenu |
|---|---|
| 1 | Marqueur de version de schéma en cellule A1 (Daxlate/1.0, en italique, gris) |
| 2 | Ligne d’en-tête, en gras, sur fond beige |
| 3+ | Une ligne par objet traduisible |
La ligne d’en-tête est figée pour que les titres de colonnes restent visibles pendant que le traducteur fait défiler. Les quatre premières colonnes sont elles aussi figées, pour que les colonnes d’identité restent visibles lors du défilement horizontal à travers les colonnes de culture.
Colonnes #
Quatre colonnes d’information fixes viennent en premier :
| Colonne | Remarques |
|---|---|
Object ID | Clé d’identité à l’import. Ne pas modifier. |
Type | L’une des valeurs Table, Column, Measure, Hierarchy, Level. |
Parent | Nom de l’objet conteneur (par exemple la table où vit une mesure). |
Name | Le nom de l’objet dans le modèle (le libellé de la culture par défaut). |
Puis, pour chaque culture du modèle, deux colonnes :
Caption ({culture}) Description ({culture})
Les colonnes de la culture par défaut du modèle sont sur fond grisé, pour qu’on voie tout de suite laquelle fait référence.
Le choix des colonnes écrites suit le commutateur AFFICHAGE de la grille au moment de l’export : Libellé n’écrit que les colonnes de libellé, Description que les colonnes de description, Les deux écrit les deux. Chaque objet reçoit une ligne dans tous les modes, y compris ceux qui n’ont pas encore de description.
Convention Object ID #
Daxlate compose les identifiants à partir du genre de l’objet et de son nom qualifié :
| Genre | Forme | Exemple |
|---|---|---|
| Table | t.{Name} | t.Sales |
| Colonne | c.{Table}.{Name} | c.Sales.Revenue |
| Mesure | m.{Table}.{Name} | m.Sales.Total Revenue |
| Hiérarchie | h.{Table}.{Name} | h.Date.Calendar |
| Niveau de hiérarchie | {HierarchyId}.l{Ordinal} | h.Date.Calendar.l1 |
Renommer un objet dans le modèle change son identifiant. À la réimportation, les lignes portant un Object ID inconnu apparaissent en avertissement dans la boîte de dialogue d’aperçu et sont ignorées ; l’import ne les supprime pas en silence.
Version de schéma #
La cellule A1 du XLSX (ou la première ligne de commentaire du CSV) porte la
version de schéma. Le lecteur refuse les fichiers issus d’une version majeure
plus récente avec un avertissement clair, et traite les marqueurs absents comme
du 1.0 pour rester compatible avec les exports antérieurs au versionnage.
Le marqueur actuel est Daxlate/1.0. Les incréments sont mineurs pour des
colonnes ajoutées (les nouvelles colonnes sont ignorées avec un avertissement)
et majeurs pour les changements cassants (par exemple une autre convention
d’Object ID).
Feuille du rapport #
Pour un fichier doté d’une couche rapport, une deuxième feuille nommée
Report porte le texte du canevas (titres de visuels, en-têtes, boutons,
zones de texte). Elle adopte une forme large et confortable pour le
traducteur : une ligne par élément de texte avec une seule colonne
Value ({culture}) par langue, au lieu du couple libellé/description de la
feuille du modèle, de sorte que le traducteur remplit toutes les langues d’une
chaîne sur une seule ligne. L’import détecte d’après le contenu s’il s’agit
d’une feuille de modèle, d’une feuille de rapport ou d’un classeur à deux
feuilles, et applique la couche correspondante.
Sur le disque, les traductions du rapport vivent à côté du fichier sous forme de
fichier compagnon nommé {fichier}.daxlate.csv, le CSV fonctionnel que Power BI
lit à l’actualisation. Les traductions du modèle vivent dans le .pbit ; pour en
obtenir une copie, passez par Exporter. Voir
Traduire les visuels du rapport.
Structure du CSV #
Le CSV reprend la même disposition de colonnes, séparées par des virgules. La ligne 1 porte le marqueur de schéma sous forme de commentaire :
# Daxlate/1.0
Object ID,Type,Parent,Name,Caption (en-US),Description (en-US),Caption (fr-FR),Description (fr-FR)
t.Sales,Table,,Sales,Sales,,Ventes,
c.Sales.Revenue,Column,Sales,Revenue,Revenue,,Chiffre d'affaires,
UTF-8 avec BOM et fins de ligne CRLF, pour la compatibilité avec l’ouverture par double-clic dans Excel.
Cellules vides #
Une cellule vide signifie « pas encore traduit » et n’est pas touchée à l’import ; elle n’efface pas une traduction existante. Cela correspond à XLIFF, gettext et aux plateformes de traduction courantes : rendre un fichier à moitié terminé n’efface donc jamais les lignes qu’un traducteur n’a pas atteintes. L’aperçu d’import indique combien de cellules vides ont été ignorées. Pour supprimer une traduction, videz-la dans la grille ou retirez la langue de la liste déroulante Cultures. Voir Aller-retour Excel pour le flux complet de réimportation.