SendMail

發行項
10/14/2023

SendMail 範例示範如何使用 Simple Mail Transfer Protocol (SMTP) 配接器，從 Microsoft BizTalk Server 協調流程內傳送電子郵件訊息。用來傳送電子郵件訊息的動態資訊，會使用以屬性升級功能從 XML 訊息擷取。

此範例的用途

此範例會依下列步驟順序，從內送 XML 訂單 (PO) 訊息升級而來的屬性取得資訊，再使用該項資訊傳送電子郵件訊息：

BizTalk Server 協調流程擷取輸入 XML PO 訊息。
BizTalk Server協調流程會提升PONumber和Email屬性，以便日後更容易存取。
BizTalk Server 協調流程使用升級屬性的值來設定動態傳送埠的目的地址和電子郵件訊息的主旨。
BizTalk Server 協調流程透過 SMTP 配接器傳送所建構的電子郵件訊息。

可在何處找到此範例

<範例路徑>\AdaptersUsage\SendMail\

下表顯示此範例中的檔案，並描述其用途。

檔案	Description
AssemblyInfo.cs, SendMail.btproj, SendMail.sln	提供此範例的專案、解決方案和組件資訊檔案。
Cleanup.bat	從全域組件快取 (GAC) 解除部署並移除組件；移除傳送和接收埠；視需要移除 Microsoft Internet Information Services (IIS) 虛擬目錄。
PropertySchema.xsd, PurchaseOrder.xsd	分別針對您要升級的屬性和 XML PO 訊息提供結構描述。
ReceiveSend.odx	提供 BizTalk Server 協調流程，以處理內送 XML PO 訊息，並根據訊息內的資訊傳送電子郵件訊息。
SendMailInput.xml	包含範本輸入檔，其中包含使用 XML 指定的訂單。
Setup.bat	建置並初始化此範例。注意：此安裝程式檔案會使用與 SDK 範例大部分的安裝程式檔案不同的機制來建立和系結埠等等。並不需要附贈 .xml 檔案。

若要建置並初始化這個範例

在命令視窗中，瀏覽至下列資料夾：

<範例路徑>\AdaptersUsage\SendMail
執行檔案 Setup.bat，這會執行下列動作：
- 為此範例建立下列輸入資料夾：
  
  <範例路徑>\AdaptersUsage\SendMail\In
- 編譯此範例的 Visual Studio 專案。
- 啟動 BizTalk Server 協調流程。
  
  注意
  
  在嘗試執行此範例之前，您必須確認 BizTalk 沒有在建置和初始化的程序中報告任何錯誤。
  
  注意
  
  如果您在此範例中選擇開啟並建置專案，而不執行檔案 Setup.bat，必須先使用 .NET Framework Strong Name Utility (sn.exe) 建立強式名稱金鑰組。請使用這個金鑰組來簽署產生的組件。
  
  注意
  
  若要復原 Setup.bat 所進行的變更，請執行 Cleanup.bat 並刪除所有前置詞為 SendMail_1.0.0.0_Microsoft.Samples.BizTalk.SendMail 的接收埠和傳送埠。您必須先執行 Cleanup.bat 才能再度執行 Setup.bat。
在BizTalk Server 管理主控台中，找出前置詞為 SendMail_1.0.0.0_Microsoft.Samples.BizTalk.SendMail 的接收埠。更新此接收埠的接收位置，以指向檔案系統上做為輸入位置的目錄。
使用記事本之類的程式，修改檔案 SendMailInput.xml，讓Email元素指定您想要接收此範例所產生之電子郵件訊息的合法電子郵件地址。
按一下[開始]，指向 [程式]，指向[Microsoft BizTalk Server 20xx]，然後按一下[BizTalk Server系統管理]。
在BizTalk Server 管理主控台中，展開 [BizTalk 群組] 樹狀結構。
展開左窗格中的 [ 平臺設定 ] 樹狀結構。
展開 [ 配接器] 資料夾，按一下 [SMTP ] 節點，然後按兩下右窗格中的 [SMTP 配接器] 列。
在 [ SMTP - 配接器處理常式屬性 ] 對話方塊中，按一下 [ 屬性]。
在 [ SMTP 傳輸屬性 ] 對話方塊的 [ 屬性 ] 索引標籤上，提供 SMTP 伺服器名稱和[從] (電子郵件地址) 屬性的適當值，然後按一下 [ 確定]。

透過此 SMTP 配接器傳送的任何電子郵件訊息，都是使用這些值來建構寄件者電子郵件地址。

注意

若您需要驗證 SMTP 伺服器，必須確保寄件者電子郵件地址的所屬帳號與驗證所用的帳戶相同。
請停止再重新啟動 BizTalk 服務 ( BizTalkServerApplication )，協調流程才會採用這些變更。

執行此範例

將修改後之 SendMailInput.xml 檔案的複本放在 [輸入] 資料夾中。
請觀察您在上一個程序中指定的電子郵件地址是否接收到電子郵件訊息。

另請參閱

配接器範例 - 用法

共用方式為