Documentação HorusBI
Buscar K

Aparência

Importar e exportar ​

Caminho: Cadastro > Ações > Importar

Além de digitar registro a registro, você pode importar dados de uma planilha Excel de uma vez — e exportar o conteúdo do Cadastro de volta para Excel quando precisar.

📥 Importar (XLSX) ​

A importação lê um arquivo XLSX e o traz para o Cadastro. Há dois modos:

  • Adicionar — acrescenta as linhas do arquivo aos registros existentes.
  • Substituir — troca o conteúdo: a importação supersede (substitui) a base anterior. É reversível — dá para desfazer (veja o rollback abaixo).

Durante a importação, cada linha passa por validações de estrutura (tipos compatíveis, campos obrigatórios preenchidos). O critério é tudo ou nada: se uma linha apresentar erro, o import inteiro é rejeitado e nada entra. Isso evita deixar o Cadastro num estado meio-importado.

A importação exige acesso irrestrito

Para importar é preciso ter acesso de importação irrestrito ao Cadastro — sem filtros nem colunas ocultas. Como a importação mexe na base inteira, ela só faz sentido para quem enxerga tudo.

NOTE

As validações em JavaScript (regras de negócio) não rodam na importação — só as checagens de estrutura. Garanta que a planilha já vem com o dado limpo. Veja Validações e expressões.

↩️ Rollback de importação ​

Toda importação fica registrada, e você pode desfazer uma importação específica — um rollback. Isso reverte o efeito daquela carga, devolvendo o Cadastro ao estado anterior.

É a rede de segurança para o modo Substituir: se a planilha nova veio errada, o rollback traz a base anterior de volta.

📤 Exportar ​

A qualquer momento você pode exportar o conteúdo do Cadastro para Excel — útil para conferir, fazer ajustes em massa fora da plataforma e reimportar, ou apenas compartilhar.

Permissão de exportar

Exportar usa a permissão de exportação genérica da plataforma (a mesma de outras telas), não um flag específico de Cadastro. Veja Permissões.

Limite de linhas pode bloquear a importação

Se uma importação ultrapassaria o limite de linhas do tenant, ela é bloqueada inteira — nenhuma linha entra. O limite é por tenant e sempre bloqueante. Veja Cobrança e limites.