Share via

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

  • Стаття

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

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

Опис

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

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

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

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

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

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

Делегування

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

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

Синтаксис

First( Table )
Last( Table )

  • Table – обов’язковий аргумент. Це таблиця, для якої потрібно виконати операцію.

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

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

Index( Table, RecordIndex )

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