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

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.

I detta självstudieexempel lär du dig hur du kommer igång med Microsoft Power Platform CLI för att uppdatera exempelportalkonfigurationen.

Anteckning

• Du kan också använda Power Platform CLI med Power Pages. Mer information: Vad är Power Pages
• Denna självstudie fokuserar på erforderliga Microsoft Power Platform CLI-kommandon som Power Apps för portaler använder. Mer information om kommandon som används i Power Platform CLI finns i vanliga kommandon.

Hämta och installera Visual Studio Code

För att ansluta till Power Apps-portaler och använda Microsoft Power Platform CLI-kommandon använder du Visual Studio Code samt den inbyggda terminalen. Den integrerade terminalen gör det enkelt att ansluta till Dataverse-miljön och att hämta, ändra och överföra portalkonfigurationen. Du kan också använda Windows PowerShell istället.

Steg 1. Autentisera

Innan du ansluter, listar, hämtar eller överför ändringar för en Power Apps-portal måste du först autentisera till Dataverse-miljön. Mer information om autentisering med Microsoft Power Platform CLI finns i pac auth.

Om du vill autentisera öppnar du Windows PowerShell och kör kommandot pac auth create med din Dataverse miljö-URL:

pac auth create -u [Dataverse URL]

Exempel

pac auth create -u https://contoso-org.crm.dynamics.com

Följ autentiseringsanvisningarna för att logga in på miljön.

Steg 2. Ange tillgängliga portaler

Använd pac paportal-listan för att lista de tillgängliga Power Apps-portalerna i den Dataverse-miljö anslöt till i föregående steg.

pac paportal list

Steg 3. Hämta portalinnehåll

Hämta portalwebbplatsinnehåll från den anslutna Dataverse-miljön med hjälp av kommandot pac paportal nedladdning.

pac paportal download --path [PATH] -id [WebSiteId-GUID]

Exempel

pac paportal download --path c:\pac-portals\downloads -id d44574f9-acc3-4ccc-8d8d-85cf5b7ad141

För parametern id använder du det WebSiteId som returnerades från utdatan från föregående steg.

Steg 4. Ändra portalinnehåll

Ändra konfigurationen med hjälp av Visual Studio Code och spara ändringarna.

Anteckning

Se till att du endast uppdaterar de tabeller som stöds och används med Power Platform CLI. Mer information finns i tabeller som stöds.

På standardportalsidan visas till exempel följande text:

Den här texten visas från webbsidans html:

Du kan ändra den här texten och spara ändringarna:

Tips

Du kan ändra sökvägen till mappen i PowerShell/integrated terminal till den hämtade platsen och ange kod. för att öppna mappen direkt i Visual Studio Code.

Steg 5. Ladda upp ändringarna

Anteckning

• Om du laddar upp till flera miljöer kan du läsa om hur du laddar upp ändringarna med hjälp av distributionsprofilen i Ladda upp ändringar med hjälp av distributionsprofil.
• Se till att målmiljöns största storlek för bifogade filer har samma eller större storlek som källmiljön.
• Den maximala storleken på filer fastställs av inställningen Maximal filstorlek på fliken e-post med systeminställningar i dialogrutan miljösysteminställningar.

När du har utfört erforderliga ändringar överför du dem med kommando pac paportal uppladdning:

pac paportal upload --path [Folder-location]

Exempel

pac paportal upload --path C:\pac-portals\downloads\custom-portal\

Anteckning

Se till att sökvägen till portalinnehållet som du har angett är korrekt. Som standard skapas en mapp som namnges av portalalen (eget namn) med innehåll från hämtade portaler. Om portalens eget namn till exempel är anpassad-portal bör sökvägen för ovanstående kommando (--path) vara C:\pac-portals\downloads\custom-portal.

Överföringen sker bara för innehåll som har ändrats. I det här exemplet överförs innehållet endast till adx_webpage webbsida.

Ladda upp ändringarna med hjälp av distributionsprofil

När du arbetar med flera olika miljöer kanske du bör överväga att använda distributionsprofiler för att se till att ändringarna laddas upp till rätt miljö med hjälp av distributionsprofilen.

1. Skapa en mapp med namnet distributionsprofiler i mappen som innehåller portalinnehållet. Om det hämtade portalinnehållet till exempel finns i "startportalen" bör mappen med distributionsprofiler finnas i den här mappen.

   

2. I mappen med distributionsprofiler skapar du en YAML-fil som innehåller de miljöspecifika ändringarna. Utvecklingsmiljön kan till exempel kallas "dev.deployment.yml".

   

3. Redigera distributions-YAML-filen med Visual Studio Code med följande format:

   <table-name>:
   - <record-id>: <GUID>
     <column-name>: <Name>
     <column-value>: <Value>
   

   I följande exempelkod för YAML uppdateras till exempel värdet för "Suffix för webbläsartitel" från standard "Anpassad portal" till "Anpassad portal (dev)".

   adx_contentsnippet:
       - adx_contentsnippetid: 76227a41-a33c-4d63-b0f6-cd4ecd116bf8 # Replace with your content snippet ID
         adx_name: Browser Title Suffix # Setting name
         adx_value:   · Custom Portal (Dev) # Setting value
   

4. Om du vill ladda upp ändringarna till en annan miljö med hjälp av en YAML-fil för distributionsprofilen måste du först autentisera till målorganisationen.

5. När du har autentiserat och kopplat till rätt miljö använder du kommandot pac paportal uppladdning för att ladda upp innehållet:

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

   Anteckning

   I exemplet ovan används namnet på distributionsprofilen "dev" efter att ha följt föregående steg för att skapa en profil för utveckling av distributionen. Ändra namnet från "dev" till något annat (t.ex. QA för "qa.deployment.yml" eller Test för "test.deployment.yml") om du har använt ett annat filnamn för YAML-filen för distribution.

Steg 6. Bekräfta ändringarna

Så här bekräftar du ändringarna på portalens webbsida:

1. Rensa cachen på serversidan eller använd Synkronisera konfiguration med hjälp av Power Apps Portals Studio.

2. Bläddra till portalens webbsida för att se ändringen.

   

3. Om du tidigare har använt exempelprofilen för distribution som förklarats tidigare uppdaterar YAML-kodavsnittet värdet enligt vad som visas nedan.

   

   Suffix för webbläsartiteln som uppdateras genom ändringen ovan visar ändringen när du öppnar portalen i en webbläsare:

   

Detta avslutar självstudien. Du kan upprepa ovanstående steg och ändra portalinnehållet för andra tabeller som stöds.

Nästa steg

Använd Visual Studio Code tillägget

Se även

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