Automações¶

Nas seções a seguir, você encontrará informações sobre como criar e gerenciar Automações.

Anatomia de uma Automação¶

Uma Automação é um dos elementos mais importantes do BotCity Orquestrador, ela caracteriza um processo a ser executado.

A Automação é responsável por fazer o vínculo entre o Robô (script, software ou código de um processo) e os Runners (instâncias do serviço BotCity Runner). Dessa forma, ao criar uma nova tarefa, na Automação estarão as informações de qual robô utilizar e para qual dos Runner a tarefa deve ser direcionada.

Mais informações

Entenda mais sobre:

Uma Automação pode conter mais informações e configurações sobre um processo a ser executado. Podemos visualizar as informações nas abas Visão Geral e Desenvolvimento

Visão Geral¶

Nessa aba, temos as informações gerais sobre a Automação, separadas em blocos:

Sobre a automação
- Nome: O nome amigável da automação.
- Label: O identificador único da automação (o label é unico, mesmo se excluir a automação não poderá usá-lo novamente).
- Repositório: Nome do repositório onde a automação está alocada.
- Descrição: Uma breve descrição sobre o processo de automação.
Gerenciamento de tarefas
- Prioridade: A prioridade padrão de execução desse processo.
- Runners vinculados: Lista de Runners associados a esta automação. Se mais de um Runner estiver anexado, a tarefa será distribuída ao primeiro BotCity Runner livre que está online e disponível.
Notificações
- Usuários para notificar: A lista de usuários a serem notificados quando o alerta de notificações de um determinado tipo acontecer.
- Tipo de notificação: Os tipos de notificação de alerta para notificar os usuários.

Importante

Os usuários selecionados no campo Notificar os usuários receberão uma notificação via e-mail toda vez que a automação disparar um alerta via código.

Veja mais detalhes sobre a funcionalidade de Alertas do BotCity Orquestrador.

Desenvolvimento¶

Nessa aba, encontramos informações de desenvolvimento da Automação, separadas em blocos:

Informações do Bot
- Tecnologia: Tecnologia ou linguagem de programação utilizada na automação.
- Robô vinculado: O código de um processo ou software associado a esta automação.
Parâmetros: Informações dinâmicas que podem ser usadas pelo Robô vinculado.

Parâmetros¶

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

Os parâmetros são definidos na seção Parâmetros da Automação ao criá-la ou editá-la. Em Desenvolvimento, clique no botão Editar, isso habilita os campos de edição, em seguida clique no botão Adicionar + para adicionar uma nova linha nos parâmetros.

Um parâmetro é definido pelos seguintes elementos:

Nome: O nome amigável do parâmetro.
Label: O identificador exclusivo do parâmetro.
Descrição: Uma breve descrição sobre o parâmetro.
Tipo: Seleção do tipo de dados do parâmetro, podem ser:
- Text: Tipo de entrada de texto.
- Integer: Tipo de entrada de número inteiro.
- Double: Tipo de entrada de número decimal.
- Date: Tipo de entrada de data.
Intervalo: Indica o valor mínimo e máximo para a entrada de dado numérico.
Valor padrão: Indica qual valor de entrada definido como padrão para o campo.
Obrigatório:
- Sim: É obrigatório informar um valor para o campo no momento de criar uma tarefa.
- Não: É opcional informar um valor para o campo no momento de criar uma tarefa.
Ações:
- Deletar: Deleta o parâmetro.
- Editar: Abre a edição do parâmetro.
- Cancelar: Cancela a edição do parâmetro.
- Salvar: Salva a edição do parâmetro.

Dica

O Tipo determinará como o parâmetro será exibido ao criar uma nova tarefa no BotCity Orquestrador.

Veja mais detalhes de como criar e acessar Parâmetros

Criar uma automação¶

Crie uma nova Automação clicando no botão + Nova Automação no canto superior direito.

Preencha o formulário com as informações necessárias e clique em Salvar no topo da tela.

Atenção

Os campos obrigatório são: Nome, Label, Repositório e Descrição.

O restante das informações pode ser preenchidas posteriormente, porém, para a execução de tarefas dessa automação, é necessário ter o Robô e pelo menos um Runner vinculado.

Aqui está um exemplo de como criar uma automação:

Visão Geral
Desenvolvimento

Dica

As Automações também podem ser criadas de maneira facilitada através do Easy Deploy.

Avisos!

Você poderá ver um quadro de avisos quando a Automação não está completamente preenchida.

Os avisos podem ser referentes a falta de informações importantes, como Robôs ou Runners não vinculados.

Também sobre não reporte de itens, isso quer dizer que o código da sua Automação ainda não está reportando dados para a plataforma.

Utilizar esse recurso no seu processo de Automação permite que você tenha informações sobre os itens processados com sucesso ou falha por cada tarefa executada.

Veja mais detalhes sobre essa funcionalidade acessando a documentação do BotCity Maestro SDK.

Importante

Esse recurso faz parte do BotCity Insights, que é um módulo dedicado a parte de reportar e exibir dados referentes à sua iniciativa de automação.

Veja mais detalhes sobre esse módulo acessando a documentação do BotCity Insights.

Editar uma Automação¶

Após criada, também é possível editar algumas informações da Automação.

Para isso, clique no nome da Automação que deseja editar, clique no botão Editar altere os campos necessários e clique em Salvar.

Mover de Repositório¶

As Automações podem ser realocadas em outro repositório.

Para isso, selecione a Automação desejada, abra as ações e selecione Mover para repositório, como na imagem:

Assim abrirá uma janela para selecionar o repositório para onde a Automação deve ser movida, após selecionar, clique em Confirmar.

Atenção

Essa ação moverá também os robôs, agendamentos e outros recursos que estão vinculados a essa Automação.