FieldValue() restituisce il valore trovato nella posizione elem_no del campo field_name (in ordine di caricamento).
Sintassi:
FieldValue(field_name , elem_no)
Tipo di dati restituiti: duale
Argomenti:
- field_name: Nome del campo per cui è richiesto l'indice. Ad esempio, la colonna in una tabella. Deve essere specificato come valore di stringa. Questo significa che il nome di campo deve essere racchiuso tra virgolette singole.
- elem_no: Il numero della posizione (elemento) del campo, che segue l'ordine di caricamento, per cui viene restituito il valore. Ciò potrebbe corrispondere alla riga in una tabella, anche se dipende dall'ordine di caricamento degli elementi (righe).
Limiti:
-
L'ordinamento sui valori y nei grafici o l'ordinamento per colonne di espressione nelle tabelle non è consentito quando si utilizza questa funzione di grafico in una qualsiasi delle espressioni del grafico. Queste alternative di ordinamento verranno perciò disattivate automaticamente. Quando si utilizza questa funzione di grafico in una visualizzazione o in una tabella, l'ordinamento della visualizzazione torna all'ordinamento inserito in questa funzione. Questa limitazione non si applica alla funzione di script equivalente.
-
Se elem_no è maggiore del numero di valori del campo, viene restituito NULL .
Esempi:
Aggiungere i dati di esempio in basso al proprio documento ed eseguirlo. Gli esempi seguenti utilizzano il campo: First name dalla tabella Names.
| Esempio | Risultato |
|---|---|
|
Funzione grafica: in una tabella contenente la dimensione First name, aggiungere come misura: FieldValue('First name','1') |
John, perché John compare per primo nell’ordine di caricamento del campo First name. Tenere presente che in una casella di elenco John sarebbe stato visualizzato come numero 2 a partire dall'alto, dopo Jane, in quanto è ordinato in modo alfabetico e non secondo l'ordine di caricamento. |
|
Funzione grafico con First name: FieldValue('First name','7') |
NULL, perché nel campo First name vi sono solo 6 valori. |
|
Funzione di script: dato che la tabella Names è stata caricata, come nei dati campione: John1: Load FieldValue('First name',1) as MyPos1 Resident Names; |
MyPos1=John, in quanto 'John' è visualizzato per primo nell'ordine di caricamento del campo First name. |
|
Funzione di script con Names: Peter1: Load FieldValue('First name',7) as MyPos2 Resident Names; |
MyPo2s= - (Null) perché nel campo First name vi sono solo 6 valori. |
Dati utilizzati nell'esempio:
Names:
LOAD * inline [
"First name"|"Last name"|Initials|"Has cellphone"
John|Anderson|JA|Yes
Sue|Brown|SB|Yes
Mark|Carr|MC |No
Peter|Devonshire|PD|No
Jane|Elliot|JE|Yes
Peter|Franc|PF|Yes ] (delimiter is '|');
John1:
Load FieldValue('First name',1) as MyPos1
Resident Names;
Peter1:
Load FieldValue('First name',7) as MyPos2
Resident Names;
