Funzione ER GETENUMVALUEBYNAME
La funzione GETENUMVALUEBYNAME cerca un valore specifico Enum nell'origine dati di enumerazione specificata utilizzando il nome dell'enumerazione specificato come un valore Stringa. Se viene trovato il valore Enum, la funzione lo restituisce. Altrimenti, la funzione restituisce il valore di enumerazione nullo.
Sintassi
GETENUMVALUEBYNAME (enumeration data source path, enumeration value text)
Argomenti
enumeration data source path: Enumerazione
Il percorso valido di un'origine dati di uno dei seguenti tipi di enumerazione:
- Enumerazione di modelli di creazione di report elettronici (ER)
- Enumerazione formato ER
- Enumerazione Microsoft Dynamics 365 Finance
enumeration value text: Stringa
Un valore di stringa che rappresenta il nome di un singolo valore di enumerazione.
Valori restituiti
Enum nullable
Il valore di enumerazione risultante.
Note sull'utilizzo
Nessuna eccezione viene generata se non viene trovato un valore Enum utilizzando il nome del valore di enumerazione specificato come un valore Stringa.
Esempio 1
Nella seguente figura viene illustrata l'enumerazione ReportDirection introdotta in un modello dati. Tenere presente che le etichette vengono definite per i valori dell'enumerazione.
La figura di seguito mostra questi dettagli:
- L'origine dati $ Direction è configurata in un report ER. Questa origine dati è configurata in base all'enumerazione del modello ReportDirection.
- L'espressione
$IsArrivalsviene progettata per l'utilizzo dell'origine dati $Direction basata sull'enumerazione di modello come parametro di questa funzione. - Il valore di questa espressione di confronto è TRUE.
Esempio 2
Le funzioni GETENUMVALUEBYNAME e LISTOFFIELDS consentono di recuperare i valori e le etichette delle enumerazioni supportate come valori di testo. (Le enumerazioni supportate sono enumerazioni di applicazioni, enumerazioni di modelli di dati ed enumerazioni di formato).
Nella seguente figura viene introdotta l'origine dati TransType in un mapping dei modelli. Questa origine dati fa riferimento all'enumerazione dell'applicazione LedgerTransType.
Nella seguente figura viene mostrata l'origine dati TransTypeList configurata in un mapping dei modelli. Questa origine dati è configurata in base all'enumerazione dell'applicazione TransType. La funzione LISTOFFIELDS viene utilizzata per restituire tutti i valori di enumerazione come un elenco di record che contengono campi. In questo modo vengono esposti i dettagli di ogni valore di enumerazione.
Nota
Il campo EnumValue è configurato per l'origine dati TransTypeList utilizzando l'espressione GETENUMVALUEBYNAME(TransType, TransTypeList.Name). Questo campo restituisce un valore di enumerazione per ogni record in questo elenco.
Nella seguente figura viene mostrata l'origine dati VendTrans configurata in un mapping dei modelli. Questa origine dati restituisce i record delle transazioni del fornitore dalla tabella delle applicazioni VendTrans. Il tipo di libro mastro di ogni transazione è definito dal valore del campo TransType.
Nota
Il campo TransTypeTitle è configurato per l'origine dati VendTrans utilizzando l'espressione FIRSTORNULL(WHERE(TransTypeList, TransTypeList.EnumValue = @.TransType)).Label. Questo campo restituisce l'etichetta di un valore di enumerazione della transazione corrente come testo, se questo valore di enumerazione è disponibile. In caso contrario, restituisce una valore di stringa vuota.
Il campo TransTypeTitle è associato al campo LedgerType di un modello di dati che consente di utilizzare queste informazioni in ogni formato ER che utilizza il modello di dati come origine di dati.
La figura seguente mostra come utilizzare il debugger dell'origine dati per testare il mapping dei modelli configurato.
Il campo LedgerType di un modello di dati espone le etichette dei tipi di transazione come previsto.
Se prevedi di utilizzare questo approccio per una grande quantità di dati transazionali, è necessario considerare le prestazioni di esecuzione. Per altre informazioni, vedi Tenere traccia dell'esecuzione dei formati di creazione di report elettronici per risolvere i problemi di prestazioni.