Executar um script JavaScript

Antes de começar

• Na central, selecione o workspace e a máquina corretos. O agente deve estar conectado.
• O Node.js precisa estar instalado na máquina executora. Se acabou de instalá-lo, reinicie o agente para atualizar o PATH.
• Para cadastrar ou editar código, use a senha do editor local definida no setup. Ela é diferente da senha de entrada na central. O agente também precisa permitir as alterações remotas necessárias ao cadastro.

Criar pelo painel

1. Abra Scripts na automação desejada e clique em Adicionar script.
2. Escolha Criar novo, tecnologia JavaScript (.js) e nome Teste JavaScript.
3. Confira o campo Arquivo a criar. O caminho fica dentro de scripts/<cliente>/<automacao>/javascript/ na máquina executora.
4. Para este exemplo, deixe as opções de escrita de dados e uso de navegador desmarcadas. Clique em Criar e abrir código.
5. Substitua o modelo pelo exemplo abaixo e clique em Salvar rascunho. Isso salva o arquivo na máquina executora, sem enviar ao GitHub. Feche o editor e clique em Executar no script Teste JavaScript, não nas etapas de Despesas corporativas.

Copiar exemplo Baixar exemplo .js

Carregando exemplo...

Conferir a execução

No log, confira a versão do Node.js, a data, Resultado: 42 e ORQUESTRA_JS_OK. A execução deve terminar como concluída, com código de saída 0. Consulte também o registro em Execuções.

Esse resultado comprova somente a execução deste exemplo naquela máquina. Não valida a API de IA, os arquivos de Despesas corporativas ou as credenciais do Protheus.

Usar um arquivo existente

Coloque seu arquivo na pasta scripts da instalação da máquina executora. Em Adicionar script, escolha Arquivo existente e JavaScript. Informe o caminho relativo exibido pela estrutura do seu cliente, por exemplo scripts/simplea_servidor/testes/javascript/teste_javascript.js.

Baixar o exemplo neste navegador não transfere o arquivo automaticamente para o servidor. Para evitar a transferência manual, use o editor do painel conforme os passos acima.

A execução parte da raiz da instalação, não da pasta do script. Em CommonJS, use __dirname para resolver arquivos vizinhos. Dependências externas devem ser instaladas na máquina executora; o exemplo fornecido não precisa de npm install.

Se falhar

• Node não encontrado: confirme node --version no Windows da máquina executora e reinicie o agente.
• Arquivo ou módulo não encontrado: confira o caminho do cadastro, o arquivo salvo e as dependências do script.
• Máquina desconectada ou comando recusado: confira o agente e as permissões do workspace antes de tentar novamente.
• Erro no JavaScript: abra o log da execução, corrija a linha indicada em Código e execute novamente.

Scripts rodam com as permissões do usuário Windows do agente. A opção de escrita controla confirmações, mas não é uma sandbox. Execute apenas código confiável e nunca inclua senhas ou tokens no código ou no log.