Referensi tabel/entitas dataverse

Gunakan referensi ini untuk memahami operasi yang tersedia untuk tabel tertentu, kolom default setiap tabel, dan hubungan antar tabel. Definisi tabel menggunakan kelas EntityMetadata.

Referensi ini hanya mencakup tabel di mana:

  • EntityMetadata.IsPrivate Sama false

    Kondisi ini mengecualikan tabel tanpa kasus penggunaan eksternal.

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

    Sebagian besar tabel irisan hanya berisi empat kolom yang diperlukan untuk mendukung hubungan banyak ke banyak. Mereka tidak berguna. Tabel berpotangan dengan lebih dari empat kolom tidak umum dan lebih menarik.

Untuk melihat informasi tentang semua tabel di lingkungan Anda, lihat Menelusuri definisi tabel di lingkungan Anda.

Referensi tabel produk Dynamics 365

Produk Dynamics 365 menggunakan Dataverse. Saat Anda membuat lingkungan untuk produk Dynamics 365, lingkungan memiliki sekumpulan tabel umum untuk semua produk Dynamics 365. Lihat referensi tabel/entitas aplikasi yang diaktifkan Dynamics 365.

Setiap produk Dynamics 365 tertentu dapat menambahkan lebih banyak tabel. Tabel berikut ini memperlihatkan referensi tabel untuk produk Dynamics 365 tertentu:

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

Karakteristik

Bagian ini mencakup properti entitas yang dipilih, bukan semuanya. Ini hanya mencakup properti yang paling berguna bagi pengembang. Anda dapat mengubah beberapa nilai properti entitas.

Kolom-kolom

Kolom tercantum dalam dua bagian terpisah:

Bagian Description
Kolom/atribut bisa-tulis Kolom yang bisa Anda atur saat membuat atau memperbarui baris dalam tabel. Kolom ini mengembalikan true untuk AttributeMetadata.IsValidForCreate properti atau AttributeMetadata.IsValidForUpdate , biasanya keduanya. Jika salah satu properti mengembalikan false, kondisi ini ditunjukkan.
Kolom/atribut baca-saja Kolom yang bisa Anda ambil tetapi tidak dapat diatur saat membuat atau memperbarui baris dalam tabel. Kolom ini selalu kembali false untuk AttributeMetadata.IsValidForCreate properti dan AttributeMetadata.IsValidForUpdate .

Pilihan kolom pilihan

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 ini lebih selaras dengan opsi yang paling sesuai dengan bahasa atau budaya. Anda dapat 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

Meskipun setiap tabel mencantumkan hubungan yang berlaku untuknya, setiap hubungan dibagikan oleh kedua tabel. Hubungan ada di antara tabel. Meskipun hubungan satu-ke-banyak ada, hubungan banyak ke satu hanyalah tampilan hubungan satu-ke-banyak dari tabel referensi.

Hubungan banyak ke satu

Termasuk properti kelas iniOneToManyRelationshipMetadata:

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 yang bertingkat ke entitas terkait.
Untuk informasi selengkapnya, lihat Konfigurasi cascade.

Hubungan satu-ke-banyak

Termasuk properti kelas iniOneToManyRelationshipMetadata:

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 Anda dapat mengubah properti hubungan.
ReferencedEntityNavigationPropertyName Nama properti navigasi bernilai koleksi API Web untuk hubungan ini.
Untuk informasi selengkapnya, lihat 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 kelas berikut ManyToManyRelationshipMetadata disertakan:

Harta benda Description
IntersectEntityName Nama logis tabel persimpangan yang mendukung hubungan banyak-ke-banyak ini.
IsCustomizable Apakah Anda dapat mengubah properti hubungan.
SchemaName Nama skema hubungan.
IntersectAttribute (Entity1IntersectAttribute atau Entity2IntersectAttribute) Nama kolom dalam tabel persimpangan yang merupakan kunci utama untuk rekaman jenis ini.
NavigationPropertyName (Entity1NavigationPropertyName atau Entity2NavigationPropertyName) Nama properti navigasi bernilai koleksi API Web untuk hubungan ini.
Informasi selengkapnya: Properti Navigasi API Web
AssociatedMenuConfiguration (Entity1AssociatedMenuConfiguration atau Entity2AssociatedMenuConfiguration) 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.