RecordInfo-Funktion

  • Artikel

Gilt für: Canvas-Apps Modellgesteuerte Apps

Liefert Informationen über einen Datensatz einer Datenquelle.

Verwenden Sie RecordInfo, um Informationen über einen bestimmten Datensatz einer Datenquelle zu erhalten. Die Datenquelle muss tabellarisch sein und mit den Funktionen Remove und Patch kompatibel sein.

Zur Zeit wird nur Microsoft Dataverse unterstützt. Datensätze aus allen anderen Datenquellen führen zu einem Formelfehler.

Die verfügbaren Informationen:

Informationsargument Beschreibung
RecordInfo.DeletePermission Hat der aktuelle Benutzer die Berechtigung, diesen Datensatz aus der Datenquelle zu entfernen?
RecordInfo.EditPermission Verfügt der aktuelle Benutzer über die Berechtigung, diesen Datensatz in der Datenquelle zu ändern?
RecordInfo.ReadPermission Verfügt der aktuelle Benutzer über die Berechtigung, diesen Datensatz aus der Datenquelle zu lesen?

RecordInfo gibt einen booleschen Wert zurück:

Wert zurückgeben Beschreibung
true Der Benutzer hat die Berechtigung.
False Der Benutzer hat keine Berechtigung. Wenn der Datensatz leer ist, gibt RecordInfo auch false zurück.

RecordInfo berücksichtigt auch die Berechtigungen auf der Ebene der Datenquelle. Wenn der Benutzer z.B. auf Datensatzebene die Berechtigung hat, einen Datensatz zu ändern, aber nicht auf Tabellenebene, dann wird false für ModifyPermission zurückgegeben. Verwenden Sie die Funktion DataSourceInfo, um Informationen über die Datenquelle als Ganzes zu erhalten.

Syntax

RecordInfo( Datensatz, Information )

  • Datensatz – Erforderlich. Der zu prüfende Datensatz.
  • Information – Erforderlich. Die gewünschten Informationen für den Datensatz.

Beispiele

RecordInfo( First(Accounts), RecordInfo.EditPermission )

Prüft die Berechtigung zur Bearbeitung des ersten Datensatzes in der Datenquelle Accounts, die sich in Dataverse, SharePoint, SQL Server oder einer anderen tabellarischen Datenquelle befinden kann. Wenn der Benutzer die Berechtigung hat, diesen Datensatz zu bearbeiten und die Datenquelle Accounts allgemein zu ändern, dann gibt RecordInfowahr zurück.

With( { MyRecord: First( Accounts ) },
      RecordInfo( MyRecord, RecordInfo.EditPermission ) )

Erfasst einen Datensatz mit der Funktion With und übergibt diesen Wert dann an die Funktion RecordInfo. Das Ergebnis ist dasselbe wie im letzten Beispiel.

Collect( MyAccounts, FirstN( Accounts, 10 ) );
RecordInfo( First( MyAccounts ), RecordInfo.EditPermission ) )

Erfasst die ersten 10 Datensätze aus der Datenquelle Accounts in der Sammlung MyAccounts. Da die Datensätze aus einer Datenquelle stammen, können sie mit der Funktion RecordInfo verwendet werden. Das Ergebnis ist dasselbe wie im letzten Beispiel.

Collect( MyCollection, [ 1, 2, 3 ] );
RecordInfo( First(MyCollection), RecordInfo.DeletePermission )

Erstellt die Sammlung MyCollection und testet den ersten Datensatz, um festzustellen, ob er entfernt werden kann. Da der Datensatz aus einer Sammlung und nicht aus einer Datenquelle stammt, wird RecordInfo einen Fehler zurückgeben.