Pular para o conteúdo principal

Importar / Exportar

O OpSee suporta importação e exportação em massa dos dados de equipamento via ficheiros Excel (.xlsx). Útil para configuração inicial, migração de outros sistemas, cópia de segurança e atualizações em massa.

Aceder a Importar / Exportar​

Na barra de ferramentas da grelha de Equipamento existem dois botões:

BotãoÍconeDescrição
ImportarCarregarAbre o diálogo de importação para carregar um ficheiro Excel
ExportarDescarregarAbre o diálogo de exportação para descarregar o equipamento em Excel

Botões Importar/Exportar na barra

Exportar equipamento​

Passos​

  1. Clique em Exportar na barra
  2. Configure as opções no diálogo:
    • Nome do ficheiro: um nome traduzido pré-preenchido; personalize se necessário
    • Incluir desativados: comutador para incluir equipamento inativo (desligado por omissão)
  3. Clique em Exportar

É descarregado um Excel com todo o equipamento que satisfaz as opções escolhidas.

Diálogo de exportação

Colunas exportadas​

O Excel contém as seguintes colunas:

ColunaDescrição
IDID do equipamento (apenas leitura, usado para atualizações)
NomeNome do equipamento
DescriçãoDescrição do equipamento
ID paiID do equipamento pai
ID tipoID do tipo de equipamento
Nome do tipoNome do tipo (apenas leitura, referência)
ÍconeIdentificador do ícone (p. ex. mdi:cog)
CorCódigo hex de cor (p. ex. #1976d2)
AtivadoEstado ativo (true/false)
dica

Exporte o equipamento atual antes de alterações em massa. Garante uma cópia de segurança a que pode regressar.

Importar equipamento​

Passos​

  1. Clique em Importar na barra
  2. Carregue um ficheiro Excel (.xlsx) no diálogo
  3. O OpSee valida o ficheiro e mostra uma pré-visualização
  4. Reveja a pré-visualização e confirme a importação
  5. Os itens de equipamento são criados ou atualizados conforme os dados

Formato do ficheiro​

O ficheiro de importação deve seguir a mesma estrutura de colunas da exportação. A forma mais simples é exportar primeiro, alterar o ficheiro e voltar a importar.

Comportamento da importação​

CenárioComportamento
Linha sem IDÉ criado um novo equipamento
Linha com ID existenteO equipamento existente é atualizado
Linha com ID desconhecidoÉ reportado erro nessa linha
Campo obrigatório (Nome) vazioÉ reportado erro nessa linha

Validação​

Antes de processar, o OpSee valida:

  • Campos obrigatórios: o Nome tem de existir
  • Referências de pai: os IDs pai devem referir equipamento existente
  • Referências de tipo: os IDs tipo devem referir tipos existentes
  • Deteção de duplicados: avisa se a importação criaria duplicados
informação

As operações de importação são registadas no Trilho de auditoria. Cada equipamento criado ou atualizado gera uma entrada com utilizador, carimbo temporal e valores antigos/novos.

Modelo​

Se começa do zero sem equipamento para exportar, pode criar um Excel em branco com os cabeçalhos corretos:

IDNomeDescriçãoID paiID tipoNome do tipoÍconeCorAtivado
Linha de enchimento 1Linha principal15Unidademdi:cog#1976d2true
Misturadora AMisturadora primária15Unidademdi:mixer#2e7d32true
dica

Deixe a coluna ID vazia para equipamento novo. O OpSee atribuirá os IDs automaticamente. A coluna Nome do tipo é ignorada na importação: só ID tipo é usado.

Limpar duplicados​

Se uma importação cria duplicados (mesmo nome, pai e tipo), use o botão Limpar duplicados na barra. Esta ferramenta:

  1. Agrupa o equipamento por nome, ID pai e ID tipo
  2. Identifica grupos com mais do que uma entrada
  3. Mantém o mais antigo (ID mais baixo) e elimina definitivamente os restantes
  4. Reporta quantos duplicados foram removidos
aviso

Limpar duplicados executa uma eliminação física. Não é reversível. Exporte sempre primeiro o equipamento como cópia de segurança antes de executar.

Boas práticas​

  1. Exporte antes de importar: crie sempre uma cópia de segurança antes de uma importação em massa.
  2. Use a exportação como modelo: exporte o equipamento existente para obter a estrutura correta e depois acrescente novas linhas.
  3. Lotes pequenos: em fábricas grandes, importe por lotes (p. ex. por área) para facilitar revisão e diagnóstico.
  4. Verifique IDs pai: garanta que o equipamento pai existe antes de importar os filhos. Importe primeiro os itens de raiz, depois os filhos.
  5. Limpe após a importação: execute Limpar duplicados após importações em massa para apanhar duplicados acidentais.

Pré-requisitos​

Próximos passos​

Relacionado​