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 do 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

As filas permitem que você crie grandes projetos de automação com uma lógica complexa subjacente. Por exemplo, você pode criar um processo que coleta todas as informações de fatura e cria um item de fila para armazenar cada parte desses dados. Na sequência, você pode criar outro processo que coleta as informações do Orchestrator e as usa para executar tarefas adicionais, como pagar as faturas em um aplicativo diferente, adiar seu pagamento de acordo com sua data de vencimento ou valor, enviar e-mails para a equipe de contabilidade sempre que uma conta é paga, etc.

A página Filas permite que você crie novas filas, visualize filas criadas anteriormente e acesse gráficos que exibem o progresso do status da transação ao longo do tempo, juntamente com vários outros detalhes, como o tempo médio de execução e o número total de transações bem-sucedidas.

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.

Item statuses are controlled by RPA developers when they create the automation projects, while revision statuses are controlled in Orchestrator and enable you to perform version control, but only of queue items that have been abandoned or have failed with an application or business exception.

Failed or abandoned items can also be assigned to a reviewer, which an be changed or cleared at any point, if needed. Each of these changes are tracked in the History tab of the Audit Details window. The reviewer is in charge of assessing the current status of the transactions he is assigned to, and changing the review status. The status of queue items up for revision can be changed in the Review Requests page.

Importante:

To ensure that queue item processing is performed successfully, you need to have a unique reference set at the queue level when dequeuing by reference. Failing to keep the reference unique will lead to concurrency access issues, such as failures due to no transaction data being found (No Transaction Data error message).

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álise. 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 1 MB with the help of the Queue.MaxSpecificDataSizeInKiloBytes app setting. 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.

As informações armazenadas em itens da fila serão exibidas no Orchestrator, na janela Detalhes da transação, em Dados específicos. Além disso, se o item falhou e for repetido, o histórico do item será exibido na mesma janela.

A janela Detalhes da transação contém três guias:

• Detalhes - possibilita a você ver as informações exatas adicionadas a uma transação, além dos status que ela teve e o número de vezes em que foi recuperada.
• Comments - enables you to view and add transaction-related comments in case you need to share information about a specific transaction with your teammates. All the users with View,Edit, and Delete permissions on Queues and Transactions can add, edit, or remove comments, respectively, however, keep in mind you can make changes to your own comments only.
• Histórico - permite ver qual ação foi executada por quem, ver quem é o revisor e qual é o status da revisão.

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/10/2019 07:40:00. A correção automática dessa data está disponível; por exemplo, se você escrever 12 10 2019 9:0, ela será transformada automaticamente em 12/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

You can export all the transactions and information related to a given queue to a .csv file, by selecting the Export button, in the Transactions page. All page filtering options apply to the generated file, too.

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.

Observação:

Learn how to configure queue SLA.

Learn how predictions are made and what they mean exactly.

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 um prazo definido tem esse valor definido automaticamente de acordo com o valor definido como 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.

A expressão cron que dita esse intervalo é configurável por meio do parâmetro SystemJobs.QueueSlaAlerting.Cron . No entanto, não recomendamos acionar o alerta com mais frequência do que o padrão se você tiver uma grande quantidade de filas ou itens de fila. Você pode configurar esse parâmetro por meio do UiPath.Orchestrator.dll.config arquivo.

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 nas próximas 24 horas (podem ser alteradas usando o Queue.SlaReadaheadTimeLimitHourse 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)