Documentatie · Handleidingen

Excel-roundtrip

Geef één XLSX aan een vertaler en importeer het terug zonder context te verliezen.

Laatst bijgewerkt:

De Excel-roundtrip is de dragende workflow voor de meeste lokalisatieteams. Deze handleiding behandelt de export, wat vertalers te zien krijgen en de vangnetten bij het terugimporteren.

Export #

Met het model open: Bestand → Vertalingen exporteren…. Kies CSV of XLSX, selecteer de bestemming en sla op.

De export bevat:

  • Een schemaversiemarkering (cel A1 bij XLSX, een commentaarregel met # als voorvoegsel bij CSV)
  • Vier vaste informatiekolommen: Object ID, Type, Parent, Name
  • Twee kolommen per cultuur: Caption ({culture}) en Description ({culture})
  • Eén rij per vertaalbaar object (tabellen, kolommen, metingen, hiërarchieën, hiërarchieniveaus)

De modelkolommen volgen de WEERGAVE-schakelaar van het raster op het moment van exporteren: Bijschrift schrijft alleen bijschriftkolommen, Beschrijving alleen beschrijvingskolommen, Beide schrijft ze allebei. Heeft het bestand een rapportlaag, dan voegt de export een tweede blad Rapport toe (of een bijbehorende .report.csv) met de tekst van het rapportcanvas in een brede vorm, met één kolom per taal. Zie XLSX- en CSV-bestandsformaat voor het volledige schema.

UTF-8 met BOM, zodat Excel het bestand goed opent wanneer een vertaler er in Windows op dubbelklikt. CSV gebruikt om dezelfde reden CRLF-regeleindes.

Wat de vertaler ervaart #

Vertalers openen het bestand. Ze zien één vertrouwd Excel-raster. Ze vullen de lege cellen in de culturen waaraan ze werken, slaan op en sturen het terug. Ze hoeven Daxlate niet te installeren.

De eerste kolom (Object ID) is de identiteitssleutel bij het importeren. Vertalers moeten die als een externe sleutel behandelen en niet bewerken. Hetzelfde geldt voor Type, Parent en Name, die er staan om vertalers de context van elke rij te laten begrijpen.

Terugimporteren #

In de app: Bestand → Vertalingen importeren…, kies het bestand en bevestig. De app toont vóór het toepassen een overzicht van de import in een dialoogvenster:

  • Aantal rijen, met het aantal gewijzigde cellen
  • Nieuwe culturen die in het bestand zijn aangetroffen (die worden aan het model toegevoegd)
  • Waarschuwingen voor onbekende kolommen, onbekende Object ID’s en afwijkende schemaversies (een bestand van een nieuwere hoofdversie wordt zonder meer geweigerd)

Klik op Toepassen om vast te leggen. Het resultaat komt als één ongedaan te maken batch in de editor terecht, dus één keer ongedaan maken draait de hele import terug.

Wat lege cellen betekenen #

De import legt de inhoud van het bestand over het model heen:

  • Een gevulde cel stelt de vertaling voor die cultuur in.
  • Een lege cel betekent “nog niet vertaald” en blijft ongemoeid, zodat een half afgemaakt bestand nooit de vertalingen wist waar een vertaler nog niet aan toe was. De importbevestiging vertelt je hoeveel lege cellen zijn overgeslagen.

Om een vertaling te verwijderen maak je de cel in het raster leeg, of haal je de hele taal weg via de vervolgkeuzelijst Culturen.

Verwijst een kolom in het bestand naar een cultuur die nog niet in het model bestaat, dan voegt de import die cultuur toe en vult haar met de cellen uit het bestand.

Schemaversie #

Zowel CSV- als XLSX-exports dragen een versiemarkering (Daxlate/1.0, in cel A1 bij XLSX of als commentaar op de eerste CSV-regel). Bij het importeren worden bestanden van een nieuwere hoofdversie met een duidelijke fout geweigerd, zodat een verouderde build een incompatibel bestand niet half toepast. Bestanden zonder markering worden voor de compatibiliteit als 1.0 behandeld.