Power Apps ішіндегі "Пішінді өңдеу" және "Пішінді көрсету" басқару элементтері
Деректер көзінде жазбаны көрсету, өңдеу және жасау.
Сипаттама
Пішінді көрсету басқару элементін қоссаңыз, пайдаланушы жазбаның барлық өрістерін немесе сіз көрсеткен өрістерді ғана көрсете алады. Пішінді өңдеу басқару элементін қоссаңыз, пайдаланушы бұл өрістерді өңдей алады, жазбаны жасай алады және бұл өзгерістерді деректер көзіне сақтай алады.
Gallery басқару элементін қоссаңыз, оны деректер көзінде кестені көрсетуге конфигурациялауға, содан кейін пішінді пайдаланушы галереяда таңдайтын жазбаны көрсетуге конфигурациялауға болады. Сондай-ақ пайдаланушы өңдеулерді сақтау, өңдеулерден бас тарту және жазбаны жасау үшін таңдай алатын бір немесе көбірек Button басқару элементін қоса аласыз. Басқару элементтерін бірге пайдалана отырып, толық шешімді жасауға болады.
Шектеулер
Пішінді басқаруда мына шектеулер бар:
- Пішіндерді деректер карталарына көшіру және қою мүмкін емес. Бұл қолданбаның тұрақтылығы мен өнімділігіне қауіп төндіретін басқару элементтерінің белгілі комбинацияларының жасалуына жол бермеу.
Жазбаны таңдау
Пішіннің кез келген түрі үшін DataSource сипатын жазбалар кестесіне орнатасыз және пішіннің Item сипатын сол кестедегі нақты жазбаны көрсетуге орнатасыз. Мысалы, пішіннің Item сипатын Gallery басқару элементінің SelectedItem сипатына орнатуға болады. Пайдаланушы галереядағы жазбаны таңдағанда, сол жазба пішінді көрінеді, тек пішін көбірек өрістерді көрсете алады. Пайдаланушы галереяға оралса және басқа жазбаны таңдаса, галереяның SelectedItem сипаты өзгереді. Бұл өзгеріс пішіннің Item сипатын жаңартады, содан кейін ол жаңадан таңдалған жазбаны көрсетеді.
Сондай-ақ Жазбаны көрсету, өңдеу немесе қосу бөлімінде сипатталғандай пішіннің Item сипатын Ашылмалы тізім басқару элементін, я болмаса, Lookup немесе First сияқты функцияны пайдалана отырып орнатуға болады. Мысалы, Элемент сипатын Microsoft Dataverse жүйесіндегі Тіркелгілер кестесіндегі Fabrikam жазбасын көрсету үшін осы формулалардың кез келгеніне орнатуға болады.
First(Accounts)
Lookup(Accounts, "Fabrikam" in name)
Әр пішін басқару элементі бір немесе көбірек Card басқару элементін қамтиды. Картаның DataField сипатын орнату арқылы сіз сол карта қай өрісті көрсететінін және басқа мәліметтерді көрсетесіз.
Жазба жасау
Пішінді өңдеу басқару элементі Өңдеу режимінде болғанда, пайдаланушы пішіннің Item сипатында көрсетілген жазбаны жаңарта алады. Тексерсе, Mode сипаты Өңдеу режимін қайтарады.
Дегенмен, Пішінді өңдеу басқару элементі Жаңа режимінде болғанда, Item сипаты еленбейді. Пішін бар жазбаны көрсетпейді; оның орнына, әр өрістегі мәндер сіз пішінді конфигурациялаған деректер көзінің әдепкі мәндеріне сәйкестендіріледі. NewForm функциясы пішіннің осы режимге ауысуына әкеледі.
Мысалы, түймешіктің Мәтін сипатын Жаңа сөзін көрсетуге және оның OnSelect сипатын NewForm функциясын қамтитын формулаға орнатуға болады. Пайдаланушы сол түймешікті таңдаса, пішін Жаңа режиміне ауысады, осылайша пайдаланушы белгіші мәндермен басталатын жазбаны жасай алады.
ResetForm функциясы немесе SubmitForm функциясы сәтті орындалса, пішін Өңдеу режиміне ауысады.
- Түймешіктің Мәтін сипатын Бас тарту сөзін көрсетуге және оның OnSelect сипатын ResetForm функциясын қамтитын формулаға орнатуға болады. Егер пайдаланушы сол түймешікті таңдаса, орындалып жатқан кез келген өзгерістер жойылады және пішіндегі мәндер қайтадан деректер көзінің әдепкі мәндеріне сәйкестендіріледі.
- Түймешіктің Мәтін сипатын Өзгерістерді сақтау сөзін көрсетуге және оның OnSelect сипатын SubmitForm функциясын қамтитын формулаға орнатуға болады. Егер пайдаланушы сол түймешікті таңдаса және деректер көзі жаңартылса, пішіндегі мәндер деректер көзінің әдепкі мәндеріне ысырылады.
Өзгерістерді сақтау
Алдыңғы бөлімде сипатталғандай Өзгерістерді сақтау түймешігін жасасаңыз, пайдаланушы жазбаны жасай немесе жаңарта алады, содан кейін сол өзгерістерді деректер көзіне сақтау үшін түймешікті таңдай алады. Оның орнына, дәл сол тапсырманы орындау үшін Image басқару элементін немесе басқа бір басқару элементін конфигурациялауға болады, тек бұл басқару элементін SubmitForm функциясымен бірге конфигурациялау керек. Кез келген жағдайда, Error, ErrorKind, OnSuccess және OnFailure сипаттары нәтиже туралы кері байланысты қамтамасыз етеді.
SubmitForm функциясы орындалғанда, ол алдымен пайдаланушы жібергісі келетін деректерді тексереді. Міндетті өріс мәнді қамтымаса немесе басқа мән басқа бір шектеуге сәйкес болмаса, ErrorKind сипаттары орнатылады және OnFailure формуласы орындалады. Пайдаланушы деректер жарамды болса ғана (яғни, пішіннің Valid сипатының мәні true болса) таңдай алуы үшін Өзгерістерді сақтау түймешігін немесе басқа басқару элементін конфигурациялауға болады. Пайдаланушы мәселені түзетіп қана қоймай, сонымен бірге Error және ErrorKind сипаттарын ысыру үшін Өзгерістерді сақтау түймешігін қайтадан таңдауы керек (немесе бұрынырақ сипатталғандай, Бас тарту түймешігін таңдау арқылы өзгерістерді жоюы керек).
Деректер тексеруден өтсе, SubmitForm оларды деректер көзіне жібереді, желінің кідірісіне байланысты бұған біраз уақыт кетуі мүмкін.
- Жіберу сәтті аяқталса, Error сипаты тазаланады, ErrorKind сипаты ErrorKind.None мәніне орнатылады және OnSuccess формуласы орындалады. Пайдаланушы жазбаны жасаса (яғни, пішін бұрын Жаңа режимінде болған болса), пайдаланушы жаңадан жасалған жазбаны немесе басқасын өңдей алуы үшін пішін Өңдеу режиміне ауысады.
- Жіберу сәтсіз аяқталса, Error сипаты деректер көзінен мәселені түсіндіретін түсінікті қате туралы хабарды қамтиды. Мәселеге байланысты ErrorKind сипаты тиісінше орнатылады және OnFailure формуласы орындалады.
Кейбір деректер көздері екі адамның бір жазбаны бір уақытта жаңартуға әрекеттенуін анықтай алады. Бұл жағдайда, ErrorKind сипаты ErrorKind.Conflict мәніне орнатылады және мұның шешімі — деректер көзін екінші пайдаланушының өзгерістерімен жаңарту және осы пайдаланушы жасаған өзгертуді қайта қолдану.
Кеңес
Пайдаланушы орындалудағы өзгерістерді жоя алуы үшін пішінде Бас тарту түймешігін ұсынсаңыз, тіпті сол сипат экрандарды өзгерту үшін Navigate функциясын да қамтыса да, ResetForm функциясын түймешіктің OnSelect сипатына қосыңыз. Әйтпесе, пішін пайдаланушының өзгертулерін сақтайды.
Құрылым
Әдепкі бойынша, карталар телефон бағдарламалары үшін бір бағанға және планшеттік бағдарламалар үшін үш бағанға орналастырылады. Пішінді конфигурациялау кезінде пішінде неше баған болатынын және карталардың оларға бекітілетін-бекітілмейтінін көрсете аласыз. Бұл параметрлер сипаттар түрінде көрсетілмейді, өйткені олар тек карталардың X, Y және Width сипаттарын орнату үшін пайдаланылады.
Қосымша ақпарат алу үшін Деректер пішінінің орналасуын түсіну бөлімін қараңыз.
Негізгі сипаттар
DataSource – пайдаланушы көрсететін, өңдейтін немесе жасайтын жазбаны қамтитын деректер көзі.
- Егер сіз бұл сипатты орнатпасаңыз, пайдаланушы жазбаны көрсете алмайды, өңдей алмайды немесе жасай алмайды және ешқандай қосымша метадеректер мен тексеру қамтамасыз етілмейді.
DefaultMode - Пішін басқару элементінің бастапқы режимі. Рұқсатты мәндерді және олардың мағыналарын төмендегі Режим сипаттамасында қараңыз.
DisplayMode - Пішін басқару элементі ішіндегі деректер карталары және басқару элементтері үшін пайдаланатын режим.
Mode сипаты негізінде алынады және тәуелсіз орнату мүмкін емес:
| Режим | DisplayMode | Сипаттама |
|---|---|---|
| FormMode.Edit | DisplayMode.Edit | Деректер карталары мен басқару элементтерін өңдеуге болады, жазбаға өзгерістерді қабылдауға дайын. |
| FormMode.New | DisplayMode.Edit | Деректер карталары мен басқару элементтерін өңдеуге болады, жаңа жазбаны қабылдауға дайын. |
| FormMode.View | DisplayMode.View | Деректер карталары мен басқару элементтерін өңдеу мүмкін емес және көруге оңтайландырылған. |
Error – SubmitForm функциясы сәтсіз аяқталғанда осы пішін үшін көрсететін түсінікті қате туралы хабар.
- Бұл сипат тек Пішінді өңдеу басқару элементіне қатысты.
- Бұл сипат тек SubmitForm, EditForm немесе ResetForm функциясы орындалғанда өзгереді.
- Ешбір қате орын алмаса, бұл сипат blank болады әрі 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 – Мәліметтермен жұмыс сәтсіз болған кезде орындалатын әрекеттер.
- Бұл сипат тек Пішінді өңдеу басқару элементіне қатысты.
OnReset – Пішінді өңдеу басқару элементі қалпына келтірілгенде орындалатын әрекеттер.
- Бұл сипат тек Пішінді өңдеу басқару элементіне қатысты.
OnSuccess – Мәліметтермен жұмыс сәтті болған кезде орындалатын әрекеттер.
- Бұл сипат тек Пішінді өңдеу басқару элементіне қатысты.
Unsaved – Пішінді өңдеу басқару элементі сақталмаған пайдаланушы өзгерістерін қамтыса, true.
- Бұл сипат тек Пішінді өңдеу басқару элементіне қатысты.
- Бұл сипатты кез келген сақталмаған өзгерістерді жоғалтуы алдында пайдаланушыға ескерту үшін пайдаланыңыз. Ағымдағы жазбаға енгізілген өзгерістерді сақтау алдында пайдаланушының Gallery басқару элементінде басқа жазбаны таңдауын болдырмау үшін галереяның Disabled сипатын Form.Unsaved мәніне орнатыңыз және осы сияқты, жаңарту әрекеттерін өшіріңіз.
Updates – пішін басқару элементінде жүктелген жазба үшін деректер көзіне жазылатын мәндер.
- Бұл сипат тек Пішінді өңдеу басқару элементіне қатысты.
- Бұл сипатты басқару элементі ішіндегі карталардан өріс мәндерін шығарып алу үшін пайдаланыңыз. Содан кейін бұл мәндерді Patch функциясын шақыру немесе байланыс ашатын басқа әдіс арқылы деректер көзін қолмен жаңарту үшін пайдалануға болады. SubmitForm функциясын пайдаланып жатсаңыз, бұл сипатты пайдалану қажет емес.
- Бұл сипат мәндердің жазбасын қайтарады. Мысалы, пішін басқару элементі Name және Quantity өрістері үшін карта басқару элементтерін қамтыса әрі сол карталар үшін Update сипаттарының мәндері сәйкесінше "Widget" және 10 мәндерін қайтарса, онда пішін басқару элементінің Updates сипаты { Name: "Widget", Quantity: 10 } мәнін қайтаратын еді.
Valid – Card немесе Edit form басқару элементінің деректер көзіне жіберуге дайын жарамды жазбаларды қамтитын-қамтымайтыны.
Бұл сипат тек Пішінді өңдеу басқару элементіне қатысты.
Пішін басқару элементінің Valid сипаты пішіндегі барлық Card басқару элементтерінің Valid сипаттарын біріктіреді. Пішіннің Valid сипаты сол пішіндегі барлық карталардағы деректер жарамды болса ғана true болады; әйтпесе, пішіннің Valid сипаты false болады.
Түймешікке пішіндегі деректер жарамды болғанда ғана, бірақ әлі жіберілмегенде өзгерістерді сақтауға мүмкіндік беру үшін түймешіктің DisplayMode сипатын мына формулаға орнатыңыз:
SubmitButton.DisplayMode = If(IsBlank( Form.Error ) || Form.Valid, DisplayMode.Edit, DisplayMode.Disabled)
Қосымша сипаттар
BorderColor – Басқару элементі жиегінің түсі.
BorderStyle – Басқару элементі жиегі Тұтас, Сызықшалы, Нүктелі немесе Жоқ екені.
BorderThickness – Басқару элементі жиегінің қалыңдығы.
Толтыру - Басқару элементінің фондық түсі.
Height – Басқару элементінің жоғарғы және төменгі шеттерінің арасындағы қашықтық.
Көрінетін – Басқару элементі көрінетіндігі немесе жасырылатындығы.
Ені – Басқару элементінің сол жақ және оң жақ шеттерінің арасындағы қашықтық.
Х - басқару элементінің сол жақ жиегі мен басты контейнерінің сол жиегі арасындағы қашықтық (егер басты контейнер болмаса, экран).
Y - басқару элементінің жоғарғы жиегі мен басты контейнерінің жоғарғы жиегі арасындағы қашықтық (егер басты контейнер болмаса, экран).
Қосымша ақпарат
- Пішіндердің жұмыс істеу жолына толық шолуды Деректер пішіндерін түсіну бөлімінен қараңыз.
- EditForm үшін Power Fx формула сілтемесін қараңыз.
Арнайы мүмкіндіктер туралы нұсқаулар
Экраннан оқу бағдарламасының қолдауы
- Label басқару элементін пайдаланып пішінге тақырып қосуды қарастырыңыз.
Ескерім
Сіз құжат тіліңіздің артықшылықтары туралы айта аласыз ба? Қысқа сауалнамаға қатысыңыз. (бұл сауалнама ағылшын тілінде екеніне назар аударыңыз)
Сауалнама шамамен жеті минут уақытыңызды алады. Жеке деректер жиналмайды (құпиялылық туралы мәлімдеме).