Configurer le connecteur Python

Écrivez et validez des scripts Python personnalisés et exécutez-les dans le cadre de votre automatisation à l’aide du connecteur Python dans Studio de conception de bureau de RPA.

Avant de commencer

Assurez-vous d’avoir installé le module d’extension Scripting sur le Studio de conception de bureau de RPA. Pour l’installer, reportez-vous à la section Gérer les modules d’extension dans Studio de conception de bureau de RPA.

Assurez-vous qu’une version de Python est installée sur votre ordinateur qui fait partie des variables d’environnement. Pour plus d’informations sur les variables d’environnement, voir Définition des variables d’environnement.

Familiarisez-vous avec les limites du script Python. Pour plus d'informations, consultez Limitations du script Python dans le connecteur Python.

Rôle requis : aucun

Procédure

1. Dans le volet Boîte à outils, accédez à Connecteurs > Python
2. Faites glisser le composant Python sous les objets globaux dans le volet Explorateur de projet.
3. Cliquez avec le bouton droit sur le connecteur Python.
4. Cliquez sur Configurer.
   La fenêtre Éditeur de script s’affiche.

   Si Python n’est pas installé sur votre machine, vous rencontrerez un message d’erreur. Veuillez installer Python et recharger le projet.

5. Dans la liste Version Python , sélectionnez une version installée ou disponible sur l’ordinateur de l’utilisateur final, capable d’exécuter l’automatisation et identique ou supérieure à la version d’exécution.
   Remarque :

   Vous affichez une liste des versions de python installées sur votre machine dans la liste des versions de Python.

   Les versions 2.7 et supérieures de Python sont prises en charge. Si votre script n’est pas valide ou exécuté, assurez-vous d’utiliser la version 2.7 ou une version supérieure.

   Par défaut, la version de Python la plus élevée est sélectionnée.

   Si vous sélectionnez la version 2.x et que Python 3.x est installé sur votre ordinateur, l’automatisation s’exécute, mais le script Python peut ne pas s’exécuter. Le script ne s’exécutera que s’il est compatible avec Python 3.x ; Sinon, vous risquez de rencontrer une erreur.

   Pendant l’exécution de l’automatisation, si vous sélectionnez une version spécifique, telle que 3.15.3, et que Python 3.11.3 est installé sur votre ordinateur, l’automatisation ne s’exécute pas et vous rencontrez une erreur. Pour continuer, sélectionnez la même version, 3.15.3, ou une version supérieure de Python.

   Vous pouvez afficher la version de Python utilisée pour l’exécution dans les journaux Studio, qui est créée dans votre profil utilisateur sur votre ordinateur.

   Figure 1. Volet Script et version Python dans l’éditeur de script

   

6. Entrez le script personnalisé dans le volet Script.
   Exemple de script pour la conversion de température et les conseils météorologiques.

   
   def celsius_to_fahrenheit(temp_c: float) -> float:
       """
       Convert a temperature from Celsius to Fahrenheit.    
       Args:
           temp_c (float): Temperature in Celsius.
       Returns:
           float: Temperature in Fahrenheit.
       """
       return (temp_c * 9/5) + 32
   
   
   class WeatherAdvisor:
       """
       A simple class that provides weather advice based on temperature and conditions.
       """
   
       def give_advice(self, city: str, temperature_c: float, is_raining: bool, wind_speed: int) -> str:
           """
           Provide advice based on weather conditions.
           Args:
               city (str): The name of the city.
               temperature_c (float): Current temperature in Celsius.
               is_raining (bool): Whether it is raining.
               wind_speed (int): Wind speed in km/h.
           Returns:
               str: Weather advice message.
           """
           temp_f = celsius_to_fahrenheit(temperature_c)
   
           advice = f"In {city}, it is {temperature_c:.1f}°C ({temp_f:.1f}°F). "
   
           if is_raining:
               advice += "Take an umbrella. "
           else:
               advice += "No rain today. "
   
           if wind_speed > 30:
               advice += "It’s quite windy, be cautious!"
           else:
               advice += "Winds are calm."
   
           return advice
   
   
   # Example usage
   if __name__ == "__main__":
       advisor = WeatherAdvisor()
   
       message = advisor.give_advice(
           city="London",
           temperature_c=18.5,
           is_raining=True,
           wind_speed=25
       )
   
       print(message)
    

7. Sélectionnez Valider.
   Si votre script personnalisé comporte des erreurs, celles-ci s’affichent dans le volet Erreurs. Résolvez les erreurs et sélectionnez Valider pour vérifier à nouveau les erreurs.
8. Cliquez sur OK.
   Si vous souhaitez enregistrer les changements, sélectionnez Oui. Le code est validé. Si vous souhaitez ignorer les modifications, sélectionnez Non.
9. Double-cliquez sur le connecteur Python pour exposer les méthodes sous le volet Explorateur d’objets.
10. Faites glisser les méthodes vers l’aire de conception.
    Pour plus d’informations sur les méthodes de connecteur Python, reportez-vous à la section Méthodes du connecteur Python.

Conversion de température et conseils météo

Effectuez les étapes suivantes pour exécuter l’automatisation de conversion de température et les conseils météorologiques.

1. Dans le volet Boîte à outils, accédez à Général > Variable.
2. Faites glisser le composant Variable vers l’aire de conception.
3. Double-cliquez sur le composant Variable et définissez ces paramètres comme indiqué dans l’image.

   Figure 2. Paramètres pour le conteneur de variables

   

4. Double-cliquez sur le connecteur Python dans les objets globaux.
5. Faites glisser la méthode Exécuter de l’Explorateur d’objets vers la surface de conception.
6. Sélectionnez le composant et cliquez sur l’icône Paramètres de méthode ( ) ou double-cliquez sur la barre de tête du composant.
7. Cochez la case Afficher les fonctions , puis sélectionnez la fonction celsius_to_fahrenheit dans la liste Fonctions.
8. Sélectionnez OK.
9. Faites glisser à nouveau la méthode Exécuter de l’Explorateur d’objets vers la surface de conception.
10. Cochez la case Afficher les fonctions , puis sélectionnez la fonction celsius_to_fahrenheit dans la liste Fonctions.
11. Sélectionnez l’option WeatherAdvisor dans la liste Classes.
12. Sélectionnez give_advice option dans la liste Méthodes.
13. Sélectionnez OK.
14. Connectez les ports des composants comme illustré dans l’image suivante.

    Figure 3. Connexion des ports pour le composant variable et les méthodes d’exécution

    

15. Pour tester le composant, cliquez avec le bouton droit sur le composant Variable et sélectionnez Exécuter à partir d’ici.

    Figure 4. Exemple de résultat pour la température

    

    Figure 5. Exemple de résultat pour les conseils météorologiques