Delen via

Ondersteuning van Microsoft Power Platform CLI voor Power Pages

Microsoft Power Platform CLI (opdrachtregelinterface) is een eenvoudige 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.

Opmerking

  • 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.
  • Met Power Platform CLI versie 1.32 is de pac powerpages opdracht gewijzigd in pac pages. Met pac cli versie 1.27 is de pac paportal-opdracht gewijzigd in pac powerpages. Zowel powerpages als paportal blijven werken, maar we raden aan om in de toekomst webpagina's 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-aanpassingen, door wijzigingen aan te brengen in de website-inhoud. 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 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 CLI:

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: Microsoft Power Platform CLI installeren.

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 de portal voor blog, community of ideeën) worden niet ondersteund voor aanpassing met behulp van Microsoft Power Platform CLI.
  • Afbeeldingsbestandbijlagen bij advertentierecords (adx_ad) worden niet gedownload met behulp van 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 het 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: het commando voor Power Apps-portals.

Bevestig de paportal-opdracht in Microsoft Power Platform CLI.

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 Beschrijving 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 pages list
downloaden 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 sitegegevens die moeten worden gedownload, gebruikmaakt van het standaardgegevensmodel (1) of het verbeterde gegevensmodel (2).		 pac pages 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: Portalgegevens uploaden met omgevingsgegevens die zijn gedefinieerd via profielvariabelen in de implementatieprofielen/[profielnaam].deployment.yaml-bestand
- modelVersion: 1 of 2 om aan te geven of de sitegegevens die moeten worden geüpload, gebruikmaakt van het standaardgegevensmodel (1) of het verbeterde gegevensmodel (2).
- forceUploadAll: alle lokale bestanden naar de omgeving pushen. Gebruik deze optie wanneer u denkt dat de externe status beschadigd is, niet is gesynchroniseerd of wanneer de laatste download afkomstig is van een andere vertakking.		 pac pages upload --path "C:\portals\starter-portal" --deploymentProfile "profile-name" --modelVersion 2

Opmerking

  • Wanneer u een portal downloadt uit Omgeving A en deze uploadt naar omgeving B, wordt een volledige upload uitgevoerd door de PAC CLI. Dit gedrag treedt op omdat bij het bijhouden van wijzigingen manifestbestanden worden gebruikt, die geen statusinformatie bevatten in omgevingen.
  • Delta-uploads, waarbij alleen gewijzigde bestanden worden geüpload, worden alleen ondersteund wanneer zowel de download- als uploadbewerkingen binnen dezelfde omgeving plaatsvinden. In dit geval detecteert PAC CLI lokale wijzigingen en uploadt alleen de bijgewerkte bestanden. Zie Manifestbestanden voor meer informatie over hoe wijzigingen bijhouden werkt.
  • Gebruik --forceUploadAll in deze situaties. (Deze parameter is momenteel alleen voor CLI-gebruik. Azure DevOps-taken maken het nog niet beschikbaar.)
    • Drift van pijplijnstatus (u hebt rebase of cherry-pick uitgevoerd op commits, waardoor de laatste serverstatus niet langer overeenkomt met uw branche).
    • Vermoedelijke deltafout (bijvoorbeeld verschijnen alleen gedeeltelijke wijzigingen na een normale upload).

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 pages 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

Opmerking

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 de pac pages download CLI-opdracht, genereert het naast het downloaden van de site-inhoud ook twee manifestbestanden.

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

Omgevingsmanifestbestand (org-url-manifest.yml)

Het manifestbestand van de omgeving wordt gegenereerd telkens wanneer de opdracht pac pages 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 pages upload gebruikt om de inhoud van de portal-website 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.

Opmerking

  • Het manifestbestand van de omgeving 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 webinhoud wordt gedownload met de opdracht pac-pagina's downloaden, worden de verwijderde records uit het omgeving-manifestbestand (org-url-manifest.yml) toegevoegd aan het manifest.yml-bestand. Dus wanneer u de website-inhoud uploadt met behulp van de opdracht pac pages uploaden , 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. 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.

Opmerking

Als u de site-inhoudsrecords in één omgeving wilt verwijderen en ook dezelfde inhoudsrecords in een andere omgeving wilt verwijderen met behulp van de PAC CLI, moet u de downloadopdracht pac-pagina'suitvoeren voor enna het verwijderen van de inhoud van de websiterecord. De manifest.yml houdt deze wijzigingen bij en verwijdert de bijbehorende records in de doelomgeving wanneer de opdracht pac pages 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

  • Last updated on