Funkcija »DataSourceInfo« v rešitvi Power Apps

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 v Microsoftovih seznamih.

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.

• Information – obvezno. Vrsta informacij, ki jih želite pridobiti.

• ColumnName – izbirno. Za informacije na ravni stolpca ime stolpca kot niz. Stolpec Phone bi bil prenesen kot "Phone", vključno z dvojnimi narekovaji. Za informacije na ravni vira podatkov ni mogoče uporabiti argumenta ColumnName.

  Opomba

  Za vire podatkov SharePoint in Excel, ki vsebujejo imena stolpcev s presledki, določite vsak presledek kot "_x0020_". Npr. določite »Column Name« kot »Column_x0020_Name«.

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?	false
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?	neresnično

Opomba

Ali nam lahko poveste, kateri je vaš prednostni jezik za dokumentacijo? Izpolnite kratko anketo. (upoštevajte, da je v angleščini)

Z anketo boste porabili približno sedem minut. Ne zbiramo nobenih osebnih podatkov (izjava o zasebnosti).