FIRST

Applies to:Calculated columnCalculated tableMeasureVisual calculation

Используется только в визуальных вычислениях. Извлекает значение в визуальной матрице из первого элемента оси.

Syntax

FIRST ( <column>[, <axis>][, <orderBy>][, <blanks>][, reset] )

Parameters

Term	Definition
column	Извлекаемого столбца.
axis	(Необязательно) Ссылка на оси. Если опущено, используется первая ось определения визуальной фигуры.
orderBy	(Необязательно) Предложение ORDERBY() с выражениями, определяющими порядок сортировки каждой секции axisвдоль . Если orderBy данные не указаны, данные сортируются по столбцам группировки по умолчанию в порядке возрастания по умолчанию axis .
blanks	(Необязательно) Перечисление, определяющее, как обрабатывать пустые значения при сортировке axis. Поддерживаемые значения: DEFAULT (значение по умолчанию), где поведение числовых значений является пустыми значениями, упорядочены от нуля до отрицательных значений. Поведение строк является пустым значением, упорядоченным перед всеми строками, включая пустые строки. FIRST, пустые поля всегда упорядочены в начале независимо от возрастания или убывающего порядка сортировки. LAST, пустые всегда упорядочены в конце независимо от возрастания или убывания сортировки.
reset	(Необязательно) Указывает, сбрасывается ли вычисление и на каком уровне иерархии столбцов визуальной фигуры. Допустимые значения: ссылка на поле столбца в текущей визуальной форме, NONE (по умолчанию), LOWESTPARENT, HIGHESTPARENTили целое число. Поведение зависит от целочисленного знака: — если нулевая или опущенная, вычисление не сбрасывается. Эквивалентно NONE. — если положительный, целое число определяет столбец, начиная с самого высокого, независимо от зерна. HIGHESTPARENT эквивалентно 1. — если отрицательно, целое число определяет столбец, начиная с самого низкого, относительно текущего зерна. LOWESTPARENT эквивалентно -1.

Return value

Значение column из первого элемента оси.

Remarks

Эту функцию можно использовать только в визуальном вычислении.

Если значение reset является абсолютным (т. е. положительным целым числом HIGHESTPARENT или ссылкой на поле), а вычисление вычисляется на целевом уровне иерархии или выше, вычисление сбрасывается для каждого отдельного элемента. То есть функция оценивается в секции, содержащей только этот конкретный элемент.

Example

Следующее визуальное вычисление возвращает объем продаж первой строки на оси ROWS, которая сбрасывается на наименьший родительский элемент.

FirstInternetSalesAmount = FIRST ( [Sum of SalesAmount], ROWS, LowestParent )

Снимок экрана ниже: визуальная матрица и выражение визуального вычисления:

Related content

• LAST
• PREVIOUS
• NEXT