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

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

Bài viết liên quan

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