NGMsoftware

NGMsoftware
로그인 회원가입
  • 매뉴얼
  • NGM 6
  • 매뉴얼

    NGM 6

    본 사이트의 컨텐츠는 저작권법의 보호를 받으므로 무단 복사, 게재, 배포 등을 금합니다.

    에디터 도구 상자 - 조건 - 이미지 서치 이벤트. (Toolbox, Condition, Image Search Event)

    페이지 정보

    본문

    안녕하세요. 엔지엠소프트웨어입니다. 엔지엠 RPA 매크로에는 스크립트의 액션과 상호 작용할 수 있는 이벤트 기능을 제공합니다. 화면에서 이미지를 주기적으로 찾으려면 [ 액션 이동 ] 또는 [ 액션 반복 ]을 사용해야 합니다. 이런 경우에는 다른 루틴을 실행하면서 체크할 수 없어서 비효율적인면이 존재합니다. 이벤트를 사용하면 실행중인 스크립트와 별개로 이미지를 찾으면 이벤트가 발동되고, 설정한 아이디로 바로 점프합니다. 또한, 예약 작업 이벤트를 통해 크론탭으로 설정한 시간에 원하는 스크립트를 실행시킬수도 있습니다. 이 기능은 매우 강력한 스크립트를 제작할 수 있도록 도와줍니다. [ 이미지 서 ]는 윈도우 화면에 사용자가 찾고 싶은 이미지가 출현하면 이벤트가 발생하고 원하는 루틴으로 이동할 수 있습니다.

    ※ 이벤트는 엔터프라이즈 기능입니다.

    1. 이벤트 위치는 도구 상자 > 조건 > 이미지 서치 이벤트입니다.
    2. 더블 클릭 또는 드래그 앤 드롭으로 스크립트에 이벤트를 추가하세요.

    Lqj0Huc.png

     

     

    이미지 서치 이벤트를 테스트하려면 윈도우 화면에서 비교할 이미지를 먼저 만들어야 합니다. 아래 동영상을 참고하여 이미지를 캡쳐하세요.

    h8XsPbl.gif

     

     

    이미지 서치 이벤트를 테스트하려면 다음과 같은 시나리오가 필요합니다. 사용자가 설정한 이미지를 윈도우 화면에서 찾는 이벤트를 등록해줍니다. 그리고, 설정한 이미지가 화면에 출현할때까지 다른 로직을 수행하는 스크립트를 만듭니다. 여기에서는 [ 그룹 ]과 [ 액션 이동 ]으로 무한 반복하도록 했습니다. 사용자가 이미지 서치 이벤트에 설정한 이미지가 윈도우 화면에 출현하면 이벤트 트리거가 동작하고, 이벤트에 설정한 아이디로 이동됩니다. 이 예제에서는 종료 그룹으로 이동하기 때문에 스크립트는 완료됩니다. 아래와 같이 스크립트를 구성하세요.

    mcnkP7M.png

     

     

    그룹 액션들은 반복과 이벤트가 발생했을 때 스크립트를 종료하기 위한 아이디를 설정 해줍니다. 그룹에 각각 아이디를 "반복"과 "종료"로 설정하세요.

    bSz39zK.png

     

     

    [ 액션 이동 ] 액션에서 그룹의 반복으로 이동시킵니다.

    ZP5w4zq.png

     

     

    이미지 서치 이벤트가 발생하면 "종료" 액션으로 이동하도록 설정했습니다. 따라서, 아래 동영상처럼 "반복" 액션으로 액션 이동이 되면서 무한 반복하다가 이미지가 출현하면 스크립트가 종료하게 됩니다. 캡쳐한 이미지가 안보이도록 창을 최소화하고, 스크립트를 실행하세요. 그리고, 창을 다시 복구하면 이미지를 찾았기 때문에 이미지 체크 이벤트가 발생하고 "종료" 액션으로 이동하면서 스크립트는 완료됩니다.

    tO0PrQN.gif

     

     

    이벤트도 액션과 동일하게 변수를 사용할 수 있습니다. 다만, 이벤트가 발생한 시점에 변수에 값을 넣어주고, 이동한 액션 아이디에서 이 값을 사용할 수 있습니다. 변수를 사용하기 위해 아래 그림과 같이 변수를 하나 추가하고, 이미지 서치 이벤트에서 이미지의 마우스 좌표를 변수에 저장해줍니다.

    ※ 아래 동영상은 이미지 체크 이벤트인데요. 이미지 서치 이벤트도 동일하니 똑같이 변수를 추가하시면 됩니다.

    mML9BDv.gif

     

     

    이벤트가 발생했다는건 사용자가 찾을 이미지가 화면에 출현했다는 뜻입니다. 그러므로 이미지의 좌표와 마우스 위치를 알 수 있습니다. 변수에 좌표 값이 제대로 저장되었는지 확인하기 위해 아래 동영상처럼 변수를 가져와서 값을 확인 해보세요.

    CU5Sgxq.gif

     

     

    결과를 확인 해보면~ 아래 그림과 같이 "종료" 액션의 설명에 좌표값이 표시되는걸 알 수 있습니다.

    APHJnCm.png

     

     

    변수를 이용할 수 있다는건 아주 큰 메리트를 제공해줍니다. 특정 이벤트가 발생했을 때 여러가지 결과 정보를 재활용할 수 있고, 이 정보를 가공해서 원하는 결과를 만들어낼 수 있습니다. 엔지엠 RPA 매크로는 조건뿐만 아니라 시간이나 마우스, 키보드 이벤트를 제공합니다. 이외에도 원격 제어에 사용되는 텔레그램과 Microsoft Office에서도 몇몇 이벤트와 액션은 유용하게 사용할 수 있습니다. 이벤트 방식으로 스크립트를 제작하려면 액션과 이벤트의 차이점에 대해 이해하는게 중요합니다. 이 예제에서 사용된 스크립트는 첨부 파일로 추가해 두었으니 다운로드 받아서 테스트 해보시기 바랍니다.

     

    속성 정보

    FZSUS0L.png

     

     

    기본 작업

    • 사용 여부: 이 액션의 사용 여부를 설정합니다. False로 설정하면 이 액션은 실행되지 않습니다.
    • 설명: 이 액션의 부가적인 설명을 입력합니다.
    • 실행 전 지연: 이 액션이 실행되기 전 지연 시간을 입력합니다.
    • 실행 후 지연: 이 액션이 실행된 후 지연 시간을 입력합니다.
    • 실행율: 이 액션을 실행하는 확률입니다. (기본값은 무조건 실행이며, 50으로 설정하면 50프로 확률로 실행하거나 건너뛰게됩니다.)
    • 아이디: 스크립트 내에서 유니크한 아이디를 입력합니다.

     

    데이터

    • 마우스 X 좌표: 클릭할 마우스의 X 좌표 값입니다.
    • 마우스 Y 좌표: 클릭할 마우스의 Y 좌표 값입니다.
    • 마우스 좌표: 이미지를 찾은 후 마우스가 클릭할 위치의 좌표 값입니다.
    • 매인 윈도우 정보: 비활성 모드에서 좌표를 계산하기 위한 매인 윈도우 정보입니다.
    • 이미지 경로: 사용자가 선택한 이미지의 경로를 표시합니다.
    • 이미지 정보: 찾은 이미지의 위치 및 크기 정보입니다.
    • 이미지 텍스트: 이벤트가 발생하면 사용자가 설정한 이미지 텍스트가 표시됩니다.
    • 콘트롤 윈도우 정보: 비활성 모드에서 좌표를 계산하기 위한 콘트롤 윈도우 정보입니다.

     

    변수

    • 가져오기: 글로벌 또는 로컬 변수에 저장되어 있는 값을 이 액션의 속성 값으로 가져옵니다.
    • 추가하기: 이 액션의 속성 값을 글로벌 또는 로컬 변수에 저장합니다.

     

    이미지 확장 기능

    • 캡처: 이미지를 캡처합니다. 이미지 만들기와 동일하지만, 세부적인 설정은 할 수 없습니다.

     

    작업

    • 공차: 이미지의 컬러값을 비교할 때 허용되는 수치를 나타냅니다.
    • 대상 이미지 필터 적용: 원본 비교 사용을 선택하더라도 대상 이미지는 필터를 적용시킵니다.
    • 성능: 액션 또는 이벤트의 성능을 조절합니다. 이 값이 큰수록 속도는 저하되지만 부드럽게 처리됩니다.
    • 액션 종료 아이디: 이벤트가 발생하면 사용자가 설정한 액션 아이디로 이동됩니다.
    • 에러 처리: 이벤트에서 에러가 발생할 경우 처리하는 방식을 결정합니다.
    • 원본 비교: 필터를 제외하고 원본 이미지로 비교합니다. 공차는 적용됩니다.
    • 원본 이미지 필터 적용: 원본 비교 사용을 선택하더라도 원본 이미지는 필터를 적용시킵니다.
    • 이미지 선택: 컴퓨터에 있는 이미지 파일의 전체 경로입니다. (png, jpg, bmp...)
    • 이미지 이름: 윈도우 화면에서 찾을 이미지 파일의 이름입니다. (ngi)
    • 이미지 텍스트: 이미지와 일치하면 설정한 텍스트를 사용할 수 있습니다. 이 값은 데이터의 이미지 텍스트에 표시됩니다.
    • 찾기 영역: 이미지를 찾는 영역입니다. 비활성 모드는 해당 창 안에 검색 영역이 존재해야 합니다.
    • 투명 사용: 투명한 컬러의 경우 비교에서 제외시킵니다. (이 옵션을 True로 설정하면 성능이 저하될 수 있습니다.)
    • 픽셀 포멧: 이미지의 각 픽셀에 대한 색 데이터의 형식을 지정합니다.

     

    개발자에게 후원하기

    MGtdv7r.png

     

    추천, 구독, 홍보 꼭~ 부탁드립니다.

    여러분의 후원이 빠른 귀농을 가능하게 해줍니다~ 답답한 도시를 벗어나 귀농하고 싶은 개발자~

    감사합니다~

    • 네이버 공유하기
    • 페이스북 공유하기
    • 트위터 공유하기
    • 카카오스토리 공유하기
    추천0 비추천0

    첨부파일

    댓글목록

    profile_image