DataSourceInfo Funkce

Platí pro: Modelem řízené aplikace plátna

Poskytuje informace o zdroji dat.

Přehled

Zdroje dat mohou poskytovat spoustu informací pro optimalizaci uživatelského prostředí.

Pomocí informací na úrovni sloupce můžete ověřit zadání uživatele a poskytnout mu bezprostřední zpětnou vazbu, než použijete funkci Patch. Tytéž informace používá funkce Validate.

Pomocí informací na úrovni zdroje dat můžete například uživatelům, kteří nemají oprávnění k úpravě nebo vytváření záznamů, zakázat nebo skrýt tlačítka Upravit a Nový.

Zdroje dat se liší v tom, kolik informací poskytují, včetně možnosti, kdy neposkytují vůbec žádné. Sbírky neposkytují žádné informace. Pokud se nějaká část informací neposkytuje, použije se výchozí hodnota, nebo se vrátí prázdná hodnota.

Poznámka:

DataSourceInfo V současné době není tato funkce v seznamech Microsoftu podporovaná.

Popis

Informace o sloupci

Můžete použít DataSourceInfo k získání informací o konkrétním sloupci zdroje dat:

Argument informací	Typ výsledku	Popis
DataSourceInfo. DisplayName	String	Zobrazovaný název sloupce. Pokud není zobrazovaný název definovaný, vrátí se název sloupce.
DataSourceInfo. MaxLength	Počet	Maximální počet znaků, který sloupec může obsahovat. Platí jenom pro sloupce obsahující řetězce. Pokud není maximum nastavené, vrátí se prázdná hodnota.
DataSourceInfo. MaxValue	Počet	Maximální číselná hodnota, kterou sloupec může obsahovat. Platí jenom pro sloupce obsahující čísla. Pokud není maximum nastavené, vrátí se prázdná hodnota.
DataSourceInfo. MinValue	Počet	Minimální číselná hodnota, kterou sloupec může obsahovat. Platí jenom pro sloupce obsahující čísla. Pokud není minimum nastavené, vrátí se prázdná hodnota.
DataSourceInfo. Požadovaný	logický	Je hodnota v tomto sloupci povinná? Pokud není zdrojem dat nastaveno, vrátí se false.

Třetím argumentem je název sloupce ve formě řetězce. Například sloupec Phone v kolekci People by se předal jako "Phone" včetně dvojitých uvozovek.

Informace o zdroji dat

Můžete také použít DataSourceInfo k získání informací o zdroji dat jako celku:

Argument informací	Typ výsledku	Popis
DataSourceInfo. AllowedValues	logický	Jaké typy oprávnění můžou být uživatelům pro tento zdroj dat uděleny? Pokud není zdrojem dat nastaveno, vrátí se prázdná hodnota.
DataSourceInfo. CreatePermission	logický	Má aktuální uživatel oprávnění k vytváření záznamů v tomto zdroji dat? Pokud není zdrojem dat nastaveno, vrátí se true.
DataSourceInfo. DeletePermission	logický	Má aktuální uživatel oprávnění k odstranění záznamů v tomto zdroji dat? Pokud není zdrojem dat nastaveno, vrátí se true.
DataSourceInfo. EditPermission	logický	Má aktuální uživatel oprávnění k úpravě záznamů v tomto zdroji dat? Pokud není zdrojem dat nastaveno, vrátí se true.
DataSourceInfo. ReadPermission	logický	Má aktuální uživatel oprávnění ke čtení záznamů v tomto zdroji dat? Pokud není zdrojem dat nastaveno, vrátí se true.

Poznámka:

DataSourceInfo vrátí hodnotu true , pokud nemůže určit, zda má aktuální uživatel požadované oprávnění. Když bude provedena skutečná operace, server znovu zkontroluje oprávnění a pokud to nebylo povoleno, zobrazí se chyba. V tuto chvíli je kontrola oprávnění DataSourceInfo možná jenom v případě, že používáte Microsoft Dataverse.

Syntaxe

DataSourceInfo( Zdroj dat, informace [, columnName] )

• ZdrojDat – povinné. Zdroj dat, který se má použít.
• Informace – Povinné. Typ informací, které chcete získat.
• ColumnName – Volitelné. Název sloupce, pro který se mají načíst informace na úrovni sloupce. Pro informace na úrovni zdroje dat se argument NázevSloupce nedá použít.

Poznámka:

V Power Apps před verzí 3.24042 byly názvy sloupců zadány pomocí textového řetězce pomocí dvojitých uvozovek, a pokud byly připojeny ke zdroji dat, také musely mít logické názvy. Například místo zobrazovaného názvu Název bez uvozovek byl použit logický název "cr43e_name" s dvojitými uvozovkami. U zdrojů dat SharePoint a Excel, které obsahují názvy sloupců s mezerami, byla každá mezera specifikována pomocí "_x0020_", například "Název sloupce" jako "Název_x0020_sloupce". Po této verzi byly všechny aplikace automaticky aktualizovány na novou syntaxi popsanou v tomto článku.

Příklady

U příkladů v této části se používá zdroj dat s názvem IceCream:

Tento zdroj dat také poskytuje tyto informace:

• Zobrazovaný název sloupce Quantity je "Quantity on Hand".
• Maximální délka sloupce Flavor je 30 znaků.
• Sloupec Flavor musí obsahovat hodnotu. Sloupec Quantity není povinný.
• Minimální hodnota Quantity je 0.
• Maximální hodnota Quantity je 100.
• Aktuální uživatel může číst a upravovat záznamy zdroje dat IceCream, nemůže je ale vytvářet ani odstraňovat.

Vzorec	Popis	Výsledek
DataSourceInfo( IceCream, DataSourceInfo. DisplayName, Quantity )	Vrátí zobrazovaný název sloupce Quantity zdroje dat IceCream.	"Množství na ruce"
DataSourceInfo( IceCream, DataSourceInfo. MaxLength, Flavor )	Vrátí maximální délku řetězce pro sloupec Flavor zdroje dat IceCream.	30
DataSourceInfo( IceCream, DataSourceInfo. Povinné, Příchuť )	Je sloupec Flavor zdroje dat IceCream povinný?	věrný
DataSourceInfo( IceCream, DataSourceInfo. Povinné, Množství )	Je sloupec Quantity zdroje dat IceCream povinný?	falešný
DataSourceInfo( IceCream, DataSourceInfo. MaxValue, Quantity )	Vrátí maximální číselnou hodnotu pro sloupec Quantity zdroje dat IceCream.	100
DataSourceInfo( IceCream, DataSourceInfo. MinValue, Quantity )	Vrátí minimální číselnou hodnotu pro sloupec Quantity zdroje dat IceCream.	0
DataSourceInfo( IceCream, DataSourceInfo. ReadPermission)	Může aktuální uživatel číst záznamy ve zdroji dat IceCream?	věrný
DataSourceInfo( IceCream, DataSourceInfo. EditPermission)	Může aktuální uživatel upravovat záznamy ve zdroji dat IceCream?	věrný
DataSourceInfo( IceCream, DataSourceInfo. CreatePermission)	Může aktuální uživatel vytvářet záznamy ve zdroji dat IceCream?	falešný
DataSourceInfo( IceCream, DataSourceInfo. DeletePermission)	Může aktuální uživatel odstraňovat záznamy ve zdroji dat IceCream?	falešný