# FieldValue — скрипт и функция диаграммы
Функция 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;`