ER-funktionen GETENUMVALUEBYNAME

Artikel
03/08/2023

Funktionen GETENUMVALUEBYNAME søger efter en bestemt Fasttekst-værdi i den angivne fasttekstdatakilde ved hjælp af det fasttekstnavn, der er angivet som en Streng-værdi. Hvis Fasttekst-værdien findes, returnerer funktionen den. Ellers returnerer funktionen nul i fasttekstværdi.

Syntaks

GETENUMVALUEBYNAME (enumeration data source path, enumeration value text)

Argumenter

enumeration data source path: Fasttekst

Den gyldige sti til en datakilde for en af følgende fastteksttyper:

Modelfasttekst til elektronisk rapportering (ER)
ER-formatfasttekst
Microsoft Dynamics 365 Finance-fasttekst

enumeration value text: Streng

En strengværdi, der repræsenterer navnet på en enkelt fasttekstværdi.

Returnerede værdier

Enum kan være nul

Den returnerede fasttekstværdi.

Bemærkninger til brug

Der udløses ingen undtagelse, hvis der ikke findes en Enum-værdi ved hjælp af navnet på den fasttekstværdi, der er angivet som en Streng-værdi.

Eksempel 1

I følgende illustration introduceres fastteksten ReportDirection i en datamodel. Bemærk, at der er defineret etiketter for fasttekstværdierne.

Tilgængelige værdier for en datamodelfasttekst.

Følgende illustration viser disse detaljer:

Datakilden $Retning er konfigureret i en ER-rapport. Denne datakilde konfigureres på basis af modelfastteksten RapportRetning.
Udtrykket $IsArrivals er designet til at bruge den modelfasttekstbaserede datakilde $Retning som parameter for denne funktion.
Værdien af denne sammenligning er SAND.

Eksempel på en datamodelfasttekst.

Eksempel 2

Funktionerne GETENUMVALUEBYNAME og LISTOFFIELDS giver dig mulighed for at hente værdier og etiketter på understøttet fasttekst som tekstværdier. (Den understøttede fasttekst er programfasttekst, datamodelfasttekst og formatfasttekst).

I følgende illustration introduceres datakilden TransType i en modeltilknytning. Denne datakilde refererer til programfastteksten LedgerTransType.

Datakilde for en modeltilknytning, der refererer til en programfasttekst.

Følgende illustration viser datakilden TransTypeList, der er konfigureret i en modeltilknytning. Denne datakilde konfigureres på basis af programfastteksten TransType. Funktionen LISTOFFIELDS bruges til at returnere alle fasttekstværdier som en liste over poster, der indeholder felter. På denne måde vises detaljerne for alle fasttekstværdier.

Bemærk!

Feltet EnumValue er konfigureret for datakilden TransTypeList ved hjælp af udtrykket GETENUMVALUEBYNAME(TransType, TransTypeList.Name). Dette felt returnerer en fasttekstværdi for hver post på denne liste.

Datakilde for en modeltilknytning, der returnerer alle fasttekstværdier for en valgt fasttekst som en liste over poster.

Følgende illustration viser datakilden VendTrans, der er konfigureret i en modeltilknytning. Denne datakilde returnerer kreditorposteringer fra programtabellen VendTrans. Finanstypen for hver postering defineres af værdien i feltet TransType.

Bemærk!

Feltet TransTypeTitle er konfigureret for datakilden VendTrans ved hjælp af udtrykket FIRSTORNULL(WHERE(TransTypeList, TransTypeList.EnumValue = @.TransType)).Label. I dette felt returneres etiketten for en fasttekstværdi for den aktuelle postering som tekst, hvis denne fasttekstværdi er tilgængelig. Ellers returneres en tom strengværdi.

Feltet TransTypeTitle er knyttet til feltet LedgerType i en datamodel, der gør det muligt at bruge disse oplysninger i hvert ER-format, der bruger datamodellen som en datakilde.

Datakilde for en modeltilknytning, der returnerer kreditorposteringer.

I følgende illustration vises, hvordan du kan bruge datakildefejlfindingen til at teste den konfigurerede modeltilknytning.

Bruge datakildefejlfindingen til at teste den konfigurerede modeltilknytning.

Feltet LedgerType i en datamodel viser etiketter af posteringstyperne som forventet.

Hvis du planlægger at bruge denne fremgangsmåde til en stor mængde transaktionsdata, skal du overveje kørselsydeevnen. Du kan finde flere oplysninger i Spore kørslen af ER-formater til fejlfinding af problemer med ydeevnen.