Funkcia DataSourceInfo

Vzťahuje sa na: Aplikácie plátna Modelom riadené aplikácie

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

DataSourceInfo V súčasnosti nie je funkcia podporovaná v zoznamoch spoločnosti Microsoft.

Description

Informácie o stĺpci

Pomocou môžete DataSourceInfo získať informácie o konkrétnom stĺpci zdroja údajov:

Argument informácií	Typ výsledku	Description
DataSourceInfo. Zobrazované meno	Reťazec	Zobrazovaný názov stĺpca. Ak nie je zobrazovaný názov definovaný, vráti sa názov stĺpca.
DataSourceInfo. MaxLength (dĺžka)	Čí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. Hodnota 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. Hodnota 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. Požadovaný	booleovský	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

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

Argument informácií	Typ výsledku	Description
DataSourceInfo. AllowedValues	booleovský	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. Vytvorenie povolenia	booleovský	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. Odstrániť povolenia	booleovský	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. Úprava povolenia	booleovský	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 (Čítanie)	booleovský	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 hodnotu true , ak nedokáže určiť, či aktuálny používateľ má 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 kontrola DataSourceInfo povolení možná len pri používaní služby Microsoft Dataverse.

Syntax

DataSourceInfo( DataSource, Information [, ColumnName] )

• 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 logický názov "cr43e_name" s dvojitými úvodzovkami bol použitý namiesto zobrazovaného názvu Názov bez úvodzoviek. Pre zdroje údajov SharePoint a Excel, ktoré obsahujú názvy stĺpcov s medzerami, bola každá medzera špecifikovaná pomocou "_x0020_", napríklad "Stĺpec Názov" 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:

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	Description	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, Flavor )	Vráti maximálnu dĺžku reťazca pre stĺpec Flavor zdroja údajov IceCream.	30
DataSourceInfo( IceCream, DataSourceInfo. Povinné, Príchuť )	Je stĺpec Flavor zdroja údajov IceCream povinný?	pravda
DataSourceInfo( IceCream, DataSourceInfo. Povinné, Množstvo )	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. Vytvorenie povolenia)	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é