Pular para o conteúdo principal

Executar Script Python

Configuração atual da tarefa Run Script Python no Workflow Designer

A tarefa Executar Script Python permite executar scripts Python configurando se a execução ocorrer localmente ou num sistema remoto, definindo as configurações de conexão e o script a ser executado.

Configuração​

A aba Configuração é o núcleo da tarefa e divide-se em duas subabas: Conexão e Script.

Subaba “Conexão”​

Esta seção permite definir como a tarefa se conectará ao sistema onde o script Python será executado. A configuração varia consoante o “Tipo de Conexão” selecionado.

Tipo de Conexão​

Este menu permite escolher entre diferentes modos de conexão:

Padrão:​

  • Descrição: Utiliza uma configuração de conexão padrão a nível de sistema ou de projeto. Não são visíveis campos de configuração específicos, pois as configurações são herdadas.
Manual:​
  • Descrição: Permite definir manualmente todos os parâmetros de conexão para a execução do script.
  • Campos específicos:
  • Endereço IP: O endereço IP do servidor remoto onde executar o script.
  • Hostname: O nome de host do servidor remoto. Pode ser usado em alternativa ao Endereço IP.
  • Utilizador: O nome de utilizador para acesso ao servidor remoto.
  • Chave SSH: Uma caixa de seleção para habilitar a autenticação por chave SSH. Se selecionado, geralmente habilita um campo para seleção da chave.
  • Palavra-passe: Um botão “Definir palavra-passe” que abre uma caixa de diálogo segura para inserir a palavra-passe do utilizador.
  • Porta: A porta para a conexão SSH.
  • Executável Python: o nome do executável Python no sistema de destino (ex. python3).
  • Ambiente Virtual: Uma caixa de seleção que, se marcada, habilita o uso de um ambiente virtual Python.
Ambiente:​
  • Descrição: Permite selecionar uma configuração de conexão previamente guardada como “Ambiente”. Isto é útil para reutilizar conjuntos de parâmetros de conexão.
  • Campos específicos:
  • Conexão Ambiente: Um menu onde escolher entre as configurações de ambiente guardadas (ex. “Teste SSH”).
  • Nota: Uma vez selecionado um ambiente, os campos abaixo (Endereço IP, Hostname, Utilizador, etc.) serão pré-preenchidos com os valores do ambiente escolhido.

Subaba “Script”​

Esta seção é dedicada à inserção e gestão do código Python a ser executado.

Editor Python​

  • Descrição: Um editor de texto integrado onde é possível escrever ou colar diretamente o código Python que se deseja executar.
  • Utilização: O código inserido aqui será executado no sistema especificado na subaba “Conexão”, utilizando o executável Python configurado.

Os campos de configuração da Tarefa podem ser preenchidos manualmente ou através de parâmetros e variáveis do fluxo de trabalho.

Parâmetros de Saída​

Ao completar a execução, a tarefa disponibiliza os seguintes Parâmetros de Saída, utilizáveis como entrada em tarefas subsequentes do Workflow.

  • result: Contém uma mensagem de texto que descreve o resultado do script ou uma mensagem de erro (ex. “Missing server address”).
  • resultJson: representa o resultado da execução da tarefa em formato JSON, incluindo informações gerais, configurações e detalhes da execução.
  • content: retorna o código Python escrito no campo Script