Lưu ý
Cần có ủy quyền mới truy nhập được vào trang này. Bạn có thể thử đăng nhập hoặc thay đổi thư mục.
Cần có ủy quyền mới truy nhập được vào trang này. Bạn có thể thử thay đổi thư mục.
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