英語で読む

次の方法で共有


SendMail

SendMail サンプルは、簡易メール転送プロトコル (SMTP) アダプタを使用して、Microsoft BizTalk Server オーケストレーションから電子メール メッセージを送信する方法を示します。 電子メール メッセージの送信に使用される動的な情報は、プロパティの昇格機能を使用して XML メッセージから取得します。

このサンプルの処理

このサンプルでは、次の一連の手順を使用して、受信 XML 発注書 (PO) メッセージから昇格されたプロパティから取得した情報を使用して電子メール メッセージを送信します。

  1. BizTalk Server オーケストレーションが、受信 XML PO メッセージを取得します。

  2. BizTalk Server オーケストレーションは、PONumber プロパティと Email プロパティを昇格させ、将来的にアクセスしやすくします。

  3. BizTalk Server オーケストレーションは、昇格されたプロパティの値を使用して、動的送信ポートの送信先アドレス、および電子メール メッセージの件名を設定します。

  4. BizTalk Server オーケストレーションは、SMTP アダプタを使用して、構築された電子メール メッセージを送信します。

このサンプルの場所

<サンプル パス>\AdaptersUsage\SendMail\

次の表は、このサンプルのファイルとその目的を示しています。

ファイル 説明
AssemblyInfo.cs、SendMail.btproj、SendMail.sln このサンプルのプロジェクト ファイル、ソリューション ファイル、およびアセンブリ情報ファイルを提供します。
Cleanup.bat 必要に応じて、アセンブリの展開の解除とグローバル アセンブリ キャッシュ (GAC) からのアセンブリの削除、送信および受信ポートの削除、Microsoft インターネット インフォメーション サービス (IIS) の仮想ディレクトリの削除などを行います。
PropertySchema.xsd、PurchaseOrder.xsd 昇格するプロパティのスキーマ、および XML PO メッセージのスキーマを提供します。
ReceiveSend.odx 受信 XML PO メッセージを処理し、メッセージの情報に基づいて電子メール メッセージを送信する BizTalk Server オーケストレーションを提供します。
SendMailInput.xml XML を使用して PO を指定したサンプル入力ファイルが含まれています。
Setup.bat このサンプルを作成および初期化します。 メモ: このセットアップ ファイルでは、SDK サンプルのほとんどのセットアップ ファイルとは異なるメカニズムを使用して、ポートの作成とバインドなどを行います。 companion .xml ファイルは必要ありません。

このサンプルを作成および初期化するには

  1. コマンド ウィンドウで、次のフォルダーに移動します。

    <サンプル パス>\AdaptersUsage\SendMail

  2. 次のアクションを実行するファイル Setup.bat を実行します。

    • このサンプルの次の入力フォルダを作成します。

      <サンプル パス>\AdaptersUsage\SendMail\In

    • このサンプルの Visual Studio プロジェクトをコンパイルします。

    • BizTalk Server オーケストレーションを開始します。

      注意

      このサンプルを実行する前に、BizTalk がビルド プロセス中および初期化プロセス中にエラーを報告していないことを確認してください。

      注意

      Setup.bat ファイルを実行せずに、このサンプルのプロジェクトを開いてビルドする場合は、最初に .NET Framework の厳密名ユーティリティ (sn.exe) を使用して、厳密な名前のキー ペアを作成する必要があります。 このキー ペアを使用して、結果のアセンブリに署名します。

      注意

      Setup.bat による変更を元に戻すには、Cleanup.bat を実行し、SendMail_1.0.0.0_Microsoft.Samples.BizTalk.SendMail で始まるすべての受信ポートと送信ポートを削除します。 Setup.bat を 2 回目に実行する場合は、その前に Cleanup.bat を実行してください。

  3. BizTalk Server管理コンソールで、SendMail_1.0.0.0_Microsoft.Samples.BizTalk.SendMail でプレフィックスが付いた受信ポートを見つけます。 この受信ポートの受信場所を更新して、ファイル システムのディレクトリをポイントし、入力場所に使用します。

  4. メモ帳などのプログラムを使用して、Email要素で、このサンプルによって生成された電子メール メッセージを受信する正当な電子メール アドレスを指定するように、ファイル SendMailInput.xml を変更します。

  5. [スタート] ボタンをクリックし、[プログラム] をポイントし、[Microsoft BizTalk Server 20xx] をポイントして、[BizTalk Server管理] をクリックします。

  6. BizTalk Server管理コンソールで、BizTalk グループ ツリーを展開します。

  7. 左側のウィンドウで [ プラットフォーム設定] ツリーを展開します。

  8. [アダプター] フォルダーを展開し、[SMTP] ノードをクリックし、右側のウィンドウで [SMTP アダプター] 行をダブルクリックします。

  9. [ SMTP - アダプター ハンドラーのプロパティ ] ダイアログ ボックスで、[ プロパティ] をクリックします。

  10. [ SMTP トランスポートのプロパティ ] ダイアログ ボックスの [ プロパティ ] タブで、 SMTP サーバー名 と差出人 (電子メール アドレス) プロパティに適切な値を指定し、[OK] をクリック します

    これらの値を使用して、この SMTP アダプタから送信するすべての電子メール メッセージの差出人の電子メール アドレスを構築します。

    注意

    SMTP サーバーで認証する必要がある場合は、差出人の電子メール アドレスが、認証に使用するアカウントと同じアカウントに所属していることを確認する必要があります。

  11. BizTalk サービス (BizTalkServerApplication) を停止してから再起動し、オーケストレーションがこれらの変更を採用するようにします。

このサンプルを実行するには

  1. 変更した SendMailInput.xml ファイルを入力フォルダーにコピーします。

  2. 電子メール メッセージが、前の手順で指定した電子メール メッセージに届くことを確認します。

参照

アダプタ サンプル – 使用法