DataSourceInfo 関数
適用対象:
キャンバス アプリ モデル駆動型アプリ
データ ソース に関する情報を提供します。
概要
データ ソースは、ユーザー エクスペリエンスを最適化するために貴重な情報を提供できます。
Patch 関数を使用する前に、列 レベルの情報を使用して、ユーザー入力を検証し、ユーザーに即時フィードバックを提供することができます。 Validate 関数はこの同じ情報を使用します。
データ ソース レベルで情報を使用して、たとえば、レコード を編集および作成するためのアクセス許可を持たないユーザーに対して、編集および新規作成ボタンを無効または非表示にすることができます。
データ ソースは提供する情報の量によって異なり、まったく提供しないものもあります。 コレクション は情報を提供しません。 情報が提供されない場合は、既定が使用されるか、もしくは空白が返されます。
Note
現在、DataSourceInfo関数は Microsoft Listsではサポートされていません。
プロパティ
列情報
DataSourceInfo を使用すると、データ ソースの特定の列に関する情報を取得できます。
| 情報の引数 | 結果の種類 | 内容 |
|---|---|---|
| データソース情報.表示名 | 文字列 | 列の表示名。 表示名が定義されていない場合は、列名を返します。 |
| データソース情報.最大長 | 番号 | 列が保持できる最大文字数。 文字列が含まれている列にのみ適用されます。 最大数が設定されていない場合は、空白を返します。 |
| データソース情報.最大値 | 番号 | 列が保持できる最大数値。 数値が含まれている列にのみ適用されます。 最大数が設定されていない場合は、空白を返します。 |
| データソース情報.最小値 | 番号 | 列が保持できる最小数値。 数値が含まれている列にのみ適用されます。 最小値が設定されていない場合は、空白を返します。 |
| データソース情報。必須 | Boolean | 値はこの列に必要ですか? データ ソースによって設定されていない場合は、false を返します。 |
3 番目の引数は、文字列としての列の名前です。 たとえば、人物コレクションの 電話の列は、二重引用符を含む "Phone" として渡されます。
データ ソースの情報
DataSourceInfo を使用すると、データ ソース全体に関する情報を取得することもできます。
| 情報の引数 | 結果の種類 | 内容 |
|---|---|---|
| データソース情報.許可された値 | Boolean | このデータ ソースに対してユーザーに付与できるアクセス許可の種類は何ですか? データ ソースによって設定されていない場合は、空白を返します。 |
| データソース情報.作成権限 | Boolean | 現在のユーザーは、このデータ ソースでレコードを作成するアクセス許可を持っていますか? データ ソースによって設定されていない場合は、true を返します。 |
| データソース情報削除権限 | Boolean | 現在のユーザーは、このデータ ソースでレコードを削除するアクセス許可を持っていますか? データ ソースによって設定されていない場合は、true を返します。 |
| データソース情報編集権限 | Boolean | 現在のユーザーは、このデータ ソースでレコードを編集するアクセス許可を持っていますか? データ ソースによって設定されていない場合は、true を返します。 |
| データソース情報読み取り権限 | Boolean | 現在のユーザーは、このデータ ソースでレコードを読み取りするアクセス許可を持っていますか?: データ ソースによって設定されていない場合は、true を返します。 |
Note
DataSourceInfo は、現在のユーザーが要求された権限を持っているかどうかを判断できない場合に true を返します。 実際の操作が実行されると、サーバーによってアクセス許可が再度チェックされ、許可されていない場合はエラーが表示されます。 現時点では、DataSourceInfo による権限チェックは、Microsoft Dataverse を使用する場合にのみ可能です。
構文
データソース情報( データソース, 情報 [, 列名] )
- DataSource – 必須。 使用するデータ ソース。
- 情報 – 必須。 取得する情報の種類。
- ColumnName – オプション。 列レベルの情報を取得するための列名。 データ ソース レベルの情報に関しては、ColumnName 引数を使用することはできません。
注意
バージョン 3.24042 より前の Power Apps では、列名は二重引用符を使用したテキスト文字列で指定され、データ ソースに接続されている場合は論理名である必要がありました。 たとえば、引用符のない表示名 名前 の代わりに、二重引用符で囲まれた論理名 "cr43e_name" が使用されました。 SharePoint およびスペースを含む列名を含む Excel データ ソースの場合、各スペースは "_x0020_" で指定されます。たとえば、"列名" は "Column_x0020_Name" となります。 このバージョン以降、すべてのアプリはこの記事で説明されている新しい構文に自動的に更新されました。
使用例
このセクションの例は、IceCream という名前のデータ ソースを使用します。
このデータ ソースは、次の情報も提供します。
- 数量の表示名は "手持ち在庫数量" です。
- Flavor の最大長は 30 文字です。
- Flavor 列には値を含める必要があります。 数量 列は必須ではありません。
- 最小数量は 0 です。
- 最大数量は 100 です。
- 現在のユーザーは、IceCream データ ソースのレコードの読み取りおよび編集を行うことができますが、レコードを作成および削除することはできません。
| 計算式 | 内容 | 結果 |
|---|---|---|
| データソース情報(IceCream、データソース情報.DisplayName、数量) | IceCream データ ソースの数量列の表示名を返します。 | "手持ち在庫数量" |
| DataSourceInfo( IceCream、DataSourceInfo.MaxLength、Flavor ) | IceCream データ ソースの Flavor 列の文字列の最大長を返します。 | 30 |
| DataSourceInfo( IceCream、DataSourceInfo.Required、Flavor ) | IceCream データ ソースの Flavor 列は必須ですか? | 真実 |
| DataSourceInfo( IceCream、DataSourceInfo.Required、数量 ) | IceCream データ ソースの数量列は必須ですか? | 間違い |
| データソース情報(IceCream、データソース情報.MaxValue、数量) | IceCream データ ソースの数量列の最大数値を返します。 | 100 |
| DataSourceInfo( IceCream、DataSourceInfo.MinValue、数量 ) | IceCream データ ソースの数量列の最小数値を返します。 | 0 |
| データソース情報( IceCream、データソース情報.ReadPermission) | 現在のユーザーは IceCream データ ソースのレコードを読み取ることができますか? | 真実 |
| データソース情報 (IceCream、データソース情報.EditPermission) | 現在のユーザーは IceCream データ ソースのレコードを編集できますか? | 真実 |
| データソース情報 (IceCream、データソース情報.CreatePermission) | 現在のユーザーは IceCream データ ソースのレコードを作成できますか? | 間違い |
| データソース情報(IceCream、データソース情報.DeletePermission) | 現在のユーザーは IceCream データ ソースのレコードを削除できますか? | 間違い |