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.

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).