LISTOFFIELDS, funkcja ER
Funkcja LISTOFFIELDS zwraca wartość typu Lista rekordów, która jest tworzona na podstawie struktury określonego argumentu typu Wyliczenie lub Kontener (rekord).
Składnia 1
LISTOFFIELDS (path)
Składnia 2
LISTOFFIELDS (path, language)
Argumenty
path: odwołanie do źródła danych
Prawidłowa ścieżka odwołania źródła danych jednego z następujących typów danych:
- Wyliczenie modeli
- Wyliczenie formatów
- Wyliczenie aplikacji
- Kontener (rekord)
language: Ciąg
Tekst, który reprezentuje kod języka.
Wartości zwracane
Lista rekordów
Wynikowa lista rekordów.
Uwagi dotyczące użytkowania
Utworzona lista składa się z rekordów zawierających następujące pola:
- Nazwa (typ danych Ciąg)
- Etykieta (typ danych Ciąg)
- Opis (typ danych Ciąg)
- Przetłumaczone (typ danych Wartość logiczna)
Jeśli argument path odwołuje się do źródła danych typu Kontener (rekord), dla każdego przywołanego pola rekordu kontenera do utworzonej listy dodawany jest nowy rekord. Dla każdego utworzonego rekordu pole nazwa zwraca nazwę pola przywołanego rekordu kontenera, dla którego utworzono bieżący rekord.
Jeśli argument path odwołuje się do źródła danych jednego z typów Wyliczenie, dla każdej wartości przywołanego wyliczenia do utworzonej listy dodawany jest nowy rekord. Dla każdego utworzonego rekordu pole Nazwa zwraca wartość przywołanego wyliczenia, dla którego utworzono bieżący rekord, pole Opis zwraca opis tego wyliczenia, a pole Etykieta — jego etykietę.
W czasie wykonywania, gdy jest używana składnia 1, pola Etykieta i Opis muszą zwracać wartości, które są oparte na ustawieniach językowych uruchomionego formatu modułu Raportowanie elektroniczne (ER):
- Jeśli etykiety i opisy dla żądanego języka są dostępne, pola Etykieta i Opis zwracają wartości oparte na tym języku, a pole Przetłumaczone zwraca wartość True.
- Jeśli etykiety i opisy dla żądanego języka są niedostępne, pola Etykieta i Opis zwracają wartości oparte na domyślnym języku EN-US, a pole Przetłumaczone zwraca wartość False.
W czasie wykonywania, gdy jest używana składnia 2, pola Etykieta i Opis muszą zwracać wartości, które są oparte na języku zdefiniowanym jako drugi argument wywołanej funkcji:
- Jeśli etykiety i opisy dla żądanego języka są dostępne, pola Etykieta i Opis zwracają wartości oparte na tym języku, a pole Przetłumaczone zwraca wartość True.
- Jeśli etykiety i opisy dla żądanego języka są niedostępne, pola Etykieta i Opis zwracają wartości oparte na języku EN-US, a pole Przetłumaczone zwraca wartość False.
Przykład 1
Na poniższej ilustracji wyliczenie zostało wprowadzone do modelu danych ER.
Na ilustracji przedstawiono następujące szczegóły:
- Wartość stałotekstowa modelu wstawiona do raportu jako źródło danych.
- W wyrażeniu ER wyliczenie modelu jest używane jako parametr funkcji
LISTOFFIELDS. - Źródło danych typu Lista rekordów jest wstawiane do raportu przy użyciu utworzonego wyrażenia ER.
W poniższym przykładzie pokazano elementy formatu ER, które są powiązane ze źródłem danych typu Lista rekordów utworzonym przy użyciu funkcji LISTOFFIELDS.
Na ilustracji poniżej widać wynik uruchomienia zaprojektowanego formatu.
Banknot
Zgodnie z ustawieniami języka nadrzędnych elementów formatu PLIK i FOLDER przetłumaczone teksty etykiet i opisów są wprowadzane do danych wyjściowych formatu ER.
Przykład 2
Typ źródła danych Pole obliczeniowe jest używane do konfigurowania źródeł danych enumType_de i enumType_deCH dla wyliczenia modelu danych enumType:
- enumType_de =
LISTOFFIELDS (enumType, "de") - enumType_deCH =
LISTOFFIELDS (enumType, "de-CH")
W tym przypadku można użyć następującego wyrażenia, aby otrzymać etykietę wyliczenia w języku niemieckim (Szwajcaria), jeśli takie tłumaczenie jest dostępne. Jeśli tłumaczenie na język niemiecki (Szwajcaria) nie jest dostępne, etykieta pozostaje w języku niemieckim.
IF (NOT (enumType_deCH.IsTranslated), enumType_de.Label, enumType_deCH.Label)