„Power Apps“ formos redagavimo ir formos rodymo valdikliai
Rodykite, redaguokite ir kurkite įrašą duomenų šaltinyje.
Aprašas
Jei įtrauksite Formos rodymo valdiklį, vartotojas galės rodyti visus įrašo laukus arba tik jūsų nurodytus laukus. Jei įtrauksite Formos redagavimo valdiklį, vartotojas galės redaguoti tuos laukus, kurti įrašą ir įrašyti pakeitimus į duomenų šaltinį.
Jei įtrauksite Gallery valdiklį, jį galėsite sukonfigūruoti taip, kad būtų rodoma duomenų šaltinio lentelė, o tada galėsite sukonfigūruoti formą, kad būtų rodomas bet kuris įrašas, kurį vartotojas pasirinks galerijoje. Taip pat galite įtraukti vieną ar daugiau Button valdiklių, kuriuos vartotojas galės pasirinkti norėdamas įrašyti redagavimus, juos atšaukti ir kurti įrašą. Valdiklius naudodami kartu galite sukurti visapusišką sprendimą.
Apribojimai
Formos valdiklis turi šiuos apribojimus:
- Negalite kopijuoti ir įklijuoti formų į duomenų korteles. Taip siekiama išvengti tam tikrų valdiklių derinių, kurie kelia pavojų programos stabilumui ir našumui.
Įrašo pasirinkimas
Bet kurio tipo formos ypatybę DataSource nustatykite į įrašų lentelę, o formos ypatybę Elementas nustatykite taip, kad būtų rodomas konkretus tos lentelės įrašas. Pavyzdžiui, formos ypatybę Elementas galite nustatyti į Gallery valdiklio ypatybę SelectedItem. Kai vartotojas galerijoje pasirinks įrašą, tas pats įrašas bus rodomas formoje, tačiau formoje gali būti rodoma daugiau laukų. Vartotojui grįžus į galeriją ir pasirinkus kitą įrašą galerijos ypatybė SelectedItem pasikeis. Šis pakeitimas atnaujina formos ypatybę Elementas, o formoje tada rodomas naujai pasirinktas įrašas.
Formos ypatybę Elementas taip pat galite nustatyti naudodami Išplečiamąjį valdiklį, kaip aprašyta straipsnyje Įrašo rodymas, redagavimas arba įtraukimas, arba funkciją, pvz., Peržvalga arba Pirmas. Pavyzdžiui, galite nustatyti elemento ypatybę į bet kurią iš šių formulės, kad būtų rodomas „Fabrikam" įrašas abonementų lentelėje „Microsoft Dataverse“:
First(Accounts)
Lookup(Accounts, "Fabrikam" in name)
Kiekviename formos valdiklyje yra vienas ar daugiau Card valdiklių. Nustatydami kortelės ypatybę DataField nurodote, koks laukas rodomas toje kortelėje, ir kitą išsamią informaciją.
Įrašo sukūrimas
Kai nustatytas Formos redagavimo valdiklio Redagavimo režimas, vartotojas gali atnaujinti įrašą, nurodytą formos ypatybėje Elementas. Patikrinus ypatybė Režimas grąžinama į Redagavimas.
Tačiau kai nustatytas Formos redagavimo valdiklio režimas Naujas, ypatybės Elementas nepaisoma. Formoje esamas įrašas nerodomas; vietoj to kiekvieno lauko reikšmės atitinka duomenų šaltinio, su kuriuo sukonfigūravote formą, numatytosios reikšmės. Forma į šį režimą perjungiama naudojant funkciją NewForm.
Pavyzdžiui, mygtuko ypatybę Tekstas galite nustatyti taip, kad būtų rodomas Naujas, o jo ypatybę OnSelect nustatyti į formulę, kurioje yra funkcija NewForm. Jei vartotojas pasirenka tą mygtuką, forma perjungiama į režimą Naujas, kad vartotojas galėtų kurti įrašą pradėdamas nuo žinomų reikšmių.
Forma vėl perjungiama į režimą Redagavimas, jei įvykdoma funkcija ResetForm arba sėkmingai įvykdoma funkcija SubmitForm.
- Mygtuko ypatybę Tekstas galite nustatyti taip, kad būtų rodoma Atšaukti, o jo ypatybę OnSelect nustatyti į formulę, kurioje yra funkcija ResetForm. Jei vartotojas pasirenka tą mygtuką, visi vykdomi pakeitimai atmetami, o formos reikšmės vėl atitinka duomenų šaltinio numatytąsias reikšmes.
- Mygtuko ypatybę Tekstas galite nustatyti taip, kad būtų rodoma Įrašyti pakeitimus, o jo ypatybę OnSelect nustatyti į formulę, kurioje yra funkcija SubmitForm. Jei vartotojas pasirenka tą mygtuką ir duomenų šaltinis yra atnaujintas, formos reikšmės iš naujo nustatomos į duomenų šaltinio numatytąsias reikšmes.
Įrašyti keitimus
Jei sukūrėte mygtuką Įrašyti pakeitimus, kaip aprašyta ankstesniame skyriuje, vartotojas gali sukurti arba atnaujinti įrašą, o tada pasirinkti tą mygtuką, kad tie pakeitimai būtų įrašyti į duomenų šaltinį. Be to, galite sukonfigūruoti Image valdiklį arba kurį nors kitą valdiklį, kad jis atliktų tą pačią užduotį, su sąlyga, kad tą valdiklį sukonfigūruosite su funkcija SubmitForm. Bet kuriuo atveju ypatybės Error, ErrorKind, OnSuccess ir OnFailure reikia atsiliepimus apie rezultatą.
Vykdant funkciją SubmitForm pirmiausia patikrinami duomenys, kuriuos nori pateikti vartotojas. Jei būtiname lauke nėra reikšmės arba kita reikšmė neatitinka kurio nors kito apribojimo, nustatomos ypatybės ErrorKind ir vykdoma formulė OnFailure. Mygtuką Įrašyti pakeitimus arba kitą valdiklį galite sukonfigūruoti taip, kad vartotojas jį galėtų pasirinkti tik tuo atveju, jei duomenys yra tinkami (t. y., jei formos ypatybė Tinkamas yra true). Atminkite, kad vartotojas turi ne tik ištaisyti problemą, bet ir dar kartą pasirinkti mygtuką įrašyti pakeitimus (arba pakeitimus atmesti pasirinkdamas mygtuką Atšaukti, kaip aprašyta anksčiau), kad ypatybės Error ir ErrorKind būtų nustatytos iš naujo.
Jei duomenys sėkmingai patikrinami, funkcija SubmitForm juos siunčia į duomenų šaltinį; priklausomai nuo tinklo gaišties šis procesas gali užtrukti.
- Jei duomenis pavyksta pateikti, ypatybė Klaida išvaloma, ypatybė ErrorKind nustatoma į ErrorKind.None ir vykdoma OnSuccess formulė. Jei vartotojas sukūrė įrašą (t. y. jei prieš tai forma buvo režime Naujas), forma perjungiama į režimą Redaguoti, kad vartotojas galėtų redaguoti naujai sukurtą įrašą arba kitą įrašą.
- Jei pateikti nepavyksta, ypatybėje Klaida iš duomenų šaltinio pateikiamas vartotojui suprantamas klaidos pranešimas, kuriame paaiškinama problema. Priklausomai nuo problemos atitinkamai nustatoma ypatybė ErrorKind ir vykdoma OnFailure formulė.
Kai kurie duomenų šaltiniai gali aptikti, kai du asmenys tuo pačiu metu bando atnaujinti tą patį įrašą. Šiuo atveju ypatybė ErrorKind nustatoma į ErrorKind.Conflict, o duomenų šaltinį su kito vartotojo pakeitimais reikia atnaujinti ir iš naujo taikyti šio vartotojo atliktus pakeitimus.
Patarimas
Jei į savo formą įtraukėte mygtuką Atšaukti, kad vartotojas galėtų atsisakyti atliekamų pakeitimų, į mygtuko ypatybę OnSelect įtraukite funkciją ResetForm, net jei toje ypatybėje taip pat yra funkcija Naršyti, skirta ekranams keisti. Priešingu atveju vartotojo pakeitimai išliks formoje.
Maketas
Pagal numatytuosius nustatymus telefono programose kortelės pateikiamos viename stulpelyje, o planšetinio kompiuterio programose – trijuose stulpeliuose. Galite nurodyti, kiek stulpelių turi būti formoje, ir nurodyti, ar konfigūruojant formą kortelės turėtų būti į juos perkeliamos. Šie parametrai nerodomi kaip ypatybės, nes jie naudojami tik kortelių ypatybėms X, Y ir Plotis nustatyti.
Norėdami gauti daugiau informacijos, žr. Duomenų formos maketo supratimas.
Pagrindinės ypatybės
Duomenų šaltinis – duomenų šaltinis, kuriame yra įrašas, kurį vartotojas rodys, redaguos arba sukurs.
- Jei šios ypatybės nenustatysite, vartotojas negalės rodyti, redaguoti arba kurti įrašo, ir nebus teikiama jokių papildomų metaduomenų ar tikrinimo.
DefaultMode – pradinis formos valdiklio režimas. Priimtinas reikšmes ir jų reikšmę žr. toliau pateiktame Režimo apraše.
DisplayMode – režimas, skirtas duomenų kortelėms ir valdikliams formos valdiklyje.
Gaunamas iš ypatybės Režimas ir jo negalima nustatyti atskirai:
| Režimas | DisplayMode | Aprašas |
|---|---|---|
| FormMode.Edit | DisplayMode.Edit | Duomenų kortelės ir valdikliai gali būti redaguojami, pasirengę priimti įrašo pakeitimus. |
| FormMode.New | DisplayMode.Edit | Duomenų kortelės ir valdikliai gali būti redaguojami, pasirengę priimti naują įrašą. |
| FormMode.View | DisplayMode.View | Duomenų kortelės ir valdikliai negali būti redaguojami ir yra optimizuoti peržiūrai. |
Klaida – vartotojui suprantamas klaidos pranešimas, rodomas šioje formoje, kai neveikia funkcija Submitform.
- Ši ypatybė taikoma tik Formos redagavimo valdikliui.
- Ši ypatybė pasikeičia tik vykdant funkciją SubmitForm, EditForm arba ResetForm.
- Jei neįvyko jokia klaida, ši ypatybė yra tuščia, o ypatybė ErrorKind nustatoma į ErrorKind.None.
- Kai įmanoma, klaidos pranešimas bus pateiktas vartotojo kalba. Kai kurie klaidų pranešimai gaunami tiesiogiai iš duomenų šaltinio ir gali būti pateikiami ne vartotojo kalba.
ErrorKind – jei vykdant SubmitForm įvyksta klaida, nurodo įvykusios klaidos tipą.
- Taikoma tik Formos redagavimo valdikliui.
- Šios ypatybės išvardijimas yra toks pats, kaip funkcijos Klaidos. Formos redagavimo valdiklis gali grąžinti šias reikšmes:
| ErrorKind | Aprašas |
|---|---|
| ErrorKind.Conflict | Kitas vartotojas pakeitė tą patį įrašą, todėl atsirado keitimo konfliktas. Vykdykite funkciją Atnaujinti, kad iš naujo įkeltumėte įrašą, ir bandykite keisti dar kartą. |
| ErrorKind.None | Klaidos tipas nežinomas. |
| ErrorKind.Sync | Duomenų šaltinis pranešė apie klaidą. Daugiau informacijos rasite ypatybėje Klaida. |
| ErrorKind.Validation | Aptikta bendra tikrinimo problema. |
Elementas – DataSource įrašas, kurį vartotojas rodys arba redaguos.
LastSubmit – paskutinis sėkmingai pateiktas įrašas, įskaitant serverio sugeneruotus laukus.
- Ši ypatybė taikoma tik Formos redagavimo valdikliui.
- Jei duomenų šaltinis automatiškai sugeneruoja arba apskaičiuoja kokius nors laukus, pvz., lauką ID su unikaliu skaičiumi, sėkmingai įvykdžius SubmitForm ypatybė LastSubmit bus nustatytą į šią naują reikšmę.
- Šios ypatybės reikšmė pateikiama OnSuccess formulėje.
Režimas – valdiklis veikia režimu Redagavimas arba Naujas.
| Režimas | Aprašas |
|---|---|
| FormMode.Edit | Vartotojas gali redaguoti įrašą naudodamas formą. Formos kortelių reikšmės iš anksto užpildomos esamu įrašu, kad vartotojas galėtų keisti. Jei sėkmingai įvykdoma funkcija SubmitForm, esamas įrašas modifikuojamas. |
| FormMode.New | Vartotojas gali kurti įrašą naudodamas formą. Formos valdiklių reikšmės iš anksto užpildomos duomenų šaltinio įrašo numatytosiomis reikšmėmis. Jei sėkmingai įvykdoma funkcija SubmitForm, sukuriamas įrašas. |
| FormMode.View | Vartotojas gali peržiūrėti įrašą naudodamas formą. Formos valdiklių reikšmės iš anksto užpildomos duomenų šaltinio įrašo numatytosiomis reikšmėmis. |
Forma iš režimo Naujas perjungiama į režimą Redagavimas, kai įvyksta kuris nors iš šių pakeitimų:
- Forma sėkmingai pateikta ir sukurtas įrašas. Jei galerijoje nustatyta, kad pasirinkimas automatiškai perkeliamas į šį naują įrašą, sukurto įrašo forma veiks režimu Redagavimas, kad vartotojas galėtų atlikti papildomų keitimų.
- Vykdoma funkcija EditForm.
- Vykdoma funkcija ResetForm. Pavyzdžiui, vartotojas gali pasirinkti su šia funkcija sukonfigūruotą mygtuką Atšaukti.
OnFailure – veiksmai, kuriuos reikia atlikti nesėkmingai atlikus duomenų operaciją.
- Ši ypatybė taikoma tik Formos redagavimo valdikliui.
OnReset – veiksmai, kuriuos reikia atlikti, kai valdiklis Redaguoti formą nustatomas iš naujo.
- Ši ypatybė taikoma tik Formos redagavimo valdikliui.
OnSuccess – veiksmai, kuriuos reikia atlikti sėkmingai atlikus duomenų operaciją.
- Ši ypatybė taikoma tik Formos redagavimo valdikliui.
Neįrašyta – „true“, jei Formos redagavimo valdiklyje yra neįrašytų vartotojo pakeitimų.
- Ši ypatybė taikoma tik Formos redagavimo valdikliui.
- Naudodami šią ypatybę galite įspėti vartotoją, kad jis neprarastų bet kokių neįrašytų pakeitimų. Kad vartotojas negalėtų pasirinkti kito Gallery valdiklio įrašo prieš įrašydamas esamos įrašo pakeitimus, galerijos ypatybę Išjungtas nustatykite į Form.Unsaved ir taip pat išjunkite atnaujinimo operacijas.
Naujinimai – reikšmės, kurios turi būti įrašomos į formos valdiklyje įkelto įrašo duomenų šaltinį.
- Ši ypatybė taikoma tik Formos redagavimo valdikliui.
- Naudodami šią ypatybę galite išskleisti valdiklyje esančių kortelių laukų reikšmes. Tada naudodami šias reikšmes galite rankiniu būdu atnaujinti duomenų šaltinį iškviesdami funkciją Pataisa arba kitu ryšio rodomu būdu. Šios ypatybės naudoti nereikia, jei naudojate funkciją SubmitForm.
- Ši ypatybė pateikia reikšmių įrašą. Pavyzdžiui, jei formos valdiklyje yra laukų Pavadinimas ir Kiekis kortelės valdiklių, o šių kortelių ypatybės Update reikšmės atitinkamai pateikia „grafinės sąsajos elementas“ ir 10, tada formos valdiklio ypatybė Atnaujinimas pateiks {Pavadinimas: „grafinės sąsajos elementas“, kiekis: 10}.
Tinkamas – ar Card arba Formos redagavimo valdiklyje yra tinkamų įrašų, paruoštų pateikti į duomenų šaltinį.
Ši ypatybė taikoma tik Formos redagavimo valdikliui.
Formos valdiklio ypatybė Tinkamas agreguoja visų formos Card valdiklių ypatybes Tinkamas. Formos ypatybė Tinkamas yra true tik tuo atveju, kai visų tos formos kortelių duomenys yra tinkami; priešingu atveju formos ypatybė Tinkamas yra false.
Norėdami įjungti mygtuką, skirtą pakeitimams įrašyti tik tuo atveju, kai formos duomenys yra tinkami, bet dar nepateikti, mygtuko ypatybę DisplayMode nustatykite į šią formulę:
SubmitButton.DisplayMode = If(IsBlank( Form.Error ) || Form.Valid, DisplayMode.Edit, DisplayMode.Disabled)
Papildomos ypatybės
BorderColor – valdiklio kraštinės spalva.
BorderStyle – ar valdiklio kraštinė yra Vientisa, Punktyrinė, Taškinė, ar Nėra.
BorderThickness – valdiklio kraštinės storis.
Užpildyti – valdiklio fono spalva.
Aukštis – atstumas tarp valdiklio viršutinių ir apatinių kraštų.
Matomas – ar valdiklis rodomas, ar paslėptas.
Plotis – atstumas tarp valdiklio kairiojo ir dešinio kraštų.
X – atstumas nuo kairiojo valdiklio krašto iki kairiojo jo pirminės talpyklės krašto (ekrano, jei nėra pirminės talpyklės).
Y – atstumas nuo viršutinio valdiklio krašto iki viršutinio jo pirminės talpyklės krašto (ekrano, jei nėra pirminės talpyklės).
Daugiau informacijos
- Išsamią apžvalgą apie tai, kaip veikia formos, žr. Kaip suprasti duomenų formas.
- Power Fx Peržiūrėkite EditForm formulės nuorodą.
Pritaikymo neįgaliesiems gairės
Ekrano skaitytuvo palaikymas
- Į formą galite įtraukti antraštę naudodami valdiklį Label.
Pastaba
Ar galite mums pranešti apie dokumentacijos kalbos nuostatas? Atlikite trumpą apklausą. (atkreipkite dėmesį, kad ši apklausa yra anglų kalba)
Apklausą atliksite per maždaug septynias minutes. Asmeniniai duomenys nėra renkami (privatumo nuostatos).