Robots-Upgrade auf Python 3.11
Diligent führt ein Upgrade der von Robots verwendeten Python-Version durch. Der cloudbasierte Robots-Agent wird gemäß dem unten stehenden Zeitplan von Python 3.8.x auf Python 3.11.x aktualisiert. Während eines Übergangszeitraums werden beide Python-Versionen von Robots unterstützt.
Dieses Upgrade beinhaltet auch die Aktualisierung der zugehörigen Bibliotheken, einschließlich Pandas von Version 1.2.4 auf 2.2.0 und Requests von Version 2.26.0 auf 2.31.0.
Wenn Ihre Organisation HighBond-Robots oder Workflow-Robots verwendet, lesen Sie diese Informationen zu den Auswirkungen des Upgrades.
Die Python Software Foundation hat angekündigt, dass Python 3.8 am 14. Oktober 2024 offiziell eingestellt wird.
Auswirkungen auf Kunden
Einige Ihrer Python/HCL-Skripte könnten vom Upgrade auf Python 3.11 betroffen sein. Wenn Skriptlogik, die in Python 3.8 funktioniert, in Python 3.11 nicht mehr ausgeführt wird, müssen Sie die Skriptlogik aktualisieren.
Hinweis
- Auf der Startseite der Robots-App wird eine Tabelle angezeigt, in der alle Robots mit einem aktivierten Skript aufgeführt sind, das Python-Code enthält, der bald veraltet ist.
- Auf dem Robot mit einem aktivierten Skript, das Python-Code enthält, der bald veraltet ist, wird ein Warnsymbol angezeigt. Dieses Symbol verschwindet, sobald Sie den Robot auf das neueste Paket aktualisieren und das Skript aktivieren.
Robots-Kunden können das Python-Upgrade nicht umgehen.
Um zu prüfen, ob Ihre vorhandenen Skripte in Python 3.11 problemlos laufen, testen Sie diese am besten im Robots-Skript-Editor. Weitere Informationen und einen Warnhinweis finden Sie unter Vorhandene Python/HCL-Skripte im Robots-Skript-Editor testen.
Wichtig
Planen Sie ausreichend Zeit ein, um alle Ihre Python/HCL-Skripte vor dem 14. Oktober 2024 zu testen, wenn Python 3.8 nicht mehr mit Robots verwendet werden kann. Damit geplante Robot-Aufgaben nicht unterbrochen werden, nehmen Sie eventuell erforderliche Skriptaktualisierungen rechtzeitig vor dem Endtermin vor.
Upgrade-Zeitplan
| Voraussichtliches Datum | Betroffener Bereich | Details |
|---|---|---|
| Mitte Dezember 2023 | HighBond-Robots |
Neu erstelltes Skript
Vorhandenes Skript, das vor dem Python-Upgrade erstellt wurde
|
| 4. April 2024 | HighBond-Robots |
Neu erstelltes Skript
Vorhandenes Skript, das vor dem Python-Upgrade im Dezember 2023 erstellt wurde
Skript, das nach Dezember 2023 auf Python 3.11 aktualisiert wurde
|
| 4. April 2024 | Workflow-Robots |
Neu erstelltes Skript
Vorhandenes Skript, das vor dem Python-Upgrade erstellt wurde
|
| 4. Juli 2024 |
HighBond-Robots Workflow-Robots |
Vorhandenes Skript, das vor dem Python-Upgrade erstellt wurde Skripts mit dem Python-Code 3.8 oder 3.11 mit den alten Bibliotheken (Pandas 1.2.4, Requests 2.26.0) können nicht manuell herabgestuft, hochgeladen oder aktiviert werden. Außerdem können Skripts, die nicht mit Python 3.11 (HCL 3.0.*) kompatibel sind, nicht hochgeladen oder über APIs oder Toolkits aktiviert werden. |
| 12. Juli 2024 |
HighBond-Robots Workflow-Robots |
Vorhandene Skripts, die vor dem Python-Upgrade erstellt wurden
|
|
14. Oktober 2024 |
HighBond-Robots Workflow-Robots |
Alle Skripte (einschließlich unbearbeiteter Skripte in geplanten Aufgaben)
Python 3.8 wird offiziell eingestellt. Siehe Status von Python-Versionen. |
Vorhandene Python/HCL-Skripte im Robots-Skript-Editor testen
Achtung
Wenn Sie ein vorhandenes Python-Skript im Robots-Skript-Editor öffnen, wird standardmäßig die Python 3.11-Laufzeitumgebung gestartet. Die angegebenen Versionen installierter Python-Anhängigkeiten (Pakete) können ebenfalls aktualisiert werden.
Neues oder bestehendes Skript im Skript-Editor öffnen
-
Wählen Sie auf der Launchpad-Startseite (www.highbond.com) die Robots-App aus, um sie zu öffnen.
Wenn Sie sich bereits in Diligent One befinden, können Sie über das linke Navigationsmenü zur Robots-App wechseln.
-
Wählen Sie im Dashboard in Robots die Registerkarte für den entsprechenden Robot-Typ aus:
-
HighBond-Robots
-
Workflow-Robots
-
-
Navigieren Sie zu einem Robot und wählen Sie den Robot aus, um ihn zu öffnen.
-
Klicken Sie in der oberen rechten Ecke des Robots auf Entwicklung, um in den Entwicklermodus zu wechseln.
-
Wählen Sie auf der Registerkarte Skriptversionen die Version des Skripts aus, die Sie testen möchten.
In der Regel sollten Sie hier die Version des Skripts auswählen, die für den Produktionsmodus aktiviert wurde. Wenn keine Version aktiviert wurde und keine bestimmte Version zu bevorzugen ist, wählen Sie die neueste Skriptversion aus.
-
Klicken Sie im Bereich Versionsdetails auf Skript bearbeiten.
Der Robots-Skript-Editor wird gestartet und lädt die Python 3.11-Laufzeitumgebung. Wenn das Skript derzeit erfolgreich ausgeführt wird, sind keine Tests bezüglich der Laufzeitumgebung erforderlich.
Laufzeitumgebung prüfen
Nachdem Sie das Skript getestet haben, sollten Sie eventuell prüfen, welche Laufzeitumgebung derzeit im Skript-Editor aktiv ist.
-
Klicken Sie auf die erste Zelle im Skript.
-
Klicken Sie auf das Symbol „Mehr“
links neben der Zelle und wählen Sie Zelle oberhalb hinzufügen aus. -
Fügen Sie in der neuen Zelle den folgenden Code ein:
import sys print(sys.version)
-
Führen Sie die Zelle aus.
Als Ergebnis wird die derzeit aktive Laufzeitumgebung angezeigt. Beispiel:
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)]
-
Wenn Sie das Skript fertig getestet haben, löschen Sie die Zelle mit dem Systemversionscode.
Skript ausführen und testen
Führen Sie das Skript aus, um zu testen, ob es mit der Python 3.11-Laufzeitumgebung kompatibel ist.
Tipp
Wenn das Skript in der Regel lange dauert, da es ein großes Dataset importiert und analysiert, können Sie es zum Testen vorübergehend so ändern, dass es nur ein kleines Probe-Dataset verwendet. Durch Verwendung kleiner Datenmengen können Sie die Skripte Ihrer Organisation schneller testen.
Achten Sie darauf, nur das Ziel-Dataset und nicht den Python-Code zu ändern.
-
Wenn der Startprozess abgeschlossen ist, führen Sie das Skript aus, um es zu testen.
Wenn das Skript erfolgreich abgeschlossen wird, ist es mit Python 3.11 kompatibel. Dann sind keine weiteren Tests des Skripts erforderlich. Sie können das Skript speichern und übermitteln und anschließend aktivieren, um es mit der Python 3.11-Laufzeitumgebung zu verknüpfen. Siehe Skript speichern und übermitteln und Skriptversion aktivieren.
-
Wenn das Skript fehlschlägt, müssen Sie die Skriptlogik für Kompatibilität mit 3.11 aktualisieren. Informationen zu den Unterschieden zwischen verschiedenen Python-Versionen und anderen verwandten Bibliotheken finden Sie in den Python-Ressourcen. Wenn das Skript auch nach der Aktualisierung der Skriptlogik fehlschlägt, ist das Problem wahrscheinlich nicht auf die Python-Laufzeitumgebung zurückzuführen. Sie müssen das Skript debuggen.
Skript speichern und übermitteln
Wenn Sie das Skript speichern und übermitteln, verknüpfen Sie es mit der Python 3.11-Laufzeitumgebung.
| Skriptstatus | Aktion |
|---|---|
| Wird erfolgreich in Python 3.11 ausgeführt |
|
|
Schlägt fehl in Python 3.11 |
|
Stellen Sie sicher, dass sich das Skript in der Python 3.11-Laufzeitumgebung befindet.
-
Führen Sie den folgenden Schritt aus, um sicherzustellen, dass die Python 3.11-Laufzeitumgebung derzeit im Skript-Editor aktiv ist:
Prüfen Sie die Laufzeitumgebung. Siehe Laufzeitumgebung prüfen.
-
Klicken Sie in der Symbolleiste des Skript-Editors auf Speichern und übermitteln.
-
Geben Sie eine aussagekräftige Übermittlungsnachricht ein, um Ihre Änderungen zu beschreiben.
Tipp
Es könnte sich anbieten, „Wird in Python 3.11 ausgeführt“ in der Übermittlungsnachricht hinzuzufügen.
-
Optional. Wählen Sie Skriptausgabe in der Protokolldatei der Aufgabenausführung speichern.
Wenn Sie ein Skript mit einer Robot-Aufgabe ausführen, speichert diese Option die gesamte Skriptausgabe in einer Protokolldatei. Die gespeicherte Ausgabe kann zu Prüfzwecken bei der Entwicklung von Fehlerbehebung von Skripten hilfreich sein. Weitere Informationen finden Sie unter Skriptausgabe in einer Protokolldatei speichern.
-
Klicken Sie auf Übermitteln, um das Skript zu speichern und zu übermitteln.
Die Meldung Ihr Skript wurde erfolgreich übermittelt wird angezeigt.
-
Klicken Sie in der Seitenkopfzeile auf den Namen des Robots.
Sie gelangen wieder zur Registerkarte Skriptversionen im Robot. Jedes Mal, wenn Sie ein Skript speichern und übermitteln, wird die gespeicherte Version dieser Registerkarte hinzugefügt.
-
Optional. Stellen Sie sicher, dass das Skript mit der Python 3.11-Laufzeitumgebung verknüpft ist:
-
Wählen Sie die gerade gespeicherte Skriptversion aus.
-
Klicken Sie im Bereich Versionsdetails auf Herunterladen.
Das Skript wird auf Ihren Computer heruntergeladen.
-
Öffnen Sie das Skript in einem Texteditor.
Die zugehörige Laufzeitumgebung wird oben im Skript angezeigt:
"runtime":"python3.11"
-
Python-Ressourcen
Die folgende Tabelle zeigt die Abschnitte mit den Neuerungen, Versionshinweisen und Änderungsprotokollen von Python und anderen verwandten Bibliotheken. Nutzen Sie diese Ressourcen, um sich über die Änderungen in den neuesten Versionen von Python und anderen Bibliotheken zu informieren.
| Name | Referenz-Link |
|---|---|
| Python 3.11 | |
| Pandas 2.2.0 | |
| Requests 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 |
