DataSet

  • [アーティクル]

グリッドとビューのデータを操作するプロパティとメソッドを提供します。

以下に使用できます

モデル駆動型アプリとキャンバス アプリ。

プロパティ​​

columns

このデータセットで利用可能な一連の列。 モデル駆動型アプリとキャンバス アプリの両方でサポートされます。

種類: 列 []

エラー

データ取得中にエラーが発生したか。 モデル駆動型アプリとキャンバス アプリの両方でサポートされます。

タイプ: boolean

errorCode

最後に発生したエラーに関連するエラーコード (該当する場合)。

errorMessage

適応対象の場合、最後に発生したエラーに関連付けられたエラー メッセージ。

型: number | string

フィルター

現在のクエリの列のフィルター処理。 モデル駆動型アプリとキャンバス アプリの両方でサポートされます。 context.parameters.[dataset_property_name].filtering.setFilter(<filterExpression>) を設定することにより、データセットのフィルター処理を構成できます。 フィルターの設定後は、呼び出した context.parameters.[dataset_property_name].refresh() は、データソースからフィルタリングされたデータを取得します。

値 条件演算子 モデル駆動型アプリ キャンバス アプリ
-1 いいえ​​ はい はい
0 等号 はい はい
1 NotEqual はい はい
2 GreaterThan はい はい
3 未満 はい はい
4 GreaterEqual はい はい
5 LessEqual はい はい
6 いいね はい はい
7 NotLike いいえ はい
8 含む はい はい
12 Null はい はい
13 NotNull いいえ はい
14 前日 はい いいえ
15 が今日 はい いいえ
16 が明日 はい いいえ
17 Last7Days はい いいえ
18 Next7Days はい いいえ
19 LastWeek はい いいえ
20 ThisWeek はい いいえ
22 LastMonth はい いいえ
23 ThisMonth はい いいえ
25 次の日付と等しい はい いいえ
26 OnOrBefore はい いいえ
27 OnOrAfter はい いいえ
28 LastYear はい いいえ
29 ThisYear はい いいえ
33 LastXDays はい いいえ
34 NextXDays はい いいえ
37 LastXMonths はい いいえ
38 NextXMonths はい いいえ
49 次を含む はい はい
54 BeginWith いいえ はい
55 DoesNotBeginWidth いいえ はい
56 EndsWidth いいえ はい
57 DesNotEndWith いいえ はい
70 InFiscalPeriodAndYear はい いいえ
75 上 はい はい
76 次の値より下 はい はい
77 NotUnder はい はい
78 AboveOrEqual はい はい
79 UnderOrEqual はい はい
87 ContainValues はい はい
88 DoesNotContainValues いいえ はい

注意

フィルター処理機能は、Dataverse データ ソースでのみ使用できます。

種類: フィルター

linking

リンクされたテーブル情報を定義します。 モデル駆動型アプリでのみサポートされます。

種類: Linking

loading

データセットが読み込み中かどうかを示します。 モデル駆動型アプリとキャンバス アプリの両方でサポートされます。

タイプ: boolean

paging

改ページの状態とアクション。 モデル駆動型アプリとキャンバス アプリの両方でサポートされます。 ページング情報は、context.parameters.[dataset_property_name].paging を使用してデータセットにアクセスし、構成できます。

注意

Dataverse データ ソースは、キャンバス アプリのページング オブジェクトで totalRecordCount を返しません。 代わりに、hasNextPage と hasPreviousPage を使用して、フェッチするレコードが他にあるかどうかを確認します。

データセット コンポーネントは、context.parameters.[dataset_property_name].paging.setPageSize(pageSize) を使用して、ページごとに取得されるレコードの数を変更できます。

種類: Paging

records

完全なレコード オブジェクトへの ID のマップ。 モデル駆動型アプリとキャンバス アプリの両方でサポートされます。

種類: EntityRecord

sortedRecordIds

データセット内のレコードのID、クエリの応答結果で並べ替えます。 モデル駆動型アプリとキャンバス アプリの両方でサポートされます。

種類: string[]

sorting

現在のクエリの並べ替え状態。 モデル駆動型アプリとキャンバス アプリの両方でサポートされます。 context.parameters.[dataset_property_name].sorting = [SortStatus] を設定することにより、データセットの並べ替えを構成できます。 並べ替えが構成されたら、context.parameters.[dataset_property_name].refresh() を呼び出すことで、並べ替えられたデータがデータ ソースから取得されます。

注意

並べ替え処理機能は、Dataverse データ ソースでのみ使用できます。 また、並べ替えを再構成すると、フィルター context.parameters.[dataset_property_name].filtering がリセットされます

種類: SortStatus[]

メソッド

メソッド 説明設定 以下に使用できます
addColumn 列のセットに列を追加します。 モデル駆動型アプリ
clearSelectedRecordIds 選択したレコード ID リストをクリアします。 モデル駆動型アプリとキャンバス アプリ
削除 データ ソースからレコードを削除します。 キャンバス アプリ
getCommands このデータ セットのコマンドです。 キャンバス アプリ
getDataSetCapabilities このデータ セットの機能です。 キャンバス アプリ
getSelectedRecordIds 選択されたすべてのレコード ID を取得します。 モデル駆動型アプリとキャンバス アプリ
getTargetEntityType ターゲット テーブルの種類名を返します。 モデル駆動型アプリとキャンバス アプリ
getTitle データセット プロパティで使用されるビュー表示名を取得します。 モデル駆動型アプリとキャンバス アプリ
getViewId データセットパラメーターで使用されるビューの ID を返します。 モデル駆動型アプリとキャンバス アプリ
newRecord コントロールが値を設定するために、ローカル レコード オブジェクトを初期化します。 コントロールは、変更を持続させるために、新しく作成されたレコードに対して save() メソッドを呼び出す必要があります。 キャンバス アプリ
openDatasetItem 指定された EntityReference のデータセット アイテムを開きます。 コマンド ボタン ID Mscrm.OpenRecordItem のコマンドがあるか確認します。 存在する場合はコマンドを実行し、それ以外の場合は EntityReference の関連フォームに移動します。 モデル駆動型アプリとキャンバス アプリ
refresh フィルター、並べ替え、リンク、新しい列に基づいてデータセットを更新します。 さらに、更新するとページングがページ 1 にリセットされます。 モデル駆動型アプリとキャンバス アプリ
retrieveRecordCommand レコードに関連付けられているコマンドを取得します。 マニフェストに複数のデータセットがある場合、retrieveRecordCommand は最初のデータセットのコマンドを返します。 モデル駆動型
setSelectedRecordIds 選択したレコードの ID を設定します。 モデル駆動型アプリとキャンバス アプリ

検索列

Dataverse テーブルの検索列を取得できるようになりました。 キャンバス アプリの場合、検索列がデータセットに含まれていれば、参照されるレコードのすべての列が取得されます。 GetFormattedValue は、この列の JSON 文字列を返します。 GetValue メソッドは JSON オブジェクトを直接返します。

例

データセット メソッドを実装する方法の詳細については、DataSet Grid コンポーネント を参照してください

Power Apps Component Framework API リファレンス
Power Apps component framework の概要

注意

ドキュメントの言語設定についてお聞かせください。 簡単な調査を行います。 (この調査は英語です)

この調査には約 7 分かかります。 個人データは収集されません (プライバシー ステートメント)。