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.

The data stored in, and output from, Queue items is free form by default. For situations where a specific schema is needed, such as integrations with other applications, processing machine-generated forms, or analytics, you can upload custom JSON schemas to ensure that all Queue item data is in the proper format.

No Orchestrator, as filas recém-criadas são vazias por padrão. Para preenchê-las com itens, você pode usar a funcionalidade de carregamento nas atividades do Orchestrator ou 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. Posteriormente, você pode criar outro processo que colete as informações do Orchestrator e as use 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 for paga etc.

A página Filas habilita você a criar novas filas. Ela também proporciona a você acesso à visualização das filas criadas anteriormente, gráficos com o progresso do status das transações ao longo do tempo e vários outros detalhes, como o tempo de execução médio 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 can 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 they are 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

When creating or editing a queue, you can upload a custom JSON schema for the Specific Data,Output Data, and/or Analytics Data. With the schema(s) in place, all transactions are validated against the provided format, and if the resulting data does not conform, that item fails with a Business Exception.

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.

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 obrigadas a serem exclusivas no nível da fila. Essa funcionalidade é habilitada 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 são exibidas no Orchestrator, na janela Detalhes da transação, em Dados específicos. Além disso, se o item falhar e for recuperado, o histórico do item será exibido na mesma janela.

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 Queue.MaxSpecificDataSizeInKiloBytes parameter. 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 external storage and only reference the link within the item.

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

Dentro de qualquer fila, as transações são processadas hidrarquicamente de acordo com esta ordem:

1. Itens que têm um Prazo, da seguinte maneira:
   1. em ordem de Prioridade e
   2. de acordo com o Prazo definido para itens com a mesma Prioridade.
2. Itens Sem prazo, em ordem de Prioridade, e
   1. 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.

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 arquivo .csv clicando no botão Exportar na página Transações. Todas as opções de filtragem de páginas se aplicam também ao arquivo.

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 a avaliar se eles podem ser processados imediatamente e quais recursos você precisa alocar para que seu SLA não seja violado. Sempre que o SLA estiver em perigo de não ser atendido, você será devidamente notificado, para que possa fazer os ajustes adequados.

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 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 quando o item foi adicionado à 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.

Itens que têm um Prazo (definido no Studio ou em um arquivo .csv usado para o carregamento) 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 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 alterados usando o parâmetro Queue.SlaReadaheadTimeLimitHours em web.config) 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 gatilho de filas para a fila Y usar o processo X. As previsões do SLA para a fila Y só podem ser feitas usando o processo X e, portanto, X é pré-preenchido e fica em um estado somente de leitura ao habilitar o SLA da 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

Para poder configurar as previsões do SLA para uma fila, você precisa das 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)

Carregamento de itens em massa usando um arquivo CSV

Essa funcionalidade permite que você carregue itens da fila em massa em uma fila específica no Orchestrator usando um arquivo .csv. Para fazer isso, primeiro, carregue seu arquivo na sua instância do Orchestrator para uma fila específica. Após o arquivo ser processado com sucesso, os itens contidos nele são carregados na fila de acordo com a estratégia selecionada. Observe que o arquivo deve ser preenchido previamente usando formatos predefinidos para que a operação de upload seja bem-sucedida.

There is a series of predefined column headers that you can use when building your .csv file, but you can also use other custom headers. After successfully uploading the .csv file, the information in columns with predefined headers is mapped to columns as found in Orchestrator. Information in columns with custom headers is placed under the Specific Data section of the corresponding item in Orchestrator.

Observação:

The upload is limited to 15,000 items per file. You can lower the limit using the Upload.Queues.MaxNumberOfItems parameter in the UiPath.Orchestrator.dll.config

.

Mapeamento de colunas

Cabeçalho da coluna do arquivo	Campo do Orchestrator
Referência Obrigatório para filas de referência exclusivas. É compatível com todos os caracteres especiais, exceto aspas duplas - "	Referência References are not compatible with v2016.2 or lower versions of Orchestrator or Robot.
Prazo Deve ser preenchido com uma data em um dos seguintes formatos: DD-MM-AAAA AAAA/MM/DD AAAA MM DD AAAA-MM-DD HH:mm AAAA/MM/DD HH:mm AAAA MM DD HH:mm AAAA-MM-DD HH:mm:ss AAAA/MM/DD HH:mm:ss AAAA MM DD HH:mm:ss	Prazo
Adiar Deve ser preenchido com uma data em um dos seguintes formatos: DD-MM-AAAA AAAA/MM/DD AAAA MM DD AAAA-MM-DD HH:mm AAAA/MM/DD HH:mm AAAA MM DD HH:mm AAAA-MM-DD HH:mm:ss AAAA/MM/DD HH:mm:ss AAAA MM DD HH:mm:ss	Adiar
Prioridade Deve ser preenchido com um dos seguintes valores: Low or 1 Normal or 2 Alta ou 3 Se a prioridade não estiver especificada no arquivo, os itens serão carregados com uma prioridade alta, por padrão.	Prioridade Mapeada para os seguintes valores, respectivamente: Baixa Normal Alta
[Custom_Name] O nome só pode ser composto por caracteres alfanuméricos: 0-9, a-z ou sublinhados.	Dados Específicos Mapeado no formato JSON. Por exemplo: On-Us Check: 5540

Observe que você não pode ter cabeçalhos de colunas vazios em seu arquivo.

Observação:

Os cabeçalhos de colunas predefinidos diferenciam maiúsculas de minúsculas e, portanto, certifique-se de seguir as regras de mapeamento acima. Uma coluna em seu .csv chamada reference é mapeada na seção Dados específicos, em vez da coluna Referência.

Estratégias de carregamento

Há duas estratégias para lidar com o carregamento:

• ProcessAllIndependently - processa todos os itens individualmente e os adiciona à fila, se for bem-sucedido. Caso contrário, retorna uma lista daqueles cujo processamento falhou. Você tem a opção de baixar a lista para um arquivo .csv preenchido com os mesmos campos do arquivo carregado inicialmente.
• AllOrNothing - adiciona os itens apenas se todos eles forem processados com sucesso. Caso contrário, nenhum será adicionado.

Exemplo:

Digamos que você carregue em uma fila o conteúdo do seguinte arquivo .csv. Uma maneira fácil de criar esse arquivo é preencher os dados em um arquivo do Excel e salvá-lo como um arquivo .csv:

Ou você pode baixar um arquivo .csv com todos os cabeçalhos de colunas pré-preenchidos e personalizá-lo de acordo com suas necessidades.

Fazer download do arquivo

Observe que esse arquivo contém três colunas predefinidas, tendo o mesmo nome do Orchestrator (Referência, Prazo e Prioridade, realçadas em verde) e duas colunas personalizadas (Cliente e Cor, realçadas em vermelho).

1. Clique em Carregar itens para a fila desejada e selecione o arquivo .csv. O Orchestrator analisa o arquivo para confirmar se ele atende às regras de formatação.

2. Selecione as estratégias de carregamento desejadas e clique em Carregar para concluir o processo.

   

Selecione Mais ações > Exibir transações para exibir os itens da fila carregados.

The Transactions page displays each item uploaded from your file. The information contained within the file's predefined columns is mapped to the columns with the same name in Orchestrator (Reference,Deadline, and Priority, highlighted in green):

As informações nas colunas personalizadas são mapeadas no formato JSON para a seção Dados específicos de cada item. Clique em Exibir detalhes para o item desejado para vê-lo: