DataSourceInfo funktsioon
Kehtib:
lõuendirakendused Mudelipõhised rakendused
Pakub teavet andmeallika kohta.
Ülevaade
Andmeallikad võivad pakkuda rikkalikku teavet kasutuskogemuse optimeerimiseks.
Saate kasutada veeru tasemel teavet, et kinnitada kasutaja sisestust ja anda kasutajale kohe tagasisidet enne funktsiooni Patch kasutamist. Funktsioon Validate kasutab seda sama teavet.
Teavet saate kasutada näiteks andmeallika tasemel, et keelata või peita nupud Redigeeri ja Uus kasutajatele, kellel pole õigust kirjeid redigeerida ja luua.
Andmeallikad varieeruvad selles, kui palju teavet nad pakuvad või ei sisalda seda üldse. Kollektsioonid ei sisalda teavet. Kui teavet ei esitata, siis vaikimisi kasutatakse või tagastatakse tühi.
Märkus.
Praegu ei toetata funktsiooni DataSourceInfo Microsofti loendites.
Kirjeldus
Veeruteave
Saate kasutada DataSourceInfo, et hankida teavet mõne kindla veeru andmeallika kohta:
| Teabe argument | Tulemuse tüüp | Kirjeldus |
|---|---|---|
| DataSourceInfo.DisplayName | String | Veeru kuvatav nimi. Kui kuvatavat nime pole määratletud, tagastab veeru nime. |
| DataSourceInfo.MaxLength | Number | Suurim lubatud arv märke, mida veerg mahutab. Rakendub ainult stringe sisaldavatele veergudele. Kui maksimumi pole määratud, tagastab tühi. |
| DataSourceInfo.MaxValue | Number | Suurim arvuline väärtus, mida veerg mahutab. Rakendub ainult numbreid sisaldavatele veergudele. Kui maksimumi pole määratud, tagastab tühi. |
| DataSourceInfo.MinValue | Number | Vähim arvuline väärtus, mida veerg mahutab. Rakendub ainult numbreid sisaldavatele veergudele. Kui miimimumi pole määratud, tagastab tühi. |
| DataSourceInfo.Required | Loogika | Kas väärtus on selle veeru jaoks nõutav? Kui andmeallika poolt pole määratud, tagastab funktsiooni väär. |
Kolmas argument on veeru nimi stringina. Näiteks, veerg Telefon kogumikus Inimesed edastatakse kui "Telefon", koos jutumärkidega.
Andmeallika teave
Saate kasutada ka DataSourceInfo, et hankida teavet kogu andmeallika kohta:
| Teabe argument | Tulemuse tüüp | Kirjeldus |
|---|---|---|
| DataSourceInfo.AllowedValues | Loogika | Millist tüüpi õigusi saab selle andmeallika jaoks kasutajatele anda? Kui andmeallika poolt pole määratud, tagastab funktsiooni tühi. |
| DataSourceInfo.CreatePermission | Loogika | Kas praegusel kasutajal on õigus selles andmeallikas kirjeid luua? Kui andmeallika poolt pole määratud, tagastab väärtuse õige. |
| DataSourceInfo.DeletePermission | Loogika | Kas praegusel kasutajal on õigus selles andmeallikas kirjeid kustutada? Kui andmeallika poolt pole määratud, tagastab väärtuse õige. |
| DataSourceInfo.EditPermission | Loogika | Kas praegusel kasutajal on õigus selles andmeallikas kirjeid redigeerida? Kui andmeallika poolt pole määratud, tagastab väärtuse õige. |
| DataSourceInfo.ReadPermission | Loogika | Kas praegusel kasutajal on õigus selles andmeallikas kirjeid lugeda? Kui andmeallika poolt pole määratud, tagastab väärtuse õige. |
Märkus.
DataSourceInfo tagastab tõese kui ta ei saa määratleda, kas praegusel kasutajal on taotletud õigus. Server kontrollib õigusi tegeliku toimingu sooritamisel uuesti ja kui see ei olnud lubatud, kuvatakse tõrge. Praegu on DataSourceInfo kontrollimise õigused saadaval ainult siis, kui kasutate Microsoft Dataverse-i.
Süntaks
DataSourceInfo(DataSource,Information [, ColumnName ] )
- DataSource – Nõutav. Andmeallikas kasutamiseks
- Teave – nõutav. Teabe tüüp, mida soovite tuua.
- ColumnName – valikuline. Veeru nimi, mille jaoks veerutasemel teavet tuua. Andmeallika tasemel teabe saamiseks ei saa kasutada ColumnName argumenti.
Märkus.
Enne Power Apps versiooni 3.24042 määrati veergude nimed tekstistringiga topeltjutumärkide abil ja kui need olid ühendatud andmeallikas-ga, pidid need olema ka loogilised nimed. Näiteks kasutati kuvatava nime asemel loogilist nime "cr43e_name" topeltjutumärkidega Nimi ilma jutumärkideta. Tühikutega veerunimesid sisaldavate ja Exceli andmeallikate puhul SharePoint määrati igale tühikule "_x0020_" , näiteks "Veeru nimi" kui"Column_x0020_Name" . Selle versiooni järel värskendati kõik rakendused automaatselt selles artiklis kirjeldatud uuele süntaksile.
Näited
Selles jaotises toodud näited kasutavad seda andmeallikat nimega IceCream.
Andmeallikas on esitanud ka selle teabe:.
- Koguse kuvatav nimi on "Kogus laos".
- Maitse maksimumpikkus on 30 tähemärki.
- Maitse veerg peab sisaldama väärtust. Veerg Kogus pole nõutav.
- Minimaalne Kogus on 0.
- Maksimaalne Kogus on 100.
- Praegune kasutaja saab andmeallika IceCream kirjeid lugeda ja redigeerida, kuid ei saa kirjeid luua ega kustutada.
| Valem | Kirjeldus | Tulem |
|---|---|---|
| DataSourceInfo( IceCream, DataSourceInfo.DisplayName, Kogus ) | Tagastab veeru Kogus kuvatava nime andmeallikas andmeallikas IceCream. | Kogus laos |
| DataSourceInfo( IceCream, DataSourceInfo.MaxLength, Flavor ) | Tagastab vastuseks andmeallika veeru Maitse stringi maksimumpikkuse andmeallikas IceCream. | 30 |
| DataSourceInfo( IceCream, DataSourceInfo.Required, Flavor ) | Kas veerg Maitse andmeallikas IceCream on nõutav? | õige |
| DataSourceInfo( IceCream, DataSourceInfo.Required, kogus ) | Kas veerg Kogus andmeallikas IceCream on nõutav? | false |
| DataSourceInfo( IceCream, DataSourceInfo.MaxValue, Kogus ) | Tagastab veeru Kogus maximaalse numbrilise väärtuse andmeallikas IceCream. | 100 |
| DataSourceInfo( IceCream, DataSourceInfo.MinValue, kogus ) | Tagastab veeru Kogus minimaalse numbrilise väärtuse andmeallikas andmeallikas IceCream. | 0 |
| DataSourceInfo( IceCream, DataSourceInfo.ReadPermission) | Kas praegune kasutaja saab andmeallikas IceCream lugeda kirjeid? | õige |
| DataSourceInfo( IceCream, DataSourceInfo.EditPermission) | Kas praegune kasutaja saab andmeallikas IceCream redigeerida kirjeid? | tõde |
| DataSourceInfo( IceCream, DataSourceInfo.CreatePermission) | Kas praegune kasutaja saab andmeallikas IceCream luua kirjeid? | väär |
| DataSourceInfo( IceCream, DataSourceInfo.DeletePermission) | Kas praegune kasutaja saab andmeallikas IceCream kustutada kirjeid? | väär |