Python コネクタの設定

  • リリースバージョン: Zurich
  • 更新日 2025年07月31日
  • 所要時間：6分

    • カスタム Python スクリプトを記述して検証し、 RPA デスクトップデザインスタジオ で Python コネクタを使用して自動化の一部として実行します。

    始める前に

    スクリプティングプラグインが RPA デスクトップデザインスタジオにインストールされていることを確認します。インストールするには、「でのプラグインの管理 RPA デスクトップデザインスタジオ」を参照してください。

    環境変数の一部である Python バージョンがマシンにインストールされていることを確認します。環境変数の詳細については、「 環境変数の設定」を参照してください。

    Python スクリプトの制限について理解しておいてください。詳細については、「Python コネクタでの Python スクリプトの制限」を参照してください。

    必要なロール：なし

    手順

    1. [ツールボックス] ペインで、 コネクタ > Python
    2. [プロジェクトエクスプローラー (Project Explorer)] ペインの Global Objects の下に Python コンポーネントをドラッグします。
    3. [Python] コネクタを右クリックします。
    4. [構成] をクリックします。
      [スクリプトエディタ] ウィンドウが表示されます。

      Pythonがマシンにインストールされていない場合は、エラーメッセージが表示されます。Pythonをインストールし、プロジェクトを再度リロードしてください。

    5. [Python バージョン] リストで、エンドユーザーのマシンにインストールされている、または利用可能で、自動化を実行できるバージョンで、ランタイムバージョンと同じかそれ以降のバージョンを選択します。
      注:

      [Python バージョン] リストには、マシンにインストールされている Python バージョンのリストが表示されます。

      Python バージョン 2.7 以降がサポートされています。スクリプトが検証中でも実行中でもない場合は、バージョン 2.7 以降のバージョンを使用していることを確認してください。

      デフォルトでは、インストールされている Python のバージョンが最も高いものが選択されています。

      バージョン 2.x を選択し、マシンに Python 3.x がインストールされている場合、自動化は実行されますが、Python スクリプトが実行されない可能性があります。スクリプトは、Python 3.x と互換性がある場合にのみ実行されます。そうしないと、エラーが発生する可能性があります。

      自動化の実行中に、3.15.3 などの特定のバージョンを選択し、マシンに Python 3.11.3 がインストールされている場合、自動化は実行されず、エラーが発生します。続行するには、同じバージョン、3.15.3、またはそれ以上のバージョンの Python を選択してください。

      実行に使用される Python バージョンは、マシンのユーザープロファイルで作成された Studio ログで確認できます。

      図 : 1. スクリプトエディタの [スクリプト] ペインと Python バージョン
      スクリプトエディタの [スクリプト] ペインと Python バージョン。
    6. [スクリプト] ペインでカスタムスクリプトを入力します。
      温度変換と天気予報のスクリプト例。
      
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. [検証] を選択します。
      カスタムスクリプトにエラーがある場合は、[エラー] ペインに表示されます。エラーを解決し、[検証] を選択してエラーを再度確認します。
    8. [OK] をクリックします。
      変更を保存する場合は、[はい]を選択します。コードが検証されます。変更を破棄する場合は、[いいえ] を選択します。
    9. Python コネクタをダブルクリックして、[オブジェクトエクスプローラー (Object Explorer)] ペインにメソッドを表示します。
    10. メソッドを [デザイン面 (Design surface)] にドラッグします。
      Python コネクタのメソッドの詳細については、「 Python コネクタのメソッド」を参照してください。

    温度変換と気象アドバイス

    次の手順を実行して、温度変換と気象アドバイスの自動化を実行します。

    1. [ツールボックス] ペインで、 全般 > 変数.
    2. Variable コンポーネントを [デザイン面 (Design surface)] にドラッグします。
    3. Variableコンポーネントをダブルクリックし、画像に示すようにこれらのパラメータを設定します。
      図 : 2. 変数コンテナのパラメーター
      Temperature、City、isRaining、WindSpeed などのパラメーターは、変数コンテナーで設定されます。
    4. Global Objects の Python コネクタをダブルクリックします。
    5. Execute メソッドを [オブジェクトエクスプローラー (Object Explorer)] から [デザイン面 (design surface)] にドラッグします。
    6. コンポーネントを選択し、メソッド設定 アイコン (メソッド設定アイコン)をクリックするか、コンポーネントのヘッドバーをダブルクリックします。
    7. [関数を表示] チェックボックスをオンにして、[関数] リストからcelsius_to_fahrenheit関数を選択します。
    8. [OK] を選択します。
    9. Execute メソッドを [オブジェクトエクスプローラー (Object Explorer)] から [デザイン面 (design surface)] に再度ドラッグします。
    10. [関数を表示] チェックボックスをオンにして、[関数] リストからcelsius_to_fahrenheit関数を選択します。
    11. [クラス] リストから [WeatherAdvisor ] オプションを選択します。
    12. [メソッド ] リストからgive_advice オプションを選択します。
    13. [OK] を選択します。
    14. 次の画像に示すように、コンポーネントのポートを接続します。
      図 : 3. 変数コンポーネントと Execute メソッドのポート接続
      Python コネクタの自動化の例。
    15. コンポーネントをテストするには、Variable コンポーネントを右クリックし、「 ここから実行」を選択します。
      図 : 4. 温度の結果の例
      温度は、Execute メソッドのデータ出力ポートに表示されます。
      図 : 5. 天気予報の結果例
      天気予報は、Execute メソッドのデータ出力ポートに表示されます。