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.
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 moeda, tipo TEXT, coloque o valor padrão como Cotação Dólar 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.
A nova variável moeda vai armazenar o valor capturado através da passagem por parâmetro, e será utilizada ao pesquisar pela moeda na barra de pesquisa do Google.
...
# Recuperando o parametro "moeda" e assumindo valor padrão como
# Cotação Dólar
moeda = execution.parameters.get("moeda", "Cotação Dólar")
# Abre a página inicial do Google
bot.browse("https://www.google.com")
if not bot.find( "lupa", matching=0.97, waiting_time=10000):
not_found("lupa")
bot.click()
bot.paste(moeda)
bot.enter()
Importante
Caso nenhum parâmetro seja passado durante a execução da tarefa, a busca da moeda utilizará o valor padrão definido como Cotação Dólar.
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 canal criado na etapa anterior foi dinamicamente exibido para que operadores possam criar tarefas.
Preencha com o valor Cotação Euro e clique em Criar.
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 cotação de qualquer moeda a ser pesquisada no Google.
Tente passar outras moedas como parâmetro:
- Cotação Real
- Cotação Pesos Argentinos