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

Отнася се за: Приложения за платно Потоци на работния плот Приложения, управлявани Power Pages Power Platform от модел CLI

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

Описание

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

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

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

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

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

Първо, Индекс и Последно връщат един запис. FirstN и LastN връщат таблица, дори ако сте задали само един запис.

Делегиране

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

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

Синтаксис

Първо ( Таблица )
Последна ( таблица )

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

FirstN(Таблица[, Брой записи ] )
LastN(Таблица[, Брой записи ] )

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

Индекс( Таблица; Индекс на записи)

• Таблица - Задължително. Таблица за работа.
• 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
Първо ( Сладолед)	Връща първия запис на IceCream.	{ Flavor: "Chocolate", Quantity: 100 }
Последен (сладолед)	Връща последния запис на IceCream.	{ Flavor: "Pistachio", Quantity: 200 }
Index( Сладолед, 3 )	Връща третия запис на IceCream.	{ Flavor: "Strawberry", Quantity: 300 }
FirstN( Сладолед, 2 )	Връща таблица, съдържаща първите два записа от IceCream.
LastN( сладолед, 2 )	Връща таблица, съдържаща последните два записа на IceCream.
Индекс ( Сладолед, 4 ). Количество	Връща четвъртия запис на таблицата и извлича колоната Количество.	60
Индекс( Сладолед, 10 )	Връща грешка, тъй като заявеният запис е извън границите на таблицата.	Грешка