Portalsondersteuning voor Microsoft Power Platform CLI

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.

Microsoft Power Platform CLI (Command Line Interface) is een eenvoudige, single-stop opdrachtregelinterface voor ontwikkelaars waarmee ontwikkelaars en app-makers codecomponenten 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. Zie Wat is Microsoft Power Platform CLI? voor meer informatie

Met deze functie ondersteunen Microsoft Power Apps-portals de Microsoft Power Platform CLI om CI/CD (Continuous Integration/Continuous Deployment) van portalconfiguratie in te schakelen. U kunt nu in de portalconfiguratie controleren op broncodebeheer en de portalconfiguratie naar een willekeurige omgeving verplaatsen met behulp van Microsoft Power Platform CLI.

Notitie

Deze functie is algemeen beschikbaar vanaf Power Platform CLI-versie 1.9.8. Zie voor meer informatie over het installeren van de nieuwste versie Microsoft Power Platform CLI installeren.

Waarom Microsoft Power Platform CLI gebruiken voor portalontwikkeling?

Met portalsondersteuning voor Microsoft Power Platform CLI kunt u nu offline-achtige mogelijkheden gebruiken voor het aanpassen van portals door wijzigingen aan te brengen in de portalinhoud. En zodra alle aanpassingen of wijzigingen zijn opgeslagen, uploadt u ze naar de portal. Wanneer u portalinhoud downloadt met Microsoft Power Platform CLI, is de inhoud gestructureerd in YAML- en HTML-indelingen, waardoor het 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 portalgegevens naar/van het lokale bestandssysteem

• Voortbouwen op bestaande Microsoft Power Platform CLI-tool.

Application Lifecycle Management (ALM)

• Wijzigingen in de portalconfiguratie 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

Portalsondersteuning voor Microsoft Power Platform CLI is beperkt tot de onderstaande 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.	pac paportal list
download	Download de inhoud van de portalwebsite vanuit de huidige Dataverse-omgeving. Dit heeft de volgende parameters: - path: pad waarnaar 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)	pac paportal download --path "C:\portals" --webSiteId f88b70cc-580b-4f1a-87c3-41debefeb902
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	pac paportal upload --path "C:\portals\starter-portal" --deploymentProfile "profile-name"

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

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 "test.deployment.yml" profiel YAML-bestand 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 inhoud van de website downloadt met de CLI-opdracht pac paportal download, worden bij de download van de site-inhoud tevens 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 omgevingsmanifestbestand is alleen-lezen wanneer het verbinding maakt met dezelfde omgeving (omgevings-URL komt overeen met bestandsnaam), om onbedoelde wijzigingen te voorkomen.

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 hiermee de verwijderde records van omgevingsmanifestbestand (org-url-manifest.yml) toegevoegd aan het bestand manifest.yml. Dus wanneer u de inhoud van de website uploadt met de opdracht pac paportal upload, worden de bestanden 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.

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

Aanvullende 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