이메일 커넥터 메서드

  • 릴리스 버전: Zurich
  • 업데이트 날짜 2025년 07월 31일
  • 소요 시간: 6분

    • 이메일 커넥터의 메서드는 이메일 메시지를 검색, 전송 및 회신하고 첨부 파일을 다운로드할 수 있습니다. 먼저 SetConfig 메서드를 사용하여 메일 서버에 대한 연결을 설정합니다.

    SetConfig 메서드를 사용하여 메일 서버 속성 및 액세스 자격 증명을 구성합니다. 이 방법은 자동화에서 다른 모든 이메일 커넥터 방법보다 우선해야 합니다.

    GetMails 메서드는 메일 서버에서 메시지를 검색하고 하나 이상의 메시지가 포함된 개체로 다른 메서드에 전달합니다. ReadMail, ReplyMail 및 SaveAllAttachments 메서드는 한 번에 하나의 메시지에서 작동합니다. 이러한 메서드가 둘 이상의 메시지가 포함된 개체를 받으면 자동화는 For Each 또는 For 루프 메서드를 사용하여 컬렉션의 각 메시지를 반복해야 합니다.

    세트 구성

    자동화가 메시지에서 작동할 수 있도록 메일 서버에 대한 연결을 설정합니다.
    주:
    이메일 커넥터에서 다른 메서드를 실행하기 전에 이 메서드를 실행해야 합니다.

    매개 변수를 설정하는 방법에 대한 자세한 내용은 다음 문서를 참조하십시오 포트 속성 구성.

    표 1. SetConfig 메서드 매개변수
    매개변수 설명 데이터 포트 유형 데이터 유형 기본값 필수? 메모
    사용자 이름 메일 서버에 로그인할 사용자 이름 데이터 입력 문자열 (없음) 예
    암호 메일 서버에 로그인하기 위한 암호 데이터 입력 문자열 (없음) 예
    UseDefaultCredentials 현재 로그인한 사용자의 기본 자격 증명을 SMTP 서버로 보냅니다. 데이터 입력 부울 아니오 아니요
    SmtpMailServer SMTP 서버 이름 데이터 입력 문자열 smtp.gmail.com 아니요 이메일 커넥터를 사용한 Gmail 액세스는 현재 지원되지 않습니다. 기본값을 변경해야 합니다.
    ImapMail서버 IMAP 서버 이름 데이터 입력 문자열 imap.gmail.com 아니요 이메일 커넥터를 사용한 Gmail 액세스는 현재 지원되지 않습니다. 기본값을 변경해야 합니다.
    SSL SSL(Secure Socket Layer) 프로토콜 사용 데이터 입력 부울 예 아니요
    smtp포트 SMTP 포트 번호 데이터 입력 정수 587 아니요
    Imap포트 IMAP 포트 번호 데이터 입력 정수 993 아니요

    메일 받기

    다른 메서드에서 사용할 수 있도록 메일 서버의 메시지를 반환합니다. 읽은(확인) 또는 읽지 않은(보이지 않음) 메시지를 검색하도록 메서드를 설정하고 메시지가 수집되는 폴더를 지정할 수 있습니다.

    매개 변수를 설정하는 방법에 대한 자세한 내용은 다음 문서를 참조하십시오 포트 속성 구성.

    표 2. GetMails 메서드 매개변수
    매개변수 설명 데이터 포트 유형 데이터 유형 기본값 필수? 메모
    폴더 이름 메서드가 컬렉션을 가져오는 IMAP 폴더의 이름(예: 받은 편지함) 의 데이터 문자열 받은 편지함 예 중첩된 IMAP 폴더를 지정하려면 백슬래시를 사용하여 폴더 계층 구조를 입력합니다(예: Project\Meetings)
    필터 읽지 않은(보이지 않음) 또는 읽은(보임) 메시지만 가져오도록 설정합니다. 의 데이터 필터 모드 보이지 않는 예
    돌아가기 메일 컬렉션을 객체로 반환합니다. 데이터 출력 객체 객체 예

    MarkAsRead

    지정된 폴더의 메시지를 읽음으로 표시합니다.

    매개 변수를 설정하는 방법에 대한 자세한 내용은 다음 문서를 참조하십시오 포트 속성 구성.

    표 3. MarkAsRead 메서드 매개 변수
    매개변수 설명 포트 유형 데이터 유형 기본값 필수? 메모
    MailObject 해당 메시지가 읽음으로 표시되는 이메일 객체 의 데이터 객체 객체 예
    폴더 이름 이메일 개체를 가져올 IMAP 폴더의 이름 의 데이터 문자열 받은 편지함 예 중첩된 IMAP 폴더를 지정하려면 백슬래시를 사용하여 폴더 계층 구조를 입력합니다(예: Project\Meetings)

    읽지 않은 상태로 표시

    지정된 폴더의 메시지를 읽지 않은 상태로 표시합니다.

    매개 변수를 설정하는 방법에 대한 자세한 내용은 다음 문서를 참조하십시오 포트 속성 구성.

    표 4. MarkAsRead 메서드 매개 변수
    매개변수 설명 포트 유형 데이터 유형 기본값 필수? 메모
    MailObject 읽지 않음으로 표시된 해당 이메일을 기반으로 하는 이메일 객체입니다. 의 데이터 객체 객체 예
    폴더 이름 이메일 객체를 가져올 IMAP 폴더의 이름입니다. 의 데이터 문자열 받은 편지함 예 중첩된 IMAP 폴더를 지정하려면 백슬래시를 사용하여 폴더 계층 구조를 입력합니다(예: Project\Meetings)

    ReadMail

    메시지를 읽고 제목, 본문, 보낸 사람(보낸 사람), 참조 필드의 수신자, 숨은 참조 필드의 수신자, 첨부 파일 수 등의 상세 정보를 반환합니다.

    매개 변수를 설정하는 방법에 대한 자세한 내용은 다음 문서를 참조하십시오 포트 속성 구성.

    표 5. ReadMail 메서드 매개 변수
    매개변수 설명 데이터 포트 유형 데이터 유형 기본값 필수?
    MailObject 마지막으로 받은 메시지의 세부 정보를 제공하는 MailObject 의 데이터 객체 객체 예
    제목 메시지 제목 데이터 출력 문자열 안 함 아니요
    본문 메시지 본문 데이터 출력 문자열 안 함 아니요
    보낸 사람 메시지 보낸 사람 데이터 출력 문자열 안 함 아니요
    참조 참조로 표시된 수신자 데이터 출력 문자열 안 함 아니요
    숨은 참조 숨은 참조로 표시된 수신자 데이터 출력 문자열 안 함 아니요
    첨부 파일 수 메시지의 첨부 파일 수 데이터 출력 정수 안 함 아니요

    회신메일

    메시지에 자동으로 회신합니다. 매개변수를 사용하여 메시지 본문 및 기타 상세 정보를 설정합니다. 첨부 파일을 포함할 수 있습니다.

    매개 변수를 설정하는 방법에 대한 자세한 내용은 다음 문서를 참조하십시오 포트 속성 구성.

    표 6. ReplyMail 메서드 매개 변수
    매개변수 설명 데이터 포트 유형 데이터 유형 기본값 필수? 메모
    MailObject 메시지 상세 정보를 포함하는 메시지 객체 의 데이터 객체 객체 예
    모두에게 회신 메시지의 받는 사람 및 참조 필드에 있는 모든 수신자에게 회신 의 데이터 부울 아니오 아니요
    숨은 참조 메시지의 숨은 참조 필드에 있는 모든 수신자에게 회신 의 데이터 문자열 안 함 아니요
    본문 회신 메시지의 본문 의 데이터 문자열 안 함 아니요
    IsHtmlBody 회신 본문이 HTML 형식인지 여부를 나타내는 옵션 의 데이터 부울 아니오 아니요
    첨부 파일 회신 메시지의 첨부 파일 의 데이터 문자열 안 함 아니요 파일을 첨부하려면 다음을 수행합니다.
    1. 필드에 파일 경로를 붙여넣습니다.
    2. 경로를 묶는 따옴표를 제거합니다.

    여러 첨부 파일을 포함하려면 경로를 쉼표로 구분합니다.

    SaveAllAttachments

    메시지의 모든 첨부 파일을 로컬 드라이브에 저장합니다.

    매개 변수를 설정하는 방법에 대한 자세한 내용은 다음 문서를 참조하십시오 포트 속성 구성.

    표 7. SaveAllAttachments 메서드 매개변수
    매개변수 설명 데이터 포트 유형 데이터 유형 기본값 필수?
    MailObject 메서드가 첨부 파일을 다운로드하는 메시지입니다 데이터 입력 객체 객체 예
    폴더 경로 첨부 파일이 다운로드되는 디렉터리의 경로 데이터 입력 문자열 안 함 예

    센드메일

    메시지를 보냅니다. 매개변수를 사용하여 메시지 본문 및 기타 상세 정보를 설정합니다. 첨부 파일을 포함할 수 있습니다.
    주:
    SetConfig 메서드를 사용하여 보낸 사람 주소를 설정합니다.

    매개 변수를 설정하는 방법에 대한 자세한 내용은 다음 문서를 참조하십시오 포트 속성 구성.

    표 8. SendMail 메서드 매개변수
    매개변수 설명 데이터 포트 유형 데이터 유형 기본값 필수? 메모
    ToAddress 메시지를 보낼 주소 의 데이터 문자열 안 함 예
    참조 참조 필드에 포함할 주소 의 데이터 문자열 안 함 아니요
    숨은 참조 숨은 참조 필드에 포함할 주소 의 데이터 문자열 안 함 아니요
    제목 메시지 제목 의 데이터 문자열 안 함 아니요
    본문 메시지 본문 의 데이터 문자열 안 함 아니요
    IsHtmlBody 회신 본문이 HTML 형식인지 여부를 나타내는 옵션 의 데이터 문자열 아니오 아니요
    첨부 파일 메시지 첨부 파일 의 데이터 문자열 안 함 아니요 파일을 첨부하려면 다음을 수행합니다.
    1. 필드에 파일 경로를 붙여넣습니다.
    2. 경로를 묶는 따옴표를 제거합니다.

    여러 첨부 파일을 포함하려면 경로를 쉼표로 구분합니다.