Documentação · Guias práticos

Fluxo de ida e volta com Excel

Entregue um único XLSX a um tradutor e importe de volta sem perder contexto.

Última atualização:

A ida e volta com Excel é o fluxo que sustenta a maioria das equipes de localização. Este guia cobre a exportação, o que os tradutores veem e as redes de proteção na reimportação.

Exportação #

Com o modelo aberto, Arquivo → Exportar traduções…. Escolha CSV ou XLSX, selecione o destino e salve.

A exportação contém:

  • Um marcador de versão de esquema (célula A1 no XLSX, uma linha de comentário com prefixo # no CSV)
  • Quatro colunas informativas fixas: Object ID, Type, Parent, Name
  • Duas colunas por cultura: Caption ({culture}) e Description ({culture})
  • Uma linha por objeto traduzível (tabelas, colunas, medidas, hierarquias, níveis de hierarquia)

As colunas do modelo seguem a chave EXIBIÇÃO da grade no momento da exportação: Legenda grava só as colunas de legenda, Descrição só as de descrição, Ambas grava as duas. Se o arquivo tem camada de relatório, a exportação acrescenta uma segunda planilha Relatório (ou um .report.csv correspondente) com o texto da tela do relatório em um formato largo, com uma coluna por idioma. Veja Formato de arquivo XLSX e CSV para o esquema completo.

UTF-8 com BOM, para que o Excel abra o arquivo corretamente quando um tradutor der um duplo clique no Windows. O CSV usa quebras de linha CRLF pelo mesmo motivo.

A experiência do tradutor #

Os tradutores abrem o arquivo. Veem uma grade familiar do Excel. Preenchem as células vazias das culturas em que estão trabalhando, salvam e devolvem. Não precisam instalar o Daxlate.

A primeira coluna (Object ID) é a chave de identidade na importação. Os tradutores devem tratá-la como chave estrangeira e não editá-la. O mesmo vale para Type, Parent e Name, que estão ali para ajudar a entender o contexto de cada linha.

Reimportação #

No aplicativo, Arquivo → Importar traduções…, escolha o arquivo e confirme. O aplicativo mostra uma prévia da importação em uma caixa de diálogo antes de aplicar:

  • Contagem de linhas, com o número de células alteradas
  • Culturas novas detectadas no arquivo (elas serão adicionadas ao modelo)
  • Avisos de colunas desconhecidas, Object ID desconhecidos e divergências de versão de esquema (um arquivo de uma versão maior mais nova é recusado de imediato)

Clique em Aplicar para confirmar. O resultado chega ao editor como um único lote reversível, então um desfazer reverte a importação inteira.

O que significam as células vazias #

A importação sobrepõe o conteúdo do arquivo ao modelo:

  • Uma célula preenchida define a tradução daquela cultura.
  • Uma célula em branco significa “ainda não traduzido” e fica intocada, então um arquivo pela metade nunca apaga as traduções que um tradutor ainda não alcançou. A confirmação da importação informa quantos brancos foram pulados.

Para remover uma tradução, limpe a célula na grade ou tire o idioma inteiro pelo menu suspenso Culturas.

Se uma coluna do arquivo aponta para uma cultura que ainda não existe no modelo, a importação adiciona a cultura e a preenche com as células do arquivo.

Versão de esquema #

Tanto a exportação CSV quanto a XLSX levam um marcador de versão (Daxlate/1.0, na célula A1 do XLSX ou como comentário na primeira linha do CSV). Na importação, arquivos de uma versão maior mais nova são recusados com um erro claro para que uma versão antiga não aplique pela metade um arquivo incompatível. Arquivos sem marcador são tratados como 1.0 por compatibilidade.