Automação Python

Conheça as novidades nas ferramentas Python RPA da BotCity

Olá, mundo! 👋

Temos novidades para compartilhar com vocês sobre as nossas ferramentas Python RPA. Acompanhem neste artigo.

[0] Novo wizard de instalação para o BotCity Studio SDK:

Agora temos uma nova forma, muito mais simples, para instalação do BotCity Studio SDK. Acompanhe o passo a passo a seguir. Mas antes, não deixe de verificar os pré-requisitos nesta página da nossa documentação.

Faça o login no BotCity Maestro, conforme usuário e senha que você já possui. Ao entrar no sistema, você terá acesso a tela do print a seguir.

Print da tela de entrada na BotCity mostrando as opções BotCity Studio, Documentação, BotCity Academy e BotCity Maestro.

Nessa tela, há quatro opções para se clicar. Neste caso, você deverá clicar em “Download” na opção de “BotCity Studio”.

Ao clicar, uma nova tela indicará que você pode baixar a ferramenta para os seguintes sistemas operacionais: Windows, MacOS e Linux. Escolha o que faz sentido para você.

Após a conclusão do download, extraia o arquivo baixado. Entre na pasta que você extraiu e identifique o aplicativo com o nome “wizard-x.y.z”. Neste caso, x, y e z correspondem ao número da versão disponibilizada. Por exemplo, pode ser “wizard-1.1.0”.

Execute o aplicativo para que a instalação via novo wizard se inicie. Escolha o local onde você deseja instalar o BotCity Studio. E, em seguida, clique em “next”.

Print da tela inicial da instalação do BotCity Studio SDK. Contém um campo perguntando onde a pessoa deseja realizar a instalação e um botão "browser" para que seja escolhido este local. No canto direito inferior tem o botão "next".

Após isso, coloque as informações solicitadas no campo “server”. Se for a versão community, você pode utilizar o link “https://developers.botcity.dev/”. Caso você já tenha a conta da sua empresa, então certifique-se de que você tenha o endereço correto para colocar nesse campo.

Em e-mail e password, basta você adicionar seu e-mail que tem a conta com a BotCity e a senha correspondente. Finalizada essa etapa, clique em “Next”.

Print da tela da instalação do BotCity Studio SDK. Contém o campo para colocar o server, o campo para colocar o e-mail e o campo para colocar a senha. No canto direito inferior tem o botão "back" para voltar e o botão "next" para prosseguir para a próxima etapa.

Opcionalmente, você pode configurar um runner para executar suas automações. Você pode escolher um que já exista ou criar um novo. Enquanto isso, uma barra horizontal começará a carregar na parte inferior da tela de instalação. Mas não se preocupe, pode clicar em “next”.

Print da tela da instalação do BotCity Studio SDK. Contém o campo para escolher um runner já existente, um checkbox para informar se deseja criar um novo e um campo para digitar o nome do novo runner se for o caso. No canto direito inferior tem o botão "next" para prosseguir para a próxima etapa.

Aguarde a instalação ser finalizada. Assim que terminar, a tela a ser exibida aparecerá com algumas opções para você. 

Print da tela da instalação do BotCity Studio SDK. Contém o texto informando que a pessoa já pode utilizar, um botão verde em destaque para trocar a versão da instalação, caso a pessoa deseje uma versão mais antiga ou instalar a mais nova. No centro, tem os botões "setup botcity runner", "launch botcity studio", "launch botcity runner", "launch botcity runner - gui" e "open sdk folder", todos explicados no decorrer do texto do post. No canto direito inferior tem o botão "close" para fechar a janela.

Dentre essas opções, seguem as ações que você pode executar a partir desta tela:

  • Change version: Altere a versão para uma versão mais recente ou anterior, bem como para uma versão de desenvolvimento;
  • Setup BotCity Runner: Configurar um BotCity Runner;
  • Launch BotCity Studio: Inicie o BotCity Studio;
  • Launch BotCity Runner: Inicie o BotCity Runner como um processo em segundo plano;
  • Launch BotCity Runner – GUI: Inicie o BotCity Runner como um aplicativo visual;
  • Open SDK Folder: Abra a pasta na qual o SDK foi instalado.

Para mais informações sobre esse processo e dicas importantes para realizá-lo, verifique nossa documentação.

[1] Agendamento de automações:

Agora você consegue adicionar parâmetros para o agendamento da automação que precisar dessas informações, além de ter um controle para deixar o agendamento como ativo ou inativo. Não é mais necessário deletar e criar novamente quando você precisar utilizar esse mesmo agendamento.

Após entrar no BotCity Maestro, verifique no menu da lateral esquerda a opção “agendamentos”. Ao clicar nela, você terá a possibilidade de criar um novo agendamento ou editar os que você já possui.

Na tela seguinte, você poderá escolher as configurações desse agendamento criado ou editado. Acompanhe a seguir.

Print da tela de agendamentos do BotCity Maestro mostrando o menu lateral esquerdo citado na explicação. e no restante da tela, os campos: ativo, nome da automação, campo para adicionar a CRON, campo que explica o significado da CRON utilizada, campo para digitar a prioridade e os campos para parâmetros da automação. No canto direito inferior tem os botões "agendar" e "cancelar".

No print acima, mostramos as informações que podem ser ajustadas. A primeira opção será onde o agendamento ficará como ativo ou não.

Em seguida, há o campo com o nome da automação que você escolheu criar ou editar o agendamento. No campo abaixo, você pode colocar a CRON que corresponde a frequência com a qual esse agendamento deverá ser executado. O campo seguinte traz a especificação da CRON colocada no campo anterior. O próximo passo é escolher a prioridade da execução desse agendamento e falaremos mais sobre ele no próximo tópico do nosso array de novidades.

Na parte inferior do print, está a parte de parâmetros. Caso a automação que você esteja agendando ou editando tenha parâmetros a serem inseridos, você pode adicioná-los durante esta etapa de agendamento.

Print de um dos agendamentos de automação, dando destaque para o clique nos três pontos com duas novas opções "editar" e "deletar".

Importante: lembre-se, você não precisa deletar um agendamento caso não queira mais que ele seja executado por um tempo. Você pode editar e desligar a opção “ativo”. Assim, quando for necessário ligar novamente a automação, você pode apenas alterar a opção “ativo”.

[2] Prioridade de tarefas:

Existem ocasiões em que determinadas tarefas podem ter prioridade maior perante outras na hora da execução. Ou até mesmo um reajuste na fila que já está em andamento. E agora você pode configurar isso da forma que for melhor para suas automações. Entenda a seguir como funciona essa prioridade:

  • Você pode configurar a prioridade entre 0 e 10;
  • A prioridade 0 é a menor prioridade e a que foi determinada como padrão;
  • Quanto maior o número configurado, maior a prioridade. Por exemplo: um agendamento ou tarefa com prioridade 4 executará antes de agendamentos com prioridade menores ou iguais a 3. E assim por diante;
  • É possível ajustar a prioridade no momento de um agendamento (conforme tópico anterior);
  • É possível ajustar a prioridade para uma tarefa específica (acompanhe a seguir).
Print da tela onde pode-se criar uma nova tarefa de uma automação. Tem o checkbox para indicar se será uma tarefa de teste, o campo para a data de agendamento, o campo para inserir a prioridade e um campo para informar o valor do parâmetro. No canto direito inferior tem o botão "criar" e o botão "cancelar".

A partir de agora, você consegue ajustar a prioridade de uma tarefa em sua criação. Vá até o campo “prioridade” e ajuste conforme for necessário.

Se for necessário checar a prioridade de uma tarefa, clique nos três pontos localizados no canto superior direito de uma tarefa na fila e, após isso, clique em “informações”.

Print da fila de tarefas dando destaque para o clique nos três pontos, dando a opção "informações".

Em seguida, procure pelo campo “prioridade”. Nele, você poderá identificar a numeração.

Print das informações da tarefa. Entre elas, a primeira no canto esquerdo superior do print, o campo "prioridade" e logo abaixo o número "2".

[3] Exportando relatório a partir do CLI:

Agora você também pode extrair um relatório da execução de tarefas da sua automação a partir do CLI, com comandos executados em linha de comando. Acompanhe como funciona:

Observação: a extensão do arquivo BotCLI depende do sistema operacional que você está utilizando. Considere isso e verifique qual o seu sistema operacional para chamar o arquivo de extensão correta no momento de executar os exemplos de comandos abaixo.

WindowsLinux ou MacOS
BotCLI.batBotCLI.sh

A forma mais direta e básica de se executar o comando seria:

WindowsLinux ou MacOS
BotCLI.bat export taskReportBotCLI.sh export taskReport

O que este comando retorna é o relatório considerando os últimos 30 dias. O arquivo do relatório será colocado dentro do diretório que você está executando o comando.

Mas você também pode adicionar outros parâmetros, que são opcionais, para a extração de relatório via linha de comando.

Exemplo de como ficaria o comando utilizando todos os parâmetros disponibilizados:

export taskReport -since 2023-01-01 -until 2023-02-20 -automationLabel "myAuto" -state "FINISHED,RUNNING" -status "SUCCESS,FAILED" -output csv -totalPageLimit 30

Importante: todos os parâmetros e suas explicações podem ser acessadas através do comando “help” no terminal. Contudo, vamos entendê-los abaixo.

  • since: para especificar a data inicial a ser considerada para extração do relatório;
    • default: últimos 30 dias;
  • until: para especificar a data final a ser considerada para extração do relatório;
    • default: data atual;
  • automationLabel: para especificar o nome da automação;
  • state: para especificar de qual estado você está querendo retornar no relatório;
    • tipos de estado: START, RUNNING, FINISHED, CANCELED;
    • se você quiser especificar mais de um estado, você pode separar por vírgula;
  • status: para especificar de qual status você está querendo retornar no relatório;
    • tipos de status: SUCCESS, FAILED;
    • se você quiser especificar mais de um status, você pode separar por vírgula;
  • output: para especificar em qual formato você deseja exportar o arquivo do relatório;
    • tipos de formatos: csv, json;
    • o padrão é csv, caso você não especifique no comando;
  • totalPageLimit: para especificar o total de páginas que você deseja retornar no relatório. Cada página retorna 100 linhas em ordem decrescente de data de criação.

Exemplo de execução no prompt do Windows:

Print do prompt de comando do windows, mostrando as informações citadas, o andamento da geração do relatório, que mostra finalizado com 100%.

Exemplo de execução no terminal do Linux:

Perceba que ao executar o comando, serão mostradas as informações relacionadas ao arquivo que será baixado. Haverá também uma linha mostrando o processo de download e a porcentagem para que você possa acompanhar.

Em caso de não encontrar nenhuma tarefa executada nas informações solicitadas, seja o período, ou o status, ou qualquer outro filtro, você receberá uma mensagem informando que nada foi encontrado.

Logo teremos mais novidades

Esperamos que tenha gostado dessa nova release. E logo traremos mais novidades e features para desenvolverem seus bots da melhor forma.

Sinta-se à vontade para participar da nossa comunidade e nos trazer os feedbacks. E se quiser testar gratuitamente todas essas novidades, só clicar aqui.

Ela/dela. Está na BotCity atuando como Tech Writer e Developer Relations, além de ser criadora de conteúdo sobre tecnologia e participante ativa de diversas comunidades.

Deixe uma resposta

%d blogueiros gostam disto: