Lõuendikomponentide ülevaade

Märkus.

• See osa selgitab lõuendi komponente, mis hõlmavad madala koodiga kasutajaliidese laiendatavust. Professionaalsed arendajad saavad kasutada ka Power Apps komponendiraamistikku koodikomponentide loomiseks.
• Lõuendi komponente saab kasutada ka mudelipõhistes rakendustes, kasutades kohandatud lehti ja komponenditeeki. Lisateabe saamiseks vaata Lisa lõuendi komponente kohandatud lehele mudelipõhises rakenduses.

Komponendid on korduvkasutatavad ehitusplokid lõuendirakendustele. Rakenduste loojad saavad luua kohandatud juhtnuppe, mida kasutada rakenduse sees või rakenduste vahel, kasutades komponentteeki. 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 juhtimismustrid. Kui värskendate rakenduse komponendi määratlust, kajastavad teie muudatused kõikides rakenduse instantsides. Komponendid vähendavad ka pingutuse dubleerimist, kõrvaldades vajaduse kopeerida ja kleepida kontrolle ning parandades jõudlust. Kui kasutad komponentide teeki, aitavad komponendid luua koostööl põhinevat arendust ning standardiseerida organisatsiooni välimust ja tunnetust.

Et õppida, kuidas kasutada komponente lõuendirakendustes, vaata seda videot:

Lõuendirakenduste komponendid

Komponendi saate luua rakenduses, nagu selles artiklis selgitatud, või luues uue komponendi komponenditeegis. Kasuta komponentide teeki, kui vajad komponente mitme rakenduse ekraani vahel. Saad ka olemasolevaid komponente kopeerida olemasolevasse või uude komponenditeeki.

Rakenduses komponendi loomiseks minge puuvaatesse, valige vahekaart Komponendid ja seejärel valige Uus komponent.

Uue komponendi valimisel avaneb tühi lõuend. Lisa juhtnupud komponendi definitsiooni osana lõuendil. Kui muudate komponenti lõuendil, uuendate sama komponendi eksemplare teistes rakenduste ekraanides. 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 olevad komponendid kuvatakse kategoorias Kohandatud kategoorias komponentide nimekirjas puuvaates. Komponentide teekidest imporditud komponendid kuvatakse kategoorias Raamatukogu komponendid :

Märkus.

Selles artiklis käsitletud komponendid erinevad Power Apps komponendiraamistikust, mis võimaldab arendajatel ja loojatel luua koodikomponente mudelipõhiste ja lõuendirakenduste jaoks. Lisateabe saamiseks vaata 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

1. Looge tühi lõuendirakendus.

2. Valige puuvaates Komponendidja seejärel valige uue komponendi loomiseks Uus komponent .

   

3. Valige vasakpoolsel paanil uus komponent, valige kolmikpunkt (...) ja seejärel valige Nimeta ümber. Tippige või kleepige nimi kujul MenuComponent.

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

   

5. Tippige või kleepige väljadele Kuvatav nimi, Atribuudi nimi jaKirjeldus tekst nimegaÜksused .

   

   Ära lisa omaduse nimesse tühikuid, sest sa viitad komponendile selle nimega, kui kirjutad valemit. 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 .

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

7. Määrake komponendi atribuudi Üksused väärtuseks järgmine valem.

   Table({Item:"SampleText"})
   

   

8. Sisestage komponendis tühi vertikaalne juhtelement Galerii ja valige atribuudipaanil Paigutus kui Pealkiri.

9. Veenduge, et atribuudiloendis oleks kuvatud atribuut Üksused (nagu see on vaikimisi). Seejärel määrame selle omaduse väärtuseks järgmise avaldise:

   MenuComponent.Items
   

   Sel viisil loeb juhtelemendi Galerii atribuut Üksused ja sõltub komponendi sisendatribuudist Üksused .

10. (Valikuline) Sea Gallery juhtimise BorderThickness omadus 1 ja TemplateSize omadus 50. Vajadusel saate muuta ka äärise paksuse ja malli suuruse väärtusi.

Komponendi lisamine ekraanile

Seejärel lisa komponent ekraanile ja määra stringide tabel, mida komponent kuvab.

1. Valige vasakpoolsel paanil ekraanide loend ja seejärel vaikimisi kuvatav ekraan.

   

2. Avage vahekaardil Lisa menüü Komponendid ja seejärel valige MenuComponent .

   

   Uue komponendi nimi on vaikimisi MenuComponent_1 .

3. 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 oled loonud komponendi ja lisanud selle rakendusse. Seejärel loo väljundomadus, mis kajastab menüüs valitud üksust.

1. Avage komponentide loend ja seejärel valige MenuComponent.

2. Valige parempoolsel paanil vahekaart Atribuudid ja seejärel valige Uus kohandatud atribuut.

3. Tippige või kleepige väljadele Kuvatav nimi, Atribuudi nimi ja Kirjeldus väärtus Valitud .

4. Valige jaotises Atribuudi tüüp Väljund ja seejärel valige Loo.

   

5. Määrake vahekaardil Täpsemalt atribuudi Valitud väärtuseks see avaldis, kohandades vajadusel galerii nimes olevat numbrit.

   Gallery1.Selected.Item
   

   

6. Lisage rakenduse vaikekuval silt ja määrake selle atribuut Tekst sellele avaldisele, kohandades vajadusel komponendi nimes olevat numbrit.

   MenuComponent_1.Selected
   

   MenuComponent_1 on eksemplari vaikenimi, mitte komponendi definitsiooni nimi. Võite iga eksemplari ümber nimetada.

7. Muuteklahvi (ALT) all hoides valige menüüst kõik üksused.

   Juhtelement Silt kajastab viimati valitud menüü-üksust.

Ulatus

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 olukordi, kus komponent võib soovida jagada andmeallikat või muutujat oma hostiga. See jagamine on eriti kasulik, 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 lülitate sisse Access rakenduse ulatuse, on järgmised elemendid komponendist ligipääsetavad:

• Globaalsed muutujad
• Kogumid
• Juhtelemendid ja komponendid ekraanidel, nagu TextInput juhtelement
• Tabelandmeallikad, näiteks Dataverse tabelid

Kui selle seade välja lülitada, ei pääse komponent ühelegi eelnevale esemele ligi.  Set ja Collect funktsioonid on endiselt saadaval, kuid tulemuseks olevad muutujad ja kogumid on piiratud komponendi instantsiga ega ole rakendusega jagatud.

Mittetabelilised andmeallikad, nagu Azure Blob Storage või kohandatud ühendus, on saadaval olenemata sellest, kas see seade on sisse lülitatud või väljas. Mõelge neile andmeallikatele rohkem nagu viitamine keskkonnaressursile, mitte rakenduseressursile. Kui komponent saadetakse komponenditeegi rakendusse, asuvad need keskkonna andmeallikad samuti komponendikogus.

Komponenditeegi komponendid ei saa kunagi rakenduse ulatusele ligi pääseda, kuna pole ühte rakenduse ulatust, millele viidata. Seega pole see säte selles kontekstis saadaval ja see on tegelikult välja lülitatud. Kui see on rakendusse imporditud ja komponendi tootja lubab kohandamist, saab lüliti lubada ning komponenti saab muuta rakenduse ulatuse kasutamiseks.

Märkus.

• Saate lisada komponentide instantse komponendi teegi ekraanile ja vaadata seda ekraani eelvaates testimise eesmärgil.
• Komponenditeek ei kuvata Power Apps Mobile kasutamisel.

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 looja saab teate, kui sõltuvate komponentide uuendused muutuvad kättesaadavaks. Seega tuleks kõik uued korduvkasutatavad komponendid luua hoopis komponendi teekides.

Komponentide importimise ja eksportimise võimalus on vaikimisi keelatud, kuna see funktsioon on eemaldatud. Kuigi soovitatav meetod komponentidega töötamiseks on komponentide teekide kasutamine, saab selle funktsiooni siiski lubada iga rakenduse kaupa erandina, kuni funktsioon eemaldatakse. Selleks muuda oma rakendust Power Apps Studios ja seejärel mine Settings>Coming features>Retired> Sea Export and import components On.

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 rakendusse vali Insertmenüüst Import components ja kasuta seejärel Custom rippmenüüd. 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 saad oma koopiat muuta ja kustutada kõik, mida pole 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 saad lokaalselt salvestada, valides Faili>salvestamise kui:

Pärast rakenduse salvestamist saad selle komponente uuesti kasutada, importides need failist. Lisateabe saamiseks vaata eelmist osa komponentide importimisest eksporditud komponentide failist.

Teadaolevad piirangud

• Kui rakenduses on kaks või enam sama komponendi eksemplari, ei saa sa seadistada kohandatud sisendi omadust kohandatud väljundomaduse väärtusele sama või erinevate instantside vahel. See tegevus annab ringikujulise viitehoiatusteate. Selle piirangu vältimiseks loo rakenduses komponendi koopia.
• Power Automate'i voogude lisamine ja käivitamine komponentteekides ei ole toetatud.
• Te ei saa salvestada andmeallikaid ega juhtelemente, mis sisaldavad nende andmeallikate andmeid (nt vormid, komponentruudustikud või andmetabelid) koos komponentidega.
• Sa ei saa lisada komponenti galeriisse ega vormi (sh 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 sammud

Õppige kasutama komponenditeeki korduvkasutatavate komponentide hoidla loomiseks.

Vt ka

• Komponentide raamatukogu
• Komponenditeegi rakenduse elutsükli haldus (ALM)
• Komponendi sisendväljade kaardistamine
• Multimeediumi lisamine komponendile
• Komponentide käitumisvalemid
• Power Apps komponendiraamistik
• Lõuendikomponentide lisamine mudelipõhise rakenduse kohandatud lehele