Sobre trabalhos

Observação: para dominar os trabalhos, é necessário entender como os processos funcionam. Saiba mais sobre argumentos de runtime, tipos de processos e compatibilidade de processos.

Um trabalho representa a execução de um processo em um UiPath Robot. É possível iniciar a execução de um trabalho no modo assistido ou não assistido. Você não pode iniciar um trabalho a partir do Orchestrator em robôs assistidos, exceto para fins de depuração ou desenvolvimento.

Os trabalhos assistidos podem ser disparados a partir do UiPath Assistant ou da interface de linha de comando do Robô. Os trabalhos não assistidos serão iniciados a partir do Orchestrator, ou no local da página Trabalhos ou Processados, ou de uma maneira planejada previamente por gatilhos, na página Gatilhos.

A página Trabalhos representa a central de controle de trabalhos, na qual você pode monitorar trabalhos iniciados, ver seus detalhes e logs e interromper/encerrar/retomar/reiniciar um trabalho.

A tabela a seguir contém descrições de campos para a página TRabalhos.

Observação: alguns dos campos não são relevantes para todos os tipos de trabalhos. Na página Trabalhos, se um campo não se aplicar a um determinado tipo de trabalho, seu valor será exibido como N/A para trabalhos desse tipo.

Campo	Description
Processo	O nome do processo. [Remote debugging job] é exibido para tarefas iniciadas no Studio por meio de sessões de depuração remota .
Tipo de execução	O tipo de execução, dependendo de onde a execução ocorre e se o robô se passa por um usuário ou não: Unattended - A execução acontece em um servidor e o robô não se passa por um usuário. Os trabalhos são iniciados a partir do Orchestrator. Remoto pessoal — a execução acontece em um servidor e o robô é executado na identidade do proprietário de um espaço de trabalho pessoal. Os trabalhos são iniciados a partir do Orchestrator. Assistido – A execução acontece na máquina pessoal de um usuário. Os trabalhos são iniciados a partir do Assistant. Desenvolvimento – A execução acontece em um servidor. Os trabalhos serão iniciados a partir do Studio por depuração remota.
Estado	O estado do trabalho. Veja detalhes sobre estados do trabalho .
Iniciou	A quantidade relativa de tempo desde o início da execução do trabalho. Passar o mouse sobre este campo exibe a hora e a data de início exatas.
Terminado	A quantidade de tempo relativa desde o término da execução do trabalho. Passar o mouse sobre isso exibe a hora e a data de término exatas.
Iniciado (absoluto) (*)	A quantidade de tempo absoluta desde o início da execução do trabalho. Os carimbos de data/hora absolutos são renderizados no fuso horário do tenant. Para gatilhos, o próximo tempo de execução é renderizado no fuso horário do gatilho, que pode ser diferente daquele do tenant.
Terminado (absoluto) (*)	A quantidade de tempo absoluta desde o término da execução do trabalho. Os carimbos de data/hora absolutos são renderizados no fuso horário do tenant. Para gatilhos, o próximo tempo de execução é renderizado no fuso horário do gatilho, que pode ser diferente daquele do tenant.
Duration	A duração do trabalho, calculada como o intervalo entre a hora de início e a hora em que o trabalho atingiu um estado final.
Origem	O agente da execução. Manual — o trabalho foi iniciado a partir do Orchestrator. Gatilho de tempo - O trabalho foi iniciado por um gatilho de tempo cujo nome é exibido na coluna Origem. Gatilho de fila - O trabalho foi iniciado por um gatilho de fila cujo nome é exibido na coluna Origem. Gatilho de evento - O trabalho foi iniciado por um gatilho de evento cujo nome é exibido na coluna Origem. Gatilho de API - O trabalho foi iniciado por um gatilho de API cujo nome é exibido na coluna Origem. Assistant — o trabalho foi iniciado pelo UiPath Assistant. Studio - O trabalho foi iniciado para fins de depuração a partir do Studio. Aplicativos - O trabalho foi iniciado por meio de um aplicativo.
Tempo de Criação (*)	A hora relativa da criação do trabalho.
Tempo de criação (absoluto) (*)	O tempo absoluto da criação do trabalho.
Prioridade	A prioridade do trabalho. Veja detalhes sobre prioridades do trabalho .
Interação do usuário	Especifica se o processo subjacente requer interação do usuário: Obrigatório: indica um processo em primeiro plano que requer interação do usuário. Não obrigatório: indica um processo em segundo plano que não requer interação do usuário.
Máquina (*)	O objeto da máquina usado para conectar a infraestrutura de execução ao Orchestrator.
Nome do host(*)	O nome da estação de trabalho usada para execução.
Identidade do host(*)	A identidade na qual a execução será realizada. Os seguintes valores são possíveis: <Domain\Username> – Trabalhos executados nessa conta específica. Exibido nos seguintes casos: trabalhos em primeiro plano independentemente da versão do Robô; todos os trabalhos executados em robôs anteriores a outubro de 2021; Trabalhos assistido executados em robôs conectados usando uma chave da máquina, sem logon do usuário. Para Robôs mais antigos que a versão 2021.10, a identidade do host é preenchida dinamicamente de acordo com as configurações de conta feitas no Orchestrator. Alterar o domain\username para a conta usada para executar um trabalho também altera a identidade do host. ROOT - tarefas em segundo plano executadas em robôs Linux . NT AUTHORITY\LOCAL SERVICE - Trabalhos executados sob a identidade de serviço do Robô. Exibido para trabalhos em segundo plano executados em Robôs posteriores a outubro de 2021 sem credenciais. Os robôs em modo de serviço são executados sob NT AUTHORITY\LOCAL SERVICE. Os robôs no modo de usuário são executados sob uma determinada identidade de usuário. N/A - trabalhos iniciados no Assistente por usuários conectados usando login interativo . Para robôs conectados usando a chave da máquina, sem login do usuário, o <Domain\Username> é exibido.
Tipo de runtime	O tipo de runtime usado para a execução.

(*) Colunas que não são visíveis na grade de trabalhos por padrão. Selecione-os no menu suspenso Colunas .

Mapeamentos de conta-máquina

Ao iniciar um trabalho ou definir um gatilho, você pode definir pares de conta-máquina específicos nos quais a execução será realizada. Os mapeamentos de conta-máquina permitem que você vincule um uso não assistido sob contas específicas a modelos de máquina específicos. Isso proporciona controle granular sobre os destinos de execução de sua automação. Os mapeamentos de conta-máquina podem ser baseados em tenant (não vinculados a uma pasta específica) ou baseados em pasta (vinculados a uma pasta específica).

Saiba como configurar os mapeamentos da conta-máquina.

Destino de Execução

De acordo com o mecanismo usado para iniciar trabalhos no Orchestrator, você pode escolher e configurar uma estratégia de alocação de trabalhos e um destino de execução, implicitamente. Este artigo descreve os destinos das estratégias de alocação e destinos de execução disponíveis ao iniciar trabalhos da página Trabalhos.

Saiba sobre os alvos de execução para gatilhos.

Observação:

Se a execução de seus trabalhos depende de um recurso específico que ainda não está disponível, o trabalho permanece no estado Pendente até as condições para a execução de trabalhos serem atendidas.

Por exemplo, o usuário U1 se conecta ao nome do host H1 usando as credenciais C1. No entanto, as credenciais erradas C2 são inseridas para se conectar ao nome do host. Portanto, o trabalho entra no estado pendente. Se as credenciais forem atualizadas posteriormente para as corretas (ou seja, C1), o trabalho retomará sua execução.

Observação: se o robô deixar de responder (caso a máquina do robô esteja inoperante, ou o Serviço de Robôs da UiPath falhe) durante a execução do trabalho, após a reconexão, ele reinicia a execução dos trabalhos que estavam em execução durante a falha.

1. Alocar de forma dinâmica

A alocação dinâmica sem seleção explícita de conta e máquina permite que você execute um processo em primeiro plano várias vezes sob a conta e a máquina que ficarem disponíveis primeiro. Os processos em segundo plano serão executados em qualquer conta, independentemente de estar ocupada ou não, desde que você tenha runtimes suficientes.

Usando a opção Alocar dinamicamente você pode executar um processo até 10.000 vezes em um trabalho.

2. Selecionar conta válida - mapeamentos de máquinas

Você pode decidir quais pares de conta e máquina específicos executarão o trabalho selecionado.

Para executar vários trabalhos de uma só vez, um para cada par, clique em Adicionar mapeamento de conta-máquina e selecionar os itens desejados nas listas suspensas exibidas.

Depois de terminar, um trabalho Pendente é criado para cada par conta-máquina.

Observação:

Isso só funciona se a opção Habilitar mapeamento de usuário-máquina na guia Geral das configurações de seu tenant estiver selecionada.

3. Conta

O processo será executado sob um usuário ou conta de robô específico. Especificar apenas a conta resulta no Orchestrator alocando a máquina dinamicamente. Especificar a conta e a máquina significa que os trabalhos serão iniciados nesse par de conta-máquina.

4. Máquina

O processo será executado em uma das máquinas do host conectadas ao modelo de máquina selecionado. Especificar o modelo exibe uma opção adicional do Nome do host, permitindo selecionar uma máquina específica do pool de máquinas de host conectadas. Especificar apenas a máquina resulta no Orchestrator alocando a conta dinamicamente. Especificar a conta e a máquina significa que os trabalhos serão iniciados nesse par de conta-máquina.

Certifique-se de que os tempos de execução correspondentes ao tipo de trabalho sejam alocados o modelo da máquina associado. Apenas as máquinas do host conectadas associadas à pasta ativa são exibidas.

5. Agendar o fim da execução de trabalho

A execução do processo pode falhar às vezes, fazendo com que o trabalho permaneça no estado pendente. A alternância permite que você automatize uma estratégia para interromper o trabalho, especificando o tempo que pode passar até que o trabalho seja interrompido ou encerrado. Para abranger o caso de um trabalho que não pode ser interrompido, você tem a opção de encerrá-lo.

6. Manter a alocação conta-máquina na retomada do trabalho

O processo retoma sua execução em qualquer Robot disponível em qualquer máquina disponível por padrão. Manter a mesma configuração de conta-máquina garante um uso otimizado de recursos e dos requisitos da licença.

Importante:

Você precisa provisionar um usuário do Windows para cada conta em uma máquina do host que pertence às pastas às quais o modelo de máquina está atribuído.

Digamos que você conectou um servidor ao Orchestrator usando a chave gerada pelo modelo de máquina, FinanceT. Esse modelo de máquina é atribuído às pastas FinanceExecution e FinanceHR, em que seis contas também estão atribuídas. Essas seis contas precisam ser provisionadas como usuários do Windows no servidor.

Se você configurar um trabalho para executar o mesmo processo várias vezes, uma entrada de trabalho é criada para cada execução. Os trabalhos são ordenados com base em sua prioridade e hora de criação, com os trabalhos mais antigos e de maior prioridade sendo colocados primeiro na fila. Assim que um robô fica disponível, ele executa o próximo trabalho na fila. Até que isso aconteça, os trabalhos permanecem em um estado pendente.

Exemplo

Configuração

• 1 pasta
• 1 modelo de máquina com dois runtimes
• Duas contas: john.smith e petri.ota

• 2 processos que exigem interação do usuário: P1 - que adiciona itens de fila a uma fila, P2 - que processa os itens na fila

  O modelo de máquina e as contas devem estar associados à pasta que contém os processos.

Resultado desejado

• P1 é executado com uma alta prioridade por qualquer um.
• P2 é executado com uma baixa prioridade por Petri.

Configuração necessária do trabalho

• Inicie um trabalho usando P1, sem atribuí-lo a nenhuma conta específica, e defina a prioridade como Alta.
• Inicie um trabalho para P2, atribua-o a petri.ota e defina a prioridade como Baixa.

Prioridade de execução

Você pode controlar qual trabalho tem precedência sobre outros trabalhos concorrentes por meio do campo Prioridade dos trabalhos, seja ao implantar o processo ou ao configurar um trabalho/gatilho para esse processo. Um trabalho pode ter uma das dez prioridades a seguir:

O Orchestrator aloca trabalhos usando a seguinte sequência de etapas:

1. Um robô fica disponível para executar um novo trabalho.
2. O Orchestrator identifica o modelo de máquina atribuído a esse robô e todas as pastas associadas ao modelo.
3. O Orchestrator avalia todos os trabalhos pendentes dessas pastas.
4. O Orchestrator atribui o trabalho com a prioridade mais alta ao robô. Se vários trabalhos tiverem a mesma prioridade, eles serão enviados para o robô em ordem cronológica, do mais antigo para o mais recente.

Observe que os modelos de máquina e máquinas de alta densidade podem executar trabalhos de várias pastas simultaneamente.

Iniciar um trabalho manualmente

O valor padrão do campo Prioridade do trabalho é Herdada, o que significa que a prioridade é herdada de onde foi configurada inicialmente. Você pode deixar isso como está, ou fazer alguma alteração.

• De onde: Página de Automações > Empregos

O trabalho herda a prioridade definida no nível do processo.

• De onde: página Automações > Gatilhos

Se o gatilho tiver a prioridade Herdada, o trabalho herdará a prioridade definida no nível do processo.

Se o gatilho tiver uma prioridade diferente de Herdada, o trabalho herdará a prioridade definida no nível do gatilho. Se ela for alterada para Herdada, a prioridade definida no nível do processo será usada.

• De onde: página Automações > Processos

O trabalho herda a prioridade definida para aquele processo.

Se você configurar um trabalho para executar o mesmo processo várias vezes, uma entrada de trabalho é criada para cada execução. Os trabalhos são ordenados com base em sua prioridade e hora de criação, com os trabalhos mais antigos e de maior prioridade sendo colocados primeiro na fila. Assim que um robô fica disponível, ele executa o próximo trabalho na fila. Até que isso aconteça, os trabalhos permanecem em um estado pendente.

Iniciar um trabalho por meio de um gatilho

A prioridade é definida por padrão como Herdado, o que significa que herda o valor no nível do processo.Escolher um processo atualiza automaticamente o ícone de seta para ilustrar qual valor foi definido no nível do processo. Quaisquer trabalhos iniciados pelo gatilho têm a prioridade definida no nível do gatilho. Se o Herdado padrão for mantido, os trabalhos serão lançados com a prioridade no nível do processo.

Quaisquer alterações subsequentes feitas no nível do processo serão propagadas para o gatilho, e os trabalhos serão criados por meio dele implicitamente.

Configurando a prioridade do trabalho usando a API

Os dez níveis de prioridade disponíveis na interface correspondem a 100 níveis na API, o que significa que a API permite que você defina uma prioridade ainda mais granular. Esses níveis são mapeados da seguinte forma:

Mínimo	Máximo	Padrão
Mais baixa	1	10	5
Muito baixa	11	20	15
Baixa	21	30	25
Média-baixa	31	40	35
Médio	41	50	45
Média-alta	51	60	55
Alta	61	70	65
Muito alta	71	80	75
Mais alta	81	90	85 85
Crítica	91	100	95

Para definir ou alterar a prioridade de um trabalho use o parâmetro SpecificPriorityValue, que está disponível nos seguintes endpoints:

• POST​/odata​/Jobs​/UiPath.Server.Configuration.OData.StartJobs
• POST/odata​/ProcessSchedules
• PUT/odata​/ProcessSchedules({key})

Digamos que você tem dois trabalhos para os quais você definiu uma prioridade de 92 e de 94, respectivamente. Ambos se enquadram no intervalo Crítico, mas o trabalho que tem uma prioridade de 94 será executado antes daquele com uma prioridade de 92.

Observação: Se você iniciar um trabalho que requer intervenção do usuário em vários Robôs na mesma máquina que não é executada no Windows Server, o processo selecionado é executado apenas pelo primeiro Robô, enquanto o resto falha. Uma instância para cada uma dessas execuções é criada e exibida na página Trabalhos.

Trabalhos em Robôs de alta densidade

Se você iniciar um trabalho em vários Robôs de Alta Densidade a partir da mesma máquina do Windows Server, isso significa que o processo selecionado é executado por cada robô especificado ao mesmo tempo. Uma instância para cada uma dessas execuções é criada e exibida na página Trabalhos.

Se você estiver usando robôs de alta densidade e não habilitou o RDP naquela máquina, sempre que iniciar um trabalho, o seguinte erro será exibido: “Uma sessão de logon especificada não existe. Ela pode já ter sido encerrada.” Para saber como configurar sua máquina para Robôs de alta densidade, consulte a página Sobre a configuração do Windows Server para Robôs de alta densidade.

Gravação

Para trabalhos não assistidos com falha, se seu processo tiver a opção Habilitar gravação ativada, você pode baixar a mídia de execução correspondente para verificar os últimos momentos de execução antes da falha.

A opção Baixar gravação é exibida somente na janela Trabalhos se você tiver permissões de Exibir na Mídia de Execução.