Pular para o conteúdo principal
Roberty Studio
CODECode

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​

  1. Clique em Executar, no cabeçalho do projeto.
  2. Escolha o Ambiente: Preview ou Produção. Projetos que recebem código por .zip só têm Produção.
  3. Escolha o Dispositivo. A Roberty já seleciona o melhor candidato do ambiente.
  4. Confirme em Executar.
aviso

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​

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

StatusSignificado
PendenteA execução foi criada e aguarda o dispositivo.
Em execuçãoO robô está rodando no dispositivo.
SucessoO processo terminou com exit code 0.
FalhouO processo terminou com outro exit code ou não pôde ser concluído.
GatilhoOrigem
ManualO botão Executar do projeto.
AgendamentoUm agendamento de um dispositivo de Produção.
WebhookUma 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 stdout e stderr do 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​