First, FirstN, Index, Last, та LastN функції

Застосовується до: Програми Canvas Copilot Studio Desktop flows Model-driven apps Power Platform CLI Dataverse functions Power Pages

Повертає перший, останній або певний запис чи набір перших або останніх записів із таблиці.

Опис

Функція First повертає перший запис таблиці.

Функція FirstN повертає перший набір записів таблиці; другий аргумент визначає кількість записів, які потрібно повернути.

Функція Last повертає останній запис таблиці.

Функція LastN повертає останній набір записів таблиці; другий аргумент визначає кількість записів, які потрібно повернути.

Функція Index повертає запис таблиці на основі впорядкованої позиції в таблиці. Нумерування записів починається з 1, тому First( table ) повертає той же запис, що й Index( table, 1 ). Index повертає помилку, якщо запитаний індекс запису менший за 1, більший за кількість записів у таблиці або пустий.

First Last і Indexповерніть один запис. FirstN і LastN поверніть таблицю, навіть якщо вказано лише один запис.

Делегування

Коли використовується з джерелом даних, ці функції не можна делегувати. Буде отримано лише першу частину джерела даних, а потім – застосовано функцію. У результаті може відображатися не повна історія. Під час редагування може з’явитися попередження, щоб нагадати вам про це обмеження та запропонувати переключитися на делеговані альтернативи, де це можливо. Додаткову інформацію див. у статті Огляд делегування.

Наприклад, якщо використовується з джерелом даних, яке містить велику таблицю з 1 мільйоном записів, Last обмеження не делегування регулюється та не повертає останній запис усього джерела даних. Аналогічно, за допомогою Index запиту запису в середині 1 мільйона записів виникає помилка, оскільки індекс виходить за межі припустимого діапазону.

Синтаксис

First( Таблиця )
Last( Таблиця )

  • Таблиця - обов’язковий. Це таблиця, для якої потрібно виконати операцію.

FirstN( Таблиця [, NumberOfRecords ] )
LastN( Таблиця [, NumberOfRecords ] )

  • Таблиця - обов’язковий. Це таблиця, для якої потрібно виконати операцію.
  • NumberOfRecords- необов’язковий . Кількість записів, які потрібно повернути. Якщо цей аргумент не задано, функція повертає один запис.

Index( Таблиця, RecordIndex )

  • Таблиця - обов’язковий. Це таблиця, для якої потрібно виконати операцію.
  • RecordIndex - обов’язковий. Покажчик запису, який потрібно повернути. Нумерування записів починається з 1.

Приклади

У наведених нижче прикладах ми використовуємо джерело данихIceCream, яке містить дані в цій таблиці:

Приклад Iceсream.

Цю таблицю можна помістити до колекції за допомогою цієї формули (розташуйте формулу OnStart для елемента керування «Кнопка» та натисніть кнопку):

Collect( IceCream, Table( { Flavor: "Chocolate", Quantity: 100 },
                          { Flavor: "Vanilla", Quantity: 200 },
                          { Flavor: "Strawberry", Quantity: 300 },
                          { Flavor: "Mint Chocolate", Quantity: 60 },
                          { Flavor: "Pistachio", Quantity: 200 } ) )
Формула Опис Результат
First( IceCream ) Повертає перший запис IceCream. { Смак: "Шоколад", Кількість: 100 }
Last( IceCream ) Повертає останній запис IceCream. { Смак: "Фісташки", Кількість: 200 }
Index( IceCream, 3 ) Повертає третій запис IceCream. { Смак: "Полуниця", Кількість: 300 }
FirstN( IceCream, 2 ) Повертає таблицю, що містить перші два записи IceCream. Таблиця з рекордами за вмістом шоколаду та ванілі
LastN( IceCream, 2 ) Повертає таблицю, що містить два останні записи IceCream. Таблиця з рекордами для м’яти, шоколаду та фісташок
Index( IceCream, 4 ). Кількість Повертає четвертий запис таблиці та витягує стовпець «Кількість». 60
Index( IceCream, 10 ) Повертає помилку, оскільки запитаний запис виходить за межі таблиці. Помилка
  • Last updated on