UiPath Documentation
action-center
2025.10
true
Importante :
A tradução automática foi aplicada parcialmente neste conteúdo. A localização de um conteúdo recém-publicado pode levar de 1 a 2 semanas para ficar disponível.
UiPath logo, featuring letters U and I in white

Guia do usuário do Action Center

Última atualização 29 de abr de 2026

Add Queue Item And Get Reference

UiPath.Persistence.Activities.Queue.AddQueueItemAndGetReference

Description

Adiciona um item de fila do Orchestrator com parâmetros e recupera o objeto do item de fila correspondente, armazenado em uma variável QueueItemData, para aguardar a conclusão da transação a qualquer momento durante a execução do fluxo de trabalho.

Compatibilidade do projeto

Windows - Legada | Windows | Multiplataforma

Windows, Windows - configuração herdada

Painel do Designer

  • Nome da fila — a fila onde o objeto ItemNaFila deve ser adicionado. O nome não diferencia maiúsculas de minúsculas, o que significa que, se no Orchestrator foi definido como "MyFirstQueue", corresponderá a "myfirstqueue". O número máximo de caracteres é 50.
  • Prioridade — o nível de prioridade do item da fila que é adicionado. Esta propriedade é um critério para a priorização de itens da fila, assim como Data de conclusão e Data de adiamento.
  • InformaçõesDoItem — uma coleção de informações adicionais sobre o ItemNaFila específico a ser adicionado. As informações são armazenadas no item e usadas durante o processamento da transação. É recomendável usar apenas valores primitivos dos seguintes tipos: Número, Booleano, String e Data/Hora. O valor dos argumentos de string não pode conter os seguintes caracteres: [ e " ". Os nomes de argumentos não podem conter os seguintes caracteres: :, ., ,, @, ".
  • Item da fila (Saída) — o objeto da fila que é retornado do Orchestrator como um objeto QueueItemData após a fila ser criada. Este objeto pode ser passado para a atividade Wait for Queue Item and Resume para suspender a execução do fluxo de trabalho até que a transação seja concluída.

Painel de Propriedades

Comum

  • ContinuarComErro — 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 prosseguirá mesmo com erros.
Observação:

Se esta atividade estiver incluída em Try Catch e o valor da propriedade Continuar com erro for Verdadeiro, nenhum erro será capturado quando o projeto for executado.

  • DisplayName - O nome de exibição da atividade.
  • TempoLimiteEmMs - Especifica o período de tempo (em milissegundos) para aguardar que a atividade seja executada antes de gerar um erro. O valor padrão é de 30.000 milissegundos (30 segundos).

Entrada

  • Prazo — o carimbo de data/hora antes do qual o item de fila deve ser processado. Esta propriedade pode ser preenchida com carimbos de data/hora como 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 12/10/2017 07:40:00. A correção automática para essa data está disponível. Por exemplo, se você escrever 8 9 2018 9:0, ela será corrigida automaticamente para 08/09/2018 09:00:00.
  • Caminho da pasta do Orchestrator — o caminho para uma pasta do Orchestrator diferente daquele no qual o processo atual opera, onde você deseja criar o item de fila. Para ler mais sobre pastas do Orchestrator, acesse aqui. Para pastas Clássicas , essa propriedade só pode ser usada com Floating Robots e apenas se o usuário atual tiver o privilégio de tarefa correto na pasta de destino. Para pastas Modernas , a substituição do caminho da pasta não é compatível. Esse campo é compatível apenas com strings e variáveis String .
Observação:

A propriedade FolderPath deve ser usada apenas se o item de fila precisar ser criado ou consultado de uma pasta diferente da atual. Se o usuário executando essa ação não tiver as permissões necessárias para a pasta de destino, a criação do item de fila falhará e gerará um erro crítico. Você pode ver mais informações sobre permissões de pastas aqui.

  • InformaçõesDoItem — uma coleção de informações adicionais sobre o ItemNaFila específico a ser adicionado. As informações são armazenadas no item e usadas durante o processamento da transação. É recomendável usar apenas valores primitivos dos seguintes tipos: Número, Booleano, String e Data/Hora. O valor dos argumentos de string não pode conter os seguintes caracteres: [ e " ". Os nomes de argumentos não podem conter os seguintes caracteres: :, ., ,, @, ".
  • ColeçãoDeInformaçõesDoItem — habilita a importação de um dicionário inteiro de informações para um item da fila. Este campo aceita apenas variáveis Dictionary<string, object> .
  • Adiar — o carimbo de data/hora após o qual o item de fila pode ser processado. Esta propriedade é um critério para a priorização de itens de fila, assim como Prioridade e Data de conclusão. Esta propriedade pode ser preenchida com carimbos de data/hora como 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 US para adicionar uma hora exata, como 12/10/2017 07:40:00. A correção automática para essa data está disponível. Por exemplo, se você escrever 8 9 2018 9:0, ela será corrigida automaticamente para 08/09/2018 09:00:00.
  • Prioridade — o nível de prioridade do item da fila que é adicionado. Esta propriedade é um critério para a priorização de itens da fila, assim como Data de conclusão e Data de adiamento.
  • Nome da fila — a fila onde o objeto ItemNaFila deve ser adicionado. O nome não diferencia maiúsculas de minúsculas, o que significa que, se no Orchestrator foi definido como "MyFirstQueue", corresponderá a "myfirstqueue". O número máximo de caracteres é 50.
  • Reference - The reference of the Queue Item that is added. The reference can be used to link your transactions to other applications used within an automation project. Additionally, this feature enables you to search for certain transactions, in Orchestrator, according to the provided string.

Diversos

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

Saída

  • Item da fila (Saída) — o objeto da fila que é retornado do Orchestrator como um objeto QueueItemData após a fila ser criada. Este objeto pode ser passado para a atividade Wait for Queue Item and Resume para suspender a execução do fluxo de trabalho até que a transação seja concluída.

Configuração multiplataforma

  • Nome da fila — a fila onde o objeto ItemNaFila deve ser adicionado. O nome não diferencia maiúsculas de minúsculas, o que significa que, se no Orchestrator foi definido como "MyFirstQueue", corresponderá a "myfirstqueue". O número máximo de caracteres é 50.
  • Prioridade — o nível de prioridade do item da fila que é adicionado. Esta propriedade é um critério para a priorização de itens da fila, assim como Data de conclusão e Data de adiamento.
  • InformaçõesDoItem — uma coleção de informações adicionais sobre o ItemNaFila específico a ser adicionado. As informações são armazenadas no item e usadas durante o processamento da transação. É recomendável usar apenas valores primitivos dos seguintes tipos: Número, Booleano, String e Data/Hora. O valor dos argumentos de string não pode conter os seguintes caracteres: [ e " ". Os nomes de argumentos não podem conter os seguintes caracteres: :, ., ,, @, ".
  • Item da fila (Saída) — o objeto da fila que é retornado do Orchestrator como um objeto QueueItemData após a fila ser criada. Este objeto pode ser passado para a atividade Wait for Queue Item and Resume para suspender a execução do fluxo de trabalho até que a transação seja concluída.

Opções avançadas

Comum

  • ContinuarComErro — 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 prosseguirá mesmo com erros.
Observação:

Se esta atividade estiver incluída em Try Catch e o valor da propriedade Continuar com erro for Verdadeiro, nenhum erro será capturado quando o projeto for executado.

  • DisplayName - O nome de exibição da atividade.
  • TempoLimiteEmMs - Especifica o período de tempo (em milissegundos) para aguardar que a atividade seja executada antes de gerar um erro. O valor padrão é de 30.000 milissegundos (30 segundos).

Entrada

  • Prazo — o carimbo de data/hora antes do qual o item de fila deve ser processado. Esta propriedade pode ser preenchida com carimbos de data/hora como 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 12/10/2017 07:40:00. A correção automática para essa data está disponível. Por exemplo, se você escrever 8 9 2018 9:0, ela será corrigida automaticamente para 08/09/2018 09:00:00.
  • CaminhoDaPastaDoOrchestrator — o caminho para uma pasta do Orchestrator diferente daquele no qual o processo atual opera, onde você deseja criar o item de fila. Para ler mais sobre pastas do Orchestrator, acesse aqui. Para pastas Clássicas , essa propriedade só pode ser usada com Floating Robots e apenas se o usuário atual tiver o privilégio de tarefa correto na pasta de destino. Para pastas Modernas , a substituição do caminho da pasta não é compatível. Esse campo é compatível apenas com strings e variáveis String .
Observação:

A propriedade FolderPath deve ser usada apenas se o item de fila precisar ser criado ou consultado de uma pasta diferente da atual. Se o usuário executando essa ação não tiver as permissões necessárias para a pasta de destino, a criação do item de fila falhará e gerará um erro crítico. Você pode ver mais informações sobre permissões de pastas aqui.

  • ColeçãoDeInformaçõesDoItem — habilita a importação de um dicionário inteiro de informações para um item da fila. Este campo aceita apenas variáveis Dictionary<string, object> .
  • Adiar — o carimbo de data/hora após o qual o item de fila pode ser processado. Esta propriedade é um critério para a priorização de itens de fila, assim como Prioridade e Data de conclusão. Esta propriedade pode ser preenchida com carimbos de data/hora como 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 US para adicionar uma hora exata, como 12/10/2017 07:40:00. A correção automática para essa data está disponível. Por exemplo, se você escrever 8 9 2018 9:0, ela será corrigida automaticamente para 08/09/2018 09:00:00.
  • Priority - The priority level of the Queue Item that is added. This property is a criterion for prioritizing queue items, alongside Due Date and Defer Date.
  • Nome da fila — a fila onde o objeto ItemNaFila deve ser adicionado. O nome não diferencia maiúsculas de minúsculas, o que significa que, se no Orchestrator foi definido como "MyFirstQueue", corresponderá a "myfirstqueue". O número máximo de caracteres é 50.
  • Reference - The reference of the Queue Item that is added. The reference can be used to link your transactions to other applications used within an automation project. Additionally, this feature enables you to search for certain transactions, in Orchestrator, according to the provided string.

Esta página foi útil?

Conectar

Precisa de ajuda? Suporte

Quer aprender? Academia UiPath

Tem perguntas? Fórum do UiPath

Fique por dentro das novidades