Funkcje First, FirstN, Index, Last i LastN

  • Artykuł

Dotyczy: Aplikacje oparte na kanwie Przepływy pulpitu Aplikacje oparte na modelach Power Platform CLI

Zwraca pierwszy, ostatni lub określony rekord albo zestaw pierwszych lub ostatnich rekordów z tabeli.

Opis

Funkcja First zwraca pierwszy rekord tabeli.

Funkcja FirstN zwraca pierwszy zestaw rekordów tabeli; drugi argument określa liczbę rekordów do zwrócenia.

Funkcja Last zwraca ostatni rekord tabeli.

Funkcja LastN zwraca ostatni zestaw rekordów tabeli; drugi argument określa liczbę rekordów do zwrócenia.

Funkcja Index zwraca rekord tabeli na podstawie uporządkowanej pozycji tabeli. Numerowanie rekordu zaczyna się od 1, First( table )więc zwracany jest ten sam rekord, co Index( table, 1 ). Index zwraca błąd, jeśli żądany indeks rekordu jest mniejszy niż 1, większa niż liczba rekordów w tabeli lub tabela jest pusta.

Funkcje First, Index i Last zwracają jeden rekord. Funkcje FirstN i LastN zwracają tabelę, nawet jeśli zostanie określony tylko jeden rekord.

Delegowanie

Tych funkcji nie można delegować, gdy są używane ze źródłem danych. Zostanie pobrana tylko pierwsza część źródła danych, a następnie zostanie zastosowana funkcja. Wynik może nie odpowiadać pełnym informacjom. W czasie tworzenia może zostać wyświetlone ostrzeżenie przypominające o tym ograniczeniu i sugerujące użycie delegowalnych alternatyw, jeśli jest to możliwe. Aby uzyskać więcej informacji, zobacz Omówienie delegowania.

Na przykład w przypadku użycia ze źródłem danych zawierającym dużą tabelę z 1 milionem rekordów Last będzie podlegać ograniczeniu braku delegowania i nie zwróci ostatniego rekordu z całego źródła danych. Podobnie użycie Index do żądania rekordu w środku 1 miliona rekordów spowoduje błąd, ponieważ indeks jest poza zakresem w oparciu o limit braku delegowania.

Składnia

First( Tabela )
Last( Tabela )

  • Tabela – wymagane. Tabela, na której będą wykonywane działania.

FirstN( Tabela [, LiczbaRekordów ] )
LastN( Tabela [, LiczbaRekordów ] )

  • Tabela – wymagane. Tabela, na której będą wykonywane działania.
  • NumberOfRecords – opcjonalne. Liczba rekordów do zwrócenia. Jeśli ten argument nie jest określony, funkcja zwraca jeden rekord.

Index( Table, RecordIndex )

  • Tabela – wymagane. Tabela, na której będą wykonywane działania.
  • RecordIndex — wymagane. Indeks rekordu do zwrócenia. Numerowanie rekordu zaczyna się od 1.

Przykłady

W poniższych przykładach użyto źródła danych IceCream, które zawiera dane z tej tabeli:

Przykład Icecream.

Ta tabela może być umieszczona w kolekcji za pomocą tej formuły (wstaw formułę OnStart dla kontrolki Button i naciśnij przycisk):

Collect( IceCream, Table( { Flavor: "Chocolate", Quantity: 100 },
                          { Flavor: "Vanilla", Quantity: 200 },
                          { Flavor: "Strawberry", Quantity: 300 },
                          { Flavor: "Mint Chocolate", Quantity: 60 },
                          { Flavor: "Pistachio", Quantity: 200 } ) )
Formuła Opis Result
First( IceCream ) Zwraca pierwszy rekord z IceCream. { Flavor: "Chocolate", Quantity: 100 }
Last( IceCream ) Zwraca ostatni rekord z IceCream. { Flavor: "Pistachio", Quantity: 200 }
Index( IceCream, 3 ) Zwraca trzeci rekord z IceCream. { Flavor: "Strawberry", Quantity: 300 }
FirstN( IceCream, 2 ) Zwraca tabelę zawierającą dwa pierwsze rekordy IceCream. Tablica zawierająca zapisy dla Czekolady i Wanilii
LastN( IceCream, 2 ) Zwraca tabelę zawierającą dwa ostatnie rekordy IceCream. Tablica zawierająca rekordy dla Miętowej Czekolady i Pistacji
Index( IceCream, 4 ).Quantity Zwraca czwarty rekord tabeli i wyodrębnia kolumnę Ilość. 60
Index( IceCream, 10 ) Zwraca błąd, ponieważ żądany rekord jest wykraczający poza granice tabeli. Błąd