Kopīgot, izmantojot

Koda komponentu Liquid veidnes tags

  • Raksts

Piezīme

No 2022. gada 12. oktobra, Power Apps portāli ir Power Pages. Papildinformācija. Pakalpojums Microsoft Power Pages tagad ir vispārēji pieejams (emuārs)
Drīzumā Power Apps portālu dokumentācija tiks migrēta un sapludināta ar Power Pages dokumentāciju.

Power Apps component framework sniedz iespēju profesionāliem izstrādātājiem un programmu veidotājiem izveidot modeļa un pamatnes programmām koda komponentus. Šie koda komponenti var uzlabot lietošanas iespējas lietotājiem, kas strādā ar datiem veidlapās, skatos un informācijas paneļos. Papildu informācija: Izmantojiet kodu komponentus portālos

Svarīgi

Liquid veidnes atzīmei ir nepieciešama portālu versija 9.3.10.x vai jaunāka.

Ar šo laidienu mēs esam ieviesuši kodu komponentu pievienošanu, izmantojot Liquid veidnes atzīmi tīmekļa lapās un iespējojuši komponentus, izmantojot tīmekļa API, kas ir iespējoti lauku līmeņa komponentiem portālu veidlapās.

Koda komponentus var pievienot, izmantojot Liquid veidnes atzīmi codecomponent. Atslēga koda komponenta apzīmēšanai, kas ir jāielādē, tiek nodota, izmantojot name atribūtu. Atslēga var būt GUID (kas ir koda komponenta ID) vai programmā Microsoft Dataverse importētā koda komponenta nosaukums.

Koda komponentam sagaidāmo rekvizītu vērtības ir jānodod kā atslēgas/vērtību pāris, kas atdalīts ar ":" (kols), kur atslēga ir rekvizīta nosaukums un vērtība ir JSON virknes vērtība.

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

Piemēram, lai pievienotu koda komponentu ar Liquid veidnes atzīmi, kurā bija paredzēts ievades parametrs ar nosaukumu controlValue:

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

Padoms

Šajā piemērā tiek izmantoti parametri, ko sauc par controlvalue un controlApiKey, tomēr komponentam, ko lietojat, var būt nepieciešami dažādi parametru nosaukumi.

Varat izmantot kartējuma parauga vadīklu un iepakot koda komponentu kā risinājumu lietošanai ar portāliem.

Piezīme

Kopienas izveidotie rīki netiek atbalstīti risinājumā Microsoft. Ja rodas jautājumi vai problēmas ar kopienas resursiem, sazinieties ar resursa izstrādātāju. Pirms šo resursu izmantošanas ir jānodrošina, ka šie kopienas resursi atbilst Power Apps component framework vadlīnijām, un tos drīkst izmantot tikai atsauces nolūkam.

Pamācība: izmantojiet koda komponentus lapās ar Liquid veidnes atzīmi

Šajā pamācībā jūs konfigurēsiet Power Apps portālus, lai komponentu pievienotu tīmekļa lapai. Un pēc tam jūs apmeklēsie portālu tīmekļa lapu un mijiedarbosieties ar komponentu.

Pirms sākt darbu

Ja izmantojat šajā reģionā izmantoto parauga koda komponentu, pirms nākamo darbību sākšanas pārliecinieties, vai vispirms importējat parauga risinājumus vidē. Informāciju par risinājumu importēšanu skatietRisinājumu importēšana.

Priekšnoteikumi

Par priekšnosacījumiem un portalos atbalstītajiem/neatbalstītajiem koda komponentiem skatiet Koda komponentu izmantošana portālos.

Piezīme

Š‎ī pamācība izmanto parauga koda komponentu, kas izveidots, izmantojot Power Apps component framework, lai demonstrētu kartējuma vadīklu tīmekļa lapā. Tā vietā jūs varat lietot arī jebkuru esošu vai jaunu komponentu, kā arī jebkuru citu tīmekļa lapu šai pamācībai. Šādā gadījumā pārliecinieties, ka lietojat savu komponentu un tīmekļa lapu, izpildot šajā tīmekļa pamācībā norādītās darbības. Papildu informāciju par koda komponentu izveidi skatiet Pirmā komponenta izveide.

1. darbība. Koda komponenta pievienošana tīmekļa lapai no Studio

  1. Atveriet savu portālu portālos Power Apps Studio.

  2. Augšējā kreisajā stūrī atlasiet Jauna lapa.

  3. Atlasiet Tukšs.

  4. Labajā rekvizītu rūtī atjauniniet tīmekļa lapas nosaukumu. Piemēram, "Karšu skatītājs."

  5. Atjauniniet daļējo URL. Piemēram, "mapviewer."

  6. Izvērsiet Atļaujas.

  7. Atspējot Lapa pieejama visiem.

  8. Atlasiet tīmekļa lomas, kurām ir jāatļauj piekļuve šai lapai.

  9. Atlasiet rediģējamo apgabalu lapā, lai rediģētu Liquid avota kodu.

  10. Atvērt studijas koda redaktoru.

  11. Pievienojiet vadīklu ar Liquid veidnes atzīmi, izmantojot šādu sintaksi:

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

    Padoms

    Lai izgūtu visu importēto komponentu detalizēto informāciju un meklētu komponenta nosaukumu, skatiet CustomControl tīmekļa API.

    Piemēram:

    • Lai meklētu komponentu:

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

    • Lai izgūtu komponenta ievades parametrus:

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

  12. Koda redaktora saglabāšana un aizvēršana.

  13. Augšējā labajā stūrī atlasiet Pārlūkot tīmekļa vietni.

  14. Tagad tīmekļa lapā tiks rādīta tai pievienotā vadīkla.

Nākamās darbības

Pārskats: Koda komponentu izmantošana portālos

Skatiet arī:

Codecomponent Dataverse entītijas atzīme
Codecomponent veidnes atzīme
Power Apps komponentu struktūras pārskats
Izveidojiet pirmo komponentu
Koda komponentu pievienošana kolonnai vai tabulai modeļa vadītā programmā
Portāla tīmekļa API komponenta parauga ieviešana

Piezīme

Kādas ir jūsu dokumentācijas valodas preferences? Aizpildiet īsu aptauju. (ņemiet vērā, ka aptauja ir angļu valodā)

Aptaujai būs nepieciešamas aptuveni septiņas minūtes. Nekādi personas dati netiks vākti (paziņojums par konfidencialitāti).