Conheça as novidades nas ferramentas Python RPA da BotCity

Blog
1

This is a discussion topic for the original post at Conheça as novidades nas ferramentas Python RPA da BotCity - BotCity | Python RPA | Blog

Olá, mundo! :wave:

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.

image-6-1024x334.png1023×334 26.8 KB

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”.

avzZEVeA7SJFixvKwv2A9ZEv6JTw4TU7ztxd_F3S2iwZ6CYo4bZSl3KRmnC5jjINq-iWTeoWM78S2kcPykhspq5miPJHLAXinX1PfNO6HEslSAx49l92nJIsXx3B0gVNvTNaO04PgSZe8wWx2RCdMkA.png977×580 208 KB

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”.

LFUqSX8yY6uKBIq737aGEPSFRrHKkwjFck8k1V8LV8cRV3HopKXZDLosukB42X-XorKqBRqW5Jrs3SEvVnXt7aJBD3ys4V77VfPYDmaEnjGKaWhdYiDI4Qn_D1O7mhRSuklJmUXHHu6Uhr2CW6XkuqE.png975×587 208 KB

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”.

5m8nLNLAs6EEy4Sr7v_sHn4D0ZM4BcPnllrQYrzeqYFd3ZuicoSIj9U4O3Ltl4eUzjgsxqvBLiPfmnlaVtMgLZjRIVP2IKA5GVCuj2vw56pgEFOL7MFir-vm0XI3rDOqhJvE5WER2YSYnYHXsA_G_W0.png977×585 196 KB

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

EU47cfuJ_BH24vFxbS4juPvMgJcyuSQo1UVLuO6J0Ys8MITFFaIWPdqIlGaakK4sZSPt4qGZkc0ZQQrMlsRpNnsZyPR3HzMQ8Z8B8iX9xNRVxfQEZ9ysnu4aiN-PN9WCTdgP7WvapPWvwE-GAQzS91w.png973×586 222 KB

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.

2T4cJDqplaTOKcwqiyizqqEzgeDCp2wSyQmo0mR-i7rFwzKnjMJjsuy3o2pt9GkQUJtLrftU0IJcTcHpIpFIsgYadathliG3hy2SOxpXtlxhV7ohWBBEHM88t7FJk6LsARSEDi_JEwdZuNI7tyFZaw.png1600×744 85.9 KB

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.

IMz_etIvp-OETpwvDICOOd4HUdeQgbukklXJD195k1zP1PJsWOQGotgRF_9kR6MzsYxjSf0ab-CQqUvLsLA86JdwB013uAZdqBPAjJyMrdVR4s-odMSEcu403TVbL7_8ci-bGnjfgN2M4pkp-aAlYxE.png1573×157 4.18 KB

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).
zjUBAs69golilV5UVLrzPaH2uQs3lRDTno8nhySvwPjv9M7cG7p3Cya9TpmkGhUq8iBWScILKR139SVoSfeJgcV3CkSmW9y3GgG8wgE-Cl605UAgtj7e_z7awN7zUZ8c6lQXTQc94cTe2MO_Re9J3Tc.png1582×700 16.7 KB

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”.

O-AvuQn0AQK4l8Ic_P41ukz-qAHwMwV9302VErPMGkhS8FG3lqefeZ5jFwmM_TfT4c7EIwIGFKPY88WX_cEofX50i4CE2RRiXRvnA22i6fzyKeVmQIhdkRYsg8XMtW_1iqeG_tiY8j6SwqqEGaR9CXc.png1582×765 30.7 KB

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

AjKkdAFXjpfhmzgHrdP4Q3geRwv1TkxSuHr5He59rwzD3wYKFtcw_6JBIulKPktpQ3RnVsQxNrM9slcQhOCyXl0_w-HwkknOnoxnOv4c1F8Z8AU1Z2EXxlKJ9zay1bbnfbMg8yeJZ1PX06qZy8d2idY.png801×365 12.6 KB

[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.

Windows Linux ou MacOS
BotCLI.bat BotCLI.sh

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

Windows Linux ou MacOS
BotCLI.bat export taskReport BotCLI.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:

MZZz7dDUgdLP3tC2C14cMPIc-kSxqNWveWdlC5eD8d0lBqo9pcqvkodGuGN-aXPdJWuPnGLEmozKzwjYt2Q1ybFKtjqiLxO26RZRKUHcykv4DnkwEFa0128EVtjyCzKwEs_wA9C8-kO5QzjODomL42U.png1313×359 34.1 KB

Exemplo de execução no terminal do Linux:

YIFzvQL4Zi3SRSnphipp3NTrRwmKVUOvGq_wxt-LUs-_OyL_ndeUFIxHITovUz5UdxCUVlHsC54YQaK08Qhy3NsS-cogj0FaIgK8I-fjIpHj6UIyoHlVv1Io4yvtIgFYNSHp4Uy1r7kU7Mx4Y526rtI.png1382×410 38.3 KB

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.