# FieldIndex — скрипт и функция диаграммы

Функция FieldIndex()возвращает позицию значения поля value в поле field\_name (в порядке загрузки).

Синтаксис:

FieldIndex(field\_name , value)

Возвращаемые типы данных: целое число

Аргументы:

* field\_name: Имя поля, для которого требуется индекс. Например, столбец в таблице. Это значение должно быть дано строковым. Это означает, что имя поля должно быть заключено в одинарные кавычки.
* value: Значение поля field\_name.

Ограничения:

* Сортировка по значениям y на диаграммах или сортировка по столбцам выражений в таблицах не допускается, если в любом из выражений диаграммы используется эта функция диаграмм. Данные возможности сортировки автоматически отключаются. Когда используется эта функция диаграмм в визуализации или таблице, сортировка визуализации будет возвращена к сортировке на входе этой функции. Это ограничение не распространяется на эквивалентную функцию скрипта.

* Если элемент value не может быть найден среди значений поля field\_name, 0 возвращается.

Примеры:

Добавьте указанный ниже образец данных в свой документ и запустите. В следующих примерах используется поле: First name из таблицы Names.

Примеры и результаты

| Пример | Результат |
| --- | --- |
| Функция диаграммы — в таблице, содержащей измерение First name, добавьте следующую меру:<br><br>`FieldIndex ('First name','John')` | 1, поскольку элемент «John» появляется сначала в порядке загрузки поля First name. Обратите внимание, что в списке элемент John появится как число 2 сверху, поскольку он отсортирован в алфавитном порядке, а не в порядке загрузки. |
| Функция диаграммы с First name:<br><br>`FieldIndex ('First name','Peter')` | 4, поскольку элемент FieldIndex() возвращает только одно значение, которое встречается сначала в порядке загрузки. |
| Функция скрипта. При условии, что таблица Names загружается как в данных примера:<br><br>`John1:`<br>`Load FieldIndex('First name','John') as MyJohnPos`<br>`Resident Names;` | `MyJohnPos=`1, поскольку элемент «John» появляется сначала в порядке загрузки поля First name. Обратите внимание, что в списке элемент John появится как число 2 сверху, поскольку он отсортирован в алфавитном порядке, а не в порядке загрузки. |
| Функция скрипта с Names:<br><br>`Peter1:`<br>`Load FieldIndex('First name','Peter') as MyPeterPos`<br>`Resident Names;` | `MyPeterPos=`4, поскольку элемент FieldIndex() возвращает только одно значение, которое встречается сначала в порядке загрузки. |

Данные, используемые в примере:

`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 FieldIndex('First name','John') as MyJohnPos` `Resident Names;` ` ` `Peter1:` `Load FieldIndex('First name','Peter') as MyPeterPos` `Resident Names;`