Lab 2.5: Recebendo atributos da tarefa a ser executada

Automações podem ser parametrizadas para maior flexibilidade e código mais dinâmico.

Parâmetros são configurados na sessão Parâmetros da automação ao criá-la ou editá-la.

Para definir parâmetros precisamos de um Label e Tipo, onde o Label deve ser um identificador único e o Tipo deve definir o tipo de dado do parâmetro.

Você também pode definir se esse parâmetro terá um valor padrão e também se é um parâmetro obrigatório.

O Tipo define também a forma com que os parâmetros serão exibidos no Orquestrador BotCity Maestro na tela Novas Tarefas.

Veja mais aqui.

Adicionando parâmetro a automação

Através do menu Automações, encontre sua automação, clique no menu de opções e selecione Editar:

Adicione um novo parâmetro com o nome canal, tipo TEXT, coloque o valor padrão como botcity_br e marque como obrigatório, conforme a imagem abaixo:

Acessando os parâmetros no código

Agora que temos o parâmetro definido em nossa automação, o próximo passo é alterar o código para capturar os valores informados.

Para isso vamos utilizar o objeto execution e acessar a propriedade parameters que é um dicionário.

Vamos alterar a variável canais para armazenar o valor capturado através da passagem por parâmetro, ela será utilizada ao abrir o navegador, direcionando para os canais escolhidos.

Como padrão vamos adotar que o nome de cada canal será separado por vírgula, por exemplo: botcity_br,github,pythonbrasiloficial.

...
# Recuperando o parametro "canais" e assumindo valor padrão como
# o canal botcity_br
canais = execution.parameters.get("canais", "botcity_br")

# Transforma em uma lista separando por vírgula
canais = canais.split(",")

# Abrindo o navegador com os canais
for canal in canais:
    # Inicia o navegador
    bot.browse(f"https://www.youtube.com/@{canal}")
    ...

Importante

Caso nenhum parâmetro seja passado durante a execução da tarefa, o browser abrirá no canal padrão setado botcity_br.

Atualize seu robô

Lembre-se sempre que após modificar o código precisamos:

• Executar o build
• Atualizar o robô

Criando tarefas com parâmetros

Usando o menu Nova Tarefa, busque a automação e clique no botão Nova Tarefa.

Note que o parâmetro canais criado na etapa anterior foi dinâmicamente exibido para que operadores possam criar tarefas.

Preencha com o valor a lista de canais e clique em Criar.

botcity_br,github,pythonbrasiloficial

Fila de Tarefas

Através dos cards das tarefas que estão na Fila de Tarefas, podemos verificar os parâmetros enviados acessando as Informações da tarefa.

Sua automação agora é capaz de obter informações de qualquer canal do YouTube.

Tente passar outros canais como parâmetro e veja o resultado.