개요

FlowControl 라이브러리에서 제공하는 기능을 이용해 프로세스의 흐름을 제어할 수 있습니다.
반복 작업을 수행하거나, 조건에 따라 다른 작업을 설정하거나, 특정 조건으로 프로세스의 흐름을 늦추거나 종료할 수 있습니다.

FlowControl 라이브러리에서 사용할 수 있는 기능은 다음과 같습니다.

의사결정: IfElse, IfThen, SwitchCase
반복: Loop, For, Foreach, While, DoWhile
변수 할당: Assign
사용자 스크립트 작성: ExecuteScript, ExecuteLibrary
프로세스 컨트롤: Delay, TerminateFlow, TerminateAll, Break, Continue
디버깅, 로깅: Debugger, Log, DumpScreen
검사: AssertExpression, AssertEquals, AssertNull, AssertEmpty, AssertContains1D, AssertContains2D, AssertNumberRange, AssertDataType
기타: RetryTask, Reboot, TryCatch, DataConverter, Block

FlowControl 라이브러리에 대한 샘플을 디자이너 혹은 윈도우 탐색기를 이용하여 참조할 수 있습니다.

• 디자이너 경로: 메뉴 > 도움말 > 샘플 > Sample > FlowControl

• 윈도 탐색기 경로: C:\Users\user\AppData\Roaming\Brity RPA Designer\samples\FlowControl

[FlowControl 샘플 프로젝트명과 관련 라이브러리]

• FlowControl : IfElse, IfThen, Loop, For, Foreach, While, DoWhile, Block, SwitchCase, Delay, Assign, Break, Continue, TerminateFlow, TerminateAll

• Customized Script : ExecuteScript, ExecuteLibrary

• Debug : RetryTask, Reboot, Log, Debugger, DumpScreen

• Assert : AssertExpression, AssertEquals, AssertNull, AssertEmpty, AssertContains1D, AssertContains2D, AssertNumberRange, AssertDataType

공통 속성

DataConverter

데이터 타입 변환과 관련된 설정을 입력할 수 있습니다.

카드 속성
속성	유형	필수여부	단위	자동입력여부	설명
Type	콤보박스	N	-	Y	입력한 데이터를 변환할 타입을 선택합니다. ※ 타입 종류 - String, Number, Date, Json, Xml, Point, Rect
Method	콤보박스	Y	-	Y	타입별 사용 가능한 메소드를 선택합니다. 자세한 내용은 아래의 '타입별 사용 가능한 메소드'를 참고하세요.
Args	문자	N	-	N	메소드에 추가로 필요한 전달인자를 입력합니다.

타입별 사용 가능한 메소드

Type 별 Method
Type	method	설명	사용 예시
String	ToString	[Input] Input에 입력된 데이터를 String 타입 문자열로 변환합니다.
	Format	[Input] Input에 입력된 Format String에 Args에 입력한 값을 넣어 반환합니다.	Input: 'This is {0}' Args: 'Sample' Output > 'This is Sample'
	Trim	[Input] Input에 입력된 문자열을 String 타입으로 변환하고, 앞-뒤 공백을 제거합니다.
	ReplaceAll	[Input] Input에 입력된 문자열에서 특정 문자열을 찾아 바꿀 문자열로 모두 변경합니다.	Args: 'aa', 'bb' (aa를 모두 bb로 변경)
	Split	[Input] Input에 입력된 문자열을 Args에 입력한 특정 문자로 나누어 배열에 저장합니다.	Args: ':' (:로 문자열을 나눔)
	SplitTable	[Input] Input에 입력된 문자열을 Args에 입력한 특정 문자열 또는 문자 배열로 나누어 2차원 문자열 배열에 저장합니다.
	ExtractByRegex	[Input] Input에 입력된 문자열에서 Args에 입력된 정규식과 일치하는 값을 추출하여 반환합니다.
	IsMatch	[Input] Input에 입력된 문자열이 Args에 입력된 정규식과 일치하는지 검사하여 True 또는 False로 반환합니다.
Number	ToNumber	[Input] Input에 입력된 데이터를 Number 타입으로 변환합니다.
	Max	[Input] Input에 입력된 데이터와 Args에 입력된 숫자를 비교하여 더 큰 값을 반환합니다.
	Min	[Input] Input에 입력된 데이터와 Args에 입력된 숫자를 비교하여 더 작은 값을 반환합니다.
	Round	[Input] Input에 입력된 값을 특정 자릿수에서 반올림하여 반환합니다. Args에 숫자를 입력하면 해당 숫자 자릿수에서 반올림됩니다.
	Ceil	[Input] Input에 입력된 값을 소숫점 버림하여 정숫값으로 반환합니다.
	Floor	[Input] Input에 입력된 값을 소숫점 올림하여 정숫값으로 반환합니다.
	Abs	[Input] Input에 입력된 값의 절댓값을 반환합니다.
Date	ToDateTime	[Input] Input에 입력된 date format 문자열을 DateTime 문자열로 변환합니다. Args에 date format을 입력할 경우 해당 형식에 맞게 문자열로 반환합니다.
	ToUTCDateTime	[Input] Input에 입력된 date format의 문자열을 UTCDateTime으로 변환합니다. Args에 date format을 입력할 경우 해당 형식에 맞게 문자열로 반환합니다.
	FromExcelDate	[Input] Input에 입력된 Excel 문서에서 가져온 Date 문자열을 UTC Date Time으로 변환합니다. Args에 date format을 입력할 경우 해당 형식에 맞게 문자열로 반환합니다.
	AddYears, AddMonths, AddDays, AddHours, AddMinutes, AddSeconds	[Input] Input에 입력된 datetime에 Args에 입력된 숫자만큼 시간(시, 분, 초) 또는 날짜(연, 월, 일)를 더하거나 뺍니다.
	DateFormat	[Input] Input에 입력된 date format에 맞게 문자열로 반환합니다.
Json	ToString	[Input] Input에 입력된 Json 객체를 문자열로 바꾸어 반환합니다.
	ToJsonObject	[Input] Input에 입력된 Json 타입의 문자열을 Json 객체로 바꾸어 반환합니다.
	GetValueByKey	[Input] Input에 입력된 Json 타입의 문자열에서 Args에 입력한 key 값에 해당하는 값을 반환합니다.
Xml	ToString	[Input] Input에 입력된 Xml 객체를 문자열로 바꾸어 반환합니다.
Xml	GetValueByXpath	[Input] Input에 입력된 Xml 타입의 문자열에서 Args에 입력한 xpath 값에 해당하는 값을 반환합니다.
Point	ToPoint	[Input] Input에 입력된 Point 타입의 문자열을 Point 객체로 바꾸어 반환합니다.
Point	Offset	[Input] Input에 입력된 Point 객체에 Args에 입력한 오프셋값을 더하여 반환합니다.
Rect	ToRect	[Input] Input에 입력된 Rect 타입의 문자열을 Rect 객체로 바꾸어 반환합니다.
	Center	[Input] Input에 입력된 Rect 객체의 중앙 좌푯값을 Point 객체로 바꾸어 반환합니다.
	Offset	[Input] Input에 입력된 Rect 객체에 Args에 입력한 오프셋값을 더하여 반환합니다.

RESTART POSITION

작업 재시작과 관련된 설정을 입력할 수 있습니다.

카드 속성
속성	유형	필수여부	단위	자동입력여부	설명
Position Type	콤보박스	N	-	Y	재시작 위치를 지정하기 위한 방식을 선택합니다. (ErrorStep: 상대위치, StepNo: 절대위치)
Position	스크립트	Y	-	Y	재시작 위치를 입력합니다.

Assert

데이터 정합성과 관련된 설정을 입력할 수 있습니다.

카드 속성
속성	유형	필수여부	단위	자동입력여부	설명
Variable	변수	Y	-	Y	검사 대상 변수를 지정합니다.
Assert Message	문자열	N	-	N	정해진 조건에 맞지 않을 때 출력하는 에러 메시지를 지정합니다.

MORE OPTION

카드 속성
속성	유형	필수여부	단위	자동입력여부	설명
Interation Variable	변수	N	-	N	Start Index부터 시작하여 반복하는 동안 1씩 증가하는 인덱스 값을 저장할 변수를 입력합니다.
Start Index	숫자	N	-	Y	Start Index를 입력합니다. (기본값: 0) 입력하지 않으면 0부터 시작합니다.
Show Message Box	토글버튼	N	-	N	메시지 박스를 표시하도록 설정합니다.
Screenshot	토글버튼	N	-	N	화면을 캡처하도록 설정합니다.
On Error	콤보박스	N	-	N	오류 발생 시 처리 방법을 설정합니다. - Ignore: 해당 오류를 무시합니다. - Retry: 해당 액티비티를 1회 재시도합니다. - Goto: 해당 액티비티가 실패한 경우 지정한 액티비티로 이동하여 시나리오를 수행합니다. - Event: 프로젝트 내에 생성된 이벤트를 선택합니다.
GotoStep Relative Position	숫자	N	-	N	해당 액티비티를 기준으로 이동할 액티비티를 선택합니다. Ctrl + F 를 통해 액티비티 번호를 확인 후 [해당 액티비티 번호] - [대상 액티비티 번호] 값을 입력합니다. (기본값: 0)
GotoStep Retry Count	콤보박스	N	-	N	해당 액티비티가 실패한 경우 지정된 횟수만큼 이동을 반복합니다. (기본값: 1)

DESCRIPTION

카드 속성
속성	유형	필수여부	단위	자동입력여부	설명
Description	문자	N	-	N	해당 액티비티 카드 대한 설명을 추가합니다. Description이 입력되면 플로차트의 해당 액티비티 설명에 표시되고, Description이 없는 경우에는 대푯값이 표시됩니다.

IfElse

개요

조건에 따라 다음에 수행될 액티비티가 달라지도록 True/False 분기문을 설정합니다. JavaScript의 If/else 기능과 동일합니다.
프로세스나 태스크, 이벤트의 플로차트에서 사용할 수 있습니다.

사용 절차

Condition에 조건을 입력하세요.
추가 조건이 필요한 경우 +Add Conditions를 클릭해 조건을 추가하세요.
True일 경우와 False일 경우에 각각 수행할 액티비티를 플로차트에서 설정하세요.

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	Condition	조건식	Y	-	Y	조건문을 입력합니다. (기본값: RESULT==true) 조건문을 여러 개 입력하려면 Add Conditions 속성을 이용하여 조건을 추가하거나 AND('&&'), OR('\|\|') 연산자를 사용합니다.
N	Add Conditions	기타	N	-	-	조건을 추가합니다.
N	Combine Condition	버튼	N	-	N	추가한 조건들을 조합할 연산자를 AND와 OR 중에서 선택합니다.
Y	DESCRIPTION	-	-	-	-	FlowControl 라이브러리의 공통 속성입니다.

활용 예시

입력 받은 변숫값에 따라 구글 또는 삼성SDS닷컴 웹사이트를 엽니다.

입력 받은 변수 InputValue의 값이 ‘1’인 경우에는 OpenBrowser 액티비티로 “www.google.com” 웹 페이지를 열고, 그 외의 변수가 입력될 경우에는 “www.amazon.com” 웹 페이지를 열도록 설정합니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Flow Control > Flow Control > P_If_Test

사용된 변수

inputValue = 입력 받을 값

사용된 속성

Condition = this.inputValue == 1 || this.inputValue ==2

연관/유사 액티비티

IfThen, SwitchCase

IfThen

개요

특정 조건에 부합할 때만 액티비티를 수행하도록 조건문을 설정합니다. JavaScript의 If 기능과 동일합니다.

사용 절차

Condition에 조건을 입력하세요.
추가 조건이 필요한 경우 +Add Conditions를 클릭해 조건을 추가하세요.
True일 경우에 수행할 액티비티를 플로차트에서 설정하세요.

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	Condition	조건식	Y	-	Y	조건문을 입력합니다. (기본값: RESULT==true) 조건문을 여러 개 입력하려면 Add Conditions 속성을 이용하여 조건을 추가하거나 AND('&&'), OR('\|\|') 연산자를 사용합니다.
N	Add Conditions	기타	N	-	-	조건을 추가합니다.
N	Combine Condition	버튼	N	-	N	추가한 조건들을 조합할 연산자를 AND와 OR 중에서 선택합니다.
Y	DESCRIPTION	-	-	-	-	FlowControl 라이브러리의 공통 속성입니다.

활용 예시

입력 받은 변숫값이 설정 조건에 맞을 경우 구글 웹 페이지를 열도록 설정합니다.

입력 받은 변수 inputValue의 값이 '1'이면 openBrowser 액티비티로 ‘www.google.com’을 열도록 설정합니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Flow Control > Flow Control > P_IfThen_Test

사용된 변수

inputValue = 입력 받을 값

사용된 속성

Condition = this.inputValue == 1

연관/유사 액티비티

If, SwitchCase

Loop

개요

같은 내용을 지정된 횟수만큼 반복하여 수행하도록 설정합니다.
Loop 타입이 'Count'면 입력한 반복 횟수만큼 수행합니다.
Loop Type이 'List'면 리스트에 속한 아이템을 차례대로 하나씩 가져옵니다.

사용 절차

Loop Type에서 Count 또는 List를 선택하세요. ProcessFlow 의 경우에는 관련 선택 속성은 보이지 않으며, 항상 Count 방식으로 동작합니다.
선택한 Loop 타입에 따른 속성들을 설정하세요. ProcessFlow 의 경우에는 관련 선택 속성은 보이지 않으며, 항상 Count 방식으로 동작합니다.
- Count를 선택한 경우: Iteration Count(반복 횟수)를 설정하세요.
- List를 선택한 경우: List Variable(리스트 타입 변수), Item Variable(리스트 타입 변수에서 가져온 아이템을 저장할 변수), Start Index(시작 인덱스 번호), Iteration Count(반복 횟수)를 설정하세요.
반복하여 수행하고자 하는 액티비티를 Loop 다이어그램 사이에 추가하세요.

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	Loop Type	버튼	Y	-	Y	Loop 타입을 선택합니다. (기본값: Count) - Count: Start Index부터 시작하여 입력된 횟수만큼 반복 수행합니다. - List: 리스트 타입 변수에서 아이템을 하나씩 읽어옵니다. . ProcessFlow 의 경우에는 관련 선택 속성은 보이지 않으며, 항상 Count 타입 방식으로 동작합니다.
N	[Count] Iteration Count	숫자	Y	양수	Y	반복 횟수를 입력합니다. (기본값: 1) Loop 타입이 Count일 경우에는 필수 입력값이며, List일 경우에는 입력하지 않으면 선택한 리스트의 크기만큼 반복 수행합니다.
N	[List] List Variable	변수	Y	-	N	리스트 타입 변수를 선택합니다.
N	[List] Item Variable	변수	Y	-	N	리스트 타입 변수에서 가져온 아이템을 저장할 변수를 입력합니다.
Y	카드 속성	-	-	-	-	FlowControl 라이브러리의 공통 속성입니다.
Y	카드 속성	-	-	-	-	FlowControl 라이브러리의 공통 속성입니다.

활용 예시

Count 또는 List 타입 변수의 항목 개수만큼 Loop를 수행합니다. 
Notepad 앱을 실행하고 리스트 개수만큼 각 항목을 작성합니다. 이후 마지막 작성한 리스트 항목을 메시지 박스로 출력한 후 Notepad 앱을 종료합니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Flow Control > Flow Control > P_Loop_Count_Test
메뉴 > 도움말 > 샘플 > Sample > Flow Control > Flow Control > P_Loop_List_Test

사용된 변수

openApp1 = 실행한 Notepad 앱을 지정할 변수
index = 반복 횟수를 저장할 변수 (Count 타입)
list = 입력할 내용을 저장한 배열 변수 (List 타입)
item = 해당 차수에 맞는 리스트에 해당하는 값 (List 타입)

사용된 속성

Loop Type = Count
Iteration Count = 5 (Count 타입)
Item Variable = this.index (Count 타입)

Loop Type = List
List Variable = this.list (List 타입)
Item Variable = this.item (List 타입)

연관/유사 액티비티

For, Foreach, While, DoWhile

For

개요

사용자가 정의한 조건에 맞게 반복하여 수행하도록 설정합니다.
JavaScript의 For loop 기능과 동일합니다.

사용 절차

Initialize에 반복문을 시작하고자 하는 Index의 초깃값을 입력하세요.
Condition에 반복문을 종료하는 Index의 조건을 입력하세요.
Update에 Index의 증가분을 입력하세요.

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	Initialize	스크립트	Y	-	Y	Index의 초깃값을 입력합니다. (기본값: this.i = 0)
N	Condition	스크립트	Y	-	Y	Index의 조건을 입력합니다. (기본값: this.i < 1)
N	Update	스크립트	Y	-	Y	Index의 업데이트 내용을 입력합니다. (기본값: this.i++)
Y	DESCRIPTION	-	-	-	-	FlowControl 라이브러리의 공통 속성입니다.

활용 예시

this.i 변수가 0으로 시작하여 5 미만이 될 때까지 값을 1씩 증가시키면서 반복문을 5회 반복 수행합니다.
Notepad 앱을 실행한 후 For문에 따라 본문 영역에 0부터 4까지 차례대로 텍스트를 입력합니다. 이후 마지막 숫자가 4면 Notepad 앱을 종료하고, 4가 아니면 “Run error”라는 메시지 박스를 출력합니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Flow Control > Flow Control > P_For_Test

사용된 변수

openApp1 = 실행한 Notepad 앱을 지정할 변수

사용된 속성

Initialize = this.i = 0
Condition = this.i < 5
Update = this.i ++

연관/유사 액티비티

Loop, Foreach, While, DoWhile

Foreach

개요

List Item(배열)에서 데이터를 차례대로 가져오는 반복문을 작성합니다. 
JavaScript의 Foreach 기능과 동일합니다.

이 기능을 활용하기 위해서는 “For-of”, “For-in” 등 “Foreach” 계열 JavaScript 기능에 대한 사전 지식이 필요합니다.

사용 절차

For List에 리스트 타입의 변수를 입력하세요.
Each Item에 리스트 타입 변수의 각 아이템이 하나씩 할당될 변수를 입력하세요.
For-of 또는 For-in을 선택하세요. ProcessFlow 의 경우에는 관련 선택 속성은 보이지 않으며, 항상 For-in 으로 동작합니다.

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	For List	변수	Y	-	N	데이터가 있는 리스트 타입의 변수를 입력합니다.
N	Each Item	변수	Y	-	N	리스트 타입의 각 순회 결과가 하나 씩 할당될 변수를 입력합니다.
N	For-of / For-in	버튼	Y	-	Y	자바스크립트 구문과 동일한 목적으로 사용합니다. (기본값: For-of) For-of 의 경우 리스트 항목의 아이템 값이 Each Item 속성에 최종 반환 됩니다. For-in 의 경우 리스트 중 유효한 항목의 색인 순서 값이 Each Item 속성에 최종 반환 됩니다. ProcessFlow 의 경우에는 관련 선택 속성은 보이지 않으며, 항상 For-in 으로 동작합니다.
Y	카드 속성	-	-	-	-	FlowControl 라이브러리의 공통 속성입니다.

활용 예시

변수 forList의 값 개수 만큼 반복문을 실행합니다.

List Item(배열) 개수만큼 반복하여 실행합니다. 실행 시마다 Notepad를 실행한 후 메시지 박스에 배열의 순서에 해당하는 내용을 출력합니다. 반목분이 종료되면 Notepad를 모두 종료합니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Flow Control > Flow Control > P_Foreach_Test

사용된 변수

openApp1 = 실행된 Notepad 앱을 지정할 변수
eachItem = 순서에 해당하는 forList의 값
forList = 전체 데이터

사용된 속성

For List = this.forList
Each Item = this.eachItem
For-of / For-in = For-Of

연관/유사 액티비티

For, Loop, While, DoWhile

While

개요

특정 조건까지 수행되는 반복문을 생성합니다.
JavaScript의 while 기능과 동일합니다

사용 절차

While Condition에 조건을 입력하세요.
추가 조건이 필요한 경우 +Add Conditions를 클릭해 설정하세요.
반복 수행할 액티비티를 While 다이어그램 사이에 추가하세요.

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	While Condition	조건식	Y	-	N	조건문을 입력합니다. 조건문을 여러 개 입력하려면 Add Conditions 속성을 이용하여 조건을 추가하거나 AND('&&'), OR('\|\|') 연산자를 사용합니다.
N	Add Conditions	기타	N	-	-	조건을 추가합니다.
N	Combine Condition	버튼	N	-	N	추가한 조건들을 조합할 연산자를 AND와 OR 중에서 선택합니다.
Y	DESCRIPTION	-	-	-	-	FlowControl 라이브러리의 공통 속성입니다.

활용 예시

입력 받은 leftValue 변숫값에 1을 더하고, 입력 받은 leftValue가 5보다 작을 때까지 반복 수행하면서 각 숫자를 메시지 박스로 출력합니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Flow Control > Flow Control > P_While_Test

사용된 변수

leftValue = 증가된 값
startValue = 초깃값(0)

사용된 속성

While Condition = this.leftValue < 5
Combine condition = And
Condition = this.leftValue < 5

연관/유사 액티비티

For, Foreach, Loop, DoWhile

DoWhile

개요

특정 조건까지 수행되는 반복문을 생성합니다.
JavaScript의 Do-while 기능과 동일합니다.

사용 절차

Condition에 조건을 입력하세요.
추가 조건이 필요한 경우 +Add Conditions를 클릭해 설정하세요.
반복 수행할 액티비티를 DoWhile 다이어그램 사이에 추가하세요.

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	Condition	조건식	Y	-	N	조건문을 입력합니다. 조건문을 여러 개 입력하려면 Add Conditions 속성을 이용하여 조건을 추가하거나 AND('&&'), OR('\|\|') 연산자를 사용합니다.
N	Add Conditions	기타	N	-	-	조건을 추가합니다.
N	Combine Condition	버튼	N	-	N	추가한 조건들을 조합할 연산자를 AND와 OR 중에서 선택합니다.
Y	DESCRIPTION	-	-	-	-	FlowControl 라이브러리의 공통 속성입니다.

활용 예시

입력 받은 count 변숫값에 1을 더하고, count가 3보다 작을 때까지 반복 수행하면서, 각 수행 시마다 “(해당 숫자)  + 번째 메시지입니다”를 메시지 박스로 표시합니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Flow Control > Flow Control > P_DoWhile_Test

사용된 변수

count = 증가되는 값

사용된 속성

Condition = this.count <= 3

연관/유사 액티비티

For, Foreach, Loop, While

Block

개요

프로세스의 특정 구간을 그룹으로 묶어 접기/펴기로 단락을 나누어 사용할 수 있도록 합니다.

사용 절차

그룹으로 묶고자 하는 카드들을 선택하여 Block 안으로 옮기세요.

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	Title	문자	N	-	N	그룹으로 묶은 단락의 Title을 지정합니다.
Y	DESCRIPTION	-	-	-	-	FlowControl 라이브러리의 공통 속성입니다.

활용 예시

Block 액티비티 카드를 더블클릭하여 카드 내의 화면 표시 내용을 확장 또는 축소할 수 있습니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Flow Control > Flow Control > P_Block_Test

사용된 변수

없음

사용된 속성

없음

SwitchCase

개요

특정 조건으로 다중 분기를 할 수 있습니다.

사용 절차

SwitchGroup(카드의 'Switch' 부분 클릭)의 Condition에 분기 조건을 입력하세요.
액티비티 카드 내 'Case' 클릭 시 표시되는 Case 속성에 Condition의 분기 조건과 비교할 조건값을 설정하세요.
액티비티 카드 내 'Case'를 더블클릭하여 실행할 내용을 입력하세요. (액티비티 카드에 마우스 포인터를 올렸을 때 표시되는 ‘+’을 더블클릭하면 새로운 Case 구문이 추가됩니다.)

CASE문 내부의 노드 접기 상태는 저장되지 않습니다.

CASE문 진입 시 내부의 노드들은 항상 펼쳐진 상태로 표시되며, 차트 저장 시 CASE문 내부의 노드는 모두 펼쳐진 상태로 저장됩니다.

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	Condition	문자	Y	-	N	분기에 필요한 조건을 입력합니다
N	Case	문자	Y	-	N	분기 조건과 비교할 조건값을 입력합니다.
Y	DESCRIPTION	-	-	-	-	FlowControl 라이브러리의 공통 속성입니다.

활용 예시

특정 조건에 맞게 수행할 내용을 각 Case에 입력합니다.

InputBox에 입력되는 수치를 확인하여 1이면 “Banana”, 2면 “Apple”, 3이면 “Orange”, 나머지는 “You didn't choose 1~3”을 표시합니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Flow Control > Flow Control > P_SwitchCase_Test

사용된 변수

Case = Case 번호

사용된 속성

Condition = this.Case
첫 번째 Case = '1'
두 번째 Case = '2'
세 번째 Case = '3'

Delay

개요

사용자가 정의한 시간만큼 프로세스 수행을 대기합니다.

사용 절차

Second(초 단위)와 Millisecond(밀리초 단위)에 대기할 시간을 각각 입력하세요.

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	Second	숫자	Y	sec	Y	초 단위 시간을 입력합니다. (기본값: 1)
N	Millisecond	숫자	Y	ms	Y	밀리초 단위 시간을 입력합니다. (기본값: 0)
Y	MORE OPTIONS	-	-	-	-	FlowControl 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	FlowControl 라이브러리의 공통 속성입니다.

활용 예시

브라우저를 열고 3초 동안 대기한 후 “RPA” 검색어를 입력하여 검색합니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Flow Control > Flow Control > P_Delay_Test

사용된 변수

변수 없음

사용된 속성

Second = 3

Assign

개요

지정된 변수에 값을 할당합니다.

사용 절차

[Output] Variable에 값이 할당될 변수를 입력하세요.
Value에 변수에 할당할 값을 입력하세요.

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
Y	[Output] Variable	변수	Y	-	-	값이 할당될 변수를 입력합니다.
N	Value	문자	Y	-	-	변수에 할당할 값을 입력합니다. - Normal: 입력한 값이 일반 텍스트로 저장됩니다. - Secure: 입력한값이암호화되어저장됩니다. 비밀번호 등 암호화가 필요한 경우에 선택합니다.
Y	MORE OPTIONS	-	-	-	-	FlowControl 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	FlowControl 라이브러리의 공통 속성입니다.

활용 예시

입력 받은 leftValue 변숫값('Assign Test')을 Notepad 앱에 입력합니다..

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Flow Control > Flow Control > P_Assign_Test

사용된 변수

openApp1 = 실행된 Notepad 앱을 지정할 변수
leftValue = 값이 할당될 변수

사용된 속성

[Output] Variable = this.leftValue
Value = 'Assign Test'

DataConverter

개요

입력된 데이터의 타입을 바꾸거나, 추출한 데이터를 원하는 형태로 변환하도록 설정합니다.

사용 절차

[Output] Output에 변환된 값을 저장할 변수를 입력하세요.
[Input] Input에 변환할 값을 입력하세요.
DataConverter 공통 속성의 표를 참고하여 변환 설정을 입력하세요.

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	[Output] Output	변수	Y	-	Y	DataConverter에서 반환된 값이 저장될 변수를 입력합니다. (기본값: RESULT)
N	[Input] Input	변수	Y	-	N	입력될 데이터를 입력합니다.
Y	DataConverter	-	-	-	-	FlowControl 라이브러리의 공통 속성입니다.
Y	MORE OPTIONS	-	-	-	-	FlowControl 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	FlowControl 라이브러리의 공통 속성입니다.

특이 사항

상세 설정 내용과 타입별 사용 가능한 메소드에 대한 자세한 내용은 공통 속성을 참고하세요.

연관/유사 액티비티

DataConveter 라이브러리에서 액티비티 카드별 상세한 설명을 확인할 수 있습니다.

ExecuteScript

개요

사용자가 JavaScript 문법으로 직접 스크립트를 작성합니다.

사용 절차

Title 에 Title로 설정하고자 하는 문자열을 입력하세요.
SCIRPT에 사용자 정의 스크립트를 입력하세요. 텍스트 상자를 더블클릭하면 ScriptEditor를 사용할 수 있습니다.

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	SCRIPT	스크립트	N	-	N	사용자 정의 스크립트를 입력합니다. 텍스트 상자를 더블클릭하면 ScriptEditor를 사용할 수 있습니다.
Y	MORE OPTIONS	-	-	-	-	FlowControl 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	FlowControl 라이브러리의 공통 속성입니다.

활용 예시

오늘 날짜를 표시하는 스크립트를 작성합니다.

Notepad 앱을 실행한 후 ‘오늘 날짜’ 스크립트를 입력하여 오늘이 몇월 며칠인지 출력합니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample >Flow Control > Customized Script > P_ExecuteScript_Test

사용된 변수

var1 = 금일 변수
mMonth = 금일 Month 변수
mDate = 금일 Date 변수
openapp = 실행된 Notepad 앱을 지정할 변수

사용된 속성

SCIRPT에 입력된 사용자 정의 스크립트

this.var1 = new Date();
this.mMonth = this.var1.getMontrh() + 1;
this.mMontrh = this.mMontrh;
this.mDate = this.var1.getDate();

연관/유사 액티비티

ExecuteLibrary

개요

사용자가 JavaScript로 작성한 스크립트 함수를 실행합니다.

사용 절차

JavaScript 문법으로 작성된 스크립트가 있어야 합니다.

[Output] Result에 실행한 결과를 저장하기 위한 변수를 지정하세요.
Library와 Function에 사용할 라이브러리 함수 종류와 메소드를 각각 선택하세요.
Arguments에 스크립트 함수를 실행하기 위한 속성값을 입력하세요.

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	[Output] Result	변수	N	-	Y	스크립트 함수를 실행한 결과를 저장할 변수를 입력합니다. (기본값: RESULT)
N	Library	콤보박스	Y	-	N	라이브러리 함수의 종류를 선택합니다. ※ 함수 종류 - Bot, Datetime, Hotkey, Math, String
N	Function	콤보박스	Y	-	N	선택한 라이브러리 함수의 메소드를 선택합니다. ※ 메소드 종류 - Round, Max, Abs
N	Arguments	문자	N	-	N	스크립트 합수를 실행하기 위한 속성값을 입력합니다.
Y	MORE OPTIONS	-	-	-	-	FlowControl 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	FlowControl 라이브러리의 공통 속성입니다.

활용 예시

최대값을 계산하는 스크립트 함수를 실행한 후 그 결과값을 메시지 박스로 출력합니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Flow Control > Customized Script > P_ExecuteLibrary_Test

사용된 변수

outValue = 스크립트 함수를 실행한 결괏값을 저장할 변수
num1 = 숫자
num2 = 숫자

사용된 속성

[Output] Result = this.outValue
Library = Math
Function = Max
Arguments = this.num1, this.num2

특이 사항

∙ 스크립트는 아래와 같은 형태로 작성하세요.

Script.파일명 = new function(){

this.함수명 = function(파라미터 목록){}

}

∙ 프로그램 설치 시 기본적인 스크립트 함수가 함께 제공됩니다. 자세한 내용은 프로그램 설치 경로의 Libraries 폴더의 .js 파일을 참고하세요.

∙ 작성한 스크립트 함수 파일은 윈도우 '문서(Documents)' 폴더 내 프로젝트 폴더에 Libraries 폴더를 생성한 후 저장하세요.

연관/유사 액티비티

ExecuteScript

Break

개요

For문과 같은 반복문 내에서 사용자가 지정한 시점에 반복을 종료합니다.
JavaScript의 break 기능과 동일합니다.

사용 절차

For 등과 같은 반복문 내에서만 적용할 수 있습니다.

반복문을 종료할 지점에 Break 액티비티 카드를 배치하세요.

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
Y	DESCRIPTION	-	-	-	-	FlowControl 라이브러리의 공통 속성입니다.

활용 예시

반복문 실행 중 원하는 위치에서 종료합니다.

For문을 사용하여 반복문이 10번 진행하는 동안 InputBox에 1이 입력되면 반복문을 종료하고, 이외의 값이 입력되면 Notepad 앱을 실행한 후 종료합니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Flow Control > Flow Control > P_Break_Test

사용된 변수

inputValue = 입력 받을 값
openApp1 = 실행된 Notepad 앱을 지정할 변수

사용된 속성

없음

연관/유사 액티비티

Continue

개요

For문과 같은 반복문 내에서 사용자가 지정한 시점에 반복문의 다음 단계로 넘어갑니다.
JavaScript의 break 기능과 동일합니다.

사용 절차

For 등의 반복문 내에서만 적용할 수 있습니다.

반복문 안에서 다음 단계로 넘기고자 하는 지점에 Continue 카드를 배치하세요.

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
Y	DESCRIPTION	-	-	-	-	FlowControl 라이브러리의 공통 속성입니다.

활용 예시

반복문 실행 중 원하는 위치에서 다음 단계로 이동합니다.

For문을 사용하여 반복문이 10번 진행하는 동안 InputBox에 1이 입력되면 다음 단계로 바로 넘어가고, 이외의 값이 입력되면 Notepad 앱을 실행한 후 종료합니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Flow Control > Flow Control > P_Continue_Test

사용된 변수

inputValue = 입력 받을 값
openApp1 = 실행된 Notepad 앱을 지정할 변수

사용된 속성

없음

연관/유사 액티비티

Break

TerminateFlow

개요

수행 중인 작업(플로우)을 종료합니다. 
Javascript의 Return 기능과 동일합니다.

사용 절차

작업을 종료하고자 하는 곳에 TerminateFlow 카드를 배치하세요.
Result에 작업 종료 시 반환할 값을 입력하세요.

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	Result	문자	N	-	N	작업 종료 시 반환할 값을 입력합니다.
Y	DESCRIPTION	-	-	-	-	FlowControl 라이브러리의 공통 속성입니다.

활용 예시

원하는 시점에 현재 수행 중인 플로우를 종료합니다.

For문을 사용하여 반복문이 10번 진행하는 동안 InputBox에 1이 입력되면 Notepad 앱을 실행한 후 종료하고, 이외의 값이 입력되면 현재 작업을 종료합니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Flow Control > Flow Control > P_TerminateFlow_Test

사용된 변수

inputValue = 입력 받을 값
openApp1 = 실행된 Notepad 앱을 지정할 변수

사용된 속성

없음

연관/유사 액티비티

TerminateAll

개요

수행 중인 프로세스를 종료합니다.
Javascript의 Exit 기능과 동일합니다.

사용 절차

Job Result에서 프로세스가 종료되면 Orchestrator 서버에 표시할 실행 결과(Pass, Fail, Stop)를 선택하세요.
Exit Message에 프로세스 종료 시 표시할 메시지를 입력하세요.
Exit Code에 프로세스 종료 시 반환할 값을 입력하세요.

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	Job Result	버튼	Y	-	Y	프로세스 종료 시점에 오케스트레이터 서버에 표시할 실행 결과를 Pass, Fail, Stop 중에서 지정합니다. (기본값: Fail)
N	Exit Message	문자	N	-	N	프로세스 종료 시 표시할 메시지를 입력합니다.
N	Exit Code	스크립트	N	-	N	프로세스 종료 시 반환할 값을 입력합니다.
Y	DESCRIPTION	-	-	-	-	FlowControl 라이브러리의 공통 속성입니다.

활용 예시

원하는 시점에 현재 수행 중인 프로세스를 종료합니다.

For문을 사용하여 반복문이 10번 진행하는 동안 InputBox에 1이 입력되면 Notepad 앱을 실행한 후 종료하고, 이외의 값이 입력되면 현재 프로세스를 종료합니다..

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Flow Control > Flow Control > P_TerminateAll_Test

사용된 변수

inputValue = 입력 받을 값
openApp1 = 실행된 Notepad 앱을 지정할 변수

사용된 속성

Job Result = Fail

연관/유사 액티비티

TerminateFlow

TryCatch

개요

스크립트 수행 중 예외 처리를 수행합니다. 각 카드의 onError 이벤트 속성과 유사합니다.
JavaScript의 TryCatch 기능과 동일합니다.

사용 절차

오류 발생 시 예외 처리할 액티비티 카드를 TryCatch 액티비티 사이에 배치하세요.
[Output] ErrorMessage에 오류 발생 시 출력할 메시지를 입력하세요.
onError에서 오류 발생 시 수행할 동작을 지정하세요.

의도적으로 오류를 발생시킬 필요가 있는 경우 다음과 같은 방법을 활용할 수 있습니다.

1. AssertExpressoin 라이브러리를 사용하여 아래와 같이 속성을 설정하여 오류를 발생시킬 수 있습니다.

- Expression : false / Assert Message : '오류 메시지 내용'

2. ExecuteScript 라이브러리를 사용해야 하는 경우에는 AssertExpression 라이브러리의 스크립트 구문을 직접 작성하거나 throw 구문을 작성하여 오류를 발생시킬 수 있습니다. throw 구문을 사용할 경우에는 'message' 속성을 가지는 객체를 사용하여 메시지를 전달해야 합니다.

- Script.Testing.Assert (false, '오류 메시지 내용');

- throw { 'message' : '오류 메시지 내용' };

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	[Output] ErrorMessage	변수	N	-	N	오류 메시지로 출력할 변수를 입력합니다.
N	onError	콤보박스	N	-	Y	예외 상황 발생 시 처리 방법을 설정합니다. (기본값: '--Ignore--') --Ignore--: 해당 오류를 무시합니다. --Event--: 프로젝트 내에 생성된 이벤트
Y	DESCRIPTION	-	-	-	-	FlowControl 라이브러리의 공통 속성입니다.

연관/유사 액티비티

RetryTask

RetryTask

개요

오류가 발생했을 때 해당 작업을 OnError 이벤트에서 재시작합니다.

RetryTask는 대상 작업을 지정한 위치부터 재시작한 후 대상 작업의 Output 타입의 변수값 정보를 Json 포멧으로 반환합니다.
RetryTask는 Result 속성을 설정하지 않으면 대상 작업의 수행이 완료된 후 작업의 반환값을 이벤트를 호출한 작업으로 그대로 반환하며 RetryTask 뒤에 정의된 액티비티는 수행되지 않습니다.
Result 속성에 작업의 결과를 저장할 변수를 설정하는 경우 RetryTask의 뒤에 정의된 액티비티가 실행되지만, 대상 작업의 Output 타입 변수가 존재하는 경우 반드시 이벤트 종료전에 작업의 결과를 명시적으로 반환하도록 시나리오를 구성해야 합니다.
작업 결과 반환은 RetryTask의 Result 변수를 TerminateAll 의 ExitMessage 혹은 TerminateFlow의 Result 속성에 입력하여 반환할 수 있습니다.
RetryTask 를 개별 스텝의 OnError 이벤트에서 사용하는 경우에는 RetryTask의 반환값을 해당 스텝이 수신할 수 없으므로 RetryTask의 Result 변수는 Gloabl변수를 사용하여 저장해야 이후 RetryTask의 결과값을 활용할 수 있습니다.

사용 절차

오류 발생 시 예외 처리할 액티비티 카드 다음에 RetryTask 액티비티 카드를 배치하세요.
RESTART POSITION의 Position Type에 재시작 위치를 지정하는 방식을 선택하세요.(ErrorStep: 상대 위치, StepNo: 절대 위치)
RESTART POSITION의 Position에 재시작 위치를 입력하세요.(기본값: 0)

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	[Output] Result	변수	N	-	N	실행한 결과를 저장할 변수를 입력합니다. 기본값 그대로 변수를 지정하지 않으면 작업의 수행결과를 그대로 반환하여 이벤트 시나리오가 종료되어 RetryTask의 다음 단계는 실행되지 않습니다. Result에 변수를 지정하면 RetryTask의 다음 단계가 이어서 실행할 수 있으나, 이 경우에는 반드시 TerminateFlow를 사용하여 TerminateFlow의 Result 속성에 RetryTask 의 Result에 설정한 변수를 입력하여 RetryTask의 수행결과를 반환해야 합니다.
Y	RESTART POSITION	-	-	-	-	FlowControl 라이브러리의 공통 속성입니다.
Y	MORE OPTIONS	-	-	-	-	FlowControl 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	FlowControl 라이브러리의 공통 속성입니다.

연관/유사 액티비티

TryCatch

Reboot

개요

컴퓨터를 재부팅합니다. 재부팅을 하기 전에 수행 중인 프로세스는 종료됩니다.

사용 절차

컴퓨터를 재부팅하고자 하는 곳에 Reboot 액티비티 카드를 배치하세요.
Job Result에서 프로세스가 종료되면 오케스트레이터 서버에 표시할 실행 결과(Pass, Fail, Stop)를 선택하세요.
Exit Code에 프로세스 종료 시 반환할 값을 입력하세요.
Exit Message에 프로세스 종료 시 표시할 메시지를 입력하세요.

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	Job Result	버튼	Y	-	Y	프로세스 종료 시점에 오케스트레이터서버에 표시할 실행 결과를 Pass, Fail, Stop 중에서 지정합니다. (기본값: Fail)
N	Exit Code	스크립트	N	-	N	프로세스 종료 시 반환할 값을 입력합니다.
N	Exit Message	문자	N	-	N	프로세스 종료 시 표시할 메시지를 입력합니다.
Y	MORE OPTIONS	-	-	-	-	FlowControl 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	FlowControl 라이브러리의 공통 속성입니다.

활용 예시

특정 시점에 컴퓨터를 재부팅합니다.

InputBox에 1이 입력될 경우 모든 프로세스를 종료하고 컴퓨터를 재부팅합니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Flow Control > Debug > P_Reboot_Test

사용된 변수

없음

사용된 속성

없음

Log

개요

사용자 로그를 지정된 파일에 출력합니다. 스크린샷이나 메시지 박스로 출력할 수도 있습니다.

사용 절차

Message에 표시할 메시지를 입력하세요.
File Path에 로그 파일을 저장할 경로를 입력하세요.
Append에서 로그 내용을 기존 내용에 이어서 추가할지, 또는 현재 로그 내용만 새로 저장할지 선택하세요.

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	Message	문자	N	-	N	파일 또는 메시지 박스에 표시할 메시지를 입력합니다.
N	File Path	문자	Y	-	N	로그 파일을 저장할 경로와 파일을 지정합니다.
N	Append	토글버튼	N	-	Y	사용으로 설정하면 로그 내용을 기존 로그 내용에 이어서 추가하고, 미사용으로 설정하면 현재 로그 내용만 새로 저장합니다. (기본: 기존 로그 내용에 이어서 추가)
Y	MORE OPTIONS	-	-	-	-	FlowControl 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	FlowControl 라이브러리의 공통 속성입니다.

활용 예시

로그를 지정된 파일에 출력합니다.

사용자 정의 스크립트를 입력하고, Notepad 앱을 실행하여 로그 파일을 저장합니다. 이후 Notepad 앱 종료하고, 메시지 박스에 텍스트를 출력합니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Flow Control > Debug > P_Log_Test

사용된 변수

없음

사용된 속성

Message = 'Log Test'
File Path = 'C:\\Log_Test.txt'
Append = False
ScreenShot = True

SetPlayOption

개요

모든 스텝에 항상 적용되는 전역 옵션을 설정합니다.

사용 절차

Option Name에서 설정할 옵션을 선택하세요.
선택한 옵션에 대한 속성이 표시되면 해당 옵션에 대한 설정값을 선택하거나 입력합니다.

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
Y	Option Name	콤보 박스	Y	-	N	설정할 옵션의 이름 목록입니다. 선택시 설정할 옵션에 대한 속성이 추가로 표시됩니다.
N	Step Interval	숫자	Y	ms	N	프로세스가 실행될 때 각 스텝 사이에 설정할 Delay를 millisecond 단위의 시간을 입력합니다.
N	Disable DrawBounds	토글버튼	Y	-	Y	객체나 이미지 탐색 시 탐색된 영역을 표시하는 박스를 표시하지 않도록 설정합니다.
N	Invoke First	토글버튼	Y	-	Y	객체 클릭 시 마우드 이벤트 API 보다 Automation 서비스의 Invoke API를 우선 사용합니다. Invoke 를 사용하면 마우스가 이동하지 않아도 클릭한 것과 같은 효과를 낼 수 있습니다.
N	Allow upload of DumpScreen results	토글버튼	Y	-	Y	옵션을 활성화 하면 봇을 이용하여 Job이 실행하는 경우 실행이 완료된 후 DumpScreen 액티비티로 생성된 이미지를 서버에 업로드합니다. 업로드된 이미지는 포탈의 Job Report 화면에서 결과 화면 기능을 이용하여 확인할 수 있습니다. [주의] 이 기능의 잦은 사용은 봇과 서버의 파일 저장 용량을 빠르게 소모할 수 있어 주의가 필요합니다.
Y	MORE OPTIONS	-	-	-	-	FlowControl 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	FlowControl 라이브러리의 공통 속성입니다.

활용 예시

개별 스텝의 속성에서 Draw Bounds 속성을 사용안함으로 변경하지 않더라도 SetPlayOption 으로 모든 스텝에 대해 Draw Bounds 기능을 끌 수 있습니다. 옵션이 설정된 이 후의 모든 스텝에 적용되므로 일부 구간에만 적용하고자 하는 경우에는 필요한 구간의 시작지점과 끝 지점에 각각 SetPlayOption을 추가하여 옵션을 비활성화하고 재활성화할 수 있습니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Flow Control > Debug > P_SetPlayOption_Test

사용된 변수

없음

사용된 속성

Step Interval (ms) = 1000
Disable DrawBoudns = true
Invoke First = true

Debugger

개요

디버그 콘솔을 실행합니다.
디버그 콘솔 안에서 현재까지 진행된 내용의 변수 상태를 입력하여 확인할 수 있습니다.

사용 절차

Message에 디버그 콘솔 창에 표시할 메시지를 입력하세요.

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	Message	문자	N	-	Y	디버그 콘솔 창에 표시할 메시지를 입력합니다. (기본값: RESULT)
Y	MORE OPTIONS	-	-	-	-	FlowControl 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	FlowControl 라이브러리의 공통 속성입니다.

활용 예시

사용자가 작성한 스크립트를 입력한 후 디버그 콘솔 창에 표시할 메시지를 입력합니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Flow Control > Debug > P_Debugger_Test

사용된 변수

없음

사용된 속성

Message = 'Run the debugger.'

DumpScreen

개요

해당 스텝의 실행 시점의 스크린샷 이미지를 수행 이력 폴더에 저장합니다.

이 기능의 잦은 사용은 봇과 서버의 파일 저장 용량을 빠르게 소모할 수 있어 주의가 필요합니다.

사용 절차

스크린샷 이미지를 저장할 때 간단한 상태 정보를 기록하기 위해 Pass 와 Fail 중 하나를 선택합니다.

Pass or Fail의 선택에 따라 이미지의 파일명은 "날짜_시간 (DumpScreen - PASS).png" 혹은 "날짜_시간 (DumpScreen - FAIL).png" 의 형태로 생성됩니다.

스크린샷 이미지 파일은 실행이력 폴더 아래의 Log\Screenshot 폴더에 저장되며, 스크린샷 이미지를 생성한 스텝에 대한 정보는 Log\dumpscreen.log 파일에 기록됩니다.

실행이력 폴더는 디자이너에서 실행한 경우에는 [프로젝트 폴더]\Histories\[JobID] 의 형태로 생성되며, 봇에서 실행한 경우에는 일반적으로 [내 문서]\Brity RPA BOT Projects\Histories\[JobID] 의 형태로 실행이력 폴더가 생성됩니다.

프로젝트 옵션 Allow upload of DumpScreen results 를 활성화하면 dumpscreen-report.log 에 정보가 기록되며, 봇을 이용하여 Job이 실행되면 실행이 완료된 후 기록된 정보를 바탕으로 DumpScreen 이미지를 결과 이미지로 서버에 업로드합니다.

프로젝트 옵션은 프로젝트창에서 프로젝트 이름을 선택한 후 속성창에서 설정할 수 있으며,

업로드된 이미지는 포탈의 Job Report 화면에서 결과 화면 기능을 이용하여 확인할 수 있습니다.

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	Pass of Fail	버튼	Y	-	Y	덤프 파일을 로컬 경로에 저장할지, 서버로 전송할지 선택합니다. (기본값: Fail) - Pass: 프로젝트 폴더 하위 Histories\Logs 경로에 저장합니다. - Fail: 서버로 전송합니다.
Y	MORE OPTIONS	-	-	-	-	FlowControl 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	FlowControl 라이브러리의 공통 속성입니다.

활용 예시

덤프 파일을 생성하여 지정한 위치에 저장합니다.

사용자가 작성한 스크립트를 입력한 후 Notepad 앱을 실행하여 텍스트를 입력합니다.
프로젝트 폴더 하위 경로에 덤프 파일을 저장하고, Notepad 앱을 종료한 후 메시지 박스에 텍스트를 출력합니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Flow Control > Debug > P_DumpScreen_Test

사용된 변수

없음

사용된 속성

Pass of Fail = Pass

AssertExpression

개요

검사할 스크립트가 true이면 PASS, false이면 예외를 발생시킵니다.

사용 절차

AssertExpression 결과가 True 또는 False가 될 수 있는 스크립트를 입력하세요.

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	Expression	문자열	Y	-	N	검사 대상 스크립트를 입력하세요.
Y	ASSERT	-	-	-	-	Assert Message
Y	MORE OPTIONS	-	-	-	-	FlowControl 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	FlowControl 라이브러리의 공통 속성입니다.

활용 예시

검사할 스크립트를 입력한 후 조건에 맞지 않을 때 출력할 메시지를 입력합니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Flow Control > Assert_Sample > P_AssertExpression

사용된 변수

var1, var2

사용된 속성

Expression : this.var1 == this.var2
Assert Message : 'Assertion is failed : this.var1 == this.var2'

AssertEquals

개요

검사할 변수와 지정된 값이 같으면 PASS, 다르면 예외를 발생시킵니다.

사용 절차

검사 대상 변수와 검사 값을 입력하고 변수 값의 정합성을 확인하세요.

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	Assert Value	Any	Y	-	N	대상을 검사하기 위한 값을 지정합니다.
Y	ASSERT	-	-	-	-	FlowControl 라이브러리의 공통 속성입니다.
Y	MORE OPTIONS	-	-	-	-	FlowControl 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	FlowControl 라이브러리의 공통 속성입니다.

활용 예시

검사할 변수와 값을 입력한 후 조건에 맞지 않을 때 출력할 메시지를 입력합니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Flow Control > Assert_Sample > P_AssertEquals

사용된 변수

var1

사용된 속성

Assert Value : 1
Assert Message : 'Assertion is failed : this.var1 not 1'

AssertNull

개요

검사할 변수가 Null이면 PASS, 다르면 예외를 발생시킵니다.

사용 절차

검사 대상 변수를 입력하고 변수 값의 정합성을 확인하세요.

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
Y	ASSERT	-	-	-	-	FlowControl 라이브러리의 공통 속성입니다.
Y	MORE OPTIONS	-	-	-	-	FlowControl 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	FlowControl 라이브러리의 공통 속성입니다.

활용 예시

검사할 변수를 입력한 후 조건에 맞지 않을 때 출력할 메시지를 입력합니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Flow Control > Assert_Sample > P_AssertNull

사용된 변수

var1

사용된 속성

Assert Message : 'Assertion is failed : this.var1 is not null'

AssertEmpty

개요

검사할 변수가 비어 있으면 PASS, 다르면 예외를 발생시킵니다.

사용 절차

검사 대상 변수를 입력하고 변수 값의 정합성을 확인하세요.

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
Y	ASSERT	-	-	-	-	FlowControl 라이브러리의 공통 속성입니다.
Y	MORE OPTIONS	-	-	-	-	FlowControl 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	FlowControl 라이브러리의 공통 속성입니다.

활용 예시

검사할 변수를 입력한 후 조건에 맞지 않을 때 출력할 메시지를 입력합니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Flow Control > Assert_Sample > P_AssertEmpty

사용된 변수

var1

사용된 속성

Assert Message : 'Assertion is failed : this.var1 is not empty'

AssertContains1D

개요

검사할 1차원 배열 변수에 지정된 값이 존재하면 PASS, 다르면 예외를 발생 시킵니다.

사용 절차

검사 대상 1차원 배열 변수와 검사 값을 입력하고, 검사 값이 1차원 배열에 포함되어 있는지 확인하세요.

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	Assert Value	Array 1D	Y	-	N	1차원 배열에 포함되어 있는 대상을 검사하기 위한 값을 지정합니다.
Y	ASSERT	-	-	-	-	FlowControl 라이브러리의 공통 속성입니다.
Y	MORE OPTIONS	-	-	-	-	FlowControl 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	FlowControl 라이브러리의 공통 속성입니다.

활용 예시

검사할 변수와 값을 입력한 후 조건에 맞지 않을 때 출력할 메시지를 입력합니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Flow Control > Assert_Sample > P_AssertContains1D

사용된 변수

var1

사용된 속성

Assert Value : b
Assert Message : 'Assertion is failed : b is not in the array'

AssertContains2D

개요

검사할 2차원 배열 변수에 지정된 값이 존재하면 PASS, 다르면 예외를 발생 시킵니다.

사용 절차

검사 대상 2차원 배열 변수와 검사 값을 입력하고, 검사 값이 2차원 배열에 포함되어 있는지 확인하세요.

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	Assert Value	Array 2D	Y	-	N	2차원 배열에 포함되어 있는 대상을 검사하기 위한 값을 지정합니다.
Y	ASSERT	-	-	-	-	FlowControl 라이브러리의 공통 속성입니다.
Y	MORE OPTIONS	-	-	-	-	FlowControl 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	FlowControl 라이브러리의 공통 속성입니다.

활용 예시

검사할 변수와 값을 입력한 후 조건에 맞지 않을 때 출력할 메시지를 입력합니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Flow Control > Assert_Sample > P_AssertContains2D

사용된 변수

var1

사용된 속성

Assert Value : c
Assert Message : 'Assertion is failed : c is not in the array'

AssertNumberRange

개요

검사할 변수가 숫자이며 최소, 최대 범위 내에 있으면 PASS, 아니면 예외를 발생 시킵니다.

사용 절차

검사 대상 변수와 최소, 최대값을 입력하고, 변수의 값이 입력된 범위 내에 있는지 확인하세요.

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	Min Value	정수	Y	-	N	검사 벙위의 최소 값을 지정합니다.
N	Max Value	정수	Y	-	N	검사 벙위의 최대 값을 지정합니다.
Y	ASSERT	-	-	-	-	FlowControl 라이브러리의 공통 속성입니다.
Y	MORE OPTIONS	-	-	-	-	FlowControl 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	FlowControl 라이브러리의 공통 속성입니다.

활용 예시

검사할 변수와 최소, 최대값을 입력한 후 조건에 맞지 않을 때 출력할 메시지를 입력합니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Flow Control > Assert_Sample > P_AssertNumberRange

사용된 변수

var1

사용된 속성

Min Value : 0
Max Value : 10
Assert Message : 'Assertion is failed : out of range'

AssertDataType

개요

검사할 변수가 지정된 데이터 타입과 일치하면 PASS, 아니면 예외를 발생 시킵니다.

사용 절차

검사 대상 변수와 변수 타입을 입력하고, 변수의 타입이 입력된 타입과 일치하는지 확인하세요.

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	Assert Type	Select	Y	-	N	검사 대상의 검사 타입을 지정합니다. 검사할 수 있는 타입은 아래와 같습니다. - number : 정수 타입 - string : 문자열 타입 - boolean : Bool 타입 - object : 객체 타입 - undefined : undefined 타입
Y	ASSERT	-	-	-	-	FlowControl 라이브러리의 공통 속성입니다.
Y	MORE OPTIONS	-	-	-	-	FlowControl 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	FlowControl 라이브러리의 공통 속성입니다.

활용 예시

검사할 변수와 검사 타입 입력한 후 조건에 맞지 않을 때 출력할 메시지를 입력합니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Flow Control > Assert_Sample > P_AssertDataType

사용된 변수

var_undefined
var_number : 1
var_string : 'sample'
var_array : [1,2]
var_bool : false

사용된 속성

Assert Message : 'Assertion is failed. : type is different'