Office 365 Outlook Email 어댑터를 사용하여 전자 메일 보내기 및 받기 - BizTalk Server

아티클
05/04/2023

Office 365 Outlook Email 어댑터를 사용하면 BizTalk에서 Office 365 Outlook Email 메일을 보내고 받을 수 있습니다.

송신 포트를 사용하여 메일 보내기

BizTalk Server 관리 콘솔에서 포트 보내기를 마우스 오른쪽 단추로 클릭하고 새로 만들기를 선택한 다음 정적 단방향 송신 포트를 선택합니다.

송신 포트 만들기는 몇 가지 지침을 제공합니다.
이름을 입력합니다. 전송에서 형식을 Outlook Email Office 365 설정하고 구성을 선택합니다.
로그인 ...을 선택하고 Office 365 계정에 로그인합니다. 계정이 전자 메일 주소로 자동 채워집니다.
액세스 권한에 대한 BizTalk Server 승인 허용:
Office 365 Outlook Email 일반 속성을 구성합니다.
- 받는 방법: 기본 메일 주소를 ';'로 구분하여 입력합니다. (최대 256자)
- CC: 기본 CC 메일 주소를 ';'로 구분하여 입력합니다. (최대 256자)
- 제목: 기본 메일 제목을 언급합니다. (최대 256자)
- 중요도: 중요도 값을 선택합니다. 드롭다운에는 Low, Normal 및 High 값이 포함되며 Normal 은 기본값입니다.
완료되면 속성은 다음과 유사하게 표시됩니다.
Office 365 Outlook Email 첨부 파일 속성을 구성합니다.

전송되는 전자 메일의 본문은 BizTalk 메시지의 본문 부분에 해당합니다. 전자 메일에 첨부 파일을 추가하려면 다음을 수행합니다.
- BizTalk 메시지 파트 연결: 선택한 경우 BizTalk 메시지 비 본문 부분이 전송된 전자 메일에 첨부 파일로 추가됩니다.
- 파일: 파일 또는 파일이 전자 메일 메시지와 파일 또는 파일의 전체 경로에 첨부되도록 지정합니다. 지정된 경로 또는 경로는 런타임에 어댑터의 호스트에 액세스할 수 있어야 합니다. 기본값: 비어 있습니다.
일부 파일을 선택한 후 첨부 파일 속성은 다음과 유사하게 표시됩니다.
확인을 선택하여 변경 내용을 저장합니다.

중요 세부 정보

기본 속성은 승격된 속성을 사용하여 업데이트할 수도 있습니다.

속성 이름 승격 속성

수행할 작업 OfficeMail.To

CC OfficeMail.CC

Subject OfficeMail.Subject

중요도 OfficeMail.Importance

첨부 파일 OfficeMail.AttachedFiles
OfficeMail.AttachedFiles 속성 값은 서로 다른 파일 사이에 구분 기호로 "|"가 있는 파일의 목록입니다. instance 경우: "C:\Attachments\File1.pdf|C:\Attachments\File2.xml".
BizTalk 메시지 본문 부분의 ContentType 속성을 "텍스트" 또는 "Html"로 설정하여 전자 메일 본문의 형식을 나타낼 수 있습니다. 기본적으로 "텍스트"입니다.
다중 파트 BizTalk 메시지의 파트가 연결되면 파트의 ContentType 속성이 제공된 경우 만든 첨부 파일의 MIME 형식으로 사용됩니다. 기본적으로 첨부 파일의 MIME 형식은 "application/octet-stream"으로 설정됩니다.
파일을 첨부할 때 첨부 파일의 MIME 형식은 파일 이름 확장명에서 결정됩니다. 기본 MIME 형식은 "application/octet-stream"입니다.

속성 이름	승격 속성
수행할 작업	OfficeMail.To
CC	OfficeMail.CC
Subject	OfficeMail.Subject
중요도	OfficeMail.Importance
첨부 파일	OfficeMail.AttachedFiles

송신 포트 테스트

간단한 파일 수신 포트 및 위치를 사용하여 Office 365 Outlook Email 메시지를 보낼 수 있습니다.

파일 어댑터를 사용하여 수신 포트를 만듭니다. 수신 위치 내에서 Receive 폴더 를 C:\Temp\In\로 설정하고 파일 마스크를 *.xml로 설정합니다.
Office 365 Outlook Email 어댑터 송신 포트 속성에서 필터를 로 BTS.ReceivePortName == <Receive Port Name>설정합니다.

다음을 텍스트 편집기에 붙여넣고 파일을 Office365Mail.xml저장합니다. 샘플 메시지입니다.

<ns0:Root xmlns:ns0="http://BizTalk_Server_Project1.Schema1"> 
    <Record> 
        <Name>BizTalk User</Name> 
        <ID>001</ID> 
    </Record> 
</ns0:Root>

파일 수신 위치 및 Office 365 Outlook Email 어댑터 송신 포트를 시작합니다.
Office365Mail.xml 샘플 메시지를 수신 폴더(C:\Temp\In\)에 복사합니다. 송신 포트는 XML 파일을 Office 365 Outlook Email 메일 본문으로 보냅니다. 포트 구성의 첨부 파일 탭에 지정된 파일이 전자 메일에 첨부됩니다.

송신 처리기의 추가 구성

BizTalk Server 2020 누적 업데이트 4부터 사용할 수 있습니다.

Office 365 Outlook Email 어댑터가 호스트 instance 모든 송신 포트에서 한 번에 보내는 최대 전자 메일 수를 조정할 수 있습니다. 이 값은 기본적으로 20으로 설정되며 Office 365 Outlook Email 어댑터의 송신 처리기 속성에서 최대 동시 송신 속성을 설정하여 변경할 수 있습니다.

BizTalk Server 관리 콘솔에서 BizTalk Server 관리, BizTalk 그룹, 플랫폼 설정을 차례로 확장한 다음 어댑터를 확장합니다.
확장된 어댑터 목록에서 Office365 Outlook Email 클릭합니다.
오른쪽 창에서 구성할 송신 처리기를 마우스 오른쪽 단추로 클릭한 다음 속성을 클릭합니다.
최대 동시 전송 속성을 설정합니다.
확인을 선택하여 변경 내용을 저장합니다.

수신 포트를 사용하여 전자 메일 받기

BizTalk Server 관리 콘솔에서 수신 포트를 마우스 오른쪽 단추로 클릭하고 새로 만들기를 선택한 다음 단방향 수신 포트를 선택합니다.

수신 포트 만들기는 몇 가지 지침을 제공합니다.
이름을 입력하고 수신 위치를 선택합니다.
새로 만들기를 선택하고 수신 위치의 이름을 지정합니다. 전송의 유형 드롭다운 목록에서 Office 365 Outlook Email 선택한 다음 구성을 선택합니다.
로그인 ...을 선택하고 Office 365 계정에 로그인합니다. 계정이 전자 메일 주소로 자동 채워집니다.
액세스 권한에 대한 BizTalk Server 승인 허용:
엔드포인트 일반 속성을 구성합니다.
- 폴더: 전자 메일을 받을 폴더를 선택합니다. 기본 폴더는 받은 편지함입니다. 폴더는 본질적으로 재귀적이지 않습니다. 예를 들어 하위 폴더의 전자 메일은 검색되지 않습니다.
- 시작: Office 365 전자 메일을 받는 방법을 입력합니다. 이 값은 Office 365 Outlook에 있는 전자 메일의 receivedTimeStamp를 나타냅니다. Email 입력한 값보다 더 최근입니다.
- 읽지 않은 메일만: 읽지 않은 전자 메일만 읽도록 확인합니다. 모든 전자 메일을 읽도록 선택 취소된 상태로 유지합니다.
- 게시 작업: 전자 메일을 읽은 후 수행할 게시물 작업을 선택합니다. None 은 기본값이며 BizTalk에서 전자 메일을 받은 후에는 아무 것도 수행하지 않습니다. 읽은 것으로 표시 하면 BizTalk에서 전자 메일을 받은 후 사서함의 전자 메일이 읽은 것으로 표시됩니다. 삭제 는 BizTalk에서 전자 메일을 받은 후 사서함의 전자 메일이 삭제됨을 의미합니다. 사후 작업은 최선을 다해 수행됩니다.
완료되면 속성은 다음과 유사하게 표시됩니다.
엔드포인트 페이로드 속성을 구성합니다(BizTalk Server 2020 이상부터 사용 가능).
- MIME 전달: 전자 메일의 MIME 표현을 저장합니다. MIME 콘텐츠에는 전자 메일 본문 및 모든 첨부 파일이 포함됩니다.
- 콘텐츠 처리: 전자 메일 본문을 저장합니다. 기본적으로 선택됩니다. 전자 메일 본문의 콘텐츠 형식은 만든 BizTalk 메시지의 ContentType 속성에 저장됩니다.
- 첨부 파일 포함: BizTalk 메시지의 일부로 전자 메일 첨부 파일을 저장합니다. 기본적으로 선택 취소되어 있습니다. 각 BizTalk 메시지 파트에는 ContentType 속성이 첨부 파일의 MIME 형식으로 설정됩니다. Outlook 항목(전자 메일, 일정 이벤트, 연락처)인 첨부 파일은 해당 MIME 표현에 저장됩니다.
완료되면 속성은 다음과 유사하게 표시됩니다.
확인을 선택하여 변경 내용을 저장합니다.

수신 설정 테스트

간단한 파일 보내기 포트를 사용하여 Office 365 Outlook Email 메시지를 받을 수 있습니다.

파일 어댑터를 사용하여 송신 포트를 만듭니다. 송신 포트 속성 내에서 대상 폴더 를 C:\Temp\Out\으로 설정하고 및 파일 이름을%MessageID%.xml로 설정합니다.
파일 송신 포트 속성에서 필터BTS.ReceivePortName == <Receive Port Name>를 로 설정합니다.
Office 365 Outlook Email 수신 위치 및 파일 보내기 포트를 시작합니다.
대상 폴더(c:\temp\out)에서 메시지를 찾습니다.

수신 파이프라인에서 승격된 속성

수신 파이프라인의 다음 속성은 기본적으로 승격됩니다.

속성 이름	승격 속성
중요도	OfficeMail.ReceivedMailImportance
Subject	OfficeMail.ReceivedMailSubject
SenderName	OfficeMail.SenderName
SenderAddress	OfficeMail.SenderAddress
HasAttachments	OfficeMail.HasAttachments

다음 단계

모든 Office 365 어댑터를 참조하세요.

Share via