Process Flow 전용 라이브러리

개요

개요

ProcessFlow는 여러 프로세스가 처리되는 순서와 흐름을 나타내는 도식입니다. ProcessFlow 라이브러리는 프로세스에서 사용되는 라이브러리와 유사하지만 일부 다른 부분이 있습니다. 본 장에서는 ProcessFlow에서만 사용되는 라이브러리를 설명합니다.

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

ProcessFlow 라이브러리는 배포 후 서버에서 동작하는 라이브러리 입니다. 따라서 디자이너에서 실행 또는 디버깅을 할 수 없습니다.

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

• 디자이너 경로: > 도움말 > 샘플 > Sample > ProcessFlow

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

AddDateTime

AddDateTime

개요

날짜 시간 (yyyy-mm-dd hh:mm:ss) 타입 기준의 정보에 연, 월, 일, 주(Week), 시간, 분, 초 등을 더하여 계산한 결과값을 변수에 할당합니다.

사용 절차

  1. [Output] Variable에 변경된 결과값을 저장할 변수를 입력하세요.

  2. Time Unit에 더할 시간 단위를 선택하세요.

  3. Add에 더할 시간을 입력하세요.

  4. Input에 변경할 기준 시간 정보를 입력하세요.

카드 출력 속성

카드 속성

속성

리턴타입

리턴 추가설명

설명

결과 예시

Variable

string

-

Input을 기준의 정보에 Time Unit의 단위로 Add만큼 더한 결과를 반환합니다.

Input: '2021-01-01 09:00:00'

Time Unit: 'Hours'

Add: 2

> Variable: '2021-01-01 11:00:00'

카드 입력 속성

Array1D_Clone 카드 속성

속성

유형

필수여부

단위

자동입력여부

설명

[CONDITIONS] Time Unit

콤보박스

N

-

Y

더하고자 하는 시간의 단위를 선택합니다.

- Years : 연도

- Months : 월

- Days : 일

- Weeks : 주

- Hours : 시간

- Minutes : 분

- Seconds : 초

[CONDITIONS] Add

숫자

Y

-

N

더할 시간을 숫자로 입력합니다.

[CONDITIONS] Input

문자

Y

-

Y

더할 기준 시간을 입력합니다.

활용 예시

기준 날짜와 시간을 입력하고, 5년을 더한 날짜를 계산합니다.

AddDateTime1

사용된 변수

사용된 속성

특이 사항

Add 값에 마이너스 정수를 입력하면 시간을 뺄 수 있습니다.

연관/유사 액티비티

AssignDateTime

AssignDateTime

개요

날짜를 지정한 변수에 할당합니다.

사용 절차

  1. [Output] Variable에 계산이 완료된 시간 정보를 저장할 변수를 입력하세요.

  2. Time에 기준이 되는 시간 정보를 입력하세요.

  3. To UTC에서 시간을 UTC를 기준으로 변환할지 선택하세요.

  4. Locale에 기준 로캘을 선택하세요.

카드 출력 속성

카드 속성

속성

리턴타입

리턴 추가설명

설명

결과 예시

Variable

string

-

계산이 완료된 시간 정보를 반환합니다.

Variable: '2021-01-01 09:00:00'

카드 속성

Array1D_Clone 카드 속성

속성

유형

필수여부

단위

자동입력여부

설명

[Output] Variable

변수

Y

-

N

계산이 완료된 시간 정보를 저장할 변수를 입력합니다.

[CONDITIONS] Time

문자

N

-

Y

날짜 시간 정보를 입력합니다.

'yyyy-mm-dd hh:mm:ss'

[CONDITIONS] To UTC

토글버튼

N

-

N

UTC 변환 여부를 설정합니다.

[CONDITIONS] Locale

콤보박스

N

-

Y

UTC 기준을 선택합니다.

활용 예시

기준 시간을 UTC+0:00로 가정하여 '(UTC+8:00) 타이베이'로 변환합니다.

AddDateTime1

사용된 변수

사용된 속성

연관/유사 액티비티

CallProcess

CallProcess

개요

서버에 배포되어 있는 프로세스를 호출하여 수행합니다.

사용 절차

수행할 프로세스가 서버에 배포되어 있어야 하며, 서버에 배포된 해당 프로세스가 프로세스 플로우 하위의 '원격 프로세스'에 추가되어 있어야 합니다.

  1. [Output] Result에 수행한 결과값을 저장할 변수를 입력하세요.

  2. ProcessID에서 수행할 프로세스 ID를 선택하세요.

카드 속성

Array1D_Clone 카드 속성

속성

유형

필수여부

단위

자동입력여부

설명

[Output] Result

변수

Y

-

N

수행 결과 정보가 할당될 변수를 지정합니다.

[Input] ExecutionBot

변수

N

-

N

이전에 수행된 프로세스와 동일한 봇에서 프로세스를 수행시키고자 하는 경우에만 사용합니다.

이전에 수행되었던 프로세스의 결과 변수(Result)를 입력합니다.

[CONDITIONS] ProcessId

콤보박스

Y

-

N

콤보박스에서 수행할 프로세스 ID를 선택합니다.

콤보박스에 프로세스 플로우 하위에 있는 프로세스들이 나타납니다.

활용 예시

프로세스 플로우 하위에 있는 프로세스 중 'BaseProcess'를 호출하여 수행합니다.

CallProcess1

사용된 변수

사용된 속성

특이 사항

CallProcess 액티비티 카드 속성에서 프로세스를 지정하면 플로우 차트에서 보이는 카드명이 'CallProcess'에서 '(프로세스ID)'로 변경됩니다.

CallRestAPI

CallRestAPI

개요

REST API를 호출합니다.

사용 절차

  1. [Output] Response에 호출 결과를 저장할 변수를 입력하세요.

  2. CONDITIONS 그룹 속성에 정의된 규약에 따라 API 호출 정보(호출 방식, 호출 내용 유형, 호출 주소, API key, Proxy URL, Proxy Port, 헤더, 바디)를 설정하세요. 실행 후 상대측에서 반환된 결과로 후속 처리를 합니다.

카드 속성

Array1D_Clone 카드 속성

속성

유형

필수여부

단위

자동입력여부

설명

[Output] Response

변수

N

-

N

메시지 응답 결과를 저장할 변수를 입력합니다.

[CONDITIONS] Method

콤보박스

N

-

Y

HTTP 메소드를 호출할 방식(RESTful Service)을 선택합니다.

- GET : Read

- POST : Create

[CONDITIONS] ContentType

콤보박스

N

-

Y

호출할 내용 유형을 선택합니다.

- Text

- text/plain

- application/json

- application/xml

- multipart/form-data

[CONDITIONS] URL

문자

Y

-

N

호출할 URL 주소를 입력합니다.

[CONDITIONS] Authorization

문자

N

-

N

API Key를 입력합니다.

[CONDITIONS] ProxyURL

문자

N

-

N

Proxy URL을 입력합니다.

[CONDITIONS] ProxyPort

문자

N

-

N

Proxy Port를 입력합니다.

[CONDITIONS] Headers

문자

N

-

Y

헤더 정보를 입력합니다.

[CONDITIONS] Body

문자

N

-

N

바디 정보를 입력합니다.

활용 예시

REST API를 호출하고 메일을 보냅니다.

AddDateTime1

예제 파일

사용된 변수

사용된 속성

특이 사항

'IV.라이브러리 상세 - 3. Net라이브러리'의 SendRequest 액티비티 카드와 동일한 기능을 수행합니다. 다만, SendRequest 액티비티 카드는 일반 프로세스에서 사용되어 봇이 수행하고, CallRestAPI 액티비티 카드는 프로세스 플로우 전용으로 서버에서 수행합니다.

연관/유사 액티비티

RequestAsset

RequestAsset

개요

서버에서 가지고 온 공용 리소스를 변수에 할당합니다.

사용 절차

서버에 로그인하여 공용 리소스를 먼저 불러와야 합니다.

  1. [Output] Variable에 가져온 공용 리소스를 저장할 변수를 입력하세요.

  2. Asset에 불러올 공용 리소를 선택하세요.

카드 속성

Array1D_Clone 카드 속성

속성

유형

필수여부

단위

자동입력여부

설명

[Output] Variable

변수

Y

-

N

서버에서 가져온 공용 리소스를 저장할 변수를 입력합니다.

Asset

콤보박스

Y

-

N

불러올 공용 리소스를 선택합니다.

콤보박스에 서버에서 불러온 공용 리소스 항목이 표시됩니다.

활용 예시

서버에서 가지고 온 공용 리소스를 변수에 할당합니다.

AddDateTime1

사용된 변수

사용된 속성

특이 사항

WaitForMultipleEvents 액티비티 카드와 함께 사용하지 않고 단독으로 사용합니다.

WaitForMultipleEvents

WaitForMultipleEvents

상세 내용은 WaitForMultipleEvents를 참고하십시요.

WaitEmail

WaitEmail

개요

특정 이메일의 수신을 대기합니다. 특정 이메일의 수신을 기다리는 이벤트를 설정하도록 Orchestrator 서버에 요청합니다.

사용 절차

  1. [Output] Variable에 대기할 이벤트를 저장하기 위한 변수를 지정하세요.

  2. Protocol에 해당 이메일 서버의 프로토콜을 선택하세요.

  3. Server URL에 해당 이메일이 있는 서버 URL을 작은따옴표 안에 입력하세요.

  4. Receiver PW에 이메일을 받는 계정의 비밀번호를 입력하세요.

  5. Use SSL에서 SSL 사용 여부를 선택하세요.

  6. To UTC에서 UTC 사용 여부를 선택하세요.

  7. Locale에서 해당 locale을 선택하세요.

  8. Receiver에 이메일을 받는 사람 ID(메일 주소)를 입력하세요.

  9. Sender에 이메일을 보낸 사람 ID(메일 주소)를 입력하세요.

  10. Subject에 가져올 이메일의 제목을 작은따옴표 안에 입력하세요.

  11. Begin Time에 이메일 가져오기를 시작할 시간을 입력하세요.

  12. End Time에 이메일 가져오기를 종료할 시간을 입력하세요.

카드 속성

카드 속성

공통여부

속성

유형

필수여부

단위

자동입력여부

설명

N

[Output] Result

변수

N

-

N

대기할 이벤트(이메일 수신)를 저장하기 위한 변수를 지정합니다.(기본값: RESULT)

지정한 변수는 WaitForMultipleEvents 액티비티 카드 속성의 WaitEvents에 입력하여 지정한 이메일 수신을 대기할 수 있습니다.

N

Protocol

콤보박스

Y

-

Y

이메일 서버의 프로토콜을 선택합니다.

(ex. POP3, IMAP)

N

Port

숫자

Y

-

Y

해당 이메일 서버의 포트를 입력합니다.

N

Server URL

문자

Y

-

Y

해당 이메일이 있는 서버 URL을 작은따옴표 안에 입력합니다.

N

Receiver PW

기타

Y

-

N

메일을 받는 계정의 비밀번호를 입력합니다.

Asset을 선택하는 경우 비밀번호가 저장된 Asset 변수를 입력하고, Input을 선택하는 경우 계정의 비밀번호를 직접 입력합니다.

N

Use SSL

토글버튼

Y

-

Y

SSL 사용 여부를 설정합니다. (대상 메일 서비스에서 제공한 정보)

N

To UTC

토글버튼

Y

-

Y

시간을 UTC 기준으로 변환할지 지정합니다.

True일 경우,

BeginTime, EndTime 에 입력된 시간값을 locale에서 설정한 곳을 기준으로 하는 값으로 간주하여 UTC 시간으로 변환합니다.

N

Locale

콤보박스

Y

-

Y

기준 시간으로 사용할 로캘(Locale)을 선택합니다.

Y

MAIL

-

-

-

-

Orchestrator 라이브러리의 공통 속성입니다.

활용 예시

특정 이메일이 수신되기를 지정 시간 동안 기다리고, 수신되었으면 메일 내용들을 메시지 박스로 출력합니다.

Excel_NewExcel_1K

사용된 변수

사용된 속성

특이 사항

설정한 이벤트를 기다리는 것은 WaitForMultipleEvents 액티비티 카드를 사용합니다.

연관/유사 액티비티

WaitForMultipleEvents, WaitHttp

SendMail

SendMail

개요

지정된 설정으로 메일을 보냅니다.

사용 절차

대상 메일 서비스가 SMTP를 제공해야 합니다.

  1. 속성에 수신자, 참조자, 비밀 참조자, 메일 제목 및 본문 등을 설정하세요.

카드 속성

카드 속성

공통여부

속성

유형

필수여부

단위

자동입력여부

설명

N

[Output] Variable

변수

N

-

N

메일 발신 결과를 저장하기 위한 변수를 지정합니다.

N

Receiver

문자

Y

-

N

이메일 수신자 메일 주소를 입력합니다.

N

CCs

문자

N

-

N

이메일 참조자 메일 주소를 입력합니다.

';'를 사용하여 여러 명을 지정할 수 있습니다.

N

BCCs

문자

N

-

N

이메일 비밀 참조자 메일 주소를 입력합니다.

';'를 사용하여 여러 명을 지정할 수 있습니다.

N

Subject

문자

Y

-

Y

메일 제목을 입력합니다.

N

Body

문자

Y

-

N

메일 본문을 입력 합니다.

N

IsHtml

True/False

Y

-

Y

메일 본문이 HTML 형식인지 지정합니다.

활용 예시

ReceiveMail로 수신한 메일을 지정된 수신인에게 메일로 그대로 전달한다.

Excel_NewExcel_1K

사용된 변수

사용된 속성

연관/유사 액티비티

WaitEmail ReceiveMail

ReceiveMail

ReceiveMail

개요

메일 내용을 받아서 지정한 변수에 저장합니다.

사용 절차

대상 메일 서비스가 POP3 또는 IMAP를 제공해야 합니다.

  1. 속성에 프로토콜(POP3/IMAP), 수신자 메일 서비스 ID/비밀번호, 메일 항목 등을 설정하세요.

카드 속성

카드 속성

속성

유형

필수여부

단위

자동입력여부

설명

[Output] Variable

변수

Y

-

N

이메일을 저장하기 위한 변수를 지정합니다.

Protocol

콤보박스

Y

-

Y

이메일 서버의 프로토콜을 선택합니다.

(ex. POP3, IMAP)

Port

숫자

Y

-

Y

이메일 서버의 포트를 입력합니다.

Server URL

문자

Y

-

Y

해당 이메일이 있는 서버 URL을 작은따옴표 안에 입력합니다.

Receiver

기타

Y

-

N

이메일을 받는 사람 ID(메일 주소)를 입력하세요.

Mail Item

토글버튼

Y

-

Y

WaitEmail 을 통해서 조회된 메일 목록 중에서 받아올 메일 항목을 입력합니다.

Receiver PW

기타

Y

-

N

메일을 받는 계정의 비밀번호를 입력합니다.

Asset을 선택하는 경우 비밀번호가 저장된 Asset 변수를 입력하고, Input을 선택하는 경우 계정의 비밀번호를 직접 입력합니다.

Use SSL

토글버튼

Y

-

Y

SSL 사용 여부를 설정합니다. (대상 메일 서비스에서 제공한 정보)

IgnoreHtml

True/False

Y

-

Y

본문 내용 중에서 html 태그 부분은 제외할지 여부를 지정합니다.

활용 예시

WaitMail로 메일을 대기 이벤트를 등록하여 WaitForMultipleEvent로 대기하다가 조건에 맞는 메일을 수신하면 WaitMail의 결과값 mailEvent의 첫번째 메일에 대해 ReceiveMail 로 수신 요청하고 WaitForMultipleEvent 를 이용하여 수신된 메일 정보를 result_email.result 에 저장합니다.

Excel_NewExcel_1K

사용된 변수

사용된 속성

연관/유사 액티비티

WaitEmail SendMail

QueueOpenChannel

QueueOpenChannel

상세 내용은 9. QueueOpenChannel 를 참고하십시요.

QueueCloseChannel

QueueCloseChannel

상세 내용은 10. QueueCloseChannel를 참고하십시요.

QueueSendData

QueueSendData

상세 내용은 11. QueueSendData를 참고하십시요.

QueueReceiveData

QueueReceiveData

상세 내용은 12. QueueReceiveData를 참고하십시요.

QueueGetDataCount

QueueGetDataCount

상세 내용은 13. QueueGetDataCount를 참고하십시요.

QueueClearData

QueueClearData

상세 내용은 14. QueueClearData를 참고하십시요.

MakeAccessLink

개요

서버에 큐 데이터 또는 리소스로 업로도 된 파일을 다운로드 받을 수 있는 URL 을 생성합니다.

사용 절차

  1. [Output] Variable에 생성된 URL 을 저장할 변수를 입력하세요.

  2. Download Type에 파일을 다운로드 받을 대상 타입을 선택하세요.

  3. Message ID에 파일의 메시지 ID 를 입력하세요.

  4. Max Download Count에 다운로드 가능 횟수를 입력하세요.

  5. RetentionPeriod에 다운로드 유효기간을 입력하세요.

카드 속성

Array1D_Clone 카드 속성

속성

유형

필수여부

단위

자동입력여부

설명

[Output] URL

변수

Y

-

Y

파일 다운로드 URL 을 저장할 변수를 입력합니다.

Download Type

콤보박스

Y

-

Y

파일을 다운로드 받을 대상 타입을 지정합니다.

Message ID

문자

Y

-

Y

파일의 메시지 ID 를 입력합니다.

Max Download Count

숫자

Y

-

Y

다운로드 가능 횟수를 입력합니다.

RetentionPeriod

문자

Y

-

Y

다운로드 유효기간을 입력합니다.

[CONDITIONS] To UTC

토글버튼

N

-

N

UTC 변환 여부를 설정합니다.

[CONDITIONS] Locale

콤보박스

N

-

Y

UTC 기준을 선택합니다.

활용 예시

받은 메일 내 첨부 파일을 큐에 전송하고 파일의 메시지 ID 를 통해 해당 파일을 다운로드 받을 수 있는 URL 을 생성합니다. 이 URL 은 새로운 메일 발송 시 본문에 포함하여 수신인이 링크를 통해 파일을 다운로드 받을 수 있도록 합니다.

AddDateTime1

사용된 변수

사용된 속성

SendSMS

SendSMS

개요

지정한 번호로 SMS를 발송합니다.

로그인 중인 Orchestra 서버가 SMS 서비스를 제공해야 사용이 가능 합니다.

사용 절차

  1. [Output] Variable에 전송 결과를 저장할 변수를 입력합니다.

  2. Telephone에 대상 전화번호를 입력합니다.

  3. Message에 송신할 메시지를 입력합니다.

카드 속성

Array1D_Clone 카드 속성

속성

유형

필수여부

단위

자동입력여부

설명

[Output] Variable

변수

Y

-

Y

전송 결과를 저장할 변수를 입력합니다.

Telephone

문자

Y

-

Y

국가 번호를 포함하여 - 없이 전화번호를 입력합니다.

';'를 사용하여 최대 200명에게 동시에 보낼 수 있습니다.

Message

문자

Y

-

Y

송신할 메시지를 입력합니다.(최대 80자)

활용 예시

지정한 전화 번호로 2명에게 SMS를 전송합니다.

AddDateTime1

사용된 변수

사용된 속성

SendKakaoTalk

SendKakaoTalk

개요

지정한 번호로 KaKaoTalk 메시지를 발송합니다.

로그인 중인 Orchestra 서버가 KaKaoTalk 서비스를 제공해야 사용이 가능 합니다.

사용 절차

  1. [Output] Variable에 전송 결과를 저장할 변수를 입력합니다.

  2. Telephone에 대상 전화번호를 입력합니다.

  3. Message에 송신할 메시지를 입력합니다.

카드 속성

Array1D_Clone 카드 속성

속성

유형

필수여부

단위

자동입력여부

설명

[Output] Variable

변수

Y

-

Y

전송 결과를 저장할 변수를 입력합니다.

Telephone

문자

Y

-

Y

국가 번호를 포함하여 - 없이 전화번호를 입력합니다.

1명 이상 동시 발송할 수 없습니다.

Message

문자

Y

-

Y

송신할 메시지를 입력합니다.(최대 1000자)

활용 예시

지정한 전화 번호로 KakaoTalk 메세지를 전송합니다.

AddDateTime1

사용된 변수

사용된 속성

SendKnoxMessage

SendKnoxMessage

개요

Konx 메신저로 메시지를 전달합니다. Knox Portal 라이브러리의 SendKnoxMessage 와는 달리 응답을 기다릴 수 없으며 발신 전용으로만 사용 가능합니다.

로그인 중인 Orchestra 서버가 Knox Portal Message 서비스를 제공해야 사용이 가능 합니다.

사용 절차

  1. [Output] Response에서 메시지 수신인의 응답 메시지를 저장할 변수를 입력하세요.

  2. Receiver ID에 수신인 Knox ID를 입력하세요.

  3. Message에 상대방에게 보낼 메시지 내용을 입력하세요.

카드 속성

SendKnoxMessage 카드 속성

공통여부

속성

유형

필수여부

단위

자동입력여부

설명

N

[Output] Variable

변수

Y

-

Y

전송 결과를 저장할 변수를 입력합니다.

N

Message Type

콤보박스

Y

-

Y

메시지 수신인의 응답 대기 유형을 표시합니다. Knox Portal 라이브러리의 SendKnxoMessage와 달리 발신 전용으로만 사용 가능하여 No Wait 타입만 표시됩니다.

N

Receiver ID

문자

Y

-

N

수신인의 Knox ID를 입력합니다.

N

Message

문자

Y

-

N

보낼 메시지 문자열을 입력합니다.

활용 예시

Knox Portal에서 지정한 사용자에게 메시지를 보내고 응답을 받습니다.

SendKnoxMessage 활용 예시

사용된 변수

사용된 속성

MessageBox

MessageBox

개요

화면에 메시지 박스를 표시합니다.

웹 디자이너에서만 사용할 수 있습니다.

사용 절차

  1. Arguments에 메시지 박스에 표시할 값을 입력하세요.

카드 속성

카드 속성

공통여부

속성

유형

필수여부

단위

자동입력여부

설명

N

Arguments

문자

N

-

N

메시지 박스에 표시할 값을 입력합니다.

활용 예시

Queue를 통해서 전달받은 데이트를 확인합니다.

SendKnoxMessage 활용 예시

사용된 변수

사용된 속성

특이 사항

MessageBox로 출력하는 값은 웹디자이너에서 테스트 실행모드에서만 동작합니다. 시나리오 작성 시 디버깅을 위해 사용할 수 있습니다.