Chia sẻ qua


Tập Dữ liệu

Cung cấp thuộc tính và phương pháp để làm việc với dữ liệu trên lưới và dạng xem.

Sẵn dùng cho

Ứng dụng dựa trên mô hình và bảng tùy biến.

Thuộc tính

Cột

Tập hợp cột sẵn dùng trong tập dữ liệu này. Được hỗ trợ trong cả ứng dụng tạo mô hình và bảng tùy biến.

Loại: Column[]

lỗi

Có xảy ra lỗi trong truy xuất dữ liệu hay không. Được hỗ trợ trong cả ứng dụng tạo mô hình và bảng tùy biến.

Loại: boolean

mã lỗi

Mã lỗi liên kết với lỗi gặp phải gần đây nhất, nếu có.

errorMessage

Thông báo lỗi được liên kết với lỗi gặp phải gần đây nhất, nếu có.

Loại: number | string

Lọc

Lọc cột cho truy vấn hiện tại. Được hỗ trợ trong cả ứng dụng tạo mô hình và bảng tùy biến. Có thể cấu hình lọc cho tập dữ liệu bằng cách đặt context.parameters.[dataset_property_name].filtering.setFilter(<filterExpression>). Sau khi bộ lọc được thiết lập, tính context.parameters.[dataset_property_name].refresh() năng gọi sẽ truy xuất dữ liệu đã lọc từ nguồn dữ liệu.

Giá trị Toán tử điều kiện Ứng dụng dựa trên mô hình Ứng dụng canvas
-1 Không ai
0 Bình đẳng
1 NotEqual
2 Vĩ đại hơn
3 ÍtThan
Tệp 4 Bình đẳng Lớn hơn
5 Bình đẳng Thấp hơn
6 Thích
7 Không Giống Không
8 Trong
12 Rỗng
13 Không rỗng Không
14 Hôm qua Không
15 Hôm nay Không
16 Mai Không
17 Ngày 7 Cuối cùng Không
18 Ngày tiếp theo7 Không
19 Tuần Trước Không
20 Tuần Này Không
22 Tháng Cuối Không
23 Tháng Này Không
25 Trên Không
26 OnOrBefore Không
27 Sau Một ngày Không
28 Năm Trước Không
29 Năm Này Không
33 Ngày Cuối cùng Không
34 Ngày NextX Không
37 Tháng Cuối cùng Không
38 Tháng NextX Không
49 Chứa
54 Bắt đầuTại Không
55 DoesNotBeginWidth Không
56 EndsWidth Không
57 DesNotEndWith Không
70 InFiscalPeriodAndYear Không
75 Bên trên
76 Dưới
77 Không có dưới
78 Trên Hoặc Bằng
79 Dưới Hoặc Bằng
87 Chứa Giá trị
88 DoesNotContainValues Không

Lưu ý

Tính năng lọc chỉ sẵn dùng cho nguồn dữ liệu Dataverse.

Loại: Lọc

Liên kết

Xác định thông tin bảng được nối kết. Chỉ được hỗ trợ trong các ứng dụng dựa trên mô hình.

Loại: Liên kết

Tải

Cho biết tập dữ liệu có đang tải hay không. Được hỗ trợ trong cả ứng dụng tạo mô hình và bảng tùy biến.

Loại: boolean

Paging

Trạng thái và hành động phân trang. Được hỗ trợ trong cả ứng dụng tạo mô hình và bảng tùy biến. Có thể truy nhập và đặt cấu hình thông tin phân trang cho tập dữ liệu bằng cách sử dụng context.parameters.[dataset_property_name].paging .

Lưu ý

Nguồn dữ liệu đảo dữ liệu không trả về đối tượng totalRecordCount phân trang cho các ứng dụng bảng tùy biến. Thay vào đó, nó hasNextPage sử hasPreviousPage dụng và để kiểm tra xem có nhiều bản ghi cần tải không.

Các cấu phần tập dữ liệu có thể context.parameters.[dataset_property_name].paging.setPageSize(pageSize) sử dụng để thay đổi số lượng bản ghi được truy xuất trên mỗi trang.

Loại: Phân trang

Hồ sơ

Bản đồ ID tới đối tượng bản ghi đầy đủ. Được hỗ trợ trong cả ứng dụng tạo mô hình và bảng tùy biến.

Loại: EntityRecord

sortedRecordIds

ID của các bản ghi trong tập dữ liệu, thứ tự theo kết quả phản hồi truy vấn. Được hỗ trợ trong cả ứng dụng tạo mô hình và bảng tùy biến.

Loại: string[]

Phân loại

Trạng thái sắp xếp cho truy vấn hiện tại. Được hỗ trợ trong cả ứng dụng tạo mô hình và bảng tùy biến. Có thể cấu hình sắp xếp cho tập dữ liệu bằng cách đặt context.parameters.[dataset_property_name].sorting = [SortStatus]. Sau khi sắp xếp được cấu hình, tính context.parameters.[dataset_property_name].refresh() năng gọi sẽ truy xuất dữ liệu đã sắp xếp từ nguồn dữ liệu.

Lưu ý

Tính năng sắp xếp chỉ sẵn dùng cho nguồn dữ liệu Dataverse. Ngoài ra, nếu sắp xếp được cấu hình lại, nó sẽ đặt lại bộ lọc context.parameters.[dataset_property_name].filtering

Loại: SortStatus[]

Phương pháp

Phương thức Sự miêu tả Sẵn dùng cho
addColumn Thêm cột vào tập hợp cột. Ứng dụng dựa trên mô hình
clearSelectedRecordIds Xóa danh sách id bản ghi đã chọn. Ứng dụng Dựa trên mô hình và Bảng tùy biến
xóa Xóa bản ghi khỏi nguồn dữ liệu. Ứng dụng canvas
getCommands Các lệnh cho tập dữ liệu. Ứng dụng canvas
getDataSetCapabilities Các khả năng cho tập dữ liệu. Ứng dụng canvas
getSelectedRecordIds Truy xuất tất cả ID bản ghi đã chọn. Ứng dụng Dựa trên mô hình và Bảng tùy biến
getTargetEntityType Trả về tên loại bảng đích. Ứng dụng Dựa trên mô hình và Bảng tùy biến
getTitle Truy xuất tên hiển thị dạng xem được dùng bởi thuộc tính tập dữ liệu. Ứng dụng Dựa trên mô hình và Bảng tùy biến
getViewId Trả về Id của dạng xem được tham số tập dữ liệu dùng. Ứng dụng Dựa trên mô hình và Bảng tùy biến
newRecord Khởi tạo đối tượng bản ghi cục bộ cho điều khiển để đặt giá trị. Điều khiển cần gọi phương thức trên bản save() ghi mới được tạo để duy trì thay đổi. Ứng dụng canvas
openDatasetItem Mở mục tập dữ liệu cho EntityReference đã cho. Công cụ này sẽ kiểm tra xem có lệnh có ID nút lệnh hay không Mscrm.OpenRecordItem. Nếu tồn tại, nó thực hiện lệnh, nếu không nó chỉ dẫn hướng đến biểu mẫu liên kết của EntityReference. Ứng dụng Dựa trên mô hình và Bảng tùy biến
làm tươi Làm mới tập dữ liệu dựa trên bộ lọc, sắp xếp, nối kết, cột mới. Ngoài ra, làm mới sẽ đặt lại phân trang thành trang 1. Ứng dụng Dựa trên mô hình và Bảng tùy biến
retrieveRecordCommand Truy xuất các lệnh liên kết của bản ghi. Nếu có nhiều tập dữ liệu trong manifest, retrieveRecordCommand sẽ trả về các lệnh cho tập dữ liệu đầu tiên. Định hướng mô hình
setSelectedRecordIds Đặt id của các bản ghi đã chọn. Ứng dụng Dựa trên mô hình và Bảng tùy biến

Cột tra cứu

Giờ đây, có thể truy xuất các cột tra cứu của bảng dataverse. Đối với các ứng dụng bảng tùy biến, nếu cột tra cứu được bao gồm trong tập dữ liệu, tất cả các cột trong bản ghi được tham chiếu sẽ được truy xuất. GetFormattedValue trả về chuỗi JSON cho cột này. GetValue phương pháp trả về đối tượng JSON trực tiếp.

Ví dụ:

Để tìm hiểu thêm về cách triển khai các phương pháp tập dữ liệu, hãy xem cấu phần Lưới Tập dữ liệu

Tham khảo API khung thành phần Power Apps
Tổng quan về khuôn khổ cấu phần Power Apps