Portalconfiguratie migreren

Notitie

Met ingang van 12 oktober 2022 wordt Power Apps-portals hernoemd tot Power Pages. Meer informatie: Microsoft Power Pages is nu algemeen beschikbaar (blog)
We zullen binnenkort de documentatie voor Power Apps-portals migreren en samenvoegen met Power Pages-documentatie.

Portalontwikkeling omvat verschillende configuraties en aanpassingen om een gewenste ervaring te bieden aan de eindgebruikers van een portal.

Nadat u de ontwikkeling of configuratie van uw portalexemplaar hebt voltooid, kunt u uw meest recente portalconfiguratie migreren van uw ontwikkel- of testomgeving naar uw productieomgeving.

Migratie houdt het exporteren van de bestaande configuratiegegevens van de bronomgeving van Microsoft Dataverse in en het importeren van deze gegevens in de doelomgeving van Dataverse.

De doelomgeving voorbereiden

Notitie

• Het voorbereiden van de doelomgeving is een eenmalig proces. U moet een nieuwe portal inrichten om de beheerde portaloplossingen te kunnen installeren in Dataverse en de portal-webtoepassing configureren. Met het proces worden ook standaard portalmetagegevens geïnstalleerd die worden vervangen door portalmetagegevens uit uw bronomgeving.
• Zorg ervoor dat de maximale bijlagegrootte van de doelomgeving is ingesteld op dezelfde of een grotere grootte als uw bronomgeving.
• De maximale grootte van bestanden wordt bepaald door de instelling Maximale bestandsgrootte op het tabblad e-mail van systeeminstellingen in het dialoogvenster met omgevingssysteeminstellingen.

1. Een nieuwe portal inrichten in uw doelomgeving. Gebruik dezelfde portalsjabloon zoals u in uw bronomgeving hebt ingericht. Als u bijvoorbeeld de Dynamics 365 Customer Self-Service-portal in uw bronomgeving hebt ingericht, richt u de Dynamics 365 Customer Self-Service-portal in voor uw doelomgeving.

2. Verwijder in de doelomgeving met de Portalbeheer-app de nieuw gemaakte websiterecord. Hiermee worden de standaard portalconfiguratiegegevens uit de doelomgeving verwijderd.

   

3. Verwijder de portal-app in de doelomgeving. Hiermee wordt de portal-app verwijderd die momenteel is geconfigureerd om de standaardportal weer te geven.

   Notitie

   Verwijder niet de Portalbeheer-app!

   

4. Breng de portalmetagegevens uit de bronomgeving over met Power Platform CLI of het hulpprogramma voor configuratiemigratie.

5. Richt in de doelomgeving een nieuwe portal in met behulp van de bestaande optie voor de portalwebsite. Via dit proces wordt een portal geconfigureerd met behulp van de portalconfiguratie die u vanuit de bronomgeving hebt overgebracht.

   

6. De portalupdates van de bronomgeving moeten worden weerspiegeld in deze nieuwe doelomgeving. In de toekomst zou u de configuratie van uw bron- naar uw doelomgevingen moeten kunnen overdragen door de portalconfiguratiegegevens over te dragen.

Metagegevens van portal overzetten

Power Platform CLI

Notitie

Met ingang van 12 oktober 2022 wordt Power Apps-portals hernoemd tot Power Pages. Meer informatie: Microsoft Power Pages is nu algemeen beschikbaar (blog)
We zullen binnenkort de documentatie voor Power Apps-portals migreren en samenvoegen met Power Pages-documentatie.

Portalconfiguratie overzetten met Power Platform CLI

Microsoft Power Platform CLI biedt veel functies speciaal voor portals. Met deze opdrachten kunt u de portalconfiguratie downloaden uit een bronomgeving en deze overzetten naar een doelomgeving. Deze opdrachten kunnen ook worden opgenomen in uw ALM-processen.

1. Maak Power Platform CLI-verificatieprofielen om verbinding te maken met zowel uw bron- als doelomgevingen. U kunt ze een naam geven zodat u de doel- en bronomgevingen eenvoudig kunt identificeren.

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

   Voorbeeld

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

2. Wanneer de verificatieprofielen zijn gemaakt, hebben ze een bijbehorende index die kan worden bepaald met de lijstopdracht.

   pac auth list
   

   

3. Selecteer het Power Platform CLI-verificatieprofiel dat is verbonden met de bronomgeving.

   pac auth select --index [source environment index]
   

   Voorbeeld

   pac auth select --index 1
   

4. Bepaal de website-id voor de bronportal.

   pac paportal list
   

   

5. Download de configuratiegegevens van de portal naar uw lokale werkstation. Stel de optie --overschrijven in op waar als u een eerdere portalconfiguratie naar hetzelfde pad hebt gedownload.

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

   Voorbeeld

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

6. Selecteer het Power Platform CLI-verificatieprofiel dat is verbonden met de doelomgeving.

   pac auth select --index [target environment index]
   

   Voorbeeld

   pac auth select --index 2
   

7. Upload de portalconfiguratiegegevens naar de doelomgeving.

   pac paportal upload --path [path]
   

   Voorbeeld

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

Notitie

Er worden geen tabellen of tabelschema gemigreerd door het Power Platform CLI-hulpprogramma. Migratie kan mislukken als elementen zoals tabellen en velden ontbreken wanneer configuratiegegevens niet overeenkomen met het geselecteerde schema. Zorg er tijdens het importeren voor dat de doelomgeving hetzelfde portaltype bevat dat al is geïnstalleerd met eventuele aanvullende aanpassingen zoals tabellen, velden, formulieren of weergaven die afzonderlijk als oplossingen zijn geïmporteerd.

Hulpprogramma voor configuratiemigratie

Notitie

Met ingang van 12 oktober 2022 wordt Power Apps-portals hernoemd tot Power Pages. Meer informatie: Microsoft Power Pages is nu algemeen beschikbaar (blog)
We zullen binnenkort de documentatie voor Power Apps-portals migreren en samenvoegen met Power Pages-documentatie.

Portalconfiguratie overbrengen met het hulpprogramma voor configuratiemigratie

Notitie

De voorkeursmethode is om Power Platform CLI te gebruik voor het overzetten van portalmetagegevens.

Als u configuratiegegevens wilt exporteren, moet u het hulpprogramma voor configuratiemigratie en een portalspecifiek configuratieschemabestand gebruiken. Voor meer informatie over dit hulpprogramma raadpleegt u Configuratiegegevens beheren.

Notitie

• Wij adviseren u gebruik te maken van de meest recente versie van het hulpprogramma voor configuratiemigratie. Het hulpprogramma voor configuratiemigratie kan worden gedownload vanaf NuGet. Meer informatie voor het downloaden van het hulpprogramma: Hulpmiddelen downloaden van NuGet.
• De minimale oplossingsversie van portals die door schemabestanden wordt ondersteund voor configuratiemigratie is 8.4.0.275. We raden u echter aan de meest recents oplossingsversie te gebruiken.
• Bron- en bestemmingsorganisaties moeten dezelfde standaardtaal hebben om de migratie te laten werken.

Er zijn schemabestanden beschikbaar zijn voor de volgende portaltypen:

• Portals gemaakt in een omgeving met Dataverse

  • Aangepaste portal (lege portal)
  • Aangepaste portal (lege portal) (voor versie 9.2.2103.x)
  • Aangepaste portal (lege portal) (voor versie 9.3.2201.x of hoger)

• Portals die zijn gemaakt in omgevingen met apps voor klantbetrokkenheid (zoals Dynamics 365 Sales en Dynamics 365 Customer Service) verschijnen in de lijst.

  • Aangepaste portal (lege portal)
  • Aangepaste portal (lege portal) (voor versie 9.2.2103.x)
  • Aangepaste portal (lege portal) (voor versie 9.3.2201.x of hoger)
  • Communityportal
  • Selfserviceportal van klanten
  • Partnerportal
  • Selfserviceportal van werknemers

De standaardschemabestanden bevatten informatie over portaltabellen, relaties en uniciteitsdefinities voor elke entiteit. Meer informatie: Portalconfiguratiegegevens exporteren

Nadat u de configuratiegegevens hebt geëxporteerd, moet u deze in de doelomgeving importeren. Meer informatie: Portalconfiguratiegegevens importeren

Notitie

Het configuratiemigratieprogramma gebruikt een schema om configuratiegegevens te exporteren en te importeren. Er worden geen tabellen of tabelschema gemigreerd. Migratie kan mislukken met ontbrekende elementen zoals tabellen en velden wanneer configuratiegegevens niet overeenkomen met het geselecteerde schema.

Zorg er tijdens het exporteren voor dat de bronomgeving portaltabellen bevat zoals gespecificeerd in het schemabestand van de configuratiemigratietool. U kunt het schemabestand aanpassen om tabellen, kenmerken enzovoort toe te voegen, te verwijderen en te wijzigen om een subset van configuratiegegevens te migreren.

Zorg er tijdens het importeren voor dat de doelomgeving hetzelfde portaltype bevat dat al is geïnstalleerd met eventuele aanvullende aanpassingen zoals tabellen, velden, formulieren of weergaven die afzonderlijk als oplossingen zijn geïmporteerd.

Portalconfiguratiegegevens exporteren

U kunt portalconfiguratiegegevens exporteren vanuit een bronsysteem met behulp van portalspecifieke configuratieschemabestanden.

1. Download het hulpprogramma voor configuratiemigratie pak het uit in de gewenste map.

2. Download een portalconfiguratiebestand via de koppelingen die hierboven worden verstrekt voor uw portaltype.

3. Dubbelklik op het bestand DataMigrationUtility.exe in de map <your_folder>\Tools\ConfigurationMigration om het hulpprogramma voor configuratiemigratie uit te voeren, kies Gegevens exporteren op het hoofdscherm en selecteer vervolgens Doorgaan.

   

4. Het scherm Aanmelden geeft verificatiedetails om verbinding te maken met uw Dataverse-omgeving van waaruit u gegevens wilt exporteren. Als u meer organisaties in de Dataverse-omgeving hebt en de organisatie wilt selecteren van waaruit u de gegevens wilt exporteren, schakelt u het selectievakje Altijd de lijst met beschikbare organisaties weergeven in en selecteert u Aanmelden.

   

5. Als u meerdere organisaties hebt en u het selectievakje Altijd de lijst met beschikbare organisaties weergeven hebt ingeschakeld in de vorige stap, kunt u in het volgende scherm de organisatie kiezen waarmee u verbinding wilt maken. Selecteer een Dataverse-omgeving waarmee u verbinding wilt maken.

   Notitie

   Als u niet over meerdere organisaties beschikt wordt dit scherm niet weergegeven.

6. Blader in Schemabestand en selecteer het portalspecifieke configuratieschemabestand dat moet worden gebruikt voor het exporteren van de gegevens.

7. Geef in Opslaan naar gegevensbestand de naam en locatie op van het gegevensbestand dat moet worden geëxporteerd.

   

8. Selecteer Gegevens exporteren. Het scherm bevat de voortgang van de export en de locatie van het geëxporteerde bestand onder aan het scherm, nadat de export is voltooid.

   

9. Selecteer Afsluiten om het hulpmiddel te sluiten.

Portalconfiguratiegegevens importeren

1. Voer het hulpprogramma voor configuratiemigratie uit en kies Gegevens importeren op het hoofdscherm en selecteer vervolgens Doorgaan.

   

2. Het scherm Aanmelden geeft verificatiedetails om verbinding te maken met uw Dataverse-omgeving van waaruit u gegevens wilt exporteren. Als u meer organisaties in de Dataverse-omgeving hebt en de organisatie wilt selecteren van waaruit u de gegevens wilt exporteren, schakelt u het selectievakje Altijd de lijst met beschikbare organisaties weergeven in en selecteert u Aanmelden.

3. Als u meerdere organisaties hebt en u het selectievakje Altijd de lijst met beschikbare organisaties weergeven hebt ingeschakeld in de vorige stap, kunt u in het volgende scherm de organisatie kiezen waarmee u verbinding wilt maken. Selecteer een Dataverse-omgeving waarmee u verbinding wilt maken.

   Notitie

   • Als u niet over meerdere organisaties beschikt wordt dit scherm niet weergegeven.
   • Zorg ervoor dat de portaloplossing al is geïnstalleerd voor de organisatie waar u de configuraties wilt importeren.

4. In het volgende scherm wordt u gevraagd het te importeren gegevensbestand (.zip) op te geven. Blader naar het gegevensbestand, selecteer het en selecteer vervolgens Gegevens importeren.

   

5. Het volgende scherm bevat de importstatus van uw records. Het importeren van gegevens wordt in meerdere stappen uitgevoerd. Eerst worden de basisgegevens geïmporteerd terwijl de afhankelijke gegevens worden klaargezet en vervolgens worden in de volgende stappen de afhankelijke gegevens geïmporteerd om eventuele gegevensafhankelijkheden of koppelingen te verwerken. Deze actie garandeert een schone en consistente gegevensimport.

6. Selecteer Afsluiten om het hulpmiddel te sluiten.

Nieuwe portal maken met gemigreerde gegevens

Als door het migratieproces een bestaande portal wordt bijgewerkt, zouden de updates nu zichtbaar moeten zijn in de doelomgeving. Als de migratie een nieuwe portal betreft, kunt u de nieuwe portal maken voor de geïmporteerde websiterecord met de optie Gegevens van bestaande websiterecord gebruiken. Meer informatie: Portal maken

Migratie van tenant naar tenant

Power Apps-portals ondersteunt geen migratie van tenant naar tenant. Als u een portal van de ene tenant naar de andere wilt migreren, moet u deze stappen volgen:

1. Opnieuw instellen van uw portal in de brontenant.

2. Een nieuwe portal inrichten in een omgeving met Dataverse of die apps voor klantbetrokkenheid bevatten.

3. Migreer portalconfiguraties en aanpassingen met de stappen die eerder in dit artikel zijn uitgelegd.

Zie ook

• Wijzigingen bijhouden in de configuratie van Power Apps-portals.
• Portalsondersteuning voor Microsoft Power Platform CLI
• Migratie van tenant naar tenant van een Power Platform-omgeving.
• Migratie van tenant naar tenant van modelgestuurde apps in Dynamics 365 zoals Sales, Customer Service, Marketing, Field Service en Project Service Automation.

Notitie

Laat ons uw taalvoorkeuren voor documentatie weten! Beantwoord een korte enquête. (houd er rekening mee dat deze in het Engels is)

De enquête duurt ongeveer zeven minuten. Er worden geen persoonlijke gegevens verzameld (privacyverklaring).