Gerenciamento de trabalhos

Início de um trabalho

Observação:

A disponibilidade de funcionalidades depende da oferta de nuvem que você usa. Para obter detalhes, consulte a página Disponibilidade de recursos.

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. In the Start Job page, use the Process drop-down to select a process that has been previously deployed to the current folder.
   Observação:

   • If you selected Start a Job in the process list, the underlying process is pre-selected in the Process drop-down.
   • If you selected Start a Job Now in the trigger list, the process associated with the underlying trigger is pre-selected in the Process drop-down.
3. Configure os campos obrigatórios, conforme descrito nas seções abaixo.
4. Select Start. The Start Job window closes and, if there are available runtimes on the currently active folder, the job starts on a Robot according to the settings you made. The State of the job is displayed in real-time on the Jobs page.

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. Important: The App Testing runtime can execute only the following: 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. If you select any other type of process, you cannot select the App Testing option in the Runtime type drop-down menu.
  Robô de teste de aplicativos	O trabalho é executado no modo não assistido, consumindo um runtime do App Test Robot. Important: The App Test Robot runtime can execute only the following: Application test cases from a package of project type Test Automation . Fluxos de trabalho de RPA para App Testing (projeto criado com a licença App Test Developer). If you select any other type of process, you cannot select the App Test Robot option in the Runtime type drop-down menu.
  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. See Robot units - Consumption for more details.
  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. See Robot units - Consumption for more details.
  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. See Robot units - Consumption for more details.
  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. See Robot units - Consumption for more details.

  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 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)
    • NonProduction Por exemplo, se não existir nenhum runtime Production, o Orchestrator usará um runtime NonProduction disponível. Se não existir nenhum, o trabalho 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.
    • Se apenas grupos de contas de robôs forem atribuídos a uma pasta, as contas de robôs individuais dentro desses grupos não podem ser usadas para executar trabalhos. Para permitir que uma conta de robô execute trabalhos em uma pasta, a conta individual do robô deve ser atribuída explicitamente a essa pasta.

    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

    Choose which specific account-machine pair will run the job. You can select Add Account-Machine mapping if you want your job to run on multiple such pairs. If you do so, a Pending job is created for each account-machine pair.

  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

  To receive suggestions and debugging information on how to fix issues that may arise during job execution, turn on the Enable Healing Agent toggle. Additionally, you can allow Healing Agent to independently fix job execution issues by selecting the Enable Healing Agent self-healing option. For detailed information on Healing Agent and its capabilities, refer to the Healing Agent documentation.

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

  • Select Stop from the drop-down menu - this attempts to gracefully end the execution after the defined time interval has passed since the job is stuck in a pending state (set the time to a minimum of 1 minute, maximum of 10 days, 23 hours and 59 minutes).

  • Select Kill from the drop-down menu - this attempts to forcefully end the execution after the defined time interval has passed since the job is stuck in a pending state (set the time to a minimum of 1 minute, maximum of 10 days, 23 hours and 59 minutes).

  • Select Stop from the drop-down menu and turn on the Schedule automatic "Kill", if the job does not stop option - this attempts to gracefully end the execution after the defined time interval has passed since the job is stuck in a pending state and then attempts to forcefully end it after the defined time interval has passed since the job is stuck in a stopping state (set the time to a minimum of 1 minute, maximum of 10 days, 23 hours and 59 minutes).

    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, 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.

    Configuração de variáveis de ambiente

  Observação:

  Environment configuration is only applied for Robot version 2025.10 and above.

  To specify environment variables for a job, use the Environment Configuration text field.

  Você pode usar o campo Configuração do ambiente para fazer referência a segredos, como chaves de API, usando um dos seguintes métodos:

  • Insira o valor do segredo diretamente no campo Configuração do ambiente, conforme exibido no exemplo a seguir:

    SECRET=Abc@123
    

    Você pode aprimorar a segurança dos segredos exibindo asteriscos em vez do valor do segredo nos seguintes cenários:

    • Iniciar um trabalho com a configuração de ambiente herdada do processo subjacente.
    • Reiniciando um trabalho. Para habilitar esse comportamento, certifique-se de que o nome da chave secreta termine em uma das seguintes strings:
    • ACCESS_KEY
    • API_KEY
    • AUTH
    • CREDENTIALS
    • PASSWORD
    • PRIVATE_KEY
    • SECRET
    • SESSION
    • TOKENPara atualizar o valor do segredo, você pode excluir os asteriscos e inserir a nova string.

  • Faça referência a um ativo do tipo secreto localizado na mesma pasta que o trabalho, como no exemplo a seguir:

    MySecret=%ASSETS/SECRET%
    

    Observação:

    • Digitando =% após a chave secreta exibe umaASSETS/sugestão de preenchimento automático.Aceitar a sugestão exibe uma lista suspensa de ativos dos quais você pode selecionar o item desejado.
    • Não é possível recuperar segredos de armazenamentos de credenciais externos ao usar um proxy de credenciais desconectado.

    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.

    Observação:

    Os argumentos do trabalho não podem exceder 10.000 caracteres.

    Observação:

    Se o erro Robots without credentials cannot run processes that require an interactive session. for exibido e nenhuma interação da interface gráfica for necessária, você pode usar a opção Inicia em segundo plano nas configurações do projeto do Studio.

  Iniciando um trabalho com agente

  Observação:

  A disponibilidade de funcionalidades depende da oferta de nuvem que você usa. Para obter detalhes, consulte a página Disponibilidade de recursos.

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

  • Select Stop from the drop-down menu - this attempts to gracefully end the execution after the defined time interval has passed since the job is stuck in a pending state (set the time to a minimum of 1 minute, maximum of 10 days, 23 hours and 59 minutes).

  • Select Kill from the drop-down menu - this attempts to forcefully end the execution after the defined time interval has passed since the job is stuck in a pending state (set the time to a minimum of 1 minute, maximum of 10 days, 23 hours and 59 minutes).

  • Select Stop from the drop-down menu and turn on the Schedule automatic "Kill", if the job does not stop option - this attempts to gracefully end the execution after the defined time interval has passed since the job is stuck in a pending state and then attempts to forcefully end it after the defined time interval has passed since the job is stuck in a stopping state (set the time to a minimum of 1 minute, maximum of 10 days, 23 hours and 59 minutes).

    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.

    Definição da configuração do ambiente para trabalhos de agente codificados

    Para especificar variáveis de ambiente para um trabalho de agente codificado, use o campo de texto Configuração de ambiente. Os agentes codificados são indicados como (Agente - <programming language>) na interface do usuário.

    Você pode usar o campo Configuração do ambiente para fazer referência a segredos, como chaves de API, usando um dos seguintes métodos:

  • Insira o valor do segredo diretamente no campo Configuração do ambiente, conforme exibido no exemplo a seguir:

    SECRET=Abc@123
    

    Você pode aprimorar a segurança dos segredos exibindo asteriscos em vez do valor do segredo nos seguintes cenários:

    • Iniciar um trabalho com a configuração de ambiente herdada do processo subjacente.
    • Reiniciando um trabalho. Para habilitar esse comportamento, certifique-se de que o nome da chave secreta termine em uma das seguintes strings:
    • ACCESS_KEY
    • API_KEY
    • AUTH
    • CREDENTIALS
    • PASSWORD
    • PRIVATE_KEY
    • SECRET
    • SESSION
    • TOKENPara atualizar o valor do segredo, você pode excluir os asteriscos e inserir a nova string.

  • Faça Referência a um ativo do tipo segredo localizado na mesma pasta que o agente, conforme mostrado no exemplo a seguir:

    MySecret=%ASSETS/SECRET%
    

    Observação:

    • Digitando =% após a chave secreta exibe umaASSETS/sugestão de preenchimento automático.Aceitar a sugestão exibe uma lista suspensa de ativos dos quais você pode selecionar o item desejado.
    • Não é possível recuperar segredos de armazenamentos de credenciais externos ao usar um proxy de credenciais desconectado.

    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.

  Observação:

  Os argumentos do trabalho não podem exceder 10.000 caracteres.

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

  Figura 1. Esquema JSON

  

  Iniciando um trabalho de processo com agente

  Observação:

  A disponibilidade de funcionalidades depende da oferta de nuvem que você usa. Para obter detalhes, consulte a página Disponibilidade de recursos.

  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. From the Process Name drop-down, select a process that has been previously deployed to the current folder. To display only agentic processes in the drop-down, use the Filter types filter and select Agentic process.

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

  • Select Stop from the drop-down menu - this attempts to gracefully end the execution after the defined time interval has passed since the job is stuck in a pending state (set the time to a minimum of 1 minute, maximum of 10 days, 23 hours and 59 minutes).

  • Select Kill from the drop-down menu - this attempts to forcefully end the execution after the defined time interval has passed since the job is stuck in a pending state (set the time to a minimum of 1 minute, maximum of 10 days, 23 hours and 59 minutes).

  • Select Stop from the drop-down menu and turn on the Schedule automatic "Kill", if the job does not stop option - this attempts to gracefully end the execution after the defined time interval has passed since the job is stuck in a pending state and then attempts to forcefully end it after the defined time interval has passed since the job is stuck in a stopping state (set the time to a minimum of 1 minute, maximum of 10 days, 23 hours and 59 minutes).

    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.

  Observação:

  Os argumentos do trabalho não podem exceder 10.000 caracteres.

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

  Figura 2. 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 '{AutomationCloudURL}/{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 '{AutomationCloudURL}/{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 '{AutomationCloudURL}/{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.

  Observação:

  Os argumentos do trabalho não podem exceder 10.000 caracteres.

  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

  Click the corresponding More Actions button, and then Kill. The automation project is forcefully stopped, the job is marked as Stopped, and "Job canceled" is displayed in the Job Details window.

  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.

  Duplicating a Job

  Select the corresponding More Actions button, and then Duplicate job. This action is available for jobs in non-terminal states:

  • Pendente
  • Em execução
  • Parando
  • Terminando
  • Suspenso
  • Retomado

  This option opens the Start Job form pre-filled with the original job’s configuration.

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

  • While the side panel is open, you can select any job in the list to display its particular details, for all tabs included in the panel. You can scroll the jobs list grid horizontally, with the Process column remaining fixed if needed for your particular screen size and resolution. Note that you can increase the size of some columns, which will cause a scroll bar to be displayed for easier access.
  • You can select the expand icon in the upper-most corner of any tab to open it as a full-sized window, with the name of the underlying process in the breadcrumbs. The Collapse button in the same corner brings the window back to its side panel state.
  • 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.

  To view details about a specific job, select the corresponding Details button. This displays a side panel which includes the Job Details section, providing you with various information:

  • Graph: you can toggle the graph view on or off using the Graph button. The graph provides a visualization of related job executions (parent, child, sblings as applicable), complementing the Trace tree view.

  • Error: error information generated during job execution.

  • Resume conditions: conditions and triggers configured for job resumption.

  • Autopilot Healing: information related to Autopilot Healing actions applied to the job.

  • Job information: core job metadata and execution status details. When applicable, this card displays pending reasons, explaining why a job is waiting or blocked.

  • Environment Variables: environment variables available at job execution time.

  • Input: the input arguments of the job.

  • Output: the output arguments of the job.

  • Raw message: unprocessed message that the job emitted before formatting.

  • Runtime details: runtime-related information for the job execution. Some fields and actions are displayed conditionally, depending on job type and status.

    • Start time: the date and time when the job execution started.
    • End time: the date and time when the job execution ended.
    • Duration: the total execution time of the job.
    • Creation time: the date and time when the job was created.
    • Consumption: the number of consumed units for the job execution, when applicable.
    • Actions: applicable to video recordings, this section includes:
      • Open, to open the video recording.
      • Delete, to delete the video recording.

  • Execution environment: execution information:

    • Package: the name and version of the package used to execute the job.
    • Host identity: the identity under which the job was executed.
    • Machine: the machine template assigned to the job execution.
    • Robot: the robot used to execute the job.
    • Account/Identity: the account under which the robot executed the job.
    • Hostname: the name of the machine where the job was executed.
    • Healing agent: indicates whether Autopilot Healing is enabled for the job.
    • Healing agent self-healing: indicates whether self-healing actions are enabled for the healing agent.

  • Job state history: a chronological timeline of the job states and the duration spent in each state.

  • Additional information: additional job details:

    • Job key: a unique identifier assigned to the job.
    • Entry point: the workflow or process entry point used to start the job.
    • Type: the type of job executed, such as an agentic process.
    • Runtime type: displayed for certain job types, provides additional classification of the runtime used to execute the job.
    • Source: the trigger or source that initiated the job execution.
    • Priority: the priority level assigned to the job.
    • User interaction: describes if user interaction is Required or Not required.
    • Healing agent status: the current status of the healing agent for the job.
    • Machine size: the machine size used for the job execution, when available.
    • Screenshots: screenshots associated with the job execution, when available.

  • Attachments: files associated with the job execution.

  • Human review: information related to human review activities linked to the job.

    When the content of the Input and Output arguments of a job is large, only a portion of it is shown by default.

    Se o argumento exceder esse tamanho, o conteúdo completo será apoiado pelo armazenamento remoto como um arquivo e pode ser carregado ou baixado conforme necessário:

  • Expand - loads the full file in the editor, up to a certain size limit.

  • Download - downloads the full file when the argument size exceeds the limit.

  • Copy - for improved performance, available only for arguments within a certain limit.

    Observação:

    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 ao SAP para retornar ao processo no SAP Build Process Automation. SAP Build Process Automation.

  Visualização de rastros de trabalho

  Observação:

  A disponibilidade de funcionalidades depende da oferta de nuvem que você usa. Para obter detalhes, consulte a página Disponibilidade de recursos.

  For agent and agentic process jobs, the job details panel includes a Trace tab. The trace provides a comprehensive, hierarchical view of the job run, its input and output, as well as any other resources invoked or jobs executed in connection with the run. The trace view also allows you to provide positive or negative feedback, as well as comments, on any of the trace items.

  Na visualização de rastreamento, quando você alterna a opção Exibir dados brutos, você pode encolher ou expandir uma seção usando atalhos de teclado:

  • Para encolher uma seção, use o atalho Ctrl + Shift + [ em um computador Windows ou Linux ou o atalho Cmd + Option + [ em um computador macOS.

  • Para expandir uma seção, use o atalho Ctrl + Shift + ] em um computador Windows ou Linux ou o atalho Cmd + Option + ] em um computador macOS.

    For agent jobs, feedback added in the Trace view is automatically available in the Agents Evaluations panel during design time, allowing you to create evaluations from job runs, edit them, and refine your agent based on manually entered feedback. Read more about Evaluations.

    Figure 3. Agent runtime traces

    

  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 da linha de tempo do vídeo

  Observação:

  If a job was suspended and later resumed, the video timeline displays only the execution that occurred after the job resumed.

  To view a video recording of a job execution, along with the underlying logs, select the corresponding Details button. This displays a side panel which includes the Video timeline tab, with a video pane on top, and a logs list at the bottom.

  You can also access this tab by selecting Open recording on the Details tab of the same panel.

  For details, check the topics dedicated to video recording.

  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.