ย้ายไซต์โมเดลข้อมูลมาตรฐานไปเป็นโมเดลข้อมูลที่ได้รับการปรับปรุง (พรีวิว)

[หัวข้อนี้คือเอกสารรุ่นก่อนวางจำหน่าย และอาจจะมีการเปลี่ยนแปลงในอนาคต]

ในบทความนี้ เรียนรู้วิธีย้ายไซต์โมเดลข้อมูลมาตรฐานที่คุณมีอยู่ไปเป็นโมเดลข้อมูลที่ได้รับการปรับปรุง

สำคัญ

• คุณลักษณะนี้เป็นคุณลักษณะพรีวิว
• คุณลักษณะการแสดงตัวอย่างไม่ได้มีไว้สำหรับการนำไปใช้งานจริง และอาจมีการจำกัดฟังก์ชันการทำงาน คุณลักษณะเหล่านี้สามารถใช้ได้ก่อนการเปิดตัวอย่างเป็นทางการ เพื่อให้ลูกค้าสามารถเข้าใช้งานได้ก่อนเวลาและให้ข้อคิดเห็น

ข้อกำหนดเบื้องต้น

• คุณต้องติดตั้ง Microsoft Power Platform CLI เวอร์ชัน 1.31.6 สูงกว่า เพื่อย้ายไซต์ของคุณไปใช้โมเดลข้อมูลที่ได้รับการปรับปรุง ข้อมูลเพิ่มเติม: ติดตั้ง Power Platform CLI รุ่นล่าสุด
• แพคเกจพอร์ทัลฐาน Dataverse 9.3.2307.x หรือสูงกว่า 
• แพคเกจหลัก Power Pages 1.0.2309.63 หรือสูงกว่า ข้อมูลเพิ่มเติม: อัปเดตโซลูชัน Power Pages
• คุณจะต้องเข้าใจวิธีใช้ Power Platform CLI ใน Power Pages เพื่อทำตามขั้นตอนการย้ายข้อมูลให้เสร็จสิ้น หากคุณไม่คุ้นเคยกับ Power Platform CLI ใน Power Pages คุณอาจต้องการอ่าน บทช่วยสอน Power Platform CLI นี้ และดูที่ คำสั่ง PAC CLI สำหรับการทำงานกับ Power Pages
• สําหรับสภาพแวดล้อมที่ตั้งค่า ในโหมดการดูแลระบบ ให้เปิดใช้งานการทํางานแบบเบื้องหลัง

ขั้นตอนที่ 1 ดาวน์โหลดและตรวจสอบการปรับแต่งสำหรับข้อมูลเมตาของไซต์มาตรฐานที่มีอยู่

1. เปิดพร้อมท์รับคำสั่ง

2. ใช้คำสั่งต่อไปนี้เพื่อตรวจสอบสิทธิ์องค์กร Dataverse สำหรับสภาพแวดล้อม Power Platform ของคุณ เพื่อดาวน์โหลดเรกคอร์ดเว็บไซต์สำหรับการย้าย

   pac auth create -u [Dataverse URL]

   ตัว อย่าง เช่น

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

   ข้อมูลเพิ่มเติม: pac auth create

3. ใช้คำสั่งต่อไปนี้เพื่อสร้างรายการเว็บไซต์ในองค์กรปัจจุบัน

   pac pages list

   ข้อมูลเพิ่มเติม: รายการหน้า PAC

4. ใช้คำสั่งต่อไปนี้เพื่อดาวน์โหลดรายงานการปรับแต่ง

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

   ตัว อย่าง เช่น

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

หากคุณพบการปรับแต่งใดๆ ในรายงานที่ดาวน์โหลด ให้ทำตามคำแนะนำในรายงานเพื่อแก้ไขหลังการย้ายข้อมูลเป็นโมเดลข้อมูลที่ได้รับการปรับปรุง ข้อมูลเพิ่มเติม: ข้อควรพิจารณาสำหรับการปรับแต่งไซต์เมื่อย้ายไซต์จากโมเดลข้อมูลมาตรฐานไปเป็นโมเดลข้อมูลที่ได้รับการปรับปรุง

ขั้นตอนที่ 2 ย้ายข้อมูลไซต์จากโมเดลข้อมูลมาตรฐานไปเป็นโมเดลข้อมูลที่ได้รับการปรับปรุง

ใช้คำสั่งต่อไปนี้เพื่อย้ายข้อมูลไซต์ของคุณไปเป็นโมเดลข้อมูลที่ได้รับการปรับปรุง

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

โหมด สามารถมีได้ 3 ค่า:

• configurationData: ย้ายข้อมูลเมตาสำหรับเว็บไซต์ ข้อมูลเพิ่มเติม: รายการของตารางที่จะจัดเก็บข้อมูลการกำหนดค่า

• configurationDataReferences: ย้ายข้อมูลธุรกรรมของเว็บไซต์ ข้อมูลเพิ่มเติม: รายการของตารางที่จะจัดเก็บข้อมูลที่ไม่ใช่การกำหนดค่า

• ทั้งหมด : ย้ายข้อมูลทั้งสองชนิด

ตัว อย่าง เช่น

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

เครื่องมือการย้ายจะตรวจสอบโซลูชันต่างๆ หากมีโซลูชันโมเดลข้อมูลมาตรฐานโดยไม่มีโซลูชันโมเดลจำลองข้อมูลที่ได้รับการปรับปรุงสำหรับเทมเพลตดังกล่าว คำเตือนจะปรากฏขึ้น: Found template <template-name>. One of the prerequisite for migrate needs Enchanged data model template

มีเทมเพลตเฉพาะ เช่น การลงทะเบียนโปรแกรม และกำหนดเวลาและจัดการการประชุม ซึ่งจำเป็นต้องมีแพคเกจโมเดลข้อมูลที่ได้รับการปรับปรุงที่ตรงกันเพื่อให้แน่ใจว่าเว็บไซต์ที่ย้ายมาทำงานได้อย่างถูกต้อง หากต้องการรับแพคเกจโมเลข้อมูลที่ได้รับการปรับปรุง คุณต้องสร้างไซต์ใหม่สำหรับเทมเพลตที่เกี่ยวข้อง (ควรเปิดใช้งานสภาพแวดล้อมสำหรับโมเดลข้อมูลที่ได้รับการปรับปรุง) เพื่อจัดเตรียมโซลูชันที่เข้ากันได้กับโมเดลข้อมูลที่ได้รับการปรับปรุงสำหรับการย้าย

เทมเพลตที่รองรับสำหรับการย้าย

ไซต์ที่มีเทมเพลตต่อไปนี้ได้รับการรองรับสำหรับการย้าย:

• เค้าโครงชุดเริ่มต้น 1-5
• การประมวลผลแอปพลิเคชัน
• เพจเปล่า
• การลงทะเบียนโปรแกรม
• กำหนดเวลาและจัดการการประชุม

ขั้นตอนที่ 3 ตรวจสอบสถานะการย้าย

ใช้คำสั่งต่อไปนี้เพื่อตรวจสอบสถานะการย้ายข้อมูลของไซต์ของคุณ:

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

ตัว อย่าง เช่น

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

หมายเหตุ

หากการย้ายไซต์ของคุณใช้เวลานานกว่าที่คาดไว้ อาจเป็นเพราะปริมาณข้อมูล หากพร้อมท์คำสั่งของคุณปิดลง ให้เปิดพร้อมท์คำสั่งใหม่แล้วใช้คำสั่งในขั้นตอนนี้เพื่อตรวจสอบสถานะของไซต์ของคุณ

ขั้นตอนที่ 4 อัปเดตเวอร์ชันโมเดลข้อมูลไซต์หลังจากการย้ายข้อมูลสำเร็จ

ใช้คำสั่งอัปเดตเวอร์ชันโมเดลข้อมูลไซต์ต่อไปนี้:

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

หมายเหตุ

• คุณสามารถค้นหารหัสพอร์ทัลได้โดยไปที่เว็บไซต์ที่มี '/_services/about' ต่อท้าย URL ของเว็บไซต์ หากต้องการดูตัวเลือกเหล่านี้ ผู้ใช้ควรมีบทบาทบนเว็บที่ได้รับการกำหนด สิทธิ์การเข้าถึงเว็บไซต์ ทั้งหมด
• หลังจากอัปเดตเวอร์ชันโมเดลข้อมูลไซต์แล้ว เรกคอร์ดของเว็บไซต์ที่เชื่อมโยงกับโมเดลข้อมูลมาตรฐานจะถูกปิดใช้งาน ไซต์จะอ้างอิงถึงเรกคอร์ดเว็บไซต์ที่เกี่ยวข้องกับโมเดลข้อมูลที่ได้รับการปรับปรุงแทน
• ผู้ใช้ควรมีบทบาทอย่างใดอย่างหนึ่งต่อไปนี้เพื่อเรียกใช้คำสั่งการย้ายข้อมูลกับอาร์กิวเมนต์ updateDatamodelVersion หรือ revertToStandardDataModel เนื่องจากการดำเนินการนี้จะทำการดำเนินการของผู้ดูแลระบบเพื่อเปลี่ยนไซต์ของคุณในการปรับปรุงโมเดลข้อมูลหรือในทางกลับกัน
  • ผู้ดูแลระบบ
  • ผู้ดูแลระบบ Dynamics 365
  • ผู้ดูแลระบบ Power Platform

ตัว อย่าง เช่น

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

แปลงกลับไซต์ที่ย้ายจากโมเดลข้อมูลที่ได้รับการปรับปรุงไปเป็นโมเดลข้อมูลมาตรฐาน

ใช้คำสั่งต่อไปนี้เพื่อแปลงกลับไซต์โมเดลข้อมูลมาตรฐานไปเป็นโมเดลข้อมูลที่ได้รับการปรับปรุงหลังการย้าย:

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

หมายเหตุ

เมื่อคุณสลับไซต์ที่ย้ายจากโมเดลข้อมูลที่ได้รับการปรับปรุงกลับไปเป็นโมเดลข้อมูลมาตรฐาน เรกคอร์ดของเว็บไซต์ที่เกี่ยวข้องกับโมเดลข้อมูลที่ได้รับการปรับปรุงจะถูกปิดใช้งาน และเรกคอร์ดของเว็บไซต์สำหรับโมเดลข้อมูลมาตรฐานจะถูกเปิดใช้งานอีกครั้ง

ตัว อย่าง เช่น

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

ย้ายข้อมูลไซต์ที่ใช้งานจริงจากโมเดลข้อมูลมาตรฐานไปเป็นโมเดลข้อมูลที่ได้รับการปรับปรุง

เราขอแนะนำให้สร้างสำเนาแบบเต็มของไซต์ที่ใช้งานจริงก่อนที่จะย้ายไซต์ที่ใช้งานจริง นอกจากนี้เรายังแนะนำให้ดำเนินการย้ายไซต์ที่ใช้งานจิงในช่วงระหว่างนอกเวลาทำการ

ใช้ขั้นตอนเหล่านี้เพื่อย้ายข้อมูลไซต์ที่ใช้งานจริงไปเป็นโมเดลข้อมูลที่ได้รับการปรับปรุง:

1. ลองใช้การย้ายข้อมูลบนไซต์ในสภาพแวดล้อมที่คัดลอกโดยใช้คำสั่ง PAC CLI migrate-datamodel
2. เพิ่มข้อมูลการกำหนดค่าไซต์ไปที่โซลูชันที่มีการจัดการ และนำเข้าสภาพแวดล้อมการทำงานจริง
3. ใช้คำสั่ง PAC CLI เพื่อย้ายข้อมูลที่ไม่ใช่การกำหนดค่าและทำให้เสร็จสิ้นโดยการอัปเดตเวอร์ชันโมเดลข้อมูลสำหรับการทำงานจริง

หมายเหตุ

สำหรับการย้ายข้อมูลรหัสเว็บไซต์ต้นทางและเว็บไซต์ที่ใช้งานจริงจะเหมือนกัน

ข้อควรพิจารณาสำหรับการปรับแต่งไซต์เมื่อย้ายไซต์จากโมเดลข้อมูลมาตรฐานไปเป็นโมเดลข้อมูลที่ได้รับการปรับปรุง

ส่วนนี้ให้คำแนะนำในการแก้ไขการปรับแต่งสำหรับการย้ายไซต์จากโมเดลข้อมูลมาตรฐานไปเป็นโมเดลข้อมูลที่ได้รับการปรับปรุง

การปรับแต่งไซต์ในตารางข้อมูลเมตา adx มีห้าแบบ:

• คอลัมน์ที่กำหนดเองในตารางข้อมูลเมตา adx
• ความสัมพันธ์ระหว่างตารางที่กำหนดเองกับตาราง adx
• การอ้างอิงตาราง Adx ในส่วนย่อยของโค้ด Liquid
• การอ้างอิงตาราง Adx ในการดึงข้อมูล xml
• เวิร์กโฟลว์และปลั๊กอินแบบกำหนดเองบนตาราง adx

หมายเหตุ

การแก้ไขที่เกี่ยวข้องกับการปรับแต่งทั้งหมดจะดำเนินการหลังจากการย้ายไปยังโมเดลข้อมูลที่ได้รับการปรับปรุง

คอลัมน์ที่กำหนดเองในตารางข้อมูลเมตา adx

หากต้องการแก้ไขการปรับแต่งนี้ในโมเดลข้อมูลที่ได้รับการปรับปรุง ให้สร้างความสัมพันธ์ระหว่างตารางระบบกับตารางที่กำหนดเองใหม่ และย้ายข้อมูลไปยังตารางใหม่

รูปแบบข้อมูลมาตรฐาน: ตาราง adx_webpage มีคอลัมน์ที่กำหนดเองเป็น contoso_pagetype

รูปแบบข้อมูลที่ได้รับการปรับปรุง: สร้างตารางใหม่ที่ชื่อ contoso_webpage ซึ่งจะรวมคอลัมน์ชื่อ contoso_pagetype และคอลัมน์การค้นหา contoso_webpage_id ที่เกี่ยวข้องกับ powerpagescomponent ใช้ พื้นที่ทำงานข้อมูล สำหรับการสร้างตาราง

ความสัมพันธ์ระหว่างตารางที่กำหนดเองกับตาราง adx

หากต้องการแก้ไขการปรับแต่งนี้ในโมเดลข้อมูลที่ได้รับการปรับปรุง ให้สร้างความสัมพันธ์ระหว่างตารางที่กำหนดเองกับตารางระบบ

รูปแบบข้อมูลมาตรฐาน: ตาราง adx_webpage มีความสัมพันธ์ชื่อ adx_webpage_contoso_pagelogs กับตาราง contoso_pagelogs

รูปแบบข้อมูลที่ได้รับการปรับปรุง: สร้างความสัมพันธ์ใหม่ที่ชื่อ powerpagecomponent_contoso_pagelogs กับตาราง contoso_webpage ใช้ พื้นที่ทำงานข้อมูล สำหรับการสร้างตาราง

การอ้างอิงตาราง Adx ในส่วนย่อยของโค้ด Liquid

หากต้องการแก้ไขการปรับแต่งนี้ในโมเดลข้อมูลที่ได้รับการปรับปรุง ให้แทนที่การอ้างอิงตาราง adx ในโค้ด Liquid ด้วยการอ้างอิง mspp ของ Virtual Tables ของโมเดลข้อมูลที่ได้รับการปรับปรุง หรือคุณสามารถใช้ตาราง ส่วนประกอบของไซต์ (ชื่อตรรกะ powerpagecomponent) พร้อมกับแอตทริบิวต์ ชนิดส่วนประกอบ (ชื่อตรรกะ powerpagecomponenttype) เพื่อดึงข้อมูลอ้างอิงที่เกี่ยวข้อง

รูปแบบข้อมูลมาตรฐาน: ใช้แท็ก Liquid entities เพื่อเข้าถึงค่า เว็บลิงก์ ในโค้ด {% assign app_weblinks= entities['adx_weblinks'] %}

รูปแบบข้อมูลที่ได้รับการปรับปรุง: แทนที่จะใช้เว็บลิงก์ผ่านแท็ก Liquid entities ให้ใช้ ออบเจ็กต์ Liquid ที่เกี่ยวข้อง entities[adx_weblinks] โดยตรง ในกรณีนี้ entities['adx_weblinks'] สามารถแทนที่ด้วยออบเจ็กต์ Liquid weblinks

การอ้างอิงตาราง Adx ในการดึงข้อมูล xml

หากต้องการแก้ไขการปรับแต่งนี้ในโมเดลข้อมูลที่ได้รับการปรับปรุง ให้แทนที่การอ้างอิงตาราง adx ในการดึงข้อมูล xml ด้วยการอ้างอิงโดยตรงของ Virtual Tables ของโมเดลข้อมูลที่ได้รับการปรับปรุง หรือคุณสามารถใช้ตาราง ส่วนประกอบของไซต์ (ชื่อตรรกะ powerpagecomponent) พร้อมกับแอตทริบิวต์ ชนิดส่วนประกอบ (ชื่อตรรกะ powerpagecomponenttype) เพื่อดึงข้อมูลอ้างอิงที่เกี่ยวข้อง

รูปแบบข้อมูลมาตรฐาน: ชื่อตาราง adx_webrole จะใช้ภายในการสอบถามดึงข้อมูล xml

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

รูปแบบข้อมูลที่ได้รับการปรับปรุง: ใช้ ส่วนประกอบของไซต์ (ชื่อตรรกะ powerpagecomponent) ร่วมกับแอตทริบิวต์ ชนิดส่วนประกอบ (ชื่อตรรกะ powerpagecomponenttype) เพื่อดึงข้อมูลอ้างอิงที่เกี่ยวข้อง

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

ชนิดและค่าส่วนประกอบของไซต์

ชนิดส่วนประกอบ	มูลค่า
สถานะการเผยแพร่	1
เว็บเพจ	2
ไฟล์เว็บ	3
ชุดเว็บลิงก์	4
ลิงก์ไปยังเว็บ	5
เทมเพลตเพจ	6
ส่วนย่อยของเนื้อหา	7
เทมเพลตเว็บ	8
การตั้งค่าไซต์	9
กฎการควบคุมการเข้าใช้เว็บเพจ	10
บทบาทเว็บ	11
การเข้าใช้เว็บไซต์	12
ตัวทำเครื่องหมายไซต์	13
ฟอร์มพื้นฐาน	15
เมตาดาต้าของฟอร์มพื้นฐาน	16
List	17
สิทธิ์ของตาราง	18
ฟอร์มขั้นสูง	19
ขั้นตอนของฟอร์มขั้นสูง	20
เมตาดาต้าของฟอร์มขั้นสูง	21
การกำหนดตำแหน่งการสำรวจ	24
การกำหนดตำแหน่งโฆษณา	26
ผู้ใช้งานบอท	27
โปรไฟล์สิทธิ์ของคอลัมน์	28
สิทธิ์ของคอลัมน์	29
เปลี่ยนเส้นทาง	30
กฎการเปลี่ยนสถานะการเผยแพร่	31
ทางลัด	32
โฟลว์ระบบคลาวด์	33
ส่วนประกอบ UX	34

เวิร์กโฟลว์และปลั๊กอินแบบกำหนดเองบนตาราง adx

เพื่อแก้ไขการปรับแต่งนี้ในโมเดลข้อมูลที่ปรับปรุงแล้ว ตรรกะของเวิร์กโฟลว์และปลั๊กอินจำเป็นต้องปรับโครงสร้างใหม่และลงทะเบียนใหม่บนตารางของไซต์ที่เกี่ยวข้อง

ตัวอย่างเช่น หากผู้ใช้ลงทะเบียนเวิร์กโฟลว์/ปลั๊กอินใน เอนทิตีหลัก เป็น เว็บเพจ (ชื่อตรรกะ adx_webpage) ในโมเดลข้อมูลมาตรฐาน ดังนั้นโค้ดภายในเวิร์กโฟลว์/ปลั๊กอินต้องแก้ไขเป็น ส่วนประกอบของไซต์ (ชื่อตรรกะ powerpagecomponent) และแอตทริบิวต์สำหรับโมเดลข้อมูลที่ได้รับการปรับปรุง

ปัญหาที่ทราบกันดี

คำสั่งการย้ายกำลังประมวลผลชุดงานเรกคอร์ด 5K เท่านั้นจากโมเดลข้อมูลมาตรฐานไปเป็นโมเดลข้อมูลที่ได้รับการปรับปรุง