Microsoft Outlook 커넥터 메서드

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

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

폴더 추가

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

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

닫기

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

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

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

폴더 삭제

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

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

메일 삭제

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

팁:

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

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

메일 전달

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

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

GetAttachmentNames

고유 항목 ID로 지정된 이메일과 관련된 첨부 파일 이름의 목록을 검색합니다.

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

기존 계정 가져오기

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

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

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

GetFolderNames

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

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

메일 가져오기

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

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

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

GetMails

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

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

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

GetSenderName

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

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

읽기 표시

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

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

읽지 않음으로 표시

고유 항목 ID에 따라 이메일을 읽지 않음으로 표시합니다.

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

메일 이동

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

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

ReadMsg파일

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

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

답글

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

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

모든 첨부 파일 저장

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

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

첨부 파일 저장

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

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

메일 저장하기

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

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

메일 보내기

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

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

다음으로 전송됨

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

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

계정 설정

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

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

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