RecordInfo 関数
適用先:
キャンバス アプリ モデル駆動型アプリ
データ ソースの特定のレコードに関する情報を取得するには、RecordInfo を使用します。 データソースは表形式で、Remove および Patch 機能に対応している必要があります。
現時点では、Microsoft Dataverse のみがサポートされています。 他のすべてのデータソースからのレコードは、数式エラーになります。
利用可能な情報:
| 情報引数 | 内容 |
|---|---|
| RecordInfo.DeletePermission | 現在のユーザーに、このレコードをデータソースから削除する権限が付与されているか？ |
| RecordInfo.EditPermission | 現在のユーザーに、データソース内のこのレコードを修正する権限が付与されているか？ |
| RecordInfo.ReadPermission | 現在のユーザーに、このレコードをデータソースから読み取る権限が付与されているか？ |
RecordInfo はブール値を返します:
| 値を返す | 内容 |
|---|---|
| true | ユーザーに権限が付与されています。 |
| 偽 | ユーザーに権限が付与されていません。 レコードが空欄の場合、RecordInfo は false を返します。 |
RecordInfo は、データ ソースレベルの権限も考慮に入れます。 たとえば、ユーザーがレコード レベルではレコードを変更する権限を持っているが、テーブル レベルでは権限を持っていない場合、ModifyPermission に対して false を返します。 DataSourceInfo 関数を使用すると、データ ソース全体に関する次の情報を取得することもできます。
構文
RecordInfo( Record、Information )
- Record – 必須。 テストするレコード。
- Information – 必須。 レコードに必要な情報。
例
RecordInfo( First(Accounts), RecordInfo.EditPermission )
Dataverse、SharePoint、SQL Server、または他の表形式のデータ ソースである Accounts データ ソースの最初のレコードの編集権限を確認します。 ユーザーがこのレコードの編集や、 Accounts データソース全般を変更する権限を持っている場合、RecordInfo は true を返します。
With( { MyRecord: First( Accounts ) },
RecordInfo( MyRecord, RecordInfo.EditPermission ) )
With 関数でレコードを取得し、その値を RecordInfo 関数に渡します。 結果は最後の例と同じになります。
Collect( MyAccounts, FirstN( Accounts, 10 ) );
RecordInfo( First( MyAccounts ), RecordInfo.EditPermission ) )
Accounts データソースの最初の 10 レコードを MyAccounts コレクションに取り込みます。 このレコードはデータソースに由来するものなので、RecordInfo 関数で使用することができます。 結果は最後の例と同じになります。
Collect( MyCollection, [ 1, 2, 3 ] );
RecordInfo( First(MyCollection), RecordInfo.DeletePermission )
MyCollection コレクションを作成し、最初のレコードが削除できるかどうかをテストします。 レコードの起源はコレクションであり、データソースではないため、RecordInfo はエラーを返します。