Liquid-sjablooncode voor codeonderdelen

Notitie

Met ingang van 12 oktober 2022 wordt Power Apps-portals hernoemd tot Power Pages. Meer informatie: Microsoft Power Pages is nu algemeen beschikbaar (blog)
We zullen binnenkort de documentatie voor Power Apps-portals migreren en samenvoegen met Power Pages-documentatie.

Met het Power Apps component framework kunnen professionele ontwikkelaars en app-makers codeonderdelen maken voor modelgestuurde en canvas-apps. Deze codeonderdelen kunnen een verbeterde ervaring bieden voor gebruikers die werken met gegevens op formulieren, weergaven en dashboards. Meer informatie: Codeonderdelen gebruiken in portals

Belangrijk

De Liquid-sjablooncode voor codeonderdelen vereist portalversie 9.3.10.x of hoger.

Met deze release introduceren we de mogelijkheid om codeonderdelen toe te voegen met behulp van een Liquid-sjablooncode op webpagina's en ingeschakelde onderdelen met behulp van web-API die zijn ingeschakeld voor onderdelen op veldniveau in formulieren in portals.

Codeonderdelen kunnen worden toegevoegd met behulp van de Liquid-sjablooncode codecomponent. De sleutel voor het aanduiden van het codeonderdeel dat moet worden geladen, wordt doorgegeven met behulp van het kenmerk name. De sleutel kan de GUID zijn (dit is de codeonderdeel-id) of de naam van het codeonderdeel dat is geïmporteerd in Microsoft Dataverse.

De waarden van de eigenschappen die het codeonderdeel verwacht, moeten worden doorgegeven als een sleutelwaardepaar, gescheiden door ":" (dubbele punt), waarbij de sleutel de eigenschapsnaam is en de waarde de JSON-tekenreekswaarde.

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

Als u bijvoorbeeld een codeonderdeel wilt toevoegen dat een invoerparameter verwacht met de naam controlValue, gebruikt u de volgende Liquid-sjablooncode:

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

Tip

In dit voorbeeld worden de parameters met de naam controlvalue en controlApiKey gebruikt. In het onderdeel dat u gebruikt, zijn echter mogelijk andere parameternamen vereist.

U kunt Sample Map Control gebruiken en het codeonderdeel verpakken als een oplossing voor gebruik met portals.

Notitie

Resources die door de community zijn gemaakt, worden niet ondersteund door Microsoft. Als u vragen of problemen hebt met betrekking tot de communityresources, moet u contact opnemen met de uitgever van de resource. Voordat u deze resources gebruikt, moet u ervoor zorgen dat deze voldoen aan de richtlijnen voor Power Apps component framework en deze mogen alleen worden gebruikt voor referentiedoeleinden.

Zelfstudie: codeonderdelen gebruiken op pagina's met Liquid-sjablooncode

In deze zelfstudie configureert u Power Apps-portals om het onderdeel aan een webpagina toe te voegen. Vervolgens bezoekt u de webpagina voor portals en werkt u met het onderdeel.

Voordat u begint

Als u het voorbeeldcodeonderdeel gebruikt dat in deze zelfstudie wordt gebruikt, moet u ervoor zorgen dat u eerst de voorbeeldoplossingen in de omgeving importeert voordat u met de volgende stappen begint. Ga naar Oplossingen importeren voor meer informatie over het importeren van oplossingen.

Vereisten

Ga naar Codeonderdelen in portals gebruiken voor vereisten en voor informatie over ondersteunde/niet-ondersteunde codeonderdelen in portals.

Notitie

In deze zelfstudie wordt een voorbeeldcodeonderdeel gebruikt dat is gemaakt met Power Apps component framework om een kaartbesturingselement op een webpagina te demonstreren. U kunt ook een bestaand of nieuw onderdeel van uzelf en elke andere webpagina voor deze zelfstudie gebruiken. Zorg er in dit geval voor dat u uw onderdeel en webpagina gebruikt bij het uitvoeren van de stappen in deze zelfstudie. Ga voor meer informatie over het maken van codeonderdelen naar Uw eerste onderdeel maken.

Stap 1. Het codeonderdeel aan een webpagina toevoegen vanuit Studio

1. Uw portal openen in  Power Apps-portals Studio.

2. Selecteer in de linkerbovenhoek de optie Nieuwe pagina.

3. Selecteer Leeg​.

4. Werk in het eigenschappenvenster aan de rechterkant de naam van de webpagina bij. Bijvoorbeeld "Kaartweergave".

5. Werk gedeeltelijke URL bij. Bijvoorbeeld "mapviewer".

6. Vouw Machtigingen uit.

7. Schakel Pagina beschikbaar voor iedereen uit.

8. Selecteer de webrollen die toegang moeten krijgen tot deze pagina.

9. Selecteer het bewerkbare gebied op de pagina om de Liquid-broncode te bewerken.

10. Open de code-editor in Studio.

11. Voeg een besturingselement met de Liquid-sjablooncode toe met van de volgende syntaxis:

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

    Tip

    Zie CustomControl Web-API om de details van alle geïmporteerde onderdelen op te halen en te zoeken naar een onderdeelnaam.

    Bijvoorbeeld:

    • Zoeken naar een onderdeel:

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

    • Invoerparameters voor een onderdeel ophalen:

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

12. Sla de code-editor op en sluit deze.

13. Selecteer in de rechterbovenhoek Bladeren door de website.

14. De webpagina toont nu het besturingselement dat eraan is toegevoegd.

Volgende stappen

Overzicht: Ccodecomponenten gebruiken in portals

Zie ook

Codecomponent Dataverse entity-tag
Codecomponent Template-tag
Overzicht Power Apps component framework
Uw eerste component maken
Codeonderdelen toevoegen aan een kolom of tabel in modelgestuurde apps
Web-API-component van voorbeeldportal implementeren

Notitie

Laat ons uw taalvoorkeuren voor documentatie weten! Beantwoord een korte enquête. (houd er rekening mee dat deze in het Engels is)

De enquête duurt ongeveer zeven minuten. Er worden geen persoonlijke gegevens verzameld (privacyverklaring).