DataSourceInfo-Funktion

Gilt für: Canvas-Apps Modellgesteuerte Apps

Stellt Informationen über eine Datenquelle bereit

Überblick

Datenquellen können eine Fülle von Informationen bereitstellen, um die Benutzerfreundlichkeit zu optimieren.

Sie können Informationen auf Spaltenebene verwenden, um Benutzereingaben zu prüfen und dem Benutzer vor dem Verwenden der Patch-Funktion sofort Feedback zu geben. Die Validate-Funktion verwendet die gleichen Informationen.

Sie können Informationen auf Datenquellenebene z.B. verwenden, um die Schaltflächen Bearbeiten und Neu für Benutzer zu deaktivieren oder auszublenden, die keine Berechtigungen haben, Datensätze zu bearbeiten und zu erstellen.

Datenquellen stellen unterschiedlich viele Informationen zur Verfügung, manchmal sogar gar keine. Sammlungen stellen keine Informationen bereit. Wenn eine Information nicht bereitgestellt wird, wird ein Standardwert verwendet, oder es wird blank (leer) zurückgegeben.

Notiz

Derzeit wird die Funktion DataSourceInfo in Microsoft Lists nicht unterstützt.

Beschreibung des Dataflows

Spalteninformationen

Sie können DataSourceInfo verwenden, um Informationen über eine bestimmte Spalte einer Datenquelle zu erhalten:

Informationsargument Ergebnistyp Beschreibung
DataSourceInfo.DisplayName Zeichenfolge Anzeigename für die Spalte. Wenn kein Anzeigename definiert ist, wird der Spaltennamen zurückgegeben.
DataSourceInfo.MaxLength Anzahl Maximale Anzahl von Zeichen, die die Spalte enthalten kann. Gilt nur für Spalten, die Zeichenfolgen enthalten. Wenn ein Maximum nicht festgelegt ist, wird blank zurückgegeben.
DataSourceInfo.MaxValue Anzahl Höchster numerischer Wert, den eine Spalte enthalten kann. Gilt nur für Spalten, die Zahlen enthalten. Wenn ein Maximum nicht festgelegt ist, wird blank zurückgegeben.
DataSourceInfo.MinValue Anzahl Niedrigster numerischer Wert, den eine Spalte enthalten kann. Gilt nur für Spalten, die Zahlen enthalten. Wenn ein Minimum nicht festgelegt ist, wird blank zurückgegeben.
DataSourceInfo.Required Boolean Ist ein Wert für diese Spalte erforderlich? Wenn nicht von der Datenquelle festgelegt, wird FALSE zurückgegeben.

Das dritte Argument ist der Name einer Spalte als Zeichenfolge. Beispielsweise würde die Spalte Phone (Telefon) in der Sammlung People (Personen) würde als "Phone", inklusive der doppelten Anführungszeichen, übergeben werden.

Datenquelleninformationen

Sie können DataSourceInfo auch dazu verwenden, Informationen über die Datenquelle als Ganzes abzurufen:

Informationsargument Ergebnistyp Beschreibung
DataSourceInfo.AllowedValues Boolean Welche Arten von Berechtigungen können Benutzern für diese Datenquelle werden erteilt? Gibt leer zurück, wenn von der Datenquelle nicht festgelegt.
DataSourceInfo.CreatePermission Boolean Verfügt der aktuelle Benutzer über die Berechtigung zum Erstellen von Datensätzen in dieser Datenquelle? Wenn nicht von der Datenquelle festgelegt, wird TRUE zurückgegeben.
DataSourceInfo.DeletePermission Boolean Verfügt der aktuelle Benutzer über die Berechtigung zum Löschen von Datensätzen in dieser Datenquelle? Wenn nicht von der Datenquelle festgelegt, wird TRUE zurückgegeben.
DataSourceInfo.EditPermission Boolean Verfügt der aktuelle Benutzer über die Berechtigung zum Bearbeiten von Datensätzen in dieser Datenquelle? Wenn nicht von der Datenquelle festgelegt, wird TRUE zurückgegeben.
DataSourceInfo.ReadPermission Boolean Verfügt der aktuelle Benutzer über die Berechtigung zum Lesen von Datensätzen in dieser Datenquelle? Wenn nicht von der Datenquelle festgelegt, wird wahr zurückgegeben.

Notiz

DataSourceInfo gibt True zurück, wenn nicht festgestellt werden kann, ob der aktuelle Benutzer über die angeforderte Berechtigung verfügt. Die Berechtigungen werden vom Server erneut überprüft, wenn der eigentliche Vorgang ausgeführt wird, und ein Fehler wird angezeigt, wenn dies nicht zulässig war. Zur Zeit ist die Überprüfung von Berechtigungen mit DataSourceInfo nur bei Verwendung von Microsoft Dataverse möglich.

Syntax

DataSourceInfo( Datenquelle, Information, Spaltenname )

  • DataSource – Erforderlich. Die zu verwendende Datenquelle.

  • Information – Erforderlich. Der Typ von Information, den Sie abrufen möchten.

  • Spaltenname – Optional. Bei Informationen auf Spaltenebene der Spaltenname als Zeichenfolge. Die Spalte Phone würde als "Phone", inklusive der doppelten Anführungszeichen, übergeben werden. Für Informationen auf Datenbankebene kann das Spaltenname-Argument nicht verwendet werden.

    Notiz

    Bei SharePoint- und Excel-Datenquellen, die Spaltennamen mit Leerzeichen enthalten, geben Sie jedes Leerzeichen als _x0020_ an. Geben Sie zum Beispiel "Column Name" als "Column_x0020_Name" an.

Beispiele

In den Beispielen in diesem Abschnitt wird diese Datenquelle namens IceCream (Eiscreme) verwendet:

Icecream Beispiel.

Die Datenquelle hat zudem diese Informationen bereitgestellt:

  • Der Anzeigename für Quantity (Menge) ist "Quantity on Hand" (Lagerbestand).
  • Die maximale Länge von Flavor (Sorte) beträgt 30 Zeichen.
  • Die Spalte Flavor muss einen Wert enthalten. Die Spalte Quantity ist nicht erforderlich.
  • Der minimale Wert für Quantity ist 0.
  • Der maximale Wert für Quantity ist 100.
  • Der aktuelle Benutzer kann die Datensätze der Datenquelle IceCream lesen und bearbeiten, jedoch keine Datensätze erstellen oder löschen.
Formel Beschreibung Ergebnis
DataSourceInfo( IceCream, DataSourceInfo.DisplayName, Menge ) Gibt den Anzeigenamen für die Spalte Quantity der Datenquelle IceCream zurück „Lagerbestandsmenge“
DataSourceInfo( IceCream, DataSourceInfo.MaxLength, „Flavor“) Gibt die maximale Länge der Zeichenfolge für die Spalte Flavor der Datenquelle IceCream zurück. 30
DataSourceInfo( IceCream, DataSourceInfo.Required, „Flavor“) Ist die Spalte Flavor der Datenquelle IceCream erforderlich? true
DataSourceInfo( IceCream, DataSourceInfo.Required, Menge ) Ist die Spalte Quantity der Datenquelle IceCream erforderlich? false
DataSourceInfo( IceCream, DataSourceInfo.MaxValue, Menge ) Gibt den höchsten numerischen Wert für die Spalte Quantity der Datenquelle IceCream zurück 100
DataSourceInfo( IceCream, DataSourceInfo.MinValue, Menge ) Gibt den niedrigsten numerischen Wert für die Spalte Quantity der Datenquelle IceCream zurück 0
DataSourceInfo( IceCream, DataSourceInfo.ReadPermission) Kann der aktuelle Benutzer Datensätze in der Datenquelle IceCream lesen? true
DataSourceInfo( IceCream, DataSourceInfo.EditPermission) Kann der aktuelle Benutzer Datensätze in der Datenquelle IceCream bearbeiten? true
DataSourceInfo( IceCream, DataSourceInfo.CreatePermission) Kann der aktuelle Benutzer Datensätze in der Datenquelle IceCream erstellen? false
DataSourceInfo( IceCream, DataSourceInfo.DeletePermission) Kann der aktuelle Benutzer Datensätze in der Datenquelle IceCream löschen? false