Microsoft Power Platform CLI support för Power Pages

Microsoft Power Platform CLI (kommandoradsgränssnitt) ä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 på Vad är Microsoft Power Platform CLI?

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

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

Med Microsoft Power Platform CLI kan du nu använda offline-liknande funktioner för webbplatsanpassning genom att ändra webbplatsinnehållet. När du har sparat alla anpassningar eller ändringar kan du överföra webbplatskonfigurationen tillbaka till Microsoft Dataverse. När du hämtar webbplatsinnehå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 data från webbplatskonfiguration till/från det lokala filsystemet

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

Programlivscykelhantering (ALM)

• Spåra ändringar till webbplatskonfiguration 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 i följande tabeller.

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 utdata innehåller "paportal" – kommandot för Power Apps-portaler.

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

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" (that is, <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 --modelVersion 2

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

Manifestfiler

När du laddar ner webbplatsens innehåll med hjälp av pac paportal download CLI-kommandot, tillsammans med nedladdning av webbplatsens innehåll genererar det också 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ömanifestfilen är skrivskyddad när den ansluter till samma miljö (miljö-URL matchar med filnamnet) 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 webbplatsens innehåll laddas ned med kommandot pac paportal download, detta lägger till de borttagna posterna från miljömanifestfil (org-url-manifest.yml) till filen manifest.yml. Så när du laddar upp webbplatsens innehåll med hjälp av kommandot pac paportal upload tas filerna bort från miljön (till och med till en annan miljö). Den här filen tas inte bort och används oavsett vilken miljö du är ansluten till. Den här filen måste beaktas när du trycker på ändringar i källkontrollen för att överväga att ta bort objekt i målmiljön.

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)

Fler ö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

• Microsoft Power Platform CLI
• Använd tillägget för Visual Studio Code (förhandsversion)