Gambaran keseluruhan migrasi model data standard ke dipertingkatkan

Utiliti migrasi CLI Microsoft Power Platform memindahkan konfigurasi dan rekod berkaitan yang disokong oleh laman Power Pages sedia ada dari model data standard ke model data yang dipertingkatkan, dan kemudian menukar laman tersebut untuk menggunakan konfigurasi yang dimigrasikan.

Model data standard menyimpan konfigurasi tapak Power Pages merentasi jadual yang menggunakan awalan adx_. Model data yang dipertingkatkan menyimpan konfigurasi tapak dalam jadual Komponen Tapak (powerpagecomponent) dan mengenal pasti setiap komponen mengikut jenis komponennya. Memahami bagaimana utiliti migrasi berfungsi, templat mana yang disokongnya, dan penyesuaian mana yang tidak dikemas kini secara automatik membantu anda menentukan bila dan bagaimana untuk memindahkan laman.

Mengkaji manfaat model data yang dipertingkatkan menerangkan mengapa anda mungkin mempertimbangkan untuk memindahkan laman web.

Penting untuk diingat bahawa tidak semua jadual adx_* bergerak ke powerpagecomponent. Hanya jadual metadata adx_* — yang menerangkan struktur dan permukaan pengarang laman, seperti , , , , adx_sitesetting, adx_pagetemplateadx_weblinkadx_entityform, dan adx_entitylist — digabungkan ke dalam powerpagecomponent (dengan sifat setiap baris dipindahkan ke dalam lajur kandungan JSON). adx_contentsnippetadx_webtemplateadx_webpage

Jadual adx_* transaksi / runtime — yang menangkap aktiviti pengguna akhir semasa runtime, seperti adx_invitation, adx_inviteredemption, adx_portalcomment, , adx_externalidentitydan jadual penyerahan dan log borang entiti / borang lanjutan — tidak dimigrasi ke ; powerpagecomponentia kekal pada skema sedia ada dan terus menyimpan data runtime seperti sebelumnya. Apa yang berubah untuk jadual transaksi tersebut ialah carian mereka kepada rekod metadata disambung semula semasa migrasi rujukan supaya ia menunjuk ke baris baru powerpagecomponent dan bukannya baris metadata adx_* yang legacy.

Laman sedia ada yang ditulis pada model data standard terus berjalan pada jadual adx_*, jadi setiap tapak mesti dimigrasikan untuk mendapat manfaat daripada model data yang dipertingkatkan. Migrasi memindahkan metadata konfigurasi laman ke dalam bentuk model powerpagecomponent data yang dipertingkatkan, menyusun semula rujukan transaksi ke rekod metadata baru tersebut, dan membalikkan rekod tapak untuk menyajikan dari model data dipertingkatkan. Di sinilah penyesuaian — lajur adx_* tersuai, Liquid yang membaca atribut adx_*, Jadual FetchXML ke atas adx_*, plugin, dan aliran kerja — dipaparkan dan diperbaiki, kerana penyesuaian tersebut tidak dibawa secara automatik dan mesti ditulis semula atau disusun semula untuk berfungsi dengan model data yang dipertingkatkan.

Prasyarat

Microsoft Power Platform CLIversi 2.11.2 atau lebih baru, yang menjalankan arahan muat turun laman, migrasi, status, pengaktifan, dan rollback. Untuk maklumat lanjut, lihat Pasang CLI Power Platform terkini.
Pakej CDSBasePortal portal asas Dataverse 9.3.2607.x atau lebih baru, yang menyediakan komponen portal asas yang diperlukan.
Pakej PowerPages_Core Power Pages Core 1.0.2605.x atau lebih baru, yang menyediakan komponen runtime Power Pages yang diperlukan. Kemas kini penyelesaian Power Pages.
Peranan Pentadbir Sistem, Pentadbir Dynamics 365, atau Pentadbir Power Platform, yang diperlukan untuk menukar atau membalikkan model data aktif.
Pengetahuan tentang Power Platform CLI untuk Power Pages.
Operasi latar belakang diaktifkan jika persekitaran berada dalam mod pentadbiran.

Keupayaan utiliti migrasi

Utiliti migrasi menyalin konfigurasi tapak yang disokong dan rekod berkaitan ke model data yang dipertingkatkan. Selepas migrasi selesai, tapak aktif beralih ke model data yang dipertingkatkan dan disahkan sebelum ia kembali digunakan secara normal.

Utiliti migrasi:

Menjana laporan penyesuaian yang mungkin memerlukan perubahan manual.
Memigrasikan konfigurasi tapak yang disokong dan rekod berkaitan.
Membolehkan anda memeriksa status migrasi sebelum menukar model data aktif.
Membolehkan anda mengembalikan laman kepada model data standard jika pengesahan mengenal pasti isu kritikal.

Penting

Utiliti migrasi tidak mengemas kini setiap penyesuaian yang bergantung secara langsung pada jadual model data standard. Semak laporan penyesuaian, baiki kod tersuai yang terjejas, dan uji tapak yang dimigrasikan sebelum penggunaan produksi.

Templat yang disokong

Anda boleh memindahkan tapak model data standard sedia ada yang dicipta daripada templat berikut:

Reka etak pemula 1-5
Pemprosesan aplikasi
Halaman kosong
Pendaftaran program
Jadualkan dan urus mesyuarat
FAQ
Portal Komuniti (Dynamics 365)
Portal Self-Service Pelanggan (Dynamics 365)
Portal Self-Service Pekerja (Dynamics 365)
Portal Rakan Kongsi (Dynamics 365)

Nota

Mewujudkan laman baru dengan model data yang dipertingkatkan dan memindahkan laman sedia ada adalah keupayaan berasingan. Jika templat asal tapak tidak disenaraikan di sini, jangan jalankan utiliti migrasi untuk laman tersebut.

Sebelum anda mula

Pertimbangan perancangan tambahan:

Tetapan persekitaran Beralih ke model data dipertingkatkan mengawal model data yang digunakan untuk tapak baru. Menghidupkan tetapan tidak memindahkan laman sedia ada.
Jalankan migrasi terlebih dahulu dalam salinan penuh persekitaran pengeluaran. Penyesuaian lengkap, pemulihan dan pengesahan sebelum migrasi.
Gunakan proses sandaran dan pemulihan standard organisasi anda untuk membuat sandaran persekitaran pengeluaran.
Rancang tingkap penyelenggaraan untuk suis pengeluaran akhir dan pengesahan.
Rekod ID laman web, ID portal, URL persekitaran, versi CLI, versi pakej, masa mula migrasi, dan borang output arahan sebagai sebahagian daripada rekod migrasi.

Rancang urutan persekitaran

Migrasi menyokong persekitaran yang berbeza, dengan mod yang berbeza untuk setiap persekitaran.

Persekitaran	Mod disyorkan	Apa yang anda lakukan
Pembangunan	`configurationData`	Migrasi konfigurasi, semak laporan penyesuaian, betulkan penyesuaian, sahkan, dan rakam konfigurasi dalam penyelesaian.
Ujian atau UAT	`configurationDataReferences`	Import penyelesaian yang diuji dari pembangunan, migrasikan rekod berkaitan yang disokong, aktifkan model data yang dipertingkatkan, dan sahkan.
Penerbitan	`configurationDataReferences`	Import penyelesaian terurus yang telah disahkan, migrasikan rekod berkaitan yang disokong, aktifkan semasa tetingkap penyelenggaraan, dan lengkapkan pengesahan pengeluaran.
Persekitaran tunggal atau tapak ringkas	`all`	Migrasikan konfigurasi dan rekod berkaitan dalam satu operasi hanya apabila anda memahami kesan penyesuaian dan tidak menggunakan laluan penyelesaian multienvironment.

Cipta folder kerja

Gunakan folder kerja kosong untuk menyimpan laporan, sumber laman yang dimuat turun, dan fail perbandingan. Contoh berikut digunakan \<OUTPUT\> untuk lokasi ini.

mkdir C:\PowerPagesMigration\<site-name>
cd C:\PowerPagesMigration\<site-name>

Fasa migrasi

Proses migrasi terdiri daripada empat fasa:

Pra-semakan — Sahkan tapak, ID, CLI, pakej, penyelesaian templat, dan status migrasi.
Konfigurasi — Migrasi konfigurasi dalam pembangunan atau import konfigurasi yang diuji dalam persekitaran hiliran.
Migrasi dan aktifkan — Migrasi rekod berkaitan, sahkan penyempurnaan, tukar model, dan mulakan semula.
Sahkan — Uji tingkah laku, kebenaran, kod tersuai, dan perjalanan templat.

Fasa 1 (Penemuan tapak dan pra-semakan) dan Fasa 4 (pengesahan pasca-migrasi) berjalan dengan cara yang sama untuk setiap tapak.

Fasa 2 dan Fasa 3 adalah bercabang trek - bentuknya bergantung pada mod migrasi, yang menghasilkan trek daripada jenis persekitaran.

Trek Pengarang (mod configurationData atau all) digunakan untuk setup Dev dan persekitaran tunggal. Metadata itu sendiri dimigrasikan secara tempatan dan penyesuaian diimbas serta diperbaiki terhadap sumber model data standard sebelum rujukan transaksi dipindahkan.

Laluan Hiliran (mod) configurationDataReferencesdigunakan untuk persekitaran Ujian, UAT, dan Pengeluaran di mana metadata konfigurasi dianggap telah sampai melalui import penyelesaian ALM dari Dev. Hanya rujukan transaksi yang dimigrasikan dalam trek ini. Sebarang penemuan penyesuaian menunjukkan jurang ALM hulu dan bukannya kerja yang perlu dilakukan secara tempatan.

Fasa 1: Pra-semakan

Sahkan versi CLI Power Platform anda dengan pac --version. Jika versi anda lebih awal daripada versi yang diperlukan, pasang atau kemas kini CLI Microsoft Power Platform sebelum meneruskan.
Sahkan kepada persekitaran sasaran.
1. Lari pac auth list.
2. Lari pac auth who.
Sahkan bahawa profil pengesahan aktif menunjuk ke persekitaran yang mengandungi laman tersebut. Untuk memilih profil lain atau mencipta profil, gunakan pac auth select atau pac auth create -u "https://contoso.crm.dynamics.com".
Pasang penyelesaian model Data Dipertingkatkan untuk templat anda menggunakan salah satu kaedah berikut:
1. Sediakan tapak templat anda dengan bendera model data dipertingkatkan (EDM) diaktifkan di pusat pentadbir.
2. Gunakan CLI untuk memasang dengan arahan pac application install --application-name "<template package name>"
Cari laman tersebut dan rekod pengecamnya dengan pac pages list -v.

Catat nilai yang ditunjukkan dalam jadual berikut.

Nilai	Digunakan untuk
ID Laman Web	Semua `migrate-datamodel` arahan.
Portal ID	Beralih kepada model data yang dipertingkatkan dan kembali kepada model data standard.
Nama dan URL mesra	Mengesahkan bahawa anda memilih tapak yang betul di pusat pentadbir.
Versi model data	Mesti Standard. Jika ia sudah Dipertingkatkan, migrasi tidak diperlukan.

Penting

ID portal bukan ID aplikasi Power Pages. Jika CLI tidak memaparkan ID portal, ia tersedia di pusat pentadbir Power Platform di bawah ResourcesPower>Pages sites>Site Site Details, atau ditambah /_services/about pada URL laman semasa log masuk dengan kebenaran akses laman web yang diperlukan.

Semak migrasi terdahulu atau yang sedang berjalan dengan arahan berikut:

pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --checkMigrationStatus

Status	Maksud	Tindakan
NotStarted atau tiada penjejak	Tiada migrasi bermula.	Teruskan dengan pemeriksaan pakej.
Dikembalikan	Migrasi terdahulu telah dibatalkan.	Semak mengapa ia dikembalikan, kemudian teruskan apabila sudah bersedia.
Dilengkapkan	Migrasi selesai, tetapi laman mungkin belum ditukar.	Sahkan model data aktif. Jika masih Standard, teruskan dengan pengaktifan.
Berjalan	Migrasi masih dalam proses.	Teruskan semak status. Jangan mulakan migrasi lain untuk laman yang sama.
Gagal	Migrasi mengalami ralat.	Kumpulkan output arahan dan butiran persekitaran, betulkan punca, dan cuba semula hanya selepas kegagalan difahami.

Nota

Jika migrasi berjalan lebih lama daripada jangkaan, anda memerlukan ID laman web, ID persekitaran, versi CLI, versi pakej, output arahan, dan masa mula migrasi sebelum menghubungi sokongan Microsoft. Migrasi aktif tidak sepatutnya diset semula melainkan sokongan atau runbook yang diluluskan mengarahkannya.

Sahkan pakej pihak pertama yang diperlukan dengan pac solution list --includeSystemSolutions.
1. Sahkan bahawa CDSBasePortal, PowerPages_Core, dan penyelesaian EDM untuk templat laman telah dipasang pada versi yang diperlukan.
Jika pakej hilang atau lapuk, kemas kini dari pusat pentadbir Power Platform:
1. Buka persekitaran sasaran.
2. Pergi ke aplikasi ResourcesDynamics>365.
3. Cari pakej yang diperlukan.
4. Pilih Pasang atauNaik Taraf.
5. Tunggu sehingga operasi selesai, kemudian jalankan pac solution list --includeSystemSolutions semula.
Nota

Jika penyelesaian EDM templat tidak tersedia untuk pemasangan langsung, mencipta tapak model data dipertingkatkan sementara dalam persekitaran yang sama dengan templat yang sama akan memasang penyelesaian EDM yang sepadan. Anda boleh memadam tapak sementara selepas penyelesaian disahkan.
Jana laporan penyesuaian dengan pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --siteCustomizationReportPath "<OUTPUT>". Menjana laporan tidak mengubah laman web.

Buka fail CSV yang dijana dan semak setiap item yang merujuk jadual model data standard. Tetapkan pemilik dan langkah pengesahan untuk setiap pemulihan yang diperlukan sebelum migrasi produksi.

Kategori penyesuaian	Pelan
Lajur tersuai pada jadual metadata adx_	Pindahkan data tersuai ke jadual tersuai yang disokong berkaitan dengan powerpagecomponent.
Hubungan dengan jadual metadata adx_	Cipta semula hubungan terhadap jadual model data dipertingkatkan yang disokong.
Rujukan Liquid atau FetchXML kepada jadual adx_	Kemas kini kod untuk menggunakan objek Liquid yang disokong, jadual maya, atau powerpagecomponent.
Aliran kerja dan pemalam pada jadual adx_	Refaktor dan daftarkan logik terhadap jadual model data dipertingkatkan yang disokong.

Nota

Laporan penyesuaian tidak membuktikan bahawa semua tingkah laku laman berfungsi selepas migrasi; pengesahan masih diperlukan.

Pilih mod migrasi untuk menentukan apa yang utiliti migrasikan dalam satu operasi.

Mod	Apa yang ia migrasikan	Bila untuk menggunakannya
konfigurasiDataData	Metadata konfigurasi laman yang disokong, seperti halaman, templat web, petikan, tetapan, borang, senarai, peranan web, dan kebenaran jadual.	Pembangunan, di mana anda memperbaiki konfigurasi dan menggerakkannya melalui penyelesaian.
konfigurasiDataRujukan	Rekod yang disokong yang merujuk kepada konfigurasi tapak yang dimigrasikan.	Ujian, UAT, dan pengeluaran selepas konfigurasi tapak tiba melalui import penyelesaian.
Semua	Kedua-dua konfigurasi dan rekod berkaitan yang disokong.	Satu persekitaran tunggal atau migrasi mudah yang tidak menggunakan urutan persekitaran berasaskan penyelesaian.

Fasa 2: Konfigurasi tapak

Laluan Penulisan: Pembangunan atau satu persekitaran

Muat turun garis dasar SDM dengan menjalankan pac pages download --webSiteId "<WEBSITE_ID>" --modelVersion 1 --path "<OUTPUT>\site-sdm". Arahan ini mencipta folder anak yang dinamakan sempena laman tersebut. Rakam folder yang mengandungi website.ymlsecara langsung .
Migrasi konfigurasi tapak dengan menjalankan pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --mode configurationData. Jika anda mahu laluan operasi tunggal, gantikan configurationData dengan all.
Semak status migrasi dengan menjalankan pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --checkMigrationStatus. Gunakan gelung PowerShell berikut untuk memeriksa status sekali setiap minit sehingga 30 minit:
```
$webSiteId = "<WEBSITE_ID>"
for ($i = 1; $i -le 30; $i++) {
    $output = pac pages migrate-datamodel `
        --webSiteId $webSiteId `
        --checkMigrationStatus 2>&1 | Out-String
    if ($output -match "Completed|Failed|Reverted") {
        Write-Host $output
        break
    }
    Write-Host "Attempt $i/30 - migration is still running."
    Start-Sleep -Seconds 60
}
```
Jika gelung berakhir semasa status masih Berjalan, pemeriksaan diteruskan dengan --checkMigrationStatus. Operasi yang berlangsung lama tidak semestinya operasi yang gagal.
Perbaiki penyesuaian yang dilaporkan dengan menggunakan laporan penyesuaian dan panduan dalam artikel ini untuk mengemas kini FetchXML, Liquid, lajur tersuai, hubungan, aliran kerja, dan plug-in yang terjejas. Uji semula setiap komponen yang telah diubah. Jika anda mengemas kini sumber yang dimuat turun, muat naik folder tapak yang mengandungi website.yml secara langsung dengan menjalankan pac pages upload --path "<OUTPUT>\site-sdm\<site-slug>" --modelVersion 1.

Laluan Hiliran: Ujian, UAT, atau pengeluaran

Import penyelesaian yang mengandungi konfigurasi tapak yang telah dimigrasi dan diperbaiki. Gunakan pusat pentadbiran Power Platform atau saluran penyebaran yang telah anda tetapkan.
```
pac solution import --path "<PATH_TO_SOLUTION_ZIP>" --activate-plugins true --publish-changes true
```
Sahkan bahawa konfigurasi laman ada dengan membuka aplikasi Power Pages Management dalam persekitaran sasaran. Rekod tapak dan konfigurasi yang dijangka perlu hadir sebelum rekod berkaitan dimigrasikan.

Migrasi rekod berkaitan yang disokong. Jika anda sudah menggunakannya --mode all, langkau langkah ini. Semak status sehingga ia melaporkan Selesai.

pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --mode configurationDataReferences
pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --checkMigrationStatus

Setelah status migrasi melaporkan penyelesaian berjaya, tukar tapak aktif ke model data yang dipertingkatkan. Rekod laman web model data standard dinyahaktifkan dan rekod laman web model data dipertingkatkan yang sepadan menjadi aktif.
```
pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --updateDatamodelVersion --portalId "<PORTAL_ID>"
```
Mulakan semula laman.
1. Buka pusat pentadbiran Power Platform.
2. Pergi ke persekitaran, kemudian pilih laman ResourcesPower>Pages.
3. Pilih laman.
4. Pilih Mulakan Semula. Jika Mulakan Semula tidak tersedia, nyahaktifkan dan kemudian aktifkan laman tersebut.
5. Tunggu sehingga operasi selesai sebelum pengesahan.
Sahkan model data aktif menggunakan satu atau lebih kaedah berikut:
1. Dalam pusat pentadbir Power Platform, pilih tapak dan sahkan bahawa model Data menunjukkan Dipertingkatkan.
2. Buka ruang kerja Setup laman dalam Power Pages design studio dan sahkan model data yang dipaparkan.
3. Sahkan bahawa konfigurasi lanjutan dibuka dalam aplikasi Power Pages Management.
4. Jalankan pac pages list -v dan sahkan versi model data.
Petua

URL laman dan reka bentuk visual tidak berubah hanya kerana model data aktif berubah. Untuk mengesahkan migrasi, gunakan pemeriksaan ini — bukan penampilan laman.

Fasa 4: Sahkan tapak yang dimigrasi

Pengesahan lengkap sebelum membuka semula tapak pengeluaran kepada pengguna. Gunakan akaun ujian untuk setiap jenis pengguna penting dan peranan web, dan rekodkan hasil setiap ujian kritikal.

Kawasan	Apa yang perlu disahkan
Halaman dan kandungan	Laman utama, halaman kandungan wakil, templat web, petikan kandungan, fail web, navigasi, pengalihan, dan kandungan berbilang bahasa.
Pengesahan	Log masuk, log keluar, pendaftaran, jemputan, penyedia identiti luaran, dan pengalaman akses ditolak.
Pengesahan	Peranan web, kebenaran jadual, kebenaran lajur, dan peraturan akses halaman membenarkan dan menolak tindakan yang dijangka.
Borang dan senarai	Borang asas, borang berbilang langkah, senarai, metadata borang, penghantaran, rekod berkaitan, dan sesi borang web yang digunakan oleh laman.
Perjalanan templat Dynamics 365	Perjalanan utama pelanggan, pekerja, komuniti, atau rakan kongsi yang digunakan oleh pelaksanaan anda, termasuk halaman khusus templat dan corak akses.
Kod tersuai	Liquid, FetchXML, JavaScript, plug-in, aliran kerja, dan integrasi yang dikenal pasti dalam laporan penyesuaian.
Tetapan laman dan fail	Tetapan laman, imej, lampiran, fail SVG, dan fail web lain dimuatkan dengan betul.
Data dan rujukan	Kiraan rekod penting dan rekod berkaitan yang disokong menunjuk kepada komponen tapak yang telah dimigrasikan dengan betul.
Pentadbiran dan ALM	Laman ini dibuka dalam Power Pages Management dan boleh ditambah, dieksport masuk, dan diimport dari penyelesaian seperti yang dijangka.

Semak diagnostik pelayar

Buka alat pembangun pelayar semasa menguji halaman wakil. Siasat:

Ralat konsol yang menyebut adx\_, entiti, Liquid, atau FetchXML.
Respons HTTP 401 atau 403 daripada \_api, yang boleh menunjukkan isu kebenaran atau peranan web.
Respons HTTP 500, yang boleh menunjukkan kegagalan Liquid, FetchXML, plug-in, atau integrasi.

Kriteria penyelesaian migrasi

Anggap migrasi selesai hanya apabila laman web menunjukkan model data yang dipertingkatkan, perjalanan perniagaan kritikal lulus, tingkah laku keselamatan yang dijangka disahkan, dan setiap penemuan penyesuaian berimpak tinggi diselesaikan atau diterima.

Urutan migrasi pengeluaran

Gunakan urutan pengeluaran berikut untuk mengurangkan risiko migrasi:

Cipta salinan penuh persekitaran produksi untuk latihan.
Sahkan prasyarat penyelesaian CLI, pakej, dan templat dalam persekitaran yang disalin.
Jana dan semak laporan penyesuaian.
Migrasi konfigurasi dalam persekitaran pembangunan yang disalin.
Perbaiki penyesuaian dan tangkap konfigurasi tapak yang telah disahkan dalam penyelesaian terurus.
Import penyelesaian ke dalam persekitaran latihan, migrasikan rekod berkaitan yang disokong, aktifkan model data yang dipertingkatkan, dan lengkapkan senarai semak pengesahan penuh.
Ulangi pemulihan dan latihan sehingga semua ujian kritikal lulus.
Jadualkan tingkap penyelenggaraan pengeluaran, komunikasikan titik keputusan pengesahan dan rollback, serta sandaran pengeluaran.
Sahkan semula prasyarat pakej pengeluaran dan penyelesaian templat.
Import penyelesaian terurus yang telah disahkan ke dalam pengeluaran.
Jalankan configurationDataReferences, semak status migrasi, tukar model data aktif, dan mulakan semula laman.
Jalankan senarai semak pengesahan pengeluaran dan kembalikan tapak ke kegunaan biasa hanya selepas ujian kritikal lulus.

Kembalikan tapak yang dimigrasikan ke model data standard

Jika pengesahan mengenal pasti isu kritikal selepas pengaktifan, gunakan arahan berikut untuk mengaktifkan semula rekod laman web model data standard:

pac pages migrate-datamodel --webSiteId "<WEBSITE_ID>" --revertToStandardDataModel --portalId "<PORTAL_ID>"

Selepas arahan selesai:

Mulakan semula laman dari pusat pentadbir Power Platform.
Sahkan bahawa laman menunjukkan Standard sebagai model data aktif.
Jalankan semula ujian pengesahan kritikal laman.
Simpan laporan migrasi, butiran ralat, dan nota pembetulan sebelum mencuba migrasi lain.

Penting

Rancang keputusan rollback sebelum migrasi pengeluaran. Semak semula perubahan yang dibuat selepas pertukaran model data dipertingkatkan sebelum mengembalikan, kerana rekod laman web standard dan enhanced adalah rekod berasingan.

Penyelesaian masalah

Mesej atau simptom	Punca yang mungkin	Tindakan
`pac powerpages migrate-datamodel` tidak diiktiraf	Arahan ini menggunakan namespace yang salah atau CLI yang sudah lapuk.	Kemas kini CLI Power Platform dan gunakan `pac pages migrate-datamodel`.
`CDSBasePortal` atau `PowerPages_Core` tidak disenaraikan	Penyelesaian sistem tidak disertakan dalam output arahan, atau pakej tidak dipasang.	Lari `pac solution list --includeSystemSolutions`. Pasang atau naik taraf pakej yang hilang dari pusat pentadbir Power Platform.
Laman web tidak disokong untuk migrasi	Templat asal tidak disokong, versi pakej tidak mencukupi, atau penyelesaian templat EDM yang sepadan tiada.	Sahkan kelayakan templat, versi pakej, dan penyelesaian EDM yang disenaraikan dalam rujukan penyelesaian templat.
Satu hujah `--webSiteId` yang tidak diketahui telah diluluskan untuk `pac pages upload`	Arahan muat naik tidak menerima argumen ID laman web.	Abaikan hujah itu. Tapak ini dikenal pasti daripada `website.yml`.
Muat naik menyasarkan laman yang salah atau gagal mencari laman tersebut	Laluan menunjuk ke folder pembalut dan bukannya folder tapak.	Gunakan folder anak yang secara langsung mengandungi website.yml.
ID portal menunjukkan `Unknown` atau `N/A`	Laman web tidak aktif atau CLI yang dipasang tidak mengembalikan nilai.	Dapatkan ID portal dari pusat pentadbir Power Platform atau halaman `/_services/about` laman. Jangan gunakan ID aplikasi.
Laporan `Completed` migrasi tetapi laman masih menunjukkan `Standard`	Model data aktif tidak ditukar, atau ID portal yang salah digunakan.	Jalankan arahan pengaktifan dengan ID laman web dan ID portal yang betul, kemudian mulakan semula dan sahkan laman tersebut.
Status kekal `Running`	Migrasi memproses sejumlah besar data atau disekat.	Teruskan semak status. Kumpulkan persekitaran, pakej, CLI, masa mula, dan butiran arahan sebelum menghubungi sokongan. Jangan mulakan migrasi kedua.
Statusnya ialah `Failed`	Ralat pakej, templat, penyesuaian, data, atau perkhidmatan telah menghentikan operasi.	Simpan output arahan lengkap, betulkan punca yang dikenal pasti, dan cuba semula hanya selepas menyemak keadaan migrasi yang gagal.
Laman ini dibuka, tetapi pengguna tidak dapat mengakses data yang dijangka	Peranan web, kebenaran jadual, atau pertanyaan tersuai tidak berfungsi seperti yang dijangka selepas migrasi.	Semak peranan web, kebenaran jadual, kebenaran lajur, FetchXML, Liquid, dan ralat rangkaian pelayar.

Pertimbangan untuk penyesuaian laman web

Laporan penyesuaian mengenal pasti kebergantungan langsung pada jadual model data standard. Selesaikan pemulihan yang diperlukan sebelum penggunaan produksi.

Lajur tersuai pada jadual metadata

Jika jadual model data standard seperti mengandungi adx_webpage lajur tersuai, cipta jadual tersuai untuk menyimpan data tersuai dan tambah carian ke powerpagecomponent. Migrasi nilai tersuai ke jadual baru dan kemas kini kod yang membaca atau menulis lajur.

Hubungan antara jadual tersuai dan jadual metadata

Cipta semula hubungan tersuai yang menunjuk ke adx_ jadual supaya ia menunjuk ke jadual model data dipertingkatkan yang sesuai, biasanya powerpagecomponent. Kemas kini borang, paparan, plug-in, aliran, dan integrasi yang bergantung.

Rujukan cecair kepada jadual metadata

Gantikan akses langsung entities['adx_*'] dengan objek Liquid yang disokong jika ada. Sebagai contoh, gunakan weblinks objek Liquid dan bukannya membuat adx_weblinkset pertanyaan langsung atau jadual berkaitan. Semak setiap penggunaan kerana objek yang dikembalikan dan atribut yang tersedia boleh berbeza.

Rujukan FetchXML kepada jadual metadata

Gantikan rujukan entiti langsung adx_ dengan jadual maya atau pertanyaan powerpagecomponent yang sepadan dan tapis dengan powerpagecomponenttype

Contoh model data standard:

<fetch>
  <entity name="adx_webpage">
    <attribute name="adx_name" />
    <filter>
      <condition attribute="adx_partialurl" operator="eq" value="home" />
    </filter>
  </entity>
</fetch>

Contoh model data yang dipertingkatkan:

<fetch>
  <entity name="powerpagecomponent">
    <attribute name="name" />
    <filter type="and">
      <condition attribute="powerpagecomponenttype" operator="eq" value="2" />
      <condition attribute="partialurl" operator="eq" value="home" />
    </filter>
  </entity>
</fetch>

Aliran kerja dan plug-in tersuai

Refaktor aliran kerja tersuai dan logik plug-in yang didaftarkan pada adx_ jadual. Daftarkan logik yang dikemas kini pada jadual model data dipertingkatkan yang sesuai dan gunakan skema serta atribut yang dipertingkatkan. Uji tingkah laku cipta, kemas kini, padam, dan keselamatan dalam persekitaran bukan produksi.

Rujukan arahan

Tujuan	Perintah
Semak versi CLI	`pac --version`
Senaraikan profil pengesahan	`pac auth list`
Cipta profil pengesahan	`pac auth create -u "<ENV_URL>"`
Senaraikan tapak dan pengecam	`pac pages list -v`
Penyelesaian sistem senarai	`pac solution list --includeSystemSolutions`
Semak status migrasi	`pac pages migrate-datamodel --webSiteId "<ID>" --checkMigrationStatus`
Muat turun sumber SDM	`pac pages download --webSiteId "<ID>" --modelVersion 1 --path "<OUT>\site-sdm"`
Muat turun sumber EDM	`pac pages download --webSiteId "<ID>" --modelVersion 2 --path "<OUT>\site-edm"`
Jana laporan penyesuaian	`pac pages migrate-datamodel --webSiteId "<ID>" --siteCustomizationReportPath "<OUT>"`
Migrasi konfigurasi	`pac pages migrate-datamodel --webSiteId "<ID>" --mode configurationData`
Migrasi rekod berkaitan	`pac pages migrate-datamodel --webSiteId "<ID>" --mode configurationDataReferences`
Migrasi kedua-dua kategori	`pac pages migrate-datamodel --webSiteId "<ID>" --mode all`
Muat naik sumber laman web	`pac pages upload --path "<SITE_ROOT>" --modelVersion 1`
Aktifkan EDM	`pac pages migrate-datamodel --webSiteId "<ID>" --updateDatamodelVersion --portalId "<PORTAL_ID>"`
Kembali ke SDM	`pac pages migrate-datamodel --webSiteId "<ID>" --revertToStandardDataModel --portalId "<PORTAL_ID>"`

Rujukan jenis komponen tapak

Apabila anda membuat pertanyaan powerpagecomponent, gunakan nilai berikut dalam penapis powerpagecomponenttype .

Komponen	Nilai	Komponen	Nilai
Keadaan Penerbitan	1	Halaman Web	2
Fail Web	3	Set Pautan Web	4
Pautan Web	5	Templat Halaman	6
Cebisan Kandungan	7	Templat Web	8
Seting Tapak	9	Peraturan Kawalan Akses Halaman Web	10
Peranan Web	11	Akses Tapak Web	12
Penanda Tapak	13	Borang Asas	15
Metadata Borang Asas	16	Senarai	17
Keizinan Jadual	18	Borang Lanjutan	19
Langkah Borang Lanjutan	20	Metadata Borang Lanjutan	21
Peletakan Undian	24	Peletakan Iklan	26
Pengguna Bot	27	Profil Keizinan Lajur	28
Keizinan Lajur	29	Ubah Hala	30
Peraturan Peralihan Keadaan Penerbitan	31	Pintasan	32
Aliran Awan	33	Komponen UX	34

Rujukan penyelesaian templat EDM

Jalankan pac solution list --includeSystemSolutions untuk mengesahkan bahawa penyelesaian model data dipertingkatkan untuk templat laman telah dipasang.

templat	Nama unik penyelesaian EDM
Susun atur permulaan 1	DefaultPortalTemplate_V2
Susun atur permulaan 2	PowerPages_BlankDesign002_V2
Susun atur permulaan 3	PowerPages_BlankDesign003_V2
Susun atur permulaan 4	PowerPages_BlankDesign004_V2
Susun atur permulaan 5	PowerPages_BlankDesign005_V2
Halaman kosong	PowerPages_BlankTemplate_V2
FAQ	PowerPages_FAQ_V2
Pemprosesan aplikasi	PowerPages_BuildingPermit_V2
Pendaftaran program	PowerPages_ProgramRegistration_V2
Jadualkan dan urus mesyuarat	PowerPages_BookMeeting_V2
Portal Komuniti (Dynamics 365)	PowerPages_CommunityPortal_V2
Portal Self-Service Pelanggan (Dynamics 365)	PowerPages_CustomerPortal_V2
Portal Self-Service Pekerja (Dynamics 365)	PowerPages_ESSPortal_V2
Portal Rakan Kongsi (Dynamics 365)	PowerPages_PartnerPortal_V2

Maklum balas

Adakah halaman ini membantu?

Last updated on 2026-10-02

Gambaran keseluruhan migrasi model data standard ke dipertingkatkan

Prasyarat

Keupayaan utiliti migrasi

Templat yang disokong

Sebelum anda mula

Rancang urutan persekitaran

Cipta folder kerja

Fasa migrasi

Fasa 1: Pra-semakan

Fasa 2: Konfigurasi tapak

Laluan Penulisan: Pembangunan atau satu persekitaran

Laluan Hiliran: Ujian, UAT, atau pengeluaran

Fasa 3: Rekod berkaitan dan pengaktifan

Fasa 4: Sahkan tapak yang dimigrasi

Semak diagnostik pelayar

Kriteria penyelesaian migrasi

Urutan migrasi pengeluaran

Kembalikan tapak yang dimigrasikan ke model data standard

Penyelesaian masalah

Pertimbangan untuk penyesuaian laman web

Lajur tersuai pada jadual metadata

Hubungan antara jadual tersuai dan jadual metadata

Rujukan cecair kepada jadual metadata

Rujukan FetchXML kepada jadual metadata

Aliran kerja dan plug-in tersuai

Rujukan arahan

Rujukan jenis komponen tapak

Rujukan penyelesaian templat EDM

Kandungan berkaitan

Maklum balas

Sumber tambahan