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

Отнася се за: Приложения за платно Copilot Studio Работен плот потоци Модел-управлявани приложения Power Platform CLI Dataverse функции Power Pages

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

Описание

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

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

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

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

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

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

Делегиране

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

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

Синтаксис

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

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

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

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

Index( Table, RecordIndex )

• Таблица - Задължително. Таблица за работа.
• 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.	{ Вкус: "Шоколад", Количество: 100 }
LastНе, не	Връща последния запис на IceCream.	{ Вкус: "Шам фъстък", Количество: 200 }
Index100 000 00:30:34,300 --	Връща третия запис на IceCream.	{ Вкус: "Ягода", Количество: 300 }
FirstN( Ледено творче, 2 )	Връща таблица, съдържаща първите два записа от IceCream.
LastN( Ледено творче, 2 )	Връща таблица, съдържаща последните два записа на IceCream.
Index( Ледено създаване, 4). Количество	Връща четвъртия запис на таблицата и извлича колоната Количество.	60
Index10 000 ли са?	Връща грешка, тъй като заявеният запис е извън границите на таблицата.	Грешка