Oznaka predloška Liquid za komponente koda

Napomena

Od 12. listopada 2022. portali Power Apps postaju Power Pages. Više informacija: Usluga Microsoft Power Pages je sada javno dostupna (blog)
Uskoro ćemo migrirati i spojiti dokumentaciju za portale Power Apps s dokumentacijom za Power Pages.

Power Apps component framework daje ovlasti profesionalnim razvojnim inženjerima i autorima aplikacija da stvore komponente koda za aplikacije stvorene prema modelu i aplikacije od gotovih gradivnih elemenata. Te komponente koda mogu pružiti bolji doživljaj korisnicima koji rade s podacima na obrascima, prikazima i nadzornim pločama. Dodatne informacije: Upotreba komponenti koda na portalima

Važno

Oznaka predloška Liquid za komponente koda zahtijeva verziju portala 9.3.10.x ili noviju.

S ovim izdanjem uveli smo dodavanje komponenti koda s pomoću značajke oznaka predloška Liquid na web-stranicama i omogućene komponente s pomoću Web API-ja koje su omogućene za komponente na razini polja na obrascima na portalima.

Komponente koda mogu se dodati s pomoću oznake predloška Liquid codecomponent. Ključ za označavanje komponente koda koju treba učitati prosljeđuje se s pomoću atributa name. Ključ može biti GUID (koji je ID komponente koda) ili naziv komponente koda uvezene u Microsoft Dataverse.

Vrijednosti svojstava koje komponenta koda očekuje treba proslijediti kao par ključ/vrijednost odvojeno znakom ":" (znak dvotočke), gdje je ključ naziv svojstva, a vrijednost JSON vrijednost niza.

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

Na primjer, za dodavanje komponente koda koja očekuje ulazni parametar pod nazivom controlValue, koristite sljedeću oznaku predloška Liquid:

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

Savjet

Ovaj primjer koristi parametre pod nazivom controlvalue i controlApiKey, međutim komponenta koju koristite može zahtijevati različite nazive parametara.

Možete koristiti kontrolu uzorka karte i zapakirati komponentu koda kao rješenje za upotrebu s portalima.

Napomena

Microsoft ne podržava resurse koje je stvorila zajednica. Ako imate pitanja ili poteškoća vezanih uz resurse zajednce, obratite se izdavaču tog resursa. Prije upotrebe tih resursa morate osigurati da zadovoljavaju smjernice za Power Apps component framework i trebaju se koristiti samo kao referenca.

Vodič: Upotreba komponenti koda na stranicama s oznakom predloška Liquid

U ovom vodiču konfigurirat ćete portale Power Apps za dodavanje komponente na web-stranicu. Zatim ćete posjetiti web-stranicu portala i stupiti u interakciju s komponentom.

Prije početka

Ako koristite komponentu uzorka koda korištenu u ovom vodiču, provjerite jeste li prvo uvezli uzorke rješenja u okruženje prije nego što počnete. Da biste saznali više o uvozu rješenja, pogledajte Uvoz rješenja.

Preduvjeti

Za preduvjete i upoznavanje podržanih/nepodržanih komponenti koda na portalima, pogledajte Upotreba komponenti koda na portalima.

Napomena

Ovaj vodič koristi uzorak komponente koda stvoren s pomoću značajke Power Apps component framework za demonstriranje kontrole karte na web-stranici. Umjesto toga, možete koristiti bilo koju postojeću ili novu komponentu, kao i bilo koju drugu web-stranicu za ovaj vodič. U tom slučaju, provjerite koristite li svoju komponentu i web-stranicu kada slijedite korake u ovom vodiču. Dodatne informacije o tome kako stvoriti komponente koda potražite u odjeljku Stvaranje prve komponente.

1. korak Dodavanje komponente koda na web-stranicu iz usluge Studio

1. Otvorite portal u studiju Power Apps portala.

2. U gornjem lijevom kutu odaberite Nova stranica.

3. Odaberite Prazno.

4. U desnom oknu svojstava ažurirajte naziv web-stranice. Na primjer, "Preglednik karte."

5. Ažurirajte djelomični URL. Na primjer, "mapviewer."

6. Proširite Dozvole.

7. Onemogućite Stranica je dostupna svima.

8. Odaberite web-uloge kojima bi trebao biti dopušten pristup ovoj stranici.

9. Odaberite područje koje je moguće uređivati na stranici da biste uredili izvorni kod Liquid.

10. Otvorite uređivač koda u Studiju.

11. Dodajte kontrolu s oznakom predloška Liquid koristeći sljedeću sintaksu:

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

    Savjet

    Za dohvaćanje pojedinosti o svim uvezenim komponentama i traženje naziva komponente pogledajte CustomControl Web API.

    Na primjer:

    • Za traženje komponente:

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

    • Za dohvaćanje ulaznih parametara za komponentu:

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

12. Spremite i zatvorite uređivač koda.

13. U gornjem desnom kutu odaberite Pregledaj web-mjesto.

14. Web-stranica će sad prikazati dodanu kontrolu.

Sljedeći koraci

Pregled: Upotreba komponenti koda na portalima

Pogledajte

Oznaka komponente koda Dataverse entiteta
Oznaka predloška komponente koda
Pregled okruženja Power Apps component framework
Stvaranje vaše prve komponente
Dodavanje komponenti koda stupcu ili tablici u aplikacijama stvorenim prema modelu
Implementacija ogledne komponente Web API-ja za portal

Napomena

Možete li nam reći više o željenim jezicima za dokumentaciju? Ispunite kratki upitnik. (imajte na umu da je upitnik na engleskom jeziku)

Ispunjavanje upitnika će trajati otprilike sedam minuta. Osobni podaci se ne prikupljaju (izjava o zaštiti privatnosti).