Bagikan melalui

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

  • Artikel

[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.

Penting

  • Fitur Ini adalah fitur pratinjau.
  • Fitur pratinjau tidak dibuat untuk penggunaan produksi dan mungkin memiliki fungsionalitas yang dibatasi. Fitur ini tersedia sebelum rilis resmi agar pelanggan bisa memperoleh akses awal dan memberikan tanggapan.

Prasyarat

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. Memigrasikan data situs dari model data standar ke model data yang disempurnakan

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:

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. Memverifikasi 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

Catatan

Jika migrasi situs Anda memakan waktu lebih lama dari yang diantisipasi, itu mungkin karena volume data. Jika prompt perintah Anda ditutup, buka prompt perintah baru dan gunakan perintah dalam langkah ini untuk memverifikasi status situs Anda.

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]

Catatan

  • Anda dapat menemukan id Portal dengan menavigasi ke situs web dengan '/_services/about' ditambahkan ke URL situs web. Untuk melihat opsi ini, pengguna harus memiliki peran web dengan semua izin akses situs web yang ditetapkan.
  • Setelah versi model data situs diperbarui, rekaman situs web yang ditautkan ke model data standar akan dinonaktifkan. Sebagai gantinya, situs sekarang akan merujuk ke rekaman situs web yang terkait dengan model data yang disempurnakan.
  • Pengguna harus memiliki salah satu peran berikut untuk menjalankan perintah migrasi dengan updateDatamodelVersion argumen atau revertToStandardDataModel . Karena ini akan melakukan tindakan admin untuk mengalihkan situs Anda ke model data enahance atau sebaliknya.

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]

Catatan

Saat Anda mengalihkan situs yang dimigrasikan dari model data yang disempurnakan kembali ke model data standar, rekaman situs web yang terkait dengan model data yang disempurnakan akan dinonaktifkan, dan rekaman situs web untuk model data standar akan diaktifkan kembali.

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.

Catatan

Untuk migrasi, id situs web sumber dan produksi sama.

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:

Catatan

Semua perbaikan terkait penyesuaian akan dilakukan setelah migrasi ke model data yang disempurnakan.

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.

Buat tabel contoso_webpage dalam model data yang disempurnakan untuk memperbaiki kode

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

Jenis Komponen Nilai
Status Publikasi 1
Halaman Web 2
File Web 3
Set Link Web 4
Link Web 5
Template Halaman 6
Cuplikan Konten 7
Template Web 8
Pengaturan Situs 9
Aturan Kontrol Akses Halaman Web 10
Peran Web 11
Akses Situs Web 12
Penanda Situs 13
Formulir Dasar 15
Metadata Formulir Dasar 16
Daftar 17
Izin Tabel 18
Formulir Tingkat Lanjut 19
Langkah Formulir Tingkat Lanjut 20
Metadata Formulir Tingkat Lanjut 21
Penempatan Polling 24
Penempatan Iklan 26
Konsumen Bot 27
Profil Izin Kolom 28
Izin Kolom 29
Alihkan 30
Aturan Transisi Status Penerbitan 31
Pintasan 32
Alur Cloud 33
Komponen UX 34

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.

Menggunakan tabel Komponen Situs dalam alur kerja dan atributnya untuk model data yang disempurnakan

Masalah yang diketahui

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