FieldValue - Skript- und Diagrammfunktion
FieldValue() liefert den Wert an der (nach Lade-Reihenfolge) elem_no-ten Position des Feldes field_name.
Syntax:
FieldValue(field_name , elem_no)
Rückgabe Datentyp: dual
Argumente:
- field_name: Name für das Feld, für das der Index erforderlich ist. Beispielsweise die Spalte in einer Tabelle. Muss als String angegeben werden. Das heißt, der Feldname muss in einfachen Anführungszeichen stehen.
- elem_no: Die Positionsnummer (Element) des Feldes gemäß der Lade-Reihenfolge, für die der Wert ausgegeben wird. Dies könnte einer Zeile in einer Tabelle entsprechen, hängt aber davon ab, in welcher Reihenfolge die Elemente (Zeilen) geladen werden.
Beschränkungen:
-
Das Sortieren nach y-Werten in Diagrammen oder nach Formelspalten in Tabellen ist nicht zulässig, wenn diese Diagrammfunktion in einer der Diagrammformeln verwendet wird. Diese Sortierungsoptionen werden daher automatisch deaktiviert. Wenn Sie diese Diagrammfunktion in einer Visualisierung oder Tabelle verwenden, wird die Sortierung der Visualisierung auf die sortierte Eingabe dieser Funktion zurückgesetzt. Diese Einschränkung gilt nicht für die entsprechende Skriptfunktion.
-
Ist elem_no größer als die Zahl der Feldwerte, ist das Ergebnis NULL.
Beispiele:
Fügen Sie Ihrem Dokument die Beispieldaten unten hinzu und führen Sie sie aus. Die folgenden Beispiele verwenden das Feld First name aus der Tabelle Names.
Beispiel | Ergebnis |
---|---|
Diagrammfunktion: Fügen Sie einer Tabelle mit der Dimension First name folgende Kennzahl hinzu: FieldValue('First name','1') |
John, weil John zuerst in der Lade-Reihenfolge des Feldes First name aufgeführt wird. Hinweis: In einer Listbox würde John als 2. von oben nach Jane angezeigt werden, da alphabetisch und nicht nach Lade-Reihenfolge sortiert wird. |
Diagrammfunktion mit First name: FieldValue('First name','7') |
NULL, weil sich nur 6 Werte im Feld First name befinden. |
Skriptfunktion: Die Tabelle Names wird wie in den Beispieldaten geladen: John1: Load FieldValue('First name',1) as MyPos1 Resident Names; |
MyPos1=John, weil 'John' zuerst in der Lade-Reihenfolge des Feldes First name aufgeführt wird. |
Skriptfunktion mit Names: Peter1: Load FieldValue('First name',7) as MyPos2 Resident Names; |
MyPo2s= – (Null), weil sich nur 6 Werte im Feld First name befinden. |
Im Beispiel verwendete Daten:
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;