Microsoft Outlook 커넥터 방법

Outlook 커넥터를 Microsoft 사용하면 Outlook 애플리케이션 내에서 Microsoft 일상적인 작업을 자동화할 수 있으며 이러한 기능을 보다 광범위한 자동화 워크플로에 통합할 수 있습니다.

수동 개입 없이 이메일 보내기 또는 회신과 같은 프로세스를 자동화할 수 있습니다. 이 커넥터는 Outlook 내에서 Microsoft 작업을 쉽게 자동화할 수 있는 다양한 방법을 제공합니다. 이러한 방법은 자동화 프레임워크 내에서 다른 방법 또는 구성 요소와 원활하게 결합되어 보다 복잡하고 효율적인 워크플로 설계를 가능하게 합니다.

폴더 추가

지정된 계층 구조 내에 새 폴더를 추가하고, 필요에 따라 하위 폴더를 Outlook 계정 집합에 추가합니다.

표 1. AddFolder 메서드 매개 변수
매개변수	설명	데이터 포트 유형	데이터 유형
메인 폴더	메서드가 Outlook 계정에 추가하는 폴더의 이름입니다. 이 매개 변수는 새 폴더가 추가되는 기본 폴더를 지정합니다.	의 데이터	문자열
하위 폴더 이름	메서드가 기본 폴더 아래에 추가하는 하위 폴더의 이름입니다. 이 매개 변수는 만들 새 폴더의 이름을 지정합니다. 이 매개 변수를 사용하는 경우 IsSubFolder 매개 변수를 사용해야 합니다.	의 데이터	문자열
IsSubFolder (영문)	SubFolderName 매개 변수에서 만든 폴더가 기본 폴더 아래의 하위 폴더임을 나타내는 옵션입니다. 이 매개 변수는 SubFolderName을 기본 폴더 내에 하위 폴더로 추가해야 하는지 여부를 나타냅니다. 기본값은 False로, SubFolderName이 메인 폴더 바로 아래에 추가됨을 의미합니다.	의 데이터	부울

닫기

프로파일 이름을 지정하여 Outlook 탐색기를 닫습니다 Microsoft .

이 방법은 모든 자동화 작업이 완료된 후 정리 활동으로 사용할 수 있습니다.

표 2. Close 메서드 매개변수
매개변수	설명	데이터 포트 유형	데이터 유형
프로파일 이름	이 매개 변수는 닫으려는 Outlook 프로필 이름을 지정합니다.	의 데이터	문자열

폴더 삭제(DeleteFolder)

지정된 폴더와 그 아래의 모든 하위 폴더를 삭제합니다.

표 3. DeleteFolder 메서드 매개 변수
매개변수	설명	데이터 포트 유형	데이터 유형
폴더 이름	메서드가 삭제하는 폴더의 이름입니다.	의 데이터	문자열

메일 삭제(DeleteMail)

하나 이상의 이메일을 삭제합니다. 고유 항목 ID를 기준으로 이메일을 삭제합니다.

팁:

GetMails 메서드를 사용하여 DeleteMail 메서드에서 삭제할 전자 메일을 제공합니다.

표 4. DeleteMail 메서드 매개 변수
매개변수	설명	데이터 포트 유형	데이터 유형
MailId (영문)	메서드가 이메일을 삭제하는 이메일을 가져옵니다. 이 매개변수는 삭제해야 하는 이메일의 고유 항목 ID를 지정합니다.	의 데이터	문자열

ForwardMail (전달 메일)

고유 항목 ID를 기반으로 지정된 이메일 주소(EmailID)로 이메일을 전달합니다.

표 5. ForwardMail 메서드 매개 변수
매개변수	설명	데이터 포트 유형	데이터 유형
MailId (영문)	이 매개변수는 전달해야 하는 이메일의 고유 항목 ID를 지정합니다.	의 데이터	문자열
이메일ID	이 매개변수는 이메일을 전달해야 하는 이메일 주소를 지정합니다.	의 데이터	문자열
참조	이 매개변수는 전달된 이메일의 참조(참조)를 보낼 이메일 주소를 지정합니다.	의 데이터	문자열
숨은 참조	이 매개변수는 전달된 이메일의 숨은 참조(BCC)를 보낼 이메일 주소를 지정합니다.	의 데이터	문자열
제목	이 매개변수는 전달된 이메일의 제목 줄을 지정합니다.	의 데이터	문자열
반환	이 메서드는 이메일이 성공적으로 전달되었는지 여부를 나타내는 부울 값을 반환합니다. true의 반환 값은 작업이 성공했음을 나타냅니다.	데이터 출력	부울

첨부 파일 이름 가져오기

고유 항목 ID로 지정된 이메일과 연결된 첨부 파일 이름의 목록을 조회합니다.

표 6. GetAttachmentNames 메서드 매개 변수
매개변수	설명	데이터 포트 유형	데이터 유형
MailId (영문)	이 매개변수는 첨부 파일 이름을 검색할 이메일의 고유 항목 ID를 지정합니다.	의 데이터	문자열

기존 계정 가져오기

구성된 계정 목록 및 해당 개수와 같은 구성된 계정에 대한 정보를 검색합니다.

이는 Outlook에 여러 계정이 구성된 경우에 유용합니다.

표 7. GetExistingAccounts 메서드 매개 변수
매개변수	설명	데이터 포트 유형	데이터 유형
계정	이 매개 변수는 참조로 전달되며 List(Of String)여야 합니다. 이 메서드를 호출하면 구성된 계정 이름 목록으로 채워집니다.	데이터 출력	목록1
카운트	이 매개 변수는 참조로 전달됩니다. 이 메서드를 호출하면 이 매개 변수가 구성된 계정 수로 채워집니다.	데이터 출력	정수32

폴더 이름 가져오기

활성 Outlook 계정에서 폴더 이름의 목록을 검색하고 반환합니다.

표 8. GetFolderNames 메서드 매개 변수
매개변수	설명	데이터 포트 유형	데이터 유형
반환	활성 Outlook 계정에서 폴더 이름 목록을 반환합니다.	데이터 출력	목록1

메일 가져오기

고유 항목 ID(MailId)로 지정된 이메일의 모든 상세 정보를 조회합니다.

전자 메일의 모든 세부 정보를 검색하기 위한 추가 조건을 지정하려면 GetMail 메서드 모음에서 메서드 설정 아이콘(메서드 을 클릭하고 CC, BCC, 제목, 본문, 보낸 사람, 받는 사람, AttachmentsCount, ReceivedTime, EntryId와 같은 필요한 메일 항목을 선택합니다.

표 9. GetMail 메서드 매개 변수
매개변수	설명	데이터 포트 유형	데이터 유형
MailId (영문)	이 매개변수는 상세 정보를 검색할 이메일의 고유 항목 ID를 지정합니다.	의 데이터	문자열

GetMails

이메일 시스템 내의 지정된 폴더에서 메일 항목 ID의 목록을 조회합니다.

GetMails 메서드는 전자 메일 시스템 내의 지정된 폴더에서 메일 항목 ID 목록을 검색합니다.

표 10. GetMails 메서드 매개 변수
매개변수	설명	데이터 포트 유형	데이터 유형
폴더 이름	이 매개변수는 메일 항목 ID를 검색할 폴더의 이름을 지정합니다. 기본값은 "받은 편지함"입니다.	의 데이터	문자열
필터	이 매개변수는 메일 항목 ID를 검색할 때 적용할 필터 조건을 지정합니다.	의 데이터	문자열
NoOfMails	이 매개변수는 검색할 메일 항목 ID의 최대 수를 지정합니다. 기본값은 10입니다.	의 데이터	정수32
읽기 전용(UnreadOnly)	이 매개 변수는 읽지 않은 메일만 검색할지(True) 또는 모든 메일(False)을 검색할지 여부를 나타냅니다. 기본값은 True입니다.	의 데이터	부울
AvoidMeetingItems (영문)	이 매개변수는 검색된 메일 항목 ID에서 회의 항목을 제외할지 여부를 지정합니다. 기본값은 True입니다.	의 데이터	부울
가져오는 순서	이 매개변수는 메일을 가져오는 순서를 지정합니다. 예: FIFO, LIFO. 기본값은 FIFO입니다.	의 데이터	가져오는 순서
반환	이 매개변수는 지정된 폴더의 이메일 목록을 반환합니다.	데이터 출력	목록1
카운트	이 매개변수는 검색된 메일 항목 ID의 총 개수를 지정합니다.	데이터 출력	정수32

보낸 사람 이름 가져오기

고유 항목 ID로 지정된 이메일과 연결된 보낸 사람의 이메일 주소를 조회합니다.

표 11. GetSenderName 메서드 매개 변수
매개변수	설명	데이터 포트 유형	데이터 유형
MailId (영문)	이 매개변수는 보낸 사람의 이메일 주소를 검색할 이메일의 고유 항목 ID를 지정합니다.	의 데이터	문자열
반환	이 메서드는 보낸 사람 이름을 나타내는 문자열 값을 반환합니다.	데이터 출력	문자열

마크아스리드

고유 입력 ID를 기준으로 이메일을 읽음으로 표시합니다.

표 12. MarkAsRead 메서드 매개 변수
매개변수	설명	데이터 포트 유형	데이터 유형
MailId (영문)	이 매개변수는 보낸 사람의 이메일 주소를 검색할 이메일의 고유 항목 ID를 지정합니다.	의 데이터	문자열
반환	이 메서드는 이메일이 읽음으로 성공적으로 표시되었는지 여부를 나타내는 부울 값을 반환합니다. true의 반환 값은 작업이 성공했음을 나타냅니다.	데이터 출력	부울

MarkAsUnread

고유 항목 ID를 기준으로 이메일을 읽지 않음으로 표시합니다.

표 13. MarkAsUnread 메서드 매개 변수
매개변수	설명	데이터 포트 유형	데이터 유형
MailId (영문)	이 매개변수는 읽지 않은 것으로 표시해야 하는 이메일의 고유 항목 ID를 지정합니다.	의 데이터	문자열
반환	이 메서드는 이메일이 읽지 않은 것으로 성공적으로 표시되었는지 여부를 나타내는 부울 값을 반환합니다. true의 반환 값은 작업이 성공했음을 나타냅니다.	데이터 출력	부울

무브메일

고유 항목 ID를 기반으로 이메일을 한 폴더에서 이메일 시스템 내의 다른 폴더로 이동합니다.

표 14. MoveMail 메서드 매개 변수
매개변수	설명	데이터 포트 유형	데이터 유형
MailId (영문)	이 매개변수는 이동해야 하는 이메일의 고유 항목 ID를 지정합니다.	의 데이터	문자열
대상 폴더	이 매개변수는 이메일을 이동해야 하는 대상 폴더의 이름 또는 경로를 지정합니다.	의 데이터	문자열

ReadMsgFile

파일 시스템에서 .msg 파일의 내용을 읽습니다.

표 15. ReadMsgFile 메서드 매개변수
매개변수	설명	데이터 포트 유형	데이터 유형
파일 경로	이 매개변수는 읽어야 하는 .msg 파일의 경로를 지정합니다.	의 데이터	문자열
본문	이 매개 변수는 참조(ByRef)에 의해 전달되며 메서드 호출 후 .msg 파일의 본문 내용으로 채워집니다.	데이터 출력	문자열

답글

고유 항목 ID로 지정된 이메일에 회신을 작성하고 보냅니다.

표 16. Reply 메서드 매개변수
매개변수	설명	데이터 포트 유형	데이터 유형
IsHtmlBody (영문)	이 매개변수는 회신 이메일의 본문 내용이 HTML 형식인지 여부를 나타냅니다. 기본값은 거짓입니다.	의 데이터	부울
반환	이 메서드는 회신이 성공적으로 전송되었는지 여부를 나타내는 부울 값을 반환합니다. true의 반환 값은 작업이 성공했음을 나타냅니다.	데이터 출력	부울

SaveAllAttachments (모든 첨부 파일 저장)

고유 항목 ID로 지정된 이메일의 모든 첨부 파일을 지정된 폴더 경로에 저장합니다.

표 17. SaveAllAttachments 메서드 매개 변수
매개변수	설명	데이터 포트 유형	데이터 유형
MailId (영문)	이 매개변수는 첨부 파일을 저장해야 하는 이메일의 고유 항목 ID를 지정합니다.	의 데이터	문자열
폴더 경로	이 매개변수는 첨부 파일을 저장해야 하는 폴더의 경로를 지정합니다.	의 데이터	문자열

첨부 파일 저장

지정된 항목 ID를 가진 메일의 지정된 첨부 파일을 지정된 파일에 저장합니다.

표 18. SaveAttachment 메서드 매개 변수
매개변수	설명	데이터 포트 유형	데이터 유형
MailId (영문)	이 매개변수는 첨부 파일을 저장해야 하는 이메일의 고유 항목 ID를 지정합니다.	의 데이터	문자열
첨부 파일 이름	이 매개변수는 저장해야 하는 첨부 파일의 이름을 지정합니다.	의 데이터	문자열
파일 경로	이 매개변수는 첨부 파일을 저장해야 하는 파일의 경로를 지정합니다.	의 데이터	문자열

메일 저장

고유 항목 ID(MailId)로 지정된 이메일을 지정된 파일 경로의 파일에 저장합니다.

표 19. SaveMail 메서드 매개변수
매개변수	설명	데이터 포트 유형	데이터 유형
MailId (영문)	이 매개변수는 저장할 이메일의 고유 항목 ID를 지정합니다.	의 데이터	문자열
파일 경로	이 매개변수는 이메일을 파일로 저장해야 하는 경로를 지정합니다.	의 데이터	문자열
저장 유형	이 매개변수는 이메일을 저장해야 하는 형식을 지정합니다. 기본값은 Microsoft Outlook MSG 형식을 나타내는 MsgSaveType.olMSG입니다.	의 데이터	메시지 저장 유형

센드메일

수신자에게 이메일을 보냅니다. 이미지를 추가하고, 보낸 사람의 주소를 설정하고, 참조 및 숨은 참조 수신자를 지정하는 기능을 포함하여 이메일을 사용자 정의할 수 있는 다양한 선택적 매개변수를 제공합니다.

표 20. SendMail 메서드 매개 변수
매개변수	설명	데이터 포트 유형	데이터 유형
ToEmailId	이 매개변수는 수신자의 이메일 주소를 지정합니다.	의 데이터	문자열
이미지	이 매개변수는 이메일에 포함할 선택적 이미지를 지정합니다.	의 데이터	도면.비트맵
시작	이 매개 변수는 보낸 사람의 전자 메일 주소를 지정합니다. 지정하지 않으면 기본 보낸 사람의 주소가 사용됩니다.	의 데이터	문자열
참조	이 매개변수는 참조(CC)를 보낼 이메일 주소를 지정합니다.	의 데이터	문자열
숨은 참조	이 매개변수는 숨은 참조(BCC)를 보낼 이메일 주소를 지정합니다.	의 데이터	문자열
제목	이 매개변수는 이메일의 제목 줄을 지정합니다.	의 데이터	문자열
본문	이 매개변수는 이메일의 본문 내용을 지정합니다.	의 데이터	문자열
첨부 파일	이 매개변수는 이메일에 포함할 첨부 파일의 경로를 지정합니다. 여러 파일은 세미콜론으로 구분할 수 있습니다.	의 데이터	문자열
IsHtmlBody (영문)	이 매개변수는 이메일 본문이 HTML 형식인지 여부를 나타냅니다. 기본값은 거짓입니다.	의 데이터	부울
반환	이 메서드는 이메일이 성공적으로 전송되었는지 여부를 나타내는 부울 값을 반환합니다. true의 반환 값은 작업이 성공했음을 나타냅니다.	데이터 출력	부울

SentAs

다른 이메일 계정을 대신하여 이메일을 보냅니다.

표 21. SentAs 메서드 매개 변수
매개변수	설명	데이터 포트 유형	데이터 유형
ToEmailId	이 매개변수는 수신자의 이메일 주소를 지정합니다.	의 데이터	문자열
SentOnBehalfEmailID	이 매개변수는 이메일을 대신 보낼 이메일 주소를 지정합니다.	의 데이터	문자열
제목	이 매개변수는 이메일의 제목 줄을 지정합니다.	의 데이터	문자열
본문	이 매개변수는 이메일의 본문 내용을 지정합니다.	의 데이터	문자열
첨부 파일	이 매개변수는 이메일에 포함할 첨부 파일의 경로를 지정합니다.	의 데이터	문자열
IsHtmlBody (영문)	이 매개변수는 이메일 본문이 HTML 형식인지 여부를 나타냅니다. 기본값은 거짓입니다.	의 데이터	부울

SetAccount

자동화 작업에 대한 작업을 수행할 Outlook 계정을 지정합니다.

SetAccount 메서드는 이 커넥터의 다른 메서드보다 먼저 처음에 사용하여 후속 메서드를 실행할 컨텍스트 또는 전자 메일 계정을 지정하거나 설정해야 합니다.

표 22. SetAccount 메서드 매개 변수
매개변수	설명	데이터 포트 유형	데이터 유형
AccountName	이 매개 변수는 작업을 수행할 Outlook 전자 메일 계정 ID를 지정합니다.	의 데이터	문자열