ER-funktionen LISTOFFIELDS
Funktionen LISTOFFIELDS returnerer en Postliste-værdi, der er oprettet på baggrund af strukturen af det angivne argument i typen Fasttekst eller Container (post).
Syntaks 1
LISTOFFIELDS (path)
Syntaks 2
LISTOFFIELDS (path, language)
Argumenter
path: Datakildenreference
Den gyldige referencesti til en datakilde for en af følgende datatyper:
- Modelfasttekst
- Formatfasttekst
- Programfasttekst
- Container (post)
language: Streng
Tekst, der repræsenterer en sprogkode.
Returnerede værdier
Liste over poster
Den resulterende liste over poster.
Bemærkninger til brug
Den liste, der oprettes, består af poster, der har følgende felter:
- Navn (Streng-datatype)
- Etiket (Streng-datatype)
- Beskrivelse (Streng-datatype)
- IsTranslated (Boolesk-datatype)
Hvis path-argumentet refererer til en datakilde for typen Container (post), føjes der en ny post til den liste, der oprettes, for hvert felt i den refererede containerpost. For hver post, der oprettes, returnerer feltet Navn navnet på feltet for den containerpost, der refereres til, som den aktuelle post blev oprettet for.
Hvis path-argumentet refererer til en datakilde af typen Fasttekst, føjes der en ny post til den liste, der oprettes, for hver fasttekstværdi i den refererede fasttekst. For hver post, der oprettes, returnerer feltet Navn værdien af den refererede fasttekst, som den aktuelle post er oprettet for; feltet Beskrivelse returnerer beskrivelsen af denne fasttekst, og feltet Etiket returnerer etiketten for den pågældende fasttekst.
Når der på kørselstidspunktet bruges syntaks 1, skal felterne Etiket og Beskrivelse returnere værdier, der er baseret på sprogindstillingerne i det elektroniske rapporteringsformat (ER), der kører:
- Hvis etiketterne og beskrivelserne for det ønskede sprog er tilgængelige, returnerer felterne Etiket og Beskrivelse værdier, der er baseret på det pågældende sprog, og feltet IsTranslated returnerer Sandt.
- Hvis etiketterne og beskrivelserne for det ønskede sprog ikke er tilgængelige, returnerer felterne Etiket og Beskrivelse værdier, der er baseret på standardsproget EN-US, og feltet IsTranslated returnerer Falsk.
Når der på kørselstidspunktet bruges syntaks 2, skal felterne Etiket og Beskrivelse returnere værdier, der er baseret på det sprog, som der er defineret som det andet argument i den kaldte funktion:
- Hvis etiketterne og beskrivelserne for det ønskede sprog er tilgængelige, returnerer felterne Etiket og Beskrivelse værdier, der er baseret på det pågældende sprog, og feltet IsTranslated returnerer Sandt.
- Hvis etiketterne og beskrivelserne for det ønskede sprog ikke er tilgængelige, returnerer felterne Etiket og Beskrivelse værdier, der er baseret på sproget EN-US, og feltet IsTranslated returnerer Falsk.
Eksempel 1
I følgende illustration introduceres en fasttekst i en ER-datamodel.
Følgende illustration viser disse detaljer:
- Modelfastteksten indsættes i en rapport som en datakilde.
- Et ER-udtryk bruger modelfastteksten som et parameter til funktionen
LISTOFFIELDS. - En datakilde af typen Postliste indsættes i en rapport ved hjælp af det oprettede ER-udtryk.
Følgende eksempel viser de ER-formatelementer, der er bundet til datakilden af typen Postliste, der blev oprettet ved hjælp af funktionen LISTOFFIELDS.
I følgende illustration vises resultatet, når det designede format køres.
Bemærk!
Baseret på sprogindstillingerne til de overordnede formatelementer for FILE og FOLDER, udfyldes oversat tekst til etiketter og beskrivelser i outputtet til ER-formatet.
Eksempel 2
Du bruger datakildetypen Beregnet felt til at konfigurere datakilderne enumType_de og enumType_deCH for datamodelfastteksten enumType:
- enumType_de =
LISTOFFIELDS (enumType, "de") - enumType_deCH =
LISTOFFIELDS (enumType, "de-CH")
I dette tilfælde skal kan du bruge følgende udtryk til at få etiketten til tællerværdien på tysk (Schweiz), hvis den pågældende oversættelse er tilgængelig. Hvis oversættelsen til tysk (Schweiz) ikke er tilgængelig, er etiketten på tysk.
IF (NOT (enumType_deCH.IsTranslated), enumType_de.Label, enumType_deCH.Label)