Komponenttikirjasto

Komponenttien luomisesta kerrotaan yleiskatsauksessa pohjaan perustuvan sovelluksen osista. Kun luot osia sovelluksen sisällä, voit myös luoda kirjaston osia, joita voit käyttää uudelleen. Luomalla komponenttikirjaston sovellusten tekijät voivat helposti jakaa ja päivittää yhtä tai useampaa osaa muiden tekijöiden kanssa.

Komponenttikirjastot ovat komponenttimääritysten säilöjä, joiden avulla on helppo tehdä seuraavat toimet:

  • Komponenttien löytäminen ja hakeminen.
  • Päivitysten julkaisu.
  • Saatavilla olevista päivityksistä sovellusten tekijöille ilmoittaminen.

Muistiinpano

Komponenttikirjastot ovat suositeltava tapa käyttää komponentteja uudelleen eri sovelluksissa. Kun käytössä on komponenttikirjasto, sovellus ylläpitää riippuvuuksia sen käyttämissä komponenteissa. Sovelluksen tekijä saa ilmoituksen, kun riippuvaisten osien päivityksiä tulee saataville. Näin ollen voit luoda uudelleenkäytettäviä komponentteja osien kirjastoissa. Aiempi Power Apps -ominaisuus, joka salli komponenttien tuonnin pohjaan perustuvasta sovelluksesta toiseen, on poistettu käytöstä.

Ero sovelluksen ja komponenttikirjaston välillä

Komponenttikirjasto tarjoaa keskitetyn ja hallitun komponenttisäilön uudelleenkäytettävyyttä varten.

Vasemman siirtymisruudun Lisää-ruutu muuttuu komponenttivälilehdeksi, jos luot komponenttikirjaston. Kun luot sovelluksen, tässä näkymässä näkyy komponenttien sijaan näyttöjä.

Muistiinpano

Osakirjaston näytöt ovat käytettävissä vain testausta varten. Sen avulla kirjaston luojat voivat nopeasti testata luotuja komponentteja todellisella näytöllä ja myös tarkistaa päivityksen toiminnan, kun komponentteja parannetaan ajan mittaan. Jos haluat käyttää komponentteja komponenttikirjastosta, sinun täytyy luoda sovellus, joka käyttää komponenttikirjastoa.

Voit esikatsella osan kirjaston osia käyttämällä kirjaston sisältämiä näyttöjä Toisto-vaihtoehdon kanssa. Kun valitset komponenttivälilehden, toistovaihtoehto poistetaan käytöstä. Komponenttikirjasto ei ole näkyvissä, kun käytetään Power Apps Mobilea.

Muistiinpano

Tässä artikkelissa käsitelty komponenttikirjasto eroaa Power Apps Component Frameworkista, jonka avulla kehittäjät ja tekijät voivat luoda koodikomponentteja mallipohjaisille ja kaaviosovelluksille. Lisätietoja on kohdassa Power Apps -osakehyksen yleiskatsaus.

Komponenttikirjaston käyttö

Voit luoda uuden komponenttikirjaston tai muokata aiemmin luotua komponenttikirjastoa samasta liittymästä. Valitse Power Appsissa> vasemmassa siirtymisruudussa Lisää> valitse sitten Tutustu kaikkeen> valitse KomponenttikirjastotSovelluksen parannukset -osassa. Voit myös kiinnittää Komponenttikirjastot-vaihtoehdon Power Apps -käyttöliittymään. Lisätietoja on kohdassa Vasen siirtymisruutu Power Apps.

Esimerkkikomponenttikirjaston luominen

Komponenttien komponenttikirjastossa luomisen vaiheet ovat samat kuin komponenttien sovelluksessa luomisen. Luot komponenttikirjaston ja noudatat sitten uudelleen komponenttien luomisen komponenttien yleiskatsausesimerkissä esitettyjä vaiheita. Sen jälkeen voit käyttää -osakirjastoa uudelleenkäytettävissä olevien osien tarjoamiseen uudessa sovelluksessa.

  1. Kirjaudu Power Appsiin.

  2. Valitse vasemmassa siirtymisruudussa Komponenttikirjastot ja valitse sitten Uusi komponenttikirjasto. Vaihtoehtoisesti jos et näe Komponenttikirjastoja vasemmassa siirtymisruudussa, valitse Lisää vasemmasta siirtymisruudusta, valitse Etsi kaikki -painike ja valitse OsakirjastotSovellustenparannukset - osasta.

  3. Nimeä osakirjaston Valikko-osat. tai anna valitsemallesi nimelle uusi nimi.

  4. Noudata komponenttien yleiskatsausesimerkissä esitettyjä komponenttien luomisen vaiheita. Sinun ei tarvitse avata Power Apps Studiota tai luoda uutta tyhjää sovellusta, koska olet jo luonut uuden komponenttikirjaston. Aloita vaiheesta 2.

    Kun olet suorittanut komponenttien luomisen vaiheet, noudata seuraavaa vaihejoukkoa lisätäksesi komponentteja näyttöön ja luodaksesi tulosominaisuuden.

  5. Kun olet suorittanut osien luomisen ja testauksen, tallenna komponenttikirjasto valitsemalla Tallenna-kuvake sovelluksen toiminnoista.

    Voit myös halutessasi tallentaa versiohuomautuksetTallenna-kuvakkeen vieressä olevan nuolivalikon alla. Versiomuistiinpano on hyödyllinen, kun noudetaan komponenttikirjaston versioita ja päivitetään sen sovelluksissa käytettyjä komponentteja. Lisätietoja sovelluksen toiminnoista on artikkelissa Tutustu Power Apps Studioon.

    Versiomuistiinpano tallennettaessa komponenttikirjastoa.

    Vihje

    Versiomuistiinpano on hyödyllinen, kun tarkistetaan komponenttikirjaston versioita. Se on hyödyllinen myös komponenttikirjastoa käyttäville sovellusten tekijöille, kun he tarkistavat muutoksia ja päivittävät sovelluksia käyttäen näitä komponentteja tarpeen mukaan. Lisätietoja on komponenttikirjaston päivittämisen kohdassa.

  6. Voit julkaista tallennetun osakirjaston. Vain julkaistuja komponenttikirjaston päivityksiä on käytettävissä sovelluksissa, jotka käyttävät komponenttikirjastoa. Julkaise osakirjastoversio valitsemalla Julkaise-kuvake sovelluksen toiminnoista:

    Komponenttikirjaston version julkaiseminen.

Kirjaston komponenttien mukauttaminen

Kun luot komponentin osakirjaston sisällä, voit määrittää, voivatko kirjaston osia käyttävät sovellukset mukauttaa osaa. Tämä asetus on oletusarvoisesti Käytössä osien ominaisuuksissa. Poista tämä asetus käytöstä , jos haluat poistaa mahdollisuuden mukauttaa komponenttia muissa sovelluksissa.

Mahdollisuus sallia mukautus tähän komponenttiin, kun sovellus käyttää sitä.

Kun lisäät komponentin, joka sallii mukauttamisen, näet mahdollisuuden muokata tätä osaa mukauttamista varten. Sovellus tekee paikallisen kopion, ja voit tehdä muutoksia paikalliseen osan kopioon. Yhteys osakirjastoon poistetaan, kun muokkaat osaa.

Muokkaa mukautusta varten sallittua osaa.

Jos valitset Muokkaa osaa, sinua kehotetaan kopioimaan komponentti paikallisesti mukauttamista varten.

Jos et salli osien mukauttamista, kuluttavat sovellukset eivät näytä komponentin muokkausvalintaa.

Ei mahdollisuutta muokata komponenttia kuluttavassa sovelluksessa.

Tässä tapauksessa ainoa tapa muokata komponenttia on muokata komponenttikirjastoa, johon komponentti on tallennettu.

Tuominen komponenttikirjastosta

Kun olet luonut ja julkaissut osakirjaston, sovellukset voivat kuluttaa tämän osakirjaston komponentteja tuomalla -kirjaston. Voit myös jakaa komponenttikirjaston.

Jos haluat tuoda komponentteja komponenttikirjastosta, muokkaa aiemmin luotua sovellusta tai luo uusi sovellus. Kun sovellus avautuu kaaviosovelluksen studiossa, valitse Lisää tai + vasemmanpuoleisessa siirtymisruudussa. Valitse sitten Hae lisää komponentteja avataksesi luettelon kulloisessakin ympäristössä käytettävissä olevista kirjastoista:

Hae lisää komponentteja.

Näet nykyisen ympäristön saatavilla olevien komponenttikirjastojen luettelon näytön oikealla puolella. Valitse yksittäinen komponentti komponenttikirjastosta. Voit myös tuoda kaikki komponentit kirjastosta kerralla valitsemalla Valitse kaikki:

Komponenttien tuonti.

Muistiinpano

Jos tekijä ei näe komponenttikirjastoa tuontiosassa, varmista, että komponenttikirjasto on jaettu tekijän kanssa. Lisätietoja on kohdassa osakirjaston käyttöoikeudet.

Muistiinpano

Voit valita ja tuoda useita komponentteja ja eri komponenttikirjastoja.

Sovelluksen sisällä käytettävissä olevat komponentit näkyvät Lisää-ruudun komponenttiluettelon Mukautettu-luokassa. Tuoduissa komponenttikirjastoissa käytettävissä olevat komponentit näkyvät luokassa Kirjastokomponentit:

Komponenttien lisääminen sovellukseen.

Komponenttikirjaston päivittäminen

Voit muokata aiemmin luotua komponenttikirjastoa ja tallentaa muutokset muihin versioihin. Päivitetty komponenttikirjaston versio on kuitenkin julkaistava käytettäväksi olemassa olevissa sovelluksissa, jotka käyttävät kyseistä komponenttikirjastoa. Osakirjaston esimerkkivaiheissa selitetään, miten osakirjasto julkaistaan sen tallentamisen jälkeen.

Kirjaston osia käyttävät sovellukset voivat saada uusimmat muutokset kahdella tavalla.

Menetelmä 1: Osan päivityksen ilmoitus sovelluksen muokkauksessa

Muiden sovellusten tekijät saavat ilmoituksen, kun päivitetyt komponentit ovat saatavilla. Ilmoitus tulee näkyviin, kun tekijät muokkaavat sovelluksia kaaviosovellusstudiossa. He voivat halutessaan päivittää komponentit:

Päivitys saatavilla.

Valitse Tarkista, niin näet komponentin päivitysvaihtoehdon:

Komponentin päivitys.

Kun julkaiset osakirjastoversion, lisäämäsi versiotiedot näkyvät tässä.

Päivitä komponentit valitsemalla Päivitä.

Menetelmä 2: Päivitysten ennakoiva tarkistus

Tämän menetelmän avulla voit tarkistaa ennakoivasti sovelluksen päivityksen, kun työskentelet sovelluksen parissa Studiossa.

Jos haluat tehdä tämän tarkistuksen, valitse vasemmalla puolella Lisää osa -paneeli ja valitse sitten Tarkista päivityksiä -kuvake.

Viimeisimpien komponenttien tarkastus

Jos kirjastossa käytettäviä osia päivitetään, näyttöön tulee viesti, jossa voit tarkistaa ja saada uusimmat muutokset. Kun tarkistat ja päivität, sovellukseen päivitetään uusimmat osat.

Komponenttikirjaston komponentin päivittäminen kuluttavassa sovelluksessa

Jos tuot komponentin komponenttikirjastosta, sitä ei voi muokata sitä käyttävässä sovelluksessa. Jos valitset Muokkaa-osan, näet vaihtoehdon, jolla voit luoda kopion komponentista nykyisen sovelluksen sisällä, jotta voit tehdä muutoksia:

Kirjastokomponentin muokkaus.

Jos valitset Luo kopio, komponentti kopioidaan paikalliseen sovellukseen. Komponentin paikallinen kopio näkyy Lisää-ruudun Mukautettu-luokassa. Tämä osan paikallinen kopio ei saa päivityksiä, jos alkuperäisestä osakirjastosta julkaistaan myöhemmin uusi versio.

Muistiinpano

Osien käytönaikaisiin esiintymiin osakirjastossa ei vaikuteta sen jälkeen, kun olet luonut komponentista paikallisen kopion, ja ne pysyvät linkitettyinä osakirjaston määritykseen. Vain paikallisesti kopioitujen komponenttien esiintymät (luokasta Mukautettu) tulkitaan paikallisiksi sovelluskomponenteiksi.

Komponenttikirjaston poistaminen

Jos pohjaan perustuva sovellus viittaa komponenttikirjastoon, sitä ei voi poistaa. Tämä ehto koskee sekä Power Platform -ympäristöjä että muita kuin Power Platform -ympäristöjä. Poista komponentti sovelluksesta, ennen kuin poistat kirjaston. Voit etsiä tietoja komponenttikirjastoa käyttävistä sovelluksista joko ratkaisun riippuvuuksien näkymästä tai viestistä, joka tulee näkyviin, kun yrität poistaa kirjastoa.

Poista kirjastokomponentti.

Komponenttikirjaston oikeudet

Komponenttikirjaston jakaminen toimii samalla tavalla kuin kaaviosovelluksen jakaminen Kun jaat komponenttikirjaston, muut käyttäjät voivat käyttää komponenttikirjastoa uudelleen. Kun komponenttikirjasto on jaettu, muut voivat muokata komponenttikirjastoa ja tuoda komponentteja tästä jaetusta komponenttikirjastosta sovellusten luomista ja muokkaamista varten. Jos se on jaettu rinnakkaisomistajille, käyttäjä voi käyttää, muokata tai jakaa komponenttikirjastoa, muttei poistaa sitä tai vaihtaa omistajaa.

Muita huomioon otettavia seikkoja jaettaessa komponenttikirjastoja käyttöoikeusryhmiin:

  • Käyttöliittymän jakoa ei voi käyttää, kun ratkaisun osana luotuja komponenttikirjastoja luodaan. Sen sijaan on käytettävä Set-PowerAppRoleAssignment-cmdlet-komentoa ja CanEdit-oikeustasoa komponenttikirjastojen jakamiseen valitun käyttöoikeusryhmän kanssa.
  • Power Platform -ympäristössä ilman Dataverse-tietokantaa luodut komponenttikirjastot, jotka jaetaan yhteisomistajana, myöntävät automaattisesti CanEdit-oikeuden valitulle käyttöoikeusryhmälle.

Tunnetut rajoitukset

  • Komponentteja koskevat tunnetut rajoitukset koskevat myös osien kirjastoja.

  • Et voi tuoda komponentteja paikallisesti tallennetusta komponenttikirjastosta. Voit ladata osakirjaston valitsemalla Lataa kopio sovelluksen toiminnoista. Jos yrität tuoda tallennetun osan kirjaston, näyttöön tulee seuraava virhesanoma:

    Komponenttikirjastotiedoston tuonti.

  • Jos tuot sovellusta ja komponenttikirjastoa ympäristössä ensimmäistä kertaa, varmista, että sovellus käyttää komponenttikirjastoon sisältyvän komponentin uusinta versiota. Muussa tapauksessa sovellus ei saa päivityksiä tuonnin jälkeen. Sovellus tunnistaa päivitetyn version ja kehottaa käyttämään sitä, kun komponenttikirjasto tuodaan myöhemmin uudelleen samaan ympäristöön.

  • Komponenttikirjastoissa ei tueta koodikomponentteja.

Katso myös