Get Jobs

Atividade Get Jobs que recupera uma lista de trabalhos do Orchestrator de acordo com um filtro personalizado, usando a API do Orchestrator.

UiPath.Core.Activities.GetJobs

Description

Recupera uma lista de trabalhos do Orchestrator de acordo com um filtro personalizado, usando a API do Orchestrator. Você também pode especificar o número de trabalhos a serem ignorados e/ou o número máximo de trabalhos a serem recuperados. Observe que, para executar esta atividade no Studio, o Robô deve estar conectado ao Orchestrator. A atividade é realizada por meio do Robô que a executa. Consulte a nota Permissões do Orchestrator abaixo para obter as permissões exatas necessárias.

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:

• Jobs.View: usado para ler o estado do trabalho
• Folders.View: usado para navegar e selecionar a pasta do Orchestrator

Compatibilidade do Projeto

Windows - Legada | Windows | Multiplataforma

Configuração multiplataforma

• Caminho da pasta do Orchestrator — o caminho da pasta da qual os trabalhos devem ser recuperados, 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 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.

• Filtro — especifica o filtro OData para o recebimento de trabalhos (ou seja CreationTime gt 2017-01-01T00:03:08.93Z e State eq 'Running'). Para obter mais referências, consulte a Documentação do OData. Essa propriedade aceita apenas strings ou variáveis String . Quando o filtro for usado em vez de uma expressão, você poderá configurá-lo usando o assistente disponível.

Configuração do Windows

• Caminho da pasta do Orchestrator — o caminho da pasta da qual os trabalhos devem ser recuperados, 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 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.

• Filtro — especifica o filtro OData para o recebimento de trabalhos (ou seja CreationTime gt 2017-01-01T00:03:08.93Z e State eq 'Running'). Para obter mais referências, consulte a Documentação do OData. Essa propriedade aceita apenas strings ou variáveis String . Clicar no campo abre a janela Assistente de Filtro.

Opções avançadas

Diversos

• Skip - Helps you skip the first "n" jobs. This property supports only integers and integer variables.
• Superior — retorna apenas um número especificado de trabalhos do total. O valor máximo é 100. Essa propriedade aceita apenas números inteiros e variáveis Integer.
• 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 é 300.000 milissegundos (5 minutos). 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 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.

Saída

• Trabalhos — os trabalhos recuperados, como uma variável IEnumerable<OrchestratorJobs>.

Configurando o assistente

O assistente permite que você crie facilmente um filtro usado para recuperar trabalhos do Orchestrator.

As seguintes entidades estão disponíveis:

• Chave - A chave de trabalho do Orchestrator.

  • Pode ser definido como Igual ou Não igual a uma string ou variável específica.

• HoraDeInício - A hora de início do trabalho do Orchestrator.

  • Pode ser definido como Mais recente ou mais antigo que uma data/hora/hora específica.

• HoraDeTérmino - A hora de término do trabalho do Orchestrator.

  • Pode ser definido como Mais recente ou mais antigo que uma data/hora/hora específica.

• Estado - O estado do trabalho do Orchestrator .

  • Pode ser definido como Igual ou Diferente de ser igual a um dos seguintes valores:
    • Com falha
    • Pendente
    • Retomado
    • Em execução
    • Interrompido
    • Parando
    • Bem-sucedido
    • Suspenso
    • Terminando

• Prioridade — a prioridade do trabalho do Orchestrator.

  • Pode ser definido como Igual ou Diferente de ser igual a um dos seguintes valores:

    • Alta
    • Baixa
    • Normal

    Níveis de prioridade mais granulares, do Mais Baixo ao Crítico, também estão disponíveis para uma filtragem mais granular.

• HoraDeCriação - A hora de criação do trabalho do Orchestrator.

• • Pode ser definido como Mais recente ou mais antigo que uma data/hora/hora específica.

• Nome da versão

• • Pode ser definido como uma das seguintes opções:
    • Contém
    • Ends With
    • É igual a
    • Not Contains
    • Not Equals
    • Starts With

  

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 é 300.000 milissegundos (5 minutos). A abertura de uma conexão com o Orchestrator é sempre limitada a 30 segundos, independentemente desse valor.

Entrada

• Filtro — especifica o filtro OData para o recebimento de trabalhos (ou seja CreationTime gt 2017-01-01T00:03:08.93Z e State eq 'Running'). Para obter mais referências, consulte a Documentação do OData. Essa propriedade aceita apenas strings ou variáveis String .

Diversos

• Caminho da pasta — o caminho da pasta da qual os trabalhos devem ser recuperados, 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 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

• Trabalhos — os trabalhos recuperados, como uma variável IEnumerable<OrchestratorJobs>.

Paginação

• Skip - Helps you skip the first "n" jobs. This property supports only integers and integer variables.
• Superior — retorna apenas um número especificado de trabalhos do total. O valor máximo é 100. Essa propriedade aceita apenas números inteiros e variáveis Integer.