Wait Queue Item

Atividade Wait Queue Item, que recupera um item de fila do Orchestrator de uma fila especificada e o armazena em uma variável QueueItem.

UiPath.Core.Activities.WaitQueueItem

Description

Recupera um item de fila do Orchestrator de uma fila especificada e o armazena em uma variável QueueItem . Esta atividade é diferente da atividade Get Transaction Item , pois em tempo de execução, caso a fila especificada esteja vazia, ele envia uma mensagem ao Orchestrator informando que está pronto para receber um item da fila e, em seguida, aguarda a inclusão de um novo item na fila. a fila especificada. Depois de recuperado, o status do item da fila é definido como Em progresso.

Observação:

Permissões do Orchestrator

Essa atividade é executada na conta do Orchestrator do robô que a executa. Ele deve conter as seguintes permissões de função do Orchestrator na pasta de destino:

• Queues.View: usado para resolver a fila de destino
• Transactions.View: usado para ler itens de fila e dados de transação
• Transactions.Create: usado para criar o item da fila ou iniciar sua transação
• Transactions.Edit: usado para atualizar ou bloquear a transação
• Folders.View: usado para navegar e selecionar a pasta do Orchestrator

Compatibilidade do projeto

Windows - Legada | Windows | Multiplataforma

Windows, configuração multiplataforma

• Caminho da pasta do Orchestrator - O caminho da pasta na qual a fila especificada está localizada, caso seja diferente da pasta na qual o processo está sendo executado. Esse campo é compatível apenas com valores string, com / como separador para indicar subpastas. Por exemplo "Finance/Accounts Payable".

  Observação:

  O parâmetro Orchestrator FolderPath não funciona para processos executados por robôs em pastas clássicas. Apenas robôs em pastas modernas têm a capacidade de passar dados para fora de sua pasta. Os caminhos de pastas relativos são suportados em um cabeçalho X-UIPATH-FolderPath-Encoded , da seguinte forma:

  • Caminho que começa com / - começa na pasta root da árvore da qual a pasta Ambiente faz parte.
  • Caminho que começa com / - começa na pasta root da árvore da qual a pasta Ambiente faz parte.
  • Caminho que começa com . - começa na pasta Ambiente.
  • Caminho começa com .. - começa um nível acima na hierarquia da pasta Ambiente para cada .. no caminho (por exemplo, ../ para um nível acima, ../../ para dois níveis acima na hierarquia).

  Barras ao final não são aceitas.

• Nome da fila — o nome da fila onde você deseja pesquisar o item da fila. Esse campo é compatível apenas com strings e variáveis String.

  Observação:

  Para que a atividade Wait Queue Item utilize o método de comunicação em tempo real do Robô, a versão do pacote de atividades System e a versão do Orchestrator precisam ser ambas mais antigas que a v20.10 ou ambas mais recentes que a v20.10. Caso contrário, a atividade Wait Queue Item não utiliza o método de comunicação em tempo real do Robô e tem um atraso máximo igual à duração de um intervalo de pulsação. A duração padrão de um intervalo de pulsação é de 30 segundos e pode ser configurada no Orchestrator.

¹Para projetos multiplataforma criados no Studio Web como parte de uma solução, o campo Caminho da pasta do Orchestrator está indisponível. Se a atividade tinha um caminho de pasta antes de se tornar parte da solução, o campo será exibido como somente leitura, e essa pasta substituirá o recurso da solução. Selecionar o recurso novamente removerá a pasta.

²Para projetos multiplataforma criados no Studio Web como parte de uma solução, o campo nome fornece opções para Definir novos recursos do Orchestrator, como filas, ativos ou buckets de armazenamento, durante o período de design, ou Abrir o Orchestrator para gerenciamento de recursos.

Opções avançadas

Opções

• PollTime (milissegundos) — especifica a quantidade de tempo (em milissegundos) entre duas tentativas para recuperar um novo item. O valor padrão é de 30.000 milissegundos (30 segundos).
• Estratégia de filtro — a estratégia para usar ao filtrar de acordo com a referência. Este campo aceita um valor literal ou uma expressão. As seguintes opções estão disponíveis:
  • ComeçarCom — procura itens cujas referências começam com o valor indicado no campo Referência.
  • Iguais — procura itens cujas referências são as mesmas que o valor indicado no campo Referência.
• Referência — filtra itens de acordo com sua referência. A expressão não pode exceder 128 caracteres nem conter aspas simples '.
• Tempo limite (milissegundos) — especifica a quantidade de tempo (em milissegundos) para aguardar que a atividade seja executada antes de gerar um erro. O valor padrão é de 300.000 milissegundos (300 segundos). A abertura de uma conexão com o Orchestrator é sempre limitada a 30 segundos, independentemente desse valor.
• Continuar com erro - Especifica se a automação deve continuar mesmo quando a atividade gera um erro. Este campo só aceita valores booleanos (True, False). O valor padrão é False. Como resultado, se o campo não estiver configurado e ocorrer um erro, a execução do projeto será interrompida. Se o valor for definido como True, a execução do projeto continua independentemente de qualquer erro.
• Converter datas para hora local - Quando ativado, as datas no item da fila retornado ( prazo, data de adiamento, início da transação e última hora de processamento) são convertidas de UTC para a hora local da máquina do robô. Quando deixado vazio, a configuração do projeto Converter datas para hora local em Configurações do projeto > Sistema > Filas se aplica. Essa configuração está ativada por padrão para novos projetos e desativada para projetos criados com uma versão anterior do pacote do sistema, portanto, os fluxos de trabalho existentes continuam recebendo valores de UTC. As configurações do projeto para filas estão disponíveis em projetos do Windows.

Saída

• Resultado — o item da fila recuperado, armazenado em uma variável QueueItem.

Windows - Configuração legada

Painel de Propriedades

Comum

• Continuar com erro - Especifica se a automação deve continuar mesmo quando a atividade gera um erro. Este campo só aceita valores booleanos (True, False). O valor padrão é False. Como resultado, se o campo estiver em branco e um erro for lançado, a execução do projeto será interrompida. Se o valor for definido como True, a execução do projeto continua independentemente de qualquer erro.
• DisplayName - O nome de exibição da atividade.
• Tempo limite (milissegundos) — especifica a quantidade de tempo (em milissegundos) para aguardar que a atividade seja executada antes de gerar um erro. O valor padrão é de 300.000 milissegundos (300 segundos). A abertura de uma conexão com o Orchestrator é sempre limitada a 30 segundos, independentemente desse valor.
  Observação:

  Para que a atividade Wait Queue Item utilize o método de comunicação em tempo real do Robô, a versão do pacote de atividades System e a versão do Orchestrator precisam ser ambas mais antigas que a v20.10 ou ambas mais recentes que a v20.10. Caso contrário, a atividade Wait Queue Item não utiliza o método de comunicação em tempo real do Robô e tem um atraso máximo igual à duração de um intervalo de pulsação. A duração padrão de um intervalo de pulsação é de 30 segundos e pode ser configurada no Orchestrator.

Entrada

• PollTime (milissegundos) — especifica a quantidade de tempo (em milissegundos) entre duas tentativas para recuperar um novo item. O valor padrão é de 30.000 milissegundos (30 segundos).
• Nome da fila — o nome da fila onde você deseja pesquisar o item da fila. Esse campo é compatível apenas com strings e variáveis string.

Diversos

• Caminho da pasta — o caminho da pasta onde a fila especificada está localizada, caso seja diferente da pasta onde o processo está sendo executado. Esse campo é compatível apenas com valores string, com / como separador para indicar subpastas. Por exemplo "Finance/Accounts Payable".

  Observação:

  O parâmetro Folder Path não funciona para processos executados por robôs em pastas clássicas. Apenas robôs em pastas modernas têm a capacidade de passar dados para fora de sua pasta. Os caminhos de pastas relativos são suportados em um cabeçalho X-UIPATH-FolderPath-Encoded , da seguinte forma:

  • Caminho que começa com / - começa na pasta root da árvore da qual a pasta Ambiente faz parte.
  • Caminho que começa com / - começa na pasta root da árvore da qual a pasta Ambiente faz parte.
  • Caminho que começa com . - começa na pasta Ambiente.
  • Caminho começa com .. - começa um nível acima na hierarquia da pasta Ambiente para cada .. no caminho (por exemplo, ../ para um nível acima, ../../ para dois níveis acima na hierarquia).

  Barras ao final não são aceitas.

• Privado - Se selecionado, os valores de variáveis e argumentos não são mais registrados no nível Verbose.

Saída

• Resultado — o item da fila recuperado, armazenado em uma variável QueueItem.

Referência

• EstratégiaDeFiltro — a estratégia para usar ao filtrar de acordo com a referência. As seguintes opções estão disponíveis:
  • ComeçarCom — procura itens cujas referências começam com o valor indicado no campo Referência.
  • Iguais — procura itens cujas referências são as mesmas que o valor indicado no campo Referência.
• Referência — filtra itens de acordo com sua referência. A expressão não pode exceder 128 caracteres nem conter aspas simples '.