Office 365 Outlook 電子メール アダプターを使用して電子メールを送受信する - BizTalk Server

Office 365 Outlook 電子メール アダプターを使用すると、BizTalk から Office 365 Outlook メールからメールを送受信できます。

送信ポートを使用してメールを送信する

1. BizTalk Server 管理コンソールで、[ 送信ポート] を右クリックし、[ 新規] を選択して、[ 静的一方向送信ポート] を選択します。

   送信ポートを作成すると、 いくつかのガイダンスが提供されます。

2. 名前を入力します。 トランスポートで、種類を Office 365 Outlook メールに設定し、[構成] を選択します。

3. [ サインイン...] を選択し、Office 365 アカウントにサインインします。 アカウントには、メール アドレスが自動的に入力されます。

4. BizTalk Server によるアクセス許可の承認を許可します。

   

5. Office 365 Outlook 電子メール 全般 プロパティを構成します。

   • To: 既定の To メール アドレスを ';' で区切って入力します。(最大 256 文字)
   • CC: 既定の CC メール アドレスを ';' で区切って入力します(最大 256 文字)
   • 件名: 既定のメールの件名をメンションします。 (最大 256 文字)
   • [重要度]: [重要度] の値を選択します。 ドロップダウンには、 値 Low、 Normal、 High が含まれており、 Normal が既定値です。

   完了すると、プロパティはこのような見た目になります。

   

6. Office 365 Outlook の メール添付ファイルのプロパティを構成します 。

   送信される電子メールの本文は、BizTalk メッセージの本文部分に対応します。 メールに添付ファイルを追加するには、次の操作を行います。

   • BizTalk メッセージ パーツの添付: オンにすると、BizTalk メッセージの本文以外のパーツが、送信されたメールの添付ファイルとして追加されます。
   • ファイル: ファイルまたはファイルを電子メール メッセージに添付し、ファイルまたはファイルの完全なパスを指定します。 指定したパスは、実行時にアダプターのホストからアクセスできる必要があります。 既定値: 空。

   一部のファイルを選択すると、添付ファイルのプロパティは次のようになります。

   

7. [ OK] を 選択して変更を保存します。

重要な詳細

1. 既定のプロパティは、昇格されたプロパティを使用して更新することもできます。

   プロパティ名	推奨された物件
   から へ	OfficeMail.To
   CC	OfficeMail.CC
   件名	OfficeMail.件名
   重要度	OfficeMail.Importance
   添付ファイル	OfficeMail.添付ファイル

2. OfficeMail.AttachedFiles プロパティの値は、異なるファイル間の区切り記号として "|" を持つファイルの一覧です。 例: "C:\Attachments\File1.pdf|C:\Attachments\File2.xml".

3. BizTalk メッセージ本文パーツの ContentType プロパティを "Text" または "Html" に設定して、メール本文の種類を示すことができます。 既定では、"Text" になります。

4. マルチパート BizTalk メッセージの一部が添付されると、パーツの ContentType プロパティが指定されている場合は、作成された添付ファイルの MIME の種類として使用されます。 既定では、添付ファイルの MIME の種類は "application/octet-stream" に設定されます。

5. ファイルを添付する場合、添付ファイルの MIME の種類はファイル名拡張子から決定されます。 既定の MIME の種類は "application/octet-stream" です。

送信ポートをテストする

単純なファイル受信ポートと場所を使用して、Office 365 Outlook メールにメッセージを送信できます。

1. ファイル アダプターを使用して受信ポートを作成します。 受信場所内で、 受信フォルダー を C:\Temp\In\ に設定し、ファイル マスクを *.xmlに設定します。

2. Office 365 Outlook 電子メール アダプターの送信ポートのプロパティで、[ フィルター] を [ BTS.ReceivePortName == <Receive Port Name>に設定します。

3. 次をテキスト エディターに貼り付け、ファイルを Office365Mail.xmlとして保存します。 これがサンプル メッセージです。

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

4. ファイルの受信場所と Office 365 Outlook 電子メール アダプターの送信ポートを開始します。

5. サンプル メッセージ Office365Mail.xml 受信フォルダー (C:\Temp\In\) にコピーします。 送信ポートは、XML ファイルをメール本文として Office 365 Outlook メールに送信します。 ポート構成の [添付ファイル] タブで指定されたファイルは、電子メールに添付されます。

送信ハンドラーの追加の構成

BizTalk Server 2020 累積的な更新プログラム 4 以降で使用できます。

Office 365 Outlook 電子メール アダプターがホスト インスタンス内のすべての送信ポートで一度に送信するメールの最大数を調整できます。 この値は既定で 20 に設定され、Office 365 Outlook 電子メール アダプターの送信ハンドラー プロパティで 最大同時送信 プロパティを設定することで変更できます。

1. BizTalk Server 管理コンソールで、[BizTalk Server 管理] を展開し、[BizTalk グループ]、[プラットフォームの設定] の順に展開し、[アダプター] を展開します。

2. 展開されたアダプターの一覧で、[Office365 Outlook メール] をクリックします。

3. 右側のウィンドウで、構成する送信ハンドラーを右クリックし、[プロパティ] をクリックします。

   

4. 最大同時送信プロパティを設定します。

   

5. [ OK] を 選択して変更を保存します。

受信ポートを使用して電子メールを受信する

1. BizTalk Server 管理コンソールで、[ 受信ポート] を右クリックし、[ 新規] を選択して、 受信ポートOne-Way 選択します。

   受信ポートを作成すると、 いくつかのガイダンスが提供されます。

2. 名前を入力し、[ 受信場所] を選択します。

3. [ 新規] を選択し、受信場所に 名前を付 けます。 トランスポートで、[種類] ドロップダウン リストから [Office 365 Outlook メール] を選択し、[構成] を選択します。

4. [ サインイン...] を選択し、Office 365 アカウントにサインインします。 アカウントには、メール アドレスが自動的に入力されます。

5. BizTalk Server によるアクセス許可の承認を許可します。

   

6. エンドポイントの [全般] プロパティを構成します。

   • フォルダー: メールを受け取るフォルダーを選択します。 既定のフォルダーは受信トレイです。 フォルダーは本質的に再帰的ではありません。 たとえば、サブフォルダーからのメールは取得されません。
   • 開始: Office 365 からメールを受信する方法を入力します。 この値は、Office 365 Outlook のメールの receivedTimeStamp を示します。 入力した値よりも新しいメールが受信されます。
   • 未読メールのみ: 未読メールのみを読み取る場合は、このチェック をオンにします。 すべてのメールを読むにはオフのままにします。
   • 投稿アクション: メールの読み取り後に実行する投稿アクションを選択します。 既定値は None で、BizTalk で電子メールを受信した後は何も行われません。 開封済みとしてマーク すると、BizTalk によって電子メールが受信されると、メールボックス内の電子メールは開封済みとしてマークされます。 削除 は、BizTalk によって電子メールが受信された後、メールボックス内の電子メールが削除されることを意味します。 投稿アクションはベスト エフォートベースで実行されます。

   完了すると、プロパティはこのような見た目になります。

   

7. エンドポイント ペイロード のプロパティ (BizTalk Server 2020 以降で使用可能) を構成します。

   • MIME の配信: メールの MIME 表現を保存します。 MIME コンテンツには、電子メール本文とすべての添付ファイルが含まれます。
   • コンテンツの処理: 電子メール本文を保存します。 既定で選択されています。 電子メール本文のコンテンツ タイプは、作成された BizTalk メッセージの ContentType プロパティに保存されます。
   • 添付ファイルを含める: メールの添付ファイルを BizTalk メッセージの一部として保存します。 既定ではオフになっています。 各 BizTalk メッセージ パーツには、添付ファイルの MIME の種類に ContentType プロパティが設定されています。 Outlook アイテム (メール、予定表イベント、連絡先) である添付ファイルは、MIME 表現に保存されます。

   完了すると、プロパティはこのような見た目になります。

   

8. [ OK] を 選択して変更を保存します。

受信設定をテストする

単純なファイル送信ポートを使用して、Office 365 Outlook メールからメッセージを受信できます。

1. ファイル アダプターを使用して送信ポートを作成します。 送信ポートのプロパティ内で、 宛先フォルダー を C:\Temp\Out\ に設定し、 ファイル名 を %MessageID%.xmlに設定します。
2. ファイル送信ポートのプロパティで、[ フィルター] を BTS.ReceivePortName == <Receive Port Name>に設定します。
3. Office 365 Outlook メールの受信場所とファイル送信ポートを起動します。
4. 宛先フォルダー (c:\temp\out) 内のメッセージを探します。

受信パイプラインからの昇格されたプロパティ

受信パイプラインの次のプロパティは、既定で昇格されます。

プロパティ名	推奨された物件
重要度	OfficeMail.受信メールの重要度
件名	オフィスメール.受信メール件名
SenderName	OfficeMail.SenderName
SenderAddress	オフィスメール.送信者アドレス
HasAttachments	OfficeMail.添付ファイルがある

次のステップ

すべての Office 365 アダプターを参照してください。