Aller au contenu principal

Exécuter le Script Python

Configuration actuelle de la tâche Run Script Python dans le Workflow Designer

La tâche Exécuter le Script Python permet d'exécuter des scripts Python en configurant si l'exécution se déroule localement ou sur un système distant, en définissant les paramètres de connexion et le script à exécuter.

Configuration​

L'onglet Configuration est le cœur de la tâche et est divisé en deux sous-onglets : Connexion et Script.

Sous-onglet “Connexion”​

Cette section permet de définir comment la tâche se connectera au système où le script Python sera exécuté. La configuration varie en fonction du “Type de Connexion” sélectionné.

Type de Connexion​

Ce menu permet de choisir parmi différents modes de connexion :

Par Défaut :​

  • Description : Utilise une configuration de connexion par défaut au niveau du système ou du projet. Aucun champ de configuration spécifique n'est visible, car les paramètres sont hérités.
Manuel :​
  • Description : Permet de définir manuellement tous les paramètres de connexion pour l'exécution du script.
  • Champs spécifiques :
  • Adresse IP : L'adresse IP du serveur distant sur lequel exécuter le script.
  • Nom d'hôte : Le nom d'hôte du serveur distant. Peut être utilisé alternativement à l'Adresse IP.
  • Utilisateur : Le nom d'utilisateur pour l'accès au serveur distant.
  • Clé SSH : Une case à cocher pour activer l'authentification via clé SSH. Si sélectionné, un champ est généralement disponible pour sélectionner la clé.
  • Mot de passe : Un bouton “Définir mot de passe” qui ouvre une boîte de dialogue sécurisée pour saisir le mot de passe de l'utilisateur.
  • Port : Le port pour la connexion SSH.
  • Exécutable Python : le nom de l'exécutable Python sur le système de destination (ex. python3).
  • Environnement Virtuel : Une case à cocher qui, si sélectionnée, active l'utilisation d'un environnement virtuel Python.
Environnement :​
  • Description : Permet de sélectionner une configuration de connexion précédemment enregistrée comme “Environnement”. Ceci est utile pour réutiliser des ensembles de paramètres de connexion.
  • Champs spécifiques :
  • Connexion Environnement : Un menu où choisir parmi les configurations d'environnement enregistrées (ex. “SSH test”).
  • Note : Une fois un environnement sélectionné, les champs suivants (Adresse IP, Nom d'hôte, Utilisateur, etc.) seront préremplis avec les valeurs de l'environnement choisi.

Sous-onglet “Script”​

Cette section est dédiée à l'insertion et à la gestion du code Python à exécuter.

Éditeur Python​

  • Description : Un éditeur de texte intégré où il est possible d'écrire ou de copier directement le code Python que l'on souhaite exécuter.
  • Utilisation : Le code inséré ici sera exécuté sur le système spécifié dans la sous-onglet “Connexion”, en utilisant l'exécutable Python configuré.

Les champs de configuration de la Tâche peuvent être valorisés manuellement ou via paramètres et variables du flux de travail.

Paramètres de Sortie​

À la fin de l'exécution, la tâche rend disponibles les Paramètres de Sortie suivants, utilisables comme entrées dans les tâches suivantes du Workflow.

  • result : Contient un message textuel décrivant le résultat de l'exécution du script ou un message d'erreur (ex. “Missing server address”).
  • resultJson : représente le résultat de l'exécution de la tâche au format JSON, incluant des informations générales, les configurations et les détails sur l'exécution.
  • content : retourne le code Python écrit dans le champ Script