Redigeeri vorm ja kuva vorm juhtelemendid Power Appsis

Kirje kuvamine, redigeerimine ja loomine andmeallikas.

Kirjeldus

Kui lisate juhtelemendi Display form (Kuva vorm), saab kasutaja kuvada kõik kirje väljad või ainult teie määratud väljad. Kui lisate juhtelemendi Edit form (Redigeeri vormi), saab kasutaja neid välju redigeerida, luua kirje ja salvestada need muudatused andmeallikassse.

Kui lisate juhtelemendi Gallery (Galerii), saate selle konfigureerida nii, et see näitaks andmeallikas tabelit ja seejärel konfigureerima vormi, et näidata, millist kirjet kasutaja galeriis valib. Saate lisada ka ühe või mitu juhtelementi Button (Nupp), mida kasutaja saab valida muudatuste salvestamiseks, nende tühistamiseks ja kirje loomiseks. Mitme juhtelemendi kasutamisel saate luua täieliku lahenduse.

Piirangud

Vormi juhtelemendil on järgmised piirangud.

• Vorme ei saa andmekaartidele kopeerida ega kleepida. Selle eesmärk on vältida teatud juhtelementide kombinatsioonide loomist, mis ohustavad rakenduse stabiilsust ja jõudlust.

Kirje valik

Mõlemat tüüpi vormi puhul määrake selle atribuut Andmeallikas kirjete tabelile ja te määrate vormi atribuut Item (Üksus), et kuvada kindlat kirjet selles tabelis. Näiteks saate seada vormi atribuudi Item juhtelemendi Gallery (Galerii) atribuudile SelectedItem (Valitud üksus). Kui kasutaja valib galeriis kirje, kuvatakse vormil sama kirje erinevusega, et vorm saab kuvada rohkem välju. Kui kasutaja naaseb galeriisse ja valib mõne muu kirje, muutub galerii atribuudi SelectedItem (Valitud üksus) väärtus. See muudatus uuendab vormi atribuuti Item (Üksus), mis kuvab seejärel äsja valitud kirje.

Samuti saate määrata vormi atribuuti Item (Üksus) kasutades juhtelementi Drop down (Rippmenüü), mida kirjeldab jaotis Kuva, redigeeri või lisa kirje või sellist funktsiooni nagu Lookup (Otsing) või First (Esimene). Näiteks saate atribuudi Üksus väärtuseks seada ühe nendest valemitest, et kuvada Fabrikami kirje Kontod Microsoft Dataverse tabelis.

First(Accounts)

Lookup(Accounts, "Fabrikam" in name)

Iga vormi juhtelement sisaldab vähemalt ühte juhtelementi Card (Kaart). Kui määrate kaardi atribuudiks DataField (Andmeväli), siis määrate, millist välja see kaart näitab ja muud üksikasjad.

Kirje loomine

Kui juhtelement Edit form (Redigeeri vorm) on režiimis Edit (Redigeeri) saab kasutaja värskendada kirjet, mis on määratletud vormi atribuudis Item (Üksus). Kontrollitult tagastab atribuut Mode (Režiim) väärtuse Edit (Redigeeri).

Kui juhtelement Edit form (Redigeeri vorm) on režiimis New (Uus), ignoreeritakse atribuuti Item (Üksus). Vorm ei kuva olemasolevat kirjet. Selle asemel vastavad kõigi väljade väärtused vaikeväärtustele andmeallikas, kus te vormi konfigureerisite. Funktsioon NewForm (Uus vorm) põhjustab vormi lülitumist sellesse režiimi.

Näiteks saate seada nupu atribuudi Tekst väärtuseks New (Uus) ja selle atribuudi OnSelect valemile, mis sisaldab funktsiooni NewForm (Uus vorm). Kui kasutaja valib selle nupu, lülitub vorm režiimi New (Uus), nii et kasutaja saab luua kirje, mis sisaldab teadaolevaid väärtusi.

Vorm lülitub tagasi režiimi Edit (Redigeeri), kui funktsioon ResetForm (Lähtesta vorm) või funktsioon SubmitForm (Esita vorm) töötab edukalt.

• Saate seada nupu atribuudi Tekst väärtuseks Cancel (Tühista) ja selle atribuudi OnSelect valemile, mis sisaldab funktsiooni ResetForm (Lähtesta vorm). Kui kasutaja valib selle nupu, siis kõik pooleliolevad muudatused hüljatakse ja vormi väärtused vastavad jällegi andmeallika vaikeväärtustele.
• Saate seada nupu atribuudi Text (Tekst) väärtuseks Save changes (Salvesta väärtused) ja selle atribuudi OnSelect valemile, mis sisaldab funktsiooni SubmitForm (Esita vorm). Kui kasutaja valib selle nupu ja andmeallikas värskendatakse, siis vormi väärtused lähtestatakse andmeallika vaikeväärtustele.

Saate muudatused salvestada

Kui loote nupu Save changes (Salvesta muudatused) vastavalt eelmisele jaotisele, saab kasutaja luua või värskendada kirjet ja seejärel andmeallikasse muudatuste salvestamiseks vajutada seda nuppu. Selle asemel saate konfigureerida juhtelemendi Image (Pilt) või mõne muu juhtelemendi sama toimingu teostamiseks, kui konfigureerite valitud juhtelemendi funktsiooniga SubmitForm (Esita vorm). Igal juhul annavad atribuudid Error (Tõrge), ErrorKind (Tõrkelaadne), OnSuccess (Edukas) ja OnFailure (Nurjunud) tagasisidet tulemuse kohta.

Kui funktsioon SubmitForm (Esita vorm) töötab, valideerib ta kõigepealt andmed, mida kasutaja soovib esitada. Kui nõutav väli ei sisalda väärtust või mõni muu väärtus ei vasta mõnele muule piirangule, on atribuudid ErrorKind (Tõrkelaadne) seatud ja OnFailure (Nurjunud) valem töötab. Saate konfigureerida nupu Save changes (Salvesta muudatused) või muu juhtelemendi, et kasutaja saaks selle valida ainult juhul, kui andmed on valideeritud (ehk juhul, kui vormi atribuudi Valid (Kehtiv) väärtus on true (tõene)). Kasutaja ei tohi ainult probleemi lahendada, vaid uuesti vajutada nuppu Save changes (Salvesta muudatused) (või muudatused hüljata vajutades nuppu Cancel (Tühista), nagu on kirjeldatud eespool), et lähtestada atribuudid Error (Tõrge) ja ErrorKind (Tõrkelaadne).

Kui andmed läbib valideerimise, saadab SubmitForm (Esita vorm) selle andmeallikasse, mis võib aega võtta sõltuvalt võrgu kiirusest.

• Kui esitamine on edukas, tühjendatakse atribuut Error (Tõrge), atribuudi ErrorKind väärtuseks seatakse ErrorKind.None ja käivitub valem OnSuccess (Edukas). Kui kasutaja lõi kirje (kui vorm oli režiimis New (Uus)), lülitub vorm ümber režiimile Edit (Redigeeri), et kasutaja saaks vastloodud kirjet või muud dokumenti redigeerida.
• Nurjunud esituse korral sisaldab atribuut Error (Tõrge) kasutajasõbralikku andmeallika tõrketeadet, mis probleemi selgitaks. Atribuut ErrorKind määratakse vastavalt probleemile ja käivitub OnFailure (Nurjunud) valem.

Teatud andmeallikad tuvastavad olukorra, kui kaks inimest püüavad sama kirjet samal ajal värskendada. Sel juhul määratakse ErrorKind (Tõrkelaadne) väärtuseks ErrorKind.Conflict. Lahenduseks on värskendada andmeallikas teise kasutaja muudatustega ja rakendada uuesti selle kasutaja tehtud muudatus.

Näpunäide

Kui vorm sisaldab nuppu Cancel (Tühista), et kasutaja saaks pooleliolevad muudatused hüljata, lisage nupu atribuudile OnSelect funktsioon ResetForm (Lähtesta vorm), isegi kui see atribuut sisaldab ekraanide muutmiseks ka funktsiooni Navigate (Navigeeri). Muul juhul säilitab vorm kasutaja muudatused.

Paigutus

Vaikimisi paigutatakse kaardid ühte veergu telefoni rakendustes ja kolme veergu tahvelarvuti rakendustes. Saate määrata, mitu veergu vormil on ja kas kaardid peaksid vormi konfigureerimisel neile kinnituma. Need sätted ei ole atribuutidena nähtaval, kuna neid kasutatakse ainult kaartide atribuutide X, Y ja Laius määratlemiseks.

Lisateavet leiate teemast Andmete vormi paigutuse mõistmine.

Põhiomadused

DataSource (Andmeallikas) – andmeallikas, mis sisaldab kirjet, mida kasutaja kuvab, redigeerib või loob.

• Kui te seda atribuuti ei määra, ei saa kasutaja kirjet kuvada, redigeerida ega luua ja täiendavad metaandmed ega valideerimine pole saadaval.

DefaultMode (Vaikerežiim) – vormi juhtelemendi algrežiim. Vaadake aktsepteeritavate väärtuste ja tähenduste kohta allpool kirjeldatud Mode-i (Režiim).

DisplayMode (Kuvarežiim) – režiim, mida kasutatakse andmete kaartide ja juhtelementide jaoks vormi juhtelemendis.

Tuletatud atribuudi Mode väärtusest ja seda ei saa sõltumatult määrata.

Režiim	Kuvarežiim	Kirjeldus
FormMode.Edit	DisplayMode.Edit	Andmete kaardid ja juhtelemendid on muudetavad, valmis kirje muudatuste aktsepteerimiseks.
FormMode.New	DisplayMode.Edit	Andmete kaardid ja juhtelemendid on muudetavad, uue kirje aktsepteerimiseks.
FormMode.View	DisplayMode.View	Andmete kaarte ja juhtelemente ei saa redigeerida ja optimeerida vaatamiseks.

Error (Tõrge) – kuvatud välja kasutajasõbralik vormi tõrketeade, kui funktsioon SubmitForm nurjub.

• See atribuut rakendub ainult juhtelemendile Edit form (Redigeeri vormi).
• See atribuut muutub ainult siis, kui SubmitForm (Esita vorm), EditForm (Redigeeri vorm) või ResetForm (Lähtesta vorm) funktsioon käivitub.
• Tõrke ilmnemisel on see atribuut tühija ErrorKind (Tõrkelaadne) on seatud ErrorKind.None.
• Võimalusel kuvatakse tagastatav tõrketeade kasutaja keeles. Mõned tõrketeated pärinevad otse andmeallikast ja need ei pruugi olla kasutaja keeles.

ErrorKind (Tõrkelaadne) – tõrkelaadne tõrge ilmub, kui tõrge esineb SubmitForm (Esita vorm) käivitumisel.

• Kehtib ainult juhtelemendi Edit form puhul.
• See atribuudil on sama loendus, nagu funktsioonil Errors (Tõrked). Juhtelement Edit form (Redigeeri vormi) tagastab järgmised väärtused.

ErrorKind (Tõrkelaadne)	Kirjeldus
ErrorKind.Conflict	Teine kasutaja muutis sama kirjet, mille tulemuseks on muudatuste vastuolu. Kirje uuesti laadimiseks käivitage funktsioon Refresh (Värskenda) ja proovige siis uuesti muuta.
ErrorKind.None	Tõrge on tundmatut tüüpi.
ErrorKind.Sync	Andmeallikas teatas tõrkest. Lisateavet leiate atribuudist Error (Tõrge).
ErrorKind.Validation	Tuvastati üldine valideerimise probleem.

Item (Üksus) – DataSource (Andmeallikas) kirje, mida kasutaja kuvab või redigeerib.

LastSubmit – viimane edukalt edastatud kirje, sh kõik serveri loodud väljad.

• See atribuut rakendub ainult juhtelemendile Edit form (Redigeeri vormi).
• Kui andmeallikas loob või arvutab automaatselt mis tahes väljad (nt ID väli kordumatu numbriga), siis atribuudil LastSubmit uus väärtus pärast SubmitForm (Esita vorm) edukat käivitamist.
• Selle atribuudi väärtus on saadaval OnSuccess (Edukas) valemis.

Mode (Režiim) – juhtelement on režiimis Edit (Redigeeri) või New (Uus).

Režiim	Kirjeldus
FormMode.Edit	Kasutaja saab kirjet vormi abil redigeerida. Vormi kaartide väärtused on eeltäidetud olemasoleva kirjega, et kasutaja saaks neid muuta. Olemasolevat kirjet muudetakse, kui funktsioon SubmitForm (Esita vorm) töötab edukalt.
FormMode.New	Kasutaja saab kirjet vormi abil luua. Vormi juhtelementide väärtused on eeltäidetud andmeallika kirje vaikimisi väärtustega. Kirje luuakse, kui funktsioon SubmitForm (Esita vorm) töötab edukalt.
FormMode.View	Kasutaja saab kirjet vormi abil kuvada. Vormi juhtelementide väärtused on eeltäidetud andmeallika kirje vaikimisi väärtustega.

Vorm lülitub režiimilt New (Uus) režiimi Edit (Redigeeri) kui esineb üks järgmistest muudatustest.

• Vormi esitamine on edukas ja kirje luuakse. Kui galerii on seatud automaatselt teisaldama valikut sellesse uude kirjesse, kuvatakse vorm režiimis Edit (Redigeeri), et kasutaja saaks teha täiendavaid muudatusi.
• Käivitub funktsioon EditForm (Redigeeri vormi).
• Käivitub funktsioon ResetForm (Lähtesta vorm). Näiteks võib kasutaja valida nupu Cancel (Tühista), mis on selle funktsiooniga konfigureeritud.

OnFailure – toimingud, mis sooritatakse juhul, kui andmetoiming on nurjunud.

• See atribuut rakendub ainult juhtelemendile Edit form (Redigeeri vormi).

OnReset – toimingud, mida sooritatakse vormi juhtelemendi Redigeeri vormi lähtestamisel.

• See atribuut rakendub ainult juhtelemendile Edit form (Redigeeri vormi).

OnSuccess – toimingud, mis sooritatakse juhul, kui andmetoiming on õnnestunud.

• See atribuut rakendub ainult juhtelemendile Edit form (Redigeeri vormi).

Unsaved (Salvestamata) – tõene, kui juhtelement Edit form (Redigeeri vormi) sisaldab kasutaja muudatusi, mida pole salvestatud.

• See atribuut rakendub ainult juhtelemendile Edit form (Redigeeri vormi).
• Selle atribuudi abil saate kasutajat hoiatada salvestamata muudatuste kaotamise eest. Kui soovite, et kasutaja ei saaks enne praeguse kirje muudatuste salvestamist valida juhtelemendis Gallery (Galerii) mõne muu kirje, seadke galerii atribuudi Disabled (Keelatud) väärtuseks Form.Unsaved ja keelake sarnaselt värskendamise toimingud.

Updates (Värskendused) – väärtused, mis tuleb vormi juhtelemendis laaditud kirje puhul andmeallikasse tagasi kirjutada.

• See atribuut rakendub ainult juhtelemendile Edit form (Redigeeri vormi).
• Seda atribuuti saate kasutada juhtelemendis olevate kaartide välja väärtuste eraldamiseks. Seejärel saate nende väärtuste abil käsitsi värskendada andmeallikat funktsiooniga Patch (Plaaster) või mõne muu ühendusega seotud meetodiga. Kui kasutate funktsiooni SubmitForm (Esita vorm), ei pea te seda atribuuti kasutama.
• See atribuut tagastab väärtuste kirje. Kui vormi juhtelement sisaldab näiteks kaardiväljade Name (Nimi) ja Quantity (Kogus) juhtelemente ning atribuudi Update (Värskenda) väärtused tagastavad vastavalt "Vidina" ja 10, siis vormi juhtelemendi atribuut Updates (Värskendused) tagastab { Name: "Widget", Quantity: 10 }.

Valid (Kehtiv) – kas Card (Kaart) või juhtelement Edit form (Redigeeri vormi) sisaldab sobivaid kirjeid, mis on valmis andmeallikasse esitamiseks.

• See atribuut rakendub ainult juhtelemendile Edit form (Redigeeri vormi).

• Juhtelemendi Vorm atribuut Valid (Kehtiv) koondab vormi kõikide juhtelementide Card atribuute Valid (Kehtiv). Vormi atribuut Valid (Kehtiv) on true (tõene) ainult juhul, kui kõigi selle vormi kaartide andmed kehtivad. Muul juhul on vormi atribuut Valid (Kehtiv) väärtuseks false (väär).

• Kui soovite, et nupp salvestaks muudatused ainult siis, kui vormi andmed on kehtivad, kuid pole veel esitatud, seadke nupu atribuut DisplayMode (Kuva režiim) sellele valemile.

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

Lisaatribuudid

BorderColor (Äärise värv) – juhtelemendi äärise värv.

BorderStyle (Äärise stiil) – kas juhtelemendi ääris on Solid (Tavaline), Dashed (Katkendlik joon), Dotted (Punktiirjoon) või None (Puudub).

BorderThickness (Äärise paksus) – juhtelemendi äärise paksus.

Fill (Taust) – juhtelemendi taustavärv.

Height (Kõrgus) – Juhtelemendi ülemiste ja alumiste servade vaheline kaugus.

Visible (Nähtav) – kas juhtelement on nähtav või peidetud.

Width (Laius) – vahemaa juhtelemendi vasaku ja parema serva vahel.

X – vahemaa juhtelemendi vasaku serva ja vanemkonteineri vasaku serva vahel (ekraan, kui vanemkonteinerit pole).

Y – vahemaa juhtelemendi ülemise serva ja vanemkonteineri ülemise serva vahel (ekraan, kui vanemkonteinerit pole).

Lisateave

• Põhjaliku ülevaate vormide töötamise kohta leiate jaotisest Andmevormide mõistmine.
• Power Fx Vaadake redigeerimisvormi valemiviidet.

Hõlbustusfunktsioonide suunised

Ekraanilugeja tugi

• Kaaluge vormile pealkirja lisamist kasutades juhtelementi Label (Silt).

Märkus

Kas saaksite meile dokumentatsiooniga seotud keele-eelistustest teada anda? Osalege lühikeses uuringus. (Uuring on ingliskeelne.)

Uuringus osalemine võtab umbes seitse minutit. Isikuandmeid ei koguta (privaatsusavaldus).