---
sourceDocument: Xanadu 애플리케이션과의 통합 생성
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/xanadu/integrate-applications

 Release :

    - xanadu

ft:locale :

    - ko-KR

ft:publication_title :

    - Xanadu 애플리케이션과의 통합 생성

ft:clusterId :

    - crint

bundleId :

    - crint

workflow :

    - Creator


---

# 이메일 커넥터 방법

# 이메일 커넥터 방법 {#ariaid-title1}

* 릴리스 버전: Xanadu
* 
* 업데이트 날짜 2024년 08월 01일
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 6분

이메일 커넥터의 메서드는 이메일 메시지를 검색, 전송 및 회신하고 첨부 파일을 다운로드할 수 있습니다. 먼저 SetConfig 메서드를 사용하여 메일 서버에 대한 연결을 설정합니다.
SetConfig 메서드를 사용하여 메일 서버 속성과 액세스 자격 증명을 구성합니다. 이 메서드는 자동화의 다른 모든 이메일 커넥터 메서드보다 우선해야 합니다.

GetMails 메서드는 메일 서버에서 메시지를 검색하여 하나 이상의 메시지를 포함하는 개체로 다른 메서드에 전달합니다. ReadMail, ReplyMail 및 SaveAllAttachments 메서드는 한 번에 하나의 메시지에서 작동합니다. 이러한 메서드가 둘 이상의 메시지가 포함된 개체를 받으면 자동화는 For Each 또는 For Loop 메서드를 사용하여 컬렉션의 각 메시지를 반복해야 합니다.  
* For Each 메서드를 사용하는 방법에 대한 자세한 내용은 를 참조하십시오 [For Each 구성요소 사용](https://servicenow-prod.fluidtopics.net/XuMnt~4VygZhcxaJtPMc1g "의 For Each 구성 요소를 사용하여 컬렉션의 각 항목을 첫 번째에서 마지막 순서로 트래버스합니다 RPA 데스크톱 디자인 스튜디오. 컬렉션은 배열, 목록 또는 테이블일 수 있습니다.").
* For 루프 메서드를 사용하는 방법에 대한 자세한 내용은 을 참조하십시오 [For 루프 구성요소 사용](https://servicenow-prod.fluidtopics.net/0ewOSiYyDZk4WiMzd3vJFg "의 For Loop 구성 요소를 RPA 데스크톱 디자인 스튜디오사용하여 코드를 반복적으로 실행하여 반복적인 작업을 수행합니다. For 루프는 반복을 지정하기 위한 제어 흐름 구성 요소입니다.").
{#email-connector-methods__ul_rkc_ss4_lzb}

## SetConfig (영문) {#email-connector-methods__section_psc_jv2_mtb}

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

매개 변수를 설정하는 방법에 대한 자세한 내용은 을 참조하십시오 [포트 속성 구성](https://servicenow-prod.fluidtopics.net/XyUWVVIZHNAOD1BSa3R53Q "에서 RPA 데스크톱 디자인 스튜디오구성 요소 또는 메서드의 입력 필드에 데이터를 전달하는 방법을 구성합니다.").  
{#email-connector-methods__table_qrp_jx2_mtb__entry__7}

| 매개변수 | 설명 | 데이터 포트 유형 | 데이터 유형 | 기본값 | 필수? | 참고 사항 |
|-|-|-|-|-|-|-|
| 사용자 이름 | 메일 서버에 로그인할 사용자 이름 | 데이터 입력 | 문자열 | (없음) | 예 |   |
| 암호 | 메일 서버에 로그인하기 위한 암호 | 데이터 입력 | 문자열 | (없음) | 예 |   |
| 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 | 아니요 |   |
[표 1. SetConfig 메서드 매개 변수]

{#email-connector-methods__table_qrp_jx2_mtb}

## GetMails {#email-connector-methods__section_rw5_4mk_mtb}

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

매개 변수를 설정하는 방법에 대한 자세한 내용은 을 참조하십시오 [포트 속성 구성](https://servicenow-prod.fluidtopics.net/XyUWVVIZHNAOD1BSa3R53Q "에서 RPA 데스크톱 디자인 스튜디오구성 요소 또는 메서드의 입력 필드에 데이터를 전달하는 방법을 구성합니다.").  
{#email-connector-methods__table_uvc_1nk_mtb__entry__7}

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

{#email-connector-methods__table_uvc_1nk_mtb}

## 마크아스리드 {#email-connector-methods__section_uhb_31l_mtb}

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

매개 변수를 설정하는 방법에 대한 자세한 내용은 을 참조하십시오 [포트 속성 구성](https://servicenow-prod.fluidtopics.net/XyUWVVIZHNAOD1BSa3R53Q "에서 RPA 데스크톱 디자인 스튜디오구성 요소 또는 메서드의 입력 필드에 데이터를 전달하는 방법을 구성합니다.").  
{#email-connector-methods__table_zhf_kbl_mtb__entry__7}

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

{#email-connector-methods__table_zhf_kbl_mtb}

## MarkAsUnread {#email-connector-methods__section_l3t_hcl_mtb}

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

매개 변수를 설정하는 방법에 대한 자세한 내용은 을 참조하십시오 [포트 속성 구성](https://servicenow-prod.fluidtopics.net/XyUWVVIZHNAOD1BSa3R53Q "에서 RPA 데스크톱 디자인 스튜디오구성 요소 또는 메서드의 입력 필드에 데이터를 전달하는 방법을 구성합니다.").  
{#email-connector-methods__table_phg_mcl_mtb__entry__7}

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

{#email-connector-methods__table_phg_mcl_mtb}

## ReadMail {#email-connector-methods__section_iqz_tfl_mtb}

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

매개 변수를 설정하는 방법에 대한 자세한 내용은 을 참조하십시오 [포트 속성 구성](https://servicenow-prod.fluidtopics.net/XyUWVVIZHNAOD1BSa3R53Q "에서 RPA 데스크톱 디자인 스튜디오구성 요소 또는 메서드의 입력 필드에 데이터를 전달하는 방법을 구성합니다.").  
{#email-connector-methods__table_uts_bgl_mtb__entry__6}

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

{#email-connector-methods__table_uts_bgl_mtb}

## 회신 메일 {#email-connector-methods__section_l11_gyy_mtb}

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

매개 변수를 설정하는 방법에 대한 자세한 내용은 을 참조하십시오 [포트 속성 구성](https://servicenow-prod.fluidtopics.net/XyUWVVIZHNAOD1BSa3R53Q "에서 RPA 데스크톱 디자인 스튜디오구성 요소 또는 메서드의 입력 필드에 데이터를 전달하는 방법을 구성합니다.").  
{#email-connector-methods__table_hm3_kmz_mtb__entry__7}

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

{#email-connector-methods__table_hm3_kmz_mtb}

## SaveAllAttachments (모든 첨부 파일 저장) {#email-connector-methods__section_mz4_gyy_mtb}

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

매개 변수를 설정하는 방법에 대한 자세한 내용은 을 참조하십시오 [포트 속성 구성](https://servicenow-prod.fluidtopics.net/XyUWVVIZHNAOD1BSa3R53Q "에서 RPA 데스크톱 디자인 스튜디오구성 요소 또는 메서드의 입력 필드에 데이터를 전달하는 방법을 구성합니다.").  
{#email-connector-methods__table_vbt_5zy_mtb__entry__6}

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

{#email-connector-methods__table_vbt_5zy_mtb}

## 센드메일 {#email-connector-methods__section_r4g_xqz_mtb}

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

매개 변수를 설정하는 방법에 대한 자세한 내용은 을 참조하십시오 [포트 속성 구성](https://servicenow-prod.fluidtopics.net/XyUWVVIZHNAOD1BSa3R53Q "에서 RPA 데스크톱 디자인 스튜디오구성 요소 또는 메서드의 입력 필드에 데이터를 전달하는 방법을 구성합니다.").  
{#email-connector-methods__table_qvr_frz_mtb__entry__7}

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

{#email-connector-methods__table_qvr_frz_mtb}