Voeg codecomponenten toe aan een aangepaste pagina voor uw modelgestuurde app

Artikel
16-03-2023

Dit artikel beschrijft het gebruik van codecomponenten die zijn gebouwd door professionele ontwikkelaars met behulp van het Power Apps componentframework binnen een aangepaste pagina. Zie voor low-code aangepaste UX-uitbreidingen: voeg canvasonderdelen toe aan een aangepaste pagina voor uw modelgestuurde app.

Belangrijk

Aangepaste pagina's zijn een nieuwe functie met aanzienlijke productwijzigingen en hebben momenteel een aantal bekende beperkingen die worden beschreven in: Bekende problemen met aangepaste pagina's.

Notitie

Aangepaste pagina's ondersteunen alle componentframework-API's die momenteel worden ondersteund voor canvas-apps.
Bepaalde modelgestuurde app-specifieke API's zoals WebAPI en Navigatie hebben gepubliceerde app-ondersteuning voor aangepaste pagina's. Deze API's kunnen worden gebruikt in de codecomponent voor aangepaste pagina's en werken op de uiteindelijke gepubliceerde app.
Voor individuele API-ondersteuningsstatus op elk platform, zie Power Apps componentframework API-referentie

Codecomponenten bieden professionele ontwikkelaars de mogelijkheid om aangepaste codecomponenten te maken voor gebruik binnen een app. Dit pro-code uitbreidbaarheidsmechanisme biedt eersteklas applicatielevenscyclusbeheer (ALM) om de componenten die beschikbaar zijn voor alle app-makers in de hele organisatie naadloos uit te breiden. Codecomponenten kunnen opnieuw worden gebruikt op aangepaste pagina's, canvas en modelgestuurde apps. Ze kunnen centraal worden bijgewerkt, verpakt en verplaatst met behulp van standaard Microsoft Dataverse oplossingen. Meer informatie: Overzicht voor het Power Apps-onderdelenframework

Inschakelen Power Apps componentframework voor aangepaste pagina's

Om codecomponenten binnen een aangepaste pagina te gebruiken, moet u Power Apps componentframeworkfunctie inschakelen. Meer informatie: Schakel de Power Apps component framework-functie in

Codecomponenten maken voor gebruik in een aangepaste pagina

Deze sectie beschrijft hoe u codecomponenten maakt, importeert en test.

Codecomponenten maken en importeren in Dataverse

Codecomponenten voor aangepaste pagina's volgen hetzelfde patroon als bij de canvas-app. Codecomponenten moeten eerst worden geïmplementeerd voordat ze aan een aangepaste pagina kunnen worden toegevoegd. Om een codecomponent aan te maken, zie Maak uw eerste component.

Je kunt ook proberen OOB-voorbeeldcomponenten om een vliegende start te maken. Zodra u klaar bent met het implementeren van uw codecomponent, kan deze worden verpakt in een oplossing en worden toegevoegd aan Dataverse, waardoor het beschikbaar is voor gebruik op alle aangepaste pagina's in overeenstemming met modelgestuurde en canvas-apps. Meer informatie: Codecomponenten applicatie lifecycle management (ALM).

Codecomponent importeren en gebruiken in een aangepaste pagina

In een omgeving kunnen aangepaste pagina's alle codecomponenten gebruiken die eerder zijn geïmporteerd in Dataverse oplossingen. Selecteer in het linkerdeelvenster Toevoegen (+) en selecteer vervolgens Krijg meer componenten onderaan de pagina. U ziet een codetabblad op het Componenten importeren deelvenster met alle codecomponenten die aanwezig zijn in de omgeving.

Notitie

Als het codetabblad niet wordt weergegeven in het Component importeren deelvenster, controleer of de functie-instelling van Power Apps componentframework voor canvas-apps is ingeschakeld. Meer informatie: Schakel de Power Apps component framework-functie in
Zorg er ook voor dat u werkt aan de nieuwste versie voor het maken van canvas-app-studio's.

De nieuw toegevoegde codecomponenten zijn nu beschikbaar onder de Codecomponenten sectie. Het kan worden toegevoegd aan een aangepaste pagina.

De codecomponent testen in de studio en de gepubliceerde app

Net als canvas-apps zijn codecomponenten interactief en kunnen ze worden getest in de creatie-omgeving van de aangepaste paginastudio. Specifieke API's zoals: Web APIs en Navigation, die alleen de runtime-ondersteuning voor aangepaste pagina's hebben wanneer ze worden aangeroepen, zullen de foutmelding "methode niet geïmplementeerd" weergeven.

U kunt deze fout sluiten en de aangepaste pagina publiceren. Voeg vervolgens deze aangepaste pagina toe aan de modelgestuurde app en publiceer de app om de web-API van de aangepaste pagina in actie te zien.

De afbeelding hieronder toont de standaard: Voorbeeldbesturingselement voor web-API en Navigatie API-besturing toegevoegd aan aangepaste pagina die werkt in een gepubliceerde modelgestuurde app.