Di chuyển dữ liệu cấu hình giữa các môi trường và tổ chức với Configuration Migration Tool

Công cụ Di chuyển cấu hình cho phép bạn di chuyển dữ liệu cấu hình trên các môi trường và tổ chức. Dữ liệu cấu hình được sử dụng để xác định chức năng tùy chỉnh trong các ứng dụng Customer Engagement (Dynamics 365 Sales, Dynamics 365 Customer Service, Dynamics 365 Field Service, Dynamics 365 Marketing và Dynamics 365 Project Service Automation) và thường được lưu trữ trong các thực thể tùy chỉnh. Dữ liệu cấu hình là khác nhau từ dữ liệu người dùng cuối (tài khoản, liên hệ và v.v.). Một ví dụ điển hình của cấu hình dữ liệu là những gì bạn xác định trong Unified Service Desk for Dynamics 365 để cấu hình ứng dụng tác nhân trung tâm cuộc gọi được tùy chỉnh. Các thực thể Unified Service Desk, cùng với các dữ liệu cấu hình được lưu trữ trong các thực thể, xác định một ứng dụng tác nhân. Để biết thêm thông tin về Unified Service Desk, hãy xem Hướng dẫn Unified Service Desk.

Công cụ Configuration Migration cho phép bạn:

  • Chọn thực thể và trường từ nơi mà bạn muốn xuất dữ liệu cấu hình.

  • Tránh hồ sơ trùng lặp trên hệ thống đích bằng cách xác định một điều kiện độc đáo cho mỗi thực thể dựa trên sự kết hợp của các trường trong thực thể, mà được sử dụng để so sánh với các giá trị trên hệ thống đích. Nếu không có giá trị phù hợp, một hồ sơ duy nhất được tạo ra trên hệ thống đích. Nếu tìm thấy hồ sơ phù hợp, hồ sơ được cập nhật trên hệ thống đích.

    Lưu ý

    Nếu không có điều kiện phát hiện trùng lặp (tính độc đáo) được chỉ định cho một thực thể đang được xuất, công cụ sử dụng tên trường chính của thực thể để so sánh với các dữ liệu hiện có trên hệ thống đích.

  • Vô hiệu hóa trình bổ sung trước khi xuất dữ liệu và sau đó kích hoạt lại chúng trên hệ thống đích sau khi hoàn tất nhập cho tất cả thực thể hoặc cho các thực thể đã chọn.

  • Xác nhận giản đồ dành cho các thực thể được chọn để được xuất đảm bảo rằng tất cả thông tin/dữ liệu yêu cầu đã có.

  • Tái sử dụng một lược đồ hiện có để xuất dữ liệu từ một hệ thống nguồn.

  • Tự động di chuyển các trường DateTime lên trước khi nhập vào các môi trường demo.

  • Nhúng mô đun đã xuất từ công cụ này (tệp lược đồ và dữ liệu) trong các chương trình khác. Ví dụ: bạn có thể sử dụng dữ liệu đã xuất trong Package Deployer cùng với các dữ liệu và tệp giải pháp khác để tạo và triển khai các gói trên một môi trường. Thông tin thêm: Triển khai các gói bằng cách sử dụng Package Deployer

Công cụ Di chuyển cấu hình có sẵn dưới dạng NuGet gói hoặc bạn có thể tải xuống công cụ bằng Power Platform CLI.

Cách công cụ Configuration Migration hoạt động?

Sơ đồ sau minh hoạ cách công cụ Configuration Migration được sử dụng để di chuyển dữ liệu cấu hình.

Sơ đồ quy trình di chuyển cấu hình.

Biểu tượng Bước 1Xác định lược đồ của dữ liệu nguồn sẽ được xuất: Tệp lược đồ (.xml) chứa thông tin về dữ liệu mà bạn muốn xuất như các thực thể, thuộc tính, mối quan hệ, định nghĩa về tính duy nhất của dữ liệu và liệu các plug-in có nên bị vô hiệu hóa trước khi xuất dữ liệu hay không. Thông tin thêm: Tạo một sơ đồ để xuất dữ liệu cấu hình

Biểu tượng Bước 2Sử dụng lược đồ để xuất dữ liệu: Sử dụng tệp lược đồ để xuất dữ liệu vào tệp .zip chứa dữ liệu và lược đồ của dữ liệu đã xuất. Thông tin thêm: Tạo một sơ đồ để xuất dữ liệu cấu hình

Biểu tượng Bước 3Nhập dữ liệu đã xuất: Sử dụng dữ liệu đã xuất (tệp .zip) để nhập vào môi trường đích. Nhập dữ liệu được thực hiện trong nhiều lần chuyển cho lần nhập dữ liệu nền tảng đầu tiên trong khi xếp hàng đợi dữ liệu phụ thuộc, và sau đó nhập dữ liệu phụ thuộc trong lần chuyển tiếp theo để xử lý bất kỳ quan hệ phụ thuộc dữ liệu hoặc mối liên kết. Điều này đảm bảo nhập dữ liệu thông suốt. Thông tin thêm: Nhập dữ liệu cấu hình

Gỡ rối các vấn đề di chuyển dữ liệu cấu hình bằng cách sử dụng tệp nhật ký

Công cụ Di chuyển cấu hình cung cấp hỗ trợ nhật ký để thu được thông tin chi tiết về lỗi có thể xảy ra trong khi đăng nhập vào môi trường bằng cách sử dụng công cụ này, hoạt động được thực hiện bởi công cụ trong định nghĩa giản đồ và xuất/nhập dữ liệu cấu hình, và thông tin về các dữ liệu được nhập bằng công cụ. Có ba tệp nhật ký được công cụ tạo ra và có sẵn tại vị trí sau trên máy tính nơi bạn chạy công cụ: c:\Users\<UserName>\AppData\Roaming\Microsoft\Microsoft Dataverse Configuration Migration Tool\<Version>.

  • Login_ErrorLog.log: Cung cấp thông tin về các sự cố xảy ra khi bạn sử dụng công cụ để đăng nhập vào môi trường. Nếu có bất kỳ vấn đề trong quá trình đăng nhập, một thông báo xuất hiện trên màn hình đăng nhập của công cụ với một liên kết đến tệp nhật ký này. Thông báo cho biết rằng một lỗi đã xảy ra trong khi thực hiện yêu cầu đăng nhập và người dùng có thể xem nhật ký lỗi. Bạn có thể bấm vào liên kết trong thông báo để xem tệp nhật ký này. Tệp nhật ký được tạo ra lần đầu tiên gặp bất kỳ sự cố đăng nhập nào vào công cụ. Sau đó, tệp nhật ký được sử dụng để ghi các thông tin về sự cố đăng nhập bất cứ khi nào nó xảy ra.

  • DataMigrationUtility.log: Cung cấp thông tin chi tiết về từng tác vụ được thực hiện trong công cụ trong lần chạy cuối cùng. Bạn có thể xem các tệp nhật ký từ công cụ bằng cách bấm vào menu Nhật ký trên màn hình chính, bấm vào chạy nhật ký.

  • ImportDataDetail.log: Cung cấp thông tin chi tiết về dữ liệu được nhập trong công việc nhập cuối cùng bằng cách sử dụng công cụ. Mỗi khi bạn chạy một công việc nhập bằng cách sử dụng công cụ này, các chi tiết sẵn có từ các tệp nhật ký được chuyển đến một tệp gọi là ImportDataDetail._old.log trong cùng một thư mục, và tệp ImportDataDetail.log hiển thị các thông tin về việc nhập chạy gần đây nhất bằng cách sử dụng công cụ. Bạn có thể xem các tệp nhật ký này từ công cụ bằng cách bấm vào menu Nhật ký trên màn hình chính, rồi bấm vào Nhật ký nhập lần trước.

Các thực hành tốt nhất để di chuyển dữ liệu cấu hình bằng cách sử dụng công cụ

Sau đây là những điều bạn cần cân nhắc khi sử dụng công cụ này để di chuyển dữ liệu cấu hình của bạn:

  • Trong khi tạo giản đồ dữ liệu xuất, bạn phải xác định quy tắc tính độc đáo một cách thích hợp cho mỗi thực thể để tránh bất kỳ cập nhật dữ liệu vô tình trên hệ thống đích.

  • Nhập dữ liệu đã xuất trong một môi trường tiền sản xuất (thường là hình ảnh phản chiếu của môi trường sản xuất) để đảm bảo rằng kết quả nhập dữ liệu như bạn dự định.

  • Sao lưu của bạn môi trường sản xuất trước khi nhập dữ liệu.

Giới hạn

  • Di chuyển thực thể Lịch không được hỗ trợ.
  • Không hỗ trợ di chuyển cột Hình ảnh.

Xem thêm

Tải xuống công cụ từ NuGet
Tạo một lược đồ để xuất dữ liệu cấu hình
Sửa đổi lược đồ dữ liệu cấu hình
Nhập dữ liệu cấu hình
Quản lý cấu hình danh mục sản phẩm