Kontrole Edit form i Prikaži obrazac u Power Apps

Prikažite, uredite i stvorite zapis u izvoru podataka.

Opis

Ako dodate kontrolu Prikaži obrazac, korisnik može prikazati sva polja zapisa ili samo polja koja odredite. Ako dodate kontrolu Edit form, korisnik može urediti ona polja, stvoriti zapis i spremiti one promjene u izvor podataka.

Ako dodate kontrolu Gallery možete je konfigurirati za prikaz tablice u izvoru podataka, a zatim konfigurirati obrazac za prikaz onog zapisa koji korisnik odabere u galeriji. Možete dodati i jednu ili više kontrola Button koju korisnik može odabrati za spremanje izmjena, otkazivanje izmjena i stvaranje zapisa. Zajedničkim korištenjem kontrola možete stvoriti cjelovito rješenje.

Ograničenja

Kontrola obrasca ima sljedeća ograničenja:

• Obrasce ne možete kopirati i lijepiti u podatkovne kartice. Time se želi spriječiti stvaranje određenih kombinacija kontrola koje riskiraju stabilnost i performanse aplikacije.

Odabir zapisa

Za bilo koju vrstu obrasca postavite njeno svojstvo Izvor podataka na tablicu zapisa i postavite svojstvo Items obrasca tako da prikažete određeni zapis u toj tablici. Na primjer, možete postaviti svojstvo Item na svojstvo SelectedItem kontrole Gallery. Kada korisnik odabere zapis u galeriji, isti se zapis pojavljuje u obrascu, osim što obrazac može pokazati više polja. Ako se korisnik vrati u galeriju i odabere drugačiji zapis, mijenja se svojstvo galerije Odabranastavka. Ova promjena ažurira svojstvo obrasca Item koje zatim pokazuje novoodabrani zapis.

Možete postaviti i svojstvo obrasca Item pomoću kontrole Drop down kao što opisuje Pokaži, uredi ili dodaj zapis ili funkciju kao što je Traženje ili Prvi. Na primjer, možete postaviti svojstvo Stavka na bilo koju od ovih formula za prikaz unosa Fabrikam u tablici Računi u servisu Microsoft Dataverse:

First(Accounts)

Lookup(Accounts, "Fabrikam" in name)

Svaka kontrola obrasca obuhvaća jednu ili više kontrola Card. Postavljanjem svojstva DataField kartice, navedite koje polje ta kartica pokazuje i druge pojedinosti.

Stvaranje zapisa

Kada je kontrola Edit form u načinu rada Uredi korisnik može ažurirati zapis koji je naveden u svojstvu obrasca Item. Ako se pregleda, svojstvo Način rada vraća Uredi.

Kada je kontrola Edit form u načinu rada Novo, međutim zanemareno je svojstvo Item. Obrazac ne pokazuje postojeći zapis; umjesto toga, vrijednosti u svakom polju odgovaraju zadanim vrijednostima izvora podataka s kojima ste konfigurirali obrazac. Funkcija NewForm uzrokuje prelazak obrasca na ovaj način.

Na primjer, možete postaviti svojstvo Tekst gumba da biste pokazali Novo i njegovo svojstvo OnSelect formuli koja obuhvaća funkciju NewForm. Ako korisnik odabere taj gumb, obrazac prelazi u način rada Novo tako da korisnik može stvoriti zapis počevši s poznatim vrijednostima.

Obrazac se vraća na način rada Uredi bilo da je pokrenuta funkcija ResetForm ili funkcija SubmitForm uspješno radi.

• Možete postaviti svojstvo Tekst gumba da biste pokazali Otkaži i njegovo svojstvo OnSelect formuli koja obuhvaća funkciju ResetForm. Ako korisnik odabere taj gumb, sve promjene u tijeku su odbačene, a vrijednosti u obrascu još jednom odgovaraju zadanim vrijednostima izvora podataka.
• Možete postaviti svojstvo Tekst gumba da biste pokazali Spremi promjene i njegovo svojstvo OnSelect formuli koja obuhvaća funkciju SubmitForm. Ako korisnik odabere taj gumb, a izvor podataka je ažuriran, vrijednosti u obrascu su ponovno postavljene na zadane vrijednosti izvora podataka.

Spremi promjene

Ako stvorite gumb Spremi promjene kao što opisuje prethodni odjeljak, korisnik može stvoriti ili ažurirati zapis, a zatim odabrati taj gumb za spremanje tih promjena u izvor podataka. Umjesto toga možete konfigurirati kontrolu Image ili neku drugu kontrolu kako biste izvršili isti zadatak sve dok konfigurirate tu kontrolu s funkcijom SubmitForm. U svakom slučau, svojstva Pogreška, ErrorKind, OnSuccess i OnFailure pružaju povratne informacije o ishodu.

Kada je pokrenuta funkcija SubmitForm, prvo provjerava podatke koje korisnik želi poslati. Ako obvezno polje ne sadrži vrijednost ili neka druga vrijednost ne odgovara nekom drugom ograničenju, svojstva ErrorKind su postavljena i pokrenuta je formula OnFailure. Možete konfigurirati gumb Spremi promjene ili drugu kontrolu tako da je korisnik može odabrati samo ako su podatci valjani (tj. ako je svojstvo obrasca Valid true). Imajte na umu da korisnik mora ne samo ispraviti problem, već ponovno odabrati gumb Spremi promjene (ili odbaciti promjene odabirom gumba Otkaži kao što je opisano ranije) za ponovno postavljanje svojstava Pogreška i ErrorKind.

Ako podatci prođu provjeru valjanosti, SubmitForm šalje ga u izvor podataka, što može potrajati neko vrijeme, ovisno o kašnjenju mreže.

• Ako slanje uspije, svojstvo Pogreška je očišćeno, svojstvo ErrorKind postavljeno je na ErrorKind.Nema i pokrenuta je formula OnSuccess. Ako je korisnik stvorio zapis (tj. ako je obrazac ranije bio u načinu rada Novo) obrazac je prebačen u način rada Uredi tako da korisnik može urediti novostvoreni zapis ili neki drugi.
• Ako slanje ne uspije, svojstvo Pogreška obuhvaća poruku o pogrešci prilagođenu korisniku iz izvora podataka, koja objašnjava problem. Svojstvo ErrorKind postavljeno je na odgovarajući način, ovisno o problemu i pokrenuta je formula OnFailure.

Neki izvori podataka mogu otkriti kada dvije osobe pokušavaju istovremeno ažurirati isti zapis. U ovom slučaju, ErrorKind postavljena je na ErrorKind.Konflikt, a rješenje je osvježiti izvor podataka s promjenama drugog korisnika i ponovno primijeniti promjenu koju je učinio ovaj korisnik.

Izgled

Karte se prema zadanim postavkama nalaze u jednom stupcu za telefonske aplikacije i u tri stupca za aplikacije tableta. Možete odrediti koliko stupaca obrazac sadrži i treba li kartice prilijepiti dok konfigurirate obrazac. Ove postavke nisu izložene kao svojstva jer se koriste samo za postavljanje svojstava X, Y i Width kartica.

Za više informacija pogledajte Razumijevanje izgleda obrasca podataka.

Ključna svojstva

DataSource – Izvor podataka koji obuhvaća zapis koji će korisnik pokazati, urediti ili stvoriti.

• Ako ne postavite ovo svojstvo, korisnik ne može pokazati, urediti ili stvoriti zapis, a nisu dodani dodatni metapodaci ili provjera valjanosti.

Zadaninačinrada - Početni način rada kontrole obrasca. Pogledajte opis Način rada u nastavku za prihvatljive vrijednosti i njihova značenja.

DisplayMode - Način rada za uporabu podatkovnih kartica i kontrola unutar kontrole obrasca.

Izvedeno iz svojstva Način rada i ne može se samostalno postaviti:

Pogreška – Poruka o pogrešci prilagođena korisniku prikazuje se za ovaj obrazac kada funkcija SubmitForm ne uspije.

• Ovo svojstvo primijenjuje se samo na kontrolu Edit form.
• Ovo svojstvo mijenja se samo kada je pokrenuta funkcija SubmitForm, EditForm ili ResetForm.
• Ako nema pogreške, ovo svojstvo je prazno, a ErrorKind postavljena je na ErrorKind.Nema.
• Kada je moguće, vraćena poruka o pogrešci bit će na jeziku korisnika. Neke poruke o pogrešci dolaze izravno s izvora podataka i ne moraju biti na jeziku korisnika.

ErrorKind – Ako dođe do pogreške kada je pokrenuto SubmitForm, vrsta pogreške koja se dogodila.

• Primijenjuje se samo na kontrolu Edit form.
• Ovo svojstvo ima isto nabrajanje kao funkcija Pogreške. Kontrola Edit form može vratiti ove vrijednosti:

Item – Zapis u DataSource koji će korisnik pokazati ili urediti.

LastSubmit – Posljednji uspješno poslani zapis uključujući sva polja generirana na poslužitelju.

• Ovo svojstvo primijenjuje se samo na kontrolu Edit form.
• Ako izvor podataka automatski generira ili izračuna bilo koja polja, poput polja ID s jedinstvenim brojem, svojstvo LastSubmit će imati ovu novu vrijednost nakon uspješnog pokretanja SubmitForm.
• Vrijednost ovog svojstva dostupna je u formuli OnSuccess.

Način rada – Kontrola je u načinu rada Uredi ili Novo.

Obrazac se prebacuje iz načina rada Novo u način rada Uredi kada se dogodi neka od ovih promjena:

• Obrazac se uspješno predaje i kreira se zapis. Ako je galerija postavljena za automatsko pomicanje odabira na ovaj novi zapis, obrazac će biti u načinu rada Uredi za stvoreni zapis tako da korisnik može načiniti dodatne promjene.
• Pokreće se funkcija EditForm.
• Pokreće se funkcija Ponovnopokreniobrazac. Na primjer, korisnik može odabrati gumb Otkaži koji je konfiguriran s ovom funkcijom.

OnFailure – Radnje koje treba provesti kada operacija podataka nije uspjela.

• Ovo svojstvo primijenjuje se samo na kontrolu Edit form.

OnReset – Radnje koje treba obaviti kada se ponovno postavi kontrola Uredi obrazac.

• Ovo svojstvo primijenjuje se samo na kontrolu Edit form.

OnSuccess – Radnje koje treba provesti kada je operacija podataka uspjela.

• Ovo svojstvo primijenjuje se samo na kontrolu Edit form.

Unsaved – True ako kontrola Edit form obuhvaća promjene korisnika koje nisu bile spremljene.

• Ovo svojstvo primijenjuje se samo na kontrolu Edit form.
• Ovim svojstvom upozorite korisnika prije gubitka nespremljenih promjena. Da biste spriječili da korisnik odabire neki drugi zapis u kontroli Gallery prije spremanja promjena na trenutni zapis, postavite svojstvo galerije Disabled na Obrazac.Unsaved i, isto tako, onemogućite operacije osvježavanja.

Updates – Vrijednosti za ponovno pisanje u izvor podataka za zapis koji je učitan u kontrolu obrasca.

• Ovo svojstvo primijenjuje se samo na kontrolu Edit form.
• Koristite ovo svojstvo da izdvojite vrijednosti polja s kartica unutar kontrole. Zatim možete koristiti ove vrijednosti za ručno ažuriranje izvora podataka s pozivom funkcije Patch ili druge metode izložene vezom. Ne trebate koristiti ovo svojstvo ako koristite funkciju SubmitForm.
• Ovo svojstvo vraća zapis vrijednosti. Na primjer, ako kontrola obrasca obuhvaća kontrole kartice za polja Naziv i Količina, a vrijednosti svojstava Update za te kartice vraćaju "Widget" i 10, tada bi svojstvo Updates za kontrolu oblika vratilo { Naziv: "Widget", Količina: 10 }.

Valid – Sadrži li kontrola Card ili Edit form valjane unose, spremne za slanje na izvor podataka.

• Ovo svojstvo primijenjuje se samo na kontrolu Edit form.

• Svojstvo Valid kontrole Form zbraja svojstva Valid svih kontrola Card u obrascu. Svojstvo obrasca Valid je true samo ako su podatci svih kartica u tom obrascu valjani; u protivnom, svojstvo obrasca Valid je false.

• Da biste omogućili gumb za spremanje promjena samo kad su podatci u obrascu valjani, ali još nisu poslani, postavite svojstvo gumba DisplayMode na ovu formulu:

  SubmitButton.DisplayMode = If(IsBlank( Form.Error ) || Form.Valid, DisplayMode.Edit, DisplayMode.Disabled)

Dodatna svojstva

BorderColor – Boja obruba kontrole.

Vrstaobruba – Bilo da je obrub kontrole Neprekidan, Isprekidan, Točkast ili Nema.

BorderThickness – Debljina obruba kontrole.

Fill – Boja pozadine kontrole.

Height – Udaljenost između gornjeg i donjeg ruba kontrole.

Visible – Bilo da se kontrola prikazuje ili je skrivena.

Width – Udaljenost između lijevog i desnog ruba kontrole.

X – Udaljenost između lijevog ruba kontrole i lijevog ruba njegovog nadređenog spremnika (zaslon, ako nema nadređenog spremnika).

Y – Udaljenost između gornjeg ruba kontrole i gornjeg ruba nadređenog spremnika (zaslon, ako nema nadređenog spremnika).

Dodatne informacije

• Za sveobuhvatni pregled načina rada obrazaca pogledajte Razumijevanje obrazaca podataka.
• Pogledajte referencu Power Fx formule za EditForm.

Smjernice za pristupačnost

Podrška za čitač zaslona

• Razmislite o dodavanju naslova u obrazac pomoću kontrole Label.