Di chuyển các trang web mô hình dữ liệu tiêu chuẩn sang mô hình dữ liệu nâng cao (bản xem trước)
[Chủ đề này là tài liệu phát hành trước và có thể thay đổi.]
Trong bài viết này, hãy tìm hiểu cách di chuyển trang web mô hình dữ liệu tiêu chuẩn hiện có của bạn sang mô hình dữ liệu nâng cao.
Quan trọng
- Đây là một tính năng ở phiên bản xem trước.
- Các tính năng xem trước không được dùng cho sản xuất và có thể có chức năng bị hạn chế. Những tính năng này khả dụng trước khi có bản phát hành chính thức để khách hàng có thể truy cập sớm và cung cấp phản hồi.
Điều kiện tiên quyết
- Bạn phải cài đặt Microsoft Power Platform CLI với phiên bản 1.31.6 trở lên để di chuyển trang web của mình sang mô hình dữ liệu nâng cao. Thông tin thêm: Cài đặt Power Platform CLI mới nhất
- Dataverse gói cổng thông tin cơ sở 9.3.2307.x hoặc cao hơn.
- Power Pages Gói lõi 1.0.2309.63 trở lên. Thông tin thêm: Cập nhật giải pháp Power Pages
- Bạn cần hiểu cách sử dụng Power Platform CLI trong Power Pages để hoàn tất các bước di chuyển. Nếu bạn chưa quen với Power Platform CLI trong Power Pages, bạn có thể muốn xem lại Power Platform hướng dẫn CLI này và tham khảo Các lệnh PAC CLI để làm việc với Power Pages.
Bước 1. Tải xuống và kiểm tra tùy chỉnh cho siêu dữ liệu trang web tiêu chuẩn hiện có
Mở một dấu nhắc lệnh.
Sử dụng lệnh sau để xác thực với Dataverse tổ chức trong môi trường Power Platform của bạn để tải bản ghi trang web xuống để di chuyển.
pac auth create -u [Dataverse URL]Ví dụ:
pac auth create -u https://contoso-org.crm.dynamics.comThông tin thêm: pac auth tạo
Sử dụng lệnh sau để tạo danh sách các trang web trong tổ chức hiện tại.
pac powerpages listThông tin thêm: danh sách các trang điện pac
Sử dụng lệnh sau để tải xuống báo cáo tùy chỉnh.
pac powerpages migrate-datamodel --webSiteId [WebSiteId-GUID] --siteCustomizationReportPath [PATH]Ví dụ:
pac powerpages migrate-datamodel --webSiteId 076bf556-9ae6-ee11-a203-6045bdf0328e --siteCustomizationReportPath "c:\\pac-powerpages\\downloads"
Nếu bạn tìm thấy bất kỳ tùy chỉnh nào trong báo cáo đã tải xuống, hãy làm theo hướng dẫn trong báo cáo để khắc phục vấn đề đó sau khi di chuyển sang mô hình dữ liệu nâng cao. Thông tin thêm: Những điều cần cân nhắc khi tùy chỉnh trang web khi di chuyển trang web từ mô hình dữ liệu tiêu chuẩn sang mô hình dữ liệu nâng cao
Bước 2. Di chuyển dữ liệu trang web từ mô hình dữ liệu tiêu chuẩn sang mô hình dữ liệu nâng cao
Sử dụng lệnh sau để di chuyển dữ liệu trang web của bạn sang mô hình dữ liệu nâng cao.
pac powerpages migrate-datamodel --webSiteId [WebSiteId-GUID] –-mode [type-of-data]
Chế độ có thể có 3 giá trị:
configureData: di chuyển siêu dữ liệu cho trang web. Thông tin thêm: Danh sách các bảng lưu trữ dữ liệu cấu hình
configureDataReferences: di chuyển dữ liệu giao dịch cho trang web. Thông tin thêm: Danh sách các bảng lưu trữ dữ liệu không cấu hình
all: di chuyển cả hai loại dữ liệu.
Ví dụ:
pac powerpages migrate-datamodel --webSiteId 076bf556-9ae6-ee11-a203-6045bdf0328e –-mode all
Công cụ di chuyển xác minh các giải pháp. Nếu có giải pháp mô hình dữ liệu tiêu chuẩn mà không có giải pháp mô hình dữ liệu nâng cao tương ứng cho mẫu được đề cập thì cảnh báo sẽ hiển thị: Found template <template-name>. One of the prerequisite for migrate needs Enchanged data model template
Có các mẫu cụ thể, chẳng hạn như Đăng ký chương trình, Lên lịch và Quản lý cuộc họp, yêu cầu các gói mô hình dữ liệu nâng cao phù hợp để đảm bảo trang web được di chuyển hoạt động bình thường. Để có được các gói mô hình dữ liệu nâng cao này, bạn phải tạo một trang web mới cho mẫu tương ứng (phải bật môi trường cho mô hình dữ liệu nâng cao) để cung cấp các giải pháp tương thích với mô hình dữ liệu nâng cao cho việc di chuyển.
Các mẫu được hỗ trợ để di chuyển
Các trang web có mẫu sau được hỗ trợ di chuyển:
- Bố cục bắt đầu 1-5
- Đang xử lý ứng dụng
- Trang trống
- Đăng ký chương trình
- Lên lịch và quản lý cuộc họp
Bước 3. Xác minh trạng thái di chuyển
Sử dụng lệnh sau để xác minh trạng thái di chuyển trang web của bạn:
pac powerpages migrate-datamodel --webSiteId [WebSiteId-GUID] --checkMigrationStatus
Ví dụ:
pac powerpages migrate-datamodel --webSiteId 076bf556-9ae6-ee11-a203-6045bdf0328e --checkMigrationStatus
Lưu ý
Nếu quá trình di chuyển trang web của bạn mất nhiều thời gian hơn dự kiến thì có thể là do khối lượng dữ liệu. Nếu dấu nhắc lệnh của bạn đóng, hãy mở dấu nhắc lệnh mới và sử dụng lệnh trong bước này để xác minh trạng thái trang web của bạn.
Bước 4. Cập nhật phiên bản mô hình dữ liệu trang web sau khi di chuyển dữ liệu thành công
Sử dụng phiên bản mô hình dữ liệu trang web cập nhật lệnh sau:
pac powerpages migrate-datamodel --webSiteId [WebSiteId-GUID] --updateDatamodelVersion --portalId [Portal-GUID]
Lưu ý
- Bạn có thể tìm id Cổng thông tin bằng cách điều hướng đến trang web có '/_services/about' được thêm vào URL của trang web. Để xem các tùy chọn này, người dùng phải có vai trò web với tất cả quyền truy cập trang web được chỉ định.
- Sau khi cập nhật phiên bản mô hình dữ liệu trang web, bản ghi trang web được liên kết với mô hình dữ liệu tiêu chuẩn sẽ bị vô hiệu hóa. Thay vào đó, trang web hiện sẽ tham chiếu đến bản ghi trang web được liên kết với mô hình dữ liệu nâng cao.
- Người dùng phải có bất kỳ vai trò nào sau đây để thực thi lệnh di chuyển với các đối số
updateDatamodelVersionhoặcrevertToStandardDataModel. Vì điều này sẽ thực hiện hành động của quản trị viên để chuyển trang web của bạn sang mô hình dữ liệu nâng cao hoặc ngược lại.
Ví dụ:
pac powerpages migrate-datamodel --webSiteId 076bf556-9ae6-ee11-a203-6045bdf0328e --updateDatamodelVersion --portalId 04435d71-c45a-4a05-9702-8f127559e48e
Hoàn nguyên đã di chuyển trang web từ mô hình dữ liệu nâng cao sang mô hình dữ liệu tiêu chuẩn
Sử dụng lệnh sau để hoàn nguyên một trang web mô hình dữ liệu tiêu chuẩn thành mô hình dữ liệu nâng cao sau khi di chuyển:
pac powerpages migrate-datamodel --webSiteId [WebSiteId-GUID] --revertToStandardDataModel --portalId [Portal-GUID]
Lưu ý
Khi bạn chuyển một trang web đã di chuyển từ mô hình dữ liệu nâng cao trở lại mô hình dữ liệu tiêu chuẩn, bản ghi trang web được liên kết với mô hình dữ liệu nâng cao sẽ bị vô hiệu hóa và bản ghi trang web cho mô hình dữ liệu tiêu chuẩn sẽ được kích hoạt lại.
Ví dụ:
pac powerpages migrate-datamodel --webSiteId 076bf556-9ae6-ee11-a203-6045bdf0328e --revertToStandardDataModel --portalId 07f35d71-c45a-4a05-9702-8f127559e48e
Di chuyển một địa điểm sản xuất từ mô hình dữ liệu tiêu chuẩn sang mô hình dữ liệu nâng cao
Trước khi di chuyển một địa điểm sản xuất, chúng tôi khuyên bạn nên tạo bản sao đầy đủ của địa điểm sản xuất. Chúng tôi cũng khuyến nghị việc di chuyển địa điểm sản xuất nên được tiến hành ngoài giờ làm việc.
Hãy sử dụng các bước sau để di chuyển cơ sở sản xuất của bạn sang mô hình dữ liệu nâng cao:
- Hãy thử di chuyển trang web trong môi trường được sao chép bằng lệnh PAC CLI
migrate-datamodel. - Thêm dữ liệu cấu hình trang web vào giải pháp được quản lý và nhập nó vào môi trường sản xuất.
- Sử dụng các lệnh PAC CLI để di chuyển dữ liệu không cấu hình và hoàn thiện nó bằng cách cập nhật phiên bản mô hình dữ liệu cho sản xuất.
Lưu ý
Để di chuyển, id trang web nguồn và sản xuất giống nhau.
Những điều cần cân nhắc khi tùy chỉnh trang web khi di chuyển trang web từ mô hình dữ liệu tiêu chuẩn sang mô hình dữ liệu nâng cao
Phần này cung cấp hướng dẫn sửa lỗi tùy chỉnh để di chuyển trang web từ mô hình dữ liệu tiêu chuẩn sang mô hình dữ liệu nâng cao.
Có năm loại tùy chỉnh trang web trên bảng siêu dữ liệu adx:
- Cột tùy chỉnh trên bảng siêu dữ liệu adx
- Mối quan hệ giữa bảng tùy chỉnh và bảng adx
- Tham chiếu bảng Adx ở dạng lỏng đoạn mã
- Tham chiếu bảng Adx trong tìm nạp xml
- Quy trình làm việc và plugin tùy chỉnh trên bảng adx
Lưu ý
Tất cả các bản sửa lỗi liên quan đến tùy chỉnh sẽ được thực hiện sau khi di chuyển sang mô hình dữ liệu nâng cao.
Cột tùy chỉnh trên bảng siêu dữ liệu adx
Để khắc phục tùy chỉnh này trong mô hình dữ liệu nâng cao, hãy tạo mối quan hệ giữa bảng hệ thống và bảng tùy chỉnh mới, đồng thời di chuyển dữ liệu sang bảng mới.
Mô hình dữ liệu tiêu chuẩn: Bảng adx_webpage chứa một cột tùy chỉnh là contoso_pagetype.
Mô hình dữ liệu nâng cao: Tạo bảng mới có tên contoso_webpage. Điều này sẽ bao gồm một cột có tên contoso_pagetype và một cột tra cứu contoso_webpage_id được liên kết với powerpagescomponent. Sử dụng Không gian làm việc dữ liệu để tạo bảng.
Mối quan hệ giữa bảng tùy chỉnh và bảng adx
Để khắc phục tùy chỉnh này trong mô hình dữ liệu nâng cao, hãy tạo mối quan hệ giữa bảng tùy chỉnh và bảng hệ thống.
Mô hình dữ liệu chuẩn: Bảng adx_webpage có mối quan hệ có tên adx_webpage_contoso_pagelogs với bảng contoso_pagelogs .
Mô hình dữ liệu nâng cao: Tạo mối quan hệ mới có tên powerpagecomponent_contoso_pagelogs với bảng contoso_webpage . Sử dụng Không gian làm việc dữ liệu để tạo bảng.
Tham chiếu bảng Adx ở dạng lỏng đoạn mã
Để khắc phục tùy chỉnh này trong mô hình dữ liệu nâng cao, hãy thay thế các tham chiếu bảng adx trong mã lỏng bằng các tham chiếu mspp của mô hình dữ liệu nâng cao. Ngoài ra, bạn có thể sử dụng bảng Thành phần trang web (tên logic powerpagecomponent) cùng với Loại thành phần Thuộc tính(logic name powerpagecomponenttype) để truy xuất các tham chiếu tương ứng.
Mô hình dữ liệu tiêu chuẩn:entities thẻ linh hoạt được sử dụng để truy cập liên kết web các giá trị trong mã {% assign app_weblinks= entities['adx_weblinks'] %} .
Mô hình dữ liệu nâng cao: Thay vì sử dụng liên kết web thông qua entities thẻ lỏng, hãy sử dụng đối tượng lỏng tương ứng.
entities[adx_weblinks] trực tiếp. Trong trường hợp này entities['adx_weblinks'] có thể được thay thế bằng weblinks vật thể lỏng.
Tham chiếu bảng Adx trong tìm nạp xml
Để khắc phục tùy chỉnh này trong mô hình dữ liệu nâng cao, hãy thay thế các tham chiếu bảng adx trong xml tìm nạp bằng các tham chiếu trực tiếp bảng ảo mô hình dữ liệu nâng cao. Ngoài ra, bạn có thể sử dụng bảng Thành phần trang web (tên logic powerpagecomponent) cùng với Loại thành phần Thuộc tính(logic name powerpagecomponenttype) để truy xuất các tham chiếu tương ứng.
Mô hình dữ liệu chuẩn: Tên bảng adx_webrole được sử dụng trong truy vấn tìm nạp xml.
{% fetchxml app_webroles %}
<fetch>
<entity name='adx_webrole'>
<attribute name='adx_name'/>
<entity>
</fetch>
{% endfetchxml %}
Mô hình dữ liệu nâng cao: Sử dụng Thành phần trang web (tên logic powerpagecomponent) kết hợp với Thuộc tính Loại thành phần (tên logic powerpagecomponenttype) để truy xuất các tham chiếu tương ứng.
{% fetchxml app_webroles %}
<fetch>
<entity name='powerpagecomponent'>
<attribute name='adx_name'/>
<filter type='and'>
<condition attribute ='powerpagecomponenttype' operator ='eq' value ='11'/>
<entity>
</fetch>
{% endfetchxml %}
Loại và giá trị thành phần trang web
| Loại thành phần | Giá_trị |
|---|---|
| Trạng thái Phát hành | 1 |
| Trang web | 2 |
| Tệp Web | 3 |
| Bộ Liên kết Web | Tệp 4 |
| Liên kết Web | 5 |
| Mẫu Trang | 6 |
| Đoạn mã nội dung | 7 |
| Mẫu Web | 8 |
| Thiết đặt Trang | 9 |
| Quy tắc kiểm soát quyền truy cập vào trang web | 10 |
| Vai trò web | 11 |
| Truy cập website | 12 |
| Đánh dấu Trang | 13 |
| Biểu mẫu cơ bản | 15 |
| Siêu dữ liệu biểu mẫu cơ bản | 16 |
| Danh sách | 17 |
| Quyền đối với bảng | 18 |
| Biểu mẫu nâng cao | 19 |
| Bước biểu mẫu nâng cao | 20 |
| Siêu dữ liệu biểu mẫu nâng cao | 21 |
| Vị trí cuộc thăm dò | 24 |
| Vị trí quảng cáo | 26 |
| Người tiêu dùng bot | 27 |
| Hồ sơ quyền đối với cột | 28 |
| Quyền của cột | 29 |
| Chuyển hướng | 30 |
| Quy tắc chuyển tiếp trạng thái phát hành | 31 |
| Lối tắt | 32 |
| Dòng đám mây | 33 |
| Thành phần UX | 34 |
Quy trình làm việc và plugin tùy chỉnh trên bảng adx
Để khắc phục tùy chỉnh này trong mô hình dữ liệu nâng cao, quy trình làm việc và logic plugin cần được cấu trúc lại và đăng ký lại trên bảng tương ứng của trang web.
Ví dụ: nếu người dùng đã đăng ký quy trình công việc/plugin cho Thực thể chính dưới dạng Trang web (tên logic adx_webpage) trong mô hình dữ liệu tiêu chuẩn thì mã trong quy trình công việc/plugin phải được sửa đổi thành Thành phần trang web (tên logic powerpagecomponent) và các thuộc tính của nó cho mô hình dữ liệu nâng cao.
Các sự cố đã biết
Lệnh di chuyển chỉ xử lý một loạt bản ghi 5K từ mô hình dữ liệu tiêu chuẩn sang mô hình dữ liệu nâng cao.
Phản hồi
Sắp ra mắt: Trong năm 2024, chúng tôi sẽ dần gỡ bỏ Sự cố với GitHub dưới dạng cơ chế phản hồi cho nội dung và thay thế bằng hệ thống phản hồi mới. Để biết thêm thông tin, hãy xem: https://aka.ms/ContentUserFeedback.
Gửi và xem ý kiến phản hồi dành cho