3. Solucionando Problemas da Ema.IA
Este artigo reúne os principais problemas que podem ocorrer com a Ema.IA e as etapas que podem solucioná-los. Os erros que aparecem aqui são principalmente aqueles que são externos e não podem ser corrigidos com uma atualização do aplicativo. O artigo é um trabalho em progresso e ainda não está tão completo quanto pode se tornar, portando sua sugestão será bem-vinda.
Diversos clientes utilizam as soluções da Ema através de RemoteApp (WTS/RDP). Infelizmente, a experiência de uso da Ema.IA por meio deste método é negativamente impactada pelas limitações inerentes à tecnologia, o que foge do nosso alcance. Recomendamos a utilização de outros métodos de acesso para usuários que desejam usar a Ema.IA.
A Ema.IA não está abrindo
O que pode estar acontecendo:
- Falhas na comunicação com o ERP ou outro produto Ema
- Falha na comunicação com o servidor da Ema.IA (Cloud)
- Falha no processo de autenticação do usuário
Possíveis soluções:
- Verifique se o servidor da Ema.IA está acessível na rede
Você pode efetuar a verificação abrindo o link https://ema.ia.br/api/v1/ no navegador, se tudo estiver correto, irá aparecer o conteúdo abaixo:
{"status":"Running"}
Caso prefira, é possível verificar também executando o comando abaixo no PowerShell:
(Invoke-WebRequest https://ema.ia.br/api/v1/).StatusDescription
Se a resposta que aparecer embaixo for diferente de OK, existe algo impedindo a conexão com o servidor.
Se a verificação executada falhar, recomendamos tentar acessar o link (https://ema.ia.br/api/v1/) a partir de um dispositivo conectado a uma rede diferente (como por exemplo os Dados Móveis do celular). Isso irá ajudar a determinar se o problema está sendo causado por uma instabilidade no servidor da Ema.IA ou se há algum bloqueio na rede (Firewall) impedindo o acesso, neste caso será necessário solicitar o desbloqueio do domínio ema.ia.br ao responsável pelo gerenciamento da rede.
- Encerre a Ema.IA e limpe os dados do app
Copie o comando abaixo, abra a janela Executar do Windows (Win + R), cole o conteúdo no campo com Ctrl + V, e pressione Enter. O comando irá encerrar os processos da Ema.IA e limpar os dados do app.
cmd /c taskkill /f /im "Ema IA.exe" & rmdir /s /q "%appdata%\Ema IA"
Agora feche o programa que você utilizou para abrir a Ema.IA (Ema ERP, Ema DOX, etc...), em seguida abra novamente e tente abrir a Ema.IA. Isso deve resolver a maior parte dos casos onde não é possível abrir o app. Caso não resolva, será necessário acionar o suporte técnico.
O botão de microfone não está funcionando
Isso costuma ocorrer principalmente quando a Ema.IA está sendo utilizada em uma máquina remota, através de Remote Desktop (RDP/WTS). Neste caso, de acordo com a figura ao lado, clique em "Mais opções" na janela da ferramenta de conexão remota, navegue até a aba "Recursos locais" e clique no botão "Configurações" na seção "Áudio remoto".
Certifique-se de que as duas opções no topo de cada seção estão selecionadas, como indicado pelas setas na captura de tela abaixo:
Após isso, clique em OK, conecte-se novamente à máquina remota, e verifique se o microfone na Ema.IA passou a funcionar.
Alguns softwares de proteção contra ameaças digitais, como o Kaspersky Endpoint Security, costumam bloquear o acesso ao microfone por aplicações desconhecidas, incluindo a Ema.IA. Neste caso se torna necessário solicitar ao administrador do sistema de segurança o desbloqueio da funcionalidade. O processo varia de acordo com a ferramenta, portando verifique a documentação da ferramenta utilizada.
A janela da Ema.IA fica sumindo
Isso costuma ocorrer quando a Ema.IA é acessada através de RemoteApp. Infelizmente, não é possível mitigar este problema devido às limitações da tecnologia, como informado acima.
Erros causados pela ausência do Microsoft Visual C++ Redistributable
A partir da versão 21.11 das soluções Ema desktop, o Microsoft Visual C++ Redistributable passa a ser verificado e instalado automaticamente quando necessário, e esta seção deixa de ser aplicável. Em versões anteriores, o componente precisa ser instalado manualmente no servidor e nas máquinas que rodam o sistema localmente.
O launcher da Ema.IA (emaia-launcher.exe) e o Runtime Local dependem do Microsoft Visual C++ Redistributable (x64) para executar. Quando ele não está presente no servidor — ou está presente em uma versão antiga, anterior à linha 14 ("evergreen") — os processos falham logo na inicialização, antes de conseguirem registrar qualquer mensagem de erro útil. Por isso os sintomas costumam ser confusos e não apontam diretamente para a causa.
Sintomas típicos:
- Aparece mensagem de erro referente ao
VCRUNTIME140.dllcomo no popup acima - A Ema.IA não abre e nenhuma mensagem clara é exibida ao usuário.
- O launcher encerra com um código de saída negativo ou aparentemente aleatório (por exemplo
-1073741515), sem gerar log. - O Runtime Local funciona quando executado manualmente pela linha de comando, mas não inicia como serviço do Windows. Este caso costuma indicar que existe uma versão antiga do redistributable instalada na máquina.
- Verifique se o redistributable está instalado
Execute o comando abaixo no PowerShell:
Get-ItemProperty "HKLM:\SOFTWARE\Microsoft\VisualStudio\14.0\VC\Runtimes\x64" -ErrorAction SilentlyContinue | Select-Object Installed, Version
Se o comando não retornar nada, ou se Installed for diferente de 1, o runtime não está instalado e precisa ser instalado manualmente.
- Instale sempre a versão mais recente
Mesmo que o comando acima indique que já existe uma versão instalada, a recomendação diante de qualquer um dos erros acima é instalar a versão mais recente, que atualiza o runtime existente sem necessidade de desinstalação prévia.
- Download direto (x64): https://aka.ms/vc14/vc_redist.x64.exe
- Página oficial da Microsoft, com todas as arquiteturas: Downloads mais recentes do Visual C++ Redistributable
A instalação exige privilégios de administrador. Após a instalação, reinicie o serviço EmaIALocalRuntime para que o novo runtime seja carregado, e tente abrir a Ema.IA novamente. Na maioria dos casos não é necessário reiniciar a máquina, mas caso os erros persistam pode se tornar uma etapa necessária.
Não encontrou o problema que está acontecendo com você?
Neste caso, entre em contato com o suporte da Ema.IA para encontrar uma solução. Se for possível corrigiremos o problema com uma atualização do aplicativo, caso contrário, principalmente em situações que dependem de ferramentas externas, atualizaremos este artigo com as possíveis soluções.