Migrera portalkonfiguration

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.

Portalutveckling består av flera konfigurationer och anpassningar för att uppnå en önskad upplevelse för portalens slutanvändare.

När du har slutfört utvecklingen eller konfigurationen av din portalinstans kanske du vill migrera din senaste portalkonfiguration från utveckling till test eller produktionsmiljöer.

Migrering involverar att exportera den befintliga konfigurationen från Microsoft Dataverse-källmiljön och sedan importera den till Dataverse-målmiljön.

Förbered målmiljön

Anteckning

• Att förbereda målmiljön är en engångsprocess. Du måste tillhandahålla en ny portal för att kunna installera de hanterade portallösningarna i Dataverse, samt även konfigurera portalwebbprogrammet. Denna process omfattar även installation av standardportalmetadata, vilka sedan ersätts med portalmetadata från källmiljön.
• 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.

1. Skapa en ny portal i målmiljön. Använd samma portalmall som du tillhandahöll i källmiljön. Om du till exempel tillhandahöll portalen Dynamics 365-portaler – självbetjäningsportal för kunder i din källmiljö ska du tillhandahålla portalen Dynamics 365-portaler – självbetjäningsportal för kunder även i målmiljön.

2. I målmiljön använder du programmet Portalhantering och raderar den nyskapta webbplatsposten. I och med detta tas standardportalkonfigurationsdatan bort från målmiljön.

   

3. I målmiljön tar du bort portalappen. Detta innebär att den portalapp som för närvarande är konfigurerad för rendering av standardportalen tas bort.

   Anteckning

   Ta inte bort programmet Portalhantering!

   

4. Överför portalmetadatan från källmiljön med hjälp av Power Platform CLI eller konfigurationsverktyget för migrering.

5. I målmiljön skapar du en ny portal med det befintliga alternativet för portalwebbplats. Med den här processen konfigureras en portal med hjälp av portalkonfigurationen som du överförde från källmiljön.

   

6. Portaluppdateringarna från källmiljön ska återspeglas i den nya målmiljön. I framtiden bör du kunna överföra konfigurationen från källan till målmiljöer genom att överföra portalkonfigurationsdata.

Överföra portalmetadata

Power Platform CLI

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.

Överföra portalkonfiguration med Power Platform CLI

Microsoft Power Platform CLI har många funktioner specifika för portaler. Med dessa kommandon kan du hämta portalkonfigurationen från en källmiljö och sedan överföra den till en målmiljö. Dessa kommandon kan också ingå i dina ALM-processer.

1. Skapa Power Platform CLI-autentiseringsprofiler för att ansluta till både käll- och målmiljöerna. Du kan ge dem ett namn för att enkelt identifiera mål- och källmiljöerna.

   pac auth create --name [name] --url [environment url]
   

   Exempel

   pac auth create --name PORTALDEV --url https://contoso-org.crm.dynamics.com
   

2. När autentiseringsprofilerna skapas får de ett associerat index som kan fastställas med hjälp av listkommandot.

   pac auth list
   

   

3. Välj den Power Platform CLI-autentiseringsprofil som är kopplad till källmiljön.

   pac auth select --index [source environment index]
   

   Exempel

   pac auth select --index 1
   

4. Fastställa webbplats-ID:t för källportalen.

   pac paportal list
   

   

5. Hämta portalkonfigurationsdata till din lokala arbetsstation. Annge alternativuppsättningen --skriva över som true (sann) om du redan har hämtat portalkonfigurationen till samma sökväg.

   pac paportal download --path [path] --webSiteId [website id]
   

   Exempel

   pac paportal download --path c:\paportals\ --webSiteId db9db518-ea5c-ec11-8f8f-00224804e6cd
   

6. Välj den Power Platform CLI-autentiseringsprofil som är kopplad till målmiljön.

   pac auth select --index [target environment index]
   

   Exempel

   pac auth select --index 2
   

7. Överför portalkonfigurationsdata till målmiljön.

   pac paportal upload --path [path]
   

   Exempel

   pac paportal upload --path "C:\paportals\portaldev"
   

Anteckning

Verktyget Power Platform CLI migrerar inte tabeller eller tabellscheman. Migreringen kan misslyckas (element såsom tabeller och fält kan saknas) när konfigurationsdata inte matchar valt schema. Under importen ser du till att målmiljön innehåller samma portaltyp som redan har installerats med eventuella ytterligare anpassningar, till exempel tabeller, fält, formulär eller vyer som importeras separat som lösningar.

Konfigurationsverktyg för migrering

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.

Överför portalkonfigurationer med verktyget för konfigurationsmigrering

Anteckning

Den bästa metoden är att använda Power Platform CLI för att överföra portalmetadata.

Om du vill exportera konfigurationsdata måste du använda konfigurationsverktyget för migrering samt en portalspecifik konfigurationsschemafil. Mer information om detta verktyg finns i Hantera konfigurationsdata.

Anteckning

• Vi rekommenderar att du använder den senaste versionen av migrationsverktyget för konfiguration. Migrationsverktyget för konfiguration kan hämtas från NuGet. Mer information om att hämta verktyget: hämta verktyg från NuGet.
• Den lägsta lösningsversionen för portaler som stöds av schemafiler för konfigurationsmigrering är 8.4.0.275. Men vi rekommenderar att du använder den senaste versionen.
• Käll- och målorganisationer måste ha samma standardspråk för att migreringen ska kunna fungera.

Schemafiler är tillgängliga för följande portaltyper:

• Portaler som skapats i en miljö med Dataverse

  • Anpassad portal (tom portal)
  • Anpassad portal (tom portal) (för version 9.2.2103.x)
  • Anpassad portal (tom portal) (för version 9.3.2201.x eller senare)

• Portaler som skapats i en miljö som innehåller Customer Engagement-appar (till exempel Dynamics 365 Sales and Dynamics 365 Customer Service)

  • Anpassad portal (tom portal)
  • Anpassad portal (tom portal) (för version 9.2.2103.x)
  • Anpassad portal (tom portal) (för version 9.3.2201.x eller senare)
  • Communityportal
  • Självbetjäningsportal för kunder
  • Partnerportal
  • Självbetjäningsportalen för anställda

Standardschemafilen innehåller information om alla portaltabeller, relationer och unika definitioner för varje entitet. Mer information finns i Exportera portalkonfigurationsdata.

När du exporterar konfigurationsdata måste du importera den till målmiljö. Mer information finns i Importera portalkonfigurationsdata.

Anteckning

Migrationsverktyg för konfiguration använder scheman för att exportera och importera konfigurationsdata. Verktyget migrerar inte tabeller eller tabellscheman. Migreringen kan misslyckas om element som tabeller och fält saknas när konfigurationsdata inte matchar det valda schemat.

Under exporten ser du till att källmiljön innehåller portaltabeller enligt vad som anges i schemafilen för konfigurationsmigreringsverktyget. Du kan fortfarande ändra schemafilerna för att lägga till, ta bort och ändra tabeller, attribut och så vidare för att migrera delmängd av konfigurationsdata.

Under importen ser du till att målmiljön innehåller samma portaltyp som redan har installerats med eventuella ytterligare anpassningar, till exempel tabeller, fält, formulär eller vyer som importeras separat som lösningar.

Exportera portalkonfigurationsdata

Du kan exportera portalkonfigurationsdata från ett källsystem genom att använda portalspecifik standardkonfigurationsschema.

1. Hämta migrationsverktyg för konfiguration och extrahera till önskad mapp.

2. Hämta en schemafil för portalkonfiguration med hjälp av länkarna ovan för din portaltyp.

3. Dubbelklicka på filen DataMigrationUtility.exe i mappen <your_folder>\Tools\ConfigurationMigration för att köra migrationsverktyget för konfiguration, välj Exportera data på huvudskärmen och välj sedan Fortsätt.

   

4. I vyn Inloggning anger du autentiseringsinformation i syfte att ansluta till din Dataverse-miljö från den plats där du vill exportera data. Om du har olika organisationer i den Dataverse-miljö från vilken du vill exportera datan markerar du kryssrutan Visa lista över tillgängliga organisationer, och välj sedan Inloggning.

   

5. Om du har flera organisationer och du har markerat kryssrutan Visa listan över tillgängliga organisationer i föregående steg, kan du i nästa skärm välja den organisation som du vill ansluta till. Välj en Dataverse-miljö att ansluta till.

   Anteckning

   Om du inte har flera organisationer visas inte den här skärmen.

6. I schemafil, bläddra och markera portalspecifika konfigurationsschemafilen som ska användas för dataexporten.

7. I Spara till datafil, ange namn och plats för datafilen som ska exporteras.

   

8. Välj Exportera data. På skärmen visas statusen för exporten och platsen för den exporterade filen längst ned på skärmen när exporten är klar.

   

9. Välj Avsluta för att stänga verktyget.

Importera portalkonfigurationsdata

1. Kör migrationsverktyg för konfiguration och välj importera data i huvudfönstret och markera Fortsätt.

   

2. I vyn Inloggning anger du autentiseringsinformation i syfte att ansluta till din Dataverse-miljö från den plats där du vill exportera data. Om du har olika organisationer i den Dataverse-miljö från vilken du vill exportera datan markerar du kryssrutan Visa lista över tillgängliga organisationer, och välj sedan Inloggning.

3. Om du har flera organisationer och du har markerat kryssrutan Visa listan över tillgängliga organisationer i föregående steg, kan du i nästa skärm välja den organisation som du vill ansluta till. Välj en Dataverse-miljö att ansluta till.

   Anteckning

   • Om du inte har flera organisationer visas inte den här skärmen.
   • Se till att portallösningen redan är installerad för den organisation där du tänker importera konfigurationerna.

4. På nästa skärm uppmanas du att ange den datafil (.zip) som ska importeras. Bläddra till datafilen, markera den och välj Importera data.

   

5. Nästa skärm visar posternas importstatus. Dataimporten sker i flera steg för att först importera grunddata medan beroende data köas och sedan importera beroende data i efterföljande pass för att hantera alla databeroenden och kopplingar. Denna åtgärd säkerställer en ren och konsekvent dataimport.

6. Välj Avsluta för att stänga verktyget.

Skapa en ny portal med migrerade data

Om migreringsprocessen uppdaterar en befintlig portal ska uppdateringarna nu visas i målmiljön. Om migreringen gäller en ny potal kan du nu skapa den nya portalen för den importerade webbplatsposten med hjälp av alternativet Använd data från befintlig webbplatspost. Mer information: Skapa portal.

Migrering klientorganisation-till-klientorganisation

Power Apps-portaler stöder inte migrering klientorganisation-till-klientorganisation. Om du vill migrera en portal från en klientorganisation till en annan måste du följa stegen nedan:

1. Återställ portalen i källinnehavaren.

2. Tillhandahålla en ny portal i en miljö med Dataverse eller med Customer Engagement-appar.

3. Migrera portalkonfigurationer och anpassningar enligt stegen som förklarats tidigare.

Se även

• Spåra ändringar i Power Apps-portalkonfigurationer.
• Portalstöd för Microsoft Power Platform CLI.
• Migrering klientorganisation-till-klientorganisation av en Power Platform-miljö.
• Migrering klientorganisation-till-klientorganisation av modellbaserade appar i Dynamics 365, till exempel Sales, Customer Service, Marketing, Field Service och Project Service Automation.

Anteckning

Kan du berätta om dina inställningar för dokumentationsspråk? Svara i en kort undersökning. (observera att undersökningen är på engelska)

Undersökningen tar ungefär sju minuter. Inga personuppgifter samlas in (sekretesspolicy).