Funkce DataSourceInfo v Power Apps

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é. Kolekce 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

Aktuálně není funkce DataSourceInfo v aplikaci Seznamy Microsoft podporována.

Popis

Informace o sloupci

Funkce DataSourceInfo umožňuje získat informace 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.Required	Logická hodnota	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

Funkce DataSourceInfo umožňuje získat také informace o zdroji dat jako celku:

Argument informací	Typ výsledku	Popis
DataSourceInfo.AllowedValues	Logická hodnota	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á hodnota	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á hodnota	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á hodnota	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á hodnota	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 vrací 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. Aktuálně je kontrola oprávnění s DataSourceInfo možná pouze při použití Microsoft Dataverse.

Syntaxe

DataSourceInfo( ZdrojDat; Informace; NázevSloupce )

• ZdrojDat – povinné. Zdroj dat, který se má použít.

• Informace – povinné. Typ informací, které chcete získat.

• NázevSloupce – povinné. Pro informace na úrovni sloupce má název sloupce formu řetězce. Sloupec Phone by se předal jako "Phone" včetně dvojitých uvozovek. Pro informace na úrovni zdroje dat se argument NázevSloupce nedá použít.

  Poznámka

  V případě zdrojů dat SharePoint a Excel obsahujících názvy sloupců s mezerami zadejte každou mezeru jako „_x0020_“. Místo Název sloupce tedy zadejte Název_x0020_sloupce.

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.	"Quantity on Hand"
DataSourceInfo( IceCream; DataSourceInfo.MaxLength; "Flavor" )	Vrátí maximální délku řetězce pro sloupec Flavor zdroje dat IceCream.	30
DataSourceInfo( IceCream; DataSourceInfo.Required; "Flavor" )	Je sloupec Flavor zdroje dat IceCream povinný?	true
DataSourceInfo( IceCream; DataSourceInfo.Required; "Quantity" )	Je sloupec Quantity zdroje dat IceCream povinný?	false
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?	true
DataSourceInfo( IceCream; DataSourceInfo.EditPermission)	Může aktuální uživatel upravovat záznamy ve zdroji dat IceCream?	true
DataSourceInfo( IceCream; DataSourceInfo.CreatePermission)	Může aktuální uživatel vytvářet záznamy ve zdroji dat IceCream?	false
DataSourceInfo( IceCream; DataSourceInfo.DeletePermission)	Může aktuální uživatel odstraňovat záznamy ve zdroji dat IceCream?	nepravda

Poznámka

Můžete nám sdělit, jaké máte jazykové preference pro dokumentaci? Zúčastněte se krátkého průzkumu. (upozorňujeme, že tento průzkum je v angličtině)

Průzkum bude trvat asi sedm minut. Nejsou shromažďovány žádné osobní údaje (prohlášení o zásadách ochrany osobních údajů).