Sistema Operacional

Processos, comandos, área de transferência, registro e ambiente

Executar Comando

system.run_command

Executa comando no terminal (cmd)

Como usar

Executa um comando do prompt (cmd) e guarda a saída e, se quiser, o código de saída. Por padrão um código diferente de 0 falha o robô; desmarque para tratar você mesmo.

Exemplo: Execute robocopy C:\Saida \\servidor\relatorios /E e guarde o código de saída.

Campos

Campo	Tipo	Padrão	Detalhes
Comando *	Texto		Ex.: `dir C:\temp`
Pasta de trabalho	Pasta
Salvar a saída na variável *	Variável de saída	`output`

+ Avançado (3)

Campo	Tipo	Padrão
Tempo limite (0 = sem limite)	Número	`300 s`
Falhar o robô se retornar erro	Sim/Não	`Sim`
Salvar o código de saída na variável	Variável de saída

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

Executar PowerShell

system.run_powershell

Executa script PowerShell

Como usar

Executa um script PowerShell e guarda a saída. Passe valores do robô como variáveis de ambiente ($env:NOME), evitando montar o script com texto.

Exemplo: Execute Get-ChildItem $env:PASTA | Measure-Object com PASTA = {pasta_entrada} para contar os arquivos.

Campos

Campo	Tipo	Padrão	Detalhes
Script *	Código
Salvar resultado na variável *	Variável de saída	`output`

+ Avançado (3)

Campo	Tipo	Padrão	Detalhes
Tempo limite (0 = sem limite)	Número	`300 s`
Variáveis para o script ($env:NOME)	Pares chave e valor		Cada linha vira uma variável de ambiente, lida no script como $env:NOME
Falhar o robô se retornar erro	Sim/Não	`Sim`

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

Obter Variável de Ambiente

system.get_env

Lê variável de ambiente

Como usar

Lê uma variável de ambiente do Windows, com um valor padrão se ela não existir.

Exemplo: Leia USERPROFILE em {pasta_usuario}.

Campos

Campo	Tipo	Padrão	Detalhes
Nome da variável *	Texto		Ex.: `USERPROFILE`
Valor padrão (se não existir)	Texto
Salvar resultado na variável *	Variável de saída	`env_value`

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

Definir Variável de Ambiente

system.set_env

Define variável de ambiente

Como usar

Define uma variável de ambiente para este robô (process) ou para o usuário do Windows (user, persistente).

Exemplo: Defina ERP_AMBIENTE = PRODUCAO para os programas chamados pelo robô.

Campos

Campo	Tipo	Padrão	Detalhes
Nome da variável *	Texto
Valor	Texto
Alcance	Opção	`Este robô (e os programas que ele abrir)`	Opções: Este robô (e os programas que ele abrir), Usuário do Windows (permanente)

Obter Info do Sistema

system.system_info

CPU, RAM, disco, SO, hostname

Como usar

Guarda informações da máquina: sistema, nome, CPU, memória e disco. Útil em logs de diagnóstico.

Exemplo: Registre {system_info} no log no início da execução.

Campos

Campo	Tipo	Padrão	Detalhes
Salvar as informações na variável *	Variável de saída	`system_info`	Campos: hostname, user, os, cpu_percent, memory_available_gb, disk_free_gb, boot_time...

Resultado: guardado na variável system_info (Dicionário).

Listar Processos

system.list_processes

Lista processos em execução

Como usar

Lista os processos em execução, opcionalmente filtrando pelo nome, com PID e memória.

Exemplo: Liste os processos com nome "EXCEL" para saber se há planilhas abertas.

Campos

Campo	Tipo	Padrão	Detalhes
Filtro de nome (vazio = todos)	Texto		Ex.: `excel`
Salvar resultado na variável *	Variável de saída	`processes`	Lista de {pid, name, user, memory_mb, started}

Resultado: guardado na variável processes (Lista).

Encerrar Processo

system.kill_process

Mata processo por nome ou PID

Como usar

Encerra processos pelo nome ou PID, com os processos filhos. Use para limpar programas travados antes de começar.

Exemplo: Encerre erp.exe no início do robô para garantir uma sessão limpa.

Campos

Campo	Tipo	Padrão	Detalhes
Nome do processo ou PID *	Texto		Aceita excel, excel.exe, chrom* ou o número do PIDEx.: `excel.exe`
Encerrar também os processos filhos	Sim/Não	`Sim`
Salvar quantos foram encerrados na variável	Variável de saída

+ Avançado (1)

Campo	Tipo	Padrão	Detalhes
Falhar se nenhum processo for encontrado	Sim/Não	`Não`

Resultado: guardado na variável escolhida (Número).

Aguardar Processo

system.wait_process

Espera processo iniciar ou encerrar

Como usar

Espera um processo iniciar ou terminar, como um instalador ou uma exportação feita por outro programa.

Exemplo: Aguarde até 600 s o processo exportador.exe terminar antes de ler o arquivo.

Campos

Campo	Tipo	Padrão	Detalhes
Nome do processo ou PID *	Texto		Ex.: `excel.exe`
Esperar o processo	Opção	`Terminar`	Opções: Terminar, Iniciar
Tempo limite (0 = sem limite)	Número	`60 s`
Salvar o resultado (verdadeiro/falso) na variável	Variável de saída

+ Avançado (1)

Campo	Tipo	Padrão	Detalhes
Falhar o robô se o tempo esgotar	Sim/Não	`Sim`

Resultado: guardado na variável escolhida (Booleano).

Obter Área de Transferência

system.get_clipboard

Lê conteúdo da clipboard

Como usar

Lê o texto da área de transferência. Útil depois de um Ctrl+C em programas de onde não dá para ler o texto direto.

Exemplo: Depois de Ctrl+A e Ctrl+C no relatório, leia a área de transferência em {texto_relatorio}.

Campos

Campo	Tipo	Padrão	Detalhes
Salvar resultado na variável *	Variável de saída	`clipboard`

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

Definir Área de Transferência

system.set_clipboard

Define conteúdo da clipboard

Como usar

Coloca um texto na área de transferência, para colar com Ctrl+V em campos que não aceitam digitação direta.

Exemplo: Copie {observacao} para a área de transferência e cole no campo de texto longo.

Campos

Campo	Tipo	Padrão	Detalhes
Texto *	Texto (várias linhas)

Abrir Arquivo/URL

system.open_file_url

Abre com programa padrão do sistema

Como usar

Abre um arquivo, pasta ou endereço com o programa padrão do Windows, ou manda imprimir o arquivo.

Exemplo: Imprima {caminho_etiqueta} na impressora padrão.

Campos

Campo	Tipo	Padrão	Detalhes
Arquivo, pasta ou URL *	Texto		Ex.: `C:\relatorios\relatorio.pdf`
Ação	Opção	`Abrir com o programa padrão`	Opções: Abrir com o programa padrão, Imprimir

Obter Valor do Registro

system.get_registry

Lê valor do registro do Windows

Como usar

Lê um valor do registro do Windows (chave e nome do valor), com um padrão se não existir.

Exemplo: Leia HKLM\SOFTWARE\ERP\InstallDir para achar onde o ERP está instalado.

Campos

Campo	Tipo	Padrão	Detalhes
Chave *	Texto		Exemplo: HKEY_CURRENT_USER\Software\Empresa (também HKCU, HKLM)
Nome do valor (vazio = padrão)	Texto
Valor padrão (se não existir)	Texto
Salvar resultado na variável *	Variável de saída	`registry_value`

Resultado: guardado na variável registry_value (Qualquer).

Definir Valor do Registro

system.set_registry

Escreve valor no registro

Como usar

Grava um valor no registro do Windows, no tipo escolhido. Chaves em HKLM exigem permissão de administrador.

Exemplo: Grave HKCU\Software\ERP\UltimoLote = {lote}.

Campos

Campo	Tipo	Padrão	Detalhes
Chave *	Texto		Exemplo: HKEY_CURRENT_USER\Software\Empresa (também HKCU, HKLM)
Nome do valor (vazio = padrão)	Texto
Valor	Texto
Tipo	Opção	`Texto (REG_SZ)`	Opções: Texto (REG_SZ), Texto com %VARIÁVEIS% (REG_EXPAND_SZ), Número (REG_DWORD), Número grande (REG_QWORD), Várias linhas (REG_MULTI_SZ)

Obter Usuário Atual

system.current_user

Retorna nome do usuário logado

Como usar

Guarda o usuário do Windows que está executando o robô, com o domínio se quiser.

Exemplo: Registre "Executado por {username}" no relatório.

Campos

Campo	Tipo	Padrão	Detalhes
Incluir o domínio (DOMINIO\usuario)	Sim/Não	`Não`
Salvar resultado na variável *	Variável de saída	`username`

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

Obter Nome do Computador

system.hostname

Retorna hostname da máquina

Como usar

Guarda o nome do computador. Útil para diferenciar máquinas nos logs e nos arquivos gerados.

Exemplo: Salve o relatório como relatorio_{hostname}.xlsx.

Campos

Campo	Tipo	Padrão	Detalhes
Salvar resultado na variável *	Variável de saída	`hostname`

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

Caixa de Mensagem

system.message_box

Mostra uma mensagem (alerta, popup) na tela e espera o clique; devolve o botão clicado

Como usar

Mostra uma mensagem na tela e espera o clique, devolvendo o botão escolhido (ok, cancel, yes, no ou timeout). Pode fechar sozinha após alguns segundos. Use só em robôs assistidos: em produção sem ninguém na frente, defina o tempo para não travar.

Exemplo: Pergunte "Confirma o envio de {qtd} boletos?" com Sim/Não e siga só se {answer} == "yes".

Campos

Campo	Tipo	Padrão	Detalhes
Mensagem *	Texto (várias linhas)
Título	Texto	`A4A`
Ícone	Opção	`Informação`	Opções: Informação, Aviso, Erro, Pergunta, Nenhum
Botões	Opção	`OK`	Opções: OK, OK / Cancelar, Sim / Não, Sim / Não / Cancelar
Fechar sozinha após (0 = esperar)	Número	`0 s`
Salvar botão clicado na variável (ok, cancel, yes, no ou timeout)	Variável de saída	`answer`	Só quando «Botões» = «OK / Cancelar» ou «Sim / Não» ou «Sim / Não / Cancelar»

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

Pedir Texto ao Usuário

system.input_box

Abre uma janela (input box) para o usuário digitar um valor

Como usar

Abre uma janela para a pessoa digitar um valor (com texto oculto para senhas) e guarda o que foi digitado; cancelar devolve vazio (None). Para robôs assistidos.

Exemplo: Peça "Informe o número do lote" e use {user_text} na busca.

Campos

Campo	Tipo	Padrão
Mensagem *	Texto (várias linhas)
Título	Texto	`A4A`
Valor padrão (também usado se o tempo esgotar)	Texto
Ocultar o texto digitado (senha)	Sim/Não	`Não`
Fechar sozinha após (0 = esperar)	Número	`0 s`
Salvar texto na variável (None se cancelar) *	Variável de saída	`user_text`

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