Gerenciamento de filas no Studio

Adição de itens a uma fila

1. Na página Filas, crie uma fila.

2. No Studio, crie um projeto de automação que, por exemplo, coleta determinadas imagens de uma planilha do Excel e as armazena em uma variável.

3. Arraste uma atividade Add Queue Item do painel Atividades para o painel Projeto.

4. No painel Propriedades, no campo QueueName, digite o nome da fila criada na etapa 1, entre aspas.

   Observação:

   Os nomes das filas não diferenciam maiúsculas de minúsculas. Por exemplo, "Test_QuEuE" e “test_queue” são o mesmo.

5. Na lista Prioridade, selecione Baixa, Normal ou Alta, dependendo da importância dos itens que serão adicionados por essa atividade e a velocidade que você deseja que eles sejam processados.

6. (Opcionalmente) No campo Referência, insira uma string ou variável de string para agir como um identificador para um item de fila ou um grupo deles. (A referência pode ser usada para vincular suas transações a outros aplicativos usados em um projeto de automação. Além disso, essa funcionalidade permite que você procure determinadas transações, no Orchestrator, de acordo com a referência personalizada fornecida.)

   Observação:

   As referências não são compatíveis com as versões 2016.2 ou inferiores do Orchestrator ou do Robô.

7. (Opcionalmente) No campo Prazo, adicione uma data representando que o item da fila pode ser processado por essa data.

8. (Opcionalmente) No campo Adiar, adicione uma data representando que o item da fila pode ser processado apenas após essa data.

9. Ao lado do campo ItemInformation , selecione a opção Procurar botão. A janela ItemInformation será exibida, permitindo que você adicione dados a cada item da fila criado.

   Figura 1. Janela InformaçõesDoItem

   

   Observação:

   O valor dos argumentos de string adicionados na janela ItemInformation não pode conter os seguintes caracteres: [ e " "

10. Selecione Criar argumento. Um novo argumento em branco é criado.

11. Altere o nome do argumento para algo que represente melhor suas necessidades.

12. Altere o Tipo do argumento para o que você precisar. Por exemplo, se você deseja armazenar valores numéricos das transações, selecione Int32.

13. No campo Valor, insira o valor que você deseja adicionar aos itens da fila ou uma variável que você usa para armazenar um valor específico.

14. Selecione OK. Suas configurações foram salvas.

    Observação:

    Coloque esses tipos de projetos de automação em um loop. Caso contrário, apenas um item será criado e preenchido no Orchestrator.

Os dados adicionados na janela ItemInformation no Studio serão exibidos na janela Detalhes do item, em Dados específicos no Orchestrator. Todos os itens adicionados a filas têm o status definido como Novo.

Figura 2. Janela Detalhes do item

Obtenção de itens de uma fila e alteração do status deles

1. No Orchestrator, suponha que você tem uma fila preenchida com itens.

2. No Studio, do painel Atividades, arraste uma atividade Get Transaction Item para o painel Designer.

3. No painel Propriedades, no campo QueueName, digite o nome da fila preenchida do Orchestrator, entre aspas.

   Observação:

   Os nomes das filas não diferenciam maiúsculas de minúsculas. Por exemplo, "New_QueUe" e “new_queue” são o mesmo.

4. Crie uma variável QueueItem. Essa variável armazena o primeiro item de uma fila, de acordo com sua prioridade e o prazo. Quando colocado em um loop, o robô itera por todos os itens da fila. Após um item da fila passar por essa atividade, ele NÃO é processado e o status do item muda para Em progresso.

5. No campo TransactionItem, insira a variável QueueItem criada anteriormente.

6. No painel Atividades, arraste uma atividade Decision sob a atividade Get Transaction Item.

7. Crie seus requisitos de automação. Por exemplo, adicione os itens de transação a uma planilha do Excel e envie e-mails com essas informações.

8. No painel Propriedades, no campo Condição, digite uma condição (por exemplo, o item da fila está vazio) com base na qual o status do item pode ser alterado.

9. No painel Atividades, arraste uma atividade Set Transaction Status e conecte-a à ramificação False da atividade Decision. Todos os itens da transação que passam por esta atividade não atendem à condição adicionada na etapa 7.

10. No painel Propriedades, na lista suspensa Status, selecione Sucesso. Esse status é aplicado a todos os itens da fila que passarem por essa atividade.

11. No campo TransactionItem, insira a variável QueueItem usada na etapa 5.

12. (Opcionalmente) Selecione o botão Pesquisar ao lado do campo Análise e insira os dados que você deseja que sejam exibidos na janela Detalhes do item, no campo Análise.

13. (Opcionalmente) Selecione o botão Pesquisar ao lado do campo Saída e insira os dados que você deseja que sejam exibidos na janela Detalhes do item, no campo Saída.

    Observação:

    Essas informações serão exibidas apenas se o item da fila for processado com sucesso.

14. Arraste outra atividade Definir Status da Transação para o painel Designer e conecte-a à ramificação True da atividade de Decisão. Todos os itens da fila que passam por essa atividade atendem à condição adicionada na etapa 7.

15. No painel Propriedades, no campo Status, selecione Com falha. Esse status é aplicado a todos os itens da fila que passarem por essa atividade.

16. No campo TransactionItem, insira a variável QueueItem usada na etapa 5.

17. Na lista ErrorType selecione Business ou Application, dependendo da condição que você colocou na atividade Decision. Por exemplo, um item da fila vazio pode ser uma exceção de aplicativo, enquanto um valor de transação menor do que um valor padrão pode ser uma exceção de negócios. Para mais informações sobre essa escolha, consulte o artigo Exceção de Negócios versus Exceção de Aplicativo.

18. No campo Motivo, digite uma string para explicar o motivo da exceção ter sido disparada. Após o projeto ser executado, essa informação será exibida na janela Detalhes do item.

19. Conecte ambas as atividades Set Transaction Status à atividade Get Transaction Item. Isso cria um loop e permite que você itere por todos os itens da fila. Um projeto de automação básico deve ser semelhante à captura de tela a seguir.

    Figura 3. Projeto de automação básico

Um mapeamento das propriedades na atividade Set Transaction Status (à esquerda) e seus campos correspondentes na janela Detalhes do item no Orchestrator.

Figura 4. Definir atividade Status da transação

Para recuperar dados específicos de um item da fila, você pode usar a função SpecificContent(). Escreva o nome do argumento usado para adicionar informações à fila entre aspas em colchetes.

Figura 5. Editor de Expressão

Por exemplo, a captura de tela acima exibe o campo Valor de uma atividade Assign. Isso permite que você recupere o valor atribuído a um item da fila (exibido na janela Detalhes do item, em Dados específicos no Orchestrator) e o atribua a uma variável de string, para que possa processá-lo posteriormente.

Na captura de tela acima:

• transItem – É uma variável QueueItem usada para armazenar itens de transação.
• .SpecificContent – É a função que recupera informações dos itens de transação.
• ("transactionID") - É o nome do argumento que foi adicionado na janela ItemInformation para preencher os itens da fila com dados. O nome do argumento também será exibido na janela Detalhes do item, em Dados específicos no Orchestrator.
• .ToString - É uma função usada para converter o ID da fila, que era um inteiro inicialmente, em uma string.

Adiamento de um item de transação

1. No Orchestrator, suponha que você tenha uma fila preenchida com vários itens.

2. No Studio, considere que já tem uma atividade Get Transaction Item que itera por todos os itens da fila.

3. No painel Atividades, arraste uma atividade de Decisão para o fluxo de trabalho. A atividade permite que você tome uma decisão de negócios com base em quais itens de fila adiar. Por exemplo, se o valor de uma fatura for superior a $3000, você pode querer adiar seu pagamento.

4. No painel Atividades, arraste uma atividade Postpone Transaction Item para a ramificação True de Decision. Isso significa que todos os itens da fila que atendam à condição colocada na atividade Decision, serão adiados de acordo com suas configurações.

5. No campo TransactionItem, insira a variável QueueItem usada na atividade Obter Transação.

6. No campo Adiar, adicione a data após a qual esse item pode ser processado.

7. No campo Deadline, adicione a data antes da qual esse item deve ser processado.

   As propriedades Prazo Final e Adiar adicionam uma nova prioridade aos itens de fila. Por exemplo, um item de fila que vence hoje às 19 horas e tem uma prioridade Média será processado primeiro, antes de outro item que não tenha data de vencimento e prioridade Alta.

   Observação:

   Modificar o prazo de um item da fila ou adiá-lo altera seu status para novo.

Adição de um progresso personalizado

1. No Orchestrator, considere que você tem uma fila preenchida com vários itens (milhões) com o status Em Progresso.
2. No Studio, considere que você já tem uma atividade Get Transaction Item que itera por todos os itens da fila e usa uma variável QueueItem.
3. No painel Atividades, arraste uma atividade Set Transaction Progress para o painel Designer.
4. Na propriedade TransactionItem da atividade, insira a variável QueueItem.
5. Na propriedade Progresso, adicione uma string personalizada para descrever o progresso alcançado aqui, como "BeforeFirstDecision". Isso informa que o item foi recuperado do banco de dados do Orchestrator. Se seu projeto de automação falhar nesse ponto durante a execução, um item terá esse status e será exibido na coluna Progresso.
   Observação:

   Os status de progresso personalizados serão exibidos apenas enquanto um item estiver com o status Em Progresso.

O restante do projeto de automação pode ser definido conforme explicado acima.

For example, the following workflow example sets each item status to Successful or Failed automatically, depending on how you design the Transaction Body sequence:

• Não fazer nada, Interromper ou Continuar: resulta em Bem-sucedido

• Throw Exception - results as Failed (Application error)

• Throw BusinessRuleException - results as Failed (business error)

• Set Transaction Status - results as the status you set

• Postpone Transaction Item - results as New

• Deve parar: se você parar o fluxo de trabalho pelo Orchestrator, o fluxo de trabalho sai do loop após a conclusão da transação atual. O fluxo de trabalho se repete para cada item da fila automaticamente e define o status da transação correspondente. No caso de Interromper ou se a fila estiver vazia, o fluxo de trabalho sai do loop.

  Figura 6. Projeto de automação

  

Baixe o fluxo de trabalho arquivado e use-o como referência.