Del via

Liquid-skabelonmærke til kodekomponenter

  • Artikel

Bemærk

Fra 12. oktober 2022 bliver Power Apps-portaler til Power Pages. Flere oplysninger: Microsoft Power Pages er nu generelt tilgængelig (blog)
Vi overfører og fletter snart dokumentationen til Power Apps-portalerne med Power Pages-dokumentationen.

Power Apps component framework giver professionelle udviklere og appudviklere mulighed for at oprette kodekomponenter til modelbaserede apps og lærredapps. Disse kodekomponenter kan give brugerne en bedre oplevelse, når de arbejder med data i formularer, visninger og dashboards. Flere oplysninger: Brug kodekomponenter i portaler

Vigtigt

Liquid-skabelonmærket til kodekomponenter kræver portalversion 9.3.10.x eller nyere.

I denne version har vi introduceret muligheden for at tilføje kodekomponenter, der bruger et Liquid-skabelonmærke på websider og aktiverede komponenter ved hjælp af web-API, som er aktiveret til komponenter på feltniveau på formularer i portaler.

Kodekomponenter kan tilføjes ved hjælp af codecomponent-liquid-skabelonmærket. Nøglen til tildeling af den kodekomponent, der skal indlæses, overføres ved hjælp af name-attributten. Nøglen kan være GUID (som er kodekomponent-id) eller navnet på den kodekomponent, der importeres til Microsoft Dataverse.

Værdierne for de egenskaber, kodekomponenten forventer, skal overføres som et nøgle/værdipar adskilt af ":" (kolontegn), hvor nøglen er egenskabsnavnet, og værdien er strengværdien JSON.

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

Hvis du f.eks. vil tilføje en kodekomponent med Liquid-skabelonmærket, som forventer en inputparameter med navnet controlValue:

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

Tip

I dette eksempel bruges parametrene controlvalue og controlApiKey, men den komponent, du bruger, kræver måske andre parameternavne.

Du kan bruge kontrolelementet for eksempeltilknytning og pakke kodekomponenten som en løsning til brug med portaler.

Bemærk

De ressourcer, der oprettes af et community, understøttes ikke af Microsoft. Hvis du har spørgsmål eller problemer med communityværktøjer, skal du kontakte udgiveren af værktøjet. Før du bruger disse ressourcer, skal du sikre, at de overholder retningslinjerne for Power Apps component framework og kun skal bruges til referenceformål.

Selvstudium: Brug kodekomponenter på sider med Liquid-skabelonmærke

I dette selvstudium skal du konfigurere Power Apps-portaler til at føje komponenten til en webside. Derefter skal du gå til portalwebsiden og kommunikere med komponenten.

Inden du starter

Hvis du bruger den komponent i eksempelkoden, der bruges i dette selvstudium, skal du sikre dig, at du først importerer eksempelløsningerne til miljøet, før du begynder med de næste trin. Du kan få mere at vide om løsningsimport under Importere løsninger.

Forudsætninger

Du kan finde oplysninger om understøttede/ikke-understøttede kodekomponenter i portaler under Brug af kodekomponenter i portaler.

Bemærk

I dette selvstudium bruges der en eksempelkodekomponent, der er oprettet ved hjælp af Power Apps component framework, til at vise et tilknytningskontrolelement på en webside. Du kan også bruge en eksisterende eller ny komponent af din egen i stedet, og en anden webside for dette selvstudium. I dette tilfælde skal du sørge for at bruge komponenten og websiden, når du følger trinnene i dette selvstudium. Du kan finde flere oplysninger om oprettelse af kodekomponenter under Oprette den første komponent.

Trin 1. Tilføje kodekomponenten til en webside fra Studio

  1. Åbn din portal i  Power Apps Portal Studio.

  2. Vælg  Ny side i øverste venstre hjørne.

  3. Vælg  Tom.

  4. Opdater websidenavnet i egenskabsruden til højre. Det kan f.eks. være "Kortviser."

  5. Opdater en del af URL-adressen. Det kan f.eks. være "kortviser."

  6. Udvid tilladelser.

  7. Deaktiver Side tilgængelig for alle.

  8. Vælg de webroller, der skal have adgang til denne side.

  9. Vælg det redigerbare område på siden for at redigere liquid-kildekoden.

  10. Editor studio kodeeditor.

  11. Tilføj kontrolelement med liquid-skabelonkoden ved hjælp af følgende syntaks:

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

    Tip

    Hvis du vil hente oplysninger om alle importerede komponenter og søge efter et komponentnavn, skal du se CustomControl web-API.

    Eksempel:

    • Søge efter en komponent:

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

    • Sådan hentes inputparametre til en komponent:

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

  12. Gem og luk kodeeditoren.

  13. Vælg  Gennemse websted i øverste højre hjørne.

  14. På websiden vises nu det kontrolelement, der er tilføjet.

Næste trin

Oversigt: Brug kodekomponenter i portaler

Se også

Codecomponent Dataverse-objektkode
Codecomponent Skabelonmærke
Oversigt over Power Apps component framework
Opret din første komponent
Føje kodekomponenter til en kolonne eller tabel i modelbaserede apps
Implementering af en eksempelportalweb-API-komponent

Bemærk

Kan du fortælle os om dine sprogpræferencer for dokumentation? Tag en kort undersøgelse. (bemærk, at denne undersøgelse er på engelsk)

Undersøgelsen tager ca. syv minutter. Der indsamles ingen personlige data (erklæring om beskyttelse af personlige oplysninger).