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

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.

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, que pode ser alterado ou removido 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 Solicitações de revisão.

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á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).
• Seus esquemas não devem conter uma matriz.
• Para fins de validação, DateTime é aceito como tipo string .
• O uso e validação de um esquema de Dados da análise requer Robôs e Atividades da versão 19.10 ou superior.
• 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:

Para obter um melhor controle em termos de desempenho do Orchestrator, o tamanho de Dados específicos dos itens de fila é limitado a 1 MB, com a ajuda da configuração do aplicativo Queue.MaxSpecificDataSizeInKiloBytes. Qualquer coisa além desse limite não pode ser adicionada a uma fila e gera o código de erro 403 — Payload Too Large. Se você precisar carregar itens maiores, armazene os dados em maior quantidade em um armazenamento externo e referencie apenas o link no 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.
• Comentários - permite que você veja e adicione comentários relacionados a transações caso precise compartilhar informações sobre uma transação específica com seus colegas de equipe. Todos os usuários com permissões de Visualizar, Editar e Excluir em filas e transações podem adicionar, editar ou remover comentários respectivamente, no entanto, tenha em mente que você pode fazer alterações apenas nos seus próprios comentários.
• Histórico - possibilita a você 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

Você pode exportar todas as transações e informações relacionadas a uma determinada fila para um 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 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 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 do SLA é acionado a cada 30 minutos, a partir de 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 via o arquivoUiPath.Orchestrator.dll.config .

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:

• A prioridade dos itens adicionados em uma fila após habilitar as previsões do SLA é definida automaticamente como Alta, independentemente de como ela tenha sido definida no Studio ou no arquivo .csv usado para o upload.
• Você não pode excluir um processo associado a uma fila com previsões do SLA habilitadas.
• Se pelo menos um item da fila exceder seu prazo, Capacidade Excedida é exibida na coluna Robôs Necessários (SLA) e as previsões não são mais calculadas.
• As previsões são feitas para itens de fila com prazos nas próximas 24 horas (pode ser alterado usando o parâmetro Queue.SlaReadaheadTimeLimitHours) 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)