Mise à niveau de Robots vers Python 3.11
Diligent procède à la mise à niveau de la version de Python utilisée par Robots. L'agent Robots dans le cloud sera mis à niveau de Python 3.8.x vers Python 3.11.x, conformément au calendrier ci-dessous. Pendant une période de transition, les deux versions de Python seront prises en charge par Robots.
Cette mise à niveau inclut la mise à jour des bibliothèques associées, y compris les versions 1.2.4 à 2.2.0 de Pandas, et les versions 2.26.0 à 2.31.0 de Requests.
Si votre organisation utilise des robots HighBond ou des robots de flux de travail, lisez cette rubrique pour en savoir plus sur les conséquences de la mise à niveau.
La Python Software Foundation a annoncé la fin de vie officielle de Python 3.8 pour le 14 octobre 2024.
Impact pour les clients
La mise à niveau vers Python 3.11 peut toucher certains de vos scripts Python/HCL. Si la logique de script qui s’exécute dans Python 3.8 ne s’exécute plus dans Python 3.11, vous devez la mettre à jour.
Remarque
- Sur la page d’accueil Robots, un tableau apparaît qui présente la liste de tous les robots dont le script actif contient du code Python bientôt obsolète.
- Une icône d’avertissement apparaît sur le robot dont le script actif contient du code Python bientôt obsolète. L’icône disparaît dès que vous mettez à niveau le robot vers le dernier package et que vous activez le script.
Les clients Robots ne peuvent pas refuser la mise à niveau Python.
La manière la plus simple de vérifier si vos scripts existants s’exécutent sans problème dans Python 3.11 consiste à les ouvrir dans l’éditeur de scripts Robots et à essayer de les exécuter. Pour obtenir plus d'informations, consultez la section , qui contient également un avertissementTester les scripts Python/HCL existants dans l'éditeur de scripts Robots.
Important
Prévoyez assez de temps pour tester tous vos scripts Python/HCL avant le 14 octobre 2024, période à laquelle Python 3.8 ne sera plus disponible dans Robots. Pour éviter toute perturbation au niveau des tâches de robot planifiées, effectuez les mises à jour de scripts nécessaires suffisamment longtemps avant la date limite.
Calendrier de mise à niveau
| Date estimée | Éléments affectés | Détails |
|---|---|---|
| Mi-décembre 2023 | Robots HighBond |
Script récemment créé
Script existant créé avant la mise à niveau Python
|
| 4 avril 2024 | Robots HighBond |
Script récemment créé
Script existant créé avant la mise à niveau Python en décembre 2023
Script mis à niveau vers Python 3.11 après décembre 2023
|
| 4 avril 2024 | Robots de flux de travail |
Script récemment créé
Script existant créé avant la mise à niveau Python
|
| 4 juillet 2024 |
Robots HighBond Robots de flux de travail |
Script existant créé avant la mise à niveau Python Les scripts utilisant le code Python 3.8 ou 3.11 avec les anciennes bibliothèques (Pandas 1.2.4, Requests 2.26.0) ne peuvent pas être manuellement déclassés, téléchargés ou activés. De plus, les scripts incompatibles avec Python 3.11 (HCL 3.0.*) ne peuvent pas être chargés ou activés via des API ou des kits de ressources. |
| 12 juillet 2024 |
Robots HighBond Robots de flux de travail |
Scripts existants créés avant la mise à niveau Python
|
|
14 octobre 2024 |
Robots HighBond Robots de flux de travail |
Tous les scripts (y compris les scripts non modifiés dans les tâches planifiées)
Python 3.8 a officiellement atteint sa fin de vie. Consultez cette page relative au statut des versions Python. |
Tester les scripts Python/HCL existants dans l'éditeur de scripts Robots
Attention
Lorsque vous ouvrez un script Python existant dans l’éditeur de scripts Robots, l’environnement d’exécution Python 3.11 démarre par défaut. Les versions spécifiées des dépendances Python installées (packages) peuvent également être mises à jour.
Ouvrir un script existant dans l’éditeur de scripts
-
Sur la page d’accueil de la barre de lancement (www.highbond.com), sélectionnez l’application Robots pour l’ouvrir.
Si vous êtes déjà dans Diligent One, vous pouvez utiliser le menu de navigation situé à gauche pour basculer vers l’application Robots.
-
Dans le tableau de bord Robots, sélectionnez l’onglet correspondant au type de robot approprié :
-
Robots HighBond
-
Robots de flux de travail
-
-
Accédez à un robot et sélectionnez-le pour l’ouvrir.
-
Dans le coin supérieur droit du robot, cliquez sur Développement pour passer en mode développement.
-
Dans l'onglet Versions du script, sélectionnez la version du script à tester.
Généralement, vous devez sélectionner la version du script qui a été activée en mode production. Si aucune version n'a été activée, sélectionnez la plus récente, sauf si vous avez une raison d'en sélectionner une autre.
-
Dans le panneau Détails sur version, cliquez sur Modifier un script.
L'éditeur de scripts Robots lance le processus de démarrage et charge l'environnement d'exécution Python 3.11. Si le script s'exécute correctement, il n'est pas nécessaire de procéder à des tests liés à l'environnement d'exécution.
Vérifier l'environnement d'exécution
Lors des tests du script, il peut être utile de vérifier quel environnement d'exécution est actuellement actif dans l'éditeur de scripts.
-
Cliquez dans la première cellule du script.
-
Cliquez sur l'icône plus
à gauche de la cellule et sélectionnez Ajouter une cellule ci-dessus. -
Dans la nouvelle cellule, collez ce code :
import sys print(sys.version)
-
Exécutez la cellule.
Le résultat affiche l'environnement d'exécution actuellement actif. Par exemple :
3.11.4 (main, Dec 15 2023, 23:07:06) [GCC 11.4.1 20230605 (Red Hat 11.4.1-2)]
3.8.17 (default, Dec 15 2023, 23:05:28) [GCC 11.4.1 20230605 (Red Hat 11.4.1-2)]
-
Lorsque vous avez terminé de tester un script, supprimez la cellule qui contient le code de la version du système.
Exécuter le script pour le tester
Exécutez le script pour tester s'il est compatible avec l'environnement d'exécution Python 3.11.
Astuce
Si le script met généralement longtemps à s'exécuter parce qu'il importe et analyse un jeu de données important, vous pouvez le modifier temporairement afin de procéder aux tests avec un petit échantillon du jeu de données. L'utilisation de petites quantités de données vous permet de tester les scripts de votre organisation plus rapidement.
Veillez à modifier uniquement le jeu de données cible et non le code Python.
-
Une fois le processus de démarrage terminé, exécutez le script pour le tester.
Si le script s'exécute correctement jusqu'à la fin, cela signifie qu'il est compatible avec Python 3.11. Il n’est pas nécessaire de continuer à tester le script. Vous pouvez enregistrer et transmettre le script, puis l’activer afin de l’associer à l’environnement d’exécution Python 3.11. Consultez les pages Enregistrer et transmettre le script et Activer une version de script.
-
Si le script échoue, vous devez mettre à jour la logique du script pour assurer sa compatibilité avec 3.11. Consultez les ressources Python pour plus d’informations sur les différences entre les différentes versions de Python et les autres bibliothèques associées. Si le script échoue même après avoir mis à jour sa logique, le problème n’est sûrement pas associé à l’environnement d’exécution Python. Vous devez déboguer le script.
Enregistrer et transmettre le script
Lorsque vous enregistrez et transmettez le script, vous l’associez à l’environnement d’exécution Python 3.11.
| Statut du script | Action |
|---|---|
| S’exécute correctement dans Python 3.11 |
|
|
Échoue dans Python 3.11 |
|
Vérifiez que le script s’exécute dans l’environnement Python 3.11
-
Effectuez l’action suivante pour vérifier que l’environnement d’exécution Python 3.11 est actuellement actif dans l’éditeur de scripts :
Vérifier l’environnement d’exécution. Consultez la rubriqueVérifier l'environnement d'exécution.
-
Dans la barre d'outils de l'éditeur de scripts, cliquez sur Enregistrer et transmettre.
-
Saisissez un message de transmission parlant pour décrire vos modifications.
Astuce
Il peut être utile d'ajouter « S'exécute dans Python 3.11 » dans le message de transmission.
-
Facultatif. Sélectionnez Enregistrer la sortie du script dans le fichier journal d'exécution de la tâche.
Quand vous exécutez un script à l'aide d'une tâche de robot, cette option enregistre l'intégralité de la sortie du script dans un fichier journal. Il peut être utile d'examiner la sortie enregistrée quand vous développez et dépannez des scripts. Pour plus d’informations, consultez la section Enregistrer une sortie de script dans un fichier journal.
-
Cliquez sur Transmettre pour enregistrer et transmettre le script.
Le message Votre script a été transmis avec succès apparaît.
-
Dans l'en-tête de la page, cliquez sur le nom du robot.
Vous êtes renvoyé à l'onglet Versions du script du robot. Chaque fois que vous enregistrez et transmettez un script, la version enregistrée est ajoutée à cet onglet.
-
Facultatif. Vérifiez que le script est associé à l'environnement d'exécution Python 3.11 :
-
Sélectionnez la version du script que vous venez d'enregistrer.
-
Dans le panneau Détails sur la version, cliquez sur Télécharger.
Le script est téléchargé sur votre ordinateur.
-
Ouvrez le script dans un éditeur de texte.
L'environnement d'exécution apparaît en haut du script :
"runtime":"python3.11"
-
Ressources Python
Le tableau suivant vous présente les sections Nouveautés, les commentaires de version, ainsi que les journaux des changements et les autres bibliothèques associées. Utilisez ces ressources pour connaître les modifications apportées aux dernières versions de Python et des autres bibliothèques.
| Nom | Lien de référence |
|---|---|
| Python 3.11 | |
| Pandas 2.2.0 | |
| Requêtes 2.31.0 | |
| NumPy >= 1.23.3 | |
| Cryptography >= 39.0.0 | |
| Boxsdk 3.9.2 | |
| Openpyxl 3.1.2 | |
| Jinja 3.1.3 | |
| Simple-salesforce 1.12.5 | |
| Jira 3.8.0 |
