Zdieľať cez

Funkcia DataSourceInfo

  • Článok

Vzťahuje sa na: aplikácie plátna aplikácie s podporou modelov

Poskytuje informácie o zdroji údajov.

Prehľad

Zdroje údajov môžu poskytovať množstvo informácií na optimalizáciu používateľského prostredia.

Pomocou informácie na úrovni stĺpca môžete overiť zadanie používateľa a poskytnúť mu okamžitú spätnú väzbu pred tým, ako použijete funkciu Patch. Rovnaké informácie používa funkcia Validate.

Pomocou informácií na úrovni zdroja údajov môžete napríklad zakázať alebo skryť tlačidlá Upraviť a Nový pre používateľov, ktorí nemajú povolenie upravovať a vytvárať záznamy.

Zdroje údajov sa líšia v tom, koľko informácií poskytujú, vrátane možnosti, že neposkytujú vôbec žiadne. Kolekcie neposkytujú žiadne informácie. Ak nejaká informácia nie je poskytnutá, použije sa predvolený režim, alebo sa vráti prázdna hodnota.

Poznámka

Funkcia DataSourceInfo momentálne nie je podporovaná v Microsoft Zoznamoch.

Description

Informácie o stĺpci

Funkciu DataSourceInfo môžete použiť na získanie informácií o konkrétnom stĺpci zdroja údajov:

Argument informácií Typ výsledku Popis
DataSourceInfo.DisplayName Reťazec Zobrazovaný názov stĺpca. Ak nie je zobrazovaný názov definovaný, vráti sa názov stĺpca.
DataSourceInfo.MaxLength Číslo Maximálny počet znakov, ktorý môže stĺpec obsahovať. Vzťahuje sa iba na stĺpce obsahujúce reťazce. Ak nie je maximum nastavené, vráti sa prázdna hodnota.
DataSourceInfo.MaxValue Číslo Maximálna číselná hodnota, ktorú môže stĺpec obsahovať. Vzťahuje sa iba na stĺpce obsahujúce čísla. Ak nie je maximum nastavené, vráti sa prázdna hodnota.
DataSourceInfo.MinValue Číslo Minimálna číselná hodnota, ktorú môže stĺpec obsahovať. Vzťahuje sa iba na stĺpce obsahujúce čísla. Ak nie je minimum nastavené, vráti sa prázdna hodnota.
DataSourceInfo.Required Boolean Je hodnota v tomto stĺpci povinná? Ak nie je zdrojom údajov nastavené, vráti sa hodnota nepravda.

Tretí argument je názov stĺpca vo forme reťazca. Napríklad stĺpec Phone v kolekcii People by sa odovzdal ako "Phone" vrátane dvojitých úvodzoviek.

Informácie o zdroji údajov

Funkciu DataSourceInfo môžete použiť na získanie informácií o zdroji údajov ako celku:

Argument informácií Typ výsledku Popis
DataSourceInfo.AllowedValues Boolean Aké typy povolení môžu byť používateľom pre tento zdroj údajov udelené? Ak nie je zdrojom údajov nastavené, vráti sa prázdna hodnota.
DataSourceInfo.CreatePermission Boolean Má aktuálny používateľ povolenie vytvárať záznamy v tomto zdroji údajov? Ak nie je zdrojom údajov nastavené, vráti sa hodnota pravda.
DataSourceInfo.DeletePermission Boolean Má aktuálny používateľ povolenie odstraňovať záznamy v tomto zdroji údajov? Ak nie je zdrojom údajov nastavené, vráti sa hodnota pravda.
DataSourceInfo.EditPermission Boolean Má aktuálny používateľ povolenie upravovať záznamy v tomto zdroji údajov? Ak nie je zdrojom údajov nastavené, vráti sa hodnota pravda.
DataSourceInfo.ReadPermission Boolean Má aktuálny používateľ povolenie čítať záznamy v tomto zdroji údajov? Ak nie je zdrojom údajov nastavené, vráti sa hodnota pravda.

Poznámka

DataSourceInfo vráti pravda ak nedokáže určiť, či má aktuálny používateľ požadované povolenie. Keď bude vykonaná skutočná operácia, server znova skontroluje povolenia a ak to nebolo povolené, zobrazí sa chyba. V súčasnosti je možné kontrola povolení s DataSourceInfo len pri použití Microsoft Dataverse.

Syntax

DataSourceInfo( DataSource, Information [, Názov stĺpca ] )

  • DataSource – povinné. Zdroj údajov, ktorý sa má použiť.
  • Informácie – povinné. Typ informácií, ktoré chcete načítať.
  • Názov stĺpca – voliteľné. Názov stĺpca, pre ktorý sa majú získať informácie na úrovni stĺpca. Pre informáciu na úrovni zdroja údajov sa argument ColumnName nedá použiť.

Poznámka

V Power Apps pred verziou 3.24042 boli názvy stĺpcov špecifikované textovým reťazcom pomocou dvojitých úvodzoviek a ak boli pripojené k zdroj údajov, museli to byť aj logické názvy. Napríklad namiesto zobrazovaného názvu Názov bez úvodzoviek bol použitý logický názov "cr43e_name" s dvojitými úvodzovkami. Pre zdroje údajov SharePoint a Excel, ktoré obsahujú názvy stĺpcov s medzerami, bola každá medzera špecifikovaná pomocou "_x0020_", napríklad "Názov stĺpca" ako "Názov_x0020_stĺpca". Po tejto verzii boli všetky aplikácie automaticky aktualizované na novú syntax opísanú v tomto článku.

Príklady

V príkladoch v tejto časti sa používa zdroj údajov s názvom IceCream:

Príklad zmrzliny.

Zdroj údajov tiež poskytuje tieto informácie:

  • Zobrazovaný názov stĺpca Quantity je „Quantity on Hand“.
  • Maximálna dĺžka stĺpca Flavor je 30 znakov.
  • Stĺpec Flavor musí obsahovať hodnotu. Stĺpec Quantity nie je povinný.
  • Minimálna hodnota stĺpca Quantity je 0.
  • Maximálna hodnota stĺpca Quantity je 100.
  • Aktuálny používateľ môže čítať a upravovať záznamy v zdroji údajov IceCream, ale nemôže ich vytvárať ani odstraňovať.
Vzorec Popis Výsledok
DataSourceInfo( IceCream, DataSourceInfo.DisplayName, Quantity ) Vráti zobrazovaný názov stĺpca Quantity zdroja údajov IceCream. „Quantity on Hand“
DataSourceInfo( IceCream, DataSourceInfo.MaxLength, Flavour ) Vráti maximálnu dĺžku reťazca pre stĺpec Flavor zdroja údajov IceCream. 30
DataSourceInfo( IceCream, DataSourceInfo.Required, Flavour ) Je stĺpec Flavor zdroja údajov IceCream povinný? pravda
DataSourceInfo( IceCream, DataSourceInfo.Required, Quantity ) Je stĺpec Quantity zdroja údajov IceCream povinný? falošný
DataSourceInfo( IceCream, DataSourceInfo.MaxValue, Quantity ) Vráti maximálnu číselnú hodnotu pre stĺpec Quantity zdroja údajov IceCream. 100
DataSourceInfo( IceCream, DataSourceInfo.MinValue, Quantity ) Vráti minimálny číselnú hodnotu pre stĺpec Quantity zdroja údajov IceCream. 0
DataSourceInfo( IceCream, DataSourceInfo.ReadPermission) Môže aktuálny používateľ čítať záznamy v zdroji údajov IceCream? pravda
DataSourceInfo( IceCream, DataSourceInfo.EditPermission) Môže aktuálny používateľ upravovať záznamy v zdroji údajov IceCream? pravda
DataSourceInfo( IceCream, DataSourceInfo.CreatePermission) Môže aktuálny používateľ vytvárať záznamy v zdroji údajov IceCream? falošný
DataSourceInfo( IceCream, DataSourceInfo.DeletePermission) Môže aktuálny používateľ odstraňovať záznamy v zdroji údajov IceCream? falošný