Функции First, FirstN, Index, Last и LastN

  • Статия

Отнася се за: Canvas apps Desktop flows Model-driven apps Power Platform CLI

Връща първия, последния или конкретен запис или набор от първи или последни записи от таблица.

Описание

First функцията връща първия запис на таблица.

FirstN функция връща първия набор от записи на таблица; вторият аргумент определя броя на записите, които трябва да се върнат.

Last функцията връща последния запис на таблица.

LastN функция връща последния набор от записи на таблица; вторият аргумент определя броя на записите, които трябва да се върнат.

Функцията Индекс връща запис на таблица въз основа на нейната подредена позиция в таблицата. Номерирането на записите започва с 1, така че First( table ) връща същия запис като Index( table, 1 ). Index връща грешка, ако исканият индекс на запис е по-малък от 1, по-голям от броя на записите в таблицата или таблицата е празна.

First, Index и Last връща един запис. FirstN и LastN връщат таблица, дори ако посочите само един запис.

Делегиране

Когато се използват с източник на данни, тези функции не може да се делегират. Ще се извлече само първата част на източника на данни, след което ще се приложи функцията. Резултатът може да не е завършен. Може да се покаже предупреждение в момента на създаване, за да ви напомни за това ограничение и да предложи превключване към алтернативи с възможност за делегиране, ако е възможно. За повече информация вж. прегледа на делегирането.

Например, когато се използва с източник на данни, съдържаща голяма таблица с 1 милион записа, Последен ще бъде предмет на ограничението за неделегиране и няма да върне последния запис на целия източник на данни. По същия начин използването на Индекс за заявка на запис в средата на 1 милион записа ще доведе до грешка, тъй като индексът е извън обхват въз основа на ограничението за неделегиране.

Синтаксис

First( Table )
Last( Table )

  • Table – Задължително. Таблица за работа.

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

  • Table – Задължително. Таблица за работа.
  • NumberOfRecords - По желание. Брой записи за връщане. Ако не посочите този аргумент, функцията връща един запис.

Index( Table, RecordIndex )

  • Table – Задължително. Таблица за работа.
  • RecordIndex - Задължително. Индексът за записа, който трябва да бъде върнат. Номерацията на записите започва с 1.

Примери

За следващите примери ще използваме IceCreamизточник на данни, който съдържа данните в тази таблица:

Пример за сладолед.

Тази таблица може да бъде поставена в колекция с тази формула (поставете във формулата 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 } ) )
Формула Описание Result
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 ) Връща грешка, тъй като заявеният запис е извън границите на таблицата. Грешка