Dela via

Portalstöd för Microsoft Power Platform-CLI

  • Artikel

Anteckning

Från och med den 12 oktober 2022 byter Power Apps-portaler namn till Power Pages. Mer information: Microsoft Power Pages är nu allmänt tillgänglig (blogg)
Vi kommer snart migrera och sammanfoga dokumentationen för Power Apps-portaler med Power Pages-dokumentationen.

Microsoft Power Platform CLI (Command Line Interface) är ett enkelt kommandoradsgränssnitt som hjälper utvecklare och apputvecklare att skapa kodkomponenter.

Microsoft Power Platform CLI-verktyg är det första steget mot en omfattande hantering av programmets livscykel (ALM) där företagsutvecklare och oberoende programvaruutvecklare (ISV) kan skapa, skapa, felsöka och publicera sina tillägg och anpassningar snabbt och effektivt. Mer information finns i Vad är Microsoft Power Platform CLI?

Med den här funktionen hjälper Microsoft Power Apps-portaler Microsoft Power Platform CLI att aktivera CI/CD (kontinuerlig integrering/kontinuerlig distribution) av portalkonfigurationen. Du kan nu kontrollera portalkonfigurationen i syfte att källkontrollera och flytta portalkonfigurationen till valfri miljö med hjälp av Microsoft Power Platform CLI.

Anteckning

Denna funktion är vanligtvis tillgänglig från och med Power Platform-CLI version 1.9.8. Mer information om hur du installerar den senaste versionen finns i Installera Microsoft Power Platform-CLI.

Varför använda Microsoft Power Platform CLI för portalutveckling?

Med portalstöd för Microsoft Power Platform CLI kan du nu använda offline-liknande funktioner för portalanpassning genom att ändra portalinnehållet. När du har sparat alla anpassningar eller ändringar kan du överföra dem till portalen. När du hämtar portalinnehåll med Microsoft Power Platform CLI är innehållet strukturerat i YAML- och HTML-format, vilket gör det enkelt att anpassa och skapa en utvecklingsvänlig upplevelse.

Här följer en lista med funktioner som portaler kan dra nytta av med hjälp av Microsoft Power Platform CLI:

Användarvänlighet

  • Support för hämtning/överföring av portaldata till/från det lokala filsystemet

  • Bygg på befintligt Microsoft Power Platform CLI-verktyg.

Programlivscykelhantering (ALM)

  • Spåra ändringar till portalkonfiguration inom en organisation

  • Flytta konfigurationsfiler mellan organisationer eller klientorganisationer

Utvecklingsvänligt stöd och företagsstöd

  • Integrerar sömlöst med alla källkontrollverktyg, till exempel "git"

  • Enkel konfigurering av CI/CD-pipelines

Installera Microsoft Power Platform CLI

Stegvisa anvisningar finns i Installera Microsoft Power Platform CLI.

Tabeller som stöds

Portalstöd för Microsoft Power Platform CLI är begränsat till tabellerna som visas nedan.

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 (hämta endast)

adx_websitelanguage

adx_webtemplate

annotation

Viktigt

  • Anpassade tabeller och portalmallspecifika tabeller (till exempel en blogg-, community- eller idéportal) stöds inte för anpassning med Microsoft Power Platform CLI.
  • Bildfilsbilagor till ad-poster (adx_ad) laddas inte ned med hjälp av Power Platform-CLI. Du kan undvika detta genom att använda fältet Bild-URL eller genom att lägga till en HTML-referens i fältet Kopiera till en post av typen webbfil som innehåller en bildfil.

Installera och bekräfta Microsoft Power Platform CLI för portaler

Om du vill lära dig mer om hur du installerar Microsoft Power Platform går du till Installera Microsoft Power Platform CLI.

När du har installerat Microsoft Power Platform CLI öppnar du en kommandotolk och kör pac för att bekräfta att utdatan innehåller "paportal" – kommandot för Power Apps-portaler.

![Bekräfta kommandot "paportal" i Microsoft Power Platform CLI.](media/power-apps-cli/confirm-paportal.png "Bekräfta kommandot "paportal" i Microsoft Power Platform CLI")

Microsoft Power Platform CLI-kommandon för portaler

Microsoft Power Platform CLI-kommandot för portaler är "paportal".

Följande avsnitt innehåller ytterligare information om olika egenskaper för kommandot "paportal".

Parametrar

Egenskapsnamn Description Exempel
lista Listar alla portalwebbplatser från den aktuella Dataverse-miljön. pac paportal list
hämta Ladda ned portalens webbplatsinnehåll från den aktuella Dataverse-miljön. Följande parametrar gäller:
- path: Sökväg där webbplatsinnehållet laddas ned (alias: -p)
- webSiteId: Portalwebbplats-ID att hämta (alias: -id)
- overwrite: (valfritt) true – för att skriva över befintligt innehåll, false – misslyckas om mappen redan innehåller webbplatsinnehåll (alias: -o)		 pac paportal download --path "C:\portals" --webSiteId f88b70cc-580b-4f1a-87c3-41debefeb902
ladda upp Ladda upp portalens webbplatsinnehåll till den aktuella Dataverse-miljön. Följande parameter gäller:
- path: Sökväg där webbplatsinnehållet lagras (alias: -p)
-deploymentProfile: Ladda upp portaldata med miljödetaljer definierade genom profilvariabel i filen deployment-profiles/[profile-name].deployment.yaml		 pac paportal upload --path "C:\portals\starter-portal" --deploymentProfile "profile-name"
Använd distributionsprofil

Knappen deploymentProfile gör att du kan definiera en uppsättning variabler för miljön i YAML-format. Du kan till exempel ha olika distributionsprofiler (till exempel utveckling, test och prod) som har olika schemainformation definierade i profilen.

Om du skapar testprofilen kan du skapa filen under deployment-profiles med namnet "test.deployment.yml" (dvs. <profileTag>.deployment.yml). Du kan också köra kommandot med taggen (<profileTag>) för att använda den här profilen:

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

I den här filen kan du ha tabellnamnet (entiteten) med tabell-ID, lista över attribut och de värden du vill åsidosätta när du överför portalkonfigurationen med deploymentProfile parametern.

Dessutom kan du använda OS variabeln för att få åtkomst till operativsystemets miljövariabler.

Här är ett exempel på den här YAML-filen för profilen "test.deployment.yml" med unik schemainformation:

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

Anteckning

Om du vill lära dig mer om alla kommandon som används i CLI förutom portaler går du till Vanliga kommandon i Microsoft Power Platform CLI.

Manifestfiler

När du hämtar webbplatsens innehåll med hjälp av pac paportal ladda ned kan du hämta CLI-kommandot, samt hämta webbplatsens innehåll och generera två manifestfiler;

  • Miljömanifestfil (org-url-manifest.yml)
  • Ta bort spårningsmani digt fil (manifest.yml)

Miljömanifestfil (org-url-manifest.yml)

Miljömanifestfilen genereras varje gång kommandot pac paportal ladda ned körs.

Efter varje nedladdning läser PAC CLI-verktyget den befintliga miljömanifestfilen och uppdaterar posterna som tagits bort i miljön, eller skapar miljömanifestfilen om den inte finns.

När du kör kommandot pac paportal ladda upp för att överföra innehållet på portalens webbplats. Den läser miljömanifestfilen och identifierar ändringarna som gjorts sedan den senaste hämtningen och överför endast det uppdaterade innehållet. Detta hjälper till att optimera överföringsprocessen så att bara uppdaterat innehåll på webbplatsen överförs, i stället för att överföra allt innehåll på varje överföringskommando.

Miljömanifestfil kommer att vara lätt att läsa när den ansluter till samma miljö (miljö-URL matchar med filnamn), för att undvika oavsiktliga ändringar.

Ta bort spårningsmani digt fil (manifest.yml)

Den här filen används för att spåra de borttagna posterna från miljön.

När webbplatsinnehåll laddas ned med kommandot pac paportal ladda ned lägger detta till de borttagna posterna från miljö manifestfil (org-url-manifest.yml) till filen manifest.yml. När du laddar upp webbplatsens innehåll med hjälp av kommandot pac paportal ladda upp raderar det filerna från miljön (även till en annan miljö). Den här filen tas inte bort och används oavsett vilken miljö du är ansluten till.

Anteckning

För att ta bort webbplatsinnehållsposterna i en miljö och dessutom ta bort samma innehållsposter i en annan miljö med hjälp av PAC CLI måste du köra kommandot pac paportal ladda ned före och efter radering av webbplatsens innehåll. Filen manifest.yml spårar dessa ändringar och tar bort motsvarande poster i målmiljön när kommandot pac paportal ladda upp körs.

Använd tillägget för Visual Studio Code

Du kan också använda VS Code-tillägget VS Code-tillägg för Power Platform om du vill utnyttja det inbyggda Liquid-språket från IntelliSense, få hjälp med kodkomplettering, tips och interaktion med Microsoft Power Platform CLI med hjälp av VS Code Integrated Terminal. Mer information: Använd tillägget för Visual Studio Code (förhandsversion)

Ytterligare överväganden

  • Ett fel rapporteras om att filsökvägen överskrider begränsningen för maximal sökvägslängd. Mer information: Begränsning av maximal längd för sökväg i Windows
  • För dubblettposter, till exempel ett dubblettnamn på webbsidan, skapar Microsoft Power Platform CLI två olika mappar — en med namnet på webbsidan, och den andra med samma namn och en hash-kod som prefix. Till exempel "Min sida" och "Min sida-hash-kod".

Nästa steg

Självstudier: Använd Microsoft Power Platform CLI med portaler

Se även