GETENUMVALUEBYNAME, funkcja ER

Artykuł
03/08/2023

Funkcja GETENUMVALUEBYNAME wyszukuje określoną wartość wyliczenia w źródle danych określonego wyliczenia przy użyciu nazwy wyliczenia, która jest określona jako wartość typu Ciąg. W przypadku znalezienia wartości typu Wyliczenie funkcja zwraca tę wartość. W przeciwnym razie funkcja zwraca wartość null wyliczenia.

Składnia

GETENUMVALUEBYNAME (enumeration data source path, enumeration value text)

Argumenty

enumeration data source path: Wyliczenie

Prawidłowa ścieżka źródła danych jednego z następujących typów wyliczenia:

Wyliczanie modelu raportowania elektronicznego (ER)
Wyliczenie formatu ER
Microsoft Dynamics 365 Finance — wyliczenia

enumeration value text : Ciąg

Wartość ciągu, która reprezentuje nazwę pojedynczej wartości wyliczenia.

Wartości zwracane

Wyliczenie z dopuszczalną wartością null

Wyjściowa wartość wyliczenia.

Uwagi dotyczące użytkowania

Wyjątek nie jest zgłaszany, jeśli wartość wyliczenia nie zostanie znaleziona przy użyciu nazwy wartości wyliczenia określonej jako wartość typu Ciąg.

Przykład 1

Na poniższej ilustracji wartość stałotekstowa ReportDirection została wprowadzona do modelu danych. Zauważ, że etykiety są zdefiniowane dla wartości wyliczenia.

Dostępne wartości dla wyliczenia modelu danych.

Na ilustracji przedstawiono następujące szczegóły:

Źródło danych $Direction jest skonfigurowane w raporcie ER. To źródło danych jest skonfigurowane na podstawie wyliczenia modelu ReportDirection.
Wyrażenie $IsArrivals jest zaprojektowane tak, aby używało źródła danych $Direction opartego na wyliczeniu modelu jako parametru tej funkcji.
Wartością tego wyrażenia porównania jest TRUE.

Przykład wyliczenia modelu danych.

Przykład 2

Funkcje GETENUMVALUEBYNAME i LISTOFFIELDS umożliwiają pobieranie wartości i etykiet obsługiwanych wyliczeń jako wartości tekstowe. (Obsługiwane wyliczenia to wyliczenia aplikacji, wyliczenia modeli danych i wyliczenia formatów.)

Na poniższej ilustracji źródło danych TransType zostało wprowadzone w odwzorowaniu modelu. To źródło danych odwołuje się do wyliczenia aplikacji LedgerTransType.

Źródło danych mapowania modelu, które odwołuje się do wyliczenia aplikacji.

Na poniższej ilustracji przedstawiono źródło danych TransTypeList skonfigurowane w odwzorowaniu modelu. To źródło danych jest skonfigurowane na podstawie wyliczenia aplikacji TransType. Funkcja LISTOFFIELDS służy do zwracania wszystkich wartości wyliczenia jako listy rekordów zawierających pola. W ten sposób szczegóły wszystkich wartości wyliczenia są ujawniane.

Banknot

Pole EnumValue jest skonfigurowane dla źródła danych TransTypeList za pomocą wyrażenia GETENUMVALUEBYNAME(TransType, TransTypeList.Name). To pole zwraca wartość wyliczenia dla każdego rekordu na liście.

Źródło danych mapowania modelu, które zwraca wszystkie wartości wyliczenia wybranego wyliczenia jako listę rekordów.

Na poniższej ilustracji przedstawiono źródło danych VendTrans skonfigurowane w odwzorowaniu modelu. To źródło danych zwraca rekordy transakcji dostawcy z tabeli aplikacji VendTrans. Typ księgi każdej transakcji jest określony przez wartość pola VendTrans.

Banknot

Pole TransTypeTitle jest skonfigurowane dla źródła danych VendTrans za pomocą wyrażenia FIRSTORNULL(WHERE(TransTypeList, TransTypeList.EnumValue = @.TransType)).Label. To pole zwraca etykietę wartości wyliczenia bieżącej transakcji jako tekst, jeśli ta wartość jest dostępna. W przeciwnym razie zwraca pustą wartość ciągu.

Pole TransTypeTitle jest powiązane z polem LedgerType modelu danych, które umożliwia używanie tych informacji w każdym formacie ER, który używa modelu danych jako źródła danych.

Źródło danych mapowania modelu, które zwraca transakcje dostawcy.

Na poniższej ilustracji przedstawiono sposób użycia debugera źródła danych do testowania skonfigurowanego mapowania modelu.

Użycie debugera źródła danych do testowania skonfigurowanego mapowania modelu.

Pole LedgerType model danych udostępnia etykiety typów transakcji zgodnie z oczekiwaniami.

Jeśli to rozwiązanie ma być używane w przypadku dużej ilości danych transakcyjnych, należy wziąć pod uwagę wydajność wykonania. Aby uzyskać więcej informacji, zobacz Śledzenie wykonywania formatów raportowania elektronicznego w celu rozwiązywania problemów z wydajnością.