Các hàm First, FirstN, Index, Last và LastN
Áp dụng cho: Ứng dụng Canvas Luồng máy tính để bàn Ứng dụng dựa trên mô hình Power Pages Power Platform CLI
Trả về bản ghi đầu tiên/cuối cùng/cụ thể hoặc một tập hợp các bản ghi đầu tiên/cuối cùng trong một bảng.
Description
Hàm First trả về bản ghi đầu tiên của bảng.
Hàm FirstN trả về tập hợp bản ghi đầu tiên của bảng; đối số thứ hai là số lượng bản ghi cần trả về.
Hàm Last trả về bản ghi cuối cùng của bảng.
Hàm LastN trả về tập hợp bản ghi cuối cùng của bảng; đối số thứ hai là số lượng bản ghi cần trả về.
Hàm Index trả về một bản ghi trong bảng dựa trên vị trí đã sắp xếp của bản ghi đó trong bảng. Bản ghi được đánh số từ 1 nên First( table )
và Index( table, 1 )
sẽ trả về cùng một bản ghi. Chỉ mục trả về lỗi nếu chỉ mục bản ghi được yêu cầu nhỏ hơn 1, lớn hơn số bản ghi trong bảng hoặc bảng trống.
Đầu tiên, Chỉ mục và Cuối cùng trả về một bản ghi duy nhất. FirstN và LastN trả về một bảng, ngay cả khi bạn chỉ định một bản ghi duy nhất.
Đại diện
Khi được dùng với một nguồn dữ liệu, bạn không thể ủy nhiệm các chức năng này. Chỉ có phần đầu tiên của nguồn dữ liệu mới được truy xuất, phần còn lại sau đó sẽ áp dụng hàm. Kết quả có thể không thể hiện toàn bộ câu chuyện. Một cảnh báo có thể xuất hiện vào lúc biên soạn để nhắc bạn về hạn chế này và gợi ý chuyển sang dùng các hình thức ủy nhiệm thay thế khi có thể. Để biết thêm thông tin, xem bản tổng quan ủy nhiệm.
Ví dụ: khi được sử dụng với nguồn dữ liệu chứa một bảng lớn có 1 triệu bản ghi, hàm Last sẽ tuân theo giới hạn không ủy quyền và sẽ không trả về bản ghi cuối cùng trong toàn bộ nguồn dữ liệu. Tương tự như vậy, việc sử dụng hàm Index để yêu cầu một bản ghi ở giữa 1 triệu bản ghi sẽ gây ra lỗi vì chỉ mục nằm ngoài phạm vi dựa trên giới hạn không ủy quyền.
Cú pháp
Đầu tiên( Bảng )
Bảngcuối cùng ( )
- Bảng - Bắt buộc. Bảng cần xử lý.
FirstN( Bảng [, Số lượng bản ghi ] )
LastN( Bảng [, Số lượng bản ghi ] )
- Bảng - Bắt buộc. Bảng cần xử lý.
- NumberOfRecords - Tùy chọn. Số lượng bản ghi cần trả về. Nếu bạn không chỉ định đối số này, hàm sẽ trả về một bản ghi.
Mục lục( Bảng, Mục lục bản ghi )
- Bảng - Bắt buộc. Bảng cần xử lý.
- RecordIndex - Bắt buộc. Chỉ mục của bản ghi cần trả về. Bản ghi được đánh số từ 1.
Ví dụ
Đối với các ví dụ sau, chúng ta sẽ sử dụng nguồn dữ liệu IceCream (Kem) có chứa dữ liệu trong bảng sau:
Bảng này có thể nằm trong một tập hợp có công thức này (đặt công thức OnStart cho thành phần điều khiển Button (Nút) và nhấn nút):
Collect( IceCream, Table( { Flavor: "Chocolate", Quantity: 100 },
{ Flavor: "Vanilla", Quantity: 200 },
{ Flavor: "Strawberry", Quantity: 300 },
{ Flavor: "Mint Chocolate", Quantity: 60 },
{ Flavor: "Pistachio", Quantity: 200 } ) )
Công thức | Description | Kết quả |
---|---|---|
Đầu tiên (Kem) | Trả về bản ghi đầu tiên của IceCream. | { Flavor: "Chocolate", Quantity: 100 } |
Cuối cùng(Kem) | Trả về bản ghi cuối cùng của IceCream. | { Flavor: "Pistachio", Quantity: 200 } |
Mục lục(Kem, 3) | Trả về bản ghi thứ ba của IceCream. | { Flavor: "Strawberry", Quantity: 300 } |
FirstN(Kem, 2) | Trả về một bảng chứa 2 bản ghi đầu tiên của IceCream. | |
LastN(Kem, 2) | Trả về bảng chứa hai bản ghi cuối cùng của IceCream. | |
Chỉ mục (Kem, 4).Số lượng | Trả về bản ghi thứ tư của bảng và trích xuất cột Số lượng. | 60 |
Mục lục(Kem, 10) | Trả về lỗi vì bản ghi yêu cầu nằm ngoài phạm vi của bảng. | Lỗi |