Scripts

Executa scripts do cliente: Python, VBScript, lote e JavaScript

Executar Script Python

scripts.run_python

Executa script ou código Python do cliente

Como usar

Executa um arquivo .py do cliente (ou o código escrito no comando) num processo separado e guarda o que ele imprimir. Escolha o Python do próprio robô (com os pacotes do Studio), o Python da máquina ou o python.exe do ambiente virtual do cliente. Os valores do robô chegam como variáveis de ambiente e, com o tipo, em JSON na A4A_VARIABLES; para devolver uma lista ou um dicionário, grave JSON no arquivo de A4A_RESULT_FILE.

Exemplo: Execute C:\scripts\conciliar.py com os argumentos {arquivo} e 2026-10, usando o venv do cliente, e guarde o JSON que ele grava em A4A_RESULT_FILE na variável totais.

Campos

Campo	Tipo	Padrão	Detalhes
Origem do script *	Opção	`Arquivo de script do cliente`	Opções: Arquivo de script do cliente, Código escrito aqui
Script Python (.py) *	Arquivo		Só quando «Origem do script» = «Arquivo de script do cliente»
Código *	Código		Ex.: `import os print(os.environ['NOME'])`Só quando «Origem do script» = «Código escrito aqui»
Argumentos	Lista		Passados ao script nesta ordem, um por linha (as aspas são tratadas pelo robô)
Interpretador Python *	Opção	`Python do robô (pacotes do Studio)`	Opções: Python do robô (pacotes do Studio), Python instalado na máquina (py/python), Outro python.exe (venv do cliente)
Caminho do python.exe *	Arquivo		Ex.: `C:\cliente\.venv\Scripts\python.exe`Só quando «Interpretador Python» = «Outro python.exe (venv do cliente)»
Salvar a saída (STDOUT) na variável *	Variável de saída	`script_output`

+ Avançado (7)

Campo	Tipo	Padrão	Detalhes
Variáveis para o script	Pares chave e valor		Cada linha vira uma variável de ambiente (os.environ['NOME']); todas, com o tipo, em A4A_VARIABLES (JSON)
Pasta de trabalho	Pasta		Vazio: a pasta do script (ou uma pasta temporária para o código escrito aqui)
Tempo limite (0 = sem limite)	Número	`300 s`	Ao esgotar, o script e tudo que ele abriu são encerrados
Falhar o robô se o código de saída não for 0	Sim/Não	`Sim`
Mostrar a saída do script no log	Sim/Não	`Sim`	Até 200 linhas do STDOUT e do STDERR vão para o console e para o log da execução
Salvar o código de saída na variável	Variável de saída
Salvar o resultado na variável	Variável de saída		O script grava JSON (ou texto) no arquivo de os.environ['A4A_RESULT_FILE']; JSON vira lista ou dicionário

Resultado: guardado na variável script_output (Texto).

Executar VBScript

scripts.run_vbscript

Executa VBScript do cliente (.vbs)

Como usar

Executa um arquivo .vbs (ou o código escrito no comando) pelo cscript, sem janelas, e guarda o que ele escreve com WScript.Echo. Leia os valores do robô com CreateObject("WScript.Shell").Environment("PROCESS")("NOME"). Evite MsgBox e InputBox: não há quem clique e o robô espera até o tempo limite. Para macros do Excel, use Excel > Executar Macro.

Exemplo: Execute C:\scripts\exportar_sap.vbs com o argumento {data} e falhe o robô se ele terminar com WScript.Quit 1.

Campos

Campo	Tipo	Padrão	Detalhes
Origem do script *	Opção	`Arquivo de script do cliente`	Opções: Arquivo de script do cliente, Código escrito aqui
Arquivo VBScript (.vbs) *	Arquivo		Só quando «Origem do script» = «Arquivo de script do cliente»
Código *	Código		Ex.: `WScript.Echo "Olá " & WScript.Arguments(0)`Só quando «Origem do script» = «Código escrito aqui»
Argumentos	Lista		Passados ao script nesta ordem, um por linha (as aspas são tratadas pelo robô)
Salvar a saída (STDOUT) na variável *	Variável de saída	`script_output`

+ Avançado (7)

Campo	Tipo	Padrão	Detalhes
Variáveis para o script	Pares chave e valor		Cada linha vira uma variável de ambiente, lida com WScript.Shell .Environment("PROCESS")("NOME")
Pasta de trabalho	Pasta		Vazio: a pasta do script (ou uma pasta temporária para o código escrito aqui)
Tempo limite (0 = sem limite)	Número	`300 s`	Ao esgotar, o script e tudo que ele abriu são encerrados
Falhar o robô se o código de saída não for 0	Sim/Não	`Sim`
Mostrar a saída do script no log	Sim/Não	`Sim`	Até 200 linhas do STDOUT e do STDERR vão para o console e para o log da execução
Salvar o código de saída na variável	Variável de saída
Salvar o resultado na variável	Variável de saída		O script grava JSON (ou texto) no arquivo da variável A4A_RESULT_FILE (FileSystemObject, Unicode = True)

Resultado: guardado na variável script_output (Texto).

Executar Arquivo de Lote

scripts.run_batch

Executa arquivo .bat ou .cmd do cliente

Como usar

Executa um arquivo .bat/.cmd (ou os comandos escritos aqui) no cmd e guarda a saída. O código de saída é o do exit /b. O código escrito aqui já começa com @echo off e saída em UTF-8. Os valores do robô chegam como %NOME%.

Exemplo: Execute C:\scripts\backup.cmd com o argumento {pasta} e guarde o código de saída em codigo_backup.

Campos

Campo	Tipo	Padrão	Detalhes
Origem do script *	Opção	`Arquivo de script do cliente`	Opções: Arquivo de script do cliente, Código escrito aqui
Arquivo de lote (.bat/.cmd) *	Arquivo		Só quando «Origem do script» = «Arquivo de script do cliente»
Código *	Código		Ex.: `echo %1 %NOME%`Só quando «Origem do script» = «Código escrito aqui»
Argumentos	Lista		Passados ao script nesta ordem, um por linha (as aspas são tratadas pelo robô)
Salvar a saída (STDOUT) na variável *	Variável de saída	`script_output`

+ Avançado (7)

Campo	Tipo	Padrão	Detalhes
Variáveis para o script	Pares chave e valor		Cada linha vira uma variável de ambiente, lida no script como %NOME%
Pasta de trabalho	Pasta		Vazio: a pasta do script (ou uma pasta temporária para o código escrito aqui)
Tempo limite (0 = sem limite)	Número	`300 s`	Ao esgotar, o script e tudo que ele abriu são encerrados
Falhar o robô se o código de saída não for 0	Sim/Não	`Sim`
Mostrar a saída do script no log	Sim/Não	`Sim`	Até 200 linhas do STDOUT e do STDERR vão para o console e para o log da execução
Salvar o código de saída na variável	Variável de saída
Salvar o resultado na variável	Variável de saída		O script grava JSON (ou texto) no arquivo de %A4A_RESULT_FILE%

Resultado: guardado na variável script_output (Texto).

Executar JavaScript (Node.js)

scripts.run_javascript

Executa JavaScript do cliente no Node.js

Como usar

Executa um arquivo .js (ou o código escrito no comando) no Node.js instalado na máquina e guarda o que ele imprime com console.log. Os valores do robô chegam em process.env.NOME e, com o tipo, em JSON na process.env.A4A_VARIABLES. Para rodar JavaScript dentro de uma página, use Web > Executar JavaScript.

Exemplo: Execute C:\scripts\converter.js com o argumento {arquivo} e guarde o JSON que ele grava em process.env.A4A_RESULT_FILE na variável dados.

Campos

Campo	Tipo	Padrão	Detalhes
Origem do script *	Opção	`Arquivo de script do cliente`	Opções: Arquivo de script do cliente, Código escrito aqui
Arquivo JavaScript (.js) *	Arquivo		Só quando «Origem do script» = «Arquivo de script do cliente»
Código *	Código		Ex.: `console.log(process.env.NOME)`Só quando «Origem do script» = «Código escrito aqui»
Argumentos	Lista		Passados ao script nesta ordem, um por linha (as aspas são tratadas pelo robô)
Salvar a saída (STDOUT) na variável *	Variável de saída	`script_output`

+ Avançado (8)

Campo	Tipo	Padrão	Detalhes
Caminho do node.exe	Arquivo		Vazio: o node encontrado no PATH
Variáveis para o script	Pares chave e valor		Cada linha vira uma variável de ambiente (process.env.NOME); todas, com o tipo, em A4A_VARIABLES (JSON)
Pasta de trabalho	Pasta		Vazio: a pasta do script (ou uma pasta temporária para o código escrito aqui)
Tempo limite (0 = sem limite)	Número	`300 s`	Ao esgotar, o script e tudo que ele abriu são encerrados
Falhar o robô se o código de saída não for 0	Sim/Não	`Sim`
Mostrar a saída do script no log	Sim/Não	`Sim`	Até 200 linhas do STDOUT e do STDERR vão para o console e para o log da execução
Salvar o código de saída na variável	Variável de saída
Salvar o resultado na variável	Variável de saída		O script grava JSON (ou texto) no arquivo de process.env.A4A_RESULT_FILE

Resultado: guardado na variável script_output (Texto).