Ir para o conteúdo

Nova Tarefa

Usando o recurso Nova Tarefa, você pode criar uma nova tarefa para uma automação específica diretamente do Orquestrador BotCity.

Captura de tela do Orquestrador da BotCity, no menu Nova Tarefa, apresentando na parte superior direito o botão Gerador de Snippets, abaixo uma tabela com todas as automações disponíveis para criação de tarefas, acima da tabela um campo de busca para digitação, um campo de seleção de filtros e campo de seleção de ordenação. Cada automação na tabela apresenta o nome, label, descrição, BotID, repositório e um botão para criar uma nova tarefa.

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.

Gerador de Snippet

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

Gif do Orquestrador da BotCity, no menu Nova Tarefa, apresentando os filtros para busca de automação. Mostra os três campos principais disponiveis para filtro: Busca por Automação, Filtro, Ordenação.

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.

Captura de tela do Orquestrador da BotCity, apresentando a tela de configuração para criação de nova tarefa. A tela apresenta os campos: Tarefa de teste, Data de execução mínima, Prioridade e Parâmetros. No inferior da tela, há um botão de cancelar e um botão para criar a tarefa.

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.

Captura de tela do Orquestrador da BotCity, apresentando o formulário de criação de nova tarefa com os campos padrões para configuração de nova tarefa, além de um campo de parâmetros customizados, onde é possível adicionar quantos parâmetros forem necessários para a execução da tarefa. Na parte inferior os botões de cancelar e criar tarefa.

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.