Execuções
Execute o projeto de código manualmente, acompanhe o histórico de execuções, veja os logs ao vivo e interrompa uma execução.
Execuções
Uma execução é uma rodada do robô em um dispositivo, com o deploy que estiver pronto nele. A aba Execuções reúne o histórico do projeto em todos os dispositivos e gatilhos.
Executar manualmente
- Clique em Executar, no cabeçalho do projeto.
- Escolha o Ambiente: Preview ou Produção. Projetos que recebem código por .zip só têm Produção.
- Escolha o Dispositivo. A Roberty já seleciona o melhor candidato do ambiente.
- Confirme em Executar.
Ao escolher Produção, a execução afeta o ambiente real — é a mesma execução que uma chamada pela API.
O dispositivo só pode ser usado se estiver ativo, online, for Windows e tiver um deploy pronto. Sem dispositivo no ambiente escolhido, vincule um nas configurações, aba Dispositivos. Veja Dispositivos.
Execuções manuais não recebem argumentos: o arquivo de argumentos só existe em execuções por webhook e por avaliação. Veja Argumentos e resultado.
O botão Executar fica desabilitado quando o projeto não tem dispositivo vinculado ou está desativado. Enquanto uma execução manual está rodando, o cabeçalho mostra Acompanhar, que abre a execução ao vivo, e Parar.
Erros ao iniciar
| Mensagem | Causa |
|---|---|
| Este dispositivo não possui um deploy pronto para execução. | O dispositivo ainda não tem um deploy concluído. Veja Deploys. |
| Dispositivo não autorizado para este projeto. | O dispositivo não está vinculado ao projeto. |
Lista de execuções
A aba Execuções lista as execuções de todos os dispositivos e gatilhos, com 20 execuções por página. Busque por dispositivo, ambiente, gatilho, status ou ID, e use o botão de atualizar para recarregar a lista.
O bloco Em andamento mostra as execuções que estão acontecendo agora, independentemente da página ou da busca.
| Status | Significado |
|---|---|
| Pendente | A execução foi criada e aguarda o dispositivo. |
| Em execução | O robô está rodando no dispositivo. |
| Sucesso | O processo terminou com exit code 0. |
| Falhou | O processo terminou com outro exit code ou não pôde ser concluído. |
| Gatilho | Origem |
|---|---|
| Manual | O botão Executar do projeto. |
| Agendamento | Um agendamento de um dispositivo de Produção. |
| Webhook | Uma chamada à API. |
As avaliações também geram execuções, com o gatilho evaluation.
Detalhes da execução
Clique em uma execução para abrir os detalhes: gatilho, ambiente, dispositivo, início e fim.
- Na fila — se o dispositivo estiver ocupado, a execução aparece como "Na fila de {dispositivo}": o dispositivo pega a execução assim que estiver livre.
- Logs — a saída
stdoutestderrdo robô, ao vivo enquanto a execução roda. Use Copiar logs para copiar o conteúdo e Mostrar horário dos logs para exibir o horário de cada linha. Se aparecer "Log indisponível: o runner não conseguiu enviar o log.", o dispositivo não conseguiu enviar o log daquela execução. - Screenshot de erro — quando a execução falha e o dispositivo registra uma captura de tela, ela aparece nos detalhes e pode ser baixada. O link expira: se o screenshot não carregar, feche e reabra o painel para gerar um novo.
Interromper uma execução
Para parar uma execução em andamento, use Parar no cabeçalho do projeto ou Interromper na lista ou nos detalhes. Uma confirmação avisa que a execução no dispositivo será interrompida imediatamente.
Quando o usuário interrompe a execução, o entry point de exceção não é executado.
Projeto desativado
Com o projeto desativado, as execuções pelo Studio e pela API ficam bloqueadas, e o topo do projeto mostra o aviso Projeto desativado com o atalho Reativar projeto. A opção fica em Configurações, aba Geral.
Veja também
- API e webhook — disparar execuções de sistemas externos, com argumentos e resposta.
- Executar projeto Code — executar o projeto a partir de um robô RPA.
- Preparar o projeto — exit code e logs.