Funkcija DataSourceInfo
Primjenjuje se na sljedeće: Aplikacije radnog područja 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 funkcija DataSourceInfo nije podržana na Microsoft popisima.
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 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( Izvor podataka,Informacije [ , ColumnName] )
- Izvor podataka– obavezno. Korišteni izvor podataka.
- Informacije – Obavezno. Vrsta informacija koje želite dohvatiti.
- ColumnName – Nije obavezno. 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
U Power Apps prije verzije 3.24042, nazivi stupaca bili su specificirani tekstualnim nizom koristeći dvostruke navodnike, a ako su povezani s izvor podataka također su morali biti logički nazivi. Na primjer, umjesto zaslonsko ime Ime bez navodnika korišteno je logičko ime "cr43e_name" s dvostrukim navodnicima. Za SharePoint i Excel izvore podataka koji sadrže nazive stupaca s razmacima, svaki je razmak naveden s "_x0020_", na primjer "Naziv stupca" kao "Column_x0020_Name". Nakon ove verzije 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( sladoled, DataSourceInfo.MaxLength, okus) | Vraća maksimalnu dužinu niza za stupac Flavor izvora podataka IceCream. | 30 |
DataSourceInfo( sladoled, DataSourceInfo.Required, okus) | Je li stupac Flavor izvora podataka IceCream potreban? | istinit |
DataSourceInfo( sladoled, DataSourceInfo.Required, količina ) | Je li stupac Quantity izvora podataka IceCream potreban? | lažan |
DataSourceInfo( sladoled, DataSourceInfo.MaxValue, količina ) | Vraća maksimalnu brojčanu vrijednost za stupac Quantity izvora podataka IceCream. | 100 |
DataSourceInfo( Sladoled, DataSourceInfo.MinValue, količina) | Vraća minimalnu brojčanu vrijednost za stupac Quantity izvora podataka IceCream. | 0 |
DataSourceInfo( Sladoled, DataSourceInfo.ReadPermission) | Može li trenutačni korisnik čitati zapise u izvoru podataka IceCream? | istinit |
DataSourceInfo( Sladoled, DataSourceInfo.EditPermission) | Može li trenutačni korisnik uređivati zapise u izvoru podataka IceCream? | istinit |
DataSourceInfo( Sladoled, DataSourceInfo.CreatePermission) | Može li trenutačni korisnik stvarati zapise u izvoru podataka IceCream? | lažan |
DataSourceInfo( sladoled, DataSourceInfo.DeletePermission) | Može li trenutačni korisnik brisati zapise u izvoru podataka IceCream? | lažan |