Tham chiếu bảng/thực thể dataverse

Sử dụng tham chiếu này để hiểu rõ các thao tác sẵn dùng cho các bảng cụ thể, các cột mặc định của mỗi bảng và mối quan hệ giữa các bảng. Định nghĩa bảng sử dụng lớp EntityMetadata.

Tài liệu tham khảo này chỉ bao gồm những bảng trong đó:

• EntityMetadata.IsPrivate bằng false

  Điều kiện này loại trừ các bảng không có trường hợp sử dụng bên ngoài.

• EntityMetadata.IsIntersect false bằng hoặc IsIntersect bằng và true bảng chứa nhiều hơn bốn cột.

  Hầu hết các bảng giao nhau chỉ chứa bốn cột cần thiết để hỗ trợ mối quan hệ nhiều-đến-nhiều. Chúng không hữu ích. Giao nhau bảng có nhiều hơn bốn cột không phải là phổ biến và thú vị hơn.

Để xem thông tin về tất cả các bảng trong môi trường của bạn, hãy xem Duyệt định nghĩa bảng trong môi trường của bạn.

Tham khảo bảng sản phẩm Dynamics 365

Các sản phẩm Dynamics 365 sử dụng Dataverse. Khi bạn tạo môi trường cho các sản phẩm Dynamics 365, môi trường sẽ có một tập hợp bảng chung cho tất cả các sản phẩm Dynamics 365. Hãy xem mục Dynamics 365 tham khảo về bảng/thực thể ứng dụng đã bật.

Mỗi sản phẩm Dynamics 365 cụ thể có thể thêm nhiều bảng hơn. Bảng sau đây hiển thị tham chiếu bảng cho các sản phẩm Dynamics 365 cụ thể:

Tài liệu sản phẩm	Tham khảo bảng sản phẩm
Sales	Tham chiếu bảng/thực thể bán hàng
Dịch vụ thực địa	Tham chiếu bảng/thực thể Field Service
Dịch vụ khách hàng	Tham chiếu bảng/thực thể Customer Service

Thuộc tính

Phần này bao gồm các thuộc tính thực thể đã chọn thay vì tất cả chúng. Nó chỉ bao gồm những thuộc tính hữu ích nhất cho các nhà phát triển. Bạn có thể thay đổi một số giá trị thuộc tính thực thể.

Số cột

Các cột được liệt kê trong hai phần riêng biệt:

Phần	Mô tả
Cột/thuộc tính có thể ghi được	Các cột bạn có thể đặt khi tạo hoặc cập nhật các hàng trong bảng. Các cột này trả true về cho thuộc AttributeMetadata.IsValidForCreate tính hoặc AttributeMetadata.IsValidForUpdate , thường là cả hai. Nếu một trong hai thuộc tính trả falsevề , điều kiện này sẽ được chỉ báo.
Cột/thuộc tính chỉ đọc	Các cột bạn có thể truy xuất nhưng không thể đặt khi tạo hoặc cập nhật các hàng trong bảng. Các cột này luôn trả về false cho cả hai AttributeMetadata.IsValidForCreate và thuộc AttributeMetadata.IsValidForUpdate tính.

Tùy chọn cột lựa chọn

Các tùy chọn cột lựa chọn trong tài liệu tham khảo này đến từ một triển khai trong đó tiếng Anh là ngôn ngữ cơ sở. Một số tùy chọn lựa chọn có thể khác nhau tùy thuộc vào ngôn ngữ cơ sở được chọn khi môi trường được tạo. Những khác biệt này phù hợp chặt chẽ hơn với các tùy chọn phù hợp nhất với ngôn ngữ hoặc văn hóa. Bạn có thể tùy chỉnh các tùy chọn này bằng cách thay đổi nhãn hoặc thêm và loại bỏ các tùy chọn nếu cần.

Mối quan hệ

Lớp EntityMetadata bao gồm ba thuộc tính để đại diện cho các mối quan hệ:

Tài sản	Kiểu	Mô tả
OneToManyMối quan hệ	Siêu dữ liệu OneToManyRelationship[]	Nhận mảng các mối quan hệ một-nhiều cho thực thể.
Mối quan hệ ManyToOne	Siêu dữ liệu OneToManyRelationship[]	Nhận mảng các mối quan hệ nhiều-một cho thực thể.
Mối quan hệ ManyToMany	Đa dữ liệu ManyToManyRelationship[]	Nhận mảng các mối quan hệ nhiều-nhiều cho thực thể.

Lưu ý

Trong khi mỗi bảng liệt kê các mối quan hệ áp dụng cho nó, mỗi mối quan hệ được chia sẻ bởi cả hai bảng. Các mối quan hệ tồn tại giữa các bảng. Trong khi tồn tại mối quan hệ một đối nhiều, mối quan hệ nhiều đối một chỉ đơn giản là một dạng xem của mối quan hệ một đối nhiều từ bảng tham chiếu.

Mối quan hệ nhiều đối một

Bao gồm các thuộcOneToManyRelationshipMetadata tính lớp này:

Tài sản	Mô tả
ReferencedEntity	Tên logic của bảng liên quan.
ReferencedAttribute	Tên logic của khóa chính của bảng liên quan.
ReferencingEntity	Tên logic của bảng liên quan có cột tra cứu.
ReferencingAttribute	Tên logic của cột tra cứu trong bảng liên quan chứa tham chiếu đến khóa chính của bảng chính.
IsHierarchical	Liệu mối quan hệ có đại diện cho một mối quan hệ phân cấp tự tham chiếu hay không
CascadeConfiguration	Dữ liệu mô tả thao tác nào được thực hiện trên thực thể mẹ xếp tầng xuống các thực thể liên quan. Để biết thêm thông tin, hãy xem Cấu hình Xếp tầng.

Mối quan hệ một-nhiều

Bao gồm các thuộcOneToManyRelationshipMetadata tính lớp này:

Tài sản	Mô tả
ReferencingEntity	Tên logic của bảng liên quan.
ReferencingAttribute	Tên logic của cột trong bảng liên quan chứa tham chiếu đến khóa chính của bảng chính.
IsCustomizable	Liệu bạn có thể thay đổi thuộc tính của mối quan hệ hay không.
ReferencedEntityNavigationPropertyName	Tên của thuộc tính điều hướng có giá trị bộ sưu tập API Web cho mối quan hệ này. Để biết thêm thông tin, hãy xem Thuộc tính Dẫn hướng API Web.
AssociatedMenuConfiguration	Dữ liệu được sử dụng bởi các ứng dụng dựa trên mô hình để kiểm soát xem có thể truy cập dữ liệu thực thể liên quan trong giao diện người dùng từ thực thể chính hay không.

Mối quan hệ nhiều-nhiều

Mỗi mối quan hệ nhiều-nhiều bao gồm Entity1LogicalName và Entity2LogicalName. Đối với tài liệu này, chi tiết mối quan hệ được cung cấp trong ngữ cảnh của bảng hiện tại. Cho dù nó có thực sự Entity1 quan trọng hay không Entity2 .

Đối với mỗi mối quan hệ nhiều-đến-nhiều, các thuộc tínhManyToManyRelationshipMetadata lớp sau đây được bao gồm:

Tài sản	Mô tả
IntersectEntityName	Tên logic của bảng giao nhau hỗ trợ mối quan hệ nhiều-nhiều này.
IsCustomizable	Liệu bạn có thể thay đổi thuộc tính của mối quan hệ hay không.
SchemaName	Tên lược đồ của mối quan hệ.
IntersectAttribute (Entity1IntersectAttribute hoặc Entity2IntersectAttribute)	Tên của cột trong bảng giao nhau là khóa chính cho các bản ghi thuộc loại này.
NavigationPropertyName (Entity1NavigationPropertyName hoặc Entity2NavigationPropertyName)	Tên của thuộc tính điều hướng có giá trị bộ sưu tập API Web cho mối quan hệ này. Thông tin thêm: Thuộc tính điều hướng API Web
AssociatedMenuConfiguration (Entity1AssociatedMenuConfiguration hoặc Entity2AssociatedMenuConfiguration)	Dữ liệu được sử dụng bởi các ứng dụng dựa trên mô hình để kiểm soát xem có thể truy cập dữ liệu bảng thứ hai trong giao diện người dùng từ bảng này hay không và như thế nào.

Trong trường hợp hiếm hoi khi mối quan hệ nhiều-nhiều tự tham chiếu, chẳng hạn như đối với connectionroleassociation_association Entity1 hoặc Entity2 được thêm vào trước thuộc tính.

Tài sản	Giá trị
Entity1IntersectAttribute	Tên của cột trong bảng giao nhau là khóa chính cho các bản ghi thuộc loại này làm bảng đầu tiên.
Entity2IntersectAttribute	Tên của cột trong bảng giao nhau là khóa chính cho các bản ghi thuộc loại này làm bảng thứ hai.
Entity1NavigationPropertyName	Tên của thuộc tính điều hướng có giá trị bộ sưu tập API Web cho mối quan hệ này làm bảng đầu tiên.
Entity2NavigationPropertyName	Tên của thuộc tính điều hướng có giá trị bộ sưu tập API Web cho mối quan hệ này làm bảng thứ hai.
Entity1AssociatedMenuConfiguration	Dữ liệu được sử dụng bởi các ứng dụng dựa trên mô hình để kiểm soát xem có thể truy cập dữ liệu bảng thứ hai trong giao diện người dùng từ bảng này làm bảng đầu tiên hay không và cách nào.
Entity2AssociatedMenuConfiguration	Dữ liệu được các ứng dụng điều chỉnh theo mô hình sử dụng để kiểm soát việc có thể truy nhập dữ liệu bảng thứ hai trong giao diện người dùng từ bảng này như bảng thứ hai hay không.