Поділитися через

Функції: FirstN, Index, Last та LastN

  • Стаття

Застосовується до: програм Canvas Потоків робочого столу Програм Power Pages Power Platform CLI на основі моделі

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

Опис

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

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

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

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

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

«Перший», «Індекс » і «Останній» повертають один запис. FirstN і LastN повертають таблицю, навіть якщо вказано лише один запис.

Делегування

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

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

Синтаксис

Перший( таблиця )
Остання ( таблиця )

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

FirstN( Table [, NumberOfRecords ] )
LastN( Table [, NumberOfRecords ] )

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

Index( Таблиця, Індекс запису)

  • Таблиця - обов’язковий. Це таблиця, для якої потрібно виконати операцію.
  • 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 } ) )
Формула Опис Результат
Перший( Морозиво ) Повертає перший запис IceCream. { Flavor: "Chocolate", Quantity: 100 }
Останній ( Морозиво ) Повертає останній запис IceCream. { Flavor: "Pistachio", Quantity: 200 }
Індекс( Морозиво, 3 ) Повертає третій запис IceCream. { Flavor: "Strawberry", Quantity: 300 }
FirstN( Морозиво, 2 ) Повертає таблицю, що містить перші два записи IceCream. Таблиця з рекордами за вмістом шоколаду та ванілі
LastN( Морозиво, 2 ) Повертає таблицю, що містить два останні записи IceCream. Таблиця з рекордами для м’яти, шоколаду та фісташок
Індекс( Морозиво, 4 ). Кількість Повертає четвертий запис таблиці та витягує стовпець «Кількість». 60
Індекс( Морозиво, 10 ) Повертає помилку, оскільки запитаний запис виходить за межі таблиці. Помилка