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