Cadastro

Como salvar meu cadastro personalizado na plataforma AltoQi Builder? (importar/exportar)

Em algumas situações como a utilização do programa em mais de uma máquina, reinstalação do AltoQi Builder, a troca de máquina ou a necessidade de manter uma cópia de segurança, é possível exportar o cadastro personalizado com peças e esquemas de lançamento criados pelo usuário. Essa exportação permite que o conteúdo seja importado posteriormente, sem a necessidade de refazer manualmente todas as edições.
Este artigo ensina o passo a passo de como realizar o backup (exportação) e a importação dos cadastros personalizados, incluindo peças e esquemas de lançamento e aborda perguntas frequentes dos usuários:

Criação do backup ou exportação do cadastro personalizado no AltoQi Builder

Para criar e exportar um arquivo de backup do cadastro personalizado por você, siga o procedimento descrito abaixo.

  • Abra o AltoQi Builder.
  • Acesse a guia Arquivo e clique em Cadastro.
  • Na janela "Cadastro" que será aberta, clique em Exportar..., disponível no canto inferior esquerdo da janela.

  • Na aba  Peça:
    • Selecione a peça ou o grupo de peças (passo 1) desejado.
    • Clique no botão Adicionar  > (passo 2) para mover os itens para o campo da direita da janela (passo 3), que lista os itens selecionados para a exportação.

Observação:  Se você possuir esquemas de lançamento personalizados, você pode exportá-los junto com as peças. 

Para isso, Acesse a aba Esquemas de lançamento e selecionar o esquema desejado e repita o processo para incluir esquemas personalizados.

  • Após selecionar todos os itens desejados (envolvendo peças e esquemas de lançamento), clique em OK.
  • Na janela Exportar Cadastro que se abre:
    • Escolha o diretório desejado para salvamento
    • Defina um nome para o arquivo de cadastro contendo os elementos a serem exportados.
  • Clique em  Salvar  na janela  Exportar Cadastro  para finalizar o procedimento e exportar o cadastro personalizado. 

O arquivo criado será salvo no formato .aq com todos os elementos exportados no diretório selecionado para salvamento do arquivo de cadastro exportado e com a nomenclatura definida pelo usuário.
 

Observação: Para salvar símbolos, margens e modelos de projeto personalizados por você, consulte o artigo: Como salvar meus símbolos, margens e modelos de projeto personalizados

Importação do cadastro personalizado para a plataforma AltoQi Builder 

Para importar o cadastro personalizado antes exportado por você, siga o procedimento descrito na sequência.

Importante: A opção "Importar" só estará habilitada se não houver nenhum projeto aberto no AltoQi Builder.

Isso ocorre pois, para realizar a importação do cadastro personalizado, é necessário que nenhum projeto esteja aberto no AltoQi Builder. Portanto, certifique-se de que somente o programa esteja aberto, sem arquivos carregados, para que a importação possa ser realizada.

  • Abra o AltoQi Builder sem nenhum projeto carregado. 
  • Acesse a guia Arquivo e clique em Cadastro.
  • Na janela "Cadastro" que será aberta, clique em Importar..., disponível no canto inferior esquerdo da janela.

  • Na janela Importar Cadastro aberta, localize o e selecione arquivo de extensão .aq salvo anteriormente, com o nome definido pelo usuário e diretório escolhido  foi salvo e clique em Abrir.
  • Ainda na janela Importar Cadastro, escolha uma das opções: 
    • Manter atual: mantém as peças já existentes.

    • Sobrescrever: substitui peças coincidentes e existentes do cadastro já existentes na instalação pelas importadas.

Observação: Quando houver duas peças com a mesma identificação, se selecionada a opção Manter atual, o programa manterá a peça já existente no cadastro de sua instalação. Se selecionada a opção Sobrescrever, o programa substituirá a peça existente no cadastro de sua instalação pela peça importada.

  • Clique em OK para importar o cadastro personalizado.
  • Neste momento o programa listará as peças que foram importadas do cadastro personalizado. Revise a lista de itens a serem importados e clique em Continuar... para finalizar.

Ao finalizar o carregamento do cadastro personalizado para o programa AltoQi Builder, será possível dar sequência ao desenvolvimento de seu projeto, por exemplo, com o lançamento dos respectivos elementos.

Perguntas frequentes

1. O que está incluído no arquivo de exportação?

Peças, grupos de peças e esquemas de lançamento personalizados.

2. Posso importar cadastros entre versões diferentes do Builder?

A importação de cadastros não é compatível com versões anteriores do AltoQi Builder. Ou seja, não é possível importar um backup criado em uma versão mais recente (como a 2025-08) em uma versão anterior (como a 2025-04).

Caso tente importar um cadastro de peças personalizado gerado a partir de versão superior em uma versão anterior, a mensagem "A pasta (...) não possui nenhum cadastro" será apresentada.

Portanto, deve-se realizar a importação da mesma versão ou de uma versão anterior para uma mais atual do que a do backup gerado.

3. O que acontece se eu importar uma peça já existente?

Você poderá escolher entre manter a peça atual ou sobrescrevê-la com a versão importada.

4. É possível exportar apenas esquemas personalizados?

Sim, basta acessá-los na aba Esquemas de lançamento durante a exportação.

5. A mensagem "A pasta (...) não possui nenhum cadastro" é indicada ao importar o cadastro mesmo com o arquivo na pasta selecionada. O que fazer?

Certifique-se de que o arquivo .aq está contido na pasta selecionada e verifique se o arquivo que deseja importar não foi gerado em uma versão superior à utilizada para importação. 

A importação do arquivo de cadastro sempre deve ser realizada a partir da mesma versão ou de uma versão anterior para uma mais atual do que a do backup gerado.