Schreiben und validieren Sie anwenderdefinierte Python-Skripts, und führen Sie sie als Teil Ihrer Automatisierung mit dem Python-Connector in aus RPA Desktop Design Studio.

Vorbereitungen

Stellen Sie sicher, dass Sie das Plugin „Skripting“ auf installiert haben RPA Desktop Design Studio. Informationen zur Installation finden Sie unter Verwalten Sie Plugins in RPA Desktop Design Studio.

Stellen Sie sicher, dass auf Ihrem Computer eine Python-Version installiert ist, die Teil der Umgebungsvariablen ist. Weitere Informationen zu Umgebungsvariablen finden Sie unter Umgebungsvariablen werden festgelegt .

Machen Sie sich mit den Einschränkungen des Python-Skripts vertraut. Weitere Informationen finden Sie unter Einschränkungen des Python-Skripts im Python-Connector.

Erforderliche Rolle: keine

Prozedur

  1. Navigieren Sie im Toolbox-Bereich zu Connectors > Python
  2. Ziehen Sie die Python-Komponente unter Globale Objekte im Bereich Projekt-Explorer.
  3. Klicken Sie mit der rechten Maustaste auf den Python-Connector.
  4. Klicken Sie auf Konfigurieren.
    Das Fenster Skripteditor wird angezeigt.

    Wenn Python nicht auf Ihrem Computer installiert ist, wird eine Fehlermeldung angezeigt. Installieren Sie Python, und laden Sie das Projekt erneut.

  5. In Python-Version Wählen Sie eine Version aus, die auf dem Computer des Endanwenders installiert oder verfügbar ist, die Automatisierung ausführen kann und die mit der Laufzeitversion identisch oder höher ist.
    Hinweis:

    Sie zeigen eine Liste der installierten Python-Versionen auf Ihrem Computer in der Liste der Python-Versionen an.

    Python-Versionen 2,7 und höher werden unterstützt. Wenn Ihr Skript nicht validiert oder ausgeführt wird, stellen Sie sicher, dass Sie Version 2,7 oder eine höhere Version verwenden.

    Standardmäßig ist die am höchsten installierte Python-Version ausgewählt.

    Wenn Sie Version 2.x auswählen und Python 3.x auf Ihrem Computer installiert ist, wird die Automatisierung ausgeführt, das Python-Skript wird jedoch möglicherweise nicht ausgeführt. Das Skript wird nur ausgeführt, wenn es mit Python 3.x kompatibel ist. Andernfalls kann ein Fehler auftreten.

    Wenn Sie während der Ausführung der Automatisierung eine bestimmte Version auswählen, z. B. 3.15.3, und Python 3.11.3 auf Ihrem Computer installiert ist, wird die Automatisierung nicht ausgeführt, und es wird ein Fehler angezeigt. Um fortzufahren, wählen Sie dieselbe Version, 3.15.3 oder eine höhere Version von Python aus.

    Sie können die Python-Version, die für die Ausführung verwendet wird, in den Studio-Protokollen anzeigen, die in Ihrem Anwenderprofil auf Ihrem Computer erstellt werden.

    Abbildung : 1. Skriptbereich und Python-Version im Skripteditor
    Skriptbereich und Python-Version im Skripteditor.
  6. Geben Sie das anwenderdefinierte Skript im Skriptbereich ein.
    Beispielskript für Temperaturumrechnung und Wetterberatung.
    
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. Wählen Sie Aus Validieren .
    Wenn Ihr anwenderdefiniertes Skript Fehler aufweist, wird es im Bereich Fehler angezeigt. Beheben Sie die Fehler, und wählen Sie aus Validieren Um erneut auf Fehler zu überprüfen.
  8. Klicken Sie auf OK.
    Wenn Sie die Änderungen speichern möchten, wählen Sie aus Ja . Der Code ist validiert. Wenn Sie die Änderungen verwerfen möchten, wählen Sie aus Nein .
  9. Doppelklicken Sie auf den Python-Connector, um die Methoden im Objekt-Explorer-Bereich anzuzeigen.
  10. Ziehen Sie die Methoden auf die Design-Oberfläche.
    Weitere Informationen zu Python-Connector-Methoden finden Sie unter Python-Connector-Methoden.

Beispiel: Temperaturumrechnung und Wetterberatung

Führen Sie die folgenden Schritte aus, um die Automatisierung für Temperaturumrechnung und Wetterberatung auszuführen.

  1. Navigieren Sie im Toolbox-Bereich zu Allgemein > Variablean.
  2. Ziehen Sie die Variablenkomponente auf die Designoberfläche.
  3. Doppelklicken Sie auf die Variablenkomponente, und legen Sie diese Parameter wie in der Abbildung gezeigt fest.
    Abbildung : 2. Parameter für Variablencontainer
    Parameter wie Temperatur, Stadt, isRaining und Windgeschwindigkeit werden im Variablencontainer festgelegt.
  4. Doppelklicken Sie in den globalen Objekten auf den Python-Connector.
  5. Ziehen Sie die Ausführungsmethode aus dem Objekt-Explorer in die Entwurfsoberfläche.
  6. Wählen Sie die Komponente aus, und klicken Sie auf das Symbol für die Methodeneinstellungen ( Symbol für Methodeneinstellungen) Oder doppelklicken Sie auf die Kopfleiste der Komponente.
  7. Wählen Sie aus Funktionen Anzeigen Aktivieren Sie das Kontrollkästchen, und aktivieren Sie das celsius_to_fahrenheit Funktion aus der Funktionsliste.
  8. Wählen Sie OK.
  9. Ziehen Sie die Ausführungsmethode erneut aus dem Objekt-Explorer auf die Designoberfläche.
  10. Wählen Sie aus Funktionen Anzeigen Aktivieren Sie das Kontrollkästchen, und aktivieren Sie das celsius_to_fahrenheit Funktion aus der Funktionsliste.
  11. Wählen Sie Aus WeatherAdvisor Option aus der Liste Klassen.
  12. Wählen Sie Aus Give_Advice Option aus der Methodenliste.
  13. Wählen Sie OK.
  14. Verbinden Sie die Ports der Komponenten wie in der folgenden Abbildung gezeigt.
    Abbildung : 3. Portverbindung für Variablenkomponente und Ausführungsmethoden
    Beispiel für die Automatisierung des Python-Connectors.
  15. Um die Komponente zu testen, klicken Sie mit der rechten Maustaste auf die Variablenkomponente, und wählen Sie aus Von Hier Aus Ausführen .
    Abbildung : 4. Beispielergebnis für Temperatur
    Die Temperatur wird am Datenausgang-Port der Ausführungsmethode angezeigt.
    Abbildung : 5. Beispielergebnis für Wetterberatung
    Wetterhinweis wird im Datenausgangs-Port der Ausführungsmethode angezeigt.