Gerenciamento de trabalhos

Início de um trabalho

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

1. Na pasta em que o processo está localizado, selecione Automações, navegue até Trabalhos e selecione Iniciar.Alternativamente, você pode iniciar um trabalho usando uma das seguintes opções:
   • Em Automações, selecione Processos, localize o processo relevante na lista e selecione Iniciar um trabalho no final da linha.
   • Em Automações, selecione Gatilhos, localize o gatilho relevante na lista e selecione Iniciar um trabalho agora no final da linha.
2. Na janela Iniciar trabalho, use a lista suspensa Nome do processo para selecionar um processo que foi implantado anteriormente na pasta atual.
   Observação:

   • Se você selecionou Iniciar um trabalho na lista de processos, o processo subjacente é pré-selecionado na lista suspensa Nome do Processo.
   • Se você selecionou Iniciar um trabalho agora na lista de gatilhos, o processo associado ao gatilho subjacente é pré-selecionado na lista suspensa Nome do processo.
3. Configure os campos obrigatórios, conforme descrito nas seções abaixo.
4. 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

Na lista suspensa Prioridade do trabalho, 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.
  App Testing	O trabalho é executado no modo Unattended, consumindo um runtime de Testes de aplicativos. Importante: o runtime de Testes de aplicativos pode executar apenas o seguinte: Casos de teste de aplicativos de projetos de Testar Automação. Processos non-production para testes de aplicativos, criados com uma licença de Desenvolvedor de teste de aplicativo. Se você selecionar qualquer outro tipo de processo, não pode selecionar a opção Teste de aplicativos no menu suspenso Tipo de runtime.
  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 Unidades do robô - 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 Unidades do robô - 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 Unidades do robô - 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 Unidades do robô - 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 na seção Destino de execução da janela Iniciar trabalho como desejado.

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 o trabalho será iniciado naquele par conta-máquina específico. 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.

Observação: se você tentar executar um trabalho sem uma conta adequada atribuída à pasta, você receberá uma mensagem de erro explicando o problema. Além disso, o botão Atribuir uma conta à pasta é destacado. Ao selecionar o botão, você pode atribuir uma conta existente à pasta ou criar uma nova em tempo real e depois retomar o fluxo de trabalho Iniciar trabalho.

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 na lista suspensa uma máquina host específica do pool de máquinas host conectadas.
• Especificar a conta e a máquina significa que o trabalho será iniciado naquele par conta-máquina específico. 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.

Habilitar Agente de Recuperação

Para receber sugestões e informações de depuração sobre como corrigir problemas que podem surgir durante a execução do trabalho, ative o botão de alternância Habilitar Agente de Recuperação.Além disso, você pode permitir que o Agente de Recuperação corrija de forma independente problemas de execução de trabalhos, selecionando a opção Habilitar a Auto-recuperação do Agente de Recuperação.Para obter informações detalhadas sobre o Agente de Recuperação e seus recursos, consulte a documentação do Agente de Recuperação.

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

Essa configuração permite que você configure se os diferentes fragmentos de um trabalho de longa duração são executados no mesmo par 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:

"O trabalho para o processo número {process_number} está 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, nenhuma 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 seção Argumentos de runtime da janela Iniciar trabalho, defina as seguintes configurações:

• Selecione o ponto de entrada. Se o processo não for compatível com vários pontos de entrada, o Orchestrator exibe Padrão na lista suspensa Ponto de entrada e você não poderá fazer uma seleção.

  Para obter mais informações, consulte Pontos de entrada.

• Forneça argumentos de entrada para o processo selecionado. A tabela é preenchida automaticamente com todos os argumentos de entrada aceitos pelo processo selecionado e os valores correspondentes herdados do pacote.

Iniciando um trabalho com agente

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

1. Navegue até Automações e, em seguida, Trabalhos a partir da pasta na qual o processo está localizado.
2. Clique em Iniciar. A janela Iniciar trabalho é exibida.
3. Na lista suspensa Nome do processo, selecione um processo que foi implantado anteriormente na pasta atual. Para exibir apenas agentes na lista suspensa, use o filtro Tipos de filtro e selecione Agente.
4. Configure os campos obrigatórios, conforme descrito nas seções abaixo.
5. Clique em Iniciar. A janela Iniciar trabalho fecha e o trabalho é iniciado de acordo com as configurações que você fez. O Estado do trabalho é exibido em tempo real na página Trabalhos.

Configurando o destino de execução

Configure seu destino de execução definindo as opções conforme desejado na aba Destino de execução da janela Iniciar 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. Habilitar o botão de alternância permite que você:

• 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 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:

"O trabalho para o processo número {process_number} está 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.

Conta

Você pode escolher uma das seguintes abordagens:

• Especificar uma conta significa que o processo será executado sob essa conta específica do usuário ou robô.
• Não especificar uma conta resulta na alocação dinâmica da conta pelo Orchestrator.

Defining the environment configuration for coded agent jobs

To specify environment variables for a coded agent job, use the Environment Configuration text field. Coded agents are indicated as (Agent - <programming language>) in the user interface.

You can use the Environment Configuration field to reference secrets, such as API keys, using one of the following methods:

• Enter the secret value directly in the Environment Configuration field, as shown in the following example:

  SECRET=Abc@123

  You can enhance the security of secrets by having asterisks displayed instead of the secret value in the following scenarios:
  • Starting a job with the environment configuration inherited from the underlying process.
  • Restarting a job.
  To enable this behavior, ensure that the name of the secret key ends in one of the following strings:
  • ACCESS_KEY
  • API_KEY
  • AUTH
  • CREDENTIALS
  • PASSWORD
  • PRIVATE_KEY
  • SECRET
  • SESSION
  • TOKEN
  To update the secret value, you can delete the asterisks and enter the new string.
• Reference a secret-type asset located in the same folder as the agent, as shown in the following example:

  MySecret=%ASSETS/SECRET%

  Observação:

  • Typing =% after the secret key displays an ASSETS/ autocompletion suggestion. Accepting the suggestion displays a drop-down list of assets from which you can select the desired item.
  • You cannot retrieve secrets from external credential stores when using a disconnected credential proxy.

Adicionando argumentos

Se o pacote tiver argumentos de entrada e/ou saída, eles serão exibidos na seção Argumentos de Runtime, nas abas Entrada e Saída. Os valores dos argumentos são herdados do pacote, mas você pode editá-los conforme necessário.

Para alternar entre os argumentos e uma exibição do esquema JSON subjacente, selecione esquema JSON.

Iniciando um trabalho de processo com agente

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

1. Navegue até Automações e, em seguida, Trabalhos a partir da pasta na qual o processo está localizado.
2. Clique em Iniciar. A janela Iniciar trabalho é exibida.
3. Na lista suspensa Nome do processo, selecione um processo que foi implantado anteriormente na pasta atual. Para exibir apenas processos com agentes na lista suspensa, use o filtro Tipos de filtro e selecione Processo com agentes.
4. Configure os campos obrigatórios, conforme descrito nas seções abaixo.
5. Clique em Iniciar. A janela Iniciar trabalho fecha e o trabalho é iniciado de acordo com as configurações que você fez. O Estado do trabalho é exibido em tempo real na página Trabalhos.

Configurando o destino de execução

Configure seu destino de execução definindo as opções conforme desejado na aba Destino de execução da janela Iniciar 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 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:

"O trabalho para o processo número {process_number} está 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.

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ô.
• Não especificar uma conta resulta na alocação dinâmica da conta pelo Orchestrator.

Adicionando argumentos

Se o pacote tiver argumentos de entrada e/ou saída, eles serão exibidos na seção Argumentos de Runtime, nas abas Entrada e Saída. Os valores dos argumentos são herdados do pacote, mas você pode editá-los conforme necessário.

Para alternar entre os argumentos e uma exibição do esquema JSON subjacente, selecione esquema JSON.

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

No menu Mais ações do trabalho, selecione Parar.O Orchestrator marca o status do trabalho como Parando e envia uma notificação para o robô, mas a execução do projeto de automação continua.

Se uma atividade Should Stop for encontrada, ela retornará true como resultado. Você pode usar o resultado como um marcador para determinar quando chamar uma atividade Parar trabalho para iniciar um processo de desligamento suave.

Se uma atividade de Interromper trabalho não for encontrada, a execução do trabalho não será interrompida até que atinja o final do projeto. O status final do trabalho é Bem-sucedido.

Observação:

• Um trabalho iniciado a partir do Orchestrator pode ser interrompido apenas do Orchestrator.
• Um trabalho iniciado a partir do Assistant pode ser interrompido tanto no Orchestrator, na página Trabalhos e 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 pacote subjacente
• o ponto de entrada usado para a execução do trabalho
• o robô e máquina de execução
• a hora de início e término do trabalho
• 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

Observação:

Para tarefas de agentes e processo com agentes, o painel de detalhes do trabalho inclui uma aba Rastreamento. O rastreamento fornece uma visão abrangente e hierárquica da execução do trabalho, sua entrada e saída, bem como quaisquer outros recursos invocados ou trabalhos executados em conexão com a execução.

A visualização do rastreamento também permite que você forneça feedback positivo ou negativo, bem como fazer comentários sobre qualquer um dos itens do rastreamento.

Note: If Healing Agent is enabled and detects issues during job execution, a Healing Agent tab appears in the job details panel. The tab allows you to download the debug file or open it in Studio, and provides you with information on the issues that occurred during job execution. In addition to the issue description, you can view screenshots and suggestions on how to address each issue. If you selected Enable Healing Agent self-healing, the Healing Agent tab also provides details on how Healing Agent addressed the issues it identified. For more information on Healing Agent and its capabilities, refer to the Healing Agent documentation.

No contexto de um tenant SAP, você pode usar o botão Voltar para SAP para retornar ao processo no SAP Build Process Automation.

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.

Para atualizar os logs de um trabalho manualmente, selecione o botão Atualizar na seção Logs do painel lateral do trabalho.

Para trabalhos que não estão em um estado Pendente ou Final, você tem a opção de atualizar automaticamente os logs de trabalho em um intervalo de dez segundos. Para habilitar a opção, selecione o menu suspenso ao lado de Atualizar na seção Logs do painel lateral do trabalho e selecione Habilitar atualização automática. O botão Atualizar muda a aparência para confirmar sua seleção. A opção persistirá para trabalhos futuros, mesmo se você atualizar a janela do navegador.

Os logs de um trabalho são atualizados automaticamente até um minuto após o trabalho atingir o estado final. Neste ponto, você não pode mais selecionar Habilitar atualização automática, e a atualização manual dos logs se torna a única opção disponível.

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.