Nova Tarefa¶
Usando o recurso Nova Tarefa, você pode criar uma nova tarefa para uma automação específica diretamente do Orquestrador BotCity.
Gerador de Snippet
As ações de manipulação de nova tarefa podem ser realizadas diretamente na plataforma do Orquestrador BotCity ou via código, utilizando o BotCity Maestro SDK ou a BotCity Orquestrador API.
Explore o botão Gerador de Snippet para obter exemplos de código que facilitam as manipulações de tarefas utilizando o SDK do BotCity Maestro. Gere trechos de código para as ações: Interromper uma tarefa, Verificar a requisição de interrupção, Finalizar uma tarefa, Recuperar uma tarefa e Acessar parâmetros da tarefa.
Os snippets gerados podem estar disponiveis nas linguagens Python, Java, JavaScript e TypeScript.
Busca e filtros¶
Ao acessar o menu Nova Tarefa, você pode visualizar uma tabela com todas as automações criadas no Orquestrados BotCity.
É possível combinar vários filtros para fazer buscas conforme as suas necessidades.
Busca por:
- Automação: Busca pelo nome da automação.
Filtros disponíveis:
- Bot ID: Seleciona o Bot ID específico.
- Label: Seleciona um ou mais labels para filtrar.
- Nome: Seleciona um ou mais nomes para filtrar.
- Repositório: Seleciona um repositório específico.
Ordenação:
- Alfabeticamente
- Mais recente primeiro
- Mais antigo primeiro
Criar Nova Tarefa¶
Para criar uma nova tarefa, clique no botão Nova Tarefa referente ao processo de automação escolhido e preencha os campos.
Tarefa de teste¶
Caixa de seleção que pode ser marcada ou não, para definir o tipo de tarefa como teste ou produção.
Ao marcar essa opção, a tarefa de teste será criada, com isso é possivel:
- Reiniciar a tarefa quantas vezes for necessário, mesmo após a execução da tarefa.
- Excluir a tarefa do histórico de tarefas.
- Não incluir os dados processados por essa tarefa nos relatórios de dados do BotCity Insights.
Sem marcar a opção, a terefa de produção será criada, com isso:
- Executa uma única vez.
- Permanece no histórico de tarefas com estado de finalização.
- Inclui os dados processados por essa tarefa nos relatórios de dados do BotCity Insights.
Excluir uma tarefa de teste
Se você deseja excluir uma tarefa de teste, precisa deixá-la com estado de Aguardando para que a opção de excluir seja habilitada. Para isso, basta reiniciar a tarefa e em seguida excluí-la.
Data de execução mínima¶
Campo opcional para definir uma data mínima para a execução da tarefa.
Sem definir uma data mínima, a tarefa estará disponível para execução assim que clicar em Criar Tarefa.
Ao definir uma data mínima, a tarefa ficará na fila de tarefas com estado de Aguardando até que a data e hora definidas sejam alcançadas, ou seja, a tarefa só estará disponível para execução após a data mínima definida.
Prioridade¶
O campo de prioridade é utilizado para definir a ordem de execução das tarefas, ou seja, quando houver mais de uma tarefa disponível para execução, a prioridade será o critério utilizado para determinar qual tarefa deve ser executada primeiro.
Por padrão, as tarefas são executadas por ordem de chegada, ou seja, a tarefa que foi criada primeiro será executada primeiro. No entanto, ao definir a prioridade, você pode alterar essa ordem de execução.
Use o campo de prioridade para gerenciar a fila, atribuindo valores de 0 (menor prioridade) a 10 (maior prioridade) para cada tarefa.
Parâmetros¶
Os parâmetros de uma automação permitem que você crie tarefas personalizadas, passando valores específicos para cada execução. Isso deixa suas automações mais flexíveis e adaptáveis a diferentes cenários, sem a necessidade de alterar o código-fonte.
Automação parametrizada
Veja como criar parâmetros para suas automações acessando a documentação de Automações.
Confirmar¶
Com as configurações definidas, clique em Criar para finalizar a criação da tarefa.
Assim que a tarefa for criada, ela será adicionada à fila de tarefas e você poderá acompanhar a execução através no menu Tarefas.
Aviso! Seu código não está informando nenhum item processado
Se você visualizar um aviso referente ao reporte de itens processados, 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 em reportar e exibir dados referentes à sua iniciativa de automação.
Veja mais detalhes sobre esse módulo acessando a documentação do BotCity Insights.




