Microsoft Outlook 커넥터 메서드

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

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

AddFolder

지정된 계층 구조 내에 새 폴더를 추가하고 선택적으로 하위 폴더를 Outlook 계정 세트에 추가합니다.

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

닫기

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

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

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

Delete폴더

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

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

삭제메일

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

팁:

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

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

포워드메일

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

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

GetAttachmentNames

고유 입력 ID로 지정된 이메일과 연결된 첨부 파일 이름의 목록을 검색합니다.

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

GetExistingAccounts

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

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

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

GetFolderNames

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

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

메일 받기

고유 입력 ID(MailId)로 지정된 이메일의 모든 상세 정보를 검색합니다.

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

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

메일 받기

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

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

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

GetSenderName

고유 입력 ID로 지정된 이메일과 연결된 보낸 사람의 이메일 주소를 검색합니다.

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

MarkAsRead

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

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

읽지 않은 상태로 표시

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

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

무브메일

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

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

ReadMsgFile

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

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

답글

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

표 16. 회신 메서드 매개변수
매개변수	설명	데이터 포트 유형	데이터 유형
메일 ID	이 매개변수는 회신이 전송되는 이메일의 고유 항목 ID를 지정합니다.	의 데이터	문자열
참조	이 매개변수는 회신의 참조(참조)를 보낼 이메일 주소를 지정합니다.	의 데이터	문자열
숨은 참조	이 매개변수는 회신의 숨은 참조(BCC)를 보낼 이메일 주소를 지정합니다.	의 데이터	문자열
제목	이 매개변수는 회신 이메일의 제목 줄을 지정합니다.	의 데이터	문자열
본문	이 매개변수는 회신 이메일의 본문 내용을 지정합니다.	의 데이터	문자열
첨부 파일	이 매개변수는 회신 이메일에 포함할 첨부 파일의 경로를 지정합니다. 파이프 기호 또는 세로 막대(\|)로 여러 파일을 분리하여 첨부 파일 경로를 분할할 수 있습니다. 자동화를 13.0 이상의 플러그인으로 업그레이드할 때 "," 또는 "를 사용하는 이전 자동화를 업데이트하십시오. "를 여러 파일 경로가 전달될 때 "\|"로 바꿉니다. 파이프 기호 또는 세로 막대(\|)를 사용하여 첨부 파일 경로를 분할합니다.	의 데이터	문자열
IsHtmlBody	이 매개변수는 회신 이메일의 본문 내용이 HTML 형식인지 여부를 나타냅니다. 기본값은 거짓입니다.	의 데이터	부울
돌아가기	이 메서드는 회신이 성공적으로 전송되었는지 여부를 나타내는 부울 값을 반환합니다. 반환 값 true 는 작업이 성공했음을 의미합니다.	데이터 출력	부울

SaveAllAttachments

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

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

첨부 파일 저장

지정된 항목 ID를 사용하여 메일의 지정된 첨부 파일을 지정된 파일로 저장합니다.

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

세이브메일

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

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

센드메일

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

표 20. SendMail 메서드 매개변수
매개변수	설명	데이터 포트 유형	데이터 유형
ToEmailId	이 매개변수는 수신자의 이메일 주소를 지정합니다.	의 데이터	문자열
이미지	이 매개변수는 이메일에 포함할 선택적 이미지를 지정합니다.	의 데이터	Drawing.Bitmap
시작일	이 매개변수는 보낸 사람의 이메일 주소를 지정합니다. 지정하지 않으면 기본 보낸 사람의 주소가 사용됩니다.	의 데이터	문자열
참조	이 매개변수는 참조(참조)를 보낼 이메일 주소를 지정합니다.	의 데이터	문자열
숨은 참조	이 매개 변수는 숨은 참조(BCC)를 보낼 이메일 주소를 지정합니다.	의 데이터	문자열
제목	이 매개변수는 이메일의 제목 줄을 지정합니다.	의 데이터	문자열
본문	이 매개변수는 이메일의 본문 내용을 지정합니다.	의 데이터	문자열
첨부 파일	이 매개변수는 이메일에 포함할 첨부 파일의 경로를 지정합니다. 파이프 기호(\|)로 여러 파일을 분리하여 첨부 파일 경로를 분할할 수 있습니다. 자동화를 13.0 이상의 플러그인으로 업그레이드할 때 "," 또는 "를 사용하는 이전 자동화를 업데이트하십시오. "를 여러 파일 경로가 전달될 때 "\|"로 바꿉니다. 파이프 기호 또는 세로 막대(\|)를 사용하여 첨부 파일 경로를 분할합니다.	의 데이터	문자열
IsHtmlBody	이 매개변수는 이메일 본문이 HTML 형식인지 여부를 나타냅니다. 기본값은 거짓입니다.	의 데이터	부울
돌아가기	이 메서드는 이메일이 성공적으로 전송되었는지 여부를 나타내는 부울 값을 반환합니다. 반환 값 true 는 작업이 성공했음을 의미합니다.	데이터 출력	부울

sentAs

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

표 21. SentAs 메서드 매개변수
매개변수	설명	데이터 포트 유형	데이터 유형
ToEmailId	이 매개변수는 수신자의 이메일 주소를 지정합니다.	의 데이터	문자열
SentOnBehalfEmailID	이 매개변수는 이메일을 대신할 이메일 주소를 지정합니다.	의 데이터	문자열
제목	이 매개변수는 이메일의 제목 줄을 지정합니다.	의 데이터	문자열
본문	이 매개변수는 이메일의 본문 내용을 지정합니다.	의 데이터	문자열
첨부 파일	이 매개변수는 이메일에 포함할 첨부 파일의 경로를 지정합니다. 파이프 기호(\|)로 여러 파일을 분리하여 첨부 파일 경로를 분할할 수 있습니다. 자동화를 13.0 이상의 플러그인으로 업그레이드할 때 "," 또는 "를 사용하는 이전 자동화를 업데이트하십시오. "를 여러 파일 경로가 전달될 때 "\|"로 바꿉니다. 파이프 기호 또는 세로 막대(\|)를 사용하여 첨부 파일 경로를 분할합니다.	의 데이터	문자열
IsHtmlBody	이 매개변수는 이메일 본문이 HTML 형식인지 여부를 나타냅니다. 기본값은 거짓입니다.	의 데이터	부울

계정 설정

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

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

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