Del via


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.

Opplisting i en modell

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.

Format

Eksemplet nedenfor viser elementene i ER-formatet som er bundet til datakilden for Postliste-typen som ble opprettet ved hjelp av funksjonen LISTOFFIELDS.

Formatutforming

Følgende illustrasjon viser resultatet når det utformede formatet kjøres.

Formatutdata

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)

Tilleggsressurser

Listefunksjoner