Zelfstudie: Microsoft Power Platform CLI gebruiken met portals

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.

In dit zelfstudievoorbeeld ziet u hoe u aan de slag kunt met Microsoft Power Platform-CLI om de configuratie van voorbeeldportals bij te werken.

Notitie

• U kunt Power Platform CLI ook gebruiken in combinatie met Power Pages. Meer informatie: Wat is Power Pages
• Deze zelfstudie richt zich op de vereiste Microsoft Power Platform CLI-opdrachten voor gebruik van Power Apps-portals. Lees Veelvoorkomende opdrachten voor meer informatie over de opdrachten die worden gebruikt in Power Platform CLI.

Visual Studio Code downloaden en installeren

Om verbinding te maken met Power Apps-portals en Microsoft Power Platform CLI-opdrachten te gebruiken, gebruikt u Visual Studio Code en de geïntegreerde terminal. De geïntegreerde terminal maakt het gemakkelijk om verbinding te maken met de Dataverse-omgeving en om de portalconfiguratie te downloaden, wijzigen en uploaden. U kunt in plaats daarvan ook Windows PowerShell gebruiken.

Stap 1. Verifiëren

Voordat u verbinding maakt, eventuele wijzigingen vermeldt, downloadt of uploadt voor een Power Apps-portal, moet u zich eerst verifiëren bij de Dataverse-omgeving. Ga voor meer informatie over verificatie met Microsoft Power Platform-CLI naar pac auth.

Om te verifiëren, opent u Windows PowerShell en voert u de opdracht pac auth create uit met de URL van uw Dataverse-omgeving.

pac auth create -u [Dataverse URL]

Voorbeeld

pac auth create -u https://contoso-org.crm.dynamics.com

Volg de aanwijzingen voor verificatie om u aan te melden bij de omgeving.

Stap 2. Beschikbaar portals weergeven

Gebruik de opdracht pac paportal list om de beschikbare Power Apps-portals in de Dataverse-omgeving weer te geven waarmee u in de vorige stap verbinding hebt gemaakt.

pac paportal list

Stap 3. De inhoud van de portal downloaden

Download de inhoud van de portalwebsite vanuit de verbonden Dataverse-omgeving met de opdracht pac paportal downloaden.

pac paportal download --path [PATH] -id [WebSiteId-GUID]

Voorbeeld

pac paportal download --path c:\pac-portals\downloads -id d44574f9-acc3-4ccc-8d8d-85cf5b7ad141

Gebruik voor de parameter id de WebSiteId die is geretourneerd uit de uitvoer van de vorige stap.

Stap 4. Inhoud van portals wijzigen

Wijzig de configuratie met Visual Studio Code en sla uw wijzigingen op.

Notitie

Zorg ervoor dat u alleen de ondersteunde tabellen bijwerkt voor gebruik met Power Platform CLI. Zie voor meer informatie Ondersteunde tabellen.

De standaardportalpagina toont bijvoorbeeld tekst zoals deze:

Deze tekst is zichtbaar vanaf de webpagina-html:

U kunt deze tekst wijzigen en de wijzigingen opslaan:

Tip

U kunt de locatie van het mappad in PowerShell/geïntegreerde terminal wijzigen in de gedownloade locatie en 'code' invoeren. om de map direct in Visual Studio Code te openen

Stap 5. De wijzigingen uploaden

Notitie

• Als u wijzigingen naar meerdere omgevingen wilt uploaden, radpleegt u De wijzigingen uploaden met het implementatieprofiel voor meer informatie over het uploaden van wijzigingen met het implementatieprofiel.
• Zorg ervoor dat de maximale bijlagegrootte van de doelomgeving is ingesteld op dezelfde of een grotere grootte als uw bronomgeving.
• De maximale grootte van bestanden wordt bepaald door de instelling Maximale bestandsgrootte op het tabblad e-mail van systeeminstellingen in het dialoogvenster met omgevingssysteeminstellingen.

Nadat u de vereiste wijzigingen hebt aangebracht, uploadt u deze met de opdracht pac paportal upload:

pac paportal upload --path [Folder-location]

Voorbeeld

pac paportal upload --path C:\pac-portals\downloads\custom-portal\

Notitie

Zorg ervoor dat het pad voor de portalinhoud die u hebt ingevoerd correct is. Standaard wordt een map met de naam van de portal (beschrijvende naam) gemaakt met gedownloade portalinhoud. Als de beschrijvende naam van de portal bijvoorbeeld is: aangepaste-portaal, moet het pad voor de bovenstaande opdracht (--path) zijn: C:\pac-portals\downloads\aangepaste-portal.

Het uploaden gebeurt alleen voor inhoud die is gewijzigd. In dit voorbeeld wordt, aangezien de wijziging is aangebracht in een webpagina, alleen inhoud geüpload voor de tabel adx_webpage.

De wijzigingen uploaden met het implementatieprofiel

Als u met meerdere verschillende omgevingen werkt, kunt u overwegen om implementatieprofielen te gebruiken om ervoor te zorgen dat de wijzigingen worden geüpload naar de juiste omgeving met behulp van het implementatieprofiel.

1. Maak een map met de naam implementatieprofielen in de map met de portalinhoud. Als de gedownloade portalinhoud zich bijvoorbeeld in 'starterportal' bevindt, moet de map met implementatieprofielen zich in deze map bevinden.

   

2. Maak in de map met implementatieprofielen een YAML-implementatiebestand met de omgevingsspecifieke wijzigingen. De ontwikkelomgeving kan bijvoorbeeld 'ontw.omgeving' worden genoemd.

   

3. Bewerk het YAML-implementatiebestand met Visual Studio-code met het volgende notatie:

   <table-name>:
   - <record-id>: <GUID>
     <column-name>: <Name>
     <column-value>: <Value>
   

   Met de volgende YAML-voorbeeldcode wordt bijvoorbeeld de waarde voor 'Achtervoegsel van browsertitel' bijgewerkt van standaard 'Aangepaste portal' naar 'Aangepaste portal (Ontw)'.

   adx_contentsnippet:
       - adx_contentsnippetid: 76227a41-a33c-4d63-b0f6-cd4ecd116bf8 # Replace with your content snippet ID
         adx_name: Browser Title Suffix # Setting name
         adx_value:   · Custom Portal (Dev) # Setting value
   

4. Als u de wijzigingen wilt uploaden naar een andere omgeving met behulp van een YAML-bestand met een implementatieprofiel, moet u zich eerst bij de doelorganisatie verifiëren.

5. Gebruik na het verifiëren en verbinding maken met de juiste omgeving de opdracht pac paportal upload om de inhoud te uploaden:

   pac paportal upload --path "C:\portals\starter-portal" --deploymentProfile dev

   Notitie

   In het bovenstaande voorbeeld is de naam van het implementatieprofiel die wordt gebruikt 'ontw' na het volgen van de voorgaande stappen om een ontw-implementatieprofiel te maken. Wijzig de naam van 'ontw' in een andere naam (zoals QA voor 'qa.inplementatie.yml' of Test voor 'test.implementatie') als u een andere bestandsnaam hebt gebruikt voor uw YAML-implementatiebestand.

Stap 6. De wijzigingen bevestigen

Om de wijzigingen aan de portalwebpagina te bevestigen:

1. Ruim de cache aan serverzijde op of gebruik Configuratie synchroniseren met behulp van Power Apps-portals Studio.

2. Blader naar de portal-webpagina om de wijziging te zien.

   

3. Als u het voorbeeld van een implementatieprofiel hebt gebruikt dat eerder aan de orde is geweest, wordt met het YAML-fragment de waarde bijgewerkt, zoals hieronder is weergegeven.

   

   Het achtervoegsel van de browsertitel dat via de bovenstaande wijziging is bijgewerkt, toont de wijziging wanneer u de portal in een browser opent:

   

Hiermee is de zelfstudie beëindigd. U kunt de bovenstaande stappen herhalen en de inhoud van de portals wijzigen voor andere ondersteunde tabellen.

Volgende stappen

De Visual Studio Code-extensie gebruiken

Zie ook

• Microsoft Power Platform CLI
• De Visual Studio Code-extensie (preview) gebruiken