Przenieś dane konfiguracji między środowiskami oraz organizacjami za pomocą narzędzia do konfiguracji migracji
Narzędzie do konfiguracji migracji umożliwia przenoszenie danych konfiguracji między środowiskami oraz organizacjami. Dane konfiguracyjne służą do definiowania niestandardowych funkcji aplikacji dla zaangażowania klientów (Dynamics 365 Sales, Dynamics 365 Customer Service, Dynamics 365 Field Service, Dynamics 365 Marketing i Dynamics 365 Project Service Automation) oraz są zazwyczaj przechowywane w encjach niestandardowych. Dane konfiguracyjne różnią się od danych użytkownika końcowego (konto, kontakty i tak dalej). Typowym przykładem danych konfiguracyjnych jest to, co się definiuje w programie Unified Service Desk for Dynamics 365 w celu konfigurowania niestandardowej aplikacji agenta biura obsługi. Encje programu Unified Service Desk, wraz z danymi konfiguracyjnymi, które są przechowywane w encjach, definiują aplikację agenta. Aby uzyskać więcej informacji o funkcji Unified Service Desk, zobacz Przewodnik po Unified Service Desk.
Narzędzie Configuration Migration umożliwia:
Wybierać encje i pola, skąd chcesz wyeksportować dane konfiguracyjne.
Unikać duplikatów rekordów w systemie docelowym poprzez określenie warunku unikatowości dla każdej encji na podstawie kombinacji pól w encji, co jest używane do porównania z wartościami w systemie docelowym. Jeśli nie ma żadnych pasujących wartości, unikatowy rekord jest tworzony w systemie docelowym. Jeśli zostanie znaleziony pasujący rekord, rekord zostanie zaktualizowany w systemie docelowym.
Uwaga
Jeśli nie zostanie określony żaden warunek wykrywania duplikatów (unikatowości) dla encji, która jest eksportowany, narzędzie używa podstawowej nazwy pola encji do porównania z danymi istniejącymi w systemie docelowym.
Wyłączenie wtyczek przed eksportowaniem danych, a następnie włączenie ich ponownie w systemie docelowym po zakończeniu importu dla wszystkich encji lub wybranych encji.
Sprawdzanie poprawności schematu dla wybranych encji, które mają zostać wyeksportowane, w celu zapewnienia, że wszystkie wymagane dane/informacje są obecne.
Ponowne użycie istniejącego schematu w celu wyeksportowania danych z systemu źródłowego.
Automatyczne przenoszenie pól Data i godzina podczas importu w środowiskach prezentacji.
Osadzenie wyeksportowanych modułów utworzonych za pomocą tego narzędzia (plików danych i schematu) w innych programach. Na przykład można użyć wyeksportowanych danych w narzędziu Package Deployer wraz plikami i danych innych rozwiązań w celu tworzenia i wdrażania pakietów w środowisku. Więcej informacji: Wdrażanie pakietów przy użyciu programu Package Deployer
Należy pobrać narzędzie do konfiguracji migracji jest dostępne jako pakiet NuGet lub możesz pobrać narzędzie za pomocą interfejsu wiersza polecenia Power Platform.
Jak działa narzędzie Configuration Migration?
Na poniższym diagramie przedstawiono sposób, w jaki narzędzie Configuration Migration jest używane do migrowania danych konfiguracyjnych.
Definiowanie schematu danych źródłowych, które mają zostać wyeksportowane:: Plik schematu (.xml) zawiera informacje o danych, które chcesz wyeksportować, takich jak encje, atrybuty, relacje, definicja unikatowości danych oraz czy wtyczki powinny zostać wyłączone przed wyeksportowaniem danych. Więcej informacji: Tworzenie schematu do eksportowania danych konfiguracji
Użyj schematu do wyeksportowania danych: Użyj schematu do wyeksportowania danych: Użyj pliku schematu, aby wyeksportować dane do pliku .zip zawierającego dane i schemat wyeksportowanych danych. Więcej informacji: Tworzenie schematu do eksportowania danych konfiguracji
Importowanie eksportowanych danych: Użyj wyeksportowanych danych (pliku .zip) do zaimportowania do docelowego środowiska. Import danych odbywa się wieloetapowo. Najpierw importowane są dane podstawowe, w tym samym czasie kolejkowane są dane zależne, następnie importowane są dane zależne i obsługiwane wszelkie zależności i powiązania z danymi. W ten sposób import danych jest czysty. Więcej informacji: Importowanie danych konfiguracji
Rozwiązywanie problemów z migracją danych konfiguracyjnych przy użyciu plików dziennika
Narzędzie do konfiguracji migracji zapewnia obsługę rejestrowania umożliwiającą uzyskanie szczegółowych informacji o błędach, które mogą wystąpić podczas logowania się w środowisku za pomocą tego narzędzia, czynnościach wykonywanych przez narzędzie podczas definiowania schematu i eksportu/importu danych konfiguracyjnych oraz o danych zaimportowanych za pomocą narzędzia. Narzędzie generuje trzy pliki dziennika, które są dostępne w następującej lokalizacji na komputerze, na którym uruchamiane jest narzędzie: c:\Użytkownicy\<UserName>\AppData\Roaming\ Microsoft\Microsoft Dataverse Configuration Migration Tool\<Wersja>.
Login_ErrorLog.log: Zawiera informacje dotyczące problemów, które wystąpiły podczas używania narzędzia do logowania do środowiska. W razie jakichkolwiek problemów podczas logowania, na ekranie logowania do narzędzia pojawi się wiadomość z łączem do tego pliku dziennika. Wiadomość ta poinformuje o wystąpieniu błędu przetwarzania żądania logowania i użytkownik będzie mógł zobaczyć dziennik błędów. Kliknięcie łącza w wiadomości umożliwi wyświetlenie tego pliku dziennika. Plik dziennika jest tworzony podczas pierwszego wystąpienia jakichkolwiek problemów podczas logowania w narzędziu. Po tej dacie plik dziennika jest używany do rejestrowania informacji o problemach podczas logowania, zawsze wtedy, gdy takie problemy wystąpią.
DataMigrationUtility.log: Zawiera szczegółowe informacje dotyczące każdego zadania wykonywanego w narzędziu podczas ostatniego uruchomienia. Plik dziennika z narzędzia można przeglądać, klikając menu Dzienniki na ekranie głównym i klikając polecenie Dziennik uruchomienia.
ImportDataDetail.log: Zawiera szczegółowe informacje dotyczące danych importowanych w ostatnim zadaniu importu za pomocą narzędzia. Każdorazowo podczas wykonywania zadania importu za pomocą tego narzędzia istniejące dane z pliku dziennika są przenoszone do pliku o nazwie ImportDataDetail._old.log w tym samym katalogu, a plik ImportDataDetail.log wyświetla informacje o najnowszym uruchomieniu zadania przeprowadzonym za pomocą tego narzędzia. Plik dziennika z narzędzia można przeglądać, klikając menu Dzienniki na ekranie głównym, a następnie klikając polecenie Dziennik ostatniego importu.
Najważniejsze wskazówki dotyczące migrowania danych konfiguracyjnych za pomocą narzędzia
Poniżej przedstawiono aspekty, które należy rozważyć podczas korzystania z tego narzędzia do migracji danych konfiguracyjnych:
Podczas tworzenia schematu eksportu danych należy zdefiniować reguły unikatowości odpowiednio dla każde encji, aby uniknąć jakichkolwiek niezamierzonych aktualizacji danych w systemie docelowym.
Importuj wyeksportowane dane do środowiska przedprodukcyjnego (najlepiej do obrazu lustrzanego środowiska produkcyjnego) w celu zapewnienia, że wyniki importu danych są takie, jak zaplanowano.
Przed importowaniem danych utwórz kopię zapasową środowiska produkcyjnego.
Ograniczenia
- Migracja encji Kalendarz nie jest obsługiwana.
- Migracja kolumny Obraz nie jest obsługiwana.
Zobacz też
Pobieranie narzędzi z NuGet
Tworzenie schematu do eksportowania danych konfiguracji
Modyfikowanie schematu danych konfiguracji
Importowanie danych konfiguracji
Zarządzanie konfiguracją katalogu produktów