개요

Orchestrator 라이브러리에서 제공하는 기능을 이용해 프로세스의 흐름을 제어할 수 있습니다.
조건에 따라 다른 작업을 설정할 수 있습니다.

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

프로세스 컨트롤: WaitForMultipleEvent, WaitEmail, WaitHttp, WakeUp, QueueOpenChannel, QueueCloseChannel, QueueSendData, QueueReceiveData, QueueClearData, HttpRequest
기타: UploadResource, DownloadResource

CallProcess, WaitEmail, WaitHttp는 Orchestrator 서버에 이벤트를 요청하는 기능으로 프로젝트를 배포한 후 봇을 이용하여 프로세스를 실행하는 경우에 동작하는 라이브러리입니다.

디자이너에서 실행하는 경우에는 실제 서버를 사용하지 않고 Simulation Result 값이 사용됩니다.

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

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

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

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

• OrchestratorLibrarySample: WaitEmail, WaitForMultipleEvent, WaitHttp, WakeUp, QueueOpenChannel, QueueCloseChannel, QueueSendData, QueueReceiveData, QueueClearData

공통 속성

MAIL

이메일 수신 대기와 관련된 정보를 설정합니다.

카드 속성
속성	유형	필수여부	단위	자동입력여부	설명
Check Mail	콤보박스	N	-	Y	이메일을 검사하는 방법을 선택합니다. - Contains : 검색어를 포함하는 메일 - EndsWith : 검색어로 끝나는 메일 - StartWith : 검색어로 시작하는 메일 - Equals : 검색어와 일치하는 메일 - RegExp :정규식을 이용
Receiver	문자	Y	-	Y	이메일을 받는 사람의 메일 주소를 입력합니다.
Sender	문자	Y	-	Y	이메일을 보낸 사람의 메일 주소를 입력합니다.
Subject	문자	Y	-	Y	가져올 이메일의 제목을 작은따옴표 안에 입력합니다.
Begin Time	문자	Y	YYYY-MM-DD HH:MM:SS	Y	이메일 가져오기를 시작할 시간을 입력합니다.
End Time	문자	Y	YYYY-MM-DD HH:MM:SS	Y	이메일 가져오기를 종료할 시간을 입력합니다.

SIMULATION RESULT

이벤트 시뮬레이션과 관련된 값을 설정할 수 있습니다.

카드 속성
속성	유형	필수여부	단위	자동입력여부	설명
Status	콤보박스	N	-	Y	시뮬레이션 수행 결과를 반환하는 'status' 값으로 사용할 값을 선택합니다. - SUCCESS: 성공 상태 - FAIL: 실패 상태 - SUSPENDED: 사용자에 의한 JOB 강제 중지 상태
Error	문자	N	-	N	시뮬레이션 수행 결과를 반환하는 'error' 값으로 사용할 값을 입력합니다.
ExpireTime(Sec)	숫자	N	초	Y	시뮬레이션할 이벤트를 발생시키는 시간을 초 단위로 입력합니다.
Result	스크립트	N	-	Y	시뮬레이션 수행 결과를 반환하는 'result' 값으로 사용할 값을 {} 안에 입력합니다.

REST

REST API와 관련된 값을 설정합니다.

카드 속성
속성	유형	필수여부	단위	자동입력여부	설명
Method	콤보박스	N	-	Y	HTTP 메소드를 호출할 방식(RESTful Service)을 선택합니다. ※ HTTP 메소드 호출 방식 - GET : Read - POST : Create - PUT : Update/Replace - DEL : Delete
ContextType	콤보박스	N	-	Y	REST API를 호출할 내용 유형을 선택합니다. ※ 호출할 내용 유형 - Text - text/plain - application/json - application/xml - multipart/form-data
URL	문자	Y	-	N	REST API를 호출할 주소를 입력합니다.
Authorization	문자	N	-	N	API Key를 입력합니다.
Headers	스크립트	N	-	Y	Header 정보를 입력합니다.
Body	스크립트	N	-	N	Body 정보를 입력합니다.

MORE OPTIONS

카드 속성
속성	유형	필수여부	단위	자동입력여부	설명
Timeout(Min)	숫자	N	분	N	지정한 내용에 따른 대기 시간을 입력합니다.
DataExpirationTime	숫자	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이 없는 경우에는 대푯값이 해당 액티비티 설명에 표시됩니다.

WaitForMultipleEvents

개요

지정한 다수의 이벤트가 끝날때까지 대기합니다.

사용 절차

Email이나 Http와 같은 이벤트들이 지정되어 있어야 합니다.

[Output] Result에 지정한 이벤트들의 결과를 저장하기 위한 변수를 지정하세요.
Wait All에서 이벤트 대기 방법을 선택하세요.
Wait For에 대기할 이벤트(이벤트의 수행 결과가 저장되는 변수)를 선택하세요.

카드 출력 속성

카드 속성
속성	리턴타입	리턴 추가설명	설명	결과 예시
Result	1차원배열 (List<class>)	class 내 변수 타입 eventId : string status : string result : JToken eventType : string error : object	지정한 이벤트의 결과에 대한 정보를 반환합니다.	[ { 'eventId' : '...', 'status': 'SUCCESS', 'result' : { 'exam1': 'val1', 'exam2': 'val2' }, 'eventType': 'mail', 'error': 'This is error message' }, ... ]

카드 입력 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	[Output] Result	변수	N	-	Y	지정한 이벤트의 결괏값을 저장할 변수를 지정합니다.(기본값: RESULT) 이벤트들의 결과는 배열로 구분되어 저장합니다.
N	Wait All	토글버튼	N	-	Y	모든 이벤트가 다 발생할 때까지 대기할지(On), 또는 하나의 이벤트라도 발생할 때까지 대기할지(Off) 선택합니다. 예를 들어 5개의 프로세스 수행 대기 시 False(Off)로 설정하면 5개 중 하나의 프로세스가 완료되면 다음으로 진행합니다.
N	Wait For	기타	N	-	Y	대기할 이벤트(이벤트의 수행 결과가 저장되는 변수)를 선택합니다. Click here to add new item을 클릭해 대기할 이벤트를 추가할 수 있습니다. 삭제하려면 를 클릭합니다.
Y	MORE OPTIONS	-	-	-	-	Orchestrator 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	Orchestrator 라이브러리의 공통 속성입니다.

활용 예시

이메일과 HTTP가 수신되기를 기다리고 그 결괏값을 메시지 박스로 출력합니다.
동시에 여러 작업 조건에 맞는 이벤트가 완료될 때까지 대기시킬때 사용합니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Orchestra > OrchestratorSamples > WaitForMultipleEventTest

사용된 변수

email = 특정 이메일을 가져온 후 대기할 이벤트를 저장할 변수
http = 특정 http를 가져온 후 대기할 이벤트를 저장할 변수

사용된 속성

Wait For Process = this.email
Wait For Process = this.http

연관/유사 액티비티

WaitEmail, WaitHttp

WaitEmail

개요

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

사용 절차

[Output] Result에 대기할 이벤트를 저장하기 위한 변수를 지정하세요.
Server URL에 해당 이메일이 있는 서버 URL을 작은따옴표 안에 입력하세요.
Receiver Password에 이메일을 받는 계정의 비밀번호를 입력하세요.
Receiver에 이메일을 받는 사람 ID(메일 주소)를 입력하세요.
Sender에 이메일을 보낸 사람 ID(메일 주소)를 입력하세요.
Subject에 가져올 이메일의 제목을 작은따옴표 안에 입력하세요.
Begin Time에 이메일 가져오기를 시작할 시간을 입력하세요.
End Time에 이메일 가져오기를 종료할 시간을 입력하세요.
SIMULATION RESULT 그룹 속성에 필요한 조건들을 선택하세요.

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	[Output] Result	변수	N	-	Y	대기할 이벤트(이메일 수신)를 저장하기 위한 변수를 지정합니다.(기본값: RESULT) 지정한 변수는 WaitForMultipleEvents 액티비티 카드 속성의 Wait For에 입력하여 지정한 이메일 수신을 대기할 수 있습니다.
N	Server URL	문자	Y	-	Y	해당 이메일이 있는 서버 URL을 작은따옴표 안에 입력합니다.
N	Protocol	콤보박스	Y	-	Y	이메일 서버의 프로토콜을 선택합니다.
N	Port	숫자	Y	-	Y	메일 서버 포트를 입력합니다.
N	Receiver Password	기타	Y	-	N	메일을 받는 계정의 비밀번호를 입력합니다. - Normal: 입력한 비밀번호가 일반 텍스트로 저장됩니다. - Credential : 입력할 비밀번호로 Credential 유형의 공용리소스를 사용합니다. - Secure: 입력한 비밀번호가 암호화되어 저장됩니다.
N	Locale	콤보박스	N	-	Y	기준 시간으로 사용할 로캘(Locale)을 선택합니다.
Y	MAIL	-	-	-	-	Orchestrator 라이브러리의 공통 속성입니다.
Y	SIMULATION RESULT	-	-	-	-	Orchestrator 라이브러리의 공통 속성입니다.
Y	MORE OPTIONS	-	-	-	-	Orchestrator 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	Orchestrator 라이브러리의 공통 속성입니다.

활용 예시

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

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Orchestra > OrchestratorSamples > WaitEmailTest

사용된 변수

ev1 = 대기할 이벤트를 저장할 변수

사용된 속성

[Output] Result = this.ev1
Server URL = xxx.xxx.xxx.xxx
Protocol = POP3
Port = 110
Receiver Password = xxxxxxx (input)
[MAIL] Receiver = 'sample@samsung.com'
[MAIL] Sender = 'sample@samsung.com'
[MAIL] Subject = 'sample title'
[MAIL] Begin Time = '2019-05-29 00:00:00'
[MAIL] End Time = '2019-06-29 00:00:00'

특이 사항

설정한 이벤트를 기다리는 것은 WaitForMultipleEvents 액티비티 카드를 사용합니다. 디자이너에서 실행하는 경우에는 실제 서버를 사용하지 않고 Simulation Result 값이 사용됩니다.

연관/유사 액티비티

WaitForMultipleEvents, WaitHttp

WaitHttp

개요

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

사용 절차

[Output] Result에 대기할 이벤트를 저장하기 위한 변수를 지정합니다.
SIMULATION RESULT 그룹 속성에 필요한 조건들을 선택하세요.

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	[Output] Result	변수	Y	-	Y	대기할 이벤트(Http 수신)를 저장하기 위한 변수를 지정합니다.(기본값: RESULT) 지정한 변수는 WaitForMultipleEvents 액티비티 카드 속성의 Wait For에 입력하여 지정한 이메일 수신을 대기할 수 있습니다.
Y	SIMULATION RESULT	-	-	-	-	Orchestrator 라이브러리의 공통 속성입니다.
Y	MORE OPTIONS	-	-	-	-	Orchestrator 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	Orchestrator 라이브러리의 공통 속성입니다.

활용 예시

특정 Http가 수신되기를 지정 시간 동안 기다리고, 수신되었으면 수신 결과를 메시지 박스로 출력합니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Orchestra > OrchestratorSamples > WaitHttpTest

사용된 변수

http = 대기할 이벤트를 저장할 변수

사용된 속성

[Output] Result = this.http
[SIMULATION RESULT] ExpireTime(Sec) = 15

특이 사항

설정한 이벤트를 기다리는 것은 WaitForMultipleEvents 액티비티 카드를 사용합니다. 디자이너에서 실행하는 경우에는 실제 서버를 사용하지 않고 Simulation Result 값이 사용됩니다.

연관/유사 액티비티

WaitForMultipleEvents, WaitEmail

WakeUp

개요

지정한 시간에 트리거를 발생시킵니다.

사용 절차

[Output] Result에 지정된 시간에 트리거를 발생시키기 위한 변수를 지정하세요.
Time에 트리거 발생 일시를 입력하세요.
Locale에 기준 시간으로 사용할 로캘을 선택하세요..
SIMULATION RESULT 그룹 속성에 필요한 조건들을 선택하세요.

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	[Output] Result	변수	N	-	Y	지정된 시간에 트리거를 발생시키기 위한 변수를 지정합니다.(기본값: RESULT) 지정한 변수는 WaitForMultipleEvents 액티비티 카드 속성의 Wait For에 입력하여 지정한 이메일 수신을 대기할 수 있습니다.
N	Time	문자	Y	-	Y	트리거 발생 일시를 입력합니다.
N	Locale	콤보박스	N	-	Y	기준 시간으로 사용할 로캘을 선택합니다.
Y	MORE OPTIONS	-	-	-	-	Orchestrator 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	Orchestrator 라이브러리의 공통 속성입니다.

활용 예시

특정 시간에 트리거를 발생시키고 그 결과를 메시지 박스로 출력합니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Orchestra > OrchestratorSamples > WakeUpTest

사용된 변수

wakeUpEvent = 대기할 이벤트를 저장할 변수
wakeUpTime = 이벤트를 발생시킬 일시를 저장한 변수

사용된 속성

[Output] Result = this.wakeUpEvent
Time = this.wakeUpTime

특이 사항

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

연관/유사 액티비티

WaitForMultipleEvents

UploadResource

개요

서버에 리소스(파일)를 업로드합니다.

사용 절차

[Output] Output에 서버에 등록된 리소스 ID를 저장할 변수를 지정하세요.
ID에 서버에 업로드할 리소스 ID를 입력하세요.
RetentionPeriod에 서버에서 파일을 보관할 기간을 입력하세요.
FilePath에 서버에 업로드할 파일이 있는 경로와 파일명을 입력하세요.

카드 출력 속성

카드 속성
속성	리턴타입	리턴 추가설명	설명	결과 예시
Output	string	-	서버에 등록된 ID를 반환합니다. ※ID를 설정하면 동일한 ID를 반환하고, 아닐 경우 서버에서 만든 ID를 반환합니다.	'TestUploadResource'

카드 입력 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	ID	문자	Y	-	N	지정한 ID 값으로 저장이 됩니다. (덮어쓰기) 입력하지 않으면 자동으로 생성됩니다.
N	RetentionPeriod	문자	Y	-	Y	서버에서 파일을 보관할 기간을 입력합니다.
N	FilePath	문자	Y	-	N	서버에 업로드 할 파일 경로를 작은따옴표 안에 입력합니다.
Y	MORE OPTIONS	-	-	-	-	Orchestrator 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	Orchestrator 라이브러리의 공통 속성입니다.

활용 예시

서버에 특정 리소스 파일(suji.gif)을 업로드합니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Orchestra > Transmit Resource > P_UploadResource_Test

사용된 변수

tonight = 리소스를 서버에 보관할 기간을 저장한 변수

사용된 속성

[RESOURCE] ID = 'TestUploadResource'
RetentionPeriod = this.tonight
FilePath = 'C:\\IPA_Test_UploadResource\\suji.gif'

특이 사항

서버에 업로드된 리소스(파일)는 리소스 ID가 반환되며, 이 ID로 다시 리소스(파일)를 업데이트하거나 다운로드할 수 있습니다. 리소스 ID는 자동으로 생성되거나, 사용자가 입력할 수 있습니다. 리소스(파일)은 보관 기한이 있고, 보관 기한이 지나면 서버에서 다운로드할 수 없습니다.

연관/유사 액티비티

DownloadResource

개요

서버에서 리소스(파일)를 다운로드합니다.

사용 절차

[Output] FilePath에 다운로드한 리소스 경로를 할당할 변수를 지정하세요.
ID에 서버에서 다운로드할 파일의 ID를 입력하세요.

카드 출력 속성

카드 속성
속성	리턴타입	리턴 추가설명	설명	결과 예시
Output	string	-	다운로드된 파일의 경로가 반환됩니다.	'C:\IPA_Test_UploadResource\suji.gif'

카드 입력 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	[Output] FilePath	변수	Y	-	Y	다운로드된 파일의 경로를 저장할 변수를 입력합니다.
N	ID	문자	Y	-	N	다운로드할 리소스(파일)의 ID를 입력합니다.
Y	MORE OPTIONS	-	-	-	-	Orchestrator 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	Orchestrator 라이브러리의 공통 속성입니다.

활용 예시

서버에서 'TestUploadResource' ID를 가진 리소스 파일을 다운로드합니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Orchestra > Transmit Resource > P_DownloadResource_Test

사용된 변수

없음

사용된 속성

[RESOURCE] ID = 'TestUploadResource'

특이 사항

ID 속성에 다운로드할 리소스의 리소스 ID가 입력되어야 해당 리소스를 다운로드할 수 있습니다. 다운로드된 리소스(파일)는 프로젝트 폴더 내 SharedResources 폴더에 저장되고, 다운로드에 성공한 경우 파일 경로가 반환됩니다.

연관/유사 액티비티

UploadResource

QueueOpenChannel

개요

큐를 사용하기 위해 지정한 큐를 엽니다.

사용 절차

큐를 생성하는 작업은 포털에서 진행해야 합니다. 큐를 사용하기 위해서는 로그인이 되어 있어야 합니다.

[Output] Output에 열린 큐의 연결 정보를 저장할 변수를 지정하세요.
ChannelName에 사용할 큐 이름을 선택하세요.

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	[Output] Output	변수	Y	-	Y	열린 큐의 연결 정보를 저장할 변수를 입력합니다.
N	ChannelName	콤보박스	Y	-	Y	사용할 큐 이름을 선택합니다.
Y	MORE OPTIONS	-	-	-	-	Orchestrator 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	Orchestrator 라이브러리의 공통 속성입니다.

활용 예시

생성한 큐를 사용하기 위해 해당 큐를 엽니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Orchestra > OrchestratorSamples > DataQueueTextTest
메뉴 > 도움말 > 샘플 > Sample > Orchestra > OrchestratorSamples > DataQueueFileTest

사용된 변수

connection = 열린 큐의 연결 정보를 저장할 변수
isSendSuccess = 데이터 전송 결과를 저장할 변수
receiveData = 큐에서 받은 데이터를 저장할 변수
isFile = 가져온 데이터의 파일 여부를 저장한 변수
dataCount = 데이터를 삭제한 후 남은 개수를 저장할 변수
deleteCount = 삭제할 데이터 개수를 저장할 변수

사용된 속성

[Output] Output = this.connection
ChannelName = Select Channel (mail push)

연관/유사 액티비티

QueueCloseChannel

개요

서버의 지정된 큐를 닫습니다. 닫은 큐는 다시 열기 전에는 사용할 수 없습니다.

사용 절차

큐를 사용하기 위해서는 로그인이 되어 있어야 합니다.

[Intput] Input에 현재 열려 있는 큐의 연결 정보 변수를 지정하세요.

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	[Input] Input	변수	Y	-	Y	닫고자 하는 큐의 연결 정보를 입력합니다. 열려 있는 큐의 정보는 QueueOpenChannel 액티비티 카드의 [Output] Output에 지정한 값입니다.
Y	MORE OPTIONS	-	-	-	-	Orchestrator 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	Orchestrator 라이브러리의 공통 속성입니다.

활용 예시

열려 있는 큐의 사용을 중지하기 위해 해당 큐를 닫습니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Orchestra > OrchestratorSamples > DataQueueTextTest
메뉴 > 도움말 > 샘플 > Sample > Orchestra > OrchestratorSamples > DataQueueFileTest

사용된 변수

connection = 열린 큐의 연결 정보를 저장할 변수
isSendSuccess = 데이터 전송 결과를 저장할 변수
receiveData = 큐에서 받은 데이터를 저장할 변수
isFile = 가져온 데이터의 파일 여부를 저장한 변수
dataCount = 데이터를 삭제한 후 남은 개수를 저장할 변수
deleteCount = 삭제할 데이터 개수를 저장할 변수

사용된 속성

[Input] Input = this.connection

연관/유사 액티비티

QueueOpenChannel

QueueSendData

개요

서버의 지정된 큐에 문자열 또는 파일 데이터를 전달합니다.

사용 절차

큐를 사용하기 위해서는 로그인이 되어 있어야 합니다.

[Output] Output에 데이터 전송 결과를 저장할 변수를 입력하세요.
[Input] Input에 열린 큐의 연결 정보를 입력하세요.

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	[Output] Output	변수	Y	-	N	데이터 전송 결괏값을 저장할 변수를 입력합니다. ※ 정상적으로 전송이 완료되면 True, 실패하면 False를 반환합니다. 전송 실패 시 서버 관리자에게 문의하세요.
N	[Input] Input	변수	Y	-	Y	열린 큐 연결 정보를 입력합니다.
N	DataType	콤보박스	N	-	Y	전송할 데이터 형식을 지정합니다. ※ 데이터 형식 - Data, File
N	Data	문자	Y	-	N	큐로 전송할 데이터를 입력합니다. 데이터 형식이 Text 또는 Object 일 경우에 표시됩니다. 데이터 형식을 파일(File)인 경우에는 FilePath가 표시됩니다. 빈 값은 큐에 전달할 수 없습니다.
N	FilePath	문자	Y	-	N	큐로 전송할 파일의 경로를 입력합니다. 데이터 형식이 File일 경우에 표시됩니다. 데이터 형식이 Text 또는 Object)인 경우에는 Data가 표시됩니다.
Y	MORE OPTIONS	-	-	-	-	Orchestrator 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	Orchestrator 라이브러리의 공통 속성입니다.

DataType 속성이 Data 인 경우에는, 일반 문자열 이외에도 배열, 숫자, 논리 값 등을 큐에 전송할 수 있습니다. 큐로 전송된 데이터는 다음과 같이 저장됩니다.

DataType 이 Object 형인 경우 큐에 저장되는 형식
Data입력값 예시	입력값 형식	큐 보관값
'Hello world'	문자열	"Hello world"
123456	숫자	123456
false	논리값	false
['Array string', 789, true]	배열	["Array string", 789, true]
{"name" : "Hong", "age" : 25}	Json 객체	{"name" : "Hong", "age" : 25}

활용 예시

지정한 큐에 데이터를 전송하고 전송 결과를 메시지 박스로 출력합니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Orchestra > OrchestratorSamples > DataQueueTextTest
메뉴 > 도움말 > 샘플 > Sample > Orchestra > OrchestratorSamples > DataQueueFileTest

사용된 변수

connection = 열린 큐의 연결 정보를 저장할 변수
isSendSuccess = 데이터 전송 결과를 저장할 변수
receiveData = 큐에서 받은 데이터를 저장할 변수
isFile = 가져온 데이터의 파일 여부를 저장한 변수
dataCount = 데이터를 삭제한 후 남은 개수를 저장할 변수
deleteCount = 삭제할 데이터 개수를 저장할 변수

사용된 속성

[Output] Output = this.isSendSuccess
[Input] Input = this.connection
DataType = Data
Data = this.i

연관/유사 액티비티

QueueReceiveData

개요

서버의 지정된 큐에서 데이터를 수신합니다.

사용 절차

큐를 사용하기 위해서는 로그인이 되어 있어야 합니다.

[Output] Output에 큐 데이터 수신 결과를 저장할 변수를 입력하세요.
[Output] IsFile에 수신된 데이터가 파일인지 확인한 결과를 저장할 변수를 입력하세요.
[Input] Input에 열린 큐의 연결 정보를 입력하세요.

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	[Output] Output	변수	Y	-	N	데이터 수신 결괏값을 저장할 변수를 입력합니다. ※ 정상적으로 전송이 완료되면 True, 실패하면 False를 반환합니다. 전송 실패 시 서버 관리자에게 문의하세요.
N	[Output] IsFile	변수	Y	-	N	수신된 데이터가 파일인지 여부를 확인한 결과값을 저장할 변수를 입력합니다. 수신된 데이터가 파일이면 True, 파일이 아니면 False를 반환합니다.
N	[Input] Input	변수	Y	-	Y	열린 큐 연결 정보를 입력합니다.
N	[More] Peek	토글버튼	N	-	N	Peek 기능 사용 여부를 지정합니다. 활성화 시 Queue 에서 데이터를 삭제하지 않습니다. 서버에서 기능을 지원하는 경우에만(2.1 버전 이상) 사용 가능합니다.
Y	MORE OPTIONS	-	-	-	-	Orchestrator 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	Orchestrator 라이브러리의 공통 속성입니다.

수신된 데이터가 문자열이 아니라면, 수신 데이터를 객체 변환 처리한 결과에 따라 다음과 같이 출력 값이 보정됩니다.

수신된 데이터를 객체화 처리하는 방식
수신 된 데이터 예시	입력값 형식	최종 결과 값
"Hello world"	문자열	Hello world 문자열 반환
123456	숫자	123456 숫자 반환
false	논리값	false 논리값 반환
["Array string", 789, true]	배열	["Array string", 789, true] 배열 반환
{"name" : "Hong", "age" : 25}	Json 객체	{"name" : "Hong", "age" : 25} Json 객체 반환

활용 예시

지정한 큐에서 데이터를 수신하고 수신 결과를 메시지 박스로 출력합니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Orchestra > OrchestratorSamples > DataQueueTextTest
메뉴 > 도움말 > 샘플 > Sample > Orchestra > OrchestratorSamples > DataQueueFileTest

사용된 변수

connection = 열린 큐의 연결 정보를 저장할 변수
isSendSuccess = 데이터 전송 결과를 저장할 변수
receiveData = 큐에서 받은 데이터를 저장할 변수
isFile = 가져온 데이터의 파일 여부를 저장한 변수
dataCount = 데이터를 삭제한 후 남은 개수를 저장할 변수
deleteCount = 삭제할 데이터 개수를 저장할 변수

사용된 속성

[Output] Output = this.receiveData
[Output] IsFile = this.isFile
[Input] Input = this.connection

특이 사항

데이터를 정상적으로 수신하면 큐에서는 해당 데이터가 삭제 됩니다.

연관/유사 액티비티

QueueSendData

QueueGetDataCount

개요

서버의 지정된 큐에 존재하는 데이터 개수를 가져옵니다.

사용 절차

큐를 사용하기 위해서는 로그인이 되어 있어야 합니다.

[Output] Output에 현재 큐에 존재하는 데이터 개수 결과를 저장할 변수를 입력하세요.
[Input] Input에 현재 열린 큐의 연결 정보를 입력하세요.

카드 출력 속성

카드 속성
속성	리턴타입	리턴 추가설명	설명	결과 예시
Output	int	-	큐에 있는 데이터 개수를 반환합니다.	10

카드 입력 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	[Input] Input	변수	Y	-	Y	큐 열기할때 반환된 큐 연결정보를 입력합니다.
Y	MORE OPTIONS	-	-	-	-	Orchestrator 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	Orchestrator 라이브러리의 공통 속성입니다.

활용 예시

큐에서 데이터를 수신하고 수신 여부를 확인합니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Orchestra > OrchestratorSamples > DataQueueTextTest
메뉴 > 도움말 > 샘플 > Sample > Orchestra > OrchestratorSamples > DataQueueFileTest

사용된 변수

connection
isSendSuccess
receiveData
isFile
dataCount
deleteCount

사용된 속성

[Output] Output = this.receiveData
[Output] IsFile = this.isFile
[Input] Input = this.connection

연관/유사 액티비티

QueueSendData, QueueReceiveData, QueueClearData

QueueClearData

개요

서버의 지정된 큐에서 문자열 또는 데이터를 삭제합니다.

사용 절차

큐를 사용하기 위해서는 로그인이 되어 있어야 합니다.

[Output] Output에 데이터를 삭제한 후 현재 큐에 남은 데이터 개수 결과를 저장할 변수를 입력하세요.
[Input] Input에 현재 열린 큐의 연결 정보를 입력하세요.
DataCount에 삭제할 데이터 개수를 입력하세요.

카드 출력 속성

카드 속성
속성	리턴타입	리턴 추가설명	설명	결과 예시
Output	int	-	데이터를 삭제한 후 큐에 남은 데이터 개수를 반환합니다. ※ 삭제에 실패할 경우 에러 또는 -1을 반환합니다.	10

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	[Input] Input	변수	Y	-	N	열린 큐 연결 정보를 입력합니다.
N	DataCount	문자	Y	-	Y	삭제할 데이터 개수를 지정합니다. - 양수 : 삭제할 데이터 개수 - 음수 : 큐에 존재하는 모든 데이터
Y	MORE OPTIONS	-	-	-	-	Orchestrator 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	Orchestrator 라이브러리의 공통 속성입니다.

활용 예시

지정한 큐에서 데이터를 삭제하고 남은 데이터 개수를 메시지 박스로 출력합니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Orchestra > OrchestratorSamples > DataQueueTextTest
메뉴 > 도움말 > 샘플 > Sample > Orchestra > OrchestratorSamples > DataQueueFileTest

사용된 변수

connection = 열린 큐의 연결 정보를 저장할 변수
isSendSuccess = 데이터 전송 결과를 저장할 변수
receiveData = 큐에서 받은 데이터를 저장할 변수
isFile = 가져온 데이터의 파일 여부를 저장한 변수
dataCount = 데이터를 삭제한 후 남은 개수를 저장할 변수
deleteCount = 삭제할 데이터 개수를 저장할 변수

사용된 속성

[Output] Output = this.dataCount
[Input] Input = this.connection
DataCount = this.deleteCount

연관/유사 액티비티

QueueSendData, QueueReceiveData

HttpRequest

개요

Orchestra 서버의 REST API를 호출합니다.

사용 절차

[Output] Response에 메시지 응답을 저장할 변수를 입력하세요.
URL에 호출할 주소를 입력하세요.
REST 그룹 속성에 호출할 방식, 호출할 내용 유형, API key, 헤더 및 바디 정보를 입력하세요.

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	[Output] Output	변수	Y	-	Y	데이터 수신 결괏값을 저장할 변수를 입력합니다. ※ 정상적으로 전송이 완료되면 True, 실패하면 False를 반환합니다. 전송 실패 시 서버 관리자에게 문의하세요.
Y	REST	-	-	-	-	Orchestrator 라이브러리의 공통 속성입니다.
Y	MORE OPTIONS	-	-	-	-	Orchestrator 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	Orchestrator 라이브러리의 공통 속성입니다.

연관/유사 액티비티

WaitHttp