Funkce elektronického výkaznictví LISTOFFIELDS
Funkce LISTOFFIELDS vrátí hodnotu typu seznam záznamů, která je vytvořena na základě struktury zadaného argumentu typu výčet nebo kontejner (záznam).
Syntaxe 1
LISTOFFIELDS (path)
Syntaxe 2
LISTOFFIELDS (path, language)
Argumenty
path: Reference zdroje dat
Platná cesta odkazu na zdroj dat jednoho z následujících datových typů:
- Výčet modelu
- Výčet formátu
- Výčet aplikací
- Kontejner (záznam)
language: Řetězec
Text, který představuje kód jazyka.
Vrácené hodnoty
Seznam záznamů
Výsledný seznam záznamů.
Poznámky k použití
Vytvořený seznam obsahuje záznamy, které mají následující pole:
- Name (datový typ řetezec)
- Label (datový typ řetezec)
- Description (datový typ řetezec)
- IsTranslated (logický datový typ)
Pokud argument path odkazuje na zdroj dat typu kontejner (záznam), pro každé pole odkazovaného záznamu kontejneru je do vytvořeného seznamu přidán nový záznam. Pro každý vytvořený záznam vrátí pole Name název pole odkazovaného záznamu kontejneru, pro který byl aktuální záznam vytvořen.
Pokud argument path odkazuje na zdroj dat jednoho z typů výčet, pro každou hodnotu výčtu odkazovaného výčtu je do vytvořeného seznamu přidán nový záznam. Pro každý vytvořený záznam vrátí pole Name hodnotu odkazovaného výčtu, pro který byl vytvořen aktuální záznam, pole Description vrátí popis tohoto výčtu a pole Label vrátí popisek tohoto výčtu.
V době běhu je při použití syntaxe 1 nutné, aby pole Label a Description vrátila hodnoty, které jsou založeny na jazykovém nastavení formátu spuštěného elektronického vykazování (ER):
- Jsou-li k dispozici popisky a popisy požadovaného jazyka, vrátí pole Label a Description hodnoty, které jsou založeny na daném jazyku, a pole IsTranslated vrátí hodnotu True.
- Nejsou-li k dispozici popisky a popisy požadovaného jazyka, vrátí pole Label a Description hodnoty, které jsou založeny na výchozím jazyku EN-US, a pole IsTranslated vrátí hodnotu False.
V době běhu je při použití syntaxe 2 nutné, aby pole Label a Description vrátila hodnoty, které jsou založeny na jazyku, který je definován jako druhý argument volané funkce:
- Jsou-li k dispozici popisky a popisy požadovaného jazyka, vrátí pole Label a Description hodnoty, které jsou založeny na daném jazyku, a pole IsTranslated vrátí hodnotu True.
- Nejsou-li k dispozici popisky a popisy požadovaného jazyka, vrátí pole Label a Description hodnoty, které jsou založeny na jazyku EN-US, a pole IsTranslated vrátí hodnotu False.
Příklad 1
Na následujícím obrázku je výčet uveden v datovém modelu elektronického vykazování.
Následující obrázek znázorňuje tyto podrobnosti:
- Výčet modelů je vložen do sestavy jako zdroj dat.
- Výraz elektronického výkaznictví používá výčet modelů jako parametr funkce
LISTOFFIELDS. - Zdroj dat typu seznamu záznamů je vložen do sestavy pomocí vytvořeného výrazu elektronického výkaznictví.
Následující příklad uvádí prvky formátu ER, které jsou vázané na zdroj dat typu seznamu záznamů, který byl vytvořen pomocí funkce LISTOFFIELDS.
Následující obrázek znázorňuje výsledek při spuštění navrženého formátu.
Poznámka
Přeložený text popisků a popisů je zadáván do výstupu formátu elektronického výkaznictví na základě nastavení jazyka nadřazených prvků formátu FILE a FOLDER.
Příklad 2
Typ datového zdroje Vypočítané pole použijete ke konfiguraci zdrojů dat enumType_de a enumType_deCH pro výčet datových modelů enumType:
- enumType_de =
LISTOFFIELDS (enumType, "de") - enumType_deCH =
LISTOFFIELDS (enumType, "de-CH")
V takovém případě můžete použít následující výraz k získání popisku hodnoty výčtu ve švýcarské němčině, pokud je tento překlad k dispozici. Není-li k dispozici překlad do švýcarské němčiny, je popisek v němčině.
IF (NOT (enumType_deCH.IsTranslated), enumType_de.Label, enumType_deCH.Label)