Liquid-mallitunniste koodikomponenteille

  • Artikkeli

Huomautus

Power Apps -portaaleja kutsutaan 12. lokakuuta 2022 alkaen nimellä Power Pages. Lisätietoja: Microsoft Power Pages on nyt yleisesti saatavilla (blogi)
Siirrämme ja yhdistämme Power Apps -portaalien dokumentaation pian Power Pagesin dokumentaatioon.

Power Apps component framework antaa mahdollisuuden ammattikehittäjille ja sovellussuunnittelijoille luoda koodikomponentteja mallipohjaisiin sovelluksiin ja pohjaan perustuviin sovelluksiin. Nämä koodikomponentit voivat tarjota paremman kokemuksen käyttäjille, jotka työskentelevät lomakkeiden, näkymien ja koontinäyttöjen tietojen kanssa. Lisätietoja: Koodikomponenttien käyttö portaaleissa

Tärkeä

Liquid-mallitunniste koodikomponenteille vaatii portaaliversion 9.3.10.x tai uudemman.

Tämän julkaisun myötä olemme ottaneet käyttöön mahdollisuuden lisätä koodikomponentteja verkkosivuille Liquid-mallitunnisteen avulla ja verkko-ohjelmointirajapinnan avulla käyttöön otettuja komponentteja, jotka ovat käytössä portaalien lomakkeiden kenttätason komponentteja varten.

Koodikomponentteja voi lisätä käyttämällä Liquid-mallitunnistetta codecomponent. Avain, joka tarkoittaa koodikomponenttia, joka on ladattava, välitetään käyttämällä määritettä name. Avain voi olla GUID (joka on koodikomponentin tunnus) tai Microsoft Dataverseen tuodun koodikomponentin nimi.

Koodikomponentin odottamien arvojen ominaisuudet on välitettävä merkin ":" (kaksoispiste) erottamana avain-arvo-parina, jossa avain on ominaisuuden nimi ja arvo on JSON-merkkijonoarvo.

{% codecomponent name: <ID or name> <property1:value> <property2:value> %}

Esimerkiksi, lisätään koodikomponentti, joka odottaa syöteparametriä nimeltä controlValue käyttämällä seuraavaa Liquid-mallitunnistetta:

{% codecomponent name:abc_SampleNamespace.MapControl controlValue:'Space Needle' controlApiKey:<API Key Value>%}

Vihje

Tämä esimerkki käyttää parametrejä nimeltä controlvalue ja controlApiKey, siinä missä käyttämäsi komponentti saattaa edellyttää erilaisia parametrien nimiä.

Voit käyttää kartan ohjausobjektin mallia ja pakata koodikomponentin ratkaisuksi käytettäviksi portaalin kanssa.

Huomautus

Microsoft ei tue yhteisön luomia resursseja. Yhteisön resursseja koskevat kysymysten tai ongelmien osalta on otettava yhteyttä resurssin julkaisijaan. Ennen kuin käytät näitä resursseja, sinun on varmistettava, että ne vastaavat Power Apps component frameworkin ohjeita, ja niitä tulisi käyttää vain viitteellisesti.

Opasohjelma: Koodikomponenttien käyttäminen sivuilla, joilla on Liquid-mallitunniste

Tässä opasohjelmassa määrität Power Apps -portaalit komponentin lisäämiseksi verkkosivulle. Tämän jälkeen siirryt portaalin verkkosivulle ja käsittelet komponenttia.

Alkutoimet

Jos käytät tässä opasohjelmassa käytettyä mallikoodikomponenttia, varmista, että tuot malliratkaisut ympäristöön ennen aloittamista. Lisätietoja ratkaisujen tuonnista löytyy kohdasta Ratkaisujen tuonti.

edellytykset

Lisätietoja edellytyksistä ja portaalien tuetuista ja ei-tuetuista koodikomponenteista löytyy kohdasta Koodikomponenttien käyttö portaaleissa.

Huomautus

Tämä opasohjelma käyttää mallikoodikomponenttia, joka on luotu käyttäen Power Apps component frameworkia, jotta voidaan esitellä kartan ohjausobjektia verkkosivuilla. Voit käyttää opasohjelmassa myös mitä tahansa omaa aiemmin luotua tai uutta komponenttia sekä mitä tahansa muuta verkkosivua. Siinä tapauksessa varmista, että käytät omaa komponenttia ja verkkosivua, kun noudatat tämän opasohjelman vaiheita. Lisätietoja koodikomponenttien luomisesta löytyy kohdasta Luo ensimmäinen komponenttisi.

Vaihe 1: Koodikomponentin lisääminen studiosta verkkosivulle

  1. Avaa portaali  Power Apps -portaalistudiossa.

  2. Valitse vasemmasta yläkulmasta Uusi sivu.

  3. Valitse Tyhjä.

  4. Päivitä verkkosivun nimi oikeanpuoleisessa ominaisuusruudussa. Esimerkiksi "Kartan katseluohjelma."

  5. Päivitä osittainen URL-osoite. Esimerkiksi "mapviewer."

  6. Laajenna Oikeudet-kohta.

  7. Poista käytöstä Sivu on kaikkien käytettävissä -vaihtoehto.

  8. Valitse verkkoroolit, joille tämän sivun käyttöoikeus pitäisi myöntää.

  9. Valitse muokattava alue sivulla, jos haluat muokata Liquid-lähdekoodia.

  10. Avaa studion koodieditori.

  11. Lisää ohjausobjekti ja Liquid-mallitunniste käyttämällä seuraavaa syntaksia:

    {% codecomponent name:abc\_SampleNamespace.MapControl controlValue:'Space Needle' controlApiKey:<API Key Value> %}

    Vihje

    Jotta voit noutaa kaikkien tuotujen komponenttien tiedot ja hakea komponentin nimeä, katso CustomControl-www-ohjelmointirajapinta.

    Esimerkki:

    • Komponenttien hakeminen:

      https://contoso.api.crm10.dynamics.com/api/data/v9.2/customcontrols?$select=ContosoCustomControlName

    • Komponentin syöteparametrien noutaminen:

      https://contoso.api.crm10.dynamics.com/api/data/v9.2/customcontrols?$filter=name eq 'ContosoCustomControlName' &$select=manifest

  12. Tallenna ja sulje koodieditori.

  13. Valitse oikeassa yläkulmassa Selaa sivustoa.

  14. Verkkosivu näkyy nyt lisätyn ohjausobjektin kanssa.

Seuraavat vaiheet

Yleiskuvaus: Koodikomponenttien käyttäminen portaaleissa

Katso myös

Koodikomponentin Dataverse-entiteettitunniste
Koodikomponentin mallitunniste
Power Apps component framework -yleiskatsaus
Ensimmäisen komponentin luominen
Koodikomponenttien lisääminen sarakkeeseen tai taulukkoon mallipohjaisissa sovelluksissa
Esimerkkiportaalin verkko-ohjelmointirajapinnan komponentin toteuttaminen

Huomautus

Voitko kertoa meille dokumentaatiota koskevan kielimäärityksesi? Vastaa lyhyeen kyselyyn. (Huomaa, että tämä kysely on englanninkielinen.)

Kyselyyn vastaaminen kestää noin seitsemän minuuttia. Henkilökohtaisia tietoja ei kerätä (tietosuojatiedot).