Funkcija »DataSourceInfo«

Velja za: Aplikacije Canvas Aplikacije, ki temeljijo na modelu

Zagotavlja informacije o viru podatkov.

Pregled

Viri podatkov lahko zagotovijo veliko informacij za optimizacijo uporabniške izkušnje.

Uporabite lahko informacije na ravni stolpca za preverjanje uporabniškega vnosa in zagotovitev takojšnjih povratnih informacij uporabniku, preden uporabite funkcijo Patch. Funkcija Validate uporabi te iste informacije.

Uporabite lahko informacije na ravni vira podatkov, da na primer onemogočite ali skrijete gumba Uredi in Novo za uporabnike, ki nimajo dovoljenj za urejanje in ustvarjanje zapisov.

Viri podatkov se razlikujejo v tem, koliko informacij zagotavljajo, vključno, da jih sploh ne zagotavljajo. Zbirke ne zagotavljajo informacij. Če določena informacija ni zagotovljena, se uporabi privzeta ali vrne prazno.

opomba,

Trenutno funkcija DataSourceInfo ni podprta na Seznamih Microsoft.

Description

Informacije o stolpcu

Uporabite lahko DataSourceInfo za pridobivanje informacij o določenem stolpcu vira podatkov:

Argument informacije	Vrsta rezultata	Opis
DataSourceInfo.DisplayName	Niz	Prikazno ime za stolpec. Če prikazno ime ni določeno, vrne ime stolpca.
DataSourceInfo.MaxLength	Število	Največje število znakov, ki jih lahko stolpec vsebuje. Velja samo za stolpce, ki vsebujejo nize. Če največje število ni nastavljeno, vrne prazno.
DataSourceInfo.MaxValue	Število	Največja številska vrednost, ki jo lahko stolpec vsebuje. Velja samo za stolpce, ki vsebujejo številke. Če največje število ni nastavljeno, vrne prazno.
DataSourceInfo.MinValue	Število	Najmanjša številska vrednost, ki jo lahko stolpec vsebuje. Velja samo za stolpce, ki vsebujejo številke. Če najmanjše število ni nastavljeno, vrne prazno.
DataSourceInfo.Required	Logični	Ali je vrednost obvezna za ta stolpec? Če tega ne nastavi vir podatkov, vrne false.

Tretji argument je ime stolpca kot niza. Na primer stolpec Phone v zbirki People bi bil prenesen kot "Phone" vključno z dvojnimi narekovaji.

Informacije o viru podatkov

DataSourceInfo lahko uporabite tudi za pridobivanje informacij o viru podatkov kot celoti:

Argument informacije	Vrsta rezultata	Opis
DataSourceInfo.AllowedValues	Logični	Kakšne vrste dovoljenj so lahko uporabnikom odobrene za ta vir podatkov? Če tega ne nastavi vir podatkov, vrne prazno.
DataSourceInfo.CreatePermission	Logični	Ali ima trenutni uporabnik dovoljenje za ustvarjanje zapisov v tem viru podatkov? Če tega ne nastavi vir podatkov, vrne true.
DataSourceInfo.DeletePermission	Logični	Ali ima trenutni uporabnik dovoljenje za brisanje zapisov v tem viru podatkov? Če tega ne nastavi vir podatkov, vrne true.
DataSourceInfo.EditPermission	Logični	Ali ima trenutni uporabnik dovoljenje za urejanje zapisov v tem viru podatkov? Če tega ne nastavi vir podatkov, vrne true.
DataSourceInfo.ReadPermission	Logični	Ali ima trenutni uporabnik dovoljenje za branje zapisov v tem viru podatkov? Če tega ne nastavi vir podatkov, vrne true.

opomba,

DataSourceInfo vrne true, če ne more določiti, ali ima trenutni uporabnik zahtevano dovoljenje. Dovoljenja bo strežnik znova preveril, ko bo izvedena dejanska operacija in se bo prikazala napaka, če ni bila dovoljena. Trenutno je preverjanje dovoljenj z DataSourceInfo možno le pri uporabi Microsoft Dataverse.

Sintaksa

DataSourceInfo( DataSource, Information [, ColumnName ] )

• DataSource – obvezno. Vir podatkov za uporabo.
• Informacije – obvezno. Vrsta informacij, ki jih želite pridobiti.
• ColumnName – izbirno. Ime stolpca, za katerega želite pridobiti informacije na ravni stolpca. Za informacije na ravni vira podatkov ni mogoče uporabiti argumenta ColumnName.

opomba,

V Power Apps pred različico 3.24042 so bila imena stolpcev podana z besedilnim nizom v dvojnih narekovajih, in če so bili povezani z vir podatkov, so morala biti tudi logična imena. Na primer, logično ime "cr43e_name" z dvojnimi narekovaji je bilo uporabljeno namesto prikazno ime Ime brez narekovajev. Za SharePoint in izvore podatkov Excel, ki vsebujejo imena stolpcev s presledki, je bil vsak presledek določen z "_x0020_", na primer "Ime stolpca" kot "Ime_stolpca_x0020". Po tej različici so bile vse aplikacije samodejno posodobljene na novo sintakso, opisano v tem članku.

Primeri

Primeri v tem razdelku uporabljajo ta vir podatkov z imenom IceCream:

Vir podatkov je zagotovil tudi te informacije:

• Prikazno ime za Quantity je »Količina na zalogi«.
• Najdaljša dovoljena dolžina za Flavor je 30 znakov.
• Stolpec Flavor mora vsebovati vrednost. Stolpec Quantity ni obvezen.
• Najmanjša vrednost za Quantity je 0.
• Največja vrednost za Quantity je 100.
• Trenutni uporabnik lahko bere in ureja zapise za vir podatkov IceCream, ne more pa zapisov ustvariti ali brisati.

Formula	Opis	Rezultat
DataSourceInfo( IceCream, DataSourceInfo.DisplayName, Quantity)	Vrne prikazno ime za stolpec Quantity vira podatkov IceCream.	»Količina na zalogi«
DataSourceInfo( IceCream, DataSourceInfo.MaxLength, Flavor)	Vrne največjo dolžino niza za stolpec Flavor vira podatkov IceCream.	30
DataSourceInfo( IceCream, DataSourceInfo.Required, Flavor)	Ali je stolpec Flavor vira podatkov IceCream obvezen?	true
DataSourceInfo( IceCream, DataSourceInfo.Required, Quantity)	Ali je stolpec Quantity vira podatkov IceCream obvezen?	neresnično
DataSourceInfo( IceCream, DataSourceInfo.MaxValue, Quantity)	Vrne največjo številsko vrednost za stolpec Quantity vira podatkov IceCream.	100
DataSourceInfo( IceCream, DataSourceInfo.MinValue, Quantity)	Vrne najmanjšo številsko vrednost za stolpec Quantity vira podatkov IceCream.	0
DataSourceInfo( IceCream, DataSourceInfo.ReadPermission)	Ali lahko trenutni uporabnik bere zapise v viru podatkov IceCream?	true
DataSourceInfo( IceCream, DataSourceInfo.EditPermission)	Ali lahko trenutni uporabnik ureja zapise v viru podatkov IceCream?	true
DataSourceInfo( IceCream, DataSourceInfo.CreatePermission)	Ali lahko trenutni uporabnik ustvarja zapise v viru podatkov IceCream?	false
DataSourceInfo( IceCream, DataSourceInfo.DeletePermission)	Ali lahko trenutni uporabnik briše zapise v viru podatkov IceCream?	false