Funkce DataSourceInfo

  • Článek

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

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( DataSource; Informace [, ColumnName] )

  • ZdrojDat – povinné. Zdroj dat, který se má použít.
  • Informace – povinné. Typ informací, které chcete získat.
  • NázevSloupce – povinné. 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:

Příklad 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ý? nepravda
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? false