XLSX- en CSV-bestandsformaat

Laatst bijgewerkt: 26 juli 2026

Daxlate exporteert vertalingen als XLSX (via ClosedXML) of als CSV (via CsvHelper). Een bestand met een rapportlaag exporteert twee bladen, Model en Rapport (of het paar .model.csv en .report.csv); een bestand met alleen een model exporteert enkel de modellaag. Deze pagina beschrijft eerst het modelblad in detail, daarna het rapportblad.

Indeling van het modelblad #

Het werkblad van het model heet Model (exports met één laag uit oudere builds noemden het Translations). De rijen:

Rij	Inhoud
1	Schemaversiemarkering in cel A1 (Daxlate/1.0, cursief, grijs)
2	Kopregel, vet, met een beige achtergrond
3+	Eén rij per vertaalbaar object

De kopregel is vastgezet, zodat de kolomtitels zichtbaar blijven terwijl de vertaler scrolt. Ook de eerste vier kolommen staan vast, zodat de identiteitskolommen zichtbaar blijven bij het naar rechts scrollen langs de cultuurkolommen.

Kolommen #

Eerst komen vier vaste informatiekolommen:

Kolom	Opmerkingen
Object ID	Identiteitssleutel bij het importeren. Niet bewerken.
Type	Een van Table, Column, Measure, Hierarchy, Level.
Parent	Naam van het omvattende object (bijvoorbeeld de tabel waarin een meting staat).
Name	De naam van het object in het model (het bijschrift van de standaardcultuur).

Daarna, voor elke cultuur in het model, twee kolommen:

Caption ({culture})    Description ({culture})

De kolommen van de standaardcultuur van het model krijgen een gearceerde achtergrond, zodat duidelijk is welke kolom leidend is.

Welke van de twee kolommen worden weggeschreven volgt de WEERGAVE-schakelaar van het raster op het moment van exporteren: Bijschrift schrijft alleen bijschriftkolommen, Beschrijving alleen beschrijvingskolommen, Beide schrijft ze allebei. Elk object krijgt in elke stand nog steeds een rij, ook objecten die nog geen beschrijving hebben.

Conventie voor Object ID #

Daxlate stelt de ID’s samen uit de soort van het object en zijn volledige naam:

Soort	Vorm	Voorbeeld
Tabel	t.{Name}	t.Sales
Kolom	c.{Table}.{Name}	c.Sales.Revenue
Meting	m.{Table}.{Name}	m.Sales.Total Revenue
Hiërarchie	h.{Table}.{Name}	h.Date.Calendar
Hiërarchieniveau	{HierarchyId}.l{Ordinal}	h.Date.Calendar.l1

Een object in het model hernoemen verandert zijn ID. Bij het terugimporteren komen rijen met een onbekende Object ID als waarschuwing in het voorbeeldvenster terecht en worden ze overgeslagen; de import laat ze niet stilletjes vallen.

Schemaversie #

Cel A1 van de XLSX (of de eerste commentaarregel van de CSV) draagt de schemaversie. De lezer weigert bestanden van een nieuwere hoofdversie met een duidelijke waarschuwing en behandelt ontbrekende markeringen als 1.0, voor de compatibiliteit met exports van vóór het versiebeheer.

De huidige markering is Daxlate/1.0. Ophogingen zijn minor bij extra kolommen (nieuwe kolommen worden met een waarschuwing genegeerd) en major bij brekende wijzigingen (bijvoorbeeld een andere conventie voor Object ID).

Rapportblad #

Bij een bestand met een rapportlaag draagt een tweede blad met de naam Report de tekst van het rapportcanvas (visualtitels, kopteksten, knoppen, tekstvakken). Het gebruikt een brede, vertalervriendelijke vorm: één rij per tekstelement met één kolom Value ({culture}) per taal, in plaats van het paar bijschrift/beschrijving van het modelblad, zodat een vertaler alle talen van een tekenreeks op één regel invult. De import bepaalt aan de inhoud of een bestand een modelblad, een rapportblad of een werkmap met twee bladen is, en past de bijbehorende laag toe.

Op schijf staan rapportvertalingen naast het bestand als metgezel per bestand met de naam {bestand}.daxlate.csv, de functionele CSV die Power BI bij het vernieuwen leest. De modelvertalingen zitten in de .pbit; een kopie daarvan krijg je via Exporteren. Zie Rapportvisuals vertalen.

CSV-indeling #

CSV gebruikt dezelfde kolomindeling, gescheiden door komma’s. Regel 1 bevat de schemamarkering als commentaar:

# 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 met BOM en CRLF-regeleindes, zodat het bestand met dubbelklikken in Excel opengaat.

Lege cellen #

Een lege cel betekent “nog niet vertaald” en blijft bij het importeren ongemoeid; hij wist geen bestaande vertaling. Dit sluit aan bij XLIFF, gettext en de gangbare vertaalplatformen, zodat een half afgemaakt bestand teruggeven nooit de rijen wist waar een vertaler niet aan toe was. Het importvoorbeeld meldt hoeveel lege cellen zijn overgeslagen. Om een vertaling te verwijderen maak je haar leeg in het raster of haal je de taal uit de vervolgkeuzelijst Culturen. Zie Excel-roundtrip voor de volledige importstroom.