Märkus.
Juurdepääs sellele lehele nõuab autoriseerimist. Võite proovida sisse logida või kausta vahetada.
Juurdepääs sellele lehele nõuab autoriseerimist. Võite proovida kausta vahetada.
Märkus.
- Selles jaotises kirjeldatakse lõuendi komponente, mis hõlmavad madala koodiga kasutajaliidese laiendatavuse võimalusi. Professionaalsed arendajad saavad komponendi raamistikku Power Apps kasutada ka koodikomponentide loomiseks.
- Lõuendikomponente saab samuti kasutada mudelipõhistes rakendustes ja teegi komponendis. Lisateave: Lõuendikomponentide lisamine mudelipõhise rakenduse kohandatud lehele
Komponendid on lõuendirakenduste korduvkasutatavad koosteüksused, et rakenduse loojad saaksid luua kohandatud juhtelemente, mida kasutada rakenduses või rakendustes, kasutades komponenditeeki. Komponendid saavad kasutada täpsemaid funktsioone (nagu kohandatud atribuudid) ja lubada keerukaid võimalusi. Käesolevas artiklis tutvustatakse komponendi kontseptsioone ja mõningaid näiteid.
Komponendid on kasulikud suuremate rakenduste ehitamisel, millel on sarnased kontrollimustrid. Kui värskendate rakenduse komponendi määratlust, kajastavad teie muudatused kõikides rakenduse instantsides. Komponendid vähendavad korduvaid pingutusi kõrvaldades vajadust kopeerida/kleepida juhtelemente ja parandada jõudlust. Komponendid aitavad luua ka ühist arendust ja standardiseerivad organisatsioonis ilmet ja olemust, kui kasutate komponenditeeki.
Vaadake videost, kuidas kasutada komponente lõuendirakendustes.
Lõuendirakenduste komponendid
Komponendi saate luua rakenduses, nagu selles artiklis selgitatud, või luues uue komponendi komponenditeegis. Komponendi teeki tuleks kasutada juhul, kui on vaja komponente kasutada mitme rakenduse ekraanil. Olemasolevaid komponente saate kopeerida ka olemasolevasse või uude komponendi teeki.
Rakenduses komponendi loomiseks minge puuvaatesse, valige vahekaart Komponendid ja seejärel valige Uus komponent.
Uue komponendi valimisel avaneb tühi lõuend. Juhtelemente saate lisada lõuendi komponendi määratluse osana. Lõuendi komponendi redigeerimisel värskendatakse sama komponendi instantse muude rakenduste ekraanidel. Rakendused, mis taaskasutavad juba loodud komponenti, saavad pärast komponendi muudatuste avaldamist ka komponente värskendada.
Komponendi saate valida vasakpoolsel paanil olemasolevate komponentide loendist pärast ekraani valimist. Komponendi valimisel lisatakse selle komponendi instants ekraanile (nagu juhtelemendi lisamisel).
Rakenduses saadaolevad komponendid on loetletud puuvaates olevate komponentide loendis kategoorias Kohandatud . Komponenditeekidest imporditud komponendid on loetletud kategoorias Teegi komponendid .
Märkus.
Selles artiklis käsitletud komponendid erinevad raamistikust Power Apps component framework, mis võimaldab arendajatel ja loojatel luua mudelipõhistele ja lõuendirakendustele koodi komponente. Lisateabe saamiseks minge jaotisse Power Apps Komponentide raamistiku ülevaade.
Kohandatud atribuudid
Komponent saab sisendi väärtusi vastu võtta ja andmeid eraldada, kui loote ühe või mitu kohandatud atribuudi. Need stsenaariumid on täiustatud ja nõuavad valemite ja siduvate lepingute mõistmist .
Märkus.
Täiustatud komponentide omaduste eksperimentaalne funktsioon pakub veelgi rohkem võimalusi omaduste jaoks, sealhulgas funktsioonid ja käitumisfunktsioonid. Lisateavet leiate teemast Lõuendikomponendi atribuudid (eksperimentaalne)
Sisendatribuut on see, kuidas komponent võtab vastu komponendis kasutatavaid andmeid. Sisendi atribuudid kuvatakse parempoolse paani vahekaardil Atribuudid , kui komponendi eksemplar on valitud. Saate konfigureerida sisendi atribuute avaldiste või valemitega, nagu konfigureerite standardseid atribuute teistes juhtelementides. Teistel juhtelementidel on sisendatribuudid, näiteks juhtelemendi Text input atribuut Default .
Väljundatribuuti kasutatakse andmete või komponendi oleku väljastamiseks. Näiteks juhtelemendi Gallery atribuut Selected on väljundi atribuut. Väljundi atribuudi loomisel saate määratleda, millised muud juhtelemendid saavad viidata komponendi olekule.
Järgmine tutvustus selgitab neid kontseptsioone.
Komponendi näidise loomine
Selles näites saate luua menüü komponendi, mis sarnaneb järgmise pildiga. Hiljem saate teksti muuta, et seda saaks kasutada mitmes ekraanil, rakenduses või mõlemas.
Märkus.
Soovitame taaskasutamiseks komponentide loomisel kasutada komponenditeeki . Komponendi värskendamine rakenduse sees teeb ainult komponendi värskendused rakenduses kättesaadavaks. Komponendi teegi kasutamisel palutakse teil värskendada komponente, kui komponendid on teegis värskendatud ja avaldatud.
Uue komponendi loomine
Looge tühi lõuendirakendus.
Valige puuvaates Komponendidja seejärel valige uue komponendi loomiseks Uus komponent .
Valige vasakpoolsel paanil uus komponent, valige kolmikpunkt (...) ja seejärel valige Nimeta ümber. Tippige või kleepige nimi kujul MenuComponent.
Määrake parempoolsel paanil komponendi laiuseks 150 ja kõrguseks 250 ning seejärel valige Uus kohandatud atribuut. Samuti saate määrata kõrguse ja laiuse mis tahes teisele väärtusele vastavalt vajadusele.
Tippige või kleepige väljadele Kuvatav nimi, Atribuudi nimi jaKirjeldus tekst nimegaÜksused .
Ärge kaasake atribuudi nimesse tühikuid, kuna viitate kirjutamisel selle nimega komponendile. Näiteks ComponentName.PropertyName.
Kuvatav nimi kuvatakse parempoolse paani vahekaardil Atribuudid , kui valite komponendi. Kirjeldav kuva nimi aitab teil ja teistel tegijatel selle atribuudi eesmärki mõista. Kirjeldus kuvatakse kohtspikris, kui hõljutate kursorit selle atribuudi kuvatava nime kohal vahekaardil Atribuudid .
Valige loendist Andmetüüp Tabel ja seejärel valige Loo.
Atribuudi Üksused väärtuseks on määratud vaikeväärtus, mis põhineb teie määratud andmetüübil. Saate selle väärtustada vastavalt oma vajadustele. Kui määrasite andmetüübiks Tabel või Kirje , võiksite muuta atribuudi Üksusedväärtust nii, et see vastaks andmeskeemile, mille soovite komponendile sisestada. Sel juhul muudate selle sõnede loendiks.
Atribuudi väärtuse saate määrata valemiribal, kui valite atribuudi nime parempoolse paani vahekaardil Atribuudid .
Nagu järgmisel graafikul näha, saate atribuudi väärtust redigeerida ka parempoolse paani vahekaardil Täpsemalt .
Määrake komponendi atribuudi Üksused väärtuseks järgmine valem.
Table({Item:"SampleText"})
Sisestage komponendis tühi vertikaalne juhtelement Galerii ja valige atribuudipaanil Paigutus kui Pealkiri.
Veenduge, et atribuudiloendis oleks kuvatud atribuut Üksused (nagu see on vaikimisi). Seejärel määrake atribuudi väärtuseks see avaldis.
MenuComponent.ItemsSel viisil loeb juhtelemendi Galerii atribuut Üksused ja sõltub komponendi sisendatribuudist Üksused .
Valikuline – määrake juhtelemendi Gallery atribuudi BorderThickness väärtuseks 1 ja atribuudi TemplateSize väärtuseks 50 . Vajadusel saate muuta ka äärise paksuse ja malli suuruse väärtusi.
Komponendi lisamine ekraanile
Järgmisena lisate komponendi ekraanile ja määrate sõnede tabeli, mida komponent kuvab.
Valige vasakpoolsel paanil ekraanide loend ja seejärel vaikimisi kuvatav ekraan.
Avage vahekaardil Lisa menüü Komponendid ja seejärel valige MenuComponent .
Uue komponendi nimi on vaikimisi MenuComponent_1 .
Määrake MenuComponent_1atribuut Üksused järgmisele valemile.
Table({Item:"Home"}, {Item:"Admin"}, {Item:"About"}, {Item:"Help"})See eksemplar meenutab seda pilti, kuid saate kohandada iga eksemplari teksti ja muid atribuute.
Väljundi atribuudi loomine ja kasutamine
Siiani olete loonud komponendi ja lisanud selle rakendusse. Järgmisena loote väljundi atribuudi, mis vastab üksusele, mille kasutaja on menüüs valinud.
Avage komponentide loend ja seejärel valige MenuComponent.
Valige parempoolsel paanil vahekaart Atribuudid ja seejärel valige Uus kohandatud atribuut.
Tippige või kleepige väljadele Kuvatav nimi, Atribuudi nimi ja Kirjeldus väärtus Valitud .
Valige jaotises Atribuudi tüüp Väljund ja seejärel valige Loo.
Määrake vahekaardil Täpsemalt atribuudi Valitud väärtuseks see avaldis, kohandades vajadusel galerii nimes olevat numbrit.
Gallery1.Selected.Item
Lisage rakenduse vaikekuval silt ja määrake selle atribuut Tekst sellele avaldisele, kohandades vajadusel komponendi nimes olevat numbrit.
MenuComponent_1.SelectedMenuComponent_1 on eksemplari vaikenimi, mitte komponendi definitsiooni nimi. Võite iga eksemplari ümber nimetada.
Muuteklahvi (ALT) all hoides valige menüüst kõik üksused.
Juhtelement Silt kajastab viimati valitud menüü-üksust.
Scope
Sisendi ja väljundi atribuudid määratlevad selgelt komponendi ja selle hostirakenduse vahelise liidese. Komponent on vaikimisi valmistatud nii, et komponenti oleks hõlpsam rakendustes uuesti kasutada, kuna selleks on vaja atribuutide kasutamist, et teavet komponendist sisse ja välja edastada. Ulatuse piirangud hoiavad komponendi andmelepingu lihtsa ja ühtsena ning aitavad lubada komponendi definitsiooni värskendusi – eriti komponentteekidega rakendustes.
Kuid on aegu, mil komponent võib soovida jagada andmeallikas muutujat oma hostiga. Eriti juhul, kui komponent on mõeldud kasutamiseks ainult ühes konkreetses rakenduses. Sellistel juhtudel pääsete rakendusetaseme teabele otse juurde, lülitades komponendi atribuudipaanil sisse lüliti Juurdepääs rakenduse ulatusele .
Kui Accessi rakenduse ulatus on sisse lülitatud, pääseb komponendi kaudu juurde järgmistele toimingutele.
- Globaalsed muutujad
- Kogumid
- Juhtelemendid ja komponendid ekraanidel, nagu TextInput juhtelement
- Tabelandmeallikad, näiteks Dataverse tabelid
Kui see säte on välja lülitatud, pole ükski ülaltoodud säte komponendi jaoks saadaval. Funktsioonid Set ja Collect on endiselt saadaval, kuid saadud muutujate ja kogumite ulatus on komponendi eksemplariga ja neid ei jagata rakendusega.
Mitte tabelduskohaga andmeallikad, nagu Azure Blob Storage või kohandatud konnektor, on saadaval, olenemata sellest, kas see säte on sisse või välja lülitatud. Mõelge neile andmeallikatele rohkem nagu viitamine keskkonnaressursile, mitte rakenduseressursile. Kui komponent saadetakse komponenditeegi rakendusse, asuvad need keskkonna andmeallikad samuti komponendikogus.
Komponenditeegi komponentidel ei saa kunagi olla juurdepääsu rakenduse ulatusele, kuna ühelegi rakenduse ulatusele pole viidata. Seega pole see säte selles kontekstis saadaval ja see on tegelikult välja lülitatud. Pärast importimist rakendusse ja kui komponendi tegija on lubanud kohandamise, saab lülituse lubada ja komponenti saab rakenduse ulatuse kasutamiseks muuta.
Märkus.
- Saate lisada komponentide instantse komponendi teegi ekraanile ja vaadata seda ekraani eelvaates testimise eesmärgil.
- Komponenditeeki ei kuvata mobiilirakenduse kasutamisel Power Apps .
Komponentide importimine ja eksportimine (taaskasutamine)
Märkus.
See funktsioon on aegunud. Komponenditeegid on soovitatav viis komponentide taaskasutamiseks rakendustes. Komponentide teegi kasutamisel säilitab rakendus sõltuvused kasutatavatest komponentidest. Rakenduse loojat hoiatatakse, kui sõltuvate komponentide värskendused muutuvad kättesaadavaks. Seega tuleks kõik uued korduvkasutatavad komponendid luua hoopis komponendi teekides.
Võimalus komponente importida ja eksportida on vaikimisi keelatud, kuna see funktsioon läheb lahku. Kuigi soovitatav meetod komponentidega töötamiseks on komponenditeekide kasutamine, saate selle funktsiooni siiski lubada rakendusepõhiselt erandina, kuni funktsioon eemaldatakse. Selleks redigeerige oma rakendust jaotises Power Apps Studio ja seejärel avage Sätted >Tulevased funktsioonid>Aegunud> Määrake Ekspordi ja impordige komponendid olekusse Sees.
Pärast selle funktsiooni lubamist saate komponentide importimiseks ja eksportimiseks kasutada järgmisi võimalusi.
Komponentide importimine mõnest muust rakendusest
Ühe või mitme komponendi importimiseks ühest rakendusest teise valige menüüst Lisa käsk Impordi komponendid ja seejärel kasutage rippmenüüd Kohandatud . Või kasutage vasakpoolse paani puuvaates komponente .
Dialoogiboksis on loetletud kõik rakendused, mis sisaldavad komponente, mida teil on õigus redigeerida. Valige rakendus ja seejärel valige Impordi, et importida selle rakenduse kõigi komponentide uusim avaldatud versioon. Pärast vähemalt ühe komponendi importimist saate koopiat redigeerida ja kustutada kõike, mida te ei vaja.
Rakenduse saate salvestada olemasolevate komponentidega kohalikku faili ja seejärel seda faili importides uuesti kasutada. Faili abil saate komponente mõnda teise rakendusse importida.
Kui rakendus sisaldab sama komponendi muudetud versiooni, palutakse teil otsustada, kas asendada muudetud versioon või tühistada import.
Pärast rakenduse komponendi loomist saavad muud rakendused selle rakenduse komponente importida.
Märkus.
Kui teisest rakendusest imporditud komponenti muudetakse algses rakenduses, tuleb komponent uuesti rakendusse käsitsi importida, et saada värskeid komponendimuudatusi. Kasutage selle asemel komponenditeeke, et komponentide värskendustega tõhusamalt töötada .
Komponentide eksportimine rakendusest
Komponente saate eksportida faili ja alla laadida, et need saaks importida mõnda teise rakendusse.
Valige vasakpoolse paani puuvaate jaotisest Komponendid suvand Ekspordi komponendid .
Võite kasutada ka menüüd Lisa ja seejärel valida selle asemel rippmenüü Kohandatud .
Kui valite Ekspordi komponendid , laaditakse komponendid faili.
Allalaaditud komponendifail kasutab failinime laiendit.msapp .
Impordi komponendid eksporditud komponentide failist
Komponentide importimiseks eksporditud komponentide failist valige menüüst Lisa käsk Impordi komponendidja seejärel kasutage rippmenüüd Kohandatud või kasutage vasakpoolse paani puuvaates Komponendid . Valige komponentide dialoogiboksis Laadi fail üles, selle asemel, et valida muid komponente või rakendusi.
Sirvige dialoogiboksis Avamine komponendifaili asukohta ja valige Ava, et importida komponendid rakendusse.
Komponentide importimine eksporditud rakendusest
Rakenduse saate salvestada kohalikult, kasutades suvandit Fail>Salvesta nimega .
Rakenduse salvestamisel saate selle komponente uuesti kasutada, kasutades sama komponentide failist importimise meetodit. Järgige eelmise jaotise etappe, et importida komponente eksporditud komponentide failist.
Teadaolevad piirangud
- Kohandatud sisendatribuuti ei saa kohandatud väljundi atribuudi väärtuseks konfigureerida samade või erinevate eksemplaride vahel, kui teil on rakenduses vähemalt kaks sama komponendi eksemplari. Selle toimingu tulemuseks on hoiatusteade, mis kuvatakse ringviitena. Sellest piirangust möödas saate luua rakenduse sees komponendi koopia.
- Komponenditeekides Power Automate voogude lisamist ja käivitamist ei toetata.
- Te ei saa salvestada andmeallikaid ega juhtelemente, mis sisaldavad nende andmeallikate andmeid (nt vormid, komponentruudustikud või andmetabelid) koos komponentidega.
- Komponenti ei saa galeriisse või vormi lisada (sealhulgas SharePoint vormi).
- Komponendid ei toeta funktsiooni UpdateContext , kuid saate komponendis muutujaid luua ja värskendada funktsiooni Set abil . Nende muutujate ulatus on piiratud komponendiga, kuid pääsete neile juurde väljaspool komponendi kohandatud väljundi atribuutide kaudu.
Järgmised etapid
Õppige kasutama komponenditeeki korduvkasutatavate komponentide hoidla loomiseks.