フィードバック

DataSet

  • [アーティクル]

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

以下に使用できます

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

プロパティ​​

列

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

種類: Column []

エラー

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

種類: 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

読み込み中

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

種類: boolean

paging

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

注意

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

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

種類: Paging

レコード

完全なレコード オブジェクトへの 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 分かかります。 個人データは収集されません (プライバシー ステートメント)。