Edit form- ja Display form -ohjausobjektit Power Appsissa

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

Kuvaus

Jos lisäät Display form -ohjausobjektin, käyttäjä voi näyttää kaikki tietueen kentät tai vain määritetyt kentät. Jos lisäät Edit form -ohjausobjektin, käyttäjä voi muokata kenttiä, luoda tietueita ja tallentaa muutokset tietolähteeseen.

Esimerkkilomake ja lomakenäkymän ohjausobjektit

Jos lisäät Gallery-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 Button-ohjausobjektin, joiden avulla käyttäjä voi tallentaa tai peruuttaa muokkauksia ja luoda tietueita. Ohjausobjekteja yhdistelemällä voit luoda täydellisen ratkaisun.

Tietueen valitseminen

Määritä kumman tahansa lomaketyypin DataSource-ominaisuudeksi taulukon tietueet ja määritä lomakkeen Kohde-ominaisuus näyttämään tietty tietue kyseisessä taulukossa. Voit esimerkiksi määrittää lomakkeen Kohde-ominaisuudeksi Gallery-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 Kohde-ominaisuuden, jonka jälkeen lomakkeessa näytetään juuri valittu tietue.

Voit myös määrittää lomakkeen Kohde-ominaisuus käyttämällä avattavan luettelon ohjausobjektia Tietueen tarkasteleminen, muokkaaminen tai lisääminen -kohdassa kuvatulla tavalla, tai funktiota, kuten Haku tai Ensimmäinen. Voit esimerkiksi määrittää Kohde-ominaisuuden jompaankumpaan näistä kaavoista näyttääksesi Fabrikam-merkinnän Microsoft Dataverse Tilit-entiteetissä:

First(Accounts)

Lookup(Accounts, "Fabrikam" in name)

Jokainen Lomake-ohjausobjekti sisältää vähintään yhden Card-ohjausobjektin. Voit määrittää, minkä kentän kortti näyttää ja muita tietoja määrittämällä kortin DataField-ominaisuuden.

Tietueen luominen

Kun Edit form -ohjausobjekti on Muokkaa-tilassa, käyttäjä voi päivittää tietueen, joka on määritetty lomakkeen Kohde-ominaisuudessa. Tila-ominaisuus palauttaa tarkastettaessa arvon Muokkaa.

Kun Edit form -ohjausobjekti on Uusi-tilassa, Kohde-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 Teksti-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 Teksti-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 Teksti-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ää Image-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 OnSelect-ominaisuuteen ResetForm-funktion, vaikka ominaisuus sisältäisi myös Siirry-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 – Lomake-ohjausobjektin alkuperäinen tila. Hyväksyttävät arvot ja niiden merkitykset ovat näkyvissä alla olevassa tilojen kuvauksessa.

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

Johdettu TIla-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 Edit form -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 Edit form -ohjausobjektia.
  • Tällä ominaisuudella on sama luettelointi kuin Erroret-funktiolla. Edit form -ohjausobjekti voi palauttaa seuraavat arvot:
ErrorKind Kuvaus
ErrorKind.Conflict Toinen käyttäjä muutti samaa tietuetta, mikä aiheutti muutosristiriidan. Lataa tietue uudestaan suorittamalla Päivitä-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.

KohdeTietolähteen 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 Edit form -ohjausobjektia.
  • Jos tietolähde laskee tai luo automaattisesti kenttiä, kuten yksilöllisesti numeroidun tunnus kentän, LastSubmit-ominaisuus saa tämän uuden arvon, kun SubmitForm suoritetaan onnistuneesti.
  • Ominaisuuden arvo on käytettävissä OnSuccess-kaavassa.

Tila – 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 – Kuinka sovellus vastaa, kun tietotoiminto epäonnistuu.

  • Tämä ominaisuus koskee vain Edit form -ohjausobjektia.

OnReset – Kuinka sovellus vastaa, kun Edit form -ohjausobjekti nollataan.

  • Tämä ominaisuus koskee vain Edit form -ohjausobjektia.

OnSuccess – Kuinka sovellus vastaa, kun tietotoiminto onnistuu.

  • Tämä ominaisuus koskee vain Edit form -ohjausobjektia.

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

  • Tämä ominaisuus koskee vain Edit form -ohjausobjektia.
  • Tällä ominaisuudella voit varoittaa käyttäjää ennen tallentamattomien tietojen menettämistä. Voit estää käyttäjää valitsemasta eri tietuetta Gallery-ohjausobjektissa ennen muutosten tallentamista nykyiseen tietueeseen, kun määrität valikoiman Poistettu käytöstä -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 Edit form -ohjausobjektia.
  • Tämän ominaisuuden avulla voit poimia kenttäarvoja ohjausobjektin korteista. Voit käyttää näitä arvoja tietolähteen manuaaliseen päivittämiseen Ohjelmakorjaus-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ää Card-ohjausobjektit Name- ja Määrä-kentille ja kyseisten korttien Update-ominaisuudet palauttavat arvot ”Widget” ja 10, Lomake-ohjausobjektin Updates-ominaisuus palauttaa arvon { Name: "Widget", Määrä: 10 }.

Valid – Sisältääkö Card- tai Edit form -ohjausobjekti kelvollisia merkintöjä, jotka voidaan lähettää tietolähteeseen.

  • Tämä ominaisuus koskee vain Edit form -ohjausobjektia.

  • Lomake-ohjausobjektin Valid-ominaisuus koostaa kaikkien lomakkeen Card-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.

Helppokäyttötoimintojen ohjeet

Näytönlukuohjelman tuki

  • Harkitse otsikon lisäämistä lomakkeeseen Label avulla.