Lab 4.2: Funcionalidade Datapool

Nesse lab vamos detalhar o passo a passo para criar um Datapool, entendendo cada etapa.

Criar um Datapool

Navegue no Orquestrador BotCity no menu lateral Datapool, clique em + Novo Datapool e preencha os formulários:

1. Informações Básicas

Label: O identificador único que será utilizado para acessar o Datapool.
Nome: O nome amigavel do Datapool.
Repositório: O repositório onde o Datapool será armazenado.
Status: O status do Datapool, que pode ser Ativo ou Inativo.
Política de consumo: Você pode escolher entre duas políticas de consumo.
- FIFO: O primeiro item a ser adicionado ao Datapool também será o primeiro item a ser processado.
- LIFO: O último item a ser adicionado ao Datapool será o primeiro item a ser processado.

2. Configurações de Processamento

Nessa etapa, você deve configurar o comportamento do Datapool durante o processamento dos itens, essas configurações podem ser ativadas ou não.

Tempo de processamento: permite definir qual o tempo esperado (em minutos) para que um item do Datapool seja processado em condições normais.
Auto-retry: permite que um item seja reprocessado automaticamente em caso de erro do tipo SYSTEM.
Abortar em caso de erro: faz com o que o Datapool fique inativo e não seja mais consumido em caso de erros consecutivos do tipo SYSTEM.
Gatilhos de disparo de tarefas: define se o Datapool criado também vai ser responsável por disparar novas tarefas:
- Nunca disparar nova tarefa: O Datapool nunca será responsável por disparar tarefas de um processo de automação.
- Disparar nova tarefa a cada item adicionado: Para cada novo item adicionado ao Datapool, uma nova tarefa será criada (número de tarefas proporcional ao número de itens).
- Disparar nova tarefa apenas se não houver tarefas pendentes: Sempre que um novo item for adicionado, o Datapool irá disparar uma nova tarefa somente se não existirem tarefas desse processo pendentes ou executando.
- Automação: O processo de automação que será utilizado pelo Datapool para disparar novas tarefas, se algum gatilho estiver sendo utilizado.

Dica

É importante que o código da Automação para o consumo dos dados do Datapool esteja em uma estrutura adequada para cada tipo de configuração de gatilho definida.

3. Definir o Esquema

Pode ser definida a estrutura dos itens que serão adicionados ao Datapool, ou seja, quais campos necessários compõe cada item.

Label: O identificador único que será utilizado para acessar esse campo.
Tipo: O tipo esperado para o valor desse campo (TEXT, INTEGER, DOUBLE).
ID único: Se marcado, o campo irá representar uma "chave única" para o item, ou seja, não será permitido adicionar itens duplicados que tenham o mesmo valor para esse campo em específico.
Exibir valor: Se marcado, o valor desse campo será exibido na lista de itens do Datapool, servindo como um identificador visual para os itens em questão.

Para a Automação de exemplo usaremos os seguintes campos necessários para preencher o formulário da plataforma OrangeHRM, todas com o tipo TEXT:

full_name

vacancy

email

contact_number

keywords

4. Resumo

Ao final, revise as informações e clique em Confirmar.

Nota

Você pode encontrar mais detalhes também na documentação do Datapool.

Adicionar itens ao Datapool

Após criar o Datapool, podemos adicionar itens de diversas formas. Clique no Datapool criado para verificar os detalhes. A tela será semelhante a essa:

Adicionar itens individualmente

Para algum caso excepcional, é possivel criar um item unico diretamente no Orquestrador BotCity.

Clique em + Adicionar entrada
Defina a prioridade do item (0 a menor | 10 a maior)
Preencha os valores para os campos
(opcional) Clique em + Entrada para criar um novo campo para esse item
Clique em Salvar para adicionar esse item

Adicionar em lote

Uma forma mais eficiente de adicionar itens é por um arquivo .csv, informando uma lista de itens de uma vez. Para isso, clique em Importar CSV e arraste o arquivo ou clique para selecionar.

Clique em Importar CSV
Baixe o modelo com o Schema definido no Datapool
Preencha o .csv
Arraste ou busque o arquivo .csv para carrega-lo
Verifique o resumo
Clique em Adicionar

A primeira linha é considerada o cabeçalho conforme o Schema criado e as demais linhas se tornam os valores dos itens.

Dica

O arquivo .csv preenchido utilizado neste exemplo está disponível para download clicando nesse link.

Note que os itens adicionados possuem o status PENDENTE, isso significa que estão aguardando processamento.

Nota

Para entender mais sobre os status durante o processo, veja a documentação do Datapool.

Adicionar de outras formas

Existem outras formas de adicionar itens como via SDK ou via API, explore essas formas na documentação de ferramentas BotCity.