이메일 커넥터 방법

  • 릴리스 버전: Xanadu
  • 업데이트 날짜 2024년 08월 01일
  • 소요 시간: 6분

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

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

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

    SetConfig (영문)

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

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

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

    GetMails

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

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

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

    마크아스리드

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

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

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

    MarkAsUnread

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

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

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

    ReadMail

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

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

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

    회신 메일

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

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

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

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

    SaveAllAttachments (모든 첨부 파일 저장)

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

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

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

    센드메일

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

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

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

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