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.
Zdefiniuj schemat danych źródłowych do wyeksportowania: Plik schematu (.xml) zawiera informacje o danych, które chcesz wyeksportować, takie jak jednostki, atrybuty relacje, definicja unikatowości danych oraz to, czy wtyczki powinny być wyłączone przed wyeksportowaniem danych. Więcej informacji: Tworzenie schematu do eksportowania danych konfiguracji
Użyj schematu do eksportowania danych: Użyj pliku schematu, aby wyeksportować dane do pliku .zip, który zawiera dane i schemat wyeksportowanych danych. Więcej informacji: Tworzenie schematu do eksportowania danych konfiguracji
Zaimportuj wyeksportowane dane: Użyj wyeksportowanych danych (pliku .zip), aby zaimportować je do środowiska docelowego. 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. Istnieją trzy pliki dziennika wygenerowane przez narzędzie, które są dostępne w następującej lokalizacji na komputerze, na którym jest uruchamiane narzędzie: c:\Users\<UserName>\AppData\Roaming\Microsoft\Microsoft Dataverse Configuration Migration Tool\Version.<>
Login_ErrorLog.log: Zawiera informacje o problemach, które wystąpiły podczas logowania się do środowiska za pomocą narzędzia. 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 o każdym zadaniu wykonanym 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 o danych zaimportowanych w ostatnim zadaniu importu przy użyciu 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ż
Pobierz narzędzia z NuGet
Tworzenie schematu w celu wyeksportowania danych konfiguracji
Modyfikowanie schematu danych konfiguracji
Importowanie danych konfiguracyjnych
Zarządzanie konfiguracją katalogu produktów