Udostępnij przez


Tabela/odwołanie do encji Dynamics 365 Sales

Tabele Dataverse zapewniają wspólny zestaw tabel, które mają wszystkie bazy danych środowiska.

Tabela/referencja jednostek aplikacji Dynamics 365 zawiera dodatkowe tabele wymagane przed zainstalowaniem aplikacji Dynamics 365, takie jak Sales.

Tabele wymienione w tym miejscu są dodawane lub modyfikowane po wybraniu opcji instalacji usługi Dynamics 365 Sales podczas dodawania usługi Dataverse do utworzonego środowiska.

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

  • IsPrivate równa się false

  • IsIntersect jest równe false lub IsIntersect jest równe true, a tabela zawiera więcej niż 4 kolumny.

    • Większość tabel krzyżowych zawiera tylko 4 kolumny niezbędne do obsługi relacji wiele-do-wielu. Nie są przydatne. Tabele przecięte z więcej niż czterema kolumnami są bardziej interesujące.

Messages

Komunikaty na tej liście mają zastosowanie do jednostki. Na przykład tabele należące do użytkownika obsługują Assign, GrantAccess, ModifyAccess oraz RevokeAccess podczas gdy tabele należące do organizacji nie.

SDK dla platformy .NET

Korzystając z zestawu SDK dla platformy .NET, zazwyczaj można wywołać odpowiednią klasę żądania, która będzie należeć do Microsoft.Crm.Sdk.Messages lub Microsoft.Xrm.Sdk.Messages namespaces. Nazwy tych klas zawierają prefiks Request dodany do nazwy wiadomości.

Niektóre wiadomości są dodawane jako akcje niestandardowe dla obsługiwanych przez nie rozwiązań. Te komunikaty nie są zdefiniowane w zestawach SDK, ale istnieje kilka sposobów ich używania.

Internetowe API

W przypadku korzystania z internetowego interfejsu API można znaleźć typowe funkcje i akcje OData Dataverse zdefiniowane w tych dokumentacjach:

W przypadku tych funkcji i akcji oraz wszystkich dodanych dodatkowych można dowiedzieć się, jak z nich korzystać, wykonując następujące czynności:

  1. Zapoznaj się z dokumentem usługi $metadata, aby uzyskać szczegółowe informacje na temat parametrów i zwracanych wartości. Aby uzyskać szczegółowe informacje, zobacz Definicje akcji i Definicje funkcji.
  2. Wywoływanie akcji i funkcji. Aby uzyskać szczegółowe informacje, zobacz Korzystanie z akcji internetowego interfejsu API i Korzystanie z funkcji internetowego interfejsu API.

Events

Wydarzenia to wiadomości, które istnieją, aby można było je subskrybować. Jeśli zdarzenie nie zostało dodane przez Ciebie, nie powinieneś wywoływać wiadomości, a jedynie ją zasubskrybować. Możesz subskrybować wydarzenia na kilka różnych sposobów, na przykład:

Właściwości

Ta sekcja zawiera wybrane właściwości encji, a nie wszystkie. Uwzględniane są tylko te właściwości, które mają być najbardziej przydatne dla deweloperów. Niektóre wartości właściwości encji można zmienić.

Kolumny

Kolumny są wymienione w dwóch oddzielnych sekcjach: Kolumny/atrybuty do zapisu i Kolumny/atrybuty tylko do odczytu. Celem tego rozdzielenia jest skoncentrowanie się na kolumnach, które deweloper może ustawić podczas tworzenia lub aktualizowania wierszy w tabeli. Zrozumienie tych kolumn pomaga deweloperowi zrozumieć, co może zrobić z tabelą poza samym pobieraniem wartości.

Kolumny w sekcji Kolumny/atrybuty zapisywalne zwracają wartość true dla właściwościIsValidForCreate lub IsValidForUpdate (zwykle obu). Jeśli którakolwiek z tych właściwości zwraca wartość false, jest to wskazane.

Kolumny/atrybuty tylko do odczytu zawsze zwracają wartość false dla właściwości IsValidForCreateiIsValidForUpdate .

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. Różnice te są bardziej zbliżone do opcji, które najlepiej pasują do języka lub kultury. Możesz dostosować te opcje, zmieniając etykiety lub dodając i usuwając opcje w razie potrzeby.

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

Należy pamiętać, że chociaż każda tabela zawiera listę relacji, które mają do niej zastosowanie, każda relacja jest wspólna dla obu tabel. Relacje istnieją między tabelami. Chociaż istnieją relacje typu „jeden do wielu”, Wiele-do-jednego relacje są po prostu widokiem relacji jeden do wielu z tabeli odniesienia.

Relacje wiele-do-jednego

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

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, które operacje wykonywane na jednostce nadrzędnej będą kaskadowo spływać w dół do encji pokrewnych.
Więcej informacji: Konfiguracja kaskadowa

Relacje jeden-do-wielu

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

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.
Więcej informacji: 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ą uwzględniane następujące właściwości:

Majątek Description
IntersectEntityName Nazwa logiczna tabeli przecięcia, która obsługuje tę relację wiele-do-wielu.
Tej wartości można użyć podczas łączenia kolumn tabeli przy użyciu FetchXml
IsCustomizable Określa, czy można zmienić właściwości relacji.
SchemaName Nazwa schematu relacji.
IntersectAttribute Nazwa kolumny w tabeli przecięcia, która jest kluczem podstawowym dla rekordów tego typu.
NavigationPropertyName 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 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 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 drugiej tabeli