Sobre filas e transações

Uma fila é um contêiner que permite que você mantenha uma quantidade ilimitada de itens. Os itens da fila podem armazenar vários tipos de dados, como informações de fatura ou detalhes do cliente. Essas informações podem ser processadas em outros sistemas, como SAP ou Salesforce.

Os dados armazenados e de saída dos itens da fila são de formato livre por padrão. Para situações em que um esquema específico é necessário, como em integrações com outros aplicativos, no processamento de formulários gerados por máquina, ou nas análises, você pode carregar esquemas JSON personalizados para garantir que todos os dados de item da fila estejam no formato adequado.

No Orchestrator, as filas recém-criadas são vazias por padrão.Para preenchê-las com itens, você pode usar a funcionalidade de upload no Orchestrator ou as atividades do Studio. Essa segunda opção também permite que você altere os status dos itens e processe-os. Assim que os itens da fila são processados, eles se tornam transações.

Visão Geral das Filas

Queues enable you to create large automation projects underlined by complex logic. For example, you can create a process that collects all invoice information and creates a queue item for each piece of data to store it. Subsequently, you can create another process that gathers the information from Orchestrator and uses it to perform additional tasks, such as:

• Paying the invoices in a different application.
• Postponing their payment according to their due date or value.
• Sending emails to the accounting team every time a bill is paid. The Queues page enables you to create new queues, to view previously created queues, and to access charts displaying the transaction status progress over time, along with various other details, such as average execution time and the total number of successful transactions.

Os dados disponíveis na grade de filas são atualizados em intervalos regulares, o que significa que nem sempre são exibidos em tempo real e que pequenos atrasos são possíveis. Além disso, não são afetados pelas políticas de retenção; portanto, o arquivamento de itens do banco de dados não altera as informações disponíveis na grade.

Os status de itens são controlados por desenvolvedores de RPA quando criam os projetos de automação, já os status de revisão são controlados no Orchestrator e permitem realizar controle de versão, mas apenas de itens da fila que foram abandonados ou falharam com uma exceção de aplicativo ou negócios.

Os itens com falha ou abandonados também podem ser atribuídos a um revisor, e podem ser alterados ou removidos a qualquer momento, se necessário. Cada uma dessas alterações é rastreada na guia Histórico da janela Detalhes da Auditoria. O revisor é responsável por avaliar o status atual das transações às quais ele foi atribuído, e alterar o status da revisão. O status dos itens da fila prontos para revisão pode ser alterado na página Revisar solicitações.

Importante:

Para garantir que o processamento de itens da fila seja realizado com sucesso, você precisa ter um conjunto de referência exclusivo no nível da fila ao remover da fila por referência. Não manter a referência exclusiva levará a problemas de acesso à simultaneidade, como falhas devido ao fato de nenhum dado de transação ser encontrado (mensagem de erro No Transaction Data ). Se a referência não puder ser exclusiva, é aconselhável remover da fila sem referência.

Definições de Esquema

Ao criar ou editar uma fila, você pode carregar um esquema JSON personalizado para os Dados específicos, Dados de saída e/ou Dados de análises. Com o(s) esquema(s) no lugar, todas as transações são validadas com o formato fornecido, e se os dados resultantes não estiverem em conformidade, o item falha com uma Exceção de Negócios.

Importante:

• O esquema não é aplicado retroativamente às transações existentes, apenas àquelas executadas após você ter carregado o(s) esquema(s).
• Your schema(s) must not contain an array.
• Para fins de validação, DateTime é aceito como tipo string .
• Use of and validation of an Analytics Data schema requires Robots and Activities of version 19.10 or greater.
• Se o(s) esquema(s) carregado(s) não contiverem uma definição de esquema válida URI, a definição draft-07 , como no exemplo abaixo, será usada como fallback.

Observação:

To achieve better control in terms of Orchestrator performance, the Specific Data size of queue items is limited to 256,000 characters or 512,000 bytes. Anything beyond this limit cannot be added to a queue, and it returns the 403 - Payload Too Large error code. If you need to upload larger items, store the large data in an external storage and only reference the link in the item.

Um exemplo de esquema:

{
  "definitions": {},
  "$schema": "http://json-schema.org/draft-07/schema#",
  "$id": "http://example.com/root.json",
  "type": "object",
  "title": "The Root Schema",
  "additionalProperties": { "type": "string" },
  "required": [
    "stringTest",
    "intTest",
    "boolTest"
  ],
  "properties": {
    "stringTest": {
      "$id": "#/properties/stringTest",
      "type": "string",
      "title": "The Stringtest Schema",
      "default": "",
      "examples": [
        "stringTest"
      ],
      "pattern": "^(.*)$"
    },
    "intTest": {
      "$id": "#/properties/intTest",
      "type": "integer",
      "title": "The Inttest Schema",
      "default": 0,
      "examples": [
        30
      ]
    },
    "boolTest": {
      "$id": "#/properties/boolTest",
      "type": "boolean",
      "title": "The Booltest Schema",
      "default": false,
      "examples": [
        false
      ]
    }
  }
}

Visão Geral das Transações

A página Transações exibe as transações de determinada fila. Ela também mostra seus status, as datas de quando foram processadas, o Robô que as processou e o tipo de exceção gerada ou referência atribuída, se houver.

Você pode pesquisar uma transação específica ou um grupo delas, de acordo com uma referência personalizada, que é adicionada por meio da propriedade Referência das atividades Add Queue Item e Add Transaction Item. A referência pode ser usada para vincular suas transações a outros aplicativos usados em um projeto de automação. Além disso, esse recurso permite que você procure determinadas transações no Orchestrator, de acordo com a referência personalizada fornecida.

As referências de transações também podem ser forçadas a serem exclusivas no nível da fila. Esse recurso é habilitado ao criar a fila e se aplica a todas as transações, exceto aquelas excluídas ou repetidas. Isso facilita a identificação de um item específico e o processo de revisão.

Se uma referência duplicada for encontrada ao adicionar itens a uma fila, o trabalho falha com um status Com falha e exibe a mensagem de erro Execution error: UiPath.Core.Activities.OrchestratorHttpException: Error creating Transaction. Duplicate Reference. na janela Detalhes do trabalho.

Ordem de processamento

Em qualquer fila, as transações são processadas de uma maneira hierarquizada, de acordo com esta ordem:

1. Itens que têm um Prazo, da seguinte maneira:
   • em ordem de Prioridade e
   • de acordo com o Prazo definido para itens com a mesma Prioridade.
2. Itens Sem prazo, em ordem de Prioridade, e
   • de acordo com a regra Primeiro a entrar, primeiro a sair para itens com a mesma Prioridade.

Ao definir um Prazo ou uma data para Adiar , recomendamos preencher os respectivos campos com datas relativas. Por exemplo, DateTime.Now.AddHours(2), DateTime.Now.AddDays(10) e DateTime.Now.Add(New System.TimeSpan(5, 0, 0, 0)). Além disso, você pode usar a notação dos EUA para adicionar um tempo exato, como 10/15/2019 07:40:00. A correção automática dessa data está disponível; por exemplo, se você escrever 15 10 2019 9:0, ela será transformada automaticamente em 15/10/2019 09:00:00.

Prazo é útil para ordenar tarefas com prioridades semelhantes, enquanto Adiar garante que uma tarefa não seja iniciada antes do horário especificado. No entanto, os dois parâmetros não são projetados para serem usados juntos.

As datas adicionadas no Studio para os campos Prazo e Adiar são exibidas no Orchestrator, na página Transações, nas colunas Prazo e Adiar.

Exportação de transações

Você pode exportar todas as transações e informações relacionadas a uma determinada fila para um arquivo .cvs, selecionando o botão Exportar, na página Transações. Todas as opções de filtragem de páginas se aplicam também ao arquivo gerado.

Figura 1. Arquivo CSV

Para garantir o melhor desempenho, observe que as entradas exportadas não estão em ordem cronológica.

Previsões do SLA de fila

Esta ferramenta ajuda você a definir um SLA (prazo do item) para itens recém-adicionados em uma fila. Isso ajuda você a avaliar se podem ser processados em tempo hábil, e quais recursos precisam ser alocados para que seu SLA não seja violado. Sempre que o SLA estiver em perigo de não ser atendido, você é devidamente notificado para que possa fazer ajustes adequadamente.

O SLA se aplica apenas aos itens que não têm um prazo definido, o que significa que um item recém-adicionado sem prazo definido previamente é preenchido automaticamente de acordo com o valor definido como o SLA. Mais especificamente, o prazo de cada item é representado pelo valor definido para o SLA da fila a partir do momento que o item é adicionado na fila. Por exemplo, se eu definir o SLA como 2 horas, e adicionar 3 itens na fila às 4, 5 e 6 PM, então os meus itens têm os prazos de 6, 7 e 8 PM, respectivamente.

O alerta de violação de SLA é disparado a cada 30 minutos, começando 7 minutos após a hora.

Itens que têm um prazo (definido no Studio ou em um arquivo .csv usado para upload) não são afetados pela configuração do SLA.

Importante:

• The Priority of the items added in a queue after enabling SLA predictions is automatically set to High, regardless of how it was set in Studio or in the .csv file used for upload.
• Você não pode excluir um processo associado a uma fila com previsões do SLA habilitadas.
• If at least one queue item exceeds its deadline, Over Capacity is displayed in the Necessary Robots (SLA) column and predictions are no longer calculated.
• As previsões são feitas para itens de fila com prazos para as próximas 24 horas e não levam em consideração as datas de adiamento dos itens.

Disparadores de filas e previsões do SLA são interdependentes em termos de associação entre fila e processo. Portanto, sempre que for configurar um deles, o outro é pré-preenchido, de forma que haja paridade entre as configurações. Suponhamos que eu defina um disparador de fila para a fila Y usar o processo X. As previsões do SLA para a fila Y podem ser feitas apenas usando o processo X e, portanto, X é pré-preenchido e fica em um estado de somente leitura ao habilitar o SLA de fila para Y.

SLA de Risco

Você também pode definir um SLA de Risco para seus itens, que funciona como uma zona de buffer antes do SLA. Mais explicitamente, os prazos de risco dos seus itens são calculados com base no SLA de Risco a partir do momento que o item for adicionado na fila. Suponhamos que eu defina o SLA de Risco como 2 horas, e adicione 3 itens na fila às 4:30, 5:15 e 6:45 PM. Nesse caso, meus itens têm os prazos de risco de 6:30, 7:15 e 8:45 PM, respectivamente.

Após o SLA de Risco ter passado e o item da fila não ser processado, o item corre o risco de não atender ao seu prazo. O usuário é devidamente notificado, para que possa fazer ajustes adequadamente.

Permissões de SLA na Fila

Para poder configurar as previsões do SLA para uma fila, você precisa ter as seguintes permissões:

• Exibir em Processos
• Exibir em Filas
• Editar em Filas (para configurar o SLA ao editar uma fila)
• Criar em Filas (para configurar o SLA ao criar uma fila)