개요

Outlook 라이브러리에서 제공하는 기능을 이용해 MS outlook 기능을 사용할 수 있습니다.

Outlook 라이브러리를 사용하기 위해서는 사용 PC에 Outlook이 설정이 되어 있어야 합니다.
Outlook 설정은 Microsoft 지원사이트 또는 소속 회사의 IT 부서에 확인하세요.

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

메일 전송: SendMail
메일 수신: GetMail, GetMailItem
메일 이동: MoveMail
메일 삭제: DeleteMail
메일 전달: ForwardMail
메일 내보내기: ExportMail
메일 회신: ReplyMail

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

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

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

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

• Other_Samples: DeleteMail, ExportMail, ForwardMail, GetMail, GetMailItem, MoveMail, ReplyMail, SendMail

공통 속성

MORE OPTIONS

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

GetMail

개요

특정 메일 계정의 메일함으로 부터 지정한 조건에 맞는 메일 리스트를 가져 옵니다.

사용 절차

[Output] Mails에 가져온 메일 목록을 저장할 변수를 입력하세요.
Account에 메일 목록을 가져올 계정을 입력하세요.
Mail Folder에 메일 목록을 가져올 Outlook의 메일함 이름을 입력하세요.
Mail Folder에 가져올 메일의 최대 개수를 입력하세요.
검색 조건 등 INPUT과 FILTER 그룹 속성에 필요한 값을 설정하세요.

카드 속성

GetMail 카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	[Output] Mails	문자	Y	-	Y	가져온 메일의 리스트를 반환합니다. ※ 리스트 내 항목을 보기 위해서는 GetMailItem을 활용합니다.
N	[INPUT] Account	문자	Y	-	Y	메일을 가져올 계정을 입력합니다.
N	[INPUT] Mail Folder	문자	Y	-	Y	메일을 가져올 Outlook 메일함의 이름을 입력합니다.
N	[INPUT] Max Count	숫자	Y	-	Y	가져올 메일의 개수를 입력합니다. 만약 0으로 입력할 경우 전체 메일을 받아 옵니다.
N	[INPUT] Mark as Read	토글버튼	N	-	Y	가져올 메일을 읽음으로 표시할지 설정합니다.
N	[INPUT] Unread Messages	토글버튼	N	-	Y	미개봉 메일만 검색할지 설정합니다.
N	[INPUT] Ignore HTML	토글버튼	N	-	Y	메일 본문 내용에서 HTML Tag는 제외할지 설정합니다.
N	[INPUT] Recent First	토글버튼	N	-	Y	메일 검색 시 최근 수신된 항목을 우선 검색하도록 설정합니다.
N	[FILTER} Sender	문자	N	-	Y	특정 발신자의 메일 계정을 검색합니다.
N	[FILTER} Title	문자	N	-	Y	메일 제목에 지정한 검색어가 포함된 메일을 검색합니다.
N	[FILTER} Body	문자	N	-	Y	메일 본문에 지정한 검색어가 포함된 메일을 검색합니다.
N	[FILTER] Start Time	문자	N	-	Y	시작 시간 이후에 수신된 메일을 검색합니다.
N	[FILTER} End Time	문자	N	-	Y	종료 시간 이전에 수신된 메일을 검색합니다.
Y	DESCRIPTION	-	-	-	-	Outlook 라이브러리의 공통 속성입니다.

활용 예시

sample@samsung.com 계정의 Outlook 받은 편지함에서 sample@samsung.com이 발신한 최신 메일 5개를 검색한 후 첫 번째 메일의 본문을 메시지 박스로 출력합니다.

GetMail 활용 예시

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Outlook > Outlook_Samples > P_OutLook_GetMail

사용된 변수

MailItemList = 가져올 메일을 저장할 배열 변수

사용된 속성

[Output] Mails = this.MailItemList
Account = 'sample@samsung.com'
Mail Folder = '받은 편지함'
Max Count = 5
Mark as Read = Off
Unread Messaged = Off
Ignore HTML = Off
Recent First = On
Sender = 'sample@samsung.com'

연관/유사 액티비티

GetMailItem

개요

GetMail 액티비티 카드로 가져온 메일 목록에서 본문, 수신인, 첨부 등의 정보를 가져 옵니다.

사용 절차

GetMail 액티비티 카드로 메일 목록을 가져와야 합니다.

[Output] Mails에 가져온 메일 정보를 저장할 변수를 입력하세요.
[Input] Mail Item에 GetMail 액티비티 카드를 통해 전달 받은 메일 목록이 저장된 변수를 입력하세요.
Mail Field에 가져올 메일 정보(본문, 수신인, 첨부)를 선택하세요.
가져올 정보가 첨부 파일인 경우 Path에 첨부 파일을 저장할 경로를 입력하세요.

카드 출력 속성

카드 속성
속성	리턴타입	리턴 추가설명	설명	결과 예시
Result	string	-	가져온 메일의 정보를 반환합니다. ※ 메일의 정보는 Mail Field에 의해서 결정됩니다.	<html> <p> 내용</p> </html>

카드 입력 속성

GetMailItem 카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	[Input] Mail Item	변수	Y	-	Y	GetMail 액티비티 카드을 통해 받은 메일 목록이 저장된 변수를 입력합니다.
N	Mail Field	콤보박스	N	-	Y	메일 정보 항목을 지정합니다. ※ 정보 항목 - Subject(제목), Body(본문), Recipients(수신인), Attachments(첨부)
N	Path	문자	N	-	N	첨부 파일을 저장할 파일 경로를 입력합니다. [INPUT] Mail Field 속성에서 'Attachment'(첨부)를 지정할 경우에만 유효합니다.
Y	DESCRIPTION	-	-	-	-	Outlook 라이브러리의 공통 속성입니다.

활용 예시

GetMailItems 활용 예시

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Outlook > Outlook_Samples > P_OutLook_GetMail

GetMail의 활용 예시를 참조하세요.

연관/유사 액티비티

GetMail

SendMail

개요

Outlook을 통해 메일을 보냅니다.

사용 절차

MAIL 그룹 속성에 발신자/수신자/참조자/비밀참조자의 메일 주소, 메일 제목, 본문, 첨부 파일 경로 등을 설정하세요.

카드 속성

SendMail 카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	[MAIL] Sender	문자	Y	-	Y	발신자 메일 주소를 입력합니다. 초기 입력되어 있는 값은 예시이므로 지우고 입력하세요.
N	[MAIL] Receivers	문자	Y	-	Y	수신자 메일 주소를 입력합니다.(세미콜론으로 구분하여 여러 메일 주소를 입력할 수 있습니다. 참조자와 비밀참조자 입력란에도 동일하게 적용됩니다.) 초기 입력되어 있는 값은 예시이므로 지우고 입력하세요.
N	[MAIL] CCs	문자	N	-	Y	참조자 메일 주소를 입력합니다. 초기 입력되어 있는 값은 예시이므로 지우고 입력하세요.
N	[MAIL] BCCs	문자	N	-	Y	비밀참조자 메일 주소를 입력합니다. 초기 입력되어 있는 값은 예시이므로 지우고 입력하세요.
N	[MAIL] Subject	문자	N	-	Y	메일 제목을 입력합니다. 초기 입력되어 있는 값은 예시이므로 지우고 입력하세요.
N	[MAIL] Body	문자	N	-	Y	메일 본문을 입력합니다. 초기 입력되어 있는 값은 예시이므로 지우고 입력하세요.
N	[MAIL] Attachments	문자	N	-	Y	첨부 파일 경로를 입력합니다.(세미콜론으로 구분하여 여러 파일을 첨부할 수 있습니다.) 초기 입력되어 있는 값은 예시이므로 지우고 입력하세요.
N	[MAIL] File Size(MB)	숫자	Y	MB	Y	첨부 파일 크기를 입력합니다.(기본값: 20MB) 첨부 파일의 크기는 메일 수신자의 메일 서버 설정에 따라 달라질 수 있습니다. 초기 입력되어 있는 값은 예시이므로 지우고 입력하세요.
N	[MAIL] Is HTML	토글버튼	N	-	Y	HTML 포맷을 사용할지 선택합니다.
Y	MORE OPTIONS	-	-	-	-	Outlook 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	Outlook 라이브러리의 공통 속성입니다.

활용 예시

'Sample Title'이라는 제목의 메일을 sample@samsung.com에게 Outlook을 통해 발송합니다.

SendMail 활용 예시

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Outlook > Outlook_Samples > P_OutLook_SendMail

사용된 변수

없음

사용된 속성

Sender = 'sample@samsung.com'
Receiver = 'sample@samsung.com'
CCs = ''
BCCs = ''
Subject = 'Sample Title'
Body = 'Sample Body Text'
File Size (MB) = 20
Is HTML = Off

연관/유사 액티비티

ForwardMail, ReplyMail

MoveMail

개요

수신한 메일을 Outlook 내 다른 메일함으로 옮깁니다.

사용 절차

GetMail 액티비티 카드로 메일 목록을 가져와야 합니다.

[Input] Mail Item에 GetMail 액티비티 카드를 통해 전달 받은 메일 목록이 저장된 변수를 입력하세요.
Mail Field에 메일을 옮길 메일함 이름을 입력하세요.

카드 속성

MoveMail 카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	[Input] Mail Item	변수	Y	-	N	GetMail 액티비티 카드을 통해 받은 메일 목록이 저장된 변수를 입력합니다.
N	[INPUT] Mail Folder	문자	Y	-	N	메일을 옮길 Outlook 메일함의 이름을 입력합니다.
Y	DESCRIPTION	-	-	-	-	Outlook 라이브러리의 공통 속성입니다.

활용 예시

Outlook에서 특정 메일을 읽어 온 후 메일을 지정한 메일함을 옮깁니다.

MoveMail 활용 예시

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Outlook > Outlook_Samples > P_OutLook_MoveMail

사용된 변수

MailItemList = 메일함의 메일 목록을 저장하는 변수
MoveTo = 메일을 옮길 메일함의 이름을 저장하는 변수

사용된 속성

Mail Item = this.MailItemList[0]
Mail Folder = this.MoveTo

연관/유사 액티비티

DeleteMail, ExportMail

DeleteMail

개요

Outlook에서 수신한 메일을 삭제합니다.

사용 절차

GetMail 액티비티 카드로 메일 목록을 가져와야 합니다.

[Input] Mail Item에 GetMail 액티비티 카드를 통해 전달 받은 메일 목록이 저장된 변수를 입력하세요.

카드 속성

DeleteMail 카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	[Input] Mail Item	변수	Y	-	N	GetMail 액티비티 카드을 통해 받은 메일 목록이 저장된 변수를 입력합니다.
Y	MORE OPTIONS	-	-	-	-	Outlook 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	Outlook 라이브러리의 공통 속성입니다.

활용 예시

Outlook에서 삭제할 메일 목록을 읽어 온 후 Input box에 '1'을 입력할 경우 수신한 메일을 삭제합니다.

DeleteMail 활용 예시

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Outlook > Outlook_Samples > P_OutLook_DeleteMail

사용된 변수

MailItemList = 메일함의 메일 목록을 저장하는 변수

사용된 속성

[Input] Mail Item = this.MailItemList[0]

연관/유사 액티비티

MoveMail, ExportMail

ForwardMail

개요

Outlook에서 수신한 메일을 재전송합니다.

사용 절차

GetMail 액티비티 카드로 메일 목록을 가져와야 합니다.

[Input] Mail Item에 GetMail 액티비티 카드를 통해 전달 받은 메일 목록이 저장된 변수를 입력하세요.
MAIL 그룹 속성에 수신자/참조자/비밀참조자의 메일 주소를 설정하세요.(최소 하나의 항목은 반드시 입력해야 합니다.)

카드 속성

ForwardMail 카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	[Input] Mail Item	변수	Y	-	N	GetMail 액티비티 카드을 통해 받은 메일 목록이 저장된 변수를 입력합니다.
N	[MAIL] Receivers	문자	Y	-	-	재전송할 메일의 수신인을 입력합니다.
N	[MAIL] CCs	문자	N	-	-	재전송할 메일의 참조인을 입력합니다.
N	[MAIL] BCCs	문자	N	-	-	재전송할 메일의 비밀참조인을 입력합니다.
Y	DESCRIPTION	-	-	-	-	Outlook 라이브러리의 공통 속성입니다.

활용 예시

Outlook에서 재전송할 메일 목록을 읽어 온 후 Input box에 '1'을 입력할 경우 지정한 메일 주소로 메일을 발송합니다.

EorwardMail 활용 예시

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Outlook > Outlook_Samples > P_OutLook_ForwardMail

사용된 변수

MailItemList = 메일함의 메일 목록을 저장하는 변수
ForwardTo = 메일을 재전송할 이메일 주소를 저장하는 변수

사용된 속성

[Input] Mail Item = this.MailItemList[0]
[MAIL] To = this.ForwardTo

연관/유사 액티비티

SendMail, ReplyMail

ExportMail

개요

Outlook에서 수신한 메일을 추출하여 .mht 또는 .msg, .txt 파일 형태로 저장합니다.

사용 절차

GetMail 액티비티 카드로 메일 목록을 가져와야 합니다.

[Input] Mail Item에 GetMail 액티비티 카드를 통해 전달 받은 메일 목록이 저장된 변수를 입력하세요.
Extention에 추출한 메일을 저장할 파일 포맷을 선택하세요.
Path에 추출한 메일을 저장할 경로와 파일명을 입력하세요.

카드 속성

ExportMail 카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	[Input] Mail Item	변수	Y	-	N	GetMail 액티비티 카드을 통해 받은 메일 목록이 저장된 변수를 입력합니다.
N	[INPUT] Extension	콤보박스	N	-	Y	메일을 저장하기 위한 확장자를 선택합니다. ※ 파일 포맷 - .mht, .msg, .txt
N	[INPUT] Path	문자	Y	-	N	메일을 저장할 파일 경로와 파일명을 입력합니다.
Y	DESCRIPTION	-	-	-	-	Outlook 라이브러리의 공통 속성입니다.

활용 예시

Outlook에서 추출할 메일 목록을 읽어 온 후 지정한 파일 경로(C:\tempmail)에 .mht 파일로 저장합니다.

ExportMail 활용 예시

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Outlook > Outlook_Samples > P_OutLook_ExportMail

사용된 변수

MailItemList = 메일함의 메일 목록을 저장하는 변수

사용된 속성

[Input] Mail Item = this.MailItemList[0]
Extension = .mht
Path = 'C:\\tempmail'

연관/유사 액티비티

MoveMail, DeleteMail

ReplyMail

개요

Outlook에서 수신한 메일에 대해 답장을 보냅니다.

사용 절차

GetMail 액티비티 카드로 메일 목록을 가져와야 합니다.

[Input] Mail Item에 GetMail 액티비티 카드를 통해 전달 받은 메일 목록이 저장된 변수를 입력하세요.
File Size (MB)에 메일로 발신할 수 있는 첨부 파일의 크기를 설정하세요.
MAIL 그룹 속성에 수신자/참조자/비밀참조자의 메일 주소, 메일 제목, 본문, 첨부 파일 경로 등을 설정하세요.

카드 속성

ReplyMail 카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	[Input] Mail Item	변수	Y	-	N	GetMail 액티비티 카드을 통해 받은 메일 목록이 저장된 변수를 입력합니다.
N	[MAIL] Receivers	문자	Y	-	N	답장 메일을 보낼 메일 주소를 입력합니다.
N	[MAIL] CCs	문자	N	-	N	답장 메일을 보낼 참조 메일 주소를 입력합니다.
N	[MAIL] BCCs	문자	N	-	N	답장 메일을 보낼 비밀참조 메일 주소를 입력합니다.
N	[MAIL] Subject	문자	N	-	N	답장 메일의 메일 제목을 입력합니다.
N	[MAIL] Attachments	문자	N	-	N	답장 메일에 첨부할 파일의 경로와 파일명을 입력합니다.
N	[MAIL] Body	문자	N	-	N	답장 메일의 메일 본문을 입력합니다.
N	[INPUT] File Size (MB)	숫자	Y	MB	N	메일에 첨부할 파일의 최대 크기를 입력합니다.
Y	MORE OPTIONS	-	-	-	-	Outlook 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	Outlook 라이브러리의 공통 속성입니다.

활용 예시

Outlook에서 답장할 메일을 읽어 온 후 Input Box에 1일 입력할 경우 지정한 수신자에게 답장 메일을 보냅니다.

ReplyMail 활용 예시

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Outlook > Outlook_Samples > P_OutLook_ReplyMail

사용된 변수

MailItemList : 메일함의 메일 목록을 저장하는 변수

사용된 속성

[Input] Mail Item = this.MailItemList[0]
To = this.MailItemList[0].Sender
CCs = this.MailItemList[0].To + ';' + this.MailItemList[0].CC
Subject = 'Re: ' + this.MailItemList[0].Subject

연관/유사 액티비티

SendMail, ForwardMail

SyncMail

개요

Outlook 프로그램이 아직 송/수신하지 않은 메일을 즉시 보내고 받도록 요청합니다. Outlook 계정이 연결된 외부 서버로  관련 작업을 즉시 시작합니다. Outlook 프로그램의 동기화 사용자 팝업 창이 나타날 수 있습니다.

사용 절차

SendMail, ForwardMail, ReplyMail 액티비티 카드와 함께 사용하려는 경우, SyncMail 카드는 해당 카드들 뒤에 위치해야 합니다.

GetMail 액티비티 카드와 함께 사용하려는 경우, SyncMail 카드는 해당 카드 앞에 위치해야 합니다.

SyncMail 카드는 Outlook 프로그램이 로컬 PC에서 대기하고 있는 메일 송/수신 작업을 즉시 시작시키는 역할을 하는 것으로, 외부 메일 서버의 메일 처리 작업에 관여하는 것은 아닙니다. 그러므로 SyncMail 카드의 동작이 완료되었어도, 연결된 외부 메일 서버에서의 작업은 처리 중 일 수 있습니다.

이 경우, SyncMail 동작 직후 GetMail 카드의 메일 수신 작업은 최신 상태를 반영하지 못할 수 있습니다.

SyncMail 과 GetMail 사이에 적절한 시간의 Delay 카드를 사용하세요.

Account에 SyncMail 액티비티 카드에서 사용할 Outlook 프로그램의 계정 주소를 입력하세요. 해당 계정에 대한 Outlook 설정은 유효하게 동작하는 상태여야 합니다.
Wait Sync Complete Time에 Outlook 프로그램이 동기화 작업을 시작하고 완료할 때까지 대기할 시간을 초 단위로 입력하세요. Outlook 프로그램의 동기화 작업이 완료되었다고 해서, 외부 메일 서버에서의 메일 처리 작업 자체가 완료된 것은 아님에 주의하세요.
Ignore Time 을 활성/비활성화하여 동기화 작업 시간이 만료되었을 때, 이를 무시하고 프로세스를 계속 진행할 지 여부를 설정하세요. 활성화 된 경우에는, 동기화가 주어진 시간 안에 완료되지 못한 경우라도, 전체 프로세스를 계속 진행합니다.

카드 속성

ReplyMail 카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	Account	문자	Y	-	Y	메일을 동기화 할 Outlook 프로그램의 계정 주소를 입력합니다. 초기 입력되어 있는 값은 예시이므로 지우고 입력하세요.
N	Wait Sync Complete Time	숫자	Y	Sec	Y	Outlook 프로그램의 동기화 시작 처리 완료를 대기할 시간을 입력합니다. 외부 메일 서버의 처리가 완료되는 시간이 아닌 것을 주의하세요.
N	Ignore Timeout	토글버튼	N	-	N	Outlook 프로그램의 동기화 시작 처리 완료 시간이 만료된 경우, 해당 카드의 작업을 계속 진행할 지 여부를 설정합니다. 이 속성이 활성화된 경우 프로세스의 실행은 중단되지 않습니다.

활용 예시

원하는 메일을 sample@samsung.com에게 Outlook을 통해 발송하고, 해당 최신 메일을 다시 메일 서버에서 수신하여, 메일의 제목을 메시지 박스로 출력합니다.

ReplyMail 활용 예시

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Outlook > Outlook_Samples > P_OutLook_SyncMail

사용된 변수

MailItemList : 메일함의 메일 목록을 저장하는 변수

사용된 속성

Account = sample@samsung.com
Wait Sync Complete Time = 5
Ignore Timeout = off

연관/유사 액티비티

SendMail, GetMail, ReplyMail