Контроле обрасца за приказ и обрасца за уређивање у услузи Power Apps
Прикажите, уређујте и креирајте запис у извору података.
Опис
Ако додате контролу образац за приказ, корисник може да приказује сва поља записа или само поља која сте ви одредили. Ако додате контролу образац за уређивање, корисник може да уређује та поља, креира запис и сачува те промене у извору података.
Ако додате контролу Gallery, можете да је конфигуришете за приказивање табеле у извору података, а затим конфигуришете образац да приказује онај запис који корисник одабере у галерији. Такође можете да додате једну или више контрола Button да корисник може да изабере да сачува измене, откаже измене и креира запис. Ако те контроле користите заједно, можете креирати комплетно решење.
Ограничења
Контрола обрасца има следећа ограничења:
- Обрасце не можете да копирате и налепите на картице са подацима. Ово је да би се спречило да се креирају одређене комбинације контрола које ризикују стабилност и перформансе апликације.
Избор записа
За било који тип обрасца, поставите његово својство DataSource на табелу записа и подесите својство обрасца Item да приказује одређени запис у тој табели. На пример, можете да поставите својство обрасца Item на својство SelectedItem контроле Gallery. Када корисник изабере запис у галерији, исти запис се појављује у обрасцу, осим што образац може приказати више поља. Ако се корисник врати у галерију и изабере другачији запис, својство галерије SelectedItem се мења. Ова промена ажурира својство обрасца Item, које затим приказује новоизабрани запис.
Такође можете да поставите својство обрасца Item помоћу контроле падајуће листе, као што је описано у чланку Приказивање, уређивање или додавање записа, или функцију попут Lookup или First. На пример, можете да подесите својство Item било које од ових формула да приказује ставку Fabrikam у табели Пословни контакти на платформи Microsoft Dataverse:
First(Accounts)
Lookup(Accounts, "Fabrikam" in name)
Свака контрола обрасца садржи једну или више контрола Card. Постављањем својства картице DataField, ви одређујете које поље та картица приказује и остале детаље.
Креирање записа
Када је контрола Образац за уређивање у режиму уређивања, корисник може ажурирати запис који је наведен у својству обрасца Item. Ако се прегледа, својство Mode враћа Edit.
Када је контрола образац за уређивање у режиму Ново, међутим, својство Item се игнорише. Образац не показује постојећи запис; уместо тога, вредности у сваком пољу одговарају подразумеваним вредностима извора података са којима сте конфигурисали образац. Функција NewForm узрокује да се образац пребаци у овај режим.
На пример, можете да поставите својство дугмета Текст да приказује Ново и његово својство OnSelect на формулу која укључује функцију NewForm. Ако корисник изабере то дугме, образац се пребацује на режим Ново, тако да корисник може креирати запис почевши од познатих вредности.
Образац се враћа на режим уређивање ако је функција ResetForm или SubmitForm успешно покренута.
- Можете да поставите својство дугмета Текст да приказује Откажи и његово својство OnSelect на формулу која укључује функцију ResetForm. Ако корисник изабере то дугме, све промене у току ће се одбацити, а вредности у обрасцу се још једном подударају са подразумеваним вредностима извора података.
- Можете да поставите својство дугмета Текст да приказује Сачувај промене и његово својство OnSelect на формулу која укључује функцију SubmitForm. Ако корисник изабере то дугме и извор података се ажурира, вредности у обрасцу ће се ресетовати на подразумеване вредности извора података.
Сачувај промене
Ако креирате дугме Сачувај промене дугме као што је описано у претходном одељку, корисник може да креира или ажурира запис, а затим изабере то дугме да би те измене сачувао у извору података. Уместо тога, можете да конфигуришете контролу Image или неку другу контролу за обављање истог задатка, све док је конфигуришете са функцијом SubmitForm. У сваком случају, функције Error, ErrorKind, OnSuccess и OnFailure пружају повратне информације о исходу.
Када се покрене функција SubmitForm, она прво потврђује ваљаност података које корисник жели да проследи. Ако обавезно поље не садржи неку вредност или нека друга вредност не одговара неком другом ограничењу, подешавају се својства ErrorKind и покреће се формула OnFailure. Можете да конфигуришете дугме Сачувај промене или друге контроле тако да их корисник може одабрати само ако су подаци важећи (тј. ако својство обрасца Valid има вредност тачно). Имајте на уму да корисник мора не само да поправи проблем, већ и да поново изабере дугме Сачувај промене (или да одбаци измене одабиром дугмета Откажи, као што је описано раније) да би поништио својства Error и ErrorKind.
Ако подаци прођу валидацију, функција SubmitForm их шаље у извор података, што може потрајати неко време у зависности од кашњења мреже.
- Ако слање успе, својство Error се брише, својство ErrorKind се поставља на ErrorKind.None и покреће се формула OnSuccess. Ако је корисник креирао запис (тј. ако је образац претходно био у режиму Ново), образац се пребацује у режим уређивања, тако да корисник може уређивати новокреирани запис или неки други.
- Ако слање не успе, својство Error садржи кориснику прилагођену поруку о грешци из извора података, објашњавајући проблем. Својство ErrorKind се поставља на одговарајући начин, у зависности од проблема и покреће се формула OnFailure.
Неки извори података могу открити када две особе покушавају истовремено да ажурирају исти запис. У том случају, ErrorKind се поставља на ErrorKind.Conflict, а решење је да се освежи извор података променама другог корисника и да се поново примене промене које је извршио овај корисник.
Савет
Ако понудите дугме Откажи на обрасцу тако да корисник може да напусти промене у току, додајте функцију ResetForm својству OnSelect чак и то својство такође садржи функцију Navigate за промену екрана. У супротном, образац ће задржати промене корисника.
Распоред
Картице се подразумевано смештају у једну колону за апликације за телефоне и три колоне за апликације за таблете. Можете да одредите колико колона образац има и да ли би картице требало да се додају на њих док конфигуришете образац. Та подешавања нису изложена као својства јер се користе само за подешавање својстава картица X, Y и Width.
За више информација, погледајте Објашњење распореда обрасца података.
Кључна својства
DataSource – Извор података који садржи запис који ће корисник приказивати, уређивати или креирати.
- Ако не подесите ово својство, корисник не може приказивати, уређивати или креирати запис, а додатни метаподаци или потврда ваљаности нису обезбеђени.
DefaultMode – Почетни режим контроле обрасца. Погледајте опис својства Mode у наставку за прихватљиве вредности и њихово значење.
DisplayMode – Начин који се користи за картице података и контроле у оквиру контроле обрасца.
Изведено из основног својства Mode и не може се поставити независно:
| Режим | DisplayMode | Опис |
|---|---|---|
| FormMode.Edit | DisplayMode.Edit | Картице података и контроле се могу уређивати, спремне да прихвате промене у запису. |
| FormMode.New | DisplayMode.Edit | Картице података и контроле се могу уређивати, спремне да прихвате нови запис. |
| FormMode.View | DisplayMode.View | Картице података и контроле се не могу уређивати или оптимизовати за гледање. |
Error – Порука о грешци прилагођена кориснику која ће се приказати за овај образац када функција SubmitForm не успе.
- Ово својство се односи само на контролу образац за уређивање.
- Ово својство се мења само када се покрене функција SubmitForm, EditForm или ResetForm.
- Ако се не догоди грешка, ово својство је празно и ErrorKind се поставља на ErrorKind.None.
- Када је могуће, порука о грешци која се враћа биће на језику корисника. Неке поруке о грешци долазе директно из извора података и можда нису на језику корисника.
ErrorKind – Ако до грешке долази када је покренута функција SubmitForm, врста грешке до које долази.
- Односи се само на контролу образац за уређивање.
- Ово својство има исто набрајање као и функција Errors. Контрола образац за уређивање може да врати ове вредности:
| ErrorKind | Опис |
|---|---|
| ErrorKind.Conflict | Други корисник је променио исти запис, што је резултирало конфликтом промене. Извршите функцију Refresh да бисте поново учитали запис, па поново покушајте да обавите промену. |
| ErrorKind.None | Грешка је непознате врсте. |
| ErrorKind.Sync | Извор података је пријавио грешку. Проверите својство Error својство за више информација. |
| ErrorKind.Validation | Откривен је општи проблем валидације. |
Item – Запис у контроли DataSource који ће корисник приказивати или уређивати.
LastSubmit – Последњи успешно прослеђен запис, укључујући сва поља генерисана на серверу.
- Ово својство се односи само на контролу образац за уређивање.
- Ако извор података аутоматски генерише или израчуна било која поља, попут поља ID са јединственим бројем, својство LastSubmit ће добити ову нову вредност када се формула SubmitForm успешно обави.
- Вредност овог својства је доступна у формули OnSuccess.
Mode – Контрола је укључена у режиму уређивање или ново.
| Режим | Опис |
|---|---|
| FormMode.Edit | Корисник може да уређује запис користећи образац. Вредности на картицама обрасца унапред су попуњене постојећим записом, како би их корисник променио. Ако функција SubmitForm успешно функционише, постојећи запис се мења. |
| FormMode.New | Корисник може да креира запис користећи образац. Вредности на контролама обрасца унапред су попуњене подразумеваним вредностима записа из извора података. Ако функција SubmitForm успешно функционише, запис се креира. |
| FormMode.View | Корисник може да прикаже запис користећи образац. Вредности на контролама обрасца унапред су попуњене подразумеваним вредностима записа из извора података. |
Образац се пребацује из режима ново у режим уређивање када се дође до било које од ових промена:
- Образац се успешно прослеђује и креира се запис. Ако је галерија постављена да аутоматски премешта избор на овај нови запис, образац ће бити у режиму уређивање за креирани запис, тако да корисник може да изврши додатне промене.
- Покреће се функција EditForm.
- Покреће се функција ResetForm. На пример, корисник може да изабере дугме Откажи које је конфигурисано овом функцијом.
OnFailure – Радње које треба предузети када операција са подацима не успе.
- Ово својство се односи само на контролу образац за уређивање.
ОнРесет - Радње које треба предузети када се контрола Измените образац ресетује.
- Ово својство се односи само на контролу образац за уређивање.
OnSuccess – Радње које треба предузети када операција са подацима успе.
- Ово својство се односи само на контролу образац за уређивање.
Unsaved – Тачно ако контрола образац за уређивање садржи корисничке промене које нису сачуване.
- Ово својство се односи само на контролу образац за уређивање.
- Овим својством упозорите корисника пре губитка несачуваних промена. Да бисте спречили да корисник изабере други запис у контроли Gallery пре него што сачувате промене у тренутни запис, подесите својство галерије Disabled на Form.Unsaved и, исто тако, онемогућите операције освежавања.
Updates – Вредности које се уписују у извор података за запис учитан у контролу обрасца.
- Ово својство се односи само на контролу образац за уређивање.
- Овим својством извуците вредности поља са картица унутар контроле. Затим можете да користите ове вредности за ручно ажурирање извора података позивом функције Patch или на неки други начин који веза омогућује. Не морате да користите ово својство ако користите функцију SubmitForm.
- Ово својство враћа запис вредности. На пример, ако контрола обрасца садржи контроле картица за поља Име и Количина и вредности својства Update за те картице враћају "Widget" и 10, тада би својство Updates за контролу обрасца вратило { Name: "Widget", Quantity: 10 }.
Valid – Да ли је контрола Card или образац за уређивање, која садржи важеће ставке, спремна за прослеђивање у извор података.
Ово својство се односи само на контролу образац за уређивање.
Својство Valid контроле образац обједињује својства Valid свих контрола Card у обрасцу. Својство Valid обрасца има вредност тачно само ако су подаци на свим картицама у том обрасцу важећи; у супротном, својство обрасца Valid има вредност нетачно.
Да бисте омогућили дугме да сачува измене само када су подаци у обрасцу важећи, али још нису прослеђени, подесите својство дугмета DisplayMode према овој формули:
SubmitButton.DisplayMode = If(IsBlank( Form.Error ) || Form.Valid, DisplayMode.Edit, DisplayMode.Disabled)
Додатна својства
BorderColor – Боја ивице контроле.
BorderStyle – Да ли је ивица контроле пуна, испрекидана, тачкаста или ниједна.
BorderThickness – Дебљина ивице контроле.
Fill – Боја позадине контроле.
Height – Одстојање између горње и доње ивице контроле.
Visible – Да ли се контрола приказује или је скривена.
Width – Одстојање између леве и десне ивице контроле.
X – Одстојање између леве ивице контроле и леве ивице његовог надређеног контејнера (или екрана ако нема надређеног контејнера).
Y – Одстојање између горње ивице контроле и горње ивице његовог надређеног контејнера (или екрана ако нема надређеног контејнера).
Још информација
- За свеобухватни преглед начина рада образаца, погледајте Објашњење образаца података.
- Погледајте референцу Power Fx формуле за ЕдитФорм.
Смернице за приступачност
Подршка за читаче екрана
- Размотрите додавање наслова у образац помоћу контроле Label.
Напомена
Можете ли нам рећи о својим жељеним поставкама језика у документацији? Испуните кратку анкету. (имајте на уму да је ова анкета на енглеском језику)
Анкета ће трајати око седам минута. Не прикупљају се лични подаци (изјава о приватности).