Python 커넥터 구성

  • 릴리스 버전: Zurich
  • 업데이트 날짜 2025년 07월 31일
  • 소요 시간: 5분

    • 의 Python 커넥터를 RPA 데스크톱 디자인 스튜디오사용하여 사용자 지정 Python 스크립트를 작성 및 검증하고 자동화의 일부로 실행합니다.

    시작하기 전에

    에 스크립팅 플러그인을 RPA 데스크톱 디자인 스튜디오설치했는지 확인하십시오. 설치하려면 문서를 참조하십시오 에서 플러그인 관리 RPA 데스크톱 디자인 스튜디오.

    환경 변수의 일부인 Python 버전이 컴퓨터에 설치되어 있는지 확인합니다. 환경 변수에 대한 자세한 정보는 환경 변수 설정의 내용을 참조하십시오.

    Python 스크립트의 제한 사항을 숙지합니다. 자세한 내용은 Python 커넥터에서 Python 스크립트의 제한 사항 문서를 참조하십시오.

    필요한 역할: 없음

    프로시저

    1. 도구 상자 창에서 커넥터 > Python
    2. 프로젝트 탐색기 창의 전역 객체 아래에 있는 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을 선택합니다.

      컴퓨터의 사용자 프로파일에 생성된 Studio 로그에서 실행에 사용되는 Python 버전을 볼 수 있습니다.

      그림 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. 확인을 클릭합니다.
      변경 내용을 저장하려면 예를 선택합니다. 코드의 유효성이 검사됩니다. 변경 내용을 취소하려면 아니요를 선택합니다.
    9. Python 커넥터를 두 번 클릭하여 개체 탐색기 창 아래에 메서드를 표시합니다.
    10. 메서드를 디자인 화면으로 끌어 옵니다.
      Python 커넥터 메서드에 대한 자세한 내용은 문서를 참조하십시오 Python 커넥터 메서드.

    온도 변환 및 날씨 조언

    다음 단계를 수행하여 온도 변환 및 날씨 조언에 대한 자동화를 실행합니다.

    1. 도구 상자 창에서 일반 > 변수.
    2. 변수 구성 요소를 디자인 화면으로 끌어옵니다.
    3. 변수(Variable) 구성 요소를 두 번 클릭하고 이미지에 표시된 대로 이러한 매개변수를 설정합니다.
      그림 2. 변수 컨테이너에 대한 매개변수
      온도, 도시, isRaining, WindSpeed와 같은 파라미터는 변수 컨테이너에 설정되어 있습니다.
    4. 전역 객체에서 Python 커넥터를 두 번 클릭합니다.
    5. 개체 탐색기의 Execute 메서드를 디자인 화면으로 끌어 옵니다.
    6. 컴포넌트를 선택하고 Method settings 아이콘( Method settings icon)을 클릭하거나 컴포넌트 헤드 바를 두 번 클릭합니다.
    7. 기능 표시(Show Functions) 확인란을 선택하고 기능(Functions) 목록에서 celsius_to_fahrenheit 기능을 선택합니다.
    8. 확인을 선택합니다.
    9. Execute 메서드를 개체 탐색기에서 디자인 화면으로 다시 끌어 옵니다.
    10. 기능 표시(Show Functions) 확인란을 선택하고 기능(Functions) 목록에서 celsius_to_fahrenheit 기능을 선택합니다.
    11. 클래스 목록에서 WeatherAdvisor 옵션을 선택합니다.
    12. 방법 목록에서 give_advice 옵션을 선택합니다.
    13. 확인을 선택합니다.
    14. 다음 이미지와 같이 구성 요소의 포트를 연결합니다.
      그림 3. 변수 구성요소 및 실행 방법에 대한 포트 연결
      Python 커넥터 자동화 예시.
    15. 구성요소를 테스트하려면 변수 구성요소를 마우스 오른쪽 버튼으로 클릭하고 여기에서 실행을 선택합니다.
      그림 4. 온도에 대한 결과 예
      온도는 Execute 메서드의 Data Out 포트에 표시됩니다.
      그림 5. 날씨 조언에 대한 결과 예시
      날씨 조언은 Execute 메서드의 데이터 출력 포트에 표시됩니다.