Funkcija DataSourceInfo
Odnosi se na:
Aplikacije od gotovih gradivnih elemenata Aplikacije stvorene prema modelu
Pruža informacije o nekom izvoru podataka.
Pretpregled
Izvori podataka mogu pružiti obilje informacija za optimizaciju korisničkog iskustva.
Možete koristiti informacije na razini stupca kako biste provjerili korisnički unosa i pružili neposredne povratne informacije korisniku prije upotrebe funkcije Patch. Funkcija Validate koristi iste te informacije.
Informacije na razini izvora podataka možete koristiti, na primjer, da biste onemogućili ili sakrili gumbe Uredi i Novo za korisnike koji nemaju dozvole za uređivanje i stvaranje zapisa.
Izvori podataka razlikuju se u tome koliko informacija pružaju, a mogu uopće ne pružati ništa. Zbirke ne pružaju nikakve informacije. Ako informacije nema, koristi se zadana postavka ili se vraća vrijednost prazno.
Napomena
Trenutačno, funkciju DataSourceInfo ne podržava popis sustava Microsoft.
Opis
Podaci o stupcu
Možete koristiti funkciju DataSourceInfo da biste dobili informacije o određenom stupcu nekog izvora podataka:
| Argument Information | Vrsta rezultata | Opis |
|---|---|---|
| DataSourceInfo.DisplayName | Niz | Zaslonsko ime za taj stupac. Ako zaslonsko ime nije definirano, vraća naziv stupca. |
| DataSourceInfo.MaxLength | Broj | Maksimalan broj znakova koje stupac može sadržavati. Važi samo za stupce koji sadrže nizove. Ako maksimum nije postavljen, vraća vrijednost prazno. |
| DataSourceInfo.MaxValue | Broj | Maksimalna brojčana vrijednost koju stupac može sadržavati. Važi samo za stupce koji sadrže brojeve. Ako maksimum nije postavljen, vraća vrijednost prazno. |
| DataSourceInfo.MinValue | Broj | Minimalna brojčana vrijednost koju stupac može sadržavati. Važi samo za stupce koji sadrže brojeve. Ako minimum nije postavljen, vraća vrijednost prazno. |
| DataSourceInfo.Required | Booleov | Je li neka vrijednost potrebna za ovaj stupac? Ako to nije postavio izvor podataka, vraća vrijednost false. |
Treći argument je naziv stupca kao niza. Na primjer, stupac Phone u zbirci People bio bi proslijeđen kao "Phone" zajedno s navodnicima.
Informacije izvora podataka
Možete koristiti i funkciju DataSourceInfo da biste dobili informacije o izvora podataka u cjelini:
| Argument Information | Vrsta rezultata | Opis |
|---|---|---|
| DataSourceInfo.AllowedValues | Booleov | Koje se vrste dozvola mogu dodijeliti korisnicima za ovaj izvor podataka? Ako je ne postavlja izvor podataka, vraća vrijednost prazno. |
| DataSourceInfo.CreatePermission | Booleov | Ima li trenutačni korisnik dozvolu za stvaranje zapisa u ovom izvoru podataka? Ako to nije postavio izvor podataka, vraća vrijednost true. |
| DataSourceInfo.DeletePermission | Booleov | Ima li trenutačni korisnik dozvolu za brisanje zapisa u ovom izvoru podataka? Ako to nije postavio izvor podataka, vraća vrijednost true. |
| DataSourceInfo.EditPermission | Booleov | Ima li trenutačni korisnik dozvolu za uređivanje zapisa u ovom izvoru podataka? Ako to nije postavio izvor podataka, vraća vrijednost true. |
| DataSourceInfo.ReadPermission | Booleov | Ima li trenutačni korisnik dozvolu za čitanje zapisa u ovom izvoru podataka? Ako to nije postavio izvor podataka, vraća vrijednost true. |
Napomena
DataSourceInfo vraća vrijednost true ako ne može utvrditi ima li trenutni korisnik traženu dozvolu. Dozvole će poslužitelj ponovno provjeriti kada se izvrši stvarna operacija i prikaže pogreška ako to nije dopušteno. U ovom trenutku, provjera dozvola uz DataSourceInfo moguća je samo pri upotrebi platforme Microsoft Dataverse.
Sintaksa
DataSourceInfo(DataSource,Information [, ColumnName ] )
- DataSource – obavezno. Korišteni izvor podataka.
- Information – obavezno. Vrsta informacija koje želite dohvatiti.
- ColumnName – neobavezno. Naziv stupca za koji se dohvaćaju informacije na razini stupca. Za informacije na razini izvora podataka, argument ColumnName ne može se upotrijebiti.
Napomena
Prije Power Apps verzije 3.24042 nazivi stupaca navedeni su tekstnim nizom pomoću dvostrukih navodnika, a ako su povezani s izvor podataka također su trebali biti logički nazivi. Na primjer, umjesto zaslonsko ime Ime bez navodnika korišten je logički naziv "cr43e_name" s dvostrukim navodnicima. Za SharePoint i Excelove izvore podataka koji sadrže nazive stupaca s razmacima, svaki je razmak određen sa" _x0020_", na primjer "Naziv stupca" kao "Column_x0020_Name". Afer ovu verziju, sve su aplikacije automatski ažurirane na novu sintaksu opisanu u ovom članku.
Primjeri
Primjeri u ovom odjeljku koriste ovaj izvor podataka, nazvan IceCream:
Izvor podataka je pružio i ove informacije:
- Zaslonsko ime za stupac Quantity je „Quantity on Hand”.
- Maksimalna dužina stupca Flavor je 30 znakova.
- Stupac Flavor mora sadržavati neku vrijednost. Stupac Quantity nije potreban.
- Minimalna vrijednost stupca Quantity je 0.
- Maksimalna vrijednost stupca Quantity je 100.
- Trenutačni korisnik može čitati i uređivati zapise izvor podataka IceCream, ali ne može stvarati ili brisati zapise.
| Formula | Opis | Rezultat |
|---|---|---|
| DataSourceInfo( Sladoled, DataSourceInfo.DisplayName, Količina ) | Vraća zaslonsko ime za stupac Quantity izvora podataka IceCream. | „Quantity on Hand” |
| DataSourceInfo( IceCream, DataSourceInfo.MaxLength, Flavor ) | Vraća maksimalnu dužinu niza za stupac Flavor izvora podataka IceCream. | 30 |
| DataSourceInfo( IceCream, DataSourceInfo.Required, Flavor ) | Je li stupac Flavor izvora podataka IceCream potreban? | true |
| DataSourceInfo( Sladoled, DataSourceInfo.Required, Količina ) | Je li stupac Quantity izvora podataka IceCream potreban? | pogrešno |
| DataSourceInfo( Sladoled, DataSourceInfo.MaxValue, Količina ) | Vraća maksimalnu brojčanu vrijednost za stupac Quantity izvora podataka IceCream. | 100 |
| DataSourceInfo( IceCream, DataSourceInfo.MinValue, Količina ) | Vraća minimalnu brojčanu vrijednost za stupac Quantity izvora podataka IceCream. | 0 |
| DataSourceInfo( IceCream, DataSourceInfo.ReadPermission) | Može li trenutačni korisnik čitati zapise u izvoru podataka IceCream? | true |
| DataSourceInfo( IceCream, DataSourceInfo.EditPermission) | Može li trenutačni korisnik uređivati zapise u izvoru podataka IceCream? | true |
| DataSourceInfo( IceCream, DataSourceInfo.CreatePermission) | Može li trenutačni korisnik stvarati zapise u izvoru podataka IceCream? | false |
| DataSourceInfo( IceCream, DataSourceInfo.DeletePermission) | Može li trenutačni korisnik brisati zapise u izvoru podataka IceCream? | false |