Tabel aktivitas email

Tabel aktivitas email membantu Anda melacak dan mengelola komunikasi email dengan pelanggan.

Tindakan pada aktivitas email

Dengan menggunakan layanan web Dataverse, Anda dapat melakukan tindakan berikut pada aktivitas email:

Membuat, mengambil, memperbarui, dan menghapus aktivitas email.
Kirim pesan email, atau kirim pesan email dengan menggunakan templat email (Template). Untuk informasi selengkapnya tentang templat email, lihat Membuat templat email.
Lampirkan file sebagai lampiran dengan menggunakan atribut (ActivityMimeAttachment) dalam pesan email.
Mengirim pesan email massal atau dalam jumlah besar.
Konfigurasikan pesan email masuk untuk dikirim dari Microsoft Exchange Server ke pengguna atau antrean apa pun, atau pesan keluar yang akan dikirim dari pengguna atau antrean apa pun ke Microsoft Exchange Server.

Jika atribut organisasi Organization.RequireApprovalForuserEmail dan Organization.RequireApprovalForQueueEmail (proses email hanya untuk pengguna/antrean yang disetujui) diatur ke true (1), hal berikut akan terjadi: pesan email dihantarkan atau dikirim dari pengguna atau antrean hanya jika alamat email utama pengguna atau antrean disetujui. Atribut SystemUser.EmailRouterAccessApproval dan Queue.EmailRouterAccessApproval menunjukkan status alamat email utama pengguna dan antrean masing-masing, dan nilainya harus diatur ke 1. Jika tidak, pesan masuk dan keluar diblokir. Anda dapat memperbarui rekaman pengguna atau antrean untuk mengubah nilai atribut, jika belum dalam status disetujui, asalkan akun pengguna Anda memiliki hak istimewa prvApproveRejectEmailAddress yang ditetapkan.

Nota

Di Dataverse, Email.StatusCode atribut tidak boleh null.

Email massal

Dataverse mendukung pengiriman email ke daftar besar penerima melalui permintaan email massal. Saat Anda mengirim permintaan email massal ke Dataverse, Dataverse membuat operasi asinkron di antrean layanan asinkron yang mengirimkan pesan email menggunakan proses latar belakang. Proses ini meningkatkan performa sistem.

Gunakan pesan SendBulkMailRequest dan BackgroundSendEmailRequest untuk mengirim pesan email massal. Daftar berikut ini menjelaskan urutan yang digunakan untuk mengirim email massal:

Jalankan permintaan SendBulkMail. Permintaan ini berisi kueri yang memilih penerima email target dan templat email untuk menulis setiap email.
Layanan asinkron membuat aktivitas email untuk setiap penerima.
Layanan asinkron mengirim setiap pesan email. Pesan email memiliki status Pengiriman "Tertunda".
Router email, Dynamics 365 for Outlook, atau komponen pengiriman email pihak ketiga memeriksa Dataverse dari pesan email yang menunggu untuk diproses. Jika ditemukan, pesan tersebut diunduh menggunakan permintaan BackgroundSendEmail.
Permintaan BackgroundSendEmail melakukan operasi berikut: memeriksa apakah ada pesan email yang tertunda, mengunduh email ke pemanggil pesan BackgroundSendEmailRequest, dan menyinkronkan unduhan jika ada beberapa pemanggil.

Nota

Penyedia layanan email Anda mungkin memiliki batasan yang memengaruhi berapa banyak email yang dapat Anda kirim dalam jangka waktu tertentu. Untuk informasi selengkapnya, lihat batas > Exchange Online Batas pengiriman.
Pemanggil pesan BackgroundSendEmailRequest menerima pesan email yang diunduh lalu mengirimkannya.

Lampiran email

Lampiran email adalah file yang bisa Anda lampirkan ke pesan email atau templat email. File terlampir dapat berada dalam format file komputer standar apa pun, seperti dokumen Office Outlook, lembar bentang Office Excel, file CAD, dan file PDF. Anda dapat melampirkan beberapa file sebagai lampiran email ke email atau templat email. Properti Organization.MaxUploadFileSize menentukan ukuran maksimum file yang dapat Anda unggah. Atur properti ini di tab Email dari Pengaturan Sistem di aplikasi Dynamics 365. Pengaturan ini membatasi ukuran file yang dapat Anda lampirkan ke pesan email, catatan, dan sumber daya web. Pengaturan default adalah 5 MB.

Untuk melampirkan file lampiran email ke pesan email atau templat email, gunakan kolom ActivityMimeAttachment.ObjectId dan ActivityMimeAttachment.ObjectTypeCode saat Anda membuat atau memperbarui baris lampiran MIME aktivitas.

Contoh kode berikut menunjukkan cara melampirkan lampiran email ke email:

ActivityMimeAttachment _sampleAttachment = new ActivityMimeAttachment{  
    ObjectId = new EntityReference(Email.EntityLogicalName, _emailId),  
    ObjectTypeCode = Email.EntityLogicalName,  
    Subject = "Sample Attachment",  
    Body = System.Convert.ToBase64String(new ASCIIEncoding().GetBytes("Example Attachment")),  
    FileName = "ExampleAttachment.txt"};

Demikian pula, untuk melampirkan lampiran email ke templat alih-alih ke email, ganti nilai atribut ActivityMimeAttachment.ObjectId dan ActivityMimeAttachment.ObjectTypeCode sebagai berikut pada kode sebelumnya:

ObjectId = new EntityReference(Template.EntityLogicalName, _templateId), ObjectTypeCode = Template.EntityLogicalName,

Untuk sampel kode lengkap tentang cara membuat lampiran email, lihat Sampel: Membuat, mengambil, memperbarui, dan menghapus lampiran email.

Menggunakan kembali lampiran email

Saat Anda membuat rekaman lampiran email, Dataverse menyimpan file terlampir sebagai BLOB file. Atribut ActivityMimeAttachment.AttachmentId rekaman lampiran email secara unik mengidentifikasi file BLOB. Proses ini memfasilitasi penggunaan kembali lampiran file dengan catatan templat email dan email lainnya, tanpa membuat dan menyimpan beberapa salinan file yang sama dalam database.

Untuk menggunakan kembali lampiran file yang ada:

ActivityMimeAttachment Ambil baris yang berisi file lampiran yang ingin Anda gunakan kembali, seperti yang diperlihatkan dalam contoh kode berikut:

ActivityMimeAttachment retrievedAttachment = 
    (ActivityMimeAttachment)_serviceProxy
    .Retrieve(ActivityMimeAttachment.EntityLogicalName, _emailAttachmentId, new ColumnSet(true));

Buat lampiran email baru, kaitkan dengan baris templat email atau email yang diperlukan, dan arahkan ke file terlampir dari baris yang diambil ActivityMimeAttachment , seperti yang ditunjukkan dalam contoh kode berikut:

ActivityMimeAttachment _reuseAttachment = new ActivityMimeAttachment{  
  ObjectId = new EntityReference(Email.EntityLogicalName, _emailId),  
  ObjectTypeCode = Email.EntityLogicalName,  
  Subject = "Sample Attachment",  
  AttachmentId = retrievedAttachment.AttachmentId};

Karena Anda menggunakan kembali file lampiran yang sudah ada, Anda tidak perlu menentukan ActivityMimeAttachment.Body nilai kolom dan ActivityMimeAttachment.FileName saat membuat dan mengaitkan baris lampiran email ke email atau templat email.

Penyimpanan email

Deskripsi email (isi email) hingga saat ini telah disimpan di penyimpanan relasional Dataverse. Perubahan terjadi ketika kolom Email.Description dalam tabel aktivitas email direlokasi ke penyimpanan Blob Azure yang tidak terstruktur. Penyimpanan Azure Blob juga digunakan untuk penyimpanan lampiran, anotasi, file, dan gambar.

Periode transisi

Migrasi data dari penyimpanan relasi Dataverse ke penyimpanan Azure Blob untuk semua pelanggan diperkirakan akan dimulai pada Bulan Mei 2023. Migrasi data ini akan berlangsung sebagai proses latar belakang (pekerjaan). Pergerakan data awal untuk pelanggan yang ada diperkirakan akan berlangsung selama sekitar 6 hingga 12 minggu, dan mungkin bahkan lebih lama tergantung pada ukuran data. Setelah pergerakan data awal, migrasi yang tersisa adalah proses berkelanjutan. Semua deskripsi email yang lebih lama dari dua belas bulan akan dipindahkan ke penyimpanan Azure Blob secara otomatis, dan periode transisi dua belas bulan ini tidak dapat diubah. Email yang lebih baru tidak akan dipindahkan hingga berusia 12 bulan. Pekerjaan migrasi deskripsi email berjalan secara berkala - sekitar 30-60 hari sekali per penyewa.

Migrasi data ini akan transparan kepada Anda dengan pengecualian bahwa Anda akan melihat pengurangan ukuran tabel ActivityPointer setelah proses migrasi selesai sepenuhnya. Di pusat admin Power Platform dalam laporan Kapasitas, baris email baru akan tersedia dalam Penggunaan file. Hasil akhirnya adalah peningkatan konsumsi penyimpanan file secara keseluruhan dan pengurangan konsumsi penyimpanan database.

Nota

Peningkatan penyimpanan File mungkin akan lebih kecil dari apa yang dihapus dari tabel ActivityPointer karena pemadatan data file.

Batasan yang disebutkan di bagian berikutnya akan mulai berlaku untuk data apa pun yang telah dipindahkan ke penyimpanan blob Azure yang dikelola Dataverse meskipun semua pergerakan data tidak selesai.

Batasan pencarian dan pemfilteran

Untuk deskripsi email (badan) yang disimpan di penyimpanan blob Azure, batasan tertentu berlaku untuk memfilter, menemukan, dan mencari deskripsi email seperti yang dijelaskan di bagian berikut.

Penyaringan

Pemfilteran pada deskripsi email tidak didukung. Beberapa poin spesifik yang perlu dipertimbangkan adalah:

FetchXML - Anda tidak dapat mencari di isi email menggunakan FetchXML.
Temukan Cepat dan Temukan Tingkat Lanjut - Anda tidak dapat memfilter deskripsi email dengan menggunakan metode ini.

Tip

Untuk Temukan Cepat, saat pemfilteran tidak didukung, Anda dapat menambahkan isi email sebagai kolom yang dikembalikan dan mengembalikan data isi dalam hasilnya.

Mencari

Anda dapat mengaktifkan pencarian Dataverse pada deskripsi email untuk mencari deskripsi email.

Lihat juga

Tabel aktivitas
Sampel: Mengirim email
Tabel email
Tabel ActivityMimeAttachment

Saran dan Komentar

Apakah halaman ini membantu?

Last updated on 2026-08-21