Bagikan melalui


Referensi tabel/entitas aplikasi Dynamics 365 yang diaktifkan

Tabel Dataverse menyediakan kumpulan tabel umum yang dimiliki semua database lingkungan. Tabel yang tercantum di sini ditambahkan atau dimodifikasi saat Anda memilih Aktifkan aplikasi Dynamics 365? saat Anda menambahkan Dataverse ke lingkungan yang Anda buat.

Ketika Anda memiliki lisensi yang diperlukan, Anda dapat menginstal produk Dynamics 365 yang dapat menambahkan lebih banyak tabel atau menyesuaikan tabel Dynamics 365 atau Dataverse yang ada.

Tabel ini mencantumkan produk Dynamics 365 lainnya yang bergantung pada referensi ini:

Dokumentasi Produk Referensi Tabel Produk
Penjualan Referensi tabel/entitas penjualan
Dinas Lapangan Referensi tabel/entitas Field Service
Layanan Pelanggan Tabel/referensi entitas Customer Service

Referensi ini hanya mencakup tabel di mana:

  • IsPrivate sama dengan false

  • IsIntersect sama dengan false atau IsIntersect sama true dengan dan tabel berisi lebih dari 4 kolom.

    • Sebagian besar tabel yang berpotongan hanya berisi 4 kolom yang diperlukan untuk mendukung hubungan Banyak ke Banyak. Mereka tidak berguna. Tabel berpotongan dengan lebih dari empat kolom lebih menarik.

Messages

Pesan dalam daftar ini berlaku untuk entitas. Misalnya, tabel milik pengguna mendukung Assign, GrantAccess, ModifyAccess, dan RevokeAccess pesan sementara tabel milik organisasi tidak.

SDK untuk .NET

Saat menggunakan SDK untuk .NET, Anda biasanya dapat memanggil kelas permintaan yang sesuai yang akan menjadi milik namespace Microsoft.Crm.Sdk.Messages atau Microsoft.Xrm.Sdk.Messages . Kelas-kelas ini memiliki nama yang menyertakan Request awalan yang ditambahkan ke nama pesan.

Beberapa pesan ditambahkan sebagai tindakan kustom untuk solusi yang mereka dukung. Pesan-pesan ini tidak ditentukan dalam rakitan SDK, tetapi ada beberapa cara untuk menggunakannya.

API untuk Web

Saat menggunakan API Web, Anda dapat menemukan fungsi dan tindakan OData Dataverse umum yang ditentukan dalam referensi ini:

Untuk fungsi dan tindakan ini, dan yang tambahan yang ditambahkan, Anda dapat menemukan cara menggunakannya dengan:

  1. Periksa dokumen layanan $metadata untuk detail tentang parameter dan nilai pengembalian. Lihat Definisi tindakan dan Definisi fungsi untuk detailnya.
  2. Memanggil tindakan dan fungsi. Lihat Menggunakan tindakan API Web dan Menggunakan fungsi API Web untuk detailnya.

Events

Acara adalah pesan yang ada sehingga Anda dapat berlangganan. Kecuali Anda menambahkan acara, Anda tidak boleh memanggil pesan, hanya berlangganan. Anda dapat berlangganan acara dengan beberapa cara berbeda, misalnya:

Karakteristik

Bagian ini mencakup properti entitas yang dipilih, bukan semuanya. Hanya properti yang diharapkan paling berguna bagi pengembang yang disertakan. Beberapa nilai properti entitas dapat diubah.

Kolom-kolom

Kolom tercantum dalam dua bagian terpisah: Kolom/atribut yang dapat ditulis dan kolom/atribut baca-saja. Tujuan dari pemisahan ini adalah untuk fokus pada kolom yang dapat diatur pengembang saat membuat atau memperbarui baris dalam tabel. Memahami kolom ini membantu pengembang memahami apa yang dapat mereka lakukan dengan tabel lebih dari sekadar mengambil nilai.

Kolom di bagian kolom/atribut yang dapat ditulis mengembalikan true untuk propertiIsValidForCreate atau IsValidForUpdate , (biasanya keduanya). Jika salah satu properti ini mengembalikan false, ini akan ditunjukkan.

Kolom/atribut baca-saja selalu mengembalikan false untuk properti IsValidForCreatedanIsValidForUpdate .

Opsi kolom pilihan dalam dokumentasi referensi ini berasal dari penyebaran di mana bahasa Inggris adalah bahasa dasar. Beberapa opsi pilihan dapat bervariasi tergantung pada bahasa dasar yang dipilih saat lingkungan dibuat. Perbedaan-perbedaan ini lebih selaras dengan opsi yang paling sesuai dengan bahasa atau budaya. Anda bebas menyesuaikan opsi ini dengan mengubah label atau menambahkan dan menghapus opsi sesuai kebutuhan.

Hubungan

Kelas EntityMetadata mencakup tiga properti untuk mewakili hubungan:

Harta benda Tipe Description
Hubungan SatuKebanyakanHubungan OneToManyRelationshipMetadata[] Mendapatkan array hubungan satu-ke-banyak untuk entitas.
ManyToOneRelationships OneToManyRelationshipMetadata[] Mendapatkan array hubungan banyak-ke-satu untuk entitas.
ManyToManyRelationships BanyakKebanyakanHubunganMetadata[] Mendapatkan array hubungan banyak-ke-banyak untuk entitas.

Nota

Penting untuk diingat bahwa meskipun setiap tabel mencantumkan hubungan yang berlaku untuknya, setiap hubungan dibagikan oleh kedua tabel. Hubungan ada di antara tabel. Meskipun ada hubungan Satu-To-Many, hubungan Banyak ke Satu hanyalah tampilan hubungan Satu-To-Many dari tabel referensi.

Hubungan banyak-ke-satu

Termasuk properti ini OneToManyRelationship :

Harta benda Description
ReferencedEntity Nama logis tabel terkait.
ReferencedAttribute Nama logis kunci primer dari tabel terkait.
ReferencingEntity Nama logis tabel terkait yang memiliki kolom pencarian.
ReferencingAttribute Nama logis kolom pencarian dalam tabel terkait yang berisi referensi ke kunci primer tabel utama.
IsHierarchical Apakah hubungan tersebut mewakili hubungan hierarkis referensial diri
CascadeConfiguration Data yang menjelaskan operasi mana yang dilakukan pada entitas induk akan mengalir ke entitas terkait.
Informasi selengkapnya: Konfigurasi kaskade

Hubungan satu-ke-banyak

Termasuk properti ini OneToManyRelationship :

Harta benda Description
ReferencingEntity Nama logis tabel terkait.
ReferencingAttribute Nama logis kolom dalam tabel terkait yang berisi referensi ke kunci primer tabel utama.
IsCustomizable Apakah sifat hubungan dapat diubah.
ReferencedEntityNavigationPropertyName Nama properti navigasi bernilai koleksi API Web untuk hubungan ini.
Informasi selengkapnya: Properti Navigasi API Web
AssociatedMenuConfiguration Data yang digunakan oleh aplikasi berbasis model untuk mengontrol apakah dan bagaimana data entitas terkait dapat diakses di UI dari entitas utama.

Hubungan banyak-ke-banyak

Setiap hubungan banyak-ke-banyak mencakup Entity1LogicalName dan Entity2LogicalName. Untuk dokumentasi ini, detail hubungan disediakan dalam konteks tabel saat ini. Apakah itu Entity1Entity2 atau tidak benar-benar penting.

Untuk setiap hubungan banyak-ke-banyak, properti berikut disertakan:

Harta benda Description
IntersectEntityName Nama logis tabel persimpangan yang mendukung hubungan banyak-ke-banyak ini.
Anda dapat menggunakan nilai ini saat menggabungkan kolom tabel menggunakan FetchXml
IsCustomizable Apakah sifat hubungan dapat diubah.
SchemaName Nama skema hubungan.
IntersectAttribute Nama kolom dalam tabel persimpangan yang merupakan kunci utama untuk rekaman jenis ini.
NavigationPropertyName Nama properti navigasi bernilai koleksi API Web untuk hubungan ini.
Informasi selengkapnya: Properti Navigasi API Web
AssociatedMenuConfiguration Data yang digunakan oleh aplikasi berbasis model untuk mengontrol apakah dan bagaimana data tabel kedua dapat diakses di UI dari tabel ini.

Dalam kasus yang jarang terjadi di mana hubungan banyak-ke-banyak mereferensikan sendiri, seperti untuk Peran Koneksi (ConnectionRole) connectionroleassociation_association, Entity1 atau Entity2 diawali ke properti.

Harta benda Nilai
Entity1IntersectAttribute Nama kolom dalam tabel persimpangan yang merupakan kunci utama untuk rekaman jenis ini sebagai tabel pertama.
Entity2IntersectAttribute Nama kolom dalam tabel persimpangan yang merupakan kunci utama untuk rekaman jenis ini sebagai tabel kedua.
Entity1NavigationPropertyName Nama properti navigasi bernilai koleksi API Web untuk hubungan ini sebagai tabel pertama.
Entity2NavigationPropertyName Nama properti navigasi bernilai koleksi API Web untuk hubungan ini sebagai tabel kedua.
Entity1AssociatedMenuConfiguration Data yang digunakan oleh aplikasi berbasis model untuk mengontrol apakah dan bagaimana data tabel kedua dapat diakses di UI dari tabel ini sebagai tabel pertama.
Entity2AssociatedMenuConfiguration Data yang digunakan oleh aplikasi berbasis model untuk mengontrol apakah dan bagaimana data tabel kedua dapat diakses di UI dari tabel ini sebagai tabel kedua