Kontrole obrasca za prikaz i obrasca za uređivanje u usluzi Power Apps
Prikažite, uređujte i kreirajte zapis u izvoru podataka.
Opis
Ako dodate kontrolu obrazac za prikaz, korisnik može da prikazuje sva polja zapisa ili samo polja koja ste vi odredili. Ako dodate kontrolu obrazac za uređivanje, korisnik može da uređuje ta polja, kreira zapis i sačuva te promene u izvoru podataka.
Ako dodate kontrolu Gallery, možete da je konfigurišete za prikazivanje tabele u izvoru podataka, a zatim konfigurišete obrazac da prikazuje onaj zapis koji korisnik odabere u galeriji. Takođe možete da dodate jednu ili više kontrola Button da korisnik može da izabere da sačuva izmene, otkaže izmene i kreira zapis. Ako te kontrole koristite zajedno, možete kreirati kompletno rešenje.
Ograničenja
Kontrola obrasca ima sledeća ograničenja:
- Obrasce ne možete da kopirate i nalepite na kartice sa podacima. Ovo je da bi se sprečilo da se kreiraju određene kombinacije kontrola koje rizikuju stabilnost i performanse aplikacije.
Izbor zapisa
Za bilo koji tip obrasca, postavite njegovo svojstvo DataSource na tabelu zapisa i podesite svojstvo obrasca Item da prikazuje određeni zapis u toj tabeli. Na primer, možete da postavite svojstvo obrasca Item na svojstvo SelectedItem kontrole Gallery. Kada korisnik izabere zapis u galeriji, isti zapis se pojavljuje u obrascu, osim što obrazac može prikazati više polja. Ako se korisnik vrati u galeriju i izabere drugačiji zapis, svojstvo galerije SelectedItem se menja. Ova promena ažurira svojstvo obrasca Item, koje zatim prikazuje novoizabrani zapis.
Takođe možete da postavite svojstvo obrasca Item pomoću kontrole padajuće liste, kao što je opisano u članku Prikazivanje, uređivanje ili dodavanje zapisa, ili funkciju poput Lookup ili First. Na primer, možete da podesite svojstvo Item bilo koje od ovih formula da prikazuje stavku Fabrikam u tabeli Poslovni kontakti na platformi Microsoft Dataverse:
First(Accounts)
Lookup(Accounts, "Fabrikam" in name)
Svaka kontrola obrasca sadrži jednu ili više kontrola Card. Postavljanjem svojstva kartice DataField, vi određujete koje polje ta kartica prikazuje i ostale detalje.
Kreiranje zapisa
Kada je kontrola Obrazac za uređivanje u režimu uređivanja, korisnik može ažurirati zapis koji je naveden u svojstvu obrasca Item. Ako se pregleda, svojstvo Mode vraća Edit.
Kada je kontrola obrazac za uređivanje u režimu Novo, međutim, svojstvo Item se ignoriše. Obrazac ne pokazuje postojeći zapis; umesto toga, vrednosti u svakom polju odgovaraju podrazumevanim vrednostima izvora podataka sa kojima ste konfigurisali obrazac. Funkcija NewForm uzrokuje da se obrazac prebaci u ovaj režim.
Na primer, možete da postavite svojstvo dugmeta Text da prikazuje Novo i njegovo svojstvo OnSelect na formulu koja uključuje funkciju NewForm. Ako korisnik izabere to dugme, obrazac se prebacuje na režim Novo, tako da korisnik može kreirati zapis počevši od poznatih vrednosti.
Obrazac se vraća na režim uređivanje ako je funkcija ResetForm ili SubmitForm uspešno pokrenuta.
- Možete da postavite svojstvo dugmeta Tekst da prikazuje Otkaži i njegovo svojstvo OnSelect na formulu koja uključuje funkciju ResetForm. Ako korisnik izabere to dugme, sve promene u toku će se odbaciti, a vrednosti u obrascu se još jednom podudaraju sa podrazumevanim vrednostima izvora podataka.
- Možete da postavite svojstvo dugmeta Tekst da prikazuje Sačuvaj promene i njegovo svojstvo OnSelect na formulu koja uključuje funkciju SubmitForm. Ako korisnik izabere to dugme i izvor podataka se ažurira, vrednosti u obrascu će se resetovati na podrazumevane vrednosti izvora podataka.
Sačuvaj promene
Ako kreirate dugme Sačuvaj promene dugme kao što je opisano u prethodnom odeljku, korisnik može da kreira ili ažurira zapis, a zatim izabere to dugme da bi te izmene sačuvao u izvoru podataka. Umesto toga, možete da konfigurišete kontrolu Image ili neku drugu kontrolu za obavljanje istog zadatka, sve dok je konfigurišete sa funkcijom SubmitForm. U svakom slučaju, funkcije Error, ErrorKind, OnSuccess i OnFailure pružaju povratne informacije o ishodu.
Kada se pokrene funkcija SubmitForm, ona prvo potvrđuje valjanost podataka koje korisnik želi da prosledi. Ako obavezno polje ne sadrži neku vrednost ili neka druga vrednost ne odgovara nekom drugom ograničenju, podešavaju se svojstva ErrorKind i pokreće se formula OnFailure. Možete da konfigurišete dugme Sačuvaj promene ili druge kontrole tako da ih korisnik može odabrati samo ako su podaci važeći (tj. ako svojstvo obrasca Valid ima vrednost tačno). Imajte na umu da korisnik mora ne samo da popravi problem, već i da ponovo izabere dugme Sačuvaj promene (ili da odbaci izmene odabirom dugmeta Otkaži, kao što je opisano ranije) da bi poništio svojstva Error i ErrorKind.
Ako podaci prođu validaciju, funkcija SubmitForm ih šalje u izvor podataka, što može potrajati neko vreme u zavisnosti od kašnjenja mreže.
- Ako slanje uspe, svojstvo Error se briše, svojstvo ErrorKind se postavlja na ErrorKind.None i pokreće se formula OnSuccess. Ako je korisnik kreirao zapis (tj. ako je obrazac prethodno bio u režimu Novo), obrazac se prebacuje u režim uređivanja, tako da korisnik može uređivati novokreirani zapis ili neki drugi.
- Ako slanje ne uspe, svojstvo Error sadrži korisniku prilagođenu poruku o grešci iz izvora podataka, objašnjavajući problem. Svojstvo ErrorKind se postavlja na odgovarajući način, u zavisnosti od problema i pokreće se formula OnFailure.
Neki izvori podataka mogu otkriti kada dve osobe pokušavaju istovremeno da ažuriraju isti zapis. U tom slučaju, ErrorKind se postavlja na ErrorKind.Conflict, a rešenje je da se osveži izvor podataka promenama drugog korisnika i da se ponovo primene promene koje je izvršio ovaj korisnik.
Savet
Ako ponudite dugme Otkaži na obrascu tako da korisnik može da napusti promene u toku, dodajte funkciju ResetForm svojstvu OnSelect čak i to svojstvo takođe sadrži funkciju Navigate za promenu ekrana. U suprotnom, obrazac će zadržati promene korisnika.
Raspored
Kartice se podrazumevano smeštaju u jednu kolonu za aplikacije za telefone i tri kolone za aplikacije za tablete. Možete da odredite koliko kolona obrazac ima i da li bi kartice trebalo da se dodaju na njih dok konfigurišete obrazac. Ta podešavanja nisu izložena kao svojstva jer se koriste samo za podešavanje svojstava kartica X, Y i Width.
Za više informacija, pogledajte Objašnjenje rasporeda obrasca podataka.
Ključna svojstva
DataSource – Izvor podataka koji sadrži zapis koji će korisnik prikazivati, uređivati ili kreirati.
- Ako ne podesite ovo svojstvo, korisnik ne može prikazivati, uređivati ili kreirati zapis, a dodatni metapodaci ili potvrda valjanosti nisu obezbeđeni.
DefaultMode – Početni režim kontrole obrasca. Pogledajte opis svojstva Mode u nastavku za prihvatljive vrednosti i njihovo značenje.
DisplayMode – Način koji se koristi za kartice podataka i kontrole u okviru kontrole obrasca.
Izvedeno iz osnovnog svojstva Mode i ne može se postaviti nezavisno:
| Režim | DisplayMode | Opis |
|---|---|---|
| FormMode.Edit | DisplayMode.Edit | Kartice podataka i kontrole se mogu uređivati, spremne da prihvate promene u zapisu. |
| FormMode.New | DisplayMode.Edit | Kartice podataka i kontrole se mogu uređivati, spremne da prihvate novi zapis. |
| FormMode.View | DisplayMode.View | Kartice podataka i kontrole se ne mogu uređivati ili optimizovati za gledanje. |
Error – Poruka o grešci prilagođena korisniku koja će se prikazati za ovaj obrazac kada funkcija SubmitForm ne uspe.
- Ovo svojstvo se odnosi samo na kontrolu obrazac za uređivanje.
- Ovo svojstvo se menja samo kada se pokrene funkcija SubmitForm, EditForm ili ResetForm.
- Ako se ne dogodi greška, ovo svojstvo je prazno i ErrorKind se postavlja na ErrorKind.None.
- Kada je moguće, poruka o grešci koja se vraća biće na jeziku korisnika. Neke poruke o grešci dolaze direktno iz izvora podataka i možda nisu na jeziku korisnika.
ErrorKind – Ako do greške dolazi kada je pokrenuta funkcija SubmitForm, vrsta greške do koje dolazi.
- Odnosi se samo na kontrolu obrazac za uređivanje.
- Ovo svojstvo ima isto nabrajanje kao i funkcija Errors. Kontrola obrazac za uređivanje može da vrati ove vrednosti:
| ErrorKind | Opis |
|---|---|
| ErrorKind.Conflict | Drugi korisnik je promenio isti zapis, što je dovelo do neusaglašenosti pri promeni. Izvršite funkciju Refresh da biste ponovo učitali zapis, pa ponovo pokušajte da obavite promenu. |
| ErrorKind.None | Greška je nepoznate vrste. |
| ErrorKind.Sync | Izvor podataka je prijavio grešku. Proverite svojstvo Error svojstvo za više informacija. |
| ErrorKind.Validation | Otkriven je opšti problem validacije. |
Item – Zapis u kontroli DataSource koji će korisnik prikazivati ili uređivati.
LastSubmit – Poslednji uspešno prosleđen zapis, uključujući sva polja generisana na serveru.
- Ovo svojstvo se odnosi samo na kontrolu obrazac za uređivanje.
- Ako izvor podataka automatski generiše ili izračuna bilo koja polja, poput polja ID sa jedinstvenim brojem, svojstvo LastSubmit će dobiti ovu novu vrednost kada se formula SubmitForm uspešno obavi.
- Vrednost ovog svojstva je dostupna u formuli OnSuccess.
Mode – Kontrola je uključena u režimu uređivanje ili novo.
| Režim | Opis |
|---|---|
| FormMode.Edit | Korisnik može da uređuje zapis koristeći obrazac. Vrednosti na karticama obrasca unapred su popunjene postojećim zapisom, kako bi ih korisnik promenio. Ako funkcija SubmitForm uspešno funkcioniše, postojeći zapis se menja. |
| FormMode.New | Korisnik može da kreira zapis koristeći obrazac. Vrednosti na kontrolama obrasca unapred su popunjene podrazumevanim vrednostima zapisa iz izvora podataka. Ako funkcija SubmitForm uspešno funkcioniše, zapis se kreira. |
| FormMode.View | Korisnik može da prikaže zapis koristeći obrazac. Vrednosti na kontrolama obrasca unapred su popunjene podrazumevanim vrednostima zapisa iz izvora podataka. |
Obrazac se prebacuje iz režima novo u režim uređivanje kada se dođe do bilo koje od ovih promena:
- Obrazac se uspešno prosleđuje i kreira se zapis. Ako je galerija postavljena da automatski premešta izbor na ovaj novi zapis, obrazac će biti u režimu uređivanje za kreirani zapis, tako da korisnik može da izvrši dodatne promene.
- Pokreće se funkcija EditForm.
- Pokreće se funkcija ResetForm. Na primer, korisnik može da izabere dugme Otkaži koje je konfigurisano ovom funkcijom.
OnFailure – Radnje koje treba preduzeti kada operacija sa podacima ne uspe.
- Ovo svojstvo se odnosi samo na kontrolu obrazac za uređivanje.
OnReset - Radnje koje treba preduzeti kada se kontrola Izmenite obrazac resetuje.
- Ovo svojstvo se odnosi samo na kontrolu obrazac za uređivanje.
OnSuccess – Radnje koje treba preduzeti kada operacija sa podacima uspe.
- Ovo svojstvo se odnosi samo na kontrolu obrazac za uređivanje.
Unsaved – Tačno ako kontrola obrazac za uređivanje sadrži korisničke promene koje nisu sačuvane.
- Ovo svojstvo se odnosi samo na kontrolu obrazac za uređivanje.
- Ovim svojstvom upozorite korisnika pre gubitka nesačuvanih promena. Da biste sprečili da korisnik izabere drugi zapis u kontroli Gallery pre nego što sačuvate promene u trenutni zapis, podesite svojstvo galerije Disabled na Form.Unsaved i, isto tako, onemogućite operacije osvežavanja.
Updates – Vrednosti koje se upisuju u izvor podataka za zapis učitan u kontrolu obrasca.
- Ovo svojstvo se odnosi samo na kontrolu obrazac za uređivanje.
- Ovim svojstvom izvucite vrednosti polja sa kartica unutar kontrole. Zatim možete da koristite ove vrednosti za ručno ažuriranje izvora podataka pozivom funkcije Patch ili na neki drugi način koji veza omogućuje. Ne morate da koristite ovo svojstvo ako koristite funkciju SubmitForm.
- Ovo svojstvo vraća zapis vrednosti. Na primer, ako kontrola obrasca sadrži kontrole kartica za polja Ime i Količina i vrednosti svojstva Update za te kartice vraćaju "Widget" i 10, tada bi svojstvo Updates za kontrolu obrasca vratilo { Name: "Widget", Quantity: 10 }.
Valid – Da li je kontrola Card ili obrazac za uređivanje, koja sadrži važeće stavke, spremna za prosleđivanje u izvor podataka.
Ovo svojstvo se odnosi samo na kontrolu obrazac za uređivanje.
Svojstvo Valid kontrole obrazac objedinjuje svojstva Valid svih kontrola Card u obrascu. Svojstvo Valid obrasca ima vrednost tačno samo ako su podaci na svim karticama u tom obrascu važeći; u suprotnom, svojstvo obrasca Valid ima vrednost netačno.
Da biste omogućili dugme da sačuva izmene samo kada su podaci u obrascu važeći, ali još nisu prosleđeni, podesite svojstvo dugmeta DisplayMode prema ovoj formuli:
SubmitButton.DisplayMode = If(IsBlank( Form.Error ) || Form.Valid, DisplayMode.Edit, DisplayMode.Disabled)
Dodatna svojstva
BorderColor – Boja ivice kontrole.
BorderStyle – Da li je ivica kontrole puna, isprekidana, tačkasta ili nijedna.
BorderThickness – Debljina ivice kontrole.
Fill – Boja pozadine kontrole.
Height – Odstojanje između gornje i donje ivice kontrole.
Visible – Da li se kontrola prikazuje ili je skrivena.
Width – Odstojanje između leve i desne ivice kontrole.
X – Odstojanje između leve ivice kontrole i leve ivice njegovog nadređenog kontejnera (ili ekrana ako nema nadređenog kontejnera).
Y – Odstojanje između gornje ivice kontrole i gornje ivice njegovog nadređenog kontejnera (ili ekrana ako nema nadređenog kontejnera).
Još informacija
- Za sveobuhvatni pregled načina rada obrazaca, pogledajte Objašnjenje obrazaca podataka.
- Pogledajte referencu Power Fx formule za EditForm.
Smernice za pristupačnost
Podrška za čitače ekrana
- Razmotrite dodavanje naslova u obrazac pomoću Label.
Napomena
Možete li nam reći o svojim željenim postavkama jezika u dokumentaciji? Ispunite kratku anketu. (imajte na umu da je ova anketa na engleskom jeziku)
Anketa će trajati oko sedam minuta. Ne prikupljaju se lični podaci (izjava o privatnosti).