Formato de arquivo XLSX e CSV

Última atualização: 26 de julho de 2026

O Daxlate exporta traduções como XLSX (via ClosedXML) ou como CSV (via CsvHelper). Um arquivo com camada de relatório exporta duas planilhas, Modelo e Relatório (ou o par .model.csv e .report.csv); um arquivo só de modelo exporta apenas a camada do modelo. Esta página documenta primeiro a planilha do modelo em detalhe, depois a planilha do relatório.

Layout da planilha do modelo #

A planilha do modelo se chama Model (exportações de camada única de versões antigas a chamavam de Translations). Suas linhas:

Linha	Conteúdo
1	Marcador de versão de esquema na célula A1 (Daxlate/1.0, em itálico, cinza)
2	Linha de cabeçalho, em negrito, com fundo bege
3+	Uma linha por objeto traduzível

A linha de cabeçalho fica congelada para que os títulos das colunas continuem visíveis enquanto o tradutor rola a planilha. As quatro primeiras colunas também ficam congeladas, para que as colunas de identidade continuem visíveis ao rolar para a direita pelas colunas de cultura.

Colunas #

Primeiro vêm quatro colunas informativas fixas:

Coluna	Observações
Object ID	Chave de identidade na importação. Não editar.
Type	Um entre Table, Column, Measure, Hierarchy, Level.
Parent	Nome do objeto que contém (por exemplo, a tabela onde vive uma medida).
Name	O nome do objeto no modelo (a legenda da cultura padrão).

Depois, para cada cultura do modelo, duas colunas:

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

As colunas da cultura padrão do modelo recebem um fundo sombreado, para deixar claro qual coluna é a referência.

Quais das duas colunas são gravadas segue a chave EXIBIÇÃO da grade no momento da exportação: Legenda grava só colunas de legenda, Descrição só colunas de descrição, Ambas grava as duas. Todo objeto continua ganhando uma linha em qualquer modo, inclusive os que ainda não têm descrição.

Convenção de Object ID #

O Daxlate monta os IDs a partir do tipo do objeto e do nome qualificado dele:

Tipo	Forma	Exemplo
Tabela	t.{Name}	t.Sales
Coluna	c.{Table}.{Name}	c.Sales.Revenue
Medida	m.{Table}.{Name}	m.Sales.Total Revenue
Hierarquia	h.{Table}.{Name}	h.Date.Calendar
Nível de hierarquia	{HierarchyId}.l{Ordinal}	h.Date.Calendar.l1

Renomear um objeto no modelo muda o ID dele. Na reimportação, linhas com um Object ID desconhecido aparecem como avisos na caixa de prévia e são puladas; a importação não as descarta em silêncio.

Versão de esquema #

A célula A1 do XLSX (ou a primeira linha de comentário do CSV) carrega a versão do esquema. O leitor recusa arquivos de uma versão maior mais nova com um aviso claro e trata marcadores ausentes como 1.0, por compatibilidade com exportações feitas antes do versionamento.

O marcador atual é Daxlate/1.0. Os incrementos são menores para colunas adicionais (colunas novas são ignoradas com um aviso) e maiores para mudanças que quebram compatibilidade (por exemplo, outra convenção de Object ID).

Planilha do relatório #

Em um arquivo com camada de relatório, uma segunda planilha chamada Report carrega o texto da tela do relatório (títulos de visuais, cabeçalhos, botões, caixas de texto). Ela usa um formato largo e amigável ao tradutor: uma linha por elemento de texto com uma única coluna Value ({culture}) por idioma, em vez do par legenda/descrição da planilha do modelo, de modo que o tradutor preenche todos os idiomas de um texto em uma linha só. A importação detecta pelo conteúdo se o arquivo é uma planilha de modelo, uma planilha de relatório ou uma pasta de trabalho com duas planilhas, e aplica a camada correspondente.

Em disco, as traduções do relatório ficam ao lado do arquivo como acompanhante por arquivo, com o nome {arquivo}.daxlate.csv, o CSV funcional que o Power BI lê na atualização. As traduções do modelo ficam dentro do .pbit; para obter uma cópia, use Exportar. Veja Traduzir os visuais do relatório.

Layout do CSV #

O CSV usa o mesmo layout de colunas, separadas por vírgula. A linha 1 traz o marcador de esquema como comentário:

# 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 com BOM e quebras de linha CRLF, para abrir com duplo clique no Excel.

Células vazias #

Uma célula em branco significa “ainda não traduzido” e fica intocada na importação; ela não apaga uma tradução existente. Isso segue XLIFF, gettext e as plataformas de tradução mais comuns, então devolver um arquivo pela metade nunca apaga as linhas que um tradutor não alcançou. A prévia da importação informa quantos brancos foram pulados. Para remover uma tradução, limpe-a na grade ou tire o idioma do menu suspenso Culturas. Veja Ida e volta com Excel para o fluxo completo de reimportação.