다음을 통해 공유

SMTP 송신 포트를 구성하는 방법

  • 아티클

프로그래밍 방식으로 또는 BizTalk Server 관리 콘솔을 사용하여 SMTP 송신 포트를 구성할 수 있습니다.

자동으로 SMTP 송신 포트를 구성하는 방법

SMTP 어댑터는 구성 데이터베이스라고도 하는 BizTalk 관리 데이터베이스에 해당 구성 정보를 저장합니다. 구성 정보는 사용자 지정 XML PropertyBag에 저장됩니다. SMTP 어댑터 초기화 및 런타임 중에 서버는 다음과 같이 구성을 어댑터에 전달합니다.

  • SMTP 송신 처리기의 경우 구성 정보는 IPersistPropertyBag 인터페이스의 Load 메서드를 호출하여 어댑터로 전달됩니다.

  • SMTP 송신 어댑터의 경우 구성 정보가 메시지 컨텍스트의 속성 집합으로 어댑터에 전달됩니다. SMTP 네임스페이스는 이러한 속성을 그룹화합니다.

    BizTalk 탐색기 개체 모델은 송신 포트에 대해 TransportTypeData 읽기/쓰기 속성을 포함하는 ITransportInfo 어댑터 구성 인터페이스를 노출합니다. 이 속성은 이름/값 쌍 XML 문자열 형식의 SMTP 송신 포트 구성 속성 모음을 허용합니다. BizTalk Explorer 개체 모델에서 이 속성을 설정하려면 먼저 ITransportInfo 인터페이스의 Address 속성에서 설정해야 합니다.

    ITransportInfo 인터페이스의 TransportTypeData 속성을 설정할 필요는 없습니다. 설정되지 않은 경우 SMTP 송신 포트는 SMTP 송신 핸들러의 기본값을 사용합니다. SMTP 송신 포트와 관련된 속성은 SMTP 송신 어댑터 속성 schema bts_smtp_properties.xsd에서 정의됩니다.

    송신 핸들러 구성 속성을 복제하는 속성을 정의하지 않으면 핸들러의 구성 속성이 사용됩니다. 필요한 속성을 정의하지 않으면 기본값이 사용됩니다. 기본값을 정의하지 않으면 SMTP 송신 핸들러는 이벤트 로그에 오류를 기록하고 메시지를 백업 어댑터로 이동합니다.

    메시지 컨텍스트에 대해 프로그래밍 방식으로 이러한 속성을 설정할 수 있습니다. BizTalk 오케스트레이션 일정이나 사용자 지정 파이프라인 구성 요소에서 이러한 속성을 설정할 수 있습니다. 이러한 속성을 사용하는 경우 다음 규칙이 적용됩니다.

  • 오케스트레이션이나 수신 파이프라인의 사용자 지정 파이프라인 구성 요소에서 속성이 설정된 경우 다음 작업이 수행됩니다.

    • 메시지가 정적 송신 포트로 전송된 경우 해당 송신 포트에 대해 구성된 값이 속성 값을 덮어씁니다.

    • 메시지가 동적 송신 포트로 전송된 경우 속성 값을 덮어쓰지 않습니다.

  • 송신 파이프라인의 사용자 지정 파이프라인 구성 요소에서 속성이 설정된 경우 다음 작업이 수행됩니다.

    • 메시지가 정적 송신 포트로 전송되든, 동적 송신 포트로 전송되든 관계없이 값을 덮어쓰지 않습니다.

    다음 표는 BizTalk 탐색기 개체 모델에서 SMTP 송신 위치에 대해 설정할 수 있는 구성 속성을 보여 줍니다.

속성 이름 Type 설명 제한 의견
SMTPHost xs:string 메시지를 보내는 데 사용되는 SMTP 서버입니다. 최대 길이: 256 기본값: 비어 있습니다.

기본값을 지정하면 SMTP 송신 포트가 핸들러의 구성 값을 사용합니다.
From xs:string SMTP 전송 포트가 SMTP 보낸 사람 헤더에 배치하는 전자 메일 주소입니다. 최대 길이: 256 기본값: 비어 있습니다.

기본값을 지정하면 SMTP 송신 포트가 핸들러의 구성 값을 사용합니다.
CC xs:string 메시지 복사본을 보낼 전자 메일 주소입니다. 최대 길이: 1024 기본값: 비어 있음

여러 개의 전자 메일 주소를 나열할 수 있습니다.
Subject xs:string 메시지의 제목 헤더입니다. 최소 길이: 0

최대 길이: 256		 기본값: %MessageID%.
SMTPAuthenticate xs:int 사용할 인증 유형입니다. 없음 유효한 값은

- 0 - 인증 없음
- 1- 기본 인증
- 2 - 프로세스 계정(NTLM)

기본값을 지정하면 SMTP 송신 포트가 핸들러의 구성 값을 사용합니다. 기본값을 적용하려면 TransportTypeData 속성을 설정할 때 속성 모음에서 이 속성을 생략합니다.
UserName xs:string SMTP 서버 인증에 사용할 사용자 이름입니다. 최소 길이: 0

최대 길이: 256		 기본값: 비어 있음

SMTPAuthenticate가 1(기본 인증)과 같으면 값이 필요합니다.
암호 xs:string SMTP 서버 인증에 사용할 사용자 암호입니다. 최소 길이: 0

최대 길이: 256		 기본값: 비어 있음

SMTPAuthenticate가 1(기본 인증)과 같으면 값이 필요합니다.
ReadReceipt xs:boolean 이 송신 포트에서 보낸 메시지에 대해 읽음 확인을 요청합니다. 없음 기본값: False
DeliveryReceipt xs:boolean 이 송신 포트에서 보낸 메시지에 대해 배달 확인을 요청합니다. 없음 기본값: False
EmailBodyText xs:string 송신할 전자 메일 본문으로 사용할 텍스트를 지정합니다. 최대 길이: 64kb 기본값: 비어 있음
EmailBodyTextCharset xs:string EmailBodyText 옵션을 사용할 때 전송되는 전자 메일의 본문을 인코딩하는 데 사용할 문자 집합을 지정합니다. SMTP 어댑터는 EmailBodyText 를 EmailBodyTextCharset에 지정된 문자 집합으로 변환합니다. 없음 기본값: 없음 명시적으로 값을 설정해야 합니다(예: UTF-8).

값을 설정하지 않으면 이 항목의 끝에 있는 오류가 표시될 수 있습니다.
EmailBodyFile xs:string 전송되는 전자 메일 본문에 파일 내용을 사용하도록 지정하고 전체 파일 경로를 지정합니다. 런타임에 SMTP 어댑터 호스트가 이 경로에 액세스할 수 있어야 합니다. 최대 경로 길이: 256자 기본값: 비어 있음
EmailBodyFileCharset xs:string EmailBodyFile 속성이 설정된 경우 전송되는 전자 메일의 본문을 인코딩하는 데 사용할 문자 집합을 지정합니다. SMTP 어댑터는 파일에 대해 변환을 수행하지 않습니다. 파일이 이 문자 집합으로 이미 인코딩되어 있어야 합니다. 파일에 BOM(바이트 순서 표시)이 있으면 SMTP 어댑터가 BOM을 제거합니다. 없음 기본값: UTF-8(65001)
Attachments xs:string 파일이 전자 메일 메시지에 첨부되도록 지정하고 전체 파일 경로를 지정합니다. 런타임에 SMTP 어댑터 호스트가 지정한 경로에 액세스할 수 있어야 합니다. 최대 경로 길이: 256자 기본값: 비어 있음
MessagePartsAttachments xs:int BizTalk 메시지 파트가 전자 메일 메시지에 첨부되는 방식을 지정합니다. 없음 유효한 값은

- 0 - BizTalk 메시지 부분이 첨부 파일로 사용되지 않습니다.
- 1- BizTalk 메시지 본문 부분이 전자 메일 첨부 파일로 전송됩니다. 이 경우 EmailBodyFile 또는 EmailBodyText 속성을 지정해야 합니다. 이러한 속성을 지정하지 않으면 BizTalk 메시지 본문이 첨부 파일이 아니라 전자 메일 본문으로 전송됩니다.
- 2 - 모든 부분이 첨부 파일로 전송됩니다. 그러나 EmailBodyText 또는 EmailBodyFile 을 지정하지 않으면 BizTalk 메시지 본문 부분이 전자 메일 본문으로 전송되고 다른 부분은 첨부 파일로 전송됩니다.

기본값: 0
ReplyBy xs:dateTime 보내는 메시지의 Reply-By 헤더 필드를 지정된 값으로 채웁니다. 송신 포트 속성 페이지에서는 이 속성을 설정할 수 없습니다. 이 속성은 파이프라인 또는 오케스트레이션에서 설정할 수 있습니다. 기본값: 비어 있음

다음 코드는 이러한 속성을 설정하는 데 사용할 XML 문자열의 형식을 보여 줍니다.

<CustomProps>  
   <DeliveryReceipt vt="11">-1</DeliveryReceipt  
   <SMTPHost vt="8">sfdsadf</SMTPHost>  
   <Subject vt="8">Some subject</Subject>  
   <From vt="8">username@domain.com</From>  
   <SMTPAuthenticate vt="19">2</SMTPAuthenticate>  
   <ReadReceipt vt="11">-1</ReadReceipt>  
</CustomProps>

BizTalk Server 관리 콘솔을 사용하여 SMTP 송신 포트를 구성하는 방법

BizTalk Server 관리 콘솔에서 SMTP 송신 포트 어댑터 변수를 설정할 수 있습니다. 송신 포트의 속성이 설정되지 않은 경우 BizTalk Server 관리 콘솔에서 설정된 기본 송신 핸들러 값이 사용됩니다.

BizTalk Server 관리 콘솔을 사용하여 SMTP 송신 포트를 구성하려면 다음 절차를 사용합니다.

SMTP 송신 포트에 대한 변수를 구성하려면 다음을 수행하십시오.

  1. BizTalk Server 관리 콘솔에서 새 송신 포트를 만들거나 기존 송신 포트를 두 번 클릭하여 수정합니다. 자세한 내용은 송신 포트를 만드는 방법을 참조하세요. 모든 송신 포트 옵션을 구성하고 일반 탭의 전송 섹션에서 형식 옵션에 대해 SMTP를 지정합니다.

  2. 일반 탭의 전송 섹션에서 형식 옆에 있는 구성을 클릭합니다.

  3. SMTP 전송 속성 대화 상자의 일반 탭에서 다음을 수행합니다.

    사용 항목 원하는 작업
    수행할 작업 필수 사항입니다. 메시지를 보낼 전자 메일 주소를 지정합니다.

    주소를 두 개 이상 지정할 수 있습니다.

    최대 길이: 256

    이 속성에 대한 자세한 내용은 SMTP To 속성에 대한 제한을 참조하세요.
    CC 메시지 참조를 보낼 전자 메일 주소를 지정합니다.

    주소를 두 개 이상 지정할 수 있습니다.

    최대 길이: 1024
    Subject 메시지의 제목 헤더를 지정합니다.

    최소 길이: 0

    최대 길이: 256
    알림 배달 알림 유형을 지정합니다. 배달 유형 중 하나 또는 둘을 모두 선택할 수 있습니다. 배달 알림 유형은 다음과 같습니다.

    - 영수증을 읽습니다. 메시지를 읽으면 확인 전자 메일 메시지가 전송됩니다.
    - 배달 확인. 메시지를 배달하면 확인 전자 메일 메시지가 전송됩니다.

  4. SMTP 전송 속성 대화 상자의 작성 탭에서 다음을 수행합니다.

    사용 항목 원하는 작업
    BizTalk 메시지 본문 송신할 전자 메일 본문으로 BizTalk 메시지 본문을 사용하도록 지정합니다.
    Text 송신할 전자 메일 본문으로 사용할 텍스트를 지정합니다. 텍스트 옵션을 선택한 후 텍스트 상자에 전자 메일 본문의 텍스트를 입력할 수 있습니다.

    최대 길이: 64Kb
    텍스트의 문자 집합 - 전송되는 전자 메일의 본문을 인코딩하는 데 사용할 문자 집합을 지정합니다. 이 옵션은 텍스트 옵션을 선택한 경우에만 사용할 수 있습니다.
    - 기본값: UTF-8 (65001)
    최근에 사용한 파일 송신할 전자 메일 본문에 파일 내용을 사용하도록 지정하고 해당 파일 경로를 지정합니다. 파일 옵션을 선택한 후 줄임표(...) 단추를 클릭하여 파일을 찾아볼 수 있습니다.

    최대 경로 길이: 256자 참고: 프로덕션에서 사용할 BizTalk Server 그룹의 모든 BizTalk 서버에서 액세스할 수 있는 파일 공유의 경로를 지정하는 것이 좋습니다.
    파일의 문자 집합 송신할 파일의 문자 집합 인코딩을 지정합니다. 참고: SMTP 어댑터는 지정된 인코딩을 파일에 적용하지 않습니다. 이 옵션은 전송되는 파일이 이미 인코딩된 방식을 지정하는 데만 사용됩니다.

    이 옵션은 파일 옵션을 선택한 경우에만 사용할 수 있습니다.

    기본값: UTF-8(65001)

  5. SMTP 전송 속성 대화 상자의 첨부 파일 탭에서 다음을 수행합니다.

    사용 항목 원하는 작업
    Remaining BizTalk message parts 전자 메일 메시지에 BizTalk 메시지 본문을 첨부하는 방법을 지정합니다.

    옵션:

    - 부품 연결 안 함
    - 본문 부분만 연결
    - 모든 부품 연결

    기본값: 파트를 연결하지 마세요.
    추가 전자 메일 메시지에 첨부할 파일을 지정합니다. 추가를 클릭한 후 파일을 찾아 첨부할 파일 목록에 추가할 수 있습니다.

    최대 경로 길이: 256자 참고: 프로덕션에 사용할 BizTalk Server 그룹의 모든 BizTalk 서버에서 액세스할 수 있는 파일 공유의 경로를 지정하는 것이 좋습니다.
    제거 전자 메일 메시지에 첨부될 파일 목록에서 선택한 파일을 제거합니다.

  6. SMTP 전송 속성 대화 상자의 처리기 재정의 탭에서 다음을 수행합니다.

    사용 항목 원하는 작업
    SMTP 서버 이름 메시지를 보낼 때 사용할 SMTP 서버 이름을 지정합니다.

    최대 길이: 256 참고: 송신 포트 또는 수신 위치의 URI는 256자를 초과할 수 없습니다.
    보낸 사람(전자 메일 주소) SMTP 보낸 사람의 머리글에 배치할 전자 메일 주소를 지정합니다.

    최대 길이: 256
    인증 유형 SMTP 서버에 사용할 인증 유형을 지정합니다.

    옵션:

    - (기본값)
    - 인증 없음
    - 기본 인증
    - 프로세스 계정(NTLM)

    기본값은 선택하면 SMTP 송신 포트가 송신 핸들러에 지정된 구성 값을 사용합니다.
    사용자 이름 SMTP 서버 인증에 사용할 사용자 이름을 지정합니다.

    인증 유형이 기본 인증인 경우 이 속성에 값이 필요합니다.

    최소 길이: 0

    최대 길이: 256
    암호 SMTP 서버 인증에 사용할 암호를 지정합니다.

    인증 유형이 기본 인증인 경우 이 속성에 값이 필요합니다.

    최소 길이: 0

    최대 길이: 256

  7. 확인을 클릭하고 확인을 다시 클릭하여 설정을 저장합니다.

참고 항목

SMTP 어댑터 구성