Skip to content

Configurando o Ambiente

Após criar a sua conta, o primeiro passo é baixar o BotCity Studio.

Download SDK

Após baixar o arquivo do SDK, basta extraí-lo em uma pasta de sua preferência.

Este SDK contém todas as ferramentas necessárias para construir, gerenciar e executar as suas automações.

Explorando o conteúdo do SDK

Depois de extrair o arquivo baixado, a estrutura da pasta será semelhante a essa aqui:

.
├── BotCLI.bat
├── BotRunner-gui.bat
├── BotRunner.bat
├── BotStudio-2.16.2.exe
├── bin
├── conf
│   ├── conf.bcf
│   └── properties.json
├── lib
│   └── tesseract
├── run
├── venvs
└── win32
    └── java

.
├── BotCLI.sh
├── BotRunner-gui.sh
├── BotRunner.sh
├── BotStudio.sh
├── bin
├── conf
│   ├── conf.bcf
│   └── properties.json
├── lib
│   └── tesseract
├── run
└── venvs

Na pasta raiz do SDK, você irá encontrar os seguintes arquivos:

  • BotCLI.bat/BotCLI.sh: Atalho para utilizar o BotCity CLI (ferramenta de interface de linha de comando).
  • BotRunner-gui.bat/BotRunner-gui.sh: Atalho para iniciar o BotCity Runner no modo gráfico.
  • BotRunner.bat/BotRunner.sh: Atalho para iniciar o BotCity Runner no modo headless (background).
  • BotStudio-X.Y.Z.exe/BotStudio.sh: Atalho para iniciar o BotCity Studio.
  • bin: Pasta contendo os arquivos binários .jar referentes ao SDK.
  • conf: Pasta contendo os arquivos de configuração.
    • conf.bcf: Arquivo de configuração do BotCity Studio.
    • properties.json: Arquivo de propriedades do BotCity Studio (Use o menu de 'Preferências' para editar os valores ao invés de alterar diretamente este arquivo).
  • lib: Bibliotecas de suporte para o BotCity Studio.
  • run: Pasta utilizada pelo BotCity Runner durante a execução.
  • venvs: Pasta utilizada pelo BotCity Runner para gerenciar os ambientes virtuais das automações Python.

Configuração

A configuração do BotCity Studio SDK é feita através do arquivo conf.bcf localizado na pasta conf.

O conteúdo do arquivo conf.bcf será semelhante a este aqui:

server=https://developers.botcity.dev
workspace=
key=
login=
machineId=<Your Machine ID Here>
logScreen=true
logApplication=false
  • server: URL do servidor do BotCity Maestro.
  • workspace: Seu workspace no BotCity Maestro.
  • key: Chave da API do BotCity Maestro, localizada na página Amb. de Desenvolvedor.
  • login: Usuário da API do BotCity Maestro, localizado na página Amb. de Desenvolvedor.
  • machineId: ID referente ao Runner atual usado para execução, veja a página Runners.
  • logScreen: Parâmetro para definir se as screenshots da máquina vão ser enviadas periodicamente para o BotCity Maestro (True ou False).
  • logApplication: Parâmetro para definir se os logs da máquina vão ser enviados periodicamente para o BotCity Maestro (True ou False).

Para configurar corretamente o seu SDK do BotCity Studio, você só irá precisar preencher as informações do arquivo conf.bcf com as informações referentes a sua conta do BotCity Maestro.

Aqui está um exemplo do arquivo conf.bcf preenchido com as informções de uma conta fictícia do BotCity Maestro.

server=https://developers.botcity.dev
workspace=7f93fd4e-d470-40b7-8912-dabf99e7bc74
key=BOT_1A235ASFGA6F6AHJ501H459
login=7f93fd4e-d470-40b7-8912-dabf99e7bc74
machineId=vm-01
logScreen=true
logApplication=false