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 página Iniciar trabalho, use a lista suspensa Processo para selecionar um processo que tenha sido previamente implantado na pasta atual.
   Observação:

   • Se você selecionou Iniciar um trabalho na lista de processos, o processo subjacente é pré-selecionado na lista suspensa Processo.
   • Se você selecionou Iniciar um trabalho agora na lista de gatilhos, o processo associado ao gatilho subjacente é pré-selecionado na lista suspensa Processo.
3. Configure os campos obrigatórios, conforme descrito nas seções abaixo.
4. Selecione 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.
  Robô de teste de aplicativos	O trabalho é executado no modo não assistido, consumindo um runtime do App Test Robot. Importante: o runtime do App Test Robot pode executar apenas o seguinte: Casos de teste de aplicativo de um pacote de tipo de projeto Automação de Teste. Fluxos de trabalho de RPA para App Testing (projeto criado com a licença App Test Developer). Se você selecionar qualquer outro tipo de processo, não poderá selecionar a opção App Test Robot na lista suspensa 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.
• 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

Escolha qual par conta-máquina específico executará o trabalho. Você pode selecionar Adicionar mapeamento de conta-máquina se 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.

Configuração de variáveis de ambiente

Observação: a configuração do ambiente é aplicada apenas à versão 2025.10 ou superior do robô.

Para especificar variáveis de ambiente para um trabalho, use o campo de texto Configuração de Ambiente.

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

  Para 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

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

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.

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
  • TOKEN
  Para 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

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.

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

   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

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.

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 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 selecionar qualquer trabalho na lista para exibir seus detalhes específicos, para todas as guias incluídas no painel. Você pode rolar a grade da lista de trabalhos 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 selecionar o ícone Expandir no canto superior de qualquer guia para abri-lo como uma janela de tamanho normal, com o nome do processo subjacente nas trilhas de navegação.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, selecione o botão Detalhes correspondente. Isso exibe um painel lateral que inclui a seção Detalhes do trabalho, fornecendo várias informações:

• Gráfico: você pode alternar a visualização do gráfico usando o botão Gráfico . O gráfico fornece uma visualização de execuções de trabalhos relacionadas (pai, filho, irmãos, conforme aplicável), complementando a visualização da Árvore do trace.
• Erro: informações de erro geradas durante a execução do trabalho.
• Condições de retomada: condições e gatilhos configurados para retomada do trabalho.
• Autopilot Healing: informações relacionadas às ações do Autopilot Healing aplicadas ao trabalho.
• Informações do trabalho: metadados principais do trabalho e detalhes do status da execução. Quando aplicável, esse cartão exibe motivos pendentes, explicando por que um trabalho está aguardando ou bloqueado.
• Variáveis de ambiente: variáveis de ambiente disponíveis no momento da execução do trabalho.
• Entrada: os argumentos de entrada do trabalho.
• Saída: os argumentos de saída do trabalho.
• Mensagem bruta: mensagem não processada que o trabalho emitiu antes da formatação.
• Detalhes do runtime: informações relacionadas ao runtime para a execução do trabalho. Alguns campos e ações são exibidos condicionalmente, dependendo do tipo e status do trabalho.
  • Hora de Início: a data e a hora em que a execução do trabalho começou.
  • Hora de Término: a data e a hora em que a execução do trabalho terminou.
  • Duração: o período total de execução do trabalho.
  • Hora de criação: a data e a hora em que o trabalho foi criado.
  • Consumo: o número de unidades consumidas para a execução do trabalho, quando aplicável.
  • Actions: aplicável a gravações de vídeo, esta seção inclui:
    • Abrir para abrir a gravação de vídeo.
    • Excluir, para excluir a gravação de vídeo.
• Ambiente da execução: informações da execução:
  • Pacote: o nome e a versão do pacote usado para executar o trabalho.
  • Identidade do Host: a identidade sob a qual o trabalho foi executado.
  • Máquina: o modelo de máquina atribuído à execução do trabalho.
  • Robô: o robô usado para executar o trabalho.
  • Conta/Identidade: a conta sob a qual o robô executou o trabalho.
  • Nome do host: o nome da máquina em que o trabalho foi executado.
  • Healing Agent: indica se o Autopilot Healing está habilitado para o trabalho.
  • Autocorreção do Healing Agent: indica se as ações de autocorreção estão habilitadas para o Healing Agent.
• Histórico do estado do trabalho: uma linha cronológica dos estados do trabalho e a duração em cada estado.
• Informações adicionais: detalhes adicionais do trabalho:
  • Chave do trabalho: um identificador exclusivo atribuído ao trabalho.
  • Entry Point: o ponto de entrada do fluxo de trabalho ou processo usado para iniciar o trabalho.
  • Tipo: o tipo de trabalho executado, como um processo com agente.
  • Tipo de Runtime: exibido para certos tipos de trabalho, oferece classificação adicional do runtime usado para executar o trabalho.
  • Origem: o gatilho ou a origem que iniciou a execução do trabalho.
  • Prioridade: o nível de prioridade atribuído ao trabalho.
  • Interação do usuário: descreve se a interação do usuário é Obrigatória ou Não necessária.
  • Status do Healing Agent: o status atual do Healing Agent para o trabalho.
  • Tamanho da máquina: o tamanho da máquina usada para a execução do trabalho, quando disponível.
  • Capturas de tela: capturas de tela associadas à execução do trabalho, quando disponíveis.
• Anexos: arquivos associados à execução do trabalho.
• Revisão humana: informações relacionadas a atividades de revisão humana vinculadas ao trabalho.

Quando o conteúdo dos argumentos de entrada e saída de um trabalho é grande, apenas uma parte dele é mostrada por padrão.

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:

• Expandir - carrega o arquivo completo no editor, até um determinado limite de tamanho.

• Baixar - baixa o arquivo completo quando o tamanho do argumento excede o limite.

• Copy - para desempenho aprimorado, disponível apenas para argumentos dentro de um determinado limite.

Observação: se o Healing Agent estiver habilitado e detectar problemas durante a execução do trabalho, uma aba Healing Agent aparecerá no painel de detalhes do trabalho. A aba permite baixar o arquivo de depuração ou abri-lo no Studio e fornece informações sobre os problemas ocorridos durante a execução do trabalho. Além da descrição do problema, você pode ver capturas de tela e sugestões sobre como solucionar cada problema. Se você selecionou Habilitar a autocorreção do Healing Agent, a aba Healing Agent também fornece detalhes sobre como o Healing Agent abordou os problemas que identificou. Para obter mais informações sobre o Healing Agent e seus recursos, consulte a documentação do Healing Agent.

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

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.

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.

Para trabalhos de agente, o feedback adicionado na visualização de Trace está disponível automaticamente no painel Avaliações de agentes durante o período de projeto, permitindo que você crie avaliações a partir de execuções de trabalhos, edite-as e refine seu agente com base no feedback inserido manualmente. Leia mais sobre Avaliações.

Figura 3. Traces de runtime de agentes

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: se um trabalho tiver sido suspenso e retomado posteriormente, a linha de tempo do vídeo exibirá apenas a execução que ocorreu após a retomada do trabalho.

Para visualizar uma gravação de vídeo de uma execução de trabalho, junto com os logs subjacentes, selecione o 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 selecionando Abrir gravação na guia Detalhes 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.