AltoQi Visus apresenta mensagem "Ocorreu uma situação não prevista na execução do QiVisus"

Ocorreu uma situação não prevista na execução do QiVisus

A seguir, apresentamos exemplos de mensagens que podem ser observadas: 

• "Valor não pode ser nulo"
• "Referência de objeto não definida para uma instância de um objeto"
• "Object reference not set to an instance of an object"
• "A conexão subjacente estava fechada: Uma conexão que deveria ser mantida ativa foi fechada pelo servidor"
• "Commom Language Runtime detectou um programa inválido"
• "A invocação do construtor no tipo 'QiVisus3D.MainViewModel' que corresponde às restrições de associação especificadas iniciou uma exceção"
• "A enumeração do valor local atual está desatualizada porque um ou mais valores locais foram definidos desde sua criação"
• "A solicitação HTTP está proibida com o esquema de autenticação de cliente 'Anonymous'."
• "Não foi possível carregar o arquivo  ou assembly 'EPPlusFree, Version 4.5.3.8, Culture=neutral, PublicKeyToken=85bfa0499e2db48a' ou uma de suas dependências. O sistema não pode encontrar o arquivo especificado"
• "CoreWebView2Controller member cannot be accessed after the WebView2 control is disposed"

1. Reiniciar o computador e abrir o software novamente

Em alguns casos, o erro pode estar relacionado a uma instabilidade momentânea do sistema ou da placa de vídeo. Ao reiniciar o computador, esses processos são reinicializados, o que pode normalizar o funcionamento.

Após a reinicialização, abra novamente o AltoQi Visus e verifique se o comportamento foi corrigido.

2. Reinstalar a última atualização do software

Recomenda-se realizar a reinstalação da versão mais recente do AltoQi Visus, disponível na Área do Cliente AltoQi. É importante verificar, durante o processo de instalação e na abertura do programa se existe algum aviso de antivirús.

Após a instalação, recomenda-se adicionar as seguintes pastas à lista de exceções do Windows Defender ou do antivírus utilizado:

• C:\Users\<seu.usuário>\AppData\Roaming\AltoQi

• C:\Program Files\AltoQi

• C:\Users\<seu.usuário>\Documents\QiVisus

• C:\ProgramData\AltoQi

Para realizar essa configuração, consulte os artigos:

• Configurando o Windows Defender para os programas AltoQi
• Como Liberar os Programas AltoQi no Firewall, Proxy e Antivírus?

3. Executar o software como Administrador

Executar o programa como administrador garante que o programa tenha permissões adequadas para acessar arquivos e bibliotecas do sistema, evitando falhas.

1. Clique com o botão direito no atalho do programa.

2. Selecione Propriedades.

3. Na aba Compatibilidade, marque a opção Executar este programa como administrador.

4. Verificar a pasta Dados do programa

O funcionamento do AltoQi Visus depende do acesso correto aos arquivos de dados do programa. Caso esses arquivos não estejam presentes ou estejam em local incorreto, podem ocorrer falhas na abertura ou utilização.

Dessa forma, é importante conferir se a pasta Dados está localizada no seguinte caminho:

• Meus Documentos/QiVisus/Dados, ou C:\ProgramData\AltoQi\QiVisus\Dados

5. Renomear a pasta Dados

Com o AltoQi Visus fechado, acesse o caminho Meus Documentos\QiVisus e renomeie a pasta Dados para um nome qualquer, como por exemplo: Dados01.

6. Renomear a pasta QiVisus em Appdata

Com o programa fechado, acesse a pasta AppData\Roaming do usuário e localize a pasta QiVisus. Em seguida, renomeie-a para um nome qualquer, como por exemplo: QiVisus01.

Requisitos do sistema

Procedimentos recomendados quando o software apresenta mensagem de erro ao abrir

Ao verificar que uma mensagem de erro foi apresentada ao abrir ou utilizar o AltoQi Visus, resultando em queda do mesmo, recomendamos a realização dos procedimentos a seguir. Essas verificações permitem que o próprio usuário identifique possíveis causas e restabeleça o funcionamento do software.

Mensagens relacionadas à conexão ou proxy

Caso a mensagem de erro apresentada contenha informações como: "A conexão subjacente estava fechada:...", ou qualquer outro aviso relacionado à conexão ou proxy, o comportamento pode estar associado à comunicação com o servidor.

Nesses casos, recomenda-se realizar um teste em outra máquina, se possível. Caso o comportamento também ocorra nesse novo ambiente, pode indicar uma indisponibilidade momentânea do servidor, sendo necessário aguardar e tentar novamente mais tarde.

Por outro lado, se o erro não se repetir em outra máquina, é provável que a situação esteja relacionada ao ambiente local do usuário, podendo envolver fatores como rede, antivírus, firewall ou configurações de proxy.

Mensagem "O acesso ao caminho foi negado" 

• Localize a pasta indicada na mensagem;
• Acesse as suas Propriedades (botão direito);
• Selecione a guia: Segurança;
• Selecione o seu usuário no painel: Nome de grupos ou de usuários;
• Clique em Editar, para editar as permissões;
• Habilite a opção Controle total;
• Finalize em Ok para confirmar a alteração. 

Mensagem "A invocação do construtor no tipo 'QiVisus3D.MainViewModel' que corresponde às restrições de associação especificadas iniciou uma exceção''

Mensagem "Referência de objeto não definida para uma instância de um objeto" ou "Object reference not set to an instance of an object"

Caso essa mensagem seja exibida após a alteração do idioma do programa para Inglês (EN), Francês (FR) ou Espanhol (ES), o comportamento está relacionado a uma inconsistência temporária, atualmente em processo de correção pela equipe de desenvolvimento do Visus Cost.

Para contornar a situação, é necessário retornar o programa para o idioma Português (Brasil). Para isso:

• Acesse o atalho Win+R;
• Execute o comando %appdata%;
• Acesse o caminho AltoQi > QiVisus;
• Exclua o arquivo QiVisus;
• Execute o programa novamente.