De ER-functie GETENUMVALUEBYNAME

Artikel
03/08/2023

De functie GETENUMVALUEBYNAME zoekt naar een specifieke waarde van het type Opsomming in de opgegeven gegevensbron voor opsommingen met behulp van de opsommingsnaam die is opgegeven als waarde van het type Tekenreeks. Als de waarde van het type Opsomming wordt gevonden, wordt deze geretourneerd. Anders retourneert de functie de opsommingswaarde null.

Syntaxis

GETENUMVALUEBYNAME (enumeration data source path, enumeration value text)

Argumenten

enumeration data source path: Opsomming

Het geldige verwijzingspad van een gegevensbron van een van de volgende opsommingstypen:

ER-opsommingsmodel (Elektronische rapportage)
Opsomming van ER-indelingen
Microsoft Dynamics 365 Finance-opsomming

enumeration value text: Tekenreeks

Een tekenreekswaarde die voor de naam van een enkele opsommingswaarde staat.

Retourwaarden

Opsomming waarvoor null-waarde is toegestaan

De resulterende opsommingswaarde.

Gebruiksaanwijzingen

Er wordt geen uitzondering gegenereerd als een opsommingswaarde niet wordt gevonden met behulp van de naam van de opsommingswaarde die is opgegeven als een tekenreekswaarde.

Voorbeeld 1

In het volgende voorbeeld wordt de opsomming ReportDirection geïntroduceerd in een gegevensmodel. Houd er rekening mee dat labels voor de opsommingswaarden worden gedefinieerd.

Beschikbare waarden voor een gegevensmodelopsomming.

De volgende afbeelding toont deze details:

De gegevensbron $Direction wordt geconfigureerd in een ER-rapport. Deze gegevensbron wordt geconfigureerd op basis van de modelopsomming ReportDirection.
De expressie $IsArrivals is ontworpen om de gegevensbron $Direction op basis van modelopsomming als parameter voor deze functie te gebruiken.
De waarde van deze vergelijkingsexpressie is TRUE.

Voorbeeld van gegevensmodelopsomming.

Voorbeeld 2

Met de functies GETENUMVALUEBYNAME en LISTOFFIELDS kunt u waarden en labels van ondersteunde opsommingen ophalen als tekstwaarden. (De ondersteunde opsommingen zijn opsommingen van toepassingen, gegevensmodellen en indelingen.)

In de volgende afbeelding wordt de gegevensbron TransType in een modeltoewijzing geïntroduceerd. Deze gegevensbron verwijst naar de toepassingsopsomming LedgerTransType.

Gegevensbron van een modeltoewijzing die verwijst naar een toepassingsopsomming.

In de volgende afbeelding wordt de gegevensbron TransTypeList weergegeven die in een modeltoewijzing is geconfigureerd. Deze gegevensbron wordt geconfigureerd op basis van de opsomming TransType. De functie LISTOFFIELDS wordt gebruikt om alle opsommingswaarden te retourneren als een lijst met records die velden bevatten. Op deze manier worden de details van elke opsommingswaarde weergegeven.

Notitie

Het veld EnumValue wordt geconfigureerd voor de gegevensbron TransTypeList met de expressie GETENUMVALUEBYNAME(TransType, TransTypeList.Name). Met dit veld wordt een opsommingswaarde geretourneerd voor elke record in deze lijst.

Gegevensbron van een modeltoewijzing waarmee alle opsommingswaarden van een geselecteerde opsomming als een lijst met records worden geretourneerd.

In de volgende afbeelding wordt de gegevensbron VendTrans weergegeven die in een modeltoewijzing is geconfigureerd. Met deze gegevensbron worden leverancierstransactierecords geretourneerd uit de toepassingstabel VendTrans. Het grootboektype van elke transactie wordt gedefinieerd door de waarde van het veld TransType.

Notitie

Het veld TransTypeTitle wordt geconfigureerd voor de gegevensbron VendTrans met de expressie FIRSTORNULL(WHERE(TransTypeList, TransTypeList.EnumValue = @.TransType)).Label. Met dit veld wordt het label van een opsommingswaarde van de huidige transactie geretourneerd als tekst als deze opsommingswaarde beschikbaar is. Anders wordt een lege tekenreekswaarde geretourneerd.

Het veld TransTypeTitle is gebonden aan het veld LedgerType van een gegevensmodel waarmee deze informatie kan worden gebruikt in elke ER-indeling waarin het gegevensmodel als een bron van gegevens wordt gebruikt.

Gegevensbron van een modeltoewijzing waarmee leverancierstransacties worden geretourneerd.

In de volgende afbeelding ziet u hoe u de foutopsporing voor gegevensbronnen kunt gebruiken om de geconfigureerde modeltoewijzing te testen.

De geconfigureerde modeltoewijzing testen met de foutopsporing voor gegevensbronnen.

Met het veld LedgerType van een gegevensmodel worden labels van transactietypen zoals verwacht weergegeven.

Als u deze methode wilt gebruiken voor een groot aantal transactiegegevens, moet u kijken naar de uitvoeringsprestaties. Zie De uitvoering van ER-indelingen traceren om prestatieproblemen op te lossen voor meer informatie.