GETENUMVALUEBYNAME, funkcja ER
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.
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
$IsArrivalsjest 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 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.
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.
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.
Na poniższej ilustracji przedstawiono sposób użycia 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ą.