Zelfstudie: Microsoft Power Platform CLI gebruiken met Power Pages

In deze zelfstudie leert u hoe u de Microsoft Power Platform CLI kunt gaan gebruiken om de configuratie van een voorbeeldwebsite bij te werken.

Notitie

• Deze zelfstudie richt zich op de vereiste Microsoft Power Platform CLI-opdrachten voor gebruik van Power Pages. Lees Veelvoorkomende opdrachten voor meer informatie over de opdrachten die worden gebruikt in Power Platform CLI.
• Vanaf Power Platform CLI versie 1.27 is de opdracht pac paportal gewijzigd in pac pages. paportal blijft werken, maar we raden aan om in de toekomst powerpages te gebruiken.

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. Beschikbare websites weergeven

Gebruik de opdracht pac pages list om de beschikbare Power Pages websites weer te geven in de Dataverse-omgeving die u in de vorige stap hebt verbonden.

pac pages list

Stap 3. Website-inhoud downloaden

Download website-inhoud uit de verbonden Dataverse-omgeving met behulp van de downloadopdracht pac pages .

pac pages download --path [PATH] -id [WebSiteId-GUID] --modelVersion [DataModel]

Voorbeeld

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

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

Notitie

• Gebruik modelVersion1 of 2 om aan te geven of de te uploaden sitegegevens het standaard (1) of het verbeterde gegevensmodel (2) zullen gebruiken.
• Voer de opdracht uit pac pages list -v om te bekijken welk gegevensmodel wordt gebruikt voor uw site. Zie verbeterde gegevensmodellen voor meer informatie.

Stap 4. Inhoud van website 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 rechtstreeks 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 behulp van de opdracht pac pages uploaden :

pac pages upload --path [Folder-location] --modelVersion [ModelVersion]

Voorbeeld

pac pages upload --path C:\pac-portals\downloads\custom-portal\ --modelVersion 2

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 wordt 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. Bijvoorbeeld kan de ontwikkelomgeving "dev.deployment.yml" worden genoemd.

   

3. Bewerk het YAML-bestand voor implementatie in Visual Studio Code met de volgende indeling:

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

   Bijvoorbeeld wordt met de volgende YAML-voorbeeldcode de waarde voor 'Achtervoegsel van de browsertitel' bijgewerkt van de standaardwaarde 'Custom Portal' naar 'Custom Portal (Dev)'.

   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. Nadat u bent geverifieerd en verbonden met de juiste omgeving, gebruikt u de opdracht pac pages uploaden om de inhoud te uploaden:

   pac pages upload --path "C:\portals\starter-portal" --deploymentProfile dev --modelVersion 2

   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 'dev' in een andere naam (bijvoorbeeld QA voor 'qa.deployment.yml' of Test voor 'test.deployment.yml') als u een andere bestandsnaam hebt gebruikt voor uw deployment-YAML-bestand.

Stap 6. De wijzigingen bevestigen

Ga als volgt te werk om de wijzigingen in de webpagina te bevestigen:

1. Selecteer in de Power Pages-ontwerpstudio Synchroniseren.

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

   

3. Als u het voorbeeld van het implementatieprofiel hebt gebruikt dat eerder aan de orde is geweest, wordt met het YAML-fragment de waarde bijgewerkt, zoals in de volgende schermopname te zien is.

   

   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 gebruiken