Configuratiegegevens verplaatsen van de ene naar de andere omgeving en organisatie het hulpprogramma voor configuratiemigratie

Met het hulpprogramma voor configuratiemigratoe kunt u configuratiegegevens verplaatsen van de ene naar de andere omgeving en organisatie. Configuratiegegevens worden gebruikt om aangepaste functionaliteit te definiëren in apps voor klantbetrokkenheid (Dynamics 365 Sales, Dynamics 365 Customer Service, Dynamics 365 Field Service, Dynamics 365 Marketing en Dynamics 365 Project Service Automation) en worden doorgaans opgeslagen in aangepaste entiteiten. Configuratiegegevens verschillen van de eindgebruikergegevens (account, contactpersonen, enzovoort.). Een voorbeeld van configuratiegegevens is wat u in Unified Service Desk voor Dynamics 365 definieert om een aangepaste callcentertoepassing te configureren. De Unified Service Desk-entiteiten, samen met de configuratiegegevens die in de entiteiten worden opgeslagen, definiëren een agenttoepassing. Zie voor meer informatie over Unified Service Desk Handleiding voor Unified Service Desk.

Met het configuratiemigratieprogramma kunt u:

• De entiteiten en velden selecteren van waar u de configuratiegegevens wilt exporteren.

• Voorkom dubbele records op het doelsysteem door een uniciteitsvoorwaarde voor elke entiteit te definiëren op basis van een combinatie van velden in de entiteit, die wordt gebruikt om de waarden in het doelsysteem mee te vergelijken. Als er geen overeenkomende waarden zijn, wordt een unieke record gemaakt op het doelsysteem. Als een overeenkomend wordt gevonden, wordt de record bijgewerkt op het doelsysteem.

  Notitie

  Als geen voorwaarde voor duplicaatdetectie (uniciteit) wordt opgegeven voor een entiteit die wordt geëxporteerd, gebruikt het hulpprogramma de primaire veldnaam van de entiteit om deze te vergelijken met de bestaande gegevens op het doelsysteem.

• Schakel invoegtoepassingen uit voordat u gegevens exporteert en schakel ze op het doelsysteem weer in nadat de import is voltooid voor alle entiteiten of geselecteerde entiteiten.

• Valideer het schema voor de geselecteerde te exporteren entiteiten om te zorgen dat alle vereiste gegevens aanwezig zijn.

• Gebruik een bestaand schema opnieuw om gegevens vanuit een bronsysteem te exporteren.

• Datum-/tijdvelden automatisch vooruit verplaatsen bij import van demo-omgevingen.

• Sluit de geëxporteerde modules die vanuit dit hulpprogramma zijn gemaakt (schema en gegevensbestanden) in andere programma's in. U kunt de geëxporteerde gegevens bijvoorbeeld in Package Deployer in combinatie met andere oplossingsbestanden en gegevens gebruiken om pakketten te maken en te implementeren in een omgeving. Meer informatie: Pakketten implementeren met behulp van Package Deployer

Het hulpprogramma voor configuratiemigratie is beschikbaar als een NuGet-pakket of kan worden gedownload via de Power Platform CLI.

Hoe werkt configuratiemigratieprogramma?

Het volgende diagram laat zien hoe het configuratiemigratieprogramma voor de migratie van configuratiegegevens wordt gebruikt.

Het schema van de te exporteren brongegevens definiëren: het schemabestand (.xml) bevat informatie over de gegevens die u wilt exporteren, zoals de entiteiten, kenmerken, relaties, definitie van uniciteit van de gegevens en of invoegtoepassingen moeten worden uitgeschakeld voordat de gegevens worden geëxporteerd. Meer informatie: Een schema maken voor het exporteren van configuratiegegevens

Het schema gebruiken om gegevens te exporteren: gebruik het schemabestand om de gegevens in een zip-bestand te exporteren dat de gegevens en het schema van de geëxporteerde gegevens bevat. Meer informatie: Een schema maken voor het exporteren van configuratiegegevens

De geëxporteerde gegevens importeren: gebruik de geëxporteerde gegevens (.zip-bestand) om in de doelomgeving te importeren. 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. Hierdoor worden gegevens schoon geïmporteerd. Meer informatie: Configuratiegegevens importeren

Problemen met de migratie van configuratiegegevens oplossen met behulp van logboekbestanden

Het hulpprogramma voor configuratiemigratie biedt ondersteuning voor logboekregistratie om gedetailleerde informatie te krijgen over fouten die zich kunnen voordoen tijdens het aanmelden bij de omgeving met het hulpprogramma, tijdens bewerkingen die door het hulpprogramma tijdens de schemadefinitie worden uitgevoerd en tijdens het importeren/exporteren van de configuratiegegevens en om informatie te krijgen over de gegevens die met het hulpprogramma zijn geïmporteerd. Er zijn drie logboekbestanden die door het hulpprogramma worden gegenereerd die vanaf de volgende locatie beschikbaar zijn op de computer waarop u het hulpprogramma uitvoert: c:\Users\<UserName>\AppData\Roaming\Microsoft\Microsoft Dataverse Configuration Migration Tool\<Version>.

• Login_ErrorLog.log: dit logboekbestand biedt informatie over de problemen die optreden als u het hulpmiddel gebruikt om u aan te melden bij de omgeving. Als er tijdens de aanmelding problemen zijn, wordt een bericht weergegeven op het aanmeldingsscherm van het hulpmiddel met een koppeling naar dit logboekbestand. Het bericht stelt dat er een fout is opgetreden tijdens het verwerken van de aanmeldingsaanvraag en dat de gebruiker het foutlogboek kan bekijken. U kunt op de koppeling in het bericht klikken om dit logboekbestand weer te geven. Het logboekbestand wordt gemaakt de eerste keer dat er aanmeldproblemen in het hulpprogramma zijn. Daarna wordt het logboekbestand gebruikt om informatie vast te leggen over volgende aanmeldproblemen als die optreden.

• DataMigrationUtility.log: Geeft gedetailleerde informatie over elke taak die in het hulpprogramma is uitgevoerd tijdens de laatste uitvoering. U kunt het logboekbestand van het hulpprogramma weergeven door te klikken op het menu Logboeken in het hoofdscherm en te klikken op Uitvoeringslogboek.

• ImportDataDetail.log: dit biedt meer informatie over de gegevens die tijdens de vorige importtaak zijn geïmporteerd met het hulpprogramma. Telkens als u met dit hulpprogramma een taak importeert, worden de bestaande gegevens van het logboekbestand verplaatst naar een bestand genaamd ImportDataDetail._old.log in dezelfde map en bevat het bestand ImportDataDetail.log informatie over de laatste importtaak die met het hulpprogramma is uitgevoerd. U kunt dit logboekbestand van het hulpprogramma weergeven door te klikken op het menu Logboeken in het hoofdscherm en te klikken op Laatste importlogboek.

Aanbevolen procedures voor het migreren van uw configuratiegegevens met het hulpprogramma

Hier volgen dingen die u moet overwegen bij het gebruik van dit hulpprogramma om uw configuratiegegevens te migreren:

• Bij het maken van het exportgegevensschema moet u uniciteitsregels definiëren die geschikt zijn voor elke entiteit om eventuele onbedoelde gegevensupdates op het doelsysteem te voorkomen.

• Importeer de geëxporteerde gegevens in een pre-productieomgeving (bij voorkeur een spiegelbeeld van de productieomgeving) om te controleren of de resultaten van het importeren van gegevens zijn zoals u bedoeld had.

• Maak een back-up van de productieomgeving voordat u de gegevens importeert.

Beperkingen

• Het migreren van de Agenda-entiteit wordt niet ondersteund.
• Het migreren van de afbeeldingskolom wordt niet ondersteund.

Zie ook

Hulpprogramma's downloaden van NuGet
Een schema maken voor het exporteren van configuratiegegevens
Een schema van configuratiegegevens wijzigen
Configuratiegegevens importeren
Configuratie van productcatalogi beheren