Функция FieldValue() возвращает значение, находящееся в позиции elem_no поля field_name (в порядке загрузки).
Синтаксис:
FieldValue(field_name , elem_no)
Возвращаемые типы данных: двойное значение
Аргументы:
- field_name: Имя поля, для которого требуется индекс. Например, столбец в таблице. Это значение должно быть дано строковым. Это означает, что имя поля должно быть заключено в одинарные кавычки.
- elem_no: Номер позиции (элемента) поля, следующего в порядке загрузки, для которого возвращено значение. Значение может соответствовать строке в таблице, но это зависит от порядка, в котором загружаются элементы (строки).
Ограничения:
-
Сортировка по значениям y на диаграммах или сортировка по столбцам выражений в таблицах не допускается, если в любом из выражений диаграммы используется эта функция диаграмм. Данные возможности сортировки автоматически отключаются. Когда используется эта функция диаграмм в визуализации или таблице, сортировка визуализации будет возвращена к сортировке на входе этой функции. Это ограничение не распространяется на эквивалентную функцию скрипта.
-
Если элемент elem_no больше, чем число значений поля, возвращается значение NULL.
Примеры:
Добавьте указанный ниже образец данных в свой документ и запустите. В следующих примерах используется поле: First name из таблицы Names.
| Пример | Результат |
|---|---|
|
Функция диаграммы — в таблице, содержащей измерение First name, добавьте следующую меру: FieldValue('First name','1') |
John, поскольку элемент John появляется сначала в порядке загрузки поля First name. Обратите внимание, что в списке элемент John появится как число 2 сверху после элемента Jane, поскольку он отсортирован в алфавитном порядке, а не в порядке загрузки. |
|
Функция диаграммы с First name: FieldValue('First name','7') |
Значение NULL, поскольку в поле First name только 6 значений. |
|
Функция скрипта. При условии, что таблица Names загружается как в данных примера: John1: Load FieldValue('First name',1) as MyPos1 Resident Names; |
MyPos1=John, поскольку элемент «John» появляется сначала в порядке загрузки поля First name. |
|
Функция скрипта с Names: Peter1: Load FieldValue('First name',7) as MyPos2 Resident Names; |
MyPo2s= — (Null), поскольку в поле First name только 6 значений. |
Данные, используемые в примере:
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;
