Gerenciamento de trabalhos

Início de um trabalho

Antes de passar pelas etapas abaixo, você precisa criar um processo.

1. Navegue até Automações > Trabalhos na pasta na qual o processo está localizado.
2. Clique em Iniciar. A janela Iniciar trabalho é exibida.
3. No menu suspenso Nome do processo, selecione um processo que foi implantado anteriormente na pasta atual.
4. Configure os campos obrigatórios, conforme descrito nas seções abaixo.
5. Clique em Iniciar. A janela Iniciar trabalho se fecha e, se houver runtimes disponíveis na pasta ativa no momento, o trabalho começa em um robô, de acordo com as configurações que você fez. O Estado do trabalho é exibido em tempo real na página Trabalhos.

Definindo a prioridade do trabalho

No menu suspenso Prioridade dos trabalhos, selecione a prioridade do trabalho a ser executado, se você quiser que ela seja diferente da prioridade definida no nível do processo. Esse campo é preenchido automaticamente com a prioridade herdada do pacote.

Selecionando o tempo de execução da execução

No menu suspenso Tipo de runtime, selecionar o tipo de runtime usado para executar o trabalho.

O número de runtimes disponíveis e conectados é exibido abaixo do menu suspenso.

• _ Disponíveis - A quantidade de runtimes disponíveis, calculada como a quantidade total de runtimes menos a quantidade de trabalhos em execução.

• _ Conectados – A quantidade total de runtimes, calculada como a soma de runtimes em todas as máquinas conectadas ao Orchestrator que estejam associadas à pasta ativa.

  Tipo de runtime	Description
  Produção (Unattended)	O trabalho é executado no modo não assistido, consumindo um runtime não assistido.
  Teste	O trabalho será executado no modo não assistido, consumindo um runtime de teste.
  Não Produtivo	O trabalho será executado no modo não assistido, consumindo um runtime NonProduction.
  Cloud - Serverless Testing	A tarefa é executada em modo autônomo, em uma máquina de robô sem servidor que foi configurada para ser executada em um ambiente de teste. A quantidade de unidades de robô necessárias é específica para ambientes de teste e depende do tamanho da máquina do robô sem servidor e do número de minutos necessários para executar um trabalho. Consulte Robot Units - Consumo para obter mais detalhes.
  Cloud - Serverless	O trabalho é executado no modo Unattended, em uma máquina Serverless Robot que foi configurada para ser executada em um ambiente de produção. A quantidade de Robot Units necessárias é específica para ambientes de produção e depende do tamanho da máquina do Serverless Robot e do número de minutos que leva para executar um trabalho. Consulte Robot Units - Consumo para obter mais detalhes.
  Cloud - VM Testing	A tarefa é executada em modo autônomo, em uma VM em nuvem que foi configurada para ser executada em um ambiente de teste ou não produção. A execução da VM consome as unidades do robô para ambientes de teste. Consulte Robot Units - Consumo para obter mais detalhes.
  Cloud - VM	O trabalho é executado no modo Unattended em uma VM na nuvem que foi configurada para ser executada em um ambiente de produção. A execução da VM consome as Robot Units para ambientes de produção. Consulte Robot Units - Consumo para obter mais detalhes.

Exemplo: digamos que haja dois runtimes NonProduction e um runtime Não assistido no modelo de máquina A, e três runtimes NonProduction e dois runtimes Não assistidos no modelo de máquina B. Ambos estão associados a uma pasta. Em cada modelo, você conecta uma máquina de host. O estado de runtime resultante é o seguinte:

• Não assistido: 3 Available, 3 Connected
• NonProduction: 5 Available, 5 Connected

Um trabalho em execução ocupando um runtime subtrai 1 da quantidade de runtimes disponíveis para esse tipo.

Observação:

No momento da publicação, o Orchestrator escolhe entre os runtimes dos espaços de trabalho disponíveis para executar o trabalho. A precedência dos runtimes é a seguinte:

• Produção (Unattended)
• Não Produtivo

Por exemplo, se não existir nenhum runtime Production, o Orchestrator usará um runtime NonProduction disponível. Se não existir nenhum, o trabalho irá falhar.

Se o runtime selecionado ficar indisponível entre execuções de trabalhos, a próxima execução do trabalho falhará, já que o Orchestrator não procurará o próximo disponível.

Configurando o destino de execução

Configure seu destino de execução definindo as opções abaixo conforme desejado na guia Destino de Execução .

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 essa opção, você pode executar um processo até 10.000 vezes em um trabalho.

Conta

Você pode escolher uma destas abordagens:

• Especificar uma conta significa que o processo será executado sob essa conta específica do usuário ou robô.
• Especificar a conta e a máquina significa que os trabalhos serão iniciados nesse par de conta-máquina. Apenas os pares de conta-máquina válidos ficam disponíveis para seleção.
• Não especificar uma conta resulta na alocação dinâmica da conta pelo Orchestrator.

Máquina

Você pode escolher uma destas abordagens:

• Especificar um objeto de máquina significa que o processo será executado em uma das máquinas do host conectadas ao modelo de máquina selecionado. Selecione uma máquina de host específica do pool de máquinas de host conectadas no campo Máquinas conectadas.
• Especificar a conta e a máquina significa que os trabalhos serão iniciados nesse par de conta-máquina. Apenas os pares de conta-máquina válidos ficam disponíveis para seleção.
• Não especificar uma máquina resulta na alocação dinâmica da máquina pelo Orchestrator.

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.

Selecionar Mapeamentos de conta-máquina válidos

Escolha qual par conta-máquina específico executará o trabalho.

Você pode clicar em Adicionar mapeamento de conta-máquina se você quiser que seu trabalho seja executado em vários desses pares. Se você o fizer, um trabalho Pendente será 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.

Manter a alocação de Conta/Máquina na continuidade do trabalho

Esse campo permite que você configure se os fragmentos diferentes de um trabalho em execução prolongada serão executados no mesmo par de conta-máquina.

Por padrão, um trabalho suspenso será retomado em qualquer robô disponível em qualquer máquina disponível.

Com base em sua licença ou requisitos de recursos, você tem a opção de retomar um trabalho na mesma máquina, e no mesmo contexto da conta que iniciou o trabalho.

Digamos que você precisa de uma licença do SAP para executar um trabalho. Em vez de instalar uma licença do SAP em cada máquina disponível (custo maior), você pode instalá-la em uma única máquina e usar essa máquina para iniciar e retomar o trabalho. A mesma estratégia pode ser aplicada às licenças do usuário. Você pode alocar apenas uma licença de usuário e usá-la para executar o trabalho.

Agendar encerramento da execução do trabalho

A execução do processo pode falhar às vezes, fazendo com que o trabalho permaneça no estado pendente. Ativar a alternância permite que você (clique para expandir):

• Selecionar Interromper no menu suspenso — tenta encerrar normalmente a execução após o intervalo de tempo definido ter passado desde que o trabalho travou em um estado pendente (defina o tempo como um mínimo de 1 minuto, máximo de 10 dias, 23 horas e 59 minutos).
  
  

  

  
  
• Selecionar Encerrar no menu suspenso — tenta encerrar à força a execução após o intervalo de tempo definido ter passado desde que o trabalho travou em um estado pendente (defina o tempo como um mínimo de 1 minuto, máximo de 10 dias, 23 horas e 59 minutos).
  
  

  

  
  
• Selecionar Interromper no menu suspenso e ativar a opção Agendar "Encerramento" automático, se o trabalho não for interrompido — tenta encerrar normalmente a execução após o intervalo de tempo definido ter passado desde que o trabalho parou em um estado pendente e, em seguida, tenta encerrá-lo à força após o intervalo de tempo definido ter passado desde que o trabalho travou em um estado parando (defina o tempo para um mínimo de 1 minuto, máximo de 10 dias, 23 horas e 59 minutos).
  
  

  

  
  

Gerar um alerta se o trabalho travar no status pendente ou retomado

Ao ativar a alternância, você ativa alertas sobre trabalhos que permanecem no status pendente ou retomado por mais tempo do que a duração especificada.

A duração configurável é de no mínimo um minuto e no máximo onze dias.

Se o trabalho exceder a duração configurada, um pop-up de alerta de gravidade de "Erro" informará a você sobre isso com o seguinte texto:

"N jobs para #process {process_number} estão pendentes ou retomados por mais de X horas e Y minutos.", onde:

• N — é o número de trabalhos que acionaram o alerta
• {process_number} - o identificador do processo

• X - o número configurado de horas que o trabalho excedeu enquanto tinha o status Pendente ou Retomado. Os dias são convertidos em horas.

• Y — o número configurado de minutos que o trabalho excedeu enquanto tinha o status pendente ou retomado.

Gerar um alerta se o trabalho tiver sido iniciado e ainda não tiver sido concluído

Ao ativar a alternância, você ativa alertas sobre trabalhos que não foram concluídos na duração especificada.

A duração configurável é de no mínimo um minuto e no máximo onze dias.

Se o trabalho exceder a duração configurada, um pop-up de alerta de gravidade de "Erro" informará a você sobre isso com o seguinte texto:

"Trabalho para o processo número {process_number} está pendente em execução por mais de X horas e Y minutos.", Onde:

• {process_number} - o identificador do processo

• X - o número configurado de horas que o trabalho excedeu enquanto tentava ser concluído. Os dias são convertidos em horas.

• Y - o número configurado de minutos que o trabalho excedeu ao tentar ser concluído.

O Orchestrator impede o início de trabalhos com configurações inválidas. Tentar iniciar um trabalho com uma configuração inválida resulta em uma mensagem de erro descritiva, fornecendo detalhes sobre como corrigir sua configuração.

Iniciar um trabalho usando a alocação dinâmica, ou seja, sem máquina ou conta especificada, com uma configuração de pasta incompatível resulta em um erro. Certifique-se de corrigir a configuração; caso contrário, os trabalhos ficarão no estado Pendente indefinidamente. Por exemplo, tentar executar um trabalho em segundo plano do .NET Framework 4.6.1 quando há apenas modelos de plataforma cruzada na pasta não funciona, pois os trabalhos ficam no estado Pendente até que a configuração seja arrumada.

Adicionando argumentos

Na guia Argumentos, forneça argumentos de entrada para o processo selecionado. Essa aba é preenchida automaticamente com todos os argumentos de entrada aceitos pelo processo selecionado e os valores correspondentes herdados do pacote.

Início de um trabalho por meio de um gatilho de API

Você pode iniciar um trabalho por meio de um gatilho de API de seu aplicativo de terceiros de escolha. Siga estas etapas:

1. Crie um gatilho de API com base no processo que você deseja executar. Isso gera o URL necessário para iniciar o trabalho. Siga as instruções no tópico Criação de um gatilho de API para esse objetivo.
2. Crie um token de acesso pessoal dedicado e conceda acesso aos recursos necessários. Isso é feito no nível da organização, a partir da página Preferências > Token de acesso pessoal. Uma vez salvo, certifique-se de copiar o PAT de uma só vez, pois ele não será exibido novamente.
3. Cole o token de acesso pessoal no campo token de portador para autorizar sua solicitação.
4. Obtenha o URL do trabalho clicando na opção Copiar URL de campo de dados dinâmico completo ao lado do tenant desejado na lista de gatilhos e, em seguida, cole-o em sua ferramenta.
5. Configure seus argumentos conforme necessário.

   Você pode inserir argumentos como:

   Parâmetros de string de consulta

   Para um trabalho com o campo de dados dinâmico hw-process e com os argumentos files e folders, o cURL a ser usado na linha de comando será parecido com o seguinte:

   curl --location --request POST 'https://cloud.uipath.com/{organizationName}/{tenantName}/orchestrator_/t/6ea73196-ca89-446c-81e1-5279bdd36dc2/hw-process?argument1=files&argument2=folders' \
   --header 'Cookie: __cf_bm=_5E_r3oulk6zLCr6.CUij.RFN4lCeTgYMR31gradWtI-1697542233-0-AdP+xhO+SE5PQ6wnoEum5qRu4wzUgGgOrezRhHrR4dcVvhsvl9yV/V3KAFhi/TmomqMtmxc426WT83lDMoL1seQ='

   Dados do Formulário

   Para um trabalho com o campo de dados dinâmico hw-process e com os argumentos files e folders, o cURL a ser usado na linha de comando será parecido com o seguinte:

   curl --location 'https://cloud.uipath.com/{organizationName}/{tenantName}/orchestrator_/t/6ea73196-ca89-446c-81e1-5279bdd36dc2/hw-process' \
   --header 'Cookie: __cf_bm=_5E_r3oulk6zLCr6.CUij.RFN4lCeTgYMR31gradWtI-1697542233-0-AdP+xhO+SE5PQ6wnoEum5qRu4wzUgGgOrezRhHrR4dcVvhsvl9yV/V3KAFhi/TmomqMtmxc426WT83lDMoL1seQ=' \
   --form 'argument1="files"' \
   --form 'argument2="folders"'

   Texto do corpo JSON

   Para um trabalho com o campo de dados dinâmico hw-process e com os argumentos files e folders, o cURL a ser usado na linha de comando será parecido com o seguinte:

   curl --location 'https://cloud.uipath.com/{organizationName}/{tenantName}/orchestrator_/t/6ea73196-ca89-446c-81e1-5279bdd36dc2/hw-process' \
   --header 'Content-Type: application/json' \
   --data '{
       "argument1" = "files"
       "argument2" = "folders"
   }
   '

   Os argumentos também podem ser inseridos por meio de uma combinação dos métodos mencionados acima.

6. Execute o trabalho.

   Dependendo do modo de chamada selecionado na definição de gatilho, o trabalho será executado da seguinte forma:

   • Sondagem assíncrona

   • Disparo assíncrono&esquecer

   • Sincronização (sondagem longa)

   Observe que o modo de chamada pode ser substituído na string ou corpo de consulta usando o parâmetro $callMode.

   Para obter detalhes sobre essas opções, consulte a seção Explicação sobre modos de chamada.

Limitação de taxa

O número de solicitações que podem ser feitas para o ponto de extremidade de status é limitado a 10 por cada 10 segundos para cada trabalho iniciado.

Limite de trabalhos pendente

O número máximo de trabalhos pendentes iniciados por meio de gatilhos de API é 100. Isso pode ser alterado usando a configuração no nível de tenant Gatilhos - Gatilhos de API - Limite máximo de trabalhos pendentes, que tem um valor padrão de 10.

Interrupção de um trabalho

Clique no botão Mais ações correspondente e, depois, em Interromper. O projeto de automação é executado até encontrar uma atividade Should Stop. Durante esse tempo, o trabalho fica no estado Parando. Se a atividade for encontrada, a execução é interrompida, e o status final do trabalho é Sucesso. Se uma atividade Should Stop não for encontrada, a execução do trabalho não para até o final do projeto ser atingido. O status final, neste caso, também será Sucesso.

Observação:

• Um trabalho iniciado a partir do Orchestrator pode ser interrompido apenas do Orchestrator.
• Um trabalho iniciado no Assistant pode ser interrompido tanto no Orchestrator, a partir da página Trabalhos e também usando o UiPath Assistant.
• Quando um trabalho é interrompido, os agendamentos de término do trabalho são perdidos e é necessário reconfigurar as opções de Agendar término da execução do trabalho ao reiniciar o trabalho.

Retomada de um trabalho

Clique no botão Mais ações correspondente e, depois, emRetomar.

Encerramento de um trabalho

Clique no botão More Actions correspondente e, em seguida, Kill. O projeto de automação é interrompido à força, o trabalho é marcado como Paradoe "Trabalho cancelado" é exibido na janela Detalhes do Trabalho .

Observação:

• Um trabalho iniciado a partir do Orchestrator pode ser interrompido no Orchestrator, a partir da página Trabalhos e usando o UiPath Assistant.
• Um trabalho iniciado a partir do Assistant pode ser interrompido no Orchestrator, a partir da página Trabalhos e usando o UiPath Assistant.
• Quando um trabalho é encerrado, os agendamentos de término do trabalho são perdidos e é necessário reconfigurar as opções de Agendar término da execução do trabalho ao reiniciar o trabalho.

Reinício de um trabalho

Essa funcionalidade permite que você execute rapidamente um trabalho da lista de trabalhos, sem passar pela configuração do fluxo do trabalho. Você pode reiniciar qualquer trabalho com um estado final - Parado, Com falha ou Bem-sucedido.

Observação:

• Não é possível reiniciar trabalhos disparados por agentes como o UiPath Assistant ou por meio das sessões de depuração remotas do Studio.
• Ao reiniciar um trabalho que tinha opções de Agendar término da execução do trabalho ativas, é necessário reconfigurar essas opções.

Esse procedimento começa a partir da suposição de que você anteriormente iniciou um trabalho que já atingiu um status final.

1. Clique no botão Mais ações correspondente e, depois, em Reiniciar. A janela Iniciar trabalho é exibida, com as configurações iniciais do trabalho.
2. Faça as alterações desejadas.
3. Clique em Iniciar. A janela Iniciar trabalhos se fecha, e a execução é iniciada. O status de cada trabalho é exibido, em tempo real, na página Trabalhos.

Exibição de detalhes do trabalho

Observação:

• Enquanto o painel lateral estiver aberto, você pode clicar em qualquer trabalho na lista para exibir seus detalhes específicos, para todas as guias incluídas no painel. A grade da lista de trabalhos pode ser rolada horizontalmente, com a coluna Processo permanecendo fixa, se necessário para seu tamanho e resolução de tela específicos. Observe que você pode aumentar o tamanho de algumas colunas, o que fará com que uma barra de rolagem seja exibida para facilitar o acesso.

• Você pode clicar no ícone de expansão no canto superior direito de qualquer guia para abri-la como uma janela de tamanho completo, com o nome do processo subjacente na trilhas. O botão Recolher no mesmo canto traz a janela de volta ao estado do painel lateral.

• Os detalhes do trabalho não incluem considerações de licenciamento para falhas de trabalhos. Use a funcionalidade de monitoramento para obter detalhes sobre licenciamento.

Para visualizar detalhes sobre um trabalho específico, clique no botão Detalhes correspondente. Isso exibe um painel lateral que inclui a seção Detalhes do trabalho, fornecendo várias informações, como:

• o nome do processo subjacente
• o robô e máquina de execução
• os motivos da falha dos trabalhos
• os motivos que impedem que o trabalho seja iniciado
• ações que você pode adotar para corrigir quaisquer problemas e acionar o trabalho para iniciar

Detalhes do trabalho concluído

Detalhes do trabalho pendentes

Exibição de logs do trabalho

Para visualizar os logs de um trabalho específico, clique no botão Detalhes correspondente. Isso exibe um painel lateral que inclui a seção Logs, com dados sobre o trabalho selecionado.

Observação: os logs gerados para trabalhos iniciados por meio das sessões de depuração remotas não ficam disponíveis na página Logs de trabalho. Eles podem ser encontrados na página global Logs.

Visualização de condições de retomada de trabalho

Para visualizar os gatilhos necessários para a retomada de um trabalho suspenso, clique no botão Detalhes correspondente. Isso exibe um painel lateral que inclui a guia Retomar condições, com detalhes sobre as tarefas de fluxo de trabalho configuradas para o trabalho selecionado.

Você pode clicar na lista para acessar os gatilhos para os outros trabalhos.

Visualização da linha de tempo do vídeo

Para visualizar uma gravação de vídeo de uma execução de um trabalho, juntamente com os logs subjacentes, clique no botão Detalhes correspondente. Isso exibe um painel lateral que inclui a guia Linha de tempo do vídeo, com um painel de vídeo na parte superior e uma lista de logs na parte inferior.

Você também pode acessar essa guia clicando em Abrir gravação na guia Logs do mesmo painel.

Para obter detalhes, consulte os tópicos dedicados à gravação de vídeo.

Baixando a mídia de execução

Para baixar a gravação para um trabalho com falha, clique em Mais opções > Baixar gravação. A mídia de execução é baixada de acordo com suas configurações.