Funzione ER LISTOFFIELDS
La funzione LISTOFFIELDS restituisce un valore Elenco di record creato in base alla struttura dell'argomento specificato del tipo Enumerazione o Contenitore (record).
Sintassi 1
LISTOFFIELDS (path)
Sintassi 2
LISTOFFIELDS (path, language)
Argomenti
path: riferimento origine dati
Il percorso di riferimento valido di un'origine dati di uno dei seguenti tipi di dati:
- Enumerazione modello
- Enumerazione formato
- Enumerazione dell'applicazione
- Contenitore (record)
language: Stringa
Testo che rappresenta un codice lingua.
Valori restituiti
Elenco di record
L'elenco risultante di record.
Note sull'utilizzo
L'elenco creato contiene record con i seguenti campi:
- Nome (tipo di dati Stringa)
- Etichetta (tipo di dati Stringa)
- Descrizione (tipo di dati Stringa)
- IsTranslated (tipo di dati Booleano)
Se l'argomento path si riferisce a un'origine dati di tipo Contenitore (Record), per ogni campo del record contenitore di riferimento all'elenco creato viene aggiunto un nuovo record. Per ogni record creato, il campo Nome restituisce il nome del campo del record contenitore di riferimento per cui è stato creato il record corrente.
Se l'argomento path si riferisce a un'origine dati uno dei tipi Enumerazione, per ogni valore di enumerazione dell'enumerazione di riferimento all'elenco creato viene aggiunto un nuovo record. Per ogni record creato, il campo Nome restituisce il valore dell'enumerazione di riferimento per cui è stato creato il record corrente, il campo Descrizione restituisce la descrizione dell'enumerazione e il campo Etichetta restituisce l'etichetta dell'enumerazione.
In fase di runtime, quando viene utilizzata la sintassi 1, i campi Etichetta e Descrizione devono restituire valori basati sulle impostazioni della lingua del formato creazione di report elettronici (ER) in esecuzione:
- Se sono disponibili le etichette e le descrizioni per la lingua richiesta, i campi Etichetta e Descrizione restituiscono valori basati su quella lingua e il campo IsTranslated restituisce True.
- Se le etichette e le descrizioni per la lingua richiesta non sono disponibili, i campi Etichetta e Descrizione restituiscono valori basati su quella lingua EN-US predefinita e il campo IsTranslated restituisce False.
In fase di runtime, quando viene utilizzata la sintassi 2, i campi Etichetta e Descrizione devono restituire valori basati sulle impostazioni della lingua definite come secondo argomento della funzione chiamata:
- Se sono disponibili le etichette e le descrizioni per la lingua richiesta, i campi Etichetta e Descrizione restituiscono valori basati su quella lingua e il campo IsTranslated restituisce True.
- Se le etichette e le descrizioni per la lingua richiesta non sono disponibili, i campi Etichetta e Descrizione restituiscono valori basati su quella lingua EN-US e il campo IsTranslated restituisce False.
Esempio 1
Nella seguente figura viene illustrata l'enumerazione introdotta in un modello dati ER.
La figura di seguito mostra questi dettagli:
- L'enumerazione del modello viene inserita in un report come origine dei dati.
- Un'espressione ER utilizza l'enumerazione modello come parametro della funzione
LISTOFFIELDS. - Un'origine dati del tipo Elenco di record viene inserita in un report mediante l'espressione ER creata.
L'esempio seguente illustra gli elementi di formato ER che sono collegati all'origine dati del tipo Elenco di record creato utilizzando la funzione LISTOFFIELDS.
Nella figura seguente è illustrato il risultato dell'esecuzione del formato progettato.
Nota
Il testo tradotto per le etichette e le descrizioni viene immesso nell'output del formato ER in base alle impostazioni di lingua configurate per gli elementi di formato FILE e FOLDER padre.
Esempio 2
Utilizzare il tipo di origine dati Campo calcolato per configurare le origini dati enumType_de e enumType_deCH per l'enumerazione del modello dati enumType.
- enumType‑de =
LISTOFFIELDS (enumType, "de") - enumType‑deCH =
LISTOFFIELDS (enumType, "de-CH")
In questo caso, è possibile utilizzare la seguente espressione per visualizzare l'etichetta del valore enumerato in svizzero tedesco, se la traduzione è disponibile. Se la traduzione tedesca svizzera non è disponibile, l'etichetta è in tedesco.
IF (NOT (enumType_deCH.IsTranslated), enumType_de.Label, enumType_deCH.Label)