UI 자동화 작업

중요

권한 없는 액세스를 방지하려면 Power Automate는 자동으로 응용 프로그램과 동일하거나 더 높은 권한으로 실행되어야 합니다. UI 자동화 작업(데스크톱 사용 작업 제외)을 사용하여 높은 권한으로 실행되는 애플리케이션과 상호 작용하려면 Power Automate를 관리자로 실행합니다. 관리자로서 Power Automate를 실행하는 경우에 대한 더 자세한 정보는 높은 권한으로 Power Automate 실행으로 이동하세요.

Power Automate는 사용자가 Windows 및 데스크톱 응용 프로그램과 상호 작용할 수 있도록 다양한 UI 자동화 작업을 제공합니다. 일부 UI 자동화 작업에서는 처리하려는 요소를 나타내기 위해 속성에서 UI 요소를 설정해야 합니다.

새 UI 요소를 추가하려면 배포된 UI 자동화 작업 또는 흐름 디자이너의 UI 요소 창을 통해 UI 요소 추가를 선택합니다.

모든 UI 요소는 구성 요소의 계층적 구조를 정확히 가리키는 선택기로 구성됩니다. 선택기는 > 주석을 사용하여 각 요소가 왼쪽에 있는 요소 내에 포함되어 있음을 나타냅니다.

애플리케이션 창의 UI 요소를 만들 때 선택기에는 항상 :desktop이라는 루트 요소가 있습니다.

애플리케이션 창 내부의 구성 요소를 정확히 가리키는 UI 요소를 생성하면 두 개의 UI 요소가 자동으로 생성됩니다. 부모 UI 요소는 애플리케이션 창을 정확히 가리키고 자식은 창 내부의 특정 구성 요소의 계층적 구조를 보여줍니다.

선택기는 UI 요소를 추가할 때 자동으로 생성되지만 일부 특정 시나리오에는 수동으로 생성된 선택기가 필요합니다. 사용자 지정 선택기가 필요한 경우 기존 선택기를 편집하거나 처음부터 만들 수 있습니다.

보다 동적인 흐름을 개발하려면 Equals to 연산자를 다른 연산자 또는 정규식으로 바꿉니다. 또한 선택기의 특성 값이 이전 작업의 결과에 따라 달라지는 경우 하드 코딩된 값 대신 변수를 사용합니다.

많은 UI 자동화 작업에는 작업 실행을 위한 두 가지 모드, 즉 물리적 모드와 시뮬레이션 모드가 있습니다. 물리적 모드에서는 도구가 시스템의 마우스와 키보드를 제어하여 물리적으로 작업을 수행합니다. 시뮬레이션 모드에서는 마우스와 키보드를 제어하지 않고 UI 요소의 화면을 전경으로 가져올 필요 없이 프로그래밍 방식으로 작업이 수행됩니다. 시뮬레이션된 옵션이 모든 UI 요소에 적용되지 않을 수도 있다는 점에 유의하는 것이 중요합니다. 시뮬레이션을 통해 작업을 수행하려면 일부 작업에서 작업 시뮬레이션 매개 변수를 활성화하거나 다른 작업에서 맨 앞으로 가져오기 매개 변수를 비활성화합니다.

참고

UI 자동화 흐름 개발 및 사용자 지정 선택기 만들기에 대한 자세한 내용을 보려면 각각 데스크톱 흐름 자동화 및 사용자 지정 선택기 빌드로 이동하세요.

창의 세부 정보 가져오기

제목 또는 소스 텍스트와 같은 창의 속성을 가져옵니다.

입력 매개 변수

인수	선택 항목	수락	기본값	Description
Window	아니요	UI 요소		세부 정보를 가져올 창
창 속성	해당 없음	창 제목 가져오기, 창 텍스트 가져오기, 창 위치 및 크기 가져오기, 프로세스 이름 가져오기	창 제목 가져오기	추출할 창의 속성 선택
맨 앞으로 가져옵니다	사용 불가	부울 값	참	실행 중에 UI 요소가 포함된 창을 앞으로 가져올지 여부를 지정합니다. 이 옵션을 비활성화하면 작업이 백그라운드에서 실행됩니다. 모든 UI 요소가 옵션 비활성화와 호환되는 것은 아닙니다. 또한 작업 실행에 스크롤이 필요한 경우 이 옵션을 비활성화하면 모든 요소가 추출되지 않을 수 있습니다.

변수 생성됨

인수	Type	Description
WindowProperty	일반 값	창의 검색된 정보

예외

예외	설명
창 속성을 검색하지 못함	창 속성을 검색하는 동안 문제가 발생했음을 나타냄

창에서 UI 요소의 세부 정보 가져오기

창에서 UI 요소의 특성 값을 가져옵니다.

입력 매개 변수

인수	선택 항목	수락	기본값	Description
UI 요소	아니요	UI 요소		세부 정보를 가져올 UI 요소
특성 이름	네	텍스트 값	자체 텍스트	값을 검색할 특성
맨 앞으로 가져옵니다	사용 불가	부울 값	참	실행 중에 UI 요소가 포함된 창을 앞으로 가져올지 여부를 지정합니다. 이 옵션을 비활성화하면 작업이 백그라운드에서 실행됩니다. 모든 UI 요소가 옵션 비활성화와 호환되는 것은 아닙니다. 또한 작업 실행에 스크롤이 필요한 경우 이 옵션을 비활성화하면 모든 요소가 추출되지 않을 수 있습니다.

변수 생성됨

인수	Type	Description
AttributeValue	텍스트 값	UI 요소의 텍스트 값

예외

예외	설명
UI 요소의 특성을 검색하지 못함	UI 요소의 특성을 검색하는 동안 문제가 발생했음을 나타냄

창에서 선택된 확인란 가져오기

확인란 그룹에서 선택된 확인란의 이름 또는 특정 확인란의 상태를 검색합니다.

입력 매개 변수

인수	선택 항목	수락	기본값	Description
UI 요소	아니요	UI 요소		확인란 또는 확인란 그룹
작업	해당 없음	그룹에서 선택한 확인란의 이름 가져오기, 확인란 상태 가져오기	그룹에서 선택한 확인란의 이름 가져오기	선택된 여러 확인란 또는 단 하나의 확인란 가져오기 지정
맨 앞으로 가져옵니다	사용 불가	부울 값	참	실행 중에 UI 요소가 포함된 창을 앞으로 가져올지 여부를 지정합니다. 이 옵션을 비활성화하면 작업이 백그라운드에서 실행됩니다. 모든 UI 요소가 옵션 비활성화와 호환되는 것은 아닙니다. 또한 작업 실행에 스크롤이 필요한 경우 이 옵션을 비활성화하면 모든 요소가 추출되지 않을 수 있습니다.

변수 생성됨

인수	Type	Description
IsChecked	부울 값	선택된 확인란의 상태
SelectedCheckboxes	텍스트 값 목록	특정 확인란 그룹 내부의 선택된 확인란의 이름

예외

예외	설명
확인란 상태를 검색하지 못함	특정 확인란 상태를 검색하는 동안 문제가 발생했음을 나타냄

창에서 선택된 라디오 버튼 가져오기

라디오 단추에서 선택된 라디오 단추의 이름 또는 특정 라디오 단추의 상태를 검색합니다.

입력 매개 변수

인수	선택 항목	수락	기본값	Description
UI 요소	아니요	UI 요소		라디오 버튼 또는 라디오 버튼 그룹
작업	해당 없음	그룹에서 선택한 라디오 버튼 이름 가져오기, 라디오 버튼 상태 가져오기	그룹에서 선택된 라디오 버튼의 이름 가져오기	라디오 버튼의 그룹 안에서 선택된 라디오 버튼의 이름 또는 단일 라디오 버튼의 상태 검색 여부 지정
맨 앞으로 가져옵니다	사용 불가	부울 값	참	실행 중에 UI 요소가 포함된 창을 앞으로 가져올지 여부를 지정합니다. 이 옵션을 비활성화하면 작업이 백그라운드에서 실행됩니다. 모든 UI 요소가 옵션 비활성화와 호환되는 것은 아닙니다. 또한 작업 실행에 스크롤이 필요한 경우 이 옵션을 비활성화하면 모든 요소가 추출되지 않을 수 있습니다.

변수 생성됨

인수	Type	Description
isSelected	부울 값	선택된 라디오 버튼의 상태
SelectedRadiobutton	텍스트 값	특정 라디오 그룹 내부의 선택된 라디오 버튼

예외

예외	설명
라디오 버튼 상태를 검색하지 못함	특정 라디오 버튼 상태를 검색하는 동안 문제가 발생했음을 나타냄

창에서 데이터 추출

창의 특정 부분에서 단일 값 가치 또는 목록, 테이블의 양식으로 데이터를 추출합니다.

입력 매개 변수

인수	선택 항목	수락	기본값	Description
Window	아니요	UI 요소		데이터를 추출할 창
Store extracted data in	사용 불가	Excel 스프레드시트, 변수	Excel 스프레드시트	추출된 데이터 저장 여부 지정
맨 앞으로 가져옵니다	사용 불가	부울 값	참	실행 중에 UI 요소가 포함된 창을 앞으로 가져올지 여부를 지정합니다. 이 옵션을 비활성화하면 작업이 백그라운드에서 실행됩니다. 모든 UI 요소가 옵션 비활성화와 호환되는 것은 아닙니다. 또한 작업 실행에 스크롤이 필요한 경우 이 옵션을 비활성화하면 모든 요소가 추출되지 않을 수 있습니다.

변수 생성됨

인수	Type	Description
ExcelInstance	Excel 인스턴스	추출된 데이터가 있는 Excel 인스턴스입니다. 스프레드시트를 조작하려면(또는 저장 및 닫기) 전용 Excel 작업을 사용해 이 인스턴스를 사용하세요.
DataFromWindow	일반 값	데이터 테이블 양식의 추출된 데이터

예외

예외	설명
추출 실패	특정 창에서 데이터를 추출하는 동안 문제가 발생했음을 나타냄

UI 요소의 스크린샷 찍기

창에서 UI 요소의 스크린샷을 찍습니다.

입력 매개 변수

인수	선택 항목	수락	기본값	Description
UI 요소	아니요	UI 요소		스크린샷으로 캡처하는 창에 있는 UI 요소
Save mode	해당 없음	클립보드, 파일	클립보드	이미지를 파일에 저장할지 아니면 클립보드에 저장할지 지정
Image file path	아니요	파일		저장할 파일의 전체 경로 설정
File format	해당 없음	BMP, EMF, EXIF, GIF, JPG, PNG, TIFF, WMF	BMP	이미지 파일의 파일 형식

변수 생성됨

인수	Type	Description
ImageFile	File	생성된 스크린샷 이미지 파일의 파일 경로

예외

예외	설명
UI 요소를 검색하지 못함	UI 요소를 검색하는 동안 문제가 발생했음을 나타냄
이미지를 저장하지 못함	찍은 스크린샷을 파일에 저장하는 동안 문제가 발생했음을 나타냄
UI 요소의 스크린샷 찍기 실패	UI 요소의 스크린샷을 찍는 동안 문제가 있음을 나타냄

창의 텍스트 필드에 포커스 설정

창의 텍스트 상자에 포커스를 설정하고 보기로 스크롤합니다.

입력 매개 변수

인수	선택 항목	수락	기본값	Description
Text field	아니요	UI 요소		포커스할 텍스트 상자

변수 생성됨

이 작업은 변수를 생성하지 않습니다.

예외

예외	Description
창 텍스트 상자에서 입력 포커스 설정하지 못함	특정 웹 페이지 텍스트 필드에서 포커스를 설정하는 동안 문제가 발생했음을 나타냄

창에서 텍스트 필드 채우기

지정된 텍스트로 창의 텍스트 상자를 채웁니다.

입력 매개 변수

인수	선택 항목	수락	기본값	Description
Text box	아니요	UI 요소		채울 텍스트 상자
채울 텍스트	아니요	직접 암호화 입력 또는 Text value		텍스트 필드에서 채울 텍스트
작업 시뮬레이션	사용 불가	부울 값	False	UI 텍스트 필드 요소에 텍스트를 채울 때 프로그래밍 방식으로 키 입력을 시뮬레이션합니다. 이 옵션을 사용하면 UI 요소 화면에 초점을 맞출 필요가 없으며 자동으로 전경으로 가져오지 않습니다. 이 옵션은 왼쪽 클릭 동작에만 적용할 수 있으며 모든 UI 요소에 적용할 수는 없습니다.
If field isn't empty	네	텍스트 바꾸기, 텍스트 추가	텍스트 대체	기존 콘텐츠를 바꿀지, 아니면 추가할지 여부를 지정합니다.
Click before populating	네	왼쪽 클릭, 더블 클릭, 아니요	왼쪽 클릭	텍스트 필드를 채우기 전에 왼쪽 마우스 클릭을 수행할지 여부를 지정합니다.

변수 생성됨

이 작업은 변수를 생성하지 않습니다.

예외

예외	Description
텍스트 상자에 쓰지 못함	특정 텍스트 필드를 채우는 동안 문제가 발생했음을 나타냄

창의 단추 누르기

창 단추를 누릅니다.

입력 매개 변수

인수	선택 항목	수락	기본값	Description
UI 요소	아니요	UI 요소		누를 버튼

변수 생성됨

이 작업은 변수를 생성하지 않습니다.

예외

예외	Description
버튼을 누르지 못함	특정 버튼을 누르는 동안 문제가 발생했음을 나타냄

창에서 라디오 단추 선택

창에서 라디오 단추를 선택합니다.

입력 매개 변수

인수	선택 항목	수락	기본값	Description
Radio button	아니요	UI 요소		선택할 라디오 버튼

변수 생성됨

이 작업은 변수를 생성하지 않습니다.

예외

예외	Description
라디오 버튼 UI 요소를 선택하지 못함	특정 라디오 버튼 UI 요소를 선택하는 동안 문제가 발생했음을 나타냄

창의 확인란 상태 설정

창 양식에서 확인란 선택 또는 선택 취소합니다.

입력 매개 변수

인수	선택 항목	수락	기본값	Description
Checkbox	아니요	UI 요소		상태를 설정할 확인란
Set checkbox state to	사용 불가	선택됨, 선택되지 않음	선택한 상태	확인란 선택 또는 선택 취소 여부 지정

변수 생성됨

이 작업은 변수를 생성하지 않습니다.

예외

예외	Description
확인란 상태를 설정하지 못함	특정 확인란 상태를 설정하는 동안 문제가 발생했음을 나타냄

창의 드롭다운 목록 값 설정

창 형식의 드롭다운 목록에 대해 선택한 옵션을 설정하거나 지웁니다.

입력 매개 변수

인수	선택 항목	수락	기본값	Description
Drop-down list	아니요	UI 요소		값을 설정할 드롭다운 목록
Operation	사용 불가	선택한 옵션 지우기, 이름으로 옵션 선택, 색인으로 옵션 선택	선택된 옵션 지우기	이름이나 순서 위치(1 2 3 ...)별로 값을 설정하거나 드롭다운 목록의 선택된 값을 지울지 여부 지정
옵션 이름	아니요	텍스트 값목록		드롭다운 목록에서 선택할 옵션 또는 옵션 목록을 입력합니다. 다중 옵션은 다중 선택 목록으로 작업할 때만 의미가 있습니다. 목록이 단일 선택인 경우 지정된 목록의 첫 번째 옵션만 사용됩니다.
정규식 사용	사용 불가	부울 값	거짓	옵션 이름 값을 정규식으로 해석할지 지정
옵션 색인	아니요	숫자 값 목록		드롭다운 목록에서 선택할 색인 또는 색인 목록을 입력합니다. 다중 옵션은 다중 선택 목록으로 작업할 때만 의미가 있습니다. 목록이 단일 선택인 경우 지정된 목록의 첫 번째 옵션만 사용됩니다.

변수 생성됨

이 작업은 변수를 생성하지 않습니다.

예외

예외	Description
드롭다운 목록에서 특정 옵션을 선택하지 못함	드롭다운 목록에서 특정 옵션을 선택하는 동안 문제가 발생했음을 나타냄

창 가져오기

데스크톱 애플리케이션 자동화에 대한 창 실행을 가져옵니다.

입력 매개 변수

인수	선택 항목	수락	기본값	Description
Get window	해당 없음	특정 창, 전경 창	특정 창	선택기 또는 전경 창을 사용하여 조회 여부 지정
UI 요소	아니요	UI 요소		가져올 창의 선택기
Bring window to front	사용 불가	부울 값	False	가져올 때 창을 전경으로 자동 가져오기 지정
Fail if window isn't found	해당 없음	부울 값	True	창이 나타날 때까지 무기한으로 대기할지 설정한 시간 안에 표시되지 않으면 실패로 처리할지 지정
Timeout	아니요	숫자 값		대기 시간 제한(초)

변수 생성됨

인수	Type	Description
WindowTitle	텍스트 값	전경 창의 제목
AutomationWindow	창 인스턴스	나중에 UI 자동화 작업과 함께 사용할 특정 창 인스턴스

예외

예외	설명
창을 가져오지 못함	창을 가져오는 동안 문제가 발생했음을 나타냄

창 포커스

특정 창을 활성화 및 전경에 가져옵니다.

입력 매개 변수

인수	선택 항목	수락	기본값	Description
Find window mode	해당 없음	창 UI 요소별, 창 인스턴스별/핸들별, 제목별 및/또는 클래스별	창 UI 요소별	UI 요소를 사용하는 창 또는 창 제목 또는 클래스 조합을 찾을지 여부 지정
Window	아니요	UI 요소		창 UI 요소
Window title	네	텍스트 값		창 제목입니다. '?' 또는 '*'와 같은 와일드 카드를 사용할 수 있습니다.
Window instance	아니요	숫자 값		포커스할 창의 인스턴스 또는 핸들
Window class	예	텍스트 값		동일한 제목을 가진 창이 두 개 있으면 창 클래스에 따라 창을 구별할 수 있습니다. 이 경우 사용할 창의 클래스를 입력하십시오.

변수 생성됨

이 작업은 변수를 생성하지 않습니다.

예외

예외	Description
창을 찾을 수 없음	특정 창을 찾을 수 없음을 나타냄
창을 포커스할 수 없음	특정 창을 포커스하는 동안 문제가 발생했음을 나타냄
대화형이 아닌 모드에서 창 관련 작업을 수행할 수 없음	대화형이 아닌 모드에서 창 관련 작업을 수행하는 동안 문제가 발생했음을 나타냄

창 상태 설정

특정 창 복원, 최대화 또는 최소화합니다.

입력 매개 변수

인수	선택 항목	수락	기본값	Description
Find window mode	해당 없음	창 UI 요소별, 창 인스턴스별/핸들별, 제목별 및/또는 클래스별	창 UI 요소별	UI 요소를 사용하는 창 또는 창 제목 또는 클래스 조합을 찾을지 여부 지정
Window	아니요	UI 요소		창 UI 요소
Window title	네	텍스트 값		창 제목입니다. '?' 또는 '*'와 같은 와일드 카드를 사용할 수 있습니다.
Window instance	아니요	숫자 값		상태를 설정할 창의 인스턴스 또는 핸들
Window class	예	텍스트 값		동일한 제목을 가진 창이 두 개 있으면 창 클래스에 따라 창을 구별할 수 있습니다. 이 경우 사용할 창의 클래스를 입력하십시오.
Window state	해당 없음	복원, 최대화, 최소화	복원됨	창을 표시할 상태 선택

변수 생성됨

이 작업은 변수를 생성하지 않습니다.

예외

예외	Description
창을 찾을 수 없음	특정 창을 찾을 수 없음을 나타냄
창 상태를 설정할 수 없음	특정 창의 창 상태를 설정하는 동안 문제가 발생했음을 나타냄
대화형이 아닌 모드에서 창 관련 작업을 수행할 수 없음	대화형이 아닌 모드에서 창 관련 작업을 수행하는 동안 문제가 발생했음을 나타냄

창 표시 여부 설정

숨겨진 창을 표시하거나 표시할 창을 숨깁니다.

입력 매개 변수

인수	선택 항목	수락	기본값	Description
Find window mode	해당 없음	창 UI 요소별, 창 인스턴스별/핸들별, 제목별 및/또는 클래스별	창 UI 요소별	UI 요소를 사용하는 창 또는 창 제목 또는 클래스 조합을 찾을지 여부 지정
Window	아니요	UI 요소		창 UI 요소
Window title	네	텍스트 값		창 제목입니다. '?' 또는 '*'와 같은 와일드 카드를 사용할 수 있습니다.
Window instance	아니요	숫자 값		표시 여부를 설정할 창의 인스턴스 또는 핸들
Window class	예	텍스트 값		동일한 제목을 가진 창이 두 개 있으면 창 클래스에 따라 창을 구별할 수 있습니다. 이 경우 사용할 창의 클래스를 입력하십시오.
Visibility	해당 없음	표시, 숨김	숨김	창 표시 여부를 설정할 상태 선택

변수 생성됨

이 작업은 변수를 생성하지 않습니다.

예외

예외	Description
창을 찾을 수 없음	특정 창을 찾을 수 없음을 나타냄
창 표시 여부를 설정할 수 없음	특정 창의 에서 표시 여부를 설정하는 동안 문제가 발생했음을 나타냄
대화형이 아닌 모드에서 창 관련 작업을 수행할 수 없음	대화형이 아닌 모드에서 창 관련 작업을 수행하는 동안 문제가 발생했음을 나타냄

창 이동

특정 창의 위치를 설정합니다.

입력 매개 변수

인수	선택 항목	수락	기본값	Description
Find window mode	해당 없음	창 UI 요소별, 창 인스턴스별/핸들별, 제목별 및/또는 클래스별	창 UI 요소별	UI 요소를 사용하는 창 또는 창 제목 또는 클래스 조합을 찾을지 여부 지정
Window	아니요	UI 요소		창 UI 요소
Window title	네	텍스트 값		창 제목입니다. '?' 또는 '*'와 같은 와일드 카드를 사용할 수 있습니다.
Window instance	아니요	숫자 값		옮길 창의 인스턴스 또는 핸들
Window class	예	텍스트 값		동일한 제목을 가진 창이 두 개가 있으면 창 클래스에 따라 창을 구별할 수 있습니다. 이 경우 사용할 창의 클래스를 입력하십시오.
Position X	아니요	숫자 값		창의 X 위치
Position Y	아니요	숫자 값		창의 Y 위치

변수 생성됨

이 작업은 변수를 생성하지 않습니다.

예외

예외	Description
창을 찾을 수 없음	특정 창을 찾을 수 없음을 나타냄
창을 옮길 수 없음	특정 창을 이동하는 동안 문제가 발생했음을 나타냄
대화형이 아닌 모드에서 창 관련 작업을 수행할 수 없음	대화형이 아닌 모드에서 창 관련 작업을 수행하는 동안 문제가 발생했음을 나타냄

창 크기 조정

특정 창의 크기를 설정합니다.

입력 매개 변수

인수	선택 항목	수락	기본값	Description
Find window mode	해당 없음	창 UI 요소별, 창 인스턴스별/핸들별, 제목별 및/또는 클래스별	창 UI 요소별	UI 요소를 사용하는 창 또는 창 제목 또는 클래스 조합을 찾을지 여부 지정
Window	아니요	UI 요소		창 UI 요소
Window title	네	텍스트 값		창 제목입니다. '?' 또는 '*'와 같은 와일드 카드를 사용할 수 있습니다.
Window instance	아니요	숫자 값		크기 조정할 창의 인스턴스 또는 핸들
Window class	예	텍스트 값		동일한 제목을 가진 창이 두 개 있으면 창 클래스에 따라 창을 구별할 수 있습니다. 이 경우 사용할 창의 클래스를 입력하십시오
Width	아니요	숫자 값		픽셀 단위의 새 너비
Height	아니요	숫자 값		픽셀 단위의 새 높이

변수 생성됨

이 작업은 변수를 생성하지 않습니다.

예외

예외	Description
창을 찾을 수 없음	특정 창을 찾을 수 없음을 나타냄
창의 크기 조정을 할 수 없음	특정 창의 크기 조정을 하는 동안 문제가 발생했음을 나타냄
대화형이 아닌 모드에서 창 관련 작업을 수행할 수 없음	대화형이 아닌 모드에서 창 관련 작업을 수행하는 동안 문제가 발생했음을 나타냄

창 닫기

특정 창을 닫습니다.

입력 매개 변수

인수	선택 항목	수락	기본값	Description
Find window mode	해당 없음	창 UI 요소별, 창 인스턴스별/핸들별, 제목별 및/또는 클래스별	창 UI 요소별	UI 요소를 사용하는 창 또는 창 제목 또는 클래스 조합을 찾을지 여부 지정
Window	아니요	UI 요소		창 UI 요소
Window title	네	텍스트 값		창 제목입니다. '?' 또는 '*'와 같은 와일드 카드를 사용할 수 있습니다.
Window instance	아니요	숫자 값		닫을 창의 인스턴스 또는 핸들
Window class	예	텍스트 값		동일한 제목을 가진 창이 두 개 있으면 창 클래스에 따라 창을 구별할 수 있습니다. 이 경우 사용할 창의 클래스를 입력하십시오.

변수 생성됨

이 작업은 변수를 생성하지 않습니다.

예외

예외	Description
창을 찾을 수 없음	특정 창을 찾을 수 없음을 나타냄
창을 닫을 수 없음	특정 창을 닫는 동안 문제가 발생했음을 나타냄
대화형이 아닌 모드에서 창 관련 작업을 수행할 수 없음	대화형이 아닌 모드에서 창 관련 작업을 수행하는 동안 문제가 발생했음을 나타냄

창이 포함하는 경우

창에 특정 텍스트 또는 UI 요소가 있는지 여부에 따라 조건부 작업 블록의 시작을 표시합니다.

입력 매개 변수

인수	선택 항목	수락	기본값	Description
Check if window	해당 없음	UI 요소 포함, UI 요소 포함 안 함, 텍스트 포함, 텍스트 포함 안 함	UI 요소 포함	특정 텍스트 또는 UI 요소가 창에 있는지 확인
Check UI element state	해당 없음	부울 값	False	특정 UI 요소를 사용할 수 있는지 여부 확인
문자	아니요	텍스트 값		확인할 텍스트
UI 요소	아니요	UI 요소		확인할 UI 요소
Window	아니요	UI 요소		텍스트가 있는지 확인할 창
시	사용 불가	사용, 사용 중지	사용 설정됨	확인할 UI 요소 상태

변수 생성됨

이 작업은 변수를 생성하지 않습니다.

예외

이 작업에는 예외가 포함되지 않습니다.

창 콘텐츠 대기

특정 텍스트 또는 UI 요소가 창에서 나타나거나 사라지기 전까지 자동화 실행을 일시 중단합니다.

입력 매개 변수

인수	선택 항목	수락	기본값	Description
Wait until window	해당 없음	UI 요소 포함, UI 요소 포함 안 함, 텍스트 포함, 텍스트 포함 안 함	UI 요소 포함	특정 텍스트 또는 UI 요소가 창에서 나타날 때까지 대기 여부
Check UI element state	해당 없음	부울 값	False	특정 UI 요소를 사용할 수 있는지 여부 확인
문자	아니요	텍스트 값		확인할 텍스트
UI 요소	아니요	UI 요소		확인할 UI 요소
Window	아니요	UI 요소		텍스트가 있는지 확인할 창
시	사용 불가	사용, 사용 중지	사용 설정됨	확인할 UI 요소 상태

변수 생성됨

이 작업은 변수를 생성하지 않습니다.

예외

예외	Description
창 내용 대기 실패	대기 작업 실패를 나타냄

이미지인 경우

이 작업은 선택한 이미지가 화면에 있는지 여부에 따라 조건부 작업 블록의 시작을 표시합니다.

입력 매개 변수

인수	선택 항목	수락	기본값	Description
If image	해당 없음	있음, 없음	예	선택된 이미지의 존재를 확인할 지 여부
Image	아니요	이미지 목록		있는 경우 작업이 검사할 이미지
다음에서 이미지 검색	해당 없음	전체 화면, 전경 창만	전체 화면	맨 앞 창에서만 지정된 이미지를 찾을지 아니면 전체 화면에서 찾을지 여부입니다. 화면에 명확하게 표시되지 않으면 두 선택 모두 이미지를 찾지 못합니다
Search mode	해당 없음	전체 화면 또는 전경 창 검색, 화면 또는 전경 창의 지정된 하위 영역에서 검색	전체 화면 또는 전경 창 검색	제공된 텍스트를 찾기 위해 전체 화면(또는 창)을 검사할지 또는 화면의 좁은 하위 범위만 검사할지 여부
Find all images in the list	해당 없음	부울 값	False	목록의 이미지가 모두 있는지 없는지 확인
X1	예	숫자 값		제공된 텍스트를 검사하기 위해 지정된 하위 지역의 시작 X 좌표
X2	예	숫자 값		제공된 텍스트를 검사하기 위해 지정된 하위 지역의 끝 X 좌표
Y1	예	숫자 값		제공된 텍스트를 검사하기 위해 지정된 하위 지역의 시작 Y 좌표
Y2	예	숫자 값		제공된 텍스트를 검사하기 위해 지정된 하위 지역의 끝 Y 좌표
Tolerance	예	숫자 값	10	원래 선택한 이미지와 검색한 이미지가 얼마나 다를지 지정
이미지 일치 알고리즘	사용 불가	기본, 고급	기본	이미지를 검색할 때 사용할 이미지 알고리즘

변수 생성됨

이 작업은 변수를 생성하지 않습니다.

예외

예외	Description
대화형이 아닌 모드에서 이미지를 확인할 수 없음	대화형이 아닌 모드에서 이미지가 식별될 수 없음을 나타냄
유효하지 않은 하위 지역 좌표	주어진 하위 지역의 좌표가 유효하지 않음을 나타냄

데스크톱 사용

작업 관련 데스크톱 및 작업 표시줄을 수행합니다.

입력 매개 변수

인수	선택 항목	수락	기본값	Description
UI 요소	아니요	UI 요소		클릭할 UI 요소
Click type	사용 불가	왼쪽 클릭, 오른쪽 클릭, 더블 클릭	왼쪽 클릭	수행할 클릭의 종류
Launch new application when left-clicking on the taskbar	해당 없음	부울 값	True	이 매개 변수가 ''참'으로 설정되면 Windows 7 이상 버전에서는 작업 표시줄로도 알려진 '빠른 실행' 표시줄의 아이콘을 왼쪽 클릭했을 때 응용 프로그램의 새 창이 나타납니다. 응용 프로그램의 이미 실행 중인 인스턴스를 전경에 가져오려면 이 옵션을 선택 취소하십시오.

변수 생성됨

이 작업은 변수를 생성하지 않습니다.

예외

예외	Description
작업 표시줄 작업 실패	작업 표시줄 작업 실패를 나타냄

창에서 탭 선택

탭의 그룹에서 탭을 선택합니다.

입력 매개 변수

인수	선택 항목	수락	기본값	Description
Tab	아니요	UI 요소		선택할 탭

변수 생성됨

이 작업은 변수를 생성하지 않습니다.

예외

예외	Description
Selecting tab failed	특정 탭을 선택하는 동안 문제가 발생했음을 나타냄

이미지 대기

이 작업은 특정 이미지가 화면 또는 전경 창에 나타날 때까지 대기합니다.

입력 매개 변수

인수	선택 항목	수락	기본값	Description
Wait for image to	해당 없음	나타남, 사라짐	나타남	이미지가 나타나거나 사라지기까지 대기 여부 확인
Image to wait for	아니요	이미지 목록		있는 경우 작업이 검사할 이미지
다음에서 이미지 검색	해당 없음	전체 화면, 전경 창만	전체 화면	맨 앞 창에서만 지정된 이미지를 찾을지 아니면 전체 화면에서 찾을지 여부입니다. 화면에 명확하게 표시되지 않으면 두 선택 모두 이미지를 찾지 못합니다
Search mode	해당 없음	전체 화면 또는 전경 창 검색, 화면 또는 전경 창의 지정된 하위 영역에서 검색	전체 화면 또는 전경 창 검색	제공된 텍스트를 찾기 위해 전체 화면(또는 창)을 검사할지 또는 화면의 좁은 하위 범위만 검사할지 여부
Wait for all images	해당 없음	부울 값	False	목록의 모든 이미지 또는 한 이미지만 나타나기(사라지기) 까지 대기할지 여부
X1	예	숫자 값		제공된 텍스트를 검사하기 위해 지정된 하위 지역의 시작 X 좌표
X2	예	숫자 값		제공된 텍스트를 검사하기 위해 지정된 하위 지역의 끝 X 좌표
Y1	예	숫자 값		제공된 텍스트를 검사하기 위해 지정된 하위 지역의 시작 Y 좌표
Y2	예	숫자 값		제공된 텍스트를 검사하기 위해 지정된 하위 지역의 끝 Y 좌표
Tolerance	예	숫자 값	10	원래 선택한 이미지와 검색한 이미지가 얼마나 다를지 지정
이미지 일치 알고리즘	사용 불가	기본, 고급	기본	이미지를 검색할 때 사용할 이미지 알고리즘
시간 제한 오류로 실패	사용 불가	부울 값	False	작업이 끝까지 대기하게 할지 아니면 설정된 기간 후에 실패하게 할지를 지정합니다

변수 생성됨

인수	Type	Description
X	숫자 값	화면에서 텍스트가 발견된 지점의 X좌표입니다. 텍스트가 전경 창에서 검색된 경우 이 값은 창의 왼쪽 상단 모서리를 기준으로 합니다.
Y	숫자 값	화면에서 텍스트가 발견된 지점의 Y좌표입니다. 텍스트가 전경 창에서 검색된 경우 이 값은 창의 왼쪽 상단 모서리를 기준으로 합니다.

예외

예외	설명
이미지 대기 실패	대기 작업 실패를 나타냄
대화형이 아닌 모드에서 이미지를 확인할 수 없음	대화형이 아닌 모드에서 이미지가 식별될 수 없음을 나타냄
유효하지 않은 하위 지역 좌표	주어진 하위 지역의 좌표가 유효하지 않음을 나타냄

창에 있는 UI 요소를 마우스로 가리키기

창의 UI 요소 위로 마우스를 가져갑니다.

입력 매개 변수

인수	선택 항목	수락	기본값	Description
UI 요소	아니요	UI 요소		창에서 가리킬 UI 요소를 선택합니다

변수 생성됨

이 작업은 변수를 생성하지 않습니다.

예외

예외	Description
요소를 가리키지 못함	요소를 마우스로 가리키지 못했음을 나타냄

창의 UI 요소 클릭

창의 UI 요소를 클릭합니다.

입력 매개 변수

인수	선택 항목	수락	기본값	Description
UI 요소	아니요	UI 요소		클릭한 UI 요소
Click type	사용 불가	왼쪽 클릭, 오른쪽 클릭, 더블 클릭, 가운데 클릭, 왼쪽 버튼 아래로, 왼쪽 버튼 위로, 오른쪽 버튼 아래로, 오른쪽 버튼 위로	왼쪽 클릭	수행할 클릭의 종류
작업 시뮬레이션	사용 불가	부울 값	False	클릭하기 전에 요소 위에서 마우스 커서의 이동을 시뮬레이션할지 여부를 지정합니다. 이 옵션을 사용하면 UI 요소 화면에 초점을 맞출 필요가 없으며 자동으로 전경으로 가져오지 않습니다. 이 옵션은 왼쪽 클릭 동작에만 적용할 수 있으며 모든 UI 요소에 적용할 수는 없습니다.
Mouse position relative to UI element	사용 불가	왼쪽 위, 중앙 위, 오른쪽 위, 왼쪽 가운데, 중앙 가운데, 오른쪽 가운데, 왼쪽 아래, 중앙 아래, 오른쪽 아래	중간 센터	클릭하기 전 마우스를 움직일 UI 요소의 섹션 지정
Offset X	예	텍스트 값	0	위치에서 이 많은 픽셀만큼 오른쪽으로 마우스 오프셋
Offset Y	예	텍스트 값	0	위치에서 이 많은 픽셀만큼 아래로 마우스 오프셋

변수 생성됨

이 작업은 변수를 생성하지 않습니다.

예외

예외	Description
클릭 실패	클릭 실패를 나타냄

창에서 메뉴 옵션 선택

창의 메뉴에서 옵션을 선택합니다.

입력 매개 변수

인수	선택 항목	수락	기본값	Description
UI 요소	아니요	UI 요소		선택할 메뉴 옵션

변수 생성됨

이 작업은 변수를 생성하지 않습니다.

예외

예외	Description
옵션을 선택하지 못함	특정 메뉴 옵션을 선택하는 동안 문제가 발생했음을 나타냄

창의 UI 요소 끌어서 놓기

창의 UI 요소 끌어서 놓습니다.

입력 매개 변수

인수	선택 항목	수락	기본값	Description
UI element to drag	아니요	UI 요소		끌 UI 요소
UI element to drop over	아니요	UI 요소		놓을 UI 요소
Click type	사용 불가	왼쪽 클릭, 오른쪽 클릭	왼쪽 클릭	UI 요소를 대상에 끌어 놓는 사이 클릭과 누르기에 사용할 마우스 버튼 지정
Mouse down offset X	예	텍스트 값	0	오른쪽의 이 많은 픽셀만큼 UI 요소 끌기를 잡는 데 사용할 마우스 아래 클릭 오프셋
Mouse down offset Y	예	텍스트 값	0	아래쪽의 이 많은 픽셀만큼 끌 UI 요소를 잡는 데 사용할 마우스 아래 클릭 오프셋
Mouse down position relative to drag-target UI element	해당 없음	왼쪽 위, 중앙 위, 오른쪽 위, 왼쪽 가운데, 중앙 가운데, 오른쪽 가운데, 왼쪽 아래, 중앙 아래, 오른쪽 아래	중간 센터	클릭하기 전에 마우스를 놓을 UI 요소의 섹션을 지정합니다.
Mouse up offset X	예	텍스트 값	0	오른쪽의 이 많은 픽셀만큼 끌 UI 요소를 잡는 데 사용할 마우스 위 클릭 오프셋
Mouse up offset Y	예	텍스트 값	0	아래쪽의 이 많은 픽셀만큼 끌 UI 요소를 잡는 데 사용할 마우스 위 클릭 오프셋
Mouse up position relative to drop-target UI element	해당 없음	왼쪽 위, 중앙 위, 오른쪽 위, 왼쪽 가운데, 중앙 가운데, 오른쪽 가운데, 왼쪽 아래, 중앙 아래, 오른쪽 아래	중간 센터	클릭한 후 마우스를 끌 UI 요소의 섹션을 지정합니다.

변수 생성됨

이 작업은 변수를 생성하지 않습니다.

예외

예외	Description
끌 UI 요소를 찾을 수 없음	끌 UI 요소를 찾을 수 없음을 나타냄
놓기 대상 UI 요소를 찾을 수 없음	놓기 대상 UI 요소를 찾을 수 없음을 나타냄
끌어서 놓기 실패	특정 UI 요소를 끌어서 놓는 동안 문제가 발생했음을 나타냄

창에서 펼칠 또는 접을 트리 노드

창에 있는 트리 보기의 노드를 확장하거나 축소합니다.

입력 매개 변수

인수	선택 항목	수락	기본값	Description
UI 요소	아니요	UI 요소		펼칠 또는 접을 트리 노드
Folders path	네	텍스트 값		펼칠 또는 접을 트리 노드로 이어지는 폴더 이름으로 만들어진 경로를 구분하는 슬래시
Use regular expressions	해당 없음	부울 값	False	경로의 각 폴더 이름을 정규식으로 해석할지 지정
Operation	해당 없음	확장, 축소	확장	트리 노드 펼치기 또는 접기 지정

노트

Power Automate의 정규식 엔진은 .NET입니다. 정규식에 대한 자세한 내용을 보려면 정규식 언어 - 빠른 참조로 이동하세요.

변수 생성됨

이 작업은 변수를 생성하지 않습니다.

예외

예외	Description
트리 노드를 특정 상태로 설정하지 못함	트리 노드를 특정 상태로 설정하는 동안 문제가 발생했음을 나타냄

창인 경우

이 작업은 창이 열려 있는지 여부 또는 창이 포커스(전경) 창인지 여부에 따라 조건부 작업 블록의 시작을 표시합니다.

입력 매개 변수

인수	선택 항목	수락	기본값	Description
Get window	해당 없음	창 UI 요소별, 창 인스턴스별/핸들별, 제목별 및/또는 클래스별	창 UI 요소별	UI 요소를 사용하는 창 또는 창 제목 또는 클래스 조합을 찾을지 여부 지정
Window title	예	텍스트 값		창 제목입니다. '?' 또는 '*'와 같은 와일드 카드를 사용할 수 있습니다.
Window	아니요	UI 요소		창 UI 요소
Window instance	아니요	숫자 값		확인할 창의 인스턴스 또는 핸들
Window class	예	텍스트 값		동일한 제목을 가진 창이 두 개 있으면 창 클래스에 따라 창을 구별할 수 있습니다. 이 경우 사용될 창의 클래스를 입력합니다.
Check if window	해당 없음	열려 있음, 열려 있지 않음, 포커스됨, 포커스되지 않음	열림	확인될 창의 상태

변수 생성됨

이 작업은 변수를 생성하지 않습니다.

예외

이 작업에는 예외가 포함되지 않습니다.

창 대기

특정 창이 열기 또는 닫기, 가져오기, 포커스 잃기를 할 때까지 실행 또는 처리를 일시 중단합니다.

입력 매개 변수

인수	선택 항목	수락	기본값	Description
Find window	해당 없음	창 UI 요소별, 창 인스턴스별/핸들별, 제목별 및/또는 클래스별	창 UI 요소별	UI 요소를 사용하는 창 또는 창 제목 또는 클래스 조합을 찾을지 여부 지정
Window title	예	텍스트 값		창 제목입니다. '?' 또는 '*'와 같은 와일드 카드를 사용할 수 있습니다.
Window	아니요	UI 요소		창 UI 요소
Window instance	아니요	숫자 값		확인할 창의 인스턴스 또는 핸들
Window class	예	텍스트 값		동일한 제목을 가진 창이 두 개 있으면 창 클래스에 따라 창을 구별할 수 있습니다. 이 경우 사용될 창의 클래스를 입력
Wait for window to	해당 없음	열기, 닫기, 포커스 하기, 포커스 해제	시작	특정 창의 열기, 닫기, 포커스되기(예: 전경 창 되기) 또는 포커스 잃기(예: 전경 창 중단) 여부를 지정합니다.
Focus window after it opens	해당 없음	부울 값	False	창을 연 후 창을 맨 앞으로 가져와 추후 작업을 이 창으로 가리킴

변수 생성됨

이 작업은 변수를 생성하지 않습니다.

예외

예외	Description
창을 포커스할 수 없음	특정 창을 포커스하는 동안 문제가 발생했음을 나타냄
창 대기 실패	대기 작업 실패를 나타냄
대화형이 아닌 모드에서 창 관련 작업을 수행할 수 없음	대화형이 아닌 모드에서 창 관련 작업을 수행하는 동안 문제가 발생했음을 나타냄