Chia sẻ qua


First, FirstN, Index, và Lastcác hàm LastN

Áp dụng cho: Ứng dụng Canvas Copilot Studio Desktop dòng ứng dụng dựa trên mô hình Power Platform CLI Chức năng đảo dữ liệu Power Pages

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 một bảng; đối số thứ hai xác định số 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 xác định số bản ghi cần trả về.

Hàm Index trả về bản ghi của một bảng dựa trên vị trí theo thứ tự của nó trong bảng. Bản ghi được đánh số từ 1 nên First( table )Index( table, 1 ) sẽ trả về cùng một bản ghi. Index 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.

First, Indexvà trả về Last một bản ghi duy nhất. FirstNLastN trả về một bảng, ngay cả khi bạn chỉ xác đị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 một nguồn dữ liệu có chứa một bảng lớn với 1 triệu bản ghi, Last sẽ tuân theo giới hạn không ủy quyền và không trả về bản ghi cuối cùng của toàn bộ nguồn dữ liệu. Tương tự, việc Index sử dụng để yêu cầu một bản ghi ở giữa 1 triệu bản ghi sẽ dẫn đến 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

First( Bảng )
Last( Bảng )

  • Bảng - Bắt buộc. Bảng cần xử lý.

FirstN( Bảng [, NumberOfRecords ] )
LastN( Bảng [, NumberOfRecords ] )

  • 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.

Index( Bảng, RecordIndex )

  • 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ụ

Để biết các ví dụ sau đây, chúng tôi sử dụng nguồn dữ liệu IceCream, chứa dữ liệu trong bảng này:

Ví dụ về IceCream.

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ả
First( IceCream ) Trả về bản ghi đầu tiên của IceCream. { Flavor: "Chocolate", Số lượng: 100 }
Last( IceCream ) Trả về bản ghi cuối cùng của IceCream. { Flavor: "Pistachio", Số lượng: 200 }
Index( IceCream, 3 ) Trả về bản ghi thứ ba của IceCream. { Hương vị: "Dâu tây", Số lượng: 300 }
FirstN( IceCream, 2 ) Trả về một bảng chứa 2 bản ghi đầu tiên của IceCream. Bảng chứa các bản ghi cho Chocolate và Vanilla
LastN( IceCream, 2 ) Trả về bảng chứa hai bản ghi cuối cùng của IceCream. Bảng chứa các bản ghi cho Mint Chocolate và Pistachio
Index( IceCream, 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
Index( IceCream, 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