구성 마이그레이션 도구를 사용하여 환경 및 조직 간에 구성 데이터 이동
구성 마이그레이션 도구를 사용하여 환경 및 조직 간에 구성 데이터를 이동할 수 있습니다. 구성 데이터는 고객 참여 앱(Dynamics 365 Sales, Dynamics 365 Customer Service, Dynamics 365 Field Service, Dynamics 365 Marketing 및 Dynamics 365 Project Service Automation)에서 사용자 지정 기능을 정의하는 데 사용되며 일반적으로 사용자 지정 엔터티에 저장됩니다. 구성 데이터는 최종 사용자 데이터(거래처, 연락처 등)와 다릅니다. 구성 데이터의 일반적인 예는 Dynamics 365용 Unified Service Desk에서 사용자 지정된 콜 센터 상담원 애플리케이션을 구성하기 위해 정의하는 것입니다. Unified Service Desk 엔터티는 엔터티에 저장된 구성 데이터와 함께 에이전트 애플리케이션을 정의합니다. Unified Service Desk에 대한 더 자세한 내용은 Unified Service Desk 가이드를 참조하십시오.
Configuration Migration 도구를 사용하여 다음이 가능합니다.
구성 데이터를 내려내려는 엔터티 및 필드를 선택할 수 있습니다.
대상 시스템의 값을 비교하는 데 사용되는 엔터티의 필드 조합에 따라 각 엔터티에 대해 고유한 조건을 정의하여 대상 시스템에서 중복 레코드를 방지합니다. 일치하는 값이 없을 경우 고유한 레코드가 대상 시스템에 만들어집니다. 일치하는 레코드가 있으면 대상 시스템에서 레코드가 업데이트됩니다.
노트
내보낼 엔터티에 지정된 중복 검색(고유성) 조건을 지정하지 않으면 도구는 엔터티의 기본 필드 이름을 사용하여 대상 시스템에서 기존 데이터를 비교합니다.
데이터를 내보내기 전에 플러그 인을 비활성화한 후 모든 엔터티 또는 선택한 엔터티에 대해 가져오기가 완료된 후 대상 시스템에서 다시 활성화합니다.
내보낼 선택한 엔터티에 대한 스키마의 유효성을 검사하여 모든 필수 데이터/정보가 있는지 확인합니다.
기존 스키마를 다시 사용하여 원본 시스템에서 데이터를 내보냅니다.
데모 환경에서 가져올 때 DateTime 필드를 자동으로 앞으로 이동합니다.
다른 프로그램에서 이 도구(스키마 및 데이터 파일)로 만든 내보낸 모듈을 포함합니다. 예를 들어 Package Deployer에서 내보낸 데이터를 다른 솔루션 파일 및 데이터와 함께 사용하여 환경에서 패키지를 만들고 배포할 수 있습니다. 추가 정보: Package Deployer를 사용하여 패키지 배포
구성 마이그레이션 도구는 NuGet 패키지로 제공되거나 Power Platform CLI를 사용하여 도구를 다운로드할 수 있습니다.
Configuration Migration 도구는 어떻게 작동합니까?
다음 다이어그램은 Configuration Migration 도구가 구성 데이터를 마이그레이션하는 데 사용되는 방법을 보여 줍니다.
내보낼 원본 데이터의 스키마 정의: 스키마 파일(.xml)에는 엔터티, 특성, 관계, 데이터의 고유성 정의, 데이터를 내보내기 전에 플러그 인을 비활성화할지 여부와 같은 내보낼 데이터에 대한 정보가 들어 있습니다. 추가 정보: 구성 데이터를 내보내기 위한 스키마 생성
스키마를 사용하여 데이터 내보내기: 스키마 파일을 사용하여 데이터를 내보낸 데이터의 스키마 및 데이터가 들어 있는 .zip 파일로 내보냅니다. 추가 정보: 구성 데이터를 내보내기 위한 스키마 생성
내보낸 데이터 가져오기: 내보낸 데이터(.zip 파일)을 사용하여 대상 환경으로 가져옵니다. 데이터 가져오기는 여러 단계로 수행되는데, 종속 데이터가 대기하고 있는 동안 먼저 기초 데이터를 가져온 후 이후 단계에서 종속 데이터를 가져와 데이터 종속성 또는 연결을 처리합니다. 그러면 깔끔하게 데이터를 가져올 수 있습니다. 추가 정보: 구성 데이터 가져오기
로그 파일을 사용하여 구성 데이터 마이그레이션 문제 해결
구성 마이그레이션 도구는 기록을 지원하므로 도구를 사용하여 환경에 로그인하는 동안 발생할 수 있는 오류, 스키마 정의 및 구성 데이터 내보내기/가져오기 중 도구로 수행한 활동, 도구를 사용하여 가져온 데이터에 대한 정보 등에 대한 자세한 정보를 가져옵니다. 도구를 실행하는 컴퓨터의 c:\Users\<UserName>\AppData\Roaming\Microsoft\Microsoft Dataverse Configuration Migration Tool\<Version> 위치에서 사용할 수 있는 로그 파일 세 가지를 생성합니다.
Login_ErrorLog.log: 환경에 로그인하기 위해 도구를 사용할 때 발생한 문제에 대한 정보를 제공합니다. 로그인하는 동안 문제가 있는 경우 메시지가 이 로그 파일에 대한 링크와 함께 도구의 로그인 화면에 나타납니다. 로그인 요청을 처리하는 동안 오류가 발생했고 사용자는 오류 로그를 볼 수 있다는 메시지가 나타납니다. 메시지의 링크를 클릭하여 이 로그 파일을 볼 수 있습니다. 도구에서 로그인 문제가 발생할 경우 로그 파일이 처음 만들어집니다. 그 후로 로그 파일은 문제가 발생할 때마다 로그인 문제에 대한 정보를 기록하는 데 사용됩니다.
DataMigrationUtility.log: 마지막으로 실행하는 동안 도구에서 수행된 각 작업에 대한 자세한 정보를 제공합니다. 기본 화면에서 로그 메뉴를 클릭하고 실행 로그를 클릭하여 도구에서 로그 파일을 볼 수 있습니다.
ImportDataDetail.log: 도구를 사용한 마지막 가져오기 작업에서 가져온 데이터에 대한 자세한 정보를 제공합니다. 이 도구를 사용하여 가져오기 작업을 실행할 때마다 로그 파일의 기존 정보는 동일한 디렉터리의 ImportDataDetail._old.log 파일로 이동하고 ImportDataDetail.log 파일은 도구를 사용하여 수행한 마지막 가져오기 작업에 대한 정보를 표시합니다. 기본 화면에서 로그 메뉴를 클릭하고 마지막 가져오기 로그를 클릭하여 도구에서 이 로그 파일을 볼 수 있습니다.
도구를 사용하여 구성 데이터를 마이그레이션하는 데 유용한 정보
다음은 이 도구를 사용하여 구성 데이터를 마이그레이션할 때 고려해야 할 사항입니다.
내보내기 데이터 스키마를 만드는 동안 각 엔터티에 대개 고유성 규칙을 정의하여 대상 시스템에서 실수로 데이터를 업데이트하지 않도록 방지해야 합니다.
데이터 가져오기 결과가 예상과 같도록 내보낸 데이터를 사전 프로덕션 환경(프로덕션 환경의 미러 이미지)으로 가져옵니다.
데이터를 가져오기 전에 프로덕션 환경을 백업합니다.
제한 사항
- 일정 엔터티 마이그레이션은 지원되지 않습니다.
- 이미지 열 마이그레이션은 지원되지 않습니다.
참조 항목
NuGet에서 도구 다운로드
스키마를 만들어 구성 데이터 내보내기
구성 데이터 스키마 수정
구성 데이터 가져오기
제품 카탈로그 구성 관리