使用 Outlook Office 365 Email 配接器傳送和接收電子郵件 - BizTalk Server

發行項
07/21/2023

Office 365 Outlook Email 配接器可讓您從 BizTalk 傳送和接收來自 BizTalk Office 365 Outlook Email的郵件。

使用傳送埠傳送郵件

在 BizTalk Server 管理主控台中，以滑鼠右鍵按一下 [傳送埠]，選取 [新增]，然後選取 [靜態單向傳送埠]。

建立傳送埠提供一些指引。
輸入 [名稱] 。在[傳輸] 中，將[類型] 設定為[Office 365 Outlook Email]，然後選取 [設定]。
選取[登入...]，然後登入您的Office 365帳戶。帳戶會自動填入您的電子郵件地址。
允許BizTalk Server核准存取權：
設定 Office 365 Outlook Email一般屬性：
- 收件者：輸入預設的 [收件者位址] 以 ';' 分隔 (256 個字元上限)
- CC：輸入以 ';' 分隔的預設 CC 郵寄地址， (256 個字元上限)
- 主旨：提及您的預設郵件主旨。 (最多 256 個字元)
- 重要性：選取 [重要性] 的值。下拉式清單包含[低]、[標準] 和 [高] 值，而[一般] 為預設值。
完成後，您的屬性看起來會類似下列內容：
設定 Outlook Email Attachments屬性Office 365：

所傳送電子郵件的本文會對應至 BizTalk 訊息的本文部分。若要將附件新增至電子郵件，請執行下列動作：
- 附加 BizTalk 訊息元件：如果核取，BizTalk 訊息非內文元件會新增為傳送電子郵件的附件。
- 檔案：指定檔案或檔案會附加至電子郵件訊息，以及檔案或檔案的完整路徑。指定的路徑或路徑在執行時間必須可供主機存取。預設值：空白。
選取某些檔案之後，附件屬性看起來會類似下列內容：
選取 [確定 ] 以儲存您的變更。

重要詳細資料

預設屬性也可以使用升級的屬性來更新：

屬性名稱	升級屬性
若要	OfficeMail.To
副本	OfficeMail.CC
主體	OfficeMail.Subject
重要性	OfficeMail.Importance
附加的檔案	OfficeMail.AttachedFiles

OfficeMail.AttachedFiles屬性值是不同檔案之間具有「|」做為分隔符號的檔案清單。例如：「C:\Attachments\File1.pdf|C:\Attachments\File2.xml」。
BizTalk 訊息本文元件的 ContentType 屬性可以設定為「Text」或「Html」，以指出電子郵件內文的類型。根據預設，它會是「Text」。
附加多部分 BizTalk 訊息的元件時，如果提供，則會使用元件的 ContentType 屬性做為所建立附件的 MIME 類型。根據預設，附件的 MIME 類型會設定為「application/octet-stream」。
附加檔案時，會從副檔名決定附件的 MIME 類型。預設 MIME 類型為「application/octet-stream」。

測試傳送埠

您可以使用簡單的檔案接收埠和位置，將訊息傳送至Office 365 Outlook Email。

使用檔案配接器建立接收埠。在您的接收位置內，將 [接收] 資料夾 設定為 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配接器一次在主機實例中所有傳送埠上傳送的電子郵件數目上限。此值預設會設定為 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接收電子郵件的方式。這個值表示 Outlook Office 365電子郵件的 receivedTimeStamp。 Email最近收到輸入的值。
- 僅限未讀取的郵件：核取此選項以唯讀未讀取的電子郵件。將其保持未核取狀態，以讀取所有電子郵件。
- Post Action：選取在讀取電子郵件之後要執行的張貼動作。 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
主體	OfficeMail.ReceivedMailSubject
SenderName	OfficeMail.SenderName
SenderAddress	OfficeMail.SenderAddress
HasAttachments	OfficeMail.HasAttachments

下一步

查看所有Office 365配接器。

共用方式為