First, , FirstNIndexи LastLastN функции

Применимо к: Приложения На основе холста Copilot Studio Desktop поддерживают функции Power Platform CLI Dataverse, управляемые моделью

Возвращает первую, последнюю или конкретную запись или набор первых или последних записей из таблицы.

Описание

Функция 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( Таблица, RecordIndex )

• Таблица - Обязательно. Таблица, с которой выполняются операции.
• RecordIndex - Обязательно. Индекс записи, которую требуется вернуть. Нумерация записей начинается с 1.

Примеры

В следующих примерах используется источник данныхIceCream, содержащий данные в этой таблице:

Эта таблица может быть помещена в коллекцию с помощью этой формулы (вставьте формулу OnStart для элемента управления Button и нажмите кнопку):

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.	{ Вкус: "Шоколад", Количество: 100 }
Last( IceCream )	Возвращает последнюю запись IceCream.	{ Вкус: "Pistachio", Количество: 200 }
Index( IceCream, 3 )	Возвращает третью запись IceCream.	{ Вкус: "Клубника", Количество: 300 }
FirstN( IceCream, 2 )	Возвращает таблицу, содержащую первые две записи IceCream.
LastN( IceCream, 2 )	Возвращает таблицу, содержащую последние две записи IceCream.
Index( IceCream, 4). Количество	Возвращает четвертую запись таблицы и извлекает столбец Quantity.	60
Index( IceCream, 10 )	Возвращает ошибку, так как запрошенная запись выходит за пределы таблицы.	Ошибка