Bagikan melalui

Membuat atau mengedit entitas virtual dengan data dari sumber data eksternal

  • Artikel

Topik ini berlaku untuk Dynamics 365 Customer Engagement (on-premises). Untuk versi Power Apps dari topik ini, lihat: Membuat dan mengedit entitas virtual yang berisi data dari sumber data eksternal

Entitas virtual adalah entitas kustom dalam Dynamics 365 Customer Engagement (on-premises) yang memiliki bidang berisi data dari sumber data eksternal. Entitas virtual ditampilkan dalam aplikasi Anda untuk pengguna sebagai rekaman entitas reguler, namun berisi data yang berasal dari database eksternal, misalnya Azure SQL Database. Rekaman berdasarkan entitas virtual tersedia di semua klien termasuk klien kustom yang dikembangkan menggunakan Layanan Web Dynamics 365 Customer Engagement.

Dulu, untuk mengintegrasikan data yang berbeda sumber Anda harus membuat konektor untuk memindahkan data atau mengembangkan plug-in kustom, baik klien atau sisi server. Namun, dengan entitas virtual Anda dapat terhubung langsung dengan sumber data eksternal saat runtime sehingga data tertentu dari sumber data eksternal tersedia di lingkungan, tanpa perlu replikasi data.

Entitas virtual terdiri dari tiga komponen utama, penyedia data, a sumber data record, dan entitas virtual. Penyedia data terdiri dari plug-in dan entitas sumber data. Sumber data adalah rekaman entitas di Dynamics 365 Customer Engagement (on-premises), yang mencakup metadata yang menunjukkan skema parameter koneksi. Setiap entitas virtual mereferensi sumber data dalam definisi entitas.

Dynamics 365 Customer Engagement (on-premises) mencakup penyedia data OData yang dapat Anda gunakan untuk terhubung dengan layanan web OData v4 yang mengakses data eksternal.

Selain itu, pengembang dapat membangun penyedia data mereka sendiri. Penyedia data diinstal di lingkungan sebagai solusi. Informasi selengkapnya: Memulai entitas virtual

Diagram entitas virtual.

Manfaat entitas virtual

  • Pengembang dapat menerapkan plugin untuk membaca data eksternal menggunakan layanan Web Dynamics 365 Customer Engagement dan alat pendaftaran plug-in Customer Engagement.

  • Penyesuai sistem menggunakan Dynamics 365 Customer Engagement (on-premises) untuk mengkonfigurasi rekaman sumber data dan membuat entitas virtual yang digunakan untuk mengakses data eksternal tanpa menulis kode apa pun.

  • Pengguna akhir berfungsi dengan rekaman yang dibuat oleh entitas virtual untuk melihat data dalam bidang, kisi, hasil pencarian, serta laporan dan dasbor berbasis Fetch XML.

Menambahkan sumber data yang akan digunakan untuk entitas virtual

Pengembang dapat membuat plug-in kustom untuk digunakan sebagai penyedia data untuk entitas virtual. Selain itu, Anda dapat menggunakan penyedia Data OData v4 yang tersedia. Informasi selengkapnya: Konfigurasi, persyaratan, dan praktik terbaik Penyedia Data OData v4

  1. Buka Sumber Data Entitas Virtual Administrasi>Pengaturan>.

  2. Pada toolbar tindakan, pilih Baru.

  3. Pada kotak dialog Pilih Penyedia Data, pilih dari sumber data berikut, lalu pilih OK.

Menambahkan bidang aman ke sumber Data

Anda membuat bidang untuk sumber Data dalam cara yang sama seperti entitas lain. Untuk data yang dienkripsi atau sensitif, Aktifkan atribut rahasia sumber Data pada bidang kustom sumber Data. Contohnya, untuk mengamankan bidang yang berisi string koneksi database.

Catatan

Atribut rahasia sumber data ini hanya tersedia dengan bidang yang ditambahkan ke formulir sumber Data.

Atribut Rahasia Sumber Data.

Buat Entitas virtual

Anda membuat entitas virtual seperti entitas lain di Customer Engagement dengan penambahan beberapa atribut tambahan yang dijelaskan di sini.

Catatan

Meskipun Anda dapat membuat entitas virtual dengan memilih Tidak Ada sebagai sumber data, untuk memperoleh data, entitas virtual memerlukan sumber data. Informasi selengkapnya: Menambahkan sumber data yang digunakan untuk entitas virtual

  1. Buka Pengaturan>Penyesuaian>Sesuaikan Sistem.

  2. Pada penjelajah solusi, buat entitas baru. Untuk melakukannya, pilih entitas di panel navigasi kiri, dan kemudian pilih baru.

  3. Pada tab Umum definisi entitas, pilih Entitas virtual, dan kemudian di daftar sumber data drop-down , pilih sumber data yang Anda inginkan.

    Opsi Entitas Virtual pada definisi entitas.

  4. Pada definisi entitas, lengkapi bidang yang diperlukan berikut.

    • Nama Eksternal. Masukkan nama tabel di sumber data eksternal yang mana entitas ini dipetakan.

    • Nama Koleksi Eksternal. Masukkan nama plural tabel di sumber data eksternal yang mana entitas ini dipetakan.

      Berikut adalah contoh entitas virtual bernama Movie yang menggunakan penyedia data Azure Cosmos DB untuk mengakses file dokumen.

    Definisi entitas virtual menggunakan penyedia data Azure Cosmos DB .

    Penting

    Beberapa opsi, seperti Tim Akses, Antrean, dan Buat Cepat, tidak tersedia dengan entitas virtual. Informasi selengkapnya: Pertimbangan saat Anda menggunakan entitas virtual

    Lengkapi properti tambahan yang diperlukan dan opsional, seperti tampilan dan nama jamak, yang diperlukan. Untuk informasi selengkapnya tentang properti ini, lihat Membuat dan mengedit entitas.

  5. Membuat dan menambahkan satu atau beberapa bidang untuk entitas virtual. Selain properti bidang standar yang diperlukan untuk membuat bidang kustom, properti opsional ini tersedia untuk setiap bidang kustom yang Anda buat untuk entitas virtual.

    • Nama Eksternal. Hal ini biasanya nama unik untuk mengidentifikasi data yang akan ditampilkan pada bidang.

    Catatan

    Jika jenis bidang yang Anda buat adalah OptionSet, bidang tambahan berikut tersedia.

    • Nama Tipe Eksternal. Properti ini dipetakan ke nama eksternal rangkaian nilai di layanan eksternal untuk rangkaian pilihan. Biasanya, hal ini dapat berupua enum atau nama kelas nilai string. Nama jenis eksternal dapat digunakan ketika nama yang benar-benar berkualifikasi diperlukan. Misalnya, sebagai Tipe Nama dengan OData di mana parameter dalam kueri memerlukan nama yang sepenuhnya memenuhi syarat, seperti [Tipe Nama].[Nilai].
    • Nilai eksternal. Properti ini dipetakan ke nilai yang sesuai dalam sumber data eksternal untuk item rangkaian pilihan. Nilai yang dimasukkan ini digunakan untuk menentukan item rangkaian pilihan untuk ditampilkan di aplikasi.

    Lengkapi properti tambahan yang diperlukan. Untuk informasi selengkapnya tentang properti ini, lihat Membuat dan mengedit bidang.

  6. Pilih Simpan dan Tutuppada halaman Properti bidang .

  7. Pada toolbar penjelajah solusi, pilih Simpan.

  8. Pada toolbar penjelajah solusi, pilih Terbitkan.

  9. Tutup explorer solusi.

Pertimbangan saat menggunakan entitas virtual

Entitas virtual memiliki batasan ini.

  • Semua virtual entitites hanya baca.

  • Entitas yang ada tidak dapat dikonversi ke entitas virtual.

  • Secara default, entitas virtual berisi hanya bidang nama dan Id. Tidak ada bidang sistem dikelola lain, seperti Status atau dibuat pada/dimodifikasi pada yang didukung.

  • Entitas virtual tidak mendukung bidang kustom dengan jenis data mata uang, Gambar, atau pelanggan.  

  • Entitas virtual tidak mendukung audit.

  • Bidang entitas virtual tidak dapat digunakan dalam Rollup atau bidang hitung.  

  • Entitas virtual tidak dapat merupakan jenis aktivitas entitas.

  • Berbagai fitur yang mempengaruhi baris tabel entitas tidak dapat diaktifkan dengan entitas virtual. Contohnya mencakup antrean, manajemen pengetahuan, SLA, Deteksi duplikat, pelacakan perubahan, kemampuan mobile offline, keamanan bidang, pencarian relevan, portal untuk solusi portal web Dynamics 365 Customer Engagement (on-premises), dan relasi n:n antara entitas virtual.

  • Entitas virtual dimiliki organisasi dan tidak mendukung konsep keamanan tingkat baris Common Data Service for Apps. Sebaiknya Anda menerapkan model keamanan Anda sendiri untuk sumber data eksternal.

  • Sebaiknya Anda menargetkan sumber tunggal data saat menggunakan entitas virtual di Pencarian Tingkat Lanjut. Contohnya, membuat pencarian tingkat lanjut yang pada akhirnya membuat Gabungan antara data asli Dataverse dan data entitas virtual eksternal tidak didukung.

  • Properti metadata bidang yang memvalidasi pada pembaruan tidak berlaku untuk entitas virtual. Misalnya, bidang bilangan bulat pada bidang entitas virtual dapat diatur ke memiliki nilai minimum nol. Namun, karena nilai berasal dari sumber eksternal data, kueri akan menghasilkan nilai kurang dari nol saat diambil dari entitas virtual. Properti nilai minimum tidak tersirat di kueri. Anda tetap perlu memfilter nilai yang akan lebih besar dari 0 jika itu yang diinginkan.

  • Entitas virtual tidak mendukung pelacakan perubahan dan tidak dapat disinkronkan dengan menggunakan fitur Customer Engagement, seperti Layanan Ekspor Data.

  • Alur proses bisnis tidak didukung dengan entitas virtual. Informasi selengkapnya: Kesalahan tak terduga yang diterima saat pengguna mengaktifkan alur proses bisnis

Kesalahan tidak terduga diterima saat pengguna mengaktifkan alur proses bisnis

Ketika pengguna mencoba mengaktifkan alur proses bisnis, mereka mungkin menerima pesan "kesalahan tidak terduga". Melihat file log, entri log berikut akan ditampilkan.

ErrorCode: 0x80040216 Pesan: System.Web.HttpUnhandledException: Pengecualian jenis 'System.Web.HttpUnhandledException' dibuat. ---> Microsoft.Crm.CrmException: alur proses bisnis tidak dapat diaktifkan untuk entitas virtual

Masalah ini terjadi karena entitas virtual tidak mendukung alur proses bisnis.

Baca juga

Persyaratan dan praktik
terbaik Penyedia Data OData v4 Membuat dan mengedit entitas
Membuat dan mengedit bidang