GETENUMVALUEBYNAME ER-funksjonen
GETENUMVALUEBYNAME-funksjonen søker etter en bestemt opplistings-verdi i den angitte opplistingsdatakilden ved hjelp av opplistingsnavnet som er angitt som en Streng-verdi. Hvis opplistings-verdien blir funnet, returnerer funksjonen den. Hvis ikke returnerer funksjonen opplistingsverdien null.
Syntaks
GETENUMVALUEBYNAME (enumeration data source path, enumeration value text)
Argumenter
enumeration data source path: Opplisting
Den gyldige referansebanen til en datakilde for en av følgende opplistingstyper:
- ER-modellopplisting
- ER-formatopplisting
- Microsoft Dynamics 365 Finance-opplisting
enumeration value text: Streng
En strengverdi som representerer navnet på en enkelt opplistingsverdi.
Returverdier
Opplisting som kan nullstilles
Den resulterende opplistingsverdien.
Bruksnotater
Det blir ikke registrert noe unntak hvis en opplisting-verdi ikke blir funnet ved å bruke navnet på opplistingsverdien som er angitt som en streng-verdi.
Eksempel 1
I følgende illustrasjon introduseres opplistingen ReportDirection i en datamodell. Legg merke til at etiketter er definert for opplistingsverdiene.
Illustrasjonen nedenfor viser disse detaljene:
- Datakilden $Direction er konfigurert i en ER-rapport. Denne datakilden er konfigurert basert på ReportDirection-modellopplistingen.
- Uttrykket
$IsArrivalser utformet for å bruke den modellopplistingsbaserte $Direction-datakilden som en parameter for denne funksjonen. - Verdien av denne sammenligningen er SANN.
Eksempel 2
Funksjonene GETENUMVALUEBYNAME og LISTOFFIELDS lar deg hente verdier og etiketter for støttede opplistinger som tekstverdier. (De støttede opplistingene er programopplistinger, datamodellopplistinger og formatopplistinger.)
I følgende illustrasjon introduseres datakilden TransType i en modelltilordning. Denne datakilden refererer til programopplistingen LedgerTransType.
Følgende illustrasjon viser datakilden TransTypeList som konfigureres i en modelltilordning. Denne datakilden er konfigurert basert på TransType-programopplistingen. Funksjonen LISTOFFIELDS brukes til å returnere alle opplistingsverdier som en liste med poster som inneholder felt. På denne måten vises detaljene for hver opplistingsverdi.
Notat
Feltet EnumValue er konfigurert for datakilden TransTypeList ved hjelp av uttrykket GETENUMVALUEBYNAME(TransType, TransTypeList.Name). Dette feltet returnerer en nummereringsverdi for hver post i denne listen.
Følgende illustrasjon viser datakilden VendTrans som konfigureres i en modelltilordning. Denne datakilden returnerer leverandørtransaksjonsposter fra VendTrans-programtabellen. Finanstypen for hver transaksjon defineres av verdien til TransType-feltet.
Notat
Feltet TransTypeTitle er konfigurert for datakilden VendTrans ved hjelp av uttrykket FIRSTORNULL(WHERE(TransTypeList, TransTypeList.EnumValue = @.TransType)).Label. Dette feltet returnerer etiketten for en opplistingsverdi for den gjeldende transaksjonen som tekst, hvis denne opplistingsverdien er tilgjengelig. Ellers returneres en tom strengverdi.
Feltet TransTypeTitle er bundet til LedgerType-feltet i en datamodell som gjør at denne informasjonen kan brukes i alle ER-format som bruker datamodellen som en datakilde.
Illustrasjonen nedenfor viser hvordan du kan bruke feilsøkingsprogrammet for datakilde til å teste den konfigurerte modelltilordningen.
Feltet LedgerType i en datamodell viser etiketter med transaksjonstyper som forventet.
Hvis du planlegger å bruke denne fremgangsmåten for en stor mengde transaksjonsdata, må du vurdere utførelsesytelsen. Hvis du vil ha mer informasjon, kan du se Spore kjøringen av ER-formater for å feilsøke ytelsesproblemer.
Tilleggsressurser
Spore kjøringen av ER-formater for å feilsøke ytelsesproblemer