이메일 커넥터 메서드

  • 릴리스 버전: Australia
  • 업데이트 날짜 2026년 03월 12일
  • 소요 시간: 6분

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

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

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

    구성 설정

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

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

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

    GetMails

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

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

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

    읽기 표시

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

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

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

    읽지 않음으로 표시

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

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

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

    메일 읽기

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

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

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

    답장 메일

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

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

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

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

    모든 첨부 파일 저장

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

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

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

    메일 보내기

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

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

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

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