提供屬性和方法來處理格線和視圖上的資料。
適用於
模型導向和畫布應用程式。
屬性
columns
此資料集中可用的欄集。 在模型導向和畫布應用程式中都支援。
類型： 列[]
錯誤
資料擷取是否發生錯誤。 在模型導向和畫布應用程式中都支援。
類型：boolean
錯誤代碼
與上次遇到的錯誤相關聯的錯誤碼 （如果適用）。
errorMessage
與上次遇到的錯誤相關聯的錯誤訊息 （如果適用的話）。
類型：number | string
過濾
目前查詢的資料行篩選。 在模型導向和畫布應用程式中都支援。 您可以透過設定 context.parameters.[dataset_property_name].filtering.setFilter(<filterExpression>)來設定資料集的篩選。 設定篩選器之後，呼叫 context.parameters.[dataset_property_name].refresh() 會從資料來源擷取篩選的資料。
| 價值觀 | 條件運算子 | 模型導向應用程式 | 畫布應用程式 |
|---|---|---|---|
| -1 | None | Yes | Yes |
| 0 | 平等 | Yes | Yes |
| 1 | 不相等 | Yes | Yes |
| 2 | 大於 | Yes | Yes |
| 3 | 小於 | Yes | Yes |
| 4 | 大等於 | Yes | Yes |
| 5 | 較少等於 | Yes | Yes |
| 6 | 喜歡 | Yes | Yes |
| 7 | NotLike | 否 | Yes |
| 8 | In | Yes | Yes |
| 12 | Null | Yes | Yes |
| 13 | NotNull | 否 | Yes |
| 14 | 昨天 | Yes | 否 |
| 15 | 今天 | Yes | 否 |
| 16 | Tomorrow | Yes | 否 |
| 17 | 過去7天 | Yes | 否 |
| 18 | 下一頁7天 | Yes | 否 |
| 19 | 上週 | Yes | 否 |
| 20 | 本週 | Yes | 否 |
| 22 | 上個月 | Yes | 否 |
| 23 | 本月 | Yes | 否 |
| 25 | 另一 | Yes | 否 |
| 26 | OnOr之前 | Yes | 否 |
| 二十七 | OnOr之後 | Yes | 否 |
| 28 | 去年 | Yes | 否 |
| 二十九 | 今年 | Yes | 否 |
| 33 | 最後XDays | Yes | 否 |
| 34 | 下一頁XDays | Yes | 否 |
| 37 | LastX上 | Yes | 否 |
| 38 | NextX上篇 | Yes | 否 |
| 49 | 包含 | Yes | Yes |
| 54 | 開始依 | 否 | Yes |
| 55 | DoesNotBegin寬度 | 否 | Yes |
| 56 | EndsWidth | 否 | Yes |
| 57 | DesNotEndWith | 否 | Yes |
| 70 | InFiscalPeriodAndYear | Yes | 否 |
| 75 | 上方 | Yes | Yes |
| 76 | 低於 | Yes | Yes |
| 77 | NotUnder | Yes | Yes |
| 78 | AboveOrEqual | Yes | Yes |
| 79 | UnderOrEqual | Yes | Yes |
| 87 | 包含值 | Yes | Yes |
| 88 | DoesNotContain值 | 否 | Yes |
備註
篩選功能僅適用於 Dataverse 資料來源。
類型： 過濾
連結
定義連結表格資訊。 僅在模型導向應用程式中支援。
類型： 連結
載入中
指出資料集是否正在載入。 在模型導向和畫布應用程式中都支援。
類型：boolean
尋呼
分頁狀態和動作。 在模型導向和畫布應用程式中都支援。 您可以使用 存取 context.parameters.[dataset_property_name].paging 和設定資料集的分頁資訊。
備註
Dataverse 資料來源不會傳回 totalRecordCount 畫布應用程式的分頁物件。 相反地，它會使用 hasNextPage and hasPreviousPage 來檢查是否有更多記錄要擷取。
資料集元件可用來 context.parameters.[dataset_property_name].paging.setPageSize(pageSize) 變更每頁擷取的記錄數目。
類型： 分頁
案卷
將 ID 對映至完整記錄物件。 在模型導向和畫布應用程式中都支援。
類型： EntityRecord
sortedRecordIds
資料集中記錄的 ID，依查詢回應結果排序。 在模型導向和畫布應用程式中都支援。
類型：string[]
排序
目前查詢的排序狀態。 在模型導向和畫布應用程式中都支援。 您可以透過設定 context.parameters.[dataset_property_name].sorting = [SortStatus]來設定資料集的排序。 設定排序之後，呼叫 context.parameters.[dataset_property_name].refresh() 會從資料來源擷取排序的資料。
備註
排序功能僅適用於 Dataverse 資料來源。
此外，如果重新配置排序，它將重置過濾器 context.parameters.[dataset_property_name].filtering
類型： SortStatus[]
Methods
| 方法 | Description | 適用於 |
|---|---|---|
| 新增欄 | 將欄新增至欄集。 | 模型導向應用程式 |
| clearSelectedRecordIds | 清除選取的記錄識別碼清單。 | 模型導向和畫布應用程式 |
| delete | 從資料來源刪除記錄。 | 畫布應用程式 |
| get命令 | 資料集的命令。 | 畫布應用程式 |
| getDataSetCapabilities | 資料集的功能。 | 畫布應用程式 |
| getSelectedRecordIds | 擷取所有選取的記錄 ID。 | 模型導向和畫布應用程式 |
| getTargetEntityType | 傳回目標資料表類型名稱。 | 模型導向和畫布應用程式 |
| get標題 | 擷取資料集屬性所使用的檢視顯示名稱。 | 模型導向和畫布應用程式 |
| getViewId | 傳回資料集參數所使用的檢視標識碼。 | 模型導向和畫布應用程式 |
| 新記錄 | 初始化本機記錄物件以進行控制以設定值。 控制項必須叫用 save() 新建立記錄上的方法，才能保存變更。 |
畫布應用程式 |
| openDataset項目 | 開啟指定 EntityReference 的資料集專案。 它會檢查是否有命令按鈕識別碼 Mscrm.OpenRecordItem。 如果存在，它會執行命令，否則它只會流覽至 EntityReference 的相關聯形式。 |
模型導向和畫布應用程式 |
| 重新整理 | 根據篩選器、排序、連結、新欄重新整理資料集。 此外，重新整理會將分頁重設為第 1 頁。 | 模型導向和畫布應用程式 |
| retrieveRecordCommand | 擷取記錄的相關聯命令。 如果資訊清單中有多個資料集，retrieveRecordCommand 會傳回第一個資料集的命令。 | 模型導向 |
| setSelectedRecordIds | 設定所選記錄的 ID。 | 模型導向和畫布應用程式 |
查閱資料行
現在可以擷取 Dataverse 資料表的查閱資料行。 對於畫布應用程式，如果資料集中包含查閱欄，則會擷取參照記錄中的所有欄。
GetFormattedValue 傳回此資料行的 JSON 字串。
GetValue 方法直接傳回JSON物件。
Example
若要深入瞭解如何實作資料集方法，請參閱 DataSet Grid 元件