Ondersteuning voor Microsoft Power Platform CLI voor Power Pages

Microsoft Power Platform CLI (Command Line Interface) is een eenvoudige, complete opdrachtregelinterface voor ontwikkelaars waarmee ontwikkelaars en app-makers codeonderdelen kunnen maken.

Microsoft Power Platform CLI-tooling is de eerste stap naar een uitgebreid ALM-verhaal (Application Lifecycle Management) waar de enterprise-ontwikkelaars en ISV's hun extensies en aanpassingen snel en efficiënt kunnen creëren, bouwen, debuggen en publiceren. Ga naar Wat is Microsoft Power Platform CLI? voor meer informatie

Met deze functie maakt de Microsoft Power Platform CLI CI/CD (Continuous Integration/Continuous Deployment) van een Power Pages-siteconfiguratie mogelijk. U kunt de websiteconfiguratie nu inchecken bij broncodebeheer en naar elke omgeving verplaatsen met behulp van Microsoft Power Platform CLI.

Notitie

• Deze functie is algemeen beschikbaar vanaf Power Platform CLI-versie 1.9.8. Voor meer informatie over het installeren van de nieuwste versie gaat u naar Microsoft Power Platform CLI installeren.
• Vanaf Power Platform CLI versie 1.27 is de opdracht pac paportal gewijzigd in pac powerpages. paportal blijft werken, maar we raden aan om in de toekomst powerpages te gebruiken. Dit artikel wordt binnenkort bijgewerkt om powerpages in plaats van paportal te gebruiken.

Waarom Microsoft Power Platform CLI gebruiken voor websiteontwikkeling?

Met de Microsoft Power Platform CLI kunt u nu offline-achtige mogelijkheden gebruiken voor website-aanpassing door wijzigingen aan te brengen in de website-inhoud. En zodra alle aanpassingen of wijzigingen zijn opgeslagen, kunt u de websiteconfiguratie weer naar Microsoft Dataverse uploaden. Wanneer u website-inhoud downloadt met Microsoft Power Platform CLI, is de inhoud gestructureerd in YAML- en HTML-indelingen, waardoor deze gemakkelijk kan worden aangepast, zodat een professionele ontwikkelingservaring mogelijk is.

Hier is een lijst met functies en mogelijkheden waarvan portals profiteren met de ondersteuning voor Microsoft Power Platform KLI:

Gebruiksgemak

• Ondersteuning voor het downloaden/uploaden van websiteconfiguratiegegevens naar/van het lokale bestandssysteem

• Voortbouwen op bestaande Microsoft Power Platform CLI-tool.

Application Lifecycle Management (ALM)

• Wijzigingen in de websiteconfiguratie binnen een organisatie bijhouden

• Configuratiebestanden tussen organisaties of tenants verplaatsen

Ondersteuning voor professionele ontwikkelaars en ondernemingen

• Helpt naadloos te integreren met alle bronbeheerprogramma's, zoals “git”

• Eenvoudige instelling van CI/CD-pijplijnen

Microsoft Power Platform CLI installeren

Raadpleeg voor stapsgewijze instructies: Installeren Microsoft Power Platform CLI.

Ondersteunde tabellen

Portalondersteuning voor Microsoft Power Platform CLI is beperkt tot de volgende tabellen.

adx_ad

adx_adplacement

adx_blog

adx_blogpost

adx_botconsumer

adx_communityforum

adx_communityforumaccesspermission

adx_contentsnippet

adx_entityform

adx_entityformmetadata

adx_entitylist

adx_entitypermission

adx_forumthreadtype

adx_pagetemplate

adx_poll

adx_polloption

adx_pollplacement

adx_portallanguage

adx_publishingstate

adx_redirect

adx_shortcut

adx_sitemarker

adx_sitesetting

adx_tag

adx_urlhistory

adx_webfile

adx_webform

adx_webformmetadata

adx_webformstep

adx_weblink

adx_weblinkset

adx_webpage

adx_webpageaccesscontrolrule

adx_webrole

adx_website

adx_websiteaccess

adx_websitebinding (alleen downloaden)

adx_websitelanguage

adx_webtemplate

aantekening

Belangrijk

• Aangepaste tabellen en portalsjabloonspecifieke tabellen (zoals blog, community of ideeënportal) worden niet ondersteund voor aanpassing met Microsoft Power Platform CLI.
• Bijlagen van afbeeldingsbestanden bij advertentierecords (adx_ad) worden niet gedownload met de Power Platform CLI . Gebruik als tijdelijke oplossing het veld Afbeeldings-URL of voeg in het veld Kopiëren een HTML-verwijzing toe naar een webbestandsrecord met een afbeeldingsbestand.

Microsoft Power Platform CLI voor portals installeren en verifiëren

Ga voor meer informatie over installeren van Microsoft Power Platform CLI naar Microsoft Power Platform CLI installeren.

Nadat u Microsoft Power Platform-CLI hebt geïnstalleerd, opent u een opdrachtprompt en voert u pac uit om te controleren of de uitvoer 'paportal' bevat: de opdracht voor Power Apps-portals.

Microsoft Power Platform CLI-opdrachten voor portals

Microsoft Power Platform-CLI-opdracht voor portals is 'paportal'.

De volgende secties bevatten aanvullende details over verschillende eigenschappen van de opdracht 'paportal'.

Parameters

Eigenschapsnaam	Omschrijving	Voorbeeld
lijst	Geeft een lijst weer met alle portalwebsites van de huidige Dataverse-omgeving. U kunt de parameter -v toevoegen om aan te geven of de site het standaard gegevensmodel of verbeterde gegevensmodel gebruikt	pac paportal list
download	Download de inhoud van de portalwebsite vanuit de huidige Dataverse-omgeving. Dit heeft de volgende parameters: - path: pad waar de inhoud van de website wordt gedownload (alias: -p) - webSiteId: portalwebsite-id voor het downloaden (alias: -id) - overwrite: (optioneel) waar: om bestaande inhoud te overschrijven, onwaar: om te mislukken als de map al website-inhoud heeft (alias: -o) - modelVersion: 1 of 2 om aan te geven of de te downloaden sitegegevens het standaard (1) of het verbeterde gegevensmodel (2) gebruiken.	pac paportal download --path "C:\portals" --webSiteId f88b70cc-580b-4f1a-87c3-41debefeb902 --modelVersion 2
uploaden	Upload de inhoud van de portalwebsite naar de huidige Dataverse-omgeving. Dit heeft de volgende parameter: - path: pad waar de inhoud van de website is opgeslagen (alias: -p) - deploymentProfile: upload portalgegevens met omgevingsdetails gedefinieerd via profielvariabelen in het bestand deployment-profiles/[profile-name].deployment.yaml - modelVersion: 1 of 2 om aan te geven of de te uploaden sitegegevens het standaard (1) of het verbeterde gegevensmodel (2) gebruiken.	pac paportal upload --path "C:\portals\starter-portal" --deploymentProfile "profile-name" --modelVersion 2

Implementatieprofiel gebruiken

De schakeloptie deploymentProfile stelt u in staat een set variabelen voor de omgeving in YAML-indeling te definiëren. U kunt bijvoorbeeld verschillende implementatieprofielen hebben (zoals dev, test, prod) met verschillende schemadetails die in het profiel zijn gedefinieerd.

Als u een testprofiel maakt, kunt u een bestand maken onder implementatieprofielen met de naam "test.deployment.yml" (dat wil zeggen: <profileTag>.deployment.yml). En u kunt een opdracht uitvoeren met tag (<profileTag>) om dit profiel te gebruiken:

pac paportal upload --path "C:\portals\starter-portal" --deploymentProfile test --modelVersion 2

In dit bestand kunt u de tabelnaam (entiteitsnaam) met tabel-ID, lijst met eigenschappen en de waarden die u wilt overschrijven tijdens het uploaden van de portalconfiguratie met behulp van de deploymentProfile parameter.

Daarnaast kunt u de OS variabele gebruiken om toegang te krijgen tot de omgevingsvariabelen van het besturingssysteem.

Hier is een voorbeeld van dit YAML-profielbestand "test.deployment.yml" met unieke schemadetails:

adx_sitesetting:
    - adx_sitesettingid: 4ad86900-b5d7-43ac-1234-482529724970
      adx_value: ${OS.FacebookAppId} 
      adx_name: Authentication/OpenAuth/Facebook/AppId
    - adx_sitesettingid: 5ad86900-b5d7-43ac-8359-482529724979
      adx_value: contoso_sample
      adx_name: Authentication/OpenAuth/Facebook/Secret
adx_contentsnippet:
    - adx_contentsnippetid: b0a1bc03-0df1-4688-86e8-c67b34476510
      adx_name: PowerBI/contoso/sales
      adx_value:  https://powerbi.com/group/contoso/sales

Notitie

Om meer te weten te komen over alle opdrachten die naast portals in CLI worden gebruikt, gaat u naar Algemene opdrachten in Microsoft Power Platform CLI.

Manifestbestanden

Wanneer u de website-inhoud downloadt met behulp van de CLI-opdracht pac paportal download, worden er naast het downloaden van de site-inhoud ook twee manifestbestanden gegenereerd:

• Omgevingsmanifestbestand (org-url-manifest.yml)
• Verwijderingstrackingmanifestbestand (manifest.yml)

Omgevingsmanifestbestand (org-url-manifest.yml)

Het omgevingsmanifestbestand wordt elke keer gegenereerd wanneer de opdracht pac paportal download wordt uitgevoerd.

Na elke download leest de PAC CLI-tool het bestaande omgevingsmanifestbestand en worden de vermeldingen bijgewerkt die in de omgeving zijn verwijderd, of wordt het omgevingsmanifestbestand gemaakt als het nog niet bestaat.

Wanneer u de opdracht pac paportal upload uitvoert om de inhoud van de portalwebsite te uploaden. Het omgevingsmanifestbestand wordt ingelezen, de wijzigingen die zijn aangebracht sinds de laatste download worden bepaald en alleen de bijgewerkte inhoud wordt geüpload. Dit helpt bij het optimaliseren van het uploadproces, omdat alleen bijgewerkte website-inhoud wordt geüpload, in plaats van alle inhoud bij elke uploadopdracht te uploaden.

Het manifestbestand voor de omgeving is alleen-lezen wanneer het verbinding maakt met dezelfde omgeving (omgevings-URL komt overeen met de bestandsnaam), om onbedoelde wijzigingen te voorkomen.

Notitie

• Het omgevingsmanifestbestand is niet ontworpen om de wijzigingen bij te houden bij het implementeren van de website in verschillende omgevingen.
• Het omgevingsmanifestbestand is ontworpen om door ontwikkelaars te worden gebruikt voor lokale implementatie in hun ontwikkelaarsomgeving en moet worden toegevoegd aan de git-ignore-lijst.

Verwijderingstrackingmanifestbestand (manifest.yml)

Dit bestand wordt gebruikt voor het bijhouden van de verwijderde records uit de omgeving.

Wanneer website-inhoud wordt gedownload met de opdracht pac paportal download, worden de verwijderde records uit het manifestbestand van de omgeving (org-url-manifest.yml) toegevoegd aan het bestand manifest.yml. Wanneer u de website-inhoud uploadt met de opdracht pac paportal upload worden de bestanden dus uit de omgeving verwijderd (zelfs naar een andere omgeving). Het bestand wordt niet verwijderd en het wordt gebruikt ongeacht de omgeving waarmee u bent verbonden. Met dit bestand moet rekening worden gehouden bij het doorvoeren van wijzigingen in het bronbeheer bij de overweging om items in de doelomgeving te verwijderen.

Notitie

Om de inhoudsrecords van de site in de ene omgeving te verwijderen en dezelfde inhoudsrecords in een andere omgeving ook te verwijderen met behulp van de PAC CLI, moet u de opdracht pac paportal download uitvoeren vóór en na het verwijderen van de inhoud van de websiterecord. Het bestand manifest.yml houdt deze wijzigingen bij en verwijdert de bijbehorende records in de doelomgeving wanneer de opdracht pac paportal upload wordt uitgevoerd.

De Visual Studio Code-extensie gebruiken

U kunt ook de VS Code-extensie Power Platform VS Code-extensie gebruiken om te profiteren van ingebouwde Liquid-taal van IntelliSense, hulp bij het invullen van codes, hints en interactie met de Microsoft Power Platform CLI met behulp van de VS Code Integrated Terminal. Meer informatie: De Visual Studio Code-extensie (preview) gebruiken

Meer overwegingen

• Er wordt een fout gemeld als uw bestandspad de maximale padlengte overschrijdt. Meer informatie: Maximale padlengtebeperking in Windows
• Voor dubbele records, zoals een dubbele webpaginanaam, maakt Microsoft Power Platform CLI twee verschillende mappen: een met de naam van de webpagina en de andere met dezelfde naam met een hashcode als voorvoegsel. Bijvoorbeeld 'Mijn-pagina' en 'Mijn-pagina-hashcode'.

Volgende stappen

Zelfstudie: Microsoft Power Platform CLI gebruiken met portals

Zie ook

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