Como identificar problemas de ambiente ao tentar instalar BotCity Studio SDK
Tags: braziliandevs, botcity, automation, rpa
Published: 2024-03-12 17:14:57

Para utilizar qualquer tecnologia e/ou linguagem de programação, você deve preparar o ambiente para que seu código funcione adequadamente conforme você o desenvolve. E as orientações sobre como fazer isso, normalmente constam nas primeiras etapas da documentação dessa tecnologia.

No caso do desenvolvimento de automações RPA com as ferramentas da BotCity também funciona dessa maneira. As orientações estão na [documentação com os pré-requisitos](https://documentation.botcity.dev/getting-started/prerequisites/). Mas dependendo do computador que estamos utilizando, pode ser que tenhamos algumas dificuldades para instalar algo.

Isso pode acontecer por alguns motivos:

- algumas tecnologias podem ter pré-requisitos para funcionar;
- alguns computadores podem ter bloqueios para instalar algo, caso você não seja a pessoa administradora da máquina.

Essas questões ressaltam quando estamos lidando com computadores que são da empresa na qual trabalhamos que, por segurança, adiciona bloqueios nesses equipamentos.

Caso você esteja tentando preparar o ambiente para desenvolvimento de suas automações utilizando as ferramentas da BotCity e enfrente alguma dificuldade, é importante que você conheça também a [ferramenta Diagnostic](https://documentation.botcity.dev/getting-started/botcity-studio-sdk/#diagnostic-tool).

Essa ferramenta acompanha o mesmo pacote que você realiza o [download do Wizard para instalação do BotCity Studio SDK](https://documentation.botcity.dev/getting-started/botcity-studio-sdk/#download). Seu objetivo é validar se o ambiente atende os pré-requisitos para que você utilize esse SDK sem problemas e se é possível a instalação das ferramentas em seu computador, além de confirmar se será possível estabelecer uma conexão de sucesso com o BotCity Orquestrador.

## Como executar o diagnóstico

Ao fazer o dowload do BotCity Studio SDK, você terá uma pasta compactada chamada Wizard. Ao descompactá-la, um dos arquivos disponíveis será o `diagnostic.jar`.

⚠️ Para executar o Diagnostic no Linux ou no MacOS, é necessário ter o Java instalado. Se você for executar no ambiente Windows, pode executar sem essa preocupação.

A janela do Diagnostic se abrirá e você deverá adicionar o seu login da conta criada para utilizar o SDK e o Orquestrador. No campo "Email" preencha o seu e-mail cadastrado e no campo "Password" adicione a sua senha. Após isso clique no botão localizado do lado direito da janela, chamado “Run”.

![Print da tela do Diagnostic ao ser aberto](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/8e37cvcqao2o23jfwr3u.png)

Caso você não preencha e-mail e senha, o Diagnostic não fará os testes de login com o Orquestrador, deixando essa informação como resultado do teste: "E-mail ou senha não informados. Essa etapa foi pulada".

![Print do Diagnostic após execução sem o e-mail e sem a senha, com destaque na linha do teste "Orchestrator Login", com status "SKIP" e anotação "E-mail ou senha não informados. Essa etapa foi pulada" em inglês.](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/tbw1df9bvf4qzsyadnhc.png)

Após clicar em "Run", o Diagnostic começará os testes do ambiente. Se terminar com tudo funcionando corretamente, uma janela de confirmação aparecerá em cima informando que o diagnóstico finalizou e que o sistema está pronto para o desenvolvimento.

![Print do Diagnostic após execução, quando mostra uma nova janela de confirmação de que os testes terminaram e que o sistema está pronto para desenvolvimento.](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/y9riab307rudvtl4pag1.png)

## Status dos resultados do diagnóstico

Pode ser que você perceba três diferentes status após a execução. São eles:

- **PASS:** significa que o teste passou;
- **FAIL:** significa que o teste falhou e será necessário averiguar o problema;
- **SKIP:** significa que o teste anterior com o SSL (certificado) habilitado, funcionou, então o Diagnostic não precisou executar um novo teste com o SSL desabilitado.

Caso receba o resultado FAIL em algum teste de conexão, possivelmente há algum bloqueio no ambiente que você está utilizando. E, neste caso, é necessário solicitar ao time responsável da empresa onde você trabalha, as liberações descritas na [documentação de problemas com bloqueios de ambiente](https://documentation.botcity.dev/pt/getting-started/prerequisites/#problemas-com-bloqueios-do-ambiente).

## Como exportar o resultado dos testes

Se for necessário, você pode exportar o resultado dos testes em formato .csv. Para fazer isso, clique no botão "Export" localizado na parte debaixo da janela, do lado direito. Feito isso, uma nova janela se abrirá para você ter acesso ao arquivo.

![Print do Diagnostic com a janela em cima para acesso ao arquivo csv criado a partir dos testes executados.](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/rt6utiwbht1xk57245cz.png)

## Ficou alguma dúvida?

Você pode acessar o nosso [FAQ](https://documentation.botcity.dev/pt/faq/) para dúvidas frequentes, ou ainda entrar em contato com a comunidade global no [Slack](https://join.slack.com/t/communitybotcitydev/shared_invite/zt-1yvjzlce9-esRSoWfAIXPse4L21bzjAQ). Caso prefira, também temos o [fórum](https://community.botcity.dev/) disponível para dúvidas.