LISTOFFIELDS ER-funktion

LISTOFFIELDS-funktionen returnerar ett postlista-värde som skapas baserat på strukturen för det angivna argumentet i typen uppräkning eller behållare (post).

Syntax 1

LISTOFFIELDS (path)

Syntax 2

LISTOFFIELDS (path, language)

Argument

path: datakällareferens

Den giltiga referenssökvägen till en datakälla för någon av följande datatyper:

• Uppräkning för modell
• Formatuppräkning
• Uppräkning för program
• Behållare (post)

language: Sträng

Text som representerar en språkkod.

Returvärden

Postlista

Den resulterande listan med poster.

Användningsanteckningar

Listan som skapas består av poster som innehåller följande fält:

• Namn (Sträng datatyp)
• Etikett (Sträng datatyp)
• Beskrivning (Sträng datatyp)
• Istranslated (boolesk datatyp)

Om path-argumentet refererar till en datakälla för typen behållare (post), läggs en ny post till i listan som skapas för varje fält i den refererade behållarposten. För varje post som skapas returnerar fältet namn namnet på fältet för den refererade behållarposten som den aktuella posten skapades för.

Om path-argumentet refererar till en datakälla för en av typerna Uppräkning, för varje uppräkningsvärde för den refererade uppräkningen läggs en ny post till i listan som skapades. För varje post som skapades returnerar fältet Namn fältet returnerar värdet på den refererade uppräkningen som den aktuella posten skapades för, fältet beskrivning returnerar beskrivningen av uppräkningen och fältet etikett returnerar etiketten för den uppräkningen.

Vid körning, när syntax 1 används, måste fälten etikett och beskrivning returnera värden som baseras på språkinställningarna för det format för elektronisk rapportering (ER) som körs:

• Om etiketterna och beskrivningarna för det begärda språket är tillgängliga returnerar fälten etikett och beskrivning värden som baseras på det språket, och fältet IsTranslated returneras sant.
• Om etiketterna och beskrivningarna för det begärda språket inte är tillgängliga returnerar fälten etikett och beskrivning värden som baseras på standardspråket EN-US och fältet IsTranslated returneras falskt.

Vid körning, när syntax 2 används, måste fälten etikett och beskrivning returnera värden som baseras på språket som definieras som det andra argumentet av de anropade funktionerna:

• Om etiketterna och beskrivningarna för det begärda språket är tillgängliga returnerar fälten etikett och beskrivning värden som baseras på det språket, och fältet IsTranslated returneras sant.
• Om etiketterna och beskrivningarna för det begärda språket inte är tillgängliga returnerar fälten etikett och beskrivning värden som baseras på språket EN-US och fältet IsTranslated returneras falskt.

Exempel 1

I följande illustration introduceras en uppräkning i en ER-datamodell.

Illustrationen som följer visar dessa detaljer:

• Modelluppräkningen har infogats i en rapport som en datakälla.
• ER-uttryck använder uppräkningsmodellen som en parameter för funktionen LISTOFFIELDS.
• En datakälla av typen postlista infogas i en rapport med hjälp av det ER-uttryck som skapats.

Följande exempel visar de ER-formatelement som är kopplade till en datakälla av typen postlista som skapats med funktionen LISTOFFIELDS.

Följande illustration visar resultatet när det designade formatet har körts.

Notering

Baserat på språkinställningarna i de överordnade FILE- och FOLDER-elementen infogas översatt text för etiketter och beskrivningar i utdata till ER-formatet.

Exempel 2

Till exempel kan du använda datakälltypen Beräknat fält för att konfigurera datakällor för enumType_de och enumType_deCH för uppräkning av datamodell enumType:

• enumType_de = LISTOFFIELDS (enumType, "de")
• enumType_deCH = LISTOFFIELDS (enumType, "de-CH")

I det här fallet kan du använda följande uttryck för att få etiketten på uppräkningsvärdet på tyska (Schweiz), om denna översättning är tillgänglig. Om schweizisk tysk översättning inte är tillgänglig är etiketten på tyska.

IF (NOT (enumType_deCH.IsTranslated), enumType_de.Label, enumType_deCH.Label)

Ytterligare resurser

Lista över funktioner