Mengirim dan menerima email dengan adaptor Email Outlook Office 365 - BizTalk Server

Adaptor Email Outlook Office 365 memungkinkan Anda mengirim dan menerima email dari Email Outlook Office 365 anda dari BizTalk.

Mengirim email menggunakan port kirim

1. Di konsol Administrasi BizTalk Server, klik kanan Kirim Port, pilih Baru, dan pilih Port pengiriman Satu Arah Statis.

   Buat Port Kirim menyediakan beberapa panduan.

2. Masukkan Nama. Di Transportasi, atur Tipe ke Office 365 Email Outlook, dan pilih Konfigurasikan.

3. Pilih Masuk ..., dan masuk ke Akun Office 365 Anda. Akun diisi secara otomatis dengan alamat email Anda.

4. Izinkan persetujuan BizTalk Server untuk izin mengakses:

   

5. Mengonfigurasi Office 365 Outlook Anda Email properti Umum:

   • Ke: Masukkan default Anda Ke alamat email yang dipisahkan oleh ';' (maksimal 256 karakter)
   • CC: Masukkan alamat surat CC default Anda yang dipisahkan oleh ';' (maksimal 256 karakter)
   • Subjek: Sebutkan subjek email default Anda. (maksimal 256 karakter)
   • Kepentingan: Pilih nilai Kepentingan Anda. Dropdown berisi nilai Rendah, Normal, dan Tinggi dengan Normal menjadi default.

   Setelah selesai, properti Anda terlihat mirip dengan yang berikut ini:

   

6. Konfigurasikan properti Lampiran Email Outlook Office 365 Anda:

   Isi email yang dikirim sesuai dengan bagian isi pesan BizTalk. Untuk menambahkan lampiran ke email, lakukan hal berikut:

   • Lampirkan bagian pesan BizTalk: Jika dicentang, bagian non-isi pesan BizTalk ditambahkan sebagai lampiran ke email yang dikirim.
   • File: Menentukan bahwa file atau file dilampirkan ke pesan email dan jalur lengkap ke file atau file. Jalur atau jalur yang ditentukan harus dapat diakses oleh host untuk adaptor pada durasi. Nilai default: kosong.

   Setelah memilih beberapa file, properti lampiran terlihat mirip dengan yang berikut ini:

   

7. Pilih Ok untuk menyimpan perubahan Anda.

Detail yang penting

1. Properti default juga dapat diperbarui menggunakan properti yang dipromosikan:

   Nama Properti	Properti yang Dipromosikan
   Ke	OfficeMail.To
   CC	OfficeMail.CC
   Subjek	OfficeMail.Subject
   Pentingnya	OfficeMail.Importance
   File Terlampir	OfficeMail.AttachedFiles

2. Nilai properti OfficeMail.AttachedFiles adalah daftar file dengan "|" sebagai pemisah di antara file yang berbeda. Misalnya: "C:\Attachments\File1.pdf|C:\Attachments\File2.xml".

3. Properti ContentType dari bagian isi pesan BizTalk dapat diatur ke "Teks" atau "Html" untuk menunjukkan jenis isi email. Secara default, itu akan menjadi "Teks".

4. Ketika bagian dari pesan BizTalk multi-bagian dilampirkan, properti ContentType bagian, jika disediakan, digunakan sebagai jenis MIME untuk lampiran yang dibuat. Secara default, jenis MIME lampiran diatur ke "application/octet-stream".

5. Saat melampirkan file, jenis MIME lampiran ditentukan dari ekstensi nama file. Jenis MIME default adalah "application/octet-stream".

Menguji port pengiriman Anda

Anda bisa menggunakan port dan lokasi penerima File sederhana untuk mengirim pesan ke Email Outlook Office 365 Anda.

1. Buat port penerima menggunakan adaptor File. Dalam lokasi terima Anda, atur folder Terima ke C:\Temp\In\, dan atur masker file ke *.xml.

2. Di Office 365 Outlook Anda Email adaptor mengirim properti port, atur Filter ke BTS.ReceivePortName == <Receive Port Name>.

3. Tempelkan yang berikut ini ke editor teks, dan simpan file sebagai Office365Mail.xml. Ini adalah contoh pesan Anda.

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

4. Mulai lokasi penerimaan File dan port pengiriman adaptor Email Outlook Office 365.

5. Salin Office365Mail.xml pesan sampel ke folder penerima (C:\Temp\In\). Port kirim mengirimkan file XML sebagai isi email ke Email Outlook Office 365 Anda. File yang ditentukan di tab Lampiran konfigurasi port dilampirkan ke email.

Konfigurasi tambahan dalam handler pengiriman

Tersedia dimulai dengan pembaruan kumulatif BizTalk Server 2020 4.

Anda dapat menyesuaikan jumlah maksimum email yang dikirim adaptor Email Office 365 Outlook pada satu waktu di semua port pengirimannya dalam instans host. Nilai diatur ke 20 secara default, dan dapat diubah dengan mengatur properti Maksimum pengiriman bersamaan di properti Kirim handler untuk adaptor Email Outlook Office 365.

1. Di konsol Administrasi BizTalk Server, perluas Administrasi BizTalk Server, perluas Grup BizTalk, perluas Pengaturan Platform, lalu perluas Adaptor.

2. Di daftar adapter yang diperluas, klik Email Office365 Outlook.

3. Di panel kanan klik kanan pengirim handler yang ingin Anda konfigurasi, lalu klik Properti.

   

4. Atur properti Pengiriman bersamaan maksimum .

   

5. Pilih Ok untuk menyimpan perubahan Anda.

Menerima email menggunakan port penerima

1. Di konsol Administrasi BizTalk Server, klik kanan Terima Port, pilih Baru, dan pilih Port terima Satu Arah.

   Membuat port penerima memberikan beberapa panduan.

2. Masukkan nama, dan pilih Terima Lokasi.

3. Pilih Baru, dan Beri nama lokasi terima. Di Transportasi, pilih Office 365 Outlook Email dari daftar drop-down Jenis, lalu pilih Konfigurasikan.

4. Pilih Masuk ..., dan masuk ke Akun Office 365 Anda. Akun diisi secara otomatis dengan alamat email Anda.

5. Izinkan persetujuan BizTalk Server untuk izin mengakses:

   

6. Mengonfigurasi properti Umum titik akhir:

   • Folder: Pilih folder untuk mendapatkan email. Folder defaultnya adalah Kotak Masuk. Perhatikan bahwa folder tidak bersifat rekursif. Misalnya, email dari subfolder tidak diambil.
   • Mulai dari: Masukkan cara email diterima dari Office 365. Nilai ini menunjukkan receivedTimeStamp email di Office 365 Outlook. Email yang lebih baru daripada nilai yang dimasukkan diterima.
   • Hanya email yang belum dibaca: Periksa ini untuk membaca email yang belum dibaca saja. Biarkan tidak dicentang untuk membaca semua email.
   • Tindakan Posting: Pilih tindakan postingan yang akan dilakukan setelah email dibaca. Tidak ada yang default, dan tidak melakukan apa pun setelah email diterima oleh BizTalk. Tandai sebagai sudah dibaca menyiratkan, bahwa setelah email diterima oleh BizTalk, email di kotak surat Anda ditandai sebagai sudah dibaca. Hapus menyiratkan, bahwa setelah email diterima oleh BizTalk, email di kotak surat Anda dihapus. Tindakan pasca dilakukan berdasarkan upaya terbaik.

   Setelah selesai, properti Anda terlihat mirip dengan yang berikut ini:

   

7. Konfigurasikan properti Payload titik akhir (tersedia dimulai dengan BizTalk Server 2020 dan yang lebih baru):

   • Kirim MIME: Menyimpan representasi MIME dari email. Konten MIME mencakup isi email dan semua lampiran.
   • Konten proses: Menyimpan isi email. Ini dipilih secara default. Jenis konten isi email disimpan di properti ContentType dari pesan BizTalk yang dibuat.
   • Sertakan lampiran: Menyimpan lampiran email sebagai bagian dari pesan BizTalk. Ini tidak dicentang secara default. Setiap bagian pesan BizTalk memiliki properti ContentType yang diatur ke jenis MIME lampiran. Lampiran yang merupakan item Outlook (email, acara kalender, kontak) disimpan dalam representasi MIME mereka.

   Setelah selesai, properti Anda terlihat mirip dengan yang berikut ini:

   

8. Pilih Ok untuk menyimpan perubahan Anda.

Menguji pengaturan penerimaan Anda

Anda bisa menggunakan port pengiriman File sederhana untuk menerima pesan dari Email Outlook Office 365 Anda.

1. Buat port kirim menggunakan adaptor File. Dalam properti port pengiriman Anda, atur folder Tujuan ke C:\Temp\Out\, dan atur nama file dan ke %MessageID%.xml.
2. Di properti Port pengiriman file Anda, atur Filter ke BTS.ReceivePortName == <Receive Port Name>.
3. Mulai Office 365 Outlook Email menerima lokasi dan port Pengiriman file.
4. Cari pesan di folder tujuan (c:\temp\out).

Properti yang Dipromosikan dari alur penerima

Properti berikut dari Alur Terima dipromosikan secara default:

Langkah berikutnya

Lihat semua adaptor Office 365.