DataSourceInfo-funktion
Gäller appar:
Arbetsyteappar Modellbaserade program
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 innehåller ingen information. Om en information inte lämnas används en standard, eller blank returneras.
Kommentar
För tillfället stöds funktionen DataSourceInfo inte i Microsoft Lists.
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 sant 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 – Krävs. Datakällan som ska användas.
Information – obligatoriskt. Den typ av information som du vill hämta.
ColumnName – valfritt. För information på kolumnnivå, kolumnnamnet som en sträng. Kolumnen Phone skulle skickas som "Phone" inklusive dubbla citattecken. För information på datakällenivå kan inte ColumnName-argumentet användas.
Kommentar
För SharePoint och Excel-datakällor som innehåller kolumnnamn med blanksteg, anges varje utrymme som "_x0020_". Ange till exempel "Kolumnens namn" som "Kolumnens_x0020_namn".
Exempel
Exemplen i det här avsnittet använder en datakälla med namnet 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, "Flavor" ) | Returnerar den maximala längden på strängen för kolumnen Flavor i datakällan IceCream. | 30 |
| DataSourceInfo( IceCream , DataSourceInfo.Required, "Flavor" ) | Är kolumnen Flavor i datakällan IceCream obligatorisk? | true |
| DataSourceInfo( IceCream , DataSourceInfo.Required, "Quantity" ) | Är kolumnen Quantity i datakällan IceCream obligatorisk? | false |
| 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? | true |
| DataSourceInfo( IceCream , DataSourceInfo.EditPermission) | Kan den aktuella användaren redigera poster i datakällan IceCream? | true |
| DataSourceInfo( IceCream , DataSourceInfo.CreatePermission) | Kan den aktuella användaren skapa poster i datakällan IceCream? | false |
| DataSourceInfo( IceCream , DataSourceInfo.DeletePermission) | Kan den aktuella användaren ta bort poster i datakällan IceCream? | false |