Udostępnij przez


Odniesienie do tabeli/encji Dynamics 365 Field Service

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

Odniesienie do tabeli/encji aplikacji z obsługą usługi Dynamics 365 zawiera dodatkowe tabele, które są wymagane przed zainstalowaniem aplikacji Dynamics 365, takich jak Field Service.

Tabele wymienione w tym miejscu są dodawane lub modyfikowane po wybraniu instalacji Dynamics 365 Field Service podczas dodawania Dataverse do utworzonego środowiska. Schematy tabel mogą wyglądać inaczej, jeśli w środowisku Dataverse są zainstalowane inne aplikacje.

Uwaga / Notatka

Ta dokumentacja referencyjna nie obejmuje niektórych tabel, które istnieją w danym środowisku. Na przykład tabele, które są przeznaczone tylko do użytku wewnętrznego i takie, które uważamy za mniej istotne dla deweloperów usługi Field Service. Zmiany w schematach tabel nie są odzwierciedlane natychmiast, ponieważ generujemy tę dokumentację w określonych odstępach czasu.

Tę dokumentację referencyjną udostępniliśmy w lutym 2025 r. Być może zauważysz zmiany częściej, gdy zbierzemy wstępne opinie i zajmiemy się nimi.

Aby wyświetlić bieżące i niefiltrowane informacje dla wszystkich tabel w środowisku Dataverse, użyj przeglądarki definicji tabel. Przeglądarka definicji tabel to rozwiązanie zarządzane opisane w temacie Przeglądanie definicji tabel w danym środowisku.

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

  • IsPrivate równa się false

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

    • Większość tabel przecinających się 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żytkowników obsługują Assignwiadomości , GrantAccess, ModifyAccessi RevokeAccess , podczas gdy tabele należące do organizacji nie.

Zestaw SDK dla platformy .NET

W przypadku korzystania z zestawu SDK dla platformy .NET zwykle można wywołać odpowiednią klasę żądania, która będzie należeć do przestrzeni nazw Microsoft.Crm.Sdk.Messages lub Microsoft.Xrm.Sdk.Messages . Te klasy mają nazwy, które zawierają prefiks Request dodany do nazwy komunikatu.

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
Relacje OneToManyRelationships OneToManyRelationshipMetadata[] Pobiera tablicę relacji jeden-do-wielu dla jednostki.
Relacje WieleToOne OneToManyRelationshipMetadata[] Pobiera tablicę relacji wiele-do-jednego dla encji.
WieleDo WieluRelacji WieleToWieluMetadanych[] Pobiera tablicę relacji wiele-do-wielu dla jednostki.

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. Między tabelami istnieją relacje. Chociaż istnieją relacje jeden-To-Many, relacje wiele-do-jednego są po prostu widokiem relacji jeden-To-Many z tabeli odwołań.

Relacje wiele-do-jednego

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

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 OneToManyRelationship właściwości:

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 internetowego interfejsu API
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 internetowego interfejsu API
AssociatedMenuConfiguration Dane używane przez aplikacje oparte na modelu do kontrolowania, czy i jak można uzyskać dostęp do danych drugiej tabeli w interfejsie użytkownika z tej tabeli.

W rzadkim przypadku, gdy relacja wiele-do-wielu odwołuje się do siebie, na przykład dla Entity1 lub Entity2 jest poprzedzona 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 drugiej tabeli.
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 używane przez aplikacje oparte na modelu do kontrolowania, czy i jak można uzyskać dostęp do danych drugiej tabeli w interfejsie użytkownika z tej tabeli jako pierwszej tabeli.
Entity2AssociatedMenuConfiguration Dane używane przez aplikacje oparte na modelu do kontrolowania, czy i w jaki sposób można uzyskać dostęp do danych drugiej tabeli w interfejsie użytkownika z tej tabeli jako drugiej tabeli