LISTOFFIELDS ER-funksjonen
LISTOFFIELDS
-funksjonen returnerer en postliste-verdi som opprettes basert på strukturen til det angitte argumentet for typen Opplisting eller Container (post).
Syntaks 1
LISTOFFIELDS (path)
Syntaks 2
LISTOFFIELDS (path, language)
Argumenter
path
: Datakildereferanse
Den gyldige referansebanen til en datakilde for en av følgende datatyper:
- Modellopplisting
- Formatopplisting
- Opplisting av programmer
- Container (post)
language
: Streng
Tekst som representerer en språkkode.
Returverdier
Postliste
Den resulterende listen over oppføringer.
Bruksnotater
Listen som opprettes, består av poster med følgende felt:
- Navn (Streng-datatype)
- Etikett (Streng-datatype)
- Beskrivelse (Streng-datatype)
- IsTranslated (boolsk datatype)
Hvis path
-argumentet refererer til en datakilde av typen Container (post), legges det til en ny post i listen som opprettes, for hvert felt i container-posten det refereres til. For hver post som opprettes, vil navn-feltet returnere navnet på feltet i den refererte container-posten som gjeldende post ble opprettet for.
Hvis path
-argumentet refererer til en datakilde for en av Opplisting-typene, legges det til en ny post i listen som opprettes, for hver opplistingsverdi i opplistingsposten det refereres til. For hver post som opprettes, returnerer Navn-feltet verdien for den refererte opplistingen som gjeldende post ble opprettet for. Beskrivelse-feltet returnerer beskrivelsen av denne opplistingen, og Etikett-feltet returnerer etiketten for denne opplistingen.
Når syntaks 1 brukes i kjøretid, må Etikett- og Beskrivelse-feltene returnere verdier som er basert på språkinnstillingene for ER-formatet som kjører:
- Hvis etikettene og beskrivelsene for det forespurte språket er tilgjengelige, returnerer Etikett- og Beskrivelse-feltene verdier som er basert på dette språket, og IsTranslated-feltet returnerer Sann.
- Hvis etikettene og beskrivelsene for det forespurte språket ikke er tilgjengelige, returnerer Etikett- og Beskrivelse-feltene verdier som er basert på standard EN-US-språket, og IsTranslated-feltet returnerer Usann.
Når syntaks 2 brukes i kjøretid, må Etikett- og Beskrivelse-feltene returnere verdier som er basert på språket som er definert som det andre argumentet for den kalte funksjonen:
- Hvis etikettene og beskrivelsene for det forespurte språket er tilgjengelige, returnerer Etikett- og Beskrivelse-feltene verdier som er basert på dette språket, og IsTranslated-feltet returnerer Sann.
- Hvis etikettene og beskrivelsene for det forespurte språket ikke er tilgjengelige, returnerer Etikett- og Beskrivelse-feltene verdier som er basert på EN-US-språket, og IsTranslated-feltet returnerer Usann.
Eksempel 1
I følgende illustrasjon introduseres en opplisting i en ER-datamodell.
Illustrasjonen nedenfor viser disse detaljene:
- Modellopplistingen settes inn i en rapport som en datakilde.
- Et ER-uttrykk bruker modellopplistingen som en parameter i
LISTOFFIELDS
-funksjonen. - En datakilde av Postliste-typen settes inn i en rapport ved hjelp av det opprettede ER-uttrykket.
Eksemplet nedenfor viser elementene i ER-formatet som er bundet til datakilden for Postliste-typen som ble opprettet ved hjelp av funksjonen LISTOFFIELDS
.
Følgende illustrasjon viser resultatet når det utformede formatet kjøres.
Notat
Basert på språkinnstillingene for de overordnede FILE og FOLDER-formatelementene, angis oversatt tekst for etiketter og beskrivelser i utdataene i ER-formatet.
Eksempel 2
Du bruker Beregnet felt-datakildetypen til å konfigurere datakildene enumType_de og enumType_deCH for enumType-datamodellopplisting:
- enumType_de =
LISTOFFIELDS (enumType, "de")
- enumType_deCH =
LISTOFFIELDS (enumType, "de-CH")
I dette tilfellet kan du bruke følgende uttrykk til å hente etiketten for opplistingsverdien på sveitsisk (tysk) hvis denne oversettelsen er tilgjengelig. Hvis sveitsisk (tysk) oversettelse ikke er tilgjengelig, er etiketten på tysk.
IF (NOT (enumType_deCH.IsTranslated), enumType_de.Label, enumType_deCH.Label)