Portalstöd för Microsoft Power Platform-CLI

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.

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.

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

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

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.

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

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