Formato de archivo XLSX y CSV

Última actualización: 26 de julio de 2026

Daxlate exporta las traducciones como XLSX (con ClosedXML) o como CSV (con CsvHelper). Un archivo con capa de informe exporta dos hojas, Modelo e Informe (o el par .model.csv y .report.csv); un archivo solo de modelo exporta únicamente la capa de modelo. Esta página documenta primero la hoja del modelo en detalle, y después la hoja del informe.

Diseño de la hoja del modelo #

La hoja de cálculo del modelo se llama Model (las exportaciones de una sola capa de compilaciones antiguas la llamaban Translations). Sus filas:

Fila	Contenido
1	Marcador de versión de esquema en la celda A1 (Daxlate/1.0, en cursiva y gris)
2	Fila de encabezado, en negrita, con fondo beige
3+	Una fila por objeto traducible

La fila de encabezado se inmoviliza para que los títulos de columna sigan visibles mientras el traductor se desplaza. Las cuatro primeras columnas también se inmovilizan, para que las columnas de identidad sigan visibles al desplazarse a la derecha por las columnas de cultura.

Columnas #

Primero van cuatro columnas informativas fijas:

Columna	Notas
Object ID	Clave de identidad al importar. No editar.
Type	Uno de Table, Column, Measure, Hierarchy, Level.
Parent	Nombre del objeto contenedor (por ejemplo, la tabla donde vive una medida).
Name	El nombre del objeto en el modelo (el título de la cultura predeterminada).

Después, por cada cultura del modelo, dos columnas:

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

Las columnas de la cultura predeterminada del modelo llevan un fondo sombreado para que quede claro cuál es la fuente de verdad.

Cuáles de las dos columnas se escriben depende del conmutador VISTA de la cuadrícula en el momento de exportar: Título escribe solo columnas de título, Descripción solo columnas de descripción, Ambos escribe las dos. Cada objeto sigue teniendo una fila en todos los modos, incluidos los que todavía no tienen descripción.

Convención de Object ID #

Daxlate compone los ID a partir del tipo de objeto y su nombre completo:

Tipo	Forma	Ejemplo
Tabla	t.{Name}	t.Sales
Columna	c.{Table}.{Name}	c.Sales.Revenue
Medida	m.{Table}.{Name}	m.Sales.Total Revenue
Jerarquía	h.{Table}.{Name}	h.Date.Calendar
Nivel de jerarquía	{HierarchyId}.l{Ordinal}	h.Date.Calendar.l1

Renombrar un objeto en el modelo cambia su ID. Al reimportar, las filas con un Object ID desconocido aparecen como avisos en el diálogo de vista previa y se omiten; la importación no las descarta en silencio.

Versión de esquema #

La celda A1 del XLSX (o la primera línea de comentario del CSV) lleva la versión de esquema. El lector rechaza los archivos de una versión mayor más nueva con un aviso claro y trata los marcadores ausentes como 1.0, por compatibilidad con las exportaciones anteriores al versionado.

El marcador actual es Daxlate/1.0. Los incrementos son menores para columnas añadidas (las columnas nuevas se ignoran con un aviso) y mayores para cambios que rompen la compatibilidad (por ejemplo, otra convención de Object ID).

Hoja del informe #

En un archivo con capa de informe, una segunda hoja llamada Report lleva el texto del lienzo del informe (títulos de objetos visuales, encabezados, botones, cuadros de texto). Usa una forma ancha y cómoda para el traductor: una fila por elemento de texto con una única columna Value ({culture}) por idioma, en lugar del par título/descripción de la hoja del modelo, de modo que el traductor rellena todos los idiomas de una cadena en una sola línea. La importación detecta por el contenido si un archivo es una hoja de modelo, una hoja de informe o un libro de dos hojas, y aplica la capa que corresponde.

En disco, las traducciones del informe viven junto al archivo como acompañante por archivo, con el nombre {archivo}.daxlate.csv, el CSV funcional que Power BI lee al actualizar. Las traducciones del modelo viven dentro del .pbit; consigue una copia desde Exportar. Consulta Traducir los objetos visuales del informe.

Diseño del CSV #

El CSV usa el mismo diseño de columnas, separadas por comas. La línea 1 lleva el marcador de esquema como comentario:

# 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 con BOM y saltos de línea CRLF, para que se pueda abrir con doble clic en Excel.

Celdas vacías #

Una celda en blanco significa “aún sin traducir” y se deja intacta al importar; no borra una traducción existente. Esto coincide con XLIFF, gettext y las plataformas de traducción más extendidas, así que devolver un archivo a medio terminar nunca borra las filas a las que un traductor no ha llegado. La vista previa de importación informa de cuántos blancos se saltaron. Para eliminar una traducción, vacíala en la cuadrícula o quita el idioma del desplegable Culturas. Consulta Ida y vuelta con Excel para el flujo completo de reimportación.