Saltar para o conteúdo
Elausys

HyperVisu / Integrações

Importação de projetos ETS

Importe um .knxproj para criar a visualização automaticamente: substituir ou unir, com um passo de revisão.

elausys · 22 julho 2026
Nesta página

Importação de um projeto ETS (.knxproj)

Pode importar um projeto ETS completo em qualquer altura, e não apenas no assistente de configuração; por exemplo, depois de o projeto ETS ter sido alargado com um novo piso.

O que é necessário: o ficheiro .knxproj exportado do ETS 5 ou 6 (e a respetiva palavra-passe, se o projeto estiver protegido) e uma cópia de segurança recente do servidor (veja «Backup & Restore»).

  1. Na página KNX, abra o separador Bridge e clique em Import KNX Project no cabeçalho. O botão só é apresentado neste separador e abre diretamente o seletor de ficheiros.

  2. Escolha o ficheiro .knxproj. Para um projeto protegido, introduza a Password do projeto ETS e clique em Unlock.

  3. Reveja o resumo da pré-visualização: Building, Floors / Rooms, Widgets to create, Group addresses, Skipped functions.

  4. Em What to import, assinale as secções pretendidas: Building structure, Group addresses, Functions (widgets). Desassinale uma secção para deixar essa parte da configuração exatamente como está: importar apenas os endereços de grupo atualiza a biblioteca sem perturbar divisões ou widgets.

  5. Opcionalmente, clique em Review & edit para corrigir a proposta antes de ser criado o que quer que seja: mudar o nome dos dispositivos, alterar tipos de widget, mover dispositivos entre divisões, excluir dispositivos por completo (veja o passo de revisão do assistente, «First-Run Setup Wizard», para o percurso completo deste painel). O botão é apresentado enquanto Functions (widgets) estiver assinalado.

  6. Se o servidor já tiver divisões e dispositivos, um aviso explica as duas alternativas. Escolha:

    • Merge (add new): acrescenta o que é novo e mantém as suas alterações locais. Não é eliminado nada: uma divisão ou um dispositivo removido do projeto ETS permanece no servidor. Uma divisão ou um dispositivo que tenha alterado no servidor desde a importação anterior fica intacto; um que não tenha alterado é atualizado a partir do projeto.
    • Replace all: reconstrói as secções assinaladas a partir do projeto. Com Functions (widgets) assinalado, elimina todos os dispositivos KNX, incluindo os criados manualmente, e volta a criá-los a partir do projeto. Com Building structure assinalado, os pisos e as divisões também são eliminados e criados de novo. Os dispositivos de outros protocolos são mantidos.

    Num servidor sem divisões nem dispositivos, um único botão Import substitui os dois.

  7. Leia a mensagem que aparece no fim da importação. Depois de unir as três secções, diz «Merged: X added, Y updated, Z kept (local edits)»; depois de uma importação parcial, lista as divisões, os widgets e os endereços de grupo processados. A mensagem é breve, por isso anote os números se precisar deles. A nova configuração é aplicada e a página recarrega-se sozinha: não há nada a aplicar depois.

⚠️ Warning: Replace all remove todos os dispositivos KNX e as respetivas associações nas secções assinaladas (incluindo alterações de nome, atribuições de divisão e dispositivos criados manualmente) e, com Building structure assinalado, todas as divisões que o projeto não contenha. Os favoritos que apontavam para uma divisão ou um dispositivo substituído são apagados. As cenas e as automatizações não são reconstruídas, por isso verifique as que utilizavam um dispositivo substituído. Em caso de dúvida, escolha Merge (add new).

📘 Note: Merge (add new) só reconhece o que uma importação de projeto anterior criou. Uma divisão ou um dispositivo criado manualmente não é associado, pelo que a importação acrescenta a versão do projeto ao lado.

📘 Note: Se o projeto ETS não declarar funções, o HyperVisu deduz os dispositivos a partir dos canais dos atuadores e dos endereços de grupo associados. A pré-visualização di-lo explicitamente: reveja os dispositivos deduzidos antes de importar.

Perguntas frequentes

Posso importar um projeto ETS depois da configuração inicial?

Sim. Abra a página KNX e, no separador Bridge, clique em Import KNX Project. Carregue um ficheiro .knxproj do ETS 5 ou 6 e indique a palavra-passe, se estiver protegido.

Posso importar apenas os endereços de grupo?

Sim. Em What to import, selecione Group addresses e deixe Building structure e Functions por assinalar.

Devo escolher Merge ou Replace all?

Merge acrescenta conteúdo novo preservando as alterações locais e não elimina nada. Replace all reconstrói as secções assinaladas: elimina aí todos os dispositivos KNX, incluindo os criados manualmente, e volta a criá-los a partir do projeto; os dispositivos de outros protocolos são mantidos.

E se o meu projeto ETS não tiver funções?

O HyperVisu deduz os dispositivos a partir dos canais dos atuadores e dos endereços de grupo associados. Reveja a proposta deduzida antes de importar.

Continuar a explorar

Encontre os outros guias deste produto na documentação.

Voltar a Integrações