Muokkaa lomaketta- ja Näytä lomake -ohjausobjektit Power Appsissa

Näytä ja luo tietue tai muokkaa sitä tietolähteessä.

Kuvaus

Jos lisäät Näytä lomake -ohjausobjektin, käyttäjä voi näyttää kaikki tietueen kentät tai vain määritetyt kentät. Jos lisäät Muokkaa lomaketta -ohjausobjektin, käyttäjä voi muokata kenttiä, luoda tietueita ja tallentaa muutokset tietolähteeseen.

Jos lisäät Valikoima-ohjausobjektin, voit määrittää sen näyttämään taulukon tietolähteessä. Tämän jälkeen voit määrittää lomakkeen näyttämään tietueen, jonka käyttäjä valitsee valikoimasta. Voit myös lisätä yhden tai useamman Painike-ohjausobjektin, joiden avulla käyttäjä voi tallentaa tai peruuttaa muokkauksia ja luoda tietueita. Ohjausobjekteja yhdistelemällä voit luoda täydellisen ratkaisun.

Rajoitukset

Lomake-ohjausobjektilla on seuraavat rajoitukset:

• Et voi kopioida ja liittää lomakkeita tietokortteihin. Tämä estää luomasta tiettyjen ohjausobjektien yhdistelmiä, jotka voisivat heikentää sovelluksen vakautta ja suorituskykyä.

Tietueen valitseminen

Määritä kumman tahansa lomaketyypin DataSource-ominaisuudeksi taulukon tietueet ja määritä lomakkeen Item-ominaisuus näyttämään tietty tietue kyseisessä taulukossa. Voit esimerkiksi määrittää lomakkeen Item-ominaisuudeksi Valikoima-ohjausobjektin SelectedItem-ominaisuuden. Kun käyttäjä valitsee valikoimasta tietueen, sama tietue näytetään myös lomakkeessa, mutta siinä voidaan näyttää enemmän kenttiä. Jos käyttäjä palaa valikoimaan ja valitsee toisen tietueen, valikoiman SelectedItem-ominaisuus muuttuu. Tämä muutos päivittää lomakkeen Item-ominaisuuden, jonka jälkeen lomakkeessa näytetään juuri valittu tietue.

Voit myös määrittää lomakkeen Item-ominaisuus käyttämällä Avattava-ohjausobjektia Tietueen tarkasteleminen, muokkaaminen tai lisääminen -kohdassa kuvatulla tavalla, tai funktiota, kuten Lookup tai First. Voit esimerkiksi määrittää Item-ominaisuuden jompaankumpaan näistä kaavoista näyttääksesi Fabrikam-merkinnän Tilit-taulukossa Microsoft Dataversessa.

First(Accounts)

Lookup(Accounts, "Fabrikam" in name)

Jokainen Form-ohjausobjekti sisältää vähintään yhden Kortti-ohjausobjektin. Määrittämällä kortin DataField-ominaisuuden voit määrittää, minkä kentän kortti näyttää, sekä muita tietoja.

Tietueen luominen

Kun Muokkaa lomaketta -ohjausobjekti on Muokkaa-tilassa, käyttäjä voi päivittää tietueen, joka on määritetty lomakkeen Item-ominaisuudessa. Mode-ominaisuus palauttaa tarkastettaessa arvon Muokkaa.

Kun Muokkaa lomaketta -ohjausobjekti on Uusi-tilassa, Item-ominaisuus ohitetaan. Lomake ei näytä olemassa olevaa tietuetta. Sen sijaan kunkin kentän arvot vastaavat lomakkeen määrittämiseen käytetyn tietolähteen oletusarvoja. NewForm-funktio siirtää lomakkeen tähän tilaan.

Voit esimerkiksi määrittää painikkeen Text-ominaisuuden näyttämään Uusi ja OnSelect-ominaisuuden näyttämään kaavan, joka sisältää NewForm-funktion. Jos käyttäjä valitsee kyseisen painikkeen, lomake siirtyy Uusi-tilaan ja käyttäjä voi luoda tietueen, joka alkaa tunnetuilla arvoilla.

Jos joko ResetForm-funktion tai SubmitForm-funktion suorittaminen onnistuu, lomake siirtyy takaisin Muokkaa-tilaan.

• Voit esimerkiksi määrittää painikkeen Text-ominaisuuden näyttämään Peruuta ja OnSelect-ominaisuuden näyttämään kaavan, joka sisältää ResetForm-funktion. Jos käyttäjä valitsee kyseisen painikkeen, keskeneräiset muutokset hylätään, ja lomakkeen arvot vastaavat jälleen tietolähteen oletusarvoja.
• Voit esimerkiksi määrittää painikkeen Text-ominaisuuden näyttämään Tallenna muutokset ja OnSelect-ominaisuuden näyttämään kaavan, joka sisältää SubmitForm-funktion. Jos käyttäjä valitsee kyseisen painikkeen ja tietolähde päivitetään, lomakkeen arvot palautetaan tietolähteen oletusarvoiksi.

Tallenna muutokset

Jos luot Tallenna muutokset -painikkeen edellisessä osassa kuvatulla tavalla, käyttäjä voi luoda tai päivittää tietuetta ja tallentaa tekemänsä muutokset tietolähteeseen valitsemalla painikkeen. Voit halutessasi määrittää Kuva-ohjausobjektin tai jonkin muun ohjausobjektin suorittamaan saman tehtävän, kunhan määrität kyseiselle ohjausobjektille SubmitForm-funktion. Error-, ErrorKind-, OnSuccess- ja OnFailure-ominaisuudet antavat joka tapauksessa palautetta tuloksesta.

Kun SubmitForm-funktio suoritetaan, se vahvistaa ensin tiedot, jotka käyttäjä haluaa lähettää. Jos pakollinen kenttä ei sisällä arvoa tai jokin toinen arvo ei vastaa muita rajoitteita, ErrorKind-ominaisuudet määritetään ja OnFailure-kaava suoritetaan. Voit määrittää Tallenna muutokset -painikkeen tai muun ohjausobjektin siten, että käyttäjä voi valita sen vain, jos tiedot ovat kelvolliset (toisin sanoen, jos Valid-ominaisuuden arvo on tosi). Huomaa, että käyttäjän on paitsi korjattava ongelma, myös valittava Tallenna muutokset -painike uudelleen (tai hylättävä muutokset valitsemalla Peruuta-painike aiempien ohjeiden mukaisesti), joka nollaa Error- ja ErrorKind-ominaisuudet.

Jos tiedot läpäisevät tarkistuksen, SubmitForm lähettää ne tietolähteeseen. Lähettämisessä voi kestää jonkin aikaa verkkoviiveen vuoksi.

• Jos lähetys onnistuu, Error-ominaisuus tyhjennetään, ErrorKind-ominaisuudeksi määritetään ErrorKind.None ja OnSuccess-kaava suoritetaan. Jos käyttäjä on luonut tietueen (eli jos lomake oli aiemmin Uusi-tilassa), lomake siirtyy Muokkaa-tilaan, jotta käyttäjä voi muokata juuri luomaansa tietuetta tai jotain toista tietuetta.
• Jos lähetys epäonnistuu, Error-ominaisuus sisältää käyttäjäystävällisen virhesanoman tietolähteestä, joka selittää ongelman. ErrorKind-ominaisuus määritetään ongelman mukaan ja OnFailure-kaava suoritetaan.

Jotkin tietolähteet voivat tunnistaa, jos kaksi henkilöä yrittää päivittää samaa tietuetta samaan aikaan. Tässä tapauksessa ErrorKind-ominaisuudeksi määritetään ErrorKind.Conflict. Ongelma korjataan päivittämällä tietolähde toisen käyttäjän muutoksilla ja ottamalla käyttäjän muutokset käyttöön uudelleen.

Vihje

Lomakkeessasi voi olla Peruuta-painike, jolla käyttäjä voi hylätä keskeneräiset muutokset. Voit lisätä painikkeen ResetForm-funktion painikkeen OnSelect-ominaisuuteen, vaikka ominaisuus sisältäisi myös Navigate-funktion näytön vaihtamiseen. Muussa tapauksessa lomake säilyttää käyttäjän tekemät muutokset.

Asettelu

Kortit sijoitetaan oletusarvoisesti yhteen sarakkeeseen puhelinsovelluksissa ja kolmeen sarakkeeseen tablettisovelluksissa. Voit määrittää, kuinka monta saraketta lomakkeessa on, ja kohdistetaanko kortit sarakkeisiin, kun määrität lomaketta. Nämä asetukset eivät näy ominaisuuksina, koska niitä käytetään vain korttien X-, Y- ja Width-ominaisuuksien määrittämiseen.

Lisätietoja on kohdassa Tutustu tietolomakkeiden asetteluun.

Tärkeimmät ominaisuudet

DataSource – Tietolähde, joka sisältää käyttäjän näyttämän, muokkaaman tai luoman tietueen.

• Jos et määritä tätä ominaisuutta, käyttäjä ei voi näyttää, muokata tai luoda tietueita, eikä muita metatietoja tai vahvistusta anneta.

DefaultMode – Form-ohjausobjektin alkuperäinen tila. Hyväksyttävät arvot ja niiden merkitykset ovat näkyvissä alla olevassa Mode kuvauksessa.

DisplayMode – Tila, jota käytetään Form-ohjausobjektin tietokorteissa ja ohjausobjekteissa.

Johdettu Mode-ominaisuudesta, eikä sitä voi määrittää erikseen:

Tila	DisplayMode	Kuvaus
FormMode.Edit	DisplayMode.Edit	Tietokortit ja ohjausobjektit ovat muokattavissa ja valmiit hyväksymään muutoksia tietueeseen.
FormMode.New	DisplayMode.Edit	Tietokortit ja ohjausobjektit ovat muokattavissa ja valmiit hyväksymään uuden tietueen.
FormMode.View	DisplayMode.View	Tietokortit ja ohjausobjektit eivät ole muokattavissa vaan optimoituja tarkastelemista varten.

Error – Lomakkeessa näytettävä käyttäjäystävällinen virhesanoma, kun SubmitForm-funktio epäonnistuu.

• Tämä ominaisuus koskee vain Muokkaa lomaketta -ohjausobjektia.
• Tämä ominaisuus muuttuu vain, kun SubmitForm-, EditForm-, tai ResetForm-funktio suoritetaan.
• Jos virhettä ei tapahdu, ominaisuus on tyhjä ja ErrorKind määritetään arvoksi ErrorKind.None.
• Jos mahdollista, palautettu virhesanoma näytetään käyttäjän kielellä. Jotkin virhesanomat ovat peräisin suoraan tietolähteestä, eikä niitä voida välttämättä näyttää käyttäjän kielellä.

ErrorKind – Ilmaisee tapahtuneen virheen lajin, jos SubmitForm-funktiota suorittaessa ilmenee virhe.

• Koskee vain Muokkaa lomaketta -ohjausobjektia.
• Tällä ominaisuudella on sama luettelointi kuin Errors-funktiolla. Muokkaa lomaketta -ohjausobjekti voi palauttaa seuraavat arvot:

ErrorKind	Kuvaus
ErrorKind.Conflict	Toinen käyttäjä muutti samaa tietuetta, mikä aiheutti muutosristiriidan. Lataa tietue uudestaan suorittamalla Refresh-funktio ja yritä tehdä muutos uudelleen.
ErrorKind.None	Erroren laji on tuntematon.
ErrorKind.Sync	Tietolähde ilmoitti virheestä. Jos haluat lisätietoa, tarkasta Error-ominaisuus.
ErrorKind.Validation	Yleinen vahvistusongelma havaittu.

Item – DataSource tietue, jonka käyttäjä aikoo näyttää tai jota hän aikoo muokata.

LastSubmit – Viimeinen onnistuneesti lähetetty tietue, mukaan lukien palvelimen luomat kentät.

• Tämä ominaisuus koskee vain Muokkaa lomaketta -ohjausobjektia.
• Jos tietolähde laskee tai luo automaattisesti kenttiä, kuten yksilöllisesti numeroidun tunnuskentän, LastSubmit-ominaisuus saa tämän uuden arvon, kun SubmitForm suoritetaan onnistuneesti.
• Ominaisuuden arvo on käytettävissä OnSuccess-kaavassa.

Mode – Ohjausobjekti on Muokkaa- tai Uusi-tilassa.

Tila	Kuvaus
FormMode.Edit	Käyttäjä voi muokata tietuetta lomakkeen avulla. Lomakkeen korteissa olevat arvot on täytetty olemassa olevalla tietueella. Käyttäjä voi muuttaa niitä halutessaan. Jos SubmitForm-funktion suorittaminen onnistuu, olemassa olevaa tietuetta muokataan.
FormMode.New	Käyttäjä voi luoda tietueen lomakkeen avulla. Lomakkeen ohjausobjekteissa olevat arvot on täytetty tietolähteen tietueen oletusarvoilla. Jos SubmitForm-funktion suorittaminen onnistuu, tietue luodaan.
FormMode.View	Käyttäjä voi tarkastella tietuetta lomakkeen avulla. Lomakkeen ohjausobjekteissa olevat arvot on täytetty tietolähteen tietueen oletusarvoilla.

Lomake siirtyy Uusi-tilasta Muokkaa-tilaan, kun jokin seuraavista muutoksista tapahtuu:

• Lomakkeen lähettäminen onnistuu ja tietue luodaan. Jos valikoima on määritetty siirtämään valinta automaattisesti uuteen tietueeseen, lomake on luodun tietueen osalta Muokkaa-tilassa, jotta käyttäjä voi tehdä lisämuutoksia.
• EditForm-funktio suoritetaan.
• ResetForm-funktio suoritetaan. Käyttäjä voi esimerkiksi valita Peruuta-painikkeen, johon on määritetty tämä funktio.

OnFailure – Toiminnot, jotka suoritetaan, kun tietotoiminto on epäonnistunut.

• Tämä ominaisuus koskee vain Muokkaa lomaketta -ohjausobjektia.

OnReset – Toiminnot, jotka suoritetaan, kun Muokkaa lomaketta -ohjausobjekti nollataan.

• Tämä ominaisuus koskee vain Muokkaa lomaketta -ohjausobjektia.

OnSuccess – Toiminnot, jotka suoritetaan, kun tietotoiminto on onnistunut.

• Tämä ominaisuus koskee vain Muokkaa lomaketta -ohjausobjektia.

Unsaved – Tosi, jos Muokkaa lomaketta -ohjausobjekti sisältää käyttäjän tekemiä muutoksia, joita ei ole tallennettu.

• Tämä ominaisuus koskee vain Muokkaa lomaketta -ohjausobjektia.
• Tällä ominaisuudella voit varoittaa käyttäjää ennen tallentamattomien tietojen menettämistä. Voit estää käyttäjää valitsemasta eri tietuetta Valikoima-ohjausobjektissa ennen muutosten tallentamista nykyiseen tietueeseen, kun määrität valikoiman Disabled -ominaisuuden arvoksi Form.Unsaved ja poistat päivitystoiminnot käytöstä.

Updates – Lomakeohjausobjektiin ladatun tietueen arvot, jotka kirjoitetaan takaisin tietolähteeseen.

• Tämä ominaisuus koskee vain Muokkaa lomaketta -ohjausobjektia.
• Tämän ominaisuuden avulla voit poimia kenttäarvoja ohjausobjektin korteista. Voit käyttää näitä arvoja tietolähteen manuaaliseen päivittämiseen Patch-funktiokutsulla tai muulla yhteyden näyttämällä menetelmällä. Tätä toimintoa ei tarvita, jos SubmitForm-funktio on käytössä.
• Ominaisuus palauttaa tietueen arvoista. Jos Lomake-ohjausobjekti sisältää Kortti-ohjausobjektit Name- ja Määrä-kentille ja kyseisten korttien Update-ominaisuudet palauttavat arvot ”Widget” ja 10, Form-ohjausobjektin Updates-ominaisuus palauttaa arvon { Name: "Widget", Määrä: 10 }.

Valid – Sisältääkö Kortti- tai Muokkaa lomaketta -ohjausobjekti kelvollisia merkintöjä, jotka voidaan lähettää tietolähteeseen.

• Tämä ominaisuus koskee vain Muokkaa lomaketta -ohjausobjektia.

• Lomake-ohjausobjektin Valid-ominaisuus koostaa kaikkien lomakkeen Kortti-ohjausobjektien Valid-ominaisuudet. Lomakkeen Valid-ominaisuuden arvo on tosi vain, jos lomakkeen kaikkien korttien tiedot ovat kelvollisia. Muussa tapauksessa Valid-ominaisuus on epätosi.

• Voit määrittää painikkeen tallentamaan muutokset vain, jos lomakkeen tiedot ovat kelvollisia, mutta niitä ei ole vielä lähetetty, määrittämällä painikkeen DisplayMode-arvoksi seuraavan kaavan:

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

Lisäominaisuudet

BorderColor – Ohjausobjektin reunan väri.

BorderStyle – Onko ohjausobjektin reuna Yhtenäinen, Katkoviiva, Pisteviiva vai Ei mitään.

BorderThickness – Ohjausobjektin reunan paksuus.

Fill – Ohjausobjektin taustaväri.

Height – Ohjausobjektin ylä- ja alareunan välinen etäisyys.

Visible – Onko ohjausobjekti näkyvissä vai piilossa.

Width – Ohjausobjektin vasemman ja oikean reunan välinen etäisyys.

X – Ohjausobjektin vasemman reunan ja pääsäilön (tai näytön, jos pääsäilöä ei ole) vasemman reunan välinen etäisyys.

Y – Ohjausobjektin yläreunan ja pääsäilön (tai näytön, jos pääsäilöä ei ole) yläreunan välinen etäisyys.

Lisätietoja

• Kattavampi yleiskatsaus lomakkeiden toiminnasta on kohdassa Tutustu tietolomakkeisiin.
• Katso Power Fx -kaavaviite EditFormille.

Helppokäyttötoimintojen ohjeet

Näytönlukuohjelman tuki

• Harkitse otsikon lisäämistä lomakkeeseen Selite-ohjausobjektin avulla.

Huomautus

Voitko kertoa meille dokumentaatiota koskevan kielimäärityksesi? Vastaa lyhyeen kyselyyn. (Huomaa, että tämä kysely on englanninkielinen.)

Kyselyyn vastaaminen kestää noin seitsemän minuuttia. Henkilökohtaisia tietoja ei kerätä (tietosuojatiedot).