Memigrasikan situs model data standar ke model data yang disempurnakan (pratinjau)

[Topik ini adalah dokumentasi prarilis dan dapat berubah.]

Dalam artikel ini, pelajari cara memigrasikan situs model data standar yang ada ke model data yang disempurnakan.

Prasyarat

• Anda harus menginstal Microsoft Power Platform CLI dengan versi 1.31.6 atau yang lebih tinggi untuk memigrasikan situs Anda ke model data yang disempurnakan. Informasi lebih lanjut: Instal CLI terbaru Power Platform
• Dataverse paket portal dasar 9.3.2307.x atau lebih tinggi. 
• Power Pages Paket inti 1.0.2309.63 atau lebih tinggi. Informasi lebih lanjut: Perbarui Power Pages solusi
• Anda harus memahami cara menggunakan Power Platform CLI untuk Power Pages menyelesaikan langkah-langkah migrasi. Jika Anda tidak terbiasa dengan Power Platform CLI Power Pages, Anda mungkin ingin meninjau tutorial Power Platform CLI ini dan mereferensikan perintah CLI PAC untuk bekerja dengan Power Pages.

Langkah 1. Unduh dan periksa penyesuaian untuk metadata situs standar yang ada

1. Buka prompt perintah.

2. Gunakan perintah berikut untuk mengautentikasi ke Dataverse organisasi agar lingkungan Anda Power Platform dapat mengunduh rekaman situs web untuk migrasi.

   pac auth create -u [Dataverse URL]

   Contoh

   pac auth create -u https://contoso-org.crm.dynamics.com

   Informasi lebih lanjut: pac auth create

3. Gunakan perintah berikut untuk membuat daftar situs web di organisasi saat ini.

   pac powerpages list

   Informasi lebih lanjut: daftar halaman pac

4. Gunakan perintah berikut untuk mengunduh laporan penyesuaian.

   pac powerpages migrate-datamodel --webSiteId [WebSiteId-GUID] --siteCustomizationReportPath [PATH]

   Contoh

   pac powerpages migrate-datamodel --webSiteId 076bf556-9ae6-ee11-a203-6045bdf0328e --siteCustomizationReportPath "c:\\pac-powerpages\\downloads"

Jika Anda menemukan penyesuaian apa pun dalam laporan yang didownload, ikuti panduan dalam laporan untuk memperbaikinya pasca-migrasi ke model data yang disempurnakan. Informasi selengkapnya: Pertimbangan untuk penyesuaian situs saat memigrasikan situs dari model data standar ke model data yang disempurnakan

Langkah 2. Migrasikan data situs dari model data standar ke model data yang ditingkatkan

Gunakan perintah berikut untuk memigrasikan data situs Anda ke model data yang disempurnakan.

pac powerpages migrate-datamodel --webSiteId [WebSiteId-GUID] –-mode [type-of-data]

Mode dapat memiliki 3 nilai:

• configurationData: migrasikan metadata untuk situs web. Informasi lebih lanjut: Daftar tabel untuk menyimpan data konfigurasi

• configurationDataReferences: memigrasikan data transaksional untuk situs web. Informasi lebih lanjut: Daftar tabel untuk menyimpan data nonkonfigurasi

• ALL: Memigrasikan kedua jenis data.

Contoh

pac powerpages migrate-datamodel --webSiteId 076bf556-9ae6-ee11-a203-6045bdf0328e –-mode all

Alat migrasi memverifikasi solusi. Jika ada solusi model data standar yang hadir tanpa solusi model data yang disempurnakan masing-masing untuk templat yang disebutkan, peringatan akan ditampilkan: Found template <template-name>. One of the prerequisite for migrate needs Enchanged data model template

Ada templat khusus, seperti Pendaftaran program dan Jadwalkan dan Kelola rapat, yang memerlukan paket model data yang disempurnakan untuk memastikan situs web yang dimigrasikan berfungsi dengan baik. Untuk mendapatkan paket model data yang disempurnakan ini, Anda harus membuat situs baru untuk templat yang sesuai (lingkungan harus diaktifkan untuk model data yang ditingkatkan) untuk menyediakan solusi yang kompatibel dengan model data yang disempurnakan untuk migrasi.

Template yang didukung untuk migrasi

Situs dengan template berikut didukung untuk migrasi:

• Tata letak starter 1-5
• Pemrosesan aplikasi
• Halaman kosong
• Pendaftaran program
• Menjadwalkan dan mengelola rapat

Langkah 3. Verifikasi status migrasi

Gunakan perintah berikut untuk memverifikasi status migrasi situs Anda:

pac powerpages migrate-datamodel --webSiteId [WebSiteId-GUID] --checkMigrationStatus

Contoh

pac powerpages migrate-datamodel --webSiteId 076bf556-9ae6-ee11-a203-6045bdf0328e --checkMigrationStatus

Langkah 4. Perbarui versi model data situs setelah migrasi data berhasil

Gunakan perintah berikut memperbarui versi model data situs:

pac powerpages migrate-datamodel --webSiteId [WebSiteId-GUID] --updateDatamodelVersion --portalId [Portal-GUID]

Contoh

pac powerpages migrate-datamodel --webSiteId 076bf556-9ae6-ee11-a203-6045bdf0328e --updateDatamodelVersion --portalId 04435d71-c45a-4a05-9702-8f127559e48e

Mengembalikan situs yang dimigrasikan dari model data yang disempurnakan ke standar

Gunakan perintah berikut untuk mengembalikan situs model data standar ke model data yang disempurnakan setelah migrasi:

pac powerpages migrate-datamodel --webSiteId [WebSiteId-GUID] --revertToStandardDataModel --portalId [Portal-GUID]

Contoh

pac powerpages migrate-datamodel --webSiteId 076bf556-9ae6-ee11-a203-6045bdf0328e --revertToStandardDataModel --portalId 07f35d71-c45a-4a05-9702-8f127559e48e

Memigrasikan situs produksi dari model data standar ke model data yang disempurnakan

Sebelum memigrasikan situs produksi, sebaiknya buat salinan lengkap situs produksi. Kami juga merekomendasikan migrasi situs produksi untuk dilakukan selama jam di luar jam kerja.

Gunakan langkah-langkah ini untuk memigrasikan situs produksi Anda ke model data yang disempurnakan:

1. Coba migrasi di situs di lingkungan yang disalin menggunakan perintah PAC CLI migrate-datamodel .
2. Tambahkan data konfigurasi situs ke solusi terkelola dan impor ke lingkungan produksi.
3. Gunakan perintah PAC CLI untuk memigrasikan data nonkonfigurasi dan menyelesaikannya dengan memperbarui versi model data untuk produksi.

Pertimbangan untuk penyesuaian situs saat memigrasikan situs dari model data standar ke model data yang disempurnakan

Bagian ini memberikan panduan memperbaiki penyesuaian untuk migrasi situs dari model data standar ke model data yang disempurnakan.

Ada lima jenis penyesuaian situs pada tabel metadata adx:

• Kolom kustom pada tabel metadata adx
• Hubungan antara tabel kustom dan tabel adx
• Referensi tabel Adx dalam cuplikan kode cair
• Referensi tabel Adx di fetch xml
• Alur kerja dan plugin kustom pada tabel adx

Kolom kustom pada tabel metadata adx

Untuk memperbaiki penyesuaian ini dalam model data yang disempurnakan, buat hubungan antara tabel sistem dan tabel kustom baru dan migrasikan data ke tabel baru.

Model data standar: Tabel adx_webpage berisi kolom kustom sebagai contoso_pagetype.

Model data yang disempurnakan: Buat tabel baru bernama contoso_webpage. Ini akan mencakup kolom yang disebut contoso_pagetype dan kolom contoso_webpage_id pencarian yang terkait dengan powerpagescomponent. Manfaatkan ruang kerja Data untuk pembuatan tabel.

Hubungan antara tabel kustom dan tabel adx

Untuk memperbaiki penyesuaian ini dalam model data yang disempurnakan, buat hubungan antara tabel kustom dan tabel sistem.

Model data standar: Tabel adx_webpage memiliki hubungan yang dinamai adx_webpage_contoso_pagelogs dengan contoso_pagelogs tabel.

Model data yang disempurnakan: Membuat hubungan baru yang diberi nama powerpagecomponent_contoso_pagelogs dengan contoso_webpage tabel. Manfaatkan ruang kerja Data untuk pembuatan tabel.

Referensi tabel Adx dalam cuplikan kode cair

Untuk memperbaiki penyesuaian ini dalam model data yang disempurnakan, ganti referensi tabel adx dalam kode cair dengan referensi mspp tabel virtual model data yang disempurnakan. Atau, Anda dapat menggunakan tabel Komponen Situs (nama logis powerpagecomponent) bersama dengan atribut Jenis Komponen (nama logis powerpagecomponenttype) untuk mengambil referensi yang sesuai.

Model data standar:entities tag liquid digunakan untuk mengakses nilai tautan web dalam {% assign app_weblinks= entities['adx_weblinks'] %} kode.

Model data yang disempurnakan: Alih-alih menggunakan tautan web melalui entities tag cair, gunakan objek cair masing-masing. entities[adx_weblinks] langsung. Dalam hal ini entities['adx_weblinks'] dapat diganti dengan weblinks benda cair.

Referensi tabel Adx di fetch xml

Untuk memperbaiki penyesuaian ini dalam model data yang disempurnakan, ganti referensi tabel adx di fetch xml dengan referensi langsung tabel virtual model data yang disempurnakan. Atau, Anda dapat menggunakan tabel Komponen Situs (nama logis powerpagecomponent) bersama dengan atribut Jenis Komponen (nama logis powerpagecomponenttype) untuk mengambil referensi yang sesuai.

Model data standar: Nama adx_webrole tabel digunakan dalam kueri xml ambil.

{% fetchxml app_webroles %}
<fetch>
 <entity name='adx_webrole'>
  <attribute name='adx_name'/>
 <entity>
</fetch>
{% endfetchxml %}

Model data yang disempurnakan: Gunakan Komponen Situs (nama logis ) bersama dengan powerpagecomponentatribut Jenis Komponen (nama logis ) untuk mengambil powerpagecomponenttypereferensi yang sesuai.

{% fetchxml app_webroles %}
<fetch>
 <entity name='powerpagecomponent'>
  <attribute name='adx_name'/>
  <filter type='and'>
   <condition attribute ='powerpagecomponenttype' operator ='eq' value ='11'/>
  <entity>
</fetch>
{% endfetchxml %}

Jenis dan nilai komponen situs

Alur kerja dan plugin kustom pada tabel adx

Untuk memperbaiki penyesuaian ini dalam model data yang disempurnakan, alur kerja dan logika plugin perlu difaktorkan ulang dan didaftarkan ulang di tabel situs masing-masing.

Misalnya, jika pengguna mendaftarkan alur kerja/plugin ke Entitas Utama sebagai tabel Halaman Web (nama logis ) dalam model data standar, maka kode dalam alur kerja/plugin harus dimodifikasi ke adx_webpagetabel Komponen Situs (nama logis ) dan atributnya untuk model data yang powerpagecomponentdisempurnakan.

Masalah yang diketahui

Perintah migrasi hanya memproses batch rekaman 5K dari model data standar ke model data yang disempurnakan.