Dela via

DataSourceInfo-funktion

  • Artikel

Gäller för: Arbetsyteappar Modellbaserade appar

Ger information om en datakälla.

Översikt

Datakällor kan ge mängder av information för att optimera användarupplevelsen.

Du kan använda information på kolumn-nivå för att validera användarindata och ge omedelbar feedback till användaren innan du använder Patch-funktionen. Funktionen Validate använder sig av samma information.

Du kan använda informationen på datakällenivå, för att till exempel inaktivera eller dölja knprogrammen Redigera och Ny för användare som inte har behörighet att redigera och skapa poster.

Det varierar hur mycket information datakällorna ger, ibland kan de inte ge någon alls. Samlingar ger ingen information. Om en information inte lämnas används en standard, eller blank returneras.

Kommentar

Funktionen DataSourceInfo stöds för närvarande inte i Microsoft Listor.

Description

Kolumninformation

Du kan använda DataSourceInfo att hämta information om en viss kolumn i en datakälla:

Information Argument Resultattyp Beskrivning
DataSourceInfo.DisplayName Sträng Visningsnamn för kolumnen. Returnerar kolumnnamnet om inget visningsnamn har definierats.
DataSourceInfo.MaxLength Antal Maximalt antal tecken som kolumnen kan innehålla. Gäller enbart för kolumner som innehåller strängar. Returnerar blank om maximalt värde inte anges.
DataSourceInfo.MaxValue Antal Maximalt numeriskt värde som en kolumn kan innehålla. Gäller enbart för kolumner som innehåller tal. Returnerar blank om maximalt värde inte anges.
DataSourceInfo.MinValue Antal Minsta numeriska värde som en kolumn kan innehålla. Gäller enbart för kolumner som innehåller tal. Returnerar blank om minsta värde inte anges.
DataSourceInfo.Required Boolean Krävs det ett värde för den här kolumnen? Returnerar false om detta inte anges av datakällan.

Det tredje argumentet är namnet på en kolumn som en sträng. Till exempel skulle kolumnen Phone i samlingen People skickas som "Phone" inklusive dubbla citattecken.

Information om datakälla

Du kan även använda DataSourceInfo för att hämta information om en datakälla som helhet:

Information Argument Resultattyp Beskrivning
DataSourceInfo.AllowedValues Boolean Vilka typer av behörigheter kan användare få för den här datakällan? Returnerar blank om detta inte anges av datakällan.
DataSourceInfo.CreatePermission Boolean Har den aktuella användaren behörighet att skapa poster i den här datakällan? Returnerar true om detta inte anges av datakällan.
DataSourceInfo.DeletePermission Boolean Har den aktuella användaren behörighet att ta bort poster i den här datakällan? Returnerar true om detta inte anges av datakällan.
DataSourceInfo.EditPermission Boolean Har den aktuella användaren behörighet att redigera poster i den här datakällan? Returnerar true om detta inte anges av datakällan.
DataSourceInfo.ReadPermission Boolean Har den aktuella användaren behörighet att läsa poster i den här datakällan? Returnerar true om detta inte anges av datakällan.

Kommentar

DataSourceInfo returnerar true om det inte går att avgöra om den aktuella användaren har den begärda behörigheten. Behörigheter kontrolleras igen av servern när den faktiska åtgärden utförs och ett fel visas om det inte var tillåtet. I nuläget är behörighetskontroller med DataSourceInfo endast möjligt när du använder Microsoft Dataverse.

Syntax

DataSourceInfo(DataSource,Information [, ColumnName ] )

  • DataSource – Obligatoriskt. Datakällan som ska användas.
  • Information – Obligatoriskt. Den typ av information som du vill hämta.
  • ColumnName – Valfritt. Kolumnnamnet som information på kolumnnivå ska hämtas till. För information på datakällenivå kan inte ColumnName-argumentet användas.

Kommentar

I Power Apps före version 3.24042, angav kolumnnamn specificerades med en textsträng med dubbla citattecken och om de var anslutna till en datakälla behövde de också vara logiska namn. Det logiska namnet "cr43e_name" med dubbla citattecken användes till exempel i stället för visningsnamnet Namn utan citattecken. För SharePoint och Excel-datakällor som innehåller kolumnnamn med blanksteg angavs varje blanksteg med "_x0020_", till exempel "Kolumnnamn" som "Column_x0020_Name". Efter den här versionen uppdaterades alla appar automatiskt till den nya syntax som beskrivs i den här artikeln.

Exempel

Exemplen i det här avsnittet använder en datakälla med namnet IceCream:

Exempel på IceCream.

Datakällan har också lämnat den här informationen:

  • Visningsnamnet för Quantity är "Lagersaldo".
  • Den maximala längden på Flavor är 30 tecken.
  • Kolumnen Flavor måste innehålla ett värde. Kolumnen Quantity är inte obligatorisk.
  • Minsta värde för Quantity är 0.
  • Maximalt värde för Quantity är 100.
  • Den aktuella användaren kan läsa och redigera posterna för datakällan IceCream, men kan inte skapa eller ta bort poster.
Formel Beskrivning Resultat
DataSourceInfo( IceCream, DataSourceInfo.DisplayName, Quantity ) Returnerar visningsnamnet för kolumnen Quantity i datakällan IceCream. "Lagersaldo"
DataSourceInfo( IceCream, DataSourceInfo.MaxLength, Smak ) Returnerar den maximala längden på strängen för kolumnen Flavor i datakällan IceCream. 30
DataSourceInfo( IceCream, DataSourceInfo.Required, Smak ) Är kolumnen Flavor i datakällan IceCream obligatorisk? sann
DataSourceInfo( IceCream, DataSourceInfo.Required, Quantity ) Är kolumnen Quantity i datakällan IceCream obligatorisk? falsk
DataSourceInfo( IceCream, DataSourceInfo.MaxValue, Quantity ) Returnerar det maximala numeriska värdet för kolumnen Quantity i datakällan IceCream. 100
DataSourceInfo( IceCream, DataSourceInfo.MinValue, Quantity ) Returnerar det minimala numeriska värdet för kolumnen Quantity i datakällan IceCream. 0
DataSourceInfo( IceCream, DataSourceInfo.ReadPermission) Kan den aktuella användaren läsa poster i datakällan IceCream? sann
DataSourceInfo( IceCream, DataSourceInfo.EditPermission) Kan den aktuella användaren redigera poster i datakällan IceCream? sann
DataSourceInfo( IceCream, DataSourceInfo.CreatePermission) Kan den aktuella användaren skapa poster i datakällan IceCream? falsk
DataSourceInfo( IceCream, DataSourceInfo.DeletePermission) Kan den aktuella användaren ta bort poster i datakällan IceCream? falsk