주 컨텐츠로 이동
Administrator Guide
최종 업데이트: 2023-06-23
참조: Email-Out 전송 속성

참조: Email-Out 전송 속성

공통 탭

속성
XML 속성명
설명
Id
id
조립품 내
이메일 전송
구성요소의 고유 ID입니다.
Routes Response To
routes-response-to
이메일 전송
전송에 대한 응답 메시지의 대상입니다.
Execute When
execute-when
전송 실행 여부를 결정하는 조건입니다.
종료
to
대상 수신자의 기본 이메일 주소입니다. 형식을 따릅니다.
mailto:[emailaddress]
.
숨은 참조 주소만 사용하려면 빈 참조 주소를 지정하십시오.
mailto:
주제
subject
이메일의 제목 라인입니다.
시작
from
전달된 이메일의
'발신자
' 필드에 표시되는 이메일 주소입니다.
Ssl
ssl
연결이 SSL인지 여부를 지정합니다.
시작
starttls
SMTP 세션을 시작하기 전에 STARTTLS 명령을 실행하여 원격 SMTP 서버와의 즉시 SSL 협상을 활성화할지 여부를 지정합니다. SMTP 서버가 다음 회신 코드 중 하나로 응답합니다.
  • 220 시작 준비 완료
  • TLS 501 구문 오류(매개변수 허용 안 됨)
  • 454 일시적인 이유로 인해 TLS 사용불가
SSL
starttls
속성은 상호 배제적입니다.
호스트
host
전송에서 메시지를 전송하는 데 사용하는 SMTP 메일 서버의 이름 또는 IP 주소입니다.
OAuth를 사용하는 경우 이 값을 으로 설정합니다.
localhost
.
포트
port
메일 서버가 실행 중인 포트 번호입니다. 기본값은 표준 SMTP 포트인 25입니다. 예외:
  • SSL
    속성이 다음으로 설정된 경우
    true
    포트가 지정되지 않은 경우 기본값은 465입니다.
  • Starttls
    속성이 다음으로 설정된 경우
    true
    포트가 지정되지 않은 경우 기본값은 587입니다.
사용자
이메일 서버에 액세스하는 데 사용되는 사용자명입니다.
비밀번호
password
사용자
속성에 지정된 사용자명의 비밀번호입니다.

고급 탭

속성
XML 속성명
설명
Store Message
store-message
Workday 지원팀에서 달리 권장하지 않는 한,
none
을 지정합니다.
메시지를 저장하려면 Studio의
store
단계를 사용합니다.
Transport Class
transport-class
필요한 경우, 어셈블리별로 대체 구현 클래스를 지정합니다.
WEB-INF/classes/spring/assembly-bean.xml 파일을 편집하여 구현 클래스를 전체적으로 변경할 수 있습니다.
Ignore Dynamic Endpoints
ignore-dynamic-endpoints
수신 메시지 헤더의 동적 WSA(WS-Addressing) 값을 무시할지 아니면 이 값을 사용하여 전송의
엔드포인트
속성 값을 재정의할지 지정합니다.
set-dynamic-endpoint
단계를 사용하여 WS-Addressing 세부내용을 지정합니다.
Bcc
bcc
세미콜론 구분 기호를 사용하여 숨은 참조 이메일 수신자를 지정합니다. 예:
logan.mcneil@workday.com; jake.lee@workday.com
.
Cc
cc
세미콜론 구분 기호를 사용하여 이메일 수신자를 지정합니다. 예:
logan.mcneil@workday.com; jake.lee@workday.com
.
회신처
reply-to
사용자가 이메일 메시지에 회신할 때 받는 사람
필드
에 자동으로 삽입되는 이메일 주소입니다. 대부분의 이메일 메시지는
발신자
필드의 주소만 있으면 충분하므로
회신처
속성을 정의할 필요가 없습니다. 세미콜론 구분 기호를 사용하여 여러 이메일 주소를 지정합니다. 예:
logan.mcneil@workday.com; jake.lee@workday.com
.
시간 초과
timeout
전송이 수신 대기하는 FTP 서버와 클라이언트 간의 FTP 세션에 대한 시간 초과 기간을 밀리초 단위로 지정합니다. 값을 지정하지 않으면 300,000ms(5분) 후에 세션 시간이 초과됩니다.
일시적 예외
transient-exceptions
일시적 예외는 재시도 시 수정 없이 성공할 수 있는 예외입니다. 일시적인 예외는 문제의 근본 원인이 수정될 때까지 재시도에서 계속 실패하는 예외입니다.
기본적으로 Workday는
java.net.ConnectException
java.net.SocketException
오류를 일시적 예외로 처리합니다.
추가 일시적 예외를 쉼표, 공백 또는 쉼표로 지정하고 공백으로 구분된 클래스명 열거를 지정합니다. 예를 들어 다음과 같습니다.
  • java.net.UknownHostException java.net.ConnectException java.net.SocketException
  • java.net.UknownHostException,java.net.ConnectException,java.net.SocketException
  • java.net.UknownHostException, java.net.ConnectException, java.net.SocketException
  • @{new java.net.UnknownHostException().getClass().getName()}
추가 일시적 예외를 지정하는 경우 기본 예외도 포함해야 합니다.
java.net.ConnectException
java.net.SocketException
을(를) 선택합니다. 그렇지 않으면 Workday가 해당 항목을 덮어씁니다.

SMTP Headers 탭

속성
XML 속성명
설명
이름
name
커스텀 SMTP 헤더의 이름입니다.
기존 행 아래에 새 커스텀 헤더를 추가하려면
추가
를 클릭한 다음
이름
을 입력합니다.
기존 행 위에 새 헤더를 추가하려면 해당 행에 커서를 놓고
추가
드롭다운 메뉴에서
삽입
을 클릭합니다.
SMTP Headers
탭 오른쪽에 있는 버튼을 사용하여 행을 삭제하거나 재정렬합니다.
value
커스텀 SMTP 헤더의 값입니다.

OAuth 탭

Studio의 이메일 전송 구성요소에서 Microsoft Outlook OAuth 인증을 사용하려면 Studio를 Microsoft Azure에 앱으로 등록하고, 도메인 전체 위임을 제공하고, 에 대한 관리자 동의를 부여합니다.
Mail.Send
권한을 부여하고 다양한 값을 가져옵니다. 자세한 내용은 다음을 참조하십시오. https://learn.microsoft.com/en-gb/azure/active-directory/develop/v2-oauth2-client-creds-grant-flow.
Studio의 Email-Out 구성요소에서 Google Gmail OAuth 인증을 사용하려면 Google Cloud에 서비스 계정을 등록하고 도메인 전체 위임을 제공한 다음 다양한 값에 대한 JSON 설명을 가져옵니다. 자세한 내용은 다음을 참조하십시오https://support.google.com/cloud/answer/6158849?hl=en.
속성
XML 속성명
설명
제공자
provider
이메일 제공자명
MICROSOFT_OUTLOOK
또는
GOOGLE_GMAIL
.
이름
name
Microsoft Azure 포털 또는 Google Cloud 콘솔에서 가져온 다양한 값과 연결하는 Workday의 필수 이름입니다.
Microsoft Outlook의 경우 다음 이름을 입력합니다.
  • outlook.client.id
  • outlook.client.secret
  • outlook.tenant.id
  • outlook.user.id
Google Gmail의 경우 다음을 입력합니다.
  • gmail.service.account.key.json
  • gmail.delegated.user
value
Microsoft 또는 Google에서 확보한 값으로 위의 이름과 연결합니다.
Microsoft Outlook의 경우 다음과 같은 이름/값 쌍을 생성합니다.
이름
outlook.client.id
Microsoft Azure Portal에서 등록된 앱의
Overview
페이지에 있는 다음 항목입니다.
어플리케이션(클라이언트) ID
outlook.client.secret
Microsoft Azure Portal에서 등록된 앱의
Certificates & secrets
페이지에 있는 다음 항목입니다.
클라이언트 비밀키 ID
outlook.tenant.id
Microsoft Azure Portal에서 등록된 앱의
Overview
페이지에 있는 다음 항목입니다.
디렉토리(테넌트) ID
outlook.user.id
이메일 전송 계정의 Outlook 주소입니다.
공통
탭의
발신자
필드에도 입력됩니다.
Google Gmail의 경우 다음과 같은 이름/값 쌍을 생성합니다.
이름
gmail.service.account.key.json
Google Cloud Console에서
Service accounts
페이지의
KEYS
섹션에서 다운로드한 파일의 JSON 텍스트입니다.
gmail.delegated.user
이메일 전송에 사용될 Gmail 주소입니다. Google 서비스 계정과 연결된 보안 주체여야 합니다.
공통
탭의
발신자
필드에도 입력됩니다.

SSL 또는 STARTTLS를 사용하는 Gmail

SSL 또는 STARTTLS를 사용하는 Gmail을 이용하도록
email-out
전송을 구성할 때는 다음을 확인합니다.
  • 사용자
    비밀번호
    에 유효한 지메일 자격증명이 포함되어 있습니다.
  • 엔드포인트
    :
    mailto:[name]@gmail.com
    .
  • 호스트
    smtp.gmail.com
    .
  • SSL
    또는
    starttls가
    다음으로 설정된 경우
    true
    .
  • 포트는
    다음 중 하나입니다.
    • 465(
      ssl이
      다음으로 설정된 경우)
      true
      .
    • 587(
      starttls가
      다음으로 설정된 경우)
      true
      .
  • 현재
    시간 초과
    30000
    (30초)

SSL 또는 STARTTLS를 통한 Microsoft Office 365

SSL 또는 STARTTLS를 사용하는 Microsoft Office 365를 이용하도록
email-out
전송을 구성할 때는 다음을 확인합니다.
  • 사용자
    비밀번호
    에 유효한 Office 365 사용자 자격증명이 포함되어 있습니다.
  • 엔드포인트
    :
    mailto:[name]@[domain-name.top-level-domain]
    .
  • 호스트
    smtp.office365.com
    .
  • SSL
    또는
    starttls가
    다음으로 설정된 경우
    true
    .
  • 포트는
    다음 중 하나입니다.
    • 465(
      ssl이
      다음으로 설정된 경우)
      true
      .
    • 587(
      starttls
      true
      로 설정된 경우)
  • 현재
    시간 초과
    30000
    (30초)

이진이 아닌 형식의 메시지 본문 및 첨부파일 구성

대부분의 이메일 어플리케이션은 수신 메시지를 수신할 때 MIME 메시지의 첫 번째 텍스트 부분을 매칭하여 메시지 텍스트로 사용합니다. root 메시지 부분의 MIME 유형을 다음으로 설정하려면 다음을 수행합니다.
text/plain
에서 메시지
Input
Output
속성을
message
로 설정한 다음,
출력
MIME 유형을
text/ Plain
으로 설정합니다.
메시지 작성기를
사용하여
텍스트
요소를 통해 이메일 메시지 본문의 메시지 콘텐츠를 정의합니다.
첨부파일의 경우
출력
속성을
첨부파일
로 설정하고,
출력
첨부파일 인덱스를 으로 설정합니다.
0
,
출력
MIME 유형을
text/ Plain
으로 설정합니다.
다시 한 번,
Message Builder를
사용하여
텍스트
요소를 통해 첨부파일의 메시지 콘텐츠를 정의합니다.
일부 이메일 어플리케이션에서 메시지 본문에 텍스트 첨부파일을 표시하지 못하게 하려면 실제 텍스트인 경우에도 첨부파일 MIME 형식을
application/octet-Stream
으로 설정합니다. 이렇게 하려면
평가
단계 내에서 MVEL 표현식을 사용합니다. 예:
parts[1].setMimeType('application/octet-stream')
첨부파일명을 설정하려면 MVEL 표현식을 사용하여
Content-Disposition
헤더 예:
parts[1].setHeader('Content-Disposition', 'attachment; filename=payload.txt')
.
마지막으로
이메일 전송
단계를 구성합니다.

이진 형식의 메시지 본문 및 첨부파일 구성

이진 파일을
MediationContext
에 삽입하려면 FTP 또는 SFTP 전송에서 파일을 검색하는
workday-in
에 대한 검색 서비스를 정의합니다.
메시지 본문을 생성한 다음
eval
단계를 사용하여 검색된 파일을 변수에 복사합니다. 이를 위해
da
문서 접근자 변수와
toVar
메서드를 사용할 수 있습니다. 예:
da.toVar(Rising_2011_Logo.jpg', 'wd.retrieve.variable')
.
복사
단계를 사용하여 에서 파일을 복사합니다.
wd.retrieve.variable
을 첨부파일에 추가합니다. 이렇게 하려면
Input
속성을
가변
으로 설정하고 다음을 지정합니다.
wd.retrieve.variable
을 입력 변수로 사용합니다.
출력
속성을
첨부파일
로 설정하십시오.
출력
첨부파일 인덱스를 로 지정하십시오.
0
출력
MIME 유형이
image/jpeg 입니다
.
마지막으로
이메일 전송
단계를 구성합니다.