Vadīklas Rediģēt veidlapu un Parādīt veidlapu programmā Power Apps
Attēlojiet, rediģējiet un izveidojiet ierakstu datu avotā.
Apraksts
Ja pievienojat vadīklu Parādīt veidlapu, lietotājs var parādīt visus ieraksta laukus vai tikai norādītos laukus. Ja pievienojat vadīklu Rediģēt, lietotājs var rediģēt šos laukus, izveidot ierakstu un saglabāt šīs izmaiņas datu avotā.
Ja pievienojat vadīklu Gallery, varat to konfigurēt, lai parādītu tabulu datu avotā, un pēc tam konfigurēt veidlapu, lai parādītu, kuru ierakstu lietotājs atlasa galerijā. Varat arī pievienot vienu vai vairākas Button vadīklas, kuras lietotājs var atlasīt, lai saglabātu rediģējumus, atceltu rediģējumus un izveidotu ierakstu. Izmantojot vadīklas kopā, var izveidot pilnīgu risinājumu.
Ierobežojumi
Veidlapas vadīklai ir šādi ierobežojumi:
- Veidlapas nevar kopēt un ielīmēt datu Kartes. Tas tiek darīts, lai novērstu noteiktu vadīklu kombināciju izveidi, kas apdraud lietotnes stabilitāti un veiktspēju.
Ierakstu atlase
Jebkuram veidlapas tipam varat iestatīt tās rekvizītu Datu avots ar ierakstu tabulu, un jūs iestatāt veidlapas rekvizītu Elements, lai parādītu noteiktu šīs tabulas ierakstu. Piemēram, varat iestatīt veidlapas rekvizītu Elements kā vadīklas Gallery rekvizītu SelectedItem. Kad lietotājs atlasa ierakstu galerijā, šis pats ieraksts tiek parādīts veidlapā, izņemot to, ka veidlapā var tikt rādīts vairāk lauku. Ja lietotājs atgriežas galerijā un atlasa citu ierakstu, galerijas rekvizīts SelectedItem tiek mainīts. Šīs izmaiņas atjaunina veidlapas rekvizītu Elements, kas pēc tam rāda tikko atlasīto ierakstu.
Veidlapas rekvizītu Elements var iestatīt arī, izmantojot nolaižamo vadīklu, piemēram, kā aprakstīts sadaļā Ieraksta rādīšana, rediģēšana vai pievienošana, vai funkciju, piemēram, Uzmeklēšana vai Pirmais. Piemēram, rekvizītu Elements var iestatīt uz kādu no šīm formulām, lai tabulas Uzņēmumi sadaļā Uzņēmumi tiktu rādīts Fabrikam ieraksts Microsoft Dataverse:
First(Accounts)
Lookup(Accounts, "Fabrikam" in name)
Katrā veidlapas vadīklā ir viena vai vairākas vadīklas Card. Iestatot kartes rekvizītu DataField, tiek norādīts, kurai kolonnai tiek rādīta karte un citas detaļas.
Ieraksta izveide
Ja vadīkla Rediģēt veidlapu ir rediģēšanas režīmā, lietotājs var atjaunināt ierakstu, kas norādīts veidlapas rekvizītā Elements. Veicot pārbaudi, rekvizīts Režīms atgriež Rediģēt.
Ja vadīkla Rediģēt veidlapu ir režīmā Jauns, tomēr rekvizīts Elements tiek ignorēts. Veilapā nav redzams esošs ieraksts; tā vietā katras kolonnas vērtības atbilst tā datu avota noklusējuma vērtībām, ar kuru ir konfigurēta veidlapa. Funkcija NewForm liek veidlapai pārslēgties uz šo režīmu.
Piemēram, varat iestatīt poga rekvizītu Teksts, lai parādītu Jauns un tās formulas rekvizītu OnSelect, kurā ir iekļauta funkcija NewForm. Ja lietotājs atlasa šo pogu, veidlapa pārslēdzas uz režīmu Jauns, lai lietotājs varētu izveidot ierakstu, kas sākas ar zināmajām vērtībām.
Veidlapa pārslēdzas atpakaļ uz režīmu Rediģēt, ja veiksmīgi tiek izpildīta funkcija ResetForm vai SubmitForm.
- Varat iestatīt pogas rekvizītu Teksts, lai parādītu Atcelt un tā rekvizītu OnSelect uz formulu, kurā ir iekļauta funkcija ResetForm. Ja lietotājs atlasa šo pogu, visas notiekošās izmaiņas tiek atmestas, un veidlapas vērtības atkal atbilst datu avota noklusējuma vērtībām.
- Varat iestatīt pogas rekvizītu Teksts, lai parādītu Save changes un tā rekvizītu OnSelect uz formulu, kurā ir iekļauta funkcija SubmitForm. Ja lietotājs atlasa šo pogu un tiek atjaunināts datu avots, veidlapas vērtības tiek atiestatītas uz datu avota noklusējuma vērtībām.
Saglabāt izmaiņas
Ja tiek izveidota poga Saglabāt izmaiņas, kā aprakstīts iepriekšējā sadaļā, lietotājs var izveidot vai atjaunināt ierakstu un pēc tam atlasīt šo pogu, lai šīs izmaiņas saglabātu datu avotā. Tā vietā varat konfigurēt vadīklu Image vai kādu citu vadīklu, lai veiktu to pašu uzdevumu, ja vien konfigurējat šo vadīklu ar funkciju SubmitForm. Jebkurā gadījumā rekvizīti Kļūda, ErrorKind, OnSuccessun OnFailure sniedz atsauksmes par rezultātu.
Kad tiek izpildīta funkcija SubmitForm, tā vispirms validē datus, ko lietotājs vēlas iesniegt. Ja obligātajā kolonnā nav vērtības vai cita vērtība neatbilst kādam citam ierobežojumam, rekvizīti ErrorKind tiek iestatīti, un tiek izpildīta formula OnFailure. Varat konfigurēt pogu Saglabāt izmaiņas vai citu vadīklu, lai lietotājs to varētu atlasīt tikai tad, ja dati ir derīgi (tas ir, ja veidlapas rekvizīts Derīgs ir true). Ņemiet vērā, ka lietotājam ir ne tikai jānovērš problēma, bet arī vēlreiz jāatlasa poga Saglabāt izmaiņas (vai jāatmet izmaiņas, atlasot pogu Atcelt, kā aprakstīts iepriekš), lai atiestatītu rekvizītus Kļūda un ErrorKind.
Ja dati iziet validāciju, SubmitForm nosūta to uz datu avotu, kas var aizņemt noteiktu laiku atkarībā no tīkla latentuma.
- Ja iesniegums ir sekmīgs, rekvizīts Kļūda tiek notīrīts, rekvizīts ErrorKind tiek iestatīts uz ErrorKind.None un tiek izpildīta formula OnSuccess. Ja lietotājs izveidoja ierakstu (tas ir, ja veidlapa iepriekš bija režīmā Jauns ), veidlapa tiek pārslēgta uz rediģēšanas režīmu, lai lietotājs varētu rediģēt tikko izveidoto ierakstu vai citu ierakstu.
- Ja iesniegums neizdodas, rekvizītā Kļūda tiek iekļauts lietotājam draudzīgs kļūdas ziņojums no datu avota, kurā izskaidrota problēma. Rekvizīts ErrorKind tiek atbilstoši iestatīts atkarībā no problēmas, un formula OnFailure tiek palaista.
Daži datu avoti var noteikt, kad divi cilvēki vienlaicīgi mēģina atjaunināt vienu ieraksta daļu. Šādā gadījumā ErrorKind tiek iestatīts uz ErrorKind. Conflict, un risinājums ir atsvaidzināt datu avotu ar otra lietotāja izmaiņām un atkārtoti lietot šī lietotāja veiktās izmaiņas.
Padoms
Ja veidlapā piedāvājat pogu Atcelt, lai lietotājs varētu atcelt notiekošās izmaiņas, pievienojiet funkciju ResetForm uz pogas rekvizītu OnSelect, pat ja šajā rekvizītā ir ietverta arī funkcija Navigācija, lai mainītu ekrānus. Pretējā gadījumā veidlapa saglabās lietotāja izmaiņas.
Izkārtojums
Pēc noklusējuma kārtis tiek ievietotas vienā kolonnā tālruņa programmām un trīs kolonnās planšetdatora programmām. Konfigurējot veidlapu, var norādīt, cik daudz kolonnu ir veidlapā un vai pie tām ir jāpiesprauž kartītes. Šie iestatījumi netiek parādīti kā rekvizīti, jo tie tiek izmantoti tikai, lai iestatītu kartīšu rekvizītus X, Y un Platums.
Papildinformāciju skatiet tēmā Datu veidlapas izkārtojuma izprašana.
Atslēgas rekvizīti
DataSource — datu avots, kurā iekļauts ieraksts, ko lietotājs rādīs, rediģēs vai izveidos.
- Ja šis rekvizīts netiek iestatīts, lietotājs nevar parādīt, rediģēt vai izveidot ierakstu, kā arī netiek nodrošināti papildu metadati vai validācija.
DefaultMode — Veidlapas vadīklas sākotnējais režīms. Tālāk skatiet režīma aprakstu pieņemamajām vērtībām un to nozīmi.
DisplayMode — Režīms, ko izmanto datu kartītēm un vadīklām veidlapas vadīklā.
Atvasināts no rekvizīta Režīms un to nevar iestatīt atsevišķi:
Režīms | DisplayMode | Apraksts |
---|---|---|
FormMode.Edit | DisplayMode.Edit | Datu kartītes un vadīklas ir rediģējamas, sagatavotas ieraksta izmaiņu apstiprināšanai. |
FormMode.New | DisplayMode.Edit | Datu kartītes un vadīklas ir rediģējamas, sagatavotas jauna ieraksta apstiprināšanai. |
FormMode.View | DisplayMode.View | Datu kartītes un vadīklas nav rediģējamas un optimizētas skatīšanai. |
Kļūda — lietotājam draudzīgs kļūdas ziņojums, kas jārāda šai veidlapai, kad funkcija SubmitForm neizdodas.
- Šis rekvizīts tiek lietots tikai vadīklā Rediģēt veidlapu.
- Šis rekvizīts tiek mainīts tikai tad, ja tiek izpildīta funkcija SubmitForm, EditFormvai ResetForm.
- Ja kļūdas nerodas, šis rekvizīts ir tukšs un ErrorKind ir iestatīts uz ErrorKind.None.
- Ja iespējams, kļūdas ziņojums, kas tiek atgriezts, būs lietotāja valodā. Daži kļūdu ziņojumi ir tieši no datu avota, un tie var nebūt lietotāja valodā.
ErrorKind — Radušās kļūdas veids, ja rodas kļūda, kamēr SubmitForm darbojas.
- Attiecas tikai uz vadīklu Rediģēt veidlapu.
- Šim rekvizītam ir tāds pats uzskaitījums kā funkcijai Kļūdas. Vadīkla Rediģēt veidlapu var atgriezt šādas vērtības:
ErrorKind | Apraksts |
---|---|
ErrorKind.Conflict | Cits lietotājs mainīja to pašu ieraksta, kā rezultātā rodas izmaiņu konflikts. Izpildiet funkciju Atsvaidzināt, lai atkārtoti ielādētu ierakstu, un vēlreiz mēģiniet veikt izmaiņas. |
ErrorKind.None | Kļūda ir nezināma tipa kļūda. |
ErrorKind.Sync | Datu avots ziņoja par kļūdu. Papildinformāciju skatiet rekvizītā Kļūda. |
ErrorKind.Validation | Tika atklāta vispārēja validācijas problēma. |
Elements — ieraksts laukā DataSource, ko lietotājs rādīs vai rediģēs.
LastSubmit — Pēdējais veiksmīgi iesniegtais ieraksts, ieskaitot servera ģenerētās kolonnas.
- Šis rekvizīts tiek lietots tikai vadīklā Rediģēt veidlapu.
- Ja datu avots automātiski ģenerē vai aprēķina jebkādus laukus, piemēram, lauku ID ar unikālu numuru, rekvizītam LastSubmit būs šī jaunā vērtība pēc SubmitForm sekmīgas izpildes.
- Šī rekvizīta vērtība ir rādīta formulā OnSuccess.
Vadīkla Režīms — vadīkla ir režīmā Rediģēt vai Jauns.
Režīms | Apraksts |
---|---|
FormMode.Edit | Lietotājs var rediģēt ierakstus, izmantojot veidlapu. Vērtības veidlapas kartiņās ir iepriekš aizpildītas ar esošu ierakstu, ko lietotājs var mainīt. Ja funkcija SubmitForm ir sekmīgi izpildīta, tiek modificēts esošs ieraksts. |
FormMode.New | Lietotājs var izveidot ierakstus, izmantojot veidlapu. Vērtības veidlapas vadīklās ir iepriekš aizpildītas ar datu ieraksta noklusējuma vērtībām. Ja funkcija SubmitForm ir sekmīgi izpildīta, tiek izveidots ieraksts. |
FormMode.View | Lietotājs var skatīt ierakstus, izmantojot veidlapu. Vērtības veidlapas vadīklās ir iepriekš aizpildītas ar datu ieraksta noklusējuma vērtībām. |
Veidlapa pārslēdzas no režīma Jauns uz režīmu Rediģēt, kad rodas kāda no šīm izmaiņām:
- Veidlapa ir iesniegta veiksmīgi, un ir izveidots ieraksts. Ja galerija ir iestatīta, lai automātiski pārvietotu atlasi uz šo jauno ierakstu, veidlapa būs pieejama režīmā Rediģēt izveidotajam ierakstam, lai lietotājs varētu veikt papildu izmaiņas.
- Tiek palaista funkcija EditForm.
- Tiek palaista funkcija ResetForm. Piemēram, lietotājs var atlasīt pogu Atcelt, kas ir konfigurēta ar šo funkciju.
OnFailune — darbības, kas jāveic, kad datu operācija ir bijusi nesekmīga.
- Šis rekvizīts tiek lietots tikai vadīklā Rediģēt veidlapu.
OnReset — darbības, kas jāveic, kad vadīkla Rediģēt veidlapu tiek atiestatīta.
- Šis rekvizīts tiek lietots tikai vadīklā Rediģēt veidlapu.
OnSuccess — darbības, kas jāveic, kad datu operācija ir bijusi sekmīga.
- Šis rekvizīts tiek lietots tikai vadīklā Rediģēt veidlapu.
Nesaglabāts — Patiess, ja vadīkla Rediģēt veidlapu satur lietotāja veiktās izmaiņas, kas nav saglabātas.
- Šis rekvizīts tiek lietots tikai vadīklā Rediģēt veidlapu.
- Izmantojiet šo rekvizītu, lai brīdinātu lietotāju pirms visu nesaglabāto izmaiņu zaudēšanas. Lai neļautu lietotājam izvēlēties citu ierakstu vadīklā Gallery pirms izmaiņu saglabāšanas pašreizējā ierakstā, iestatiet galerijas rekvizītu Atspējots kā Form.Unsaved un līdzīgā veidā atspējojiet atsvaidzināšanas operācijas.
Atjauninājumi — Vērtības, kas jāieraksta atpakaļ veidlapā ielādētā ieraksta vadīklas datu avotā.
- Šis rekvizīts tiek lietots tikai vadīklā Rediģēt veidlapu.
- Izmantojiet šo rekvizītu, lai vadīklā izvilktu lauku vērtības no kartītēm. Šīs vērtības var izmantot, lai manuāli atjauninātu datu avotu ar funkcijas Ielāps izsaukumu vai citu metodi, kas ir pakļauta savienojumam. Šī rekvizīts nav jāizmanto, ja lietojat funkciju SubmitForm.
- Šis rekvizīts atgriež vērtību reģistru. Piemēram, ja veidlapas vadīklā ir kartītes vadīklas laukiem Nosaukums un Daudzums un šo kartīšu rekvizītu Update vērtības atgriež “Logrīks” un 10, tad veidlapas vadīklas rekvizīts Atjauninājumi atgriež { Nosaukums: “Logrīks”, Daudzums: 10 }.
Derīgs — vai vadīklas Card vai Rediģēt veidlapu satur derīgus ierakstus, kas ir gatavi iesniegšanai datu avotā.
Šis rekvizīts tiek lietots tikai vadīklā Rediģēt veidlapu.
Vadīklas Veidlapa rekvizīts Derīgs apkopo rekvizītus Derīgs no visām vadīklām Card veidlapā. Veidlapas rekvizīts Derīgs ir true tikai tad, ja dati visās šīs veidlapas kartītēs ir derīgi. Pretējā gadījumā veidlapas rekvizīts Derīgs ir false.
Lai iespējotu pogu un saglabātu izmaiņas tikai tad, ja veidlapas dati ir derīgi, bet vēl nav iesniegti, iestatiet pogas rekvizītu DisplayMode ar šādu formulu:
SubmitButton.DisplayMode = If(IsBlank( Form.Error ) || Form.Valid, DisplayMode.Edit, DisplayMode.Disabled)
Papildu rekvizīti
BorderColor — Vadīklas apmales krāsa.
BorderStyle — Vai vadīklas apmale ir Necaurspīdīga, Svītrota, Punktota vai Nav.
BorderThickness — Vadīklas apmales biezums.
Aizpildījums — Vadīklas fona krāsa.
Augstums — Attālums starp vadīklas augšu un šīs vadīklas apakšējo malu.
Redzama — Vai vadīkla ir redzama vai paslēpta.
Platums — Attālums starp vadīklas kreiso un šīs vadīklas labo malu.
X – Attālums starp vadīklas kreiso malu un tās primārā konteinera kreiso malu (vai ekrānu, ja nav primārā konteinera).
Y — Attālums starp vadīklas augšējo malu un tās primārā konteinera augšējo malu (vai ekrānu, ja nav primārā konteinera).
Papildinformācija
- Lai iegūtu visaptverošu pārskatu par to, kā darbojas veidlapas, skatiet rakstu Datu veidlapu izprašana.
- Skatiet formulas Power Fx atsauci uz EditForm.
Pieejamības vadlīnijas
Ekrāna lasītāja atbalsts
- Apsveriet iespēju pievienot virsrakstu veidlapai, izmantojot Label.
Piezīme
Kādas ir jūsu dokumentācijas valodas preferences? Aizpildiet īsu aptauju. (ņemiet vērā, ka aptauja ir angļu valodā)
Aptaujai būs nepieciešamas aptuveni septiņas minūtes. Nekādi personas dati netiks vākti (paziņojums par konfidencialitāti).
Atsauksmes
https://aka.ms/ContentUserFeedback.
Drīzumā: 2024. gada laikā mēs pakāpeniski pārtrauksim izmantot “GitHub problēmas” kā atsauksmju par saturu mehānismu un aizstāsim to ar jaunu atsauksmju sistēmu. Papildinformāciju skatiet:Iesniegt un skatīt atsauksmes par