Odwołanie do tabeli/jednostki usługi Dataverse

Użyj tego odwołania, aby zrozumieć dostępne operacje dla określonych tabel, kolumn domyślnych każdej tabeli i relacje między tabelami. Definicje tabel używają klasy EntityMetadata.

Odniesienie to obejmuje tylko te tabele, w których:

  • EntityMetadata.IsPrivate Równa false

    Ten warunek wyklucza tabele bez zewnętrznych przypadków użycia.

  • EntityMetadata.IsIntersect false równa się lub IsIntersect równa true się, a tabela zawiera więcej niż cztery kolumny.

    Większość tabel krzyżowych zawiera tylko cztery kolumny niezbędne do obsługi relacji wiele-do-wielu. Nie są one przydatne. Przecięcie tabel z więcej niż czterema kolumnami nie są wspólne i bardziej interesujące.

Aby wyświetlić informacje o wszystkich tabelach w środowisku, zobacz Przeglądanie definicji tabel w danym środowisku.

Dokumentacja tabeli produktów dynamics 365

Produkty dynamics 365 używają usługi Dataverse. Podczas tworzenia środowiska dla produktów Dynamics 365 środowisko ma wspólny zestaw tabel dla wszystkich produktów usługi Dynamics 365. Zobacz dokumentację tabeli/jednostki aplikacji z włączoną obsługą Dynamics 365.

Każdy konkretny produkt Dynamics 365 może dodawać więcej tabel. W poniższej tabeli przedstawiono odwołanie do tabeli dla określonych produktów usługi Dynamics 365:

Dokumentacja produktu Odniesienie do tabeli produktów
Sprzedaż Odwołanie do tabeli/encji sprzedaży
Serwis terenowy Odniesienie do tabeli/encji usługi Field Service
Obsługa klienta Odniesienie do tabeli/encji Customer Service

Właściwości

Ta sekcja zawiera wybrane właściwości encji, a nie wszystkie. Zawiera tylko te właściwości, które są najbardziej przydatne dla deweloperów. Możesz zmienić niektóre wartości właściwości jednostki.

Kolumny

Kolumny są wymienione w dwóch oddzielnych sekcjach:

Section Description
Zapisywalne kolumny/atrybuty Kolumny, które można ustawić podczas tworzenia lub aktualizowania wierszy w tabeli. Te kolumny są zwracane true dla AttributeMetadata.IsValidForCreate obu właściwości lub AttributeMetadata.IsValidForUpdate . Jeśli którakolwiek z właściwości zwróci falsewartość , ten warunek jest wskazywany.
Kolumny/atrybuty tylko do odczytu Kolumny, które można pobrać, ale nie można ustawić podczas tworzenia lub aktualizowania wierszy w tabeli. Te kolumny zawsze zwracają falseAttributeMetadata.IsValidForCreate właściwości i AttributeMetadata.IsValidForUpdate .

Opcje kolumn do wyboru

Opcje kolumn wyboru w tej dokumentacji referencyjnej pochodzą z wdrożenia, w którym język angielski jest językiem podstawowym. Niektóre opcje wyboru mogą się różnić w zależności od języka podstawowego wybranego podczas tworzenia środowiska. Te różnice ściślej pasują do opcji, które najlepiej pasują do języka lub kultury. Te opcje można dostosować, zmieniając etykiety lub dodając i usuwając opcje zgodnie z potrzebami.

Relacje

Klasa EntityMetadata zawiera trzy właściwości reprezentujące relacje:

Majątek Typ Description
OneToManyRelationships OneToManyRelationshipMetadata[] Pobiera tablicę relacji jeden-do-wielu dla jednostki.
ManyToOneRelationships OneToManyRelationshipMetadata[] Pobiera tablicę relacji wiele-do-jednego dla encji.
ManyToManyRelationships ManyToManyRelationshipMetadata[] Pobiera tablicę relacji wiele-do-wielu dla danej encji.

Uwaga / Notatka

Podczas gdy każda tabela zawiera listę relacji, które mają do niej zastosowanie, każda relacja jest współużytkowany przez obie tabele. Relacje istnieją między tabelami. Chociaż istnieją relacje jeden do wielu, relacje wiele do jednego są po prostu widokiem relacji jeden do wielu z tabeli odwołującej się.

Relacje wiele-do-jednego

Obejmuje następujące OneToManyRelationshipMetadata właściwości klasy :

Majątek Description
ReferencedEntity Nazwa logiczna powiązanej tabeli.
ReferencedAttribute Nazwa logiczna klucza podstawowego powiązanej tabeli.
ReferencingEntity Nazwa logiczna powiązanej tabeli, w której znajduje się kolumna odnośnika.
ReferencingAttribute Nazwa logiczna kolumny odnośnika w powiązanej tabeli, która zawiera odwołanie do klucza podstawowego tabeli podstawowej.
IsHierarchical Czy relacja reprezentuje hierarchiczną relację typu odniesienie do samego siebie
CascadeConfiguration Dane opisujące operacje wykonywane na jednostce nadrzędnej kaskadowo do powiązanych jednostek.
Aby uzyskać więcej informacji, zobacz Konfiguracja kaskadowa.

Relacje jeden-do-wielu

Obejmuje następujące OneToManyRelationshipMetadata właściwości klasy :

Majątek Description
ReferencingEntity Nazwa logiczna powiązanej tabeli.
ReferencingAttribute Nazwa logiczna kolumny w powiązanej tabeli, która zawiera odwołanie do klucza podstawowego tabeli podstawowej.
IsCustomizable Określa, czy można zmienić właściwości relacji.
ReferencedEntityNavigationPropertyName Nazwa właściwości nawigacji z wartościami kolekcji internetowego interfejsu API dla tej relacji.
Aby uzyskać więcej informacji, zobacz Właściwości nawigacji interfejsu API sieci Web.
AssociatedMenuConfiguration Dane używane przez aplikacje oparte na modelu do kontrolowania, czy i jak można uzyskać dostęp do powiązanych danych encji w interfejsie użytkownika z encji podstawowej.

Relacje wiele-do-wielu

Każda relacja wiele-do-wielu zawiera Entity1LogicalName i Entity2LogicalName. W tej dokumentacji szczegóły relacji są podane w kontekście bieżącej tabeli. Czy to jest Entity1, czy Entity2 nie jest naprawdę ważne.

Dla każdej relacji wiele-do-wielu są zawarte następujące ManyToManyRelationshipMetadata właściwości klasy :

Majątek Description
IntersectEntityName Nazwa logiczna tabeli przecięcia, która obsługuje tę relację wiele-do-wielu.
IsCustomizable Określa, czy można zmienić właściwości relacji.
SchemaName Nazwa schematu relacji.
IntersectAttribute (Entity1IntersectAttribute lub Entity2IntersectAttribute) Nazwa kolumny w tabeli przecięcia, która jest kluczem podstawowym dla rekordów tego typu.
NavigationPropertyName (Entity1NavigationPropertyName lub Entity2NavigationPropertyName) Nazwa właściwości nawigacji z wartościami kolekcji internetowego interfejsu API dla tej relacji.
Więcej informacji: Właściwości nawigacji interfejsu API sieci Web
AssociatedMenuConfiguration (Entity1AssociatedMenuConfiguration lub Entity2AssociatedMenuConfiguration) Dane wykorzystywane przez aplikacje oparte na modelach do kontrolowania, czy i w jaki sposób dane z drugiej tabeli mogą być dostępne w interfejsie użytkownika z tej tabeli.

W rzadkich przypadkach, gdy relacja wiele-do-wielu jest odwołuje się sama do siebie, np. dla Rola połączenia (ConnectionRole) connectionroleassociation_association, Entity1 lub Entity2 jest dodawany przed właściwością.

Majątek Wartość
Entity1IntersectAttribute Nazwa kolumny w tabeli przecięcia, która jest kluczem podstawowym dla rekordów tego typu jako pierwsza tabela.
Entity2IntersectAttribute Nazwa kolumny w tabeli przecięcia, która jest kluczem podstawowym dla rekordów tego typu jako druga tabela.
Entity1NavigationPropertyName Nazwa właściwości nawigacji z wartościami kolekcji internetowego interfejsu API dla tej relacji jako pierwszej tabeli.
Entity2NavigationPropertyName Nazwa właściwości nawigacji z wartościami kolekcji internetowego interfejsu API dla tej relacji jako drugiej tabeli.
Entity1AssociatedMenuConfiguration Dane wykorzystywane przez aplikacje oparte na modelach do kontrolowania, czy i w jaki sposób dane z drugiej tabeli mogą być dostępne w interfejsie użytkownika z tej tabeli jako pierwszej tabeli.
Entity2AssociatedMenuConfiguration Dane używane przez aplikacje oparte na modelu do kontrolowania, czy i jak drugie dane tabeli mogą być dostępne w interfejsie użytkownika z tej tabeli jako druga tabela.