Obter item de transação

UiPath.Core.Activities.GetQueueItem

Description

Obtém um item da fila do Orchestrator para que você possa processá-lo (iniciar a transação) e define seu status como Em Andamento. Iniciar o processamento faz dela uma transação

Observe que, para executar esta atividade, a função Robô precisa ter permissões de Editar em filas. A atividade é realizada por meio do Robô que a executa.

Se a fila estiver vazia, o erro a seguir será gerado ao acessar o TransactionItem recuperado: System.Exception: Object reference not set to an instance of an object.

Compatibilidade do projeto

Windows - Legada | Windows | Multiplataforma

Multiplataforma, Configuração do Windows

• 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).

    Observe que barras ao final não são aceitas.

• Nome da fila — a fila onde o objeto QueueItem 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".

  Para gerenciar as filas em suas pastas do Orchestrator, clique em Gerenciar filas.

Opções avançadas

Opções

• Estratégia de filtro — 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.
• 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 30.000 milissegundos (30 segundos).
• 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 prosseguirá mesmo com erros.

Saída

• Item de transação — o item de transação recuperado, armazenado em uma variável QueueItem.

• Dados específicos — essa propriedade fica disponível para filas que têm uma definição de esquema. Permite que você acesse as propriedades do esquema de Conteúdo Específico da fila.

  Se uma nova versão de esquema tiver sido aplicada à fila, clique em Atualizar para recuperar as últimas alterações.

Windows - Configuração legada

Painel de Propriedades

Opções

• 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 prosseguirá mesmo com erros.
• NomeDeExibição - 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 30.000 milissegundos (30 segundos).

Entrada

• Nome da fila — a fila onde o objeto QueueItem 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".

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. Este campo é compatível apenas com valores string, com / como separador para indicar subpastas. Por exemplo "Finance/Accounts Payable".
  Observação:

  O parâmetro 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:

  -right: Caminho que começa com / — começa da pasta root da árvore da qual a pasta ambiente faz parte.

  -right: Caminho que começa com . — começa da pasta do ambiente.

  -right: Caminho que começa com .. — começa um nível acima na hierarquia da pasta do ambiente para cada .. no caminho (por exemplo, ../ para um nível acima, ../../ para dois níveis acima na hierarquia).

  Observe que 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

• Item de transação — o item de transação recuperado, armazenado em uma variável QueueItem.

Referência

• Estratégia de filtro — 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.