Eticheta de șablon Liquid pentru componente de cod

Notă

Începând cu 12 octombrie 2022, portalurile Power Apps sunt Power Pages. Mai multe informații: Microsoft Power Pages este acum disponibil în general (blog)
În curând vom migra și vom îmbina documentația portalurilor Power Apps cu documentația Power Pages.

Power Apps component framework permite dezvoltatorilor profesioniști și creatorilor de aplicații să creeze componente de cod pentru aplicații proiectate pe bază de model și pe pânză. Aceste componente de cod pot oferi o experiență îmbunătățită utilizatorilor care lucrează cu date despre formulare, vizualizări și tablouri de bord. Mai multe informații: Utilizarea componentelor de cod în portaluri

Important

Eticheta șablon Liquid pentru componentele codului necesită versiunea de portaluri 9.3.10.x sau o versiune ulterioară.

Cu această versiune, am introdus posibilitatea de a adăuga componente de cod create folosind eticheta de șablon Liquid pe paginile web și componentele activate folosind API-uri web care sunt activate pentru componente la nivel de câmp în formularele din portaluri.

Componentele codului pot fi adăugate utilizând eticheta de șablon Liquid codecomponent. Cheia pentru desemnarea componentei de cod care trebuie încărcată este transmisă folosind atributul name. Cheia poate fi GUID (care este ID-ul componentei de cod) sau numele componentei de cod importate în Microsoft Dataverse.

Valorile proprietăților pe care estimate de componenta de cod trebuie să fie transmise ca pereche cheie/valoare separată prin ":" (semnul două puncte), unde cheia este numele proprietății și valoarea este valoarea șirului JSON.

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

De exemplu, pentru a adăuga o componentă de cod care așteaptă un parametru de intrare numit controlValue, utilizați eticheta șablon Liquid următoare:

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

Sfat

Acest exemplu folosește parametri numiți controlvalue și controlApiKey, dar componenta pe care o utilizați poate necesita nume diferite de parametri.

Puteți utiliza controlul pentru eșantionul de hartă și să ambalați componenta de cod ca soluție pentru utilizarea cu portaluri.

Notă

Resursele create de comunitate nu sunt acceptate de Microsoft. Dacă aveți întrebări sau probleme cu resursele comunității, contactați editorul resursei. Înainte de a utiliza aceste resurse, trebuie să vă asigurați că îndeplinesc cerințele din îndrumările pentru Power Apps component framework și ar trebui să fie utilizate numai în scop de referință.

Tutorial: folosiți componentele de cod pe paginile cu eticheta șablon Liquid

În acest tutorial, veți configura portaluri Power Apps pentru a adăuga componenta la o pagină web. Apoi, veți vizita pagina web a portalurilor și veți interacționa cu componenta.

Înainte de a începe

Dacă utilizați șablonul de componentă de cod folosit în acest tutorial, asigurați-vă că importați mai întâi soluțiile șablonului în mediu, înainte de a începe. Pentru a afla despre importul soluției, consultați Importul soluțiilor.

Cerințe preliminare

Pentru cerințe preliminare și pentru a afla despre componentele de cod acceptate/neacceptate în portaluri, consultați Utilizați componente de cod în portaluri.

Notă

Acest tutorial folosește un eșantion de componentă de cod creat folosind Power Apps component framework pentru a demonstra un control de tip hartă pe o pagină web. De asemenea, puteți utiliza orice componentă existentă sau nouă pe care o dețineți și orice altă pagină web pentru acest tutorial. În acest caz, asigurați-vă că utilizați componenta și pagina dvs. web când urmați pașii din acest tutorial. Pentru mai multe informații despre cum să creați componente de cod, consultați Creați-vă prima componentă.

Pasul 1. Adăugați componenta de cod pe o pagină web din Studio

1. Deschideți-vă portalul în Power Apps portals Studio.

2. În colțul din stânga sus, selectați Pagină nouă.

3. Selectați Alb.

4. În panoul de proprietăți din partea dreaptă, actualizați numele paginii web. De exemplu, „Vizualizator de hărți”.

5. Actualizați adresa URL parțială. De exemplu, "mapviewer".

6. Extindeți Permisiunile.

7. Dezactivați Pagină disponibilă tuturor.

8. Selectați rolurile web care ar trebui să aibă acces la această pagină.

9. Selectați zona editabilă de pe pagină pentru a edita codul sursă Liquid.

10. Deschideți editorul de cod studio.

11. Adăugați controlul cu eticheta șablon Liquid folosind următoarea sintaxă:

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

    Sfat

    Pentru a prelua detaliile tuturor componentelor importate și pentru a căuta un nume de componentă, consultați API-ul web CustomControl.

    De exemplu:

    • Pentru a căuta o componentă:

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

    • Pentru a prelua parametrii de intrare pentru o componentă:

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

12. Salvați și închideți editorul de cod.

13. În colțul din dreapta sus, selectați Răsfoiți site-ul web.

14. Pagina web va afișa acum controlul adăugat pe ea.

Pașii următori

Prezentare generală: Utilizare a componentelor de cod din portaluri

Consultați și

Eticheta de entitate Dataverse pentru componenta codului
Etichetă de șablon pentru componenta de cod
Power Apps component framework - prezentare generală
Creați-vă prima componentă
Adăugați componente de cod într-o coloană sau într-un tabel în aplicații proiectate pe bază de model
Implementarea unui exemplu de componentă API web în portal

Notă

Ne puteți spune care preferințele dvs. lingvistice pentru documentație? Răspundeți la un chestionar scurt. (rețineți că acest chestionar este în limba engleză)

Chestionarul va dura aproximativ șapte minute. Nu sunt colectate date personale (angajament de respectare a confidențialității).