Funktionen GETENUMVALUEBYNAME ER

Artikel
03/08/2023

GETENUMVALUEBYNAME-funktionen söker efter ett specifikt värde för uppräkning i angiven uppräkningsdatakälla med hjälp av det uppräkningsnamn som anges som ett sträng-värde. Om Enum-värdet hittas returnerar funktionen den. Annars returnerar funktionen null-uppräkningsvärdet.

Syntax

GETENUMVALUEBYNAME (enumeration data source path, enumeration value text)

Argument

enumeration data source path: uppräkning

Den giltiga sökvägen till en datakälla för någon av följande uppräkningstyper:

Elektronisk rapportering (ER) modelluppräkning
ER-formatuppräkning
Microsoft Dynamics 365 Finance uppräkning

enumeration value text: Sträng

Ett strängvärde som representerar namnet på ett enda uppräkningsvärde.

Returvärden

Kan ha värdet null Enum

Det resulterande fasttextvärde.

Användningsanteckningar

Inget undantag genereras om fasttextvärde inte hittas med hjälp av namnet på uppräkningsvärdet som anges som ett sträng-värde.

Exempel 1

I följande illustration introduceras uppräkningen ReportDirection i en datamodell. Observera att etiketter definieras för uppräkningsvärden.

Tillgängliga värden för en uppräkning för datamodell.

Illustrationen som följer visar dessa detaljer:

$Direction datakällan har konfigurerats i en ER-rapport. Den här datakällan konfigureras baserat på den ReportDirection modelluppräkning.
$IsArrivals-uttrycket är utformat för att använda modelluppräkningsbaserad $Direction datakälla som en parameter för denna funktion.
Värdet för detta jämförelseuttryck är SANT.

Exempel på uppräkning av en datamodell.

Exempel 2

Med funktionerna GETENUMVALUEBYNAME och LISTOFFIELDS kan du hämta värden och etiketter för uppräkningar som stöds som textvärden. (De uppräkningar som stöds är programuppräkningar, uppräkningar av datamodeller och formatuppräkningar.)

I följande illustration introduceras datakällan TransType i en modellmappning. Den här datakällan refererar till uppräkningen LedgerTransType för program.

Datakälla för en modellmappning som refererar till en programuppräkning.

Följande bild visar datakällan TransTypeList som konfigureras i en modellmappning. Den här datakällan konfigureras baserat på den TransType programuppräkning. Funktionen LISTOFFIELDS används för att returnera alla uppräkningsvärden som en lista med poster som innehåller fält. På så sätt visas information om varje uppräkningsvärde.

Notering

Fälteet EnumValue konfigureras för datakällan TransTypeList med hjälp av GETENUMVALUEBYNAME(TransType, TransTypeList.Name)-uttrycket. Det här fältet returnerar ett uppräkningsvärde för varje post i den här listan.

Datakälla för en modellmappning som returnerar alla uppräkningsvärden för en markerad uppräkning som en lista med poster.

Följande bild visar datakällan VendTrans som konfigureras i en modellmappning. Den här datakällan returnerar transaktionsposter för leverantörer från programregistret VendTrans. Redovisningstypen för varje transaktion definieras av värdet i fältet TransType.

Notering

Fälteet TransTypeTitle konfigureras för datakällan VendTrans med hjälp av FIRSTORNULL(WHERE(TransTypeList, TransTypeList.EnumValue = @.TransType)).Label-uttrycket. Det här fältet returnerar etiketten för ett uppräkningsvärde för den aktuella transaktionen som text, om detta uppräkningsvärde är tillgängligt. Annars returneras ett tomt strängvärde.

Fältet TransTypeTitle är bundet till LedgerType för en datamodell som gör att informationen kan användas i alla ER-format där datamodellen används som datakälla.

Datakälla för en modellmappning som returnerar leverantörstransaktioner.

Följande bild visar hur du kan använda datakällans felsökare för att testa den konfigurerade modellmappningen.

Använda datakällans felsökare för att testa den konfigurerade modellmappningen.

Fältet LedgerType i en datamodell visar etiketter för de transaktionstyper som förväntas.

Om du planerar att använda den här metoden för en stor mängd transaktionsdata måste du överväga att köra prestanda. För mer information, se Spåra körningen av ER-format för att felsöka prestandaproblem.