เพิ่มส่วนประกอบของโค้ดลงในหน้าแบบกำหนดเองสำหรับแอปแบบจำลองของคุณ

บทความ
16/03/2566

บทความนี้สรุปการใช้ส่วนประกอบของโค้ดที่สร้างโดยนักพัฒนามืออาชีพโดยใช้ Power Apps component framework ภายในหน้าแบบกำหนดเอง สำหรับความสามารถในการเพิ่ม UX แบบกำหนดเองแบบเขียนโค้ดเล็กน้อย โปรดดูที่ เพิ่มส่วนประกอบพื้นที่ทำงานลงในหน้าแบบกำหนดเองสำหรับแอปแบบจำลองของคุณ

ข้อสำคัญ

หน้าแบบกำหนดเองเป็นคุณลักษณะใหม่ที่มีการเปลี่ยนแปลงผลิตภัณฑ์ที่สำคัญ และขณะนี้มีข้อจำกัดที่ทราบจำนวนหนึ่งซึ่งระบุไว้ใน ปัญหาที่ทราบของหน้าที่กำหนดเอง

หมายเหตุ

หน้าแบบกำหนดเองรองรับ component framework API ทั้งหมดที่ได้รับการสนับสนุนสำหรับแอปพื้นที่ทำงานในปัจจุบัน
API เฉพาะของแอปแบบจำลองบางอย่าง เช่น WebAPI และ การนำทาง ได้เผยแพร่การสนับสนุนแอปสำหรับหน้าแบบกำหนดเอง API เหล่านี้สามารถใช้ในส่วนประกอบของโค้ดสำหรับหน้าแบบกำหนดเองและทำงานบนแอปที่เผยแพร่ในขั้นสุดท้ายได้
สำหรับสถานะการสนับสนุน API แต่ละรายการในแต่ละแพลตฟอร์ม โปรดดูที่ การอ้างอิง API ของ Power Apps component framework

ส่วนประกอบของโค้ดช่วยให้นักพัฒนามืออาชีพสามารถสร้างส่วนประกอบโค้ดที่กำหนดเองเพื่อใช้ภายในแอปได้ กลไกความสามารถในการเพิ่มที่ใช้โค้ดระดับสูงนี้ให้การจัดการววงจรชีวิตของแอปพลิเคชันระดับเฟิร์สคลาส (ALM) เพื่อขยายส่วนประกอบที่มีให้สำหรับผู้ผลิตแอปทุกคนในองค์กรได้อย่างราบรื่น ส่วนประกอบของโค้ดสามารถนำมาใช้ซ้ำได้ในหน้าแบบกำหนดเอง พื้นที่ทำงาน และแอปแบบจำลอง ซึ่งสามารถอัปเดต บรรจุ และย้ายจากส่วนกลางได้โดยใช้โซลูชัน Microsoft Dataverse มาตรฐาน ข้อมูลเพิ่มเติม: ภาพรวม Power Apps Component Framework

การเปิดใช้งาน Power Apps component framework สำหรับหน้าแบบกำหนดเอง

หากต้องการใช้ส่วนประกอบของโค้ดภายในหน้าที่กำหนดเอง คุณต้องเปิดใช้งานคุณลักษณ Power Apps component framework ข้อมูลเพิ่มเติม: เปิดใช้งานคุณลักษณะ Power Apps component framework

สร้างส่วนประกอบของโค้ดเพื่อใช้ในหน้าแบบกำหนดเอง

ส่วนนี้สรุปวิธีการสร้าง นำเข้า และทดสอบส่วนประกอบของโค้ด

การสร้างและนำเข้าส่วนประกอบของโค้ดใน Dataverse

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

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

การนำเข้าและการใช้ส่วนประกอบของโค้ดในหน้าแบบกำหนดเอง

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

หมายเหตุ

หากแท็บรหัสไม่ปรากฏในบานหน้าต่าง นำเข้าส่วนประกอบตรวจสอบว่าเปิดใช้งานการตั้งค่าคุณลักษณะ Power Apps component framework สำหรับแอปพื้นที่ทำงานแล้ว ข้อมูลเพิ่มเติม: เปิดใช้งานคุณลักษณะ Power Apps component framework
นอกจากนี้ ตรวจสอบให้แน่ใจว่าคุณกำลังทำงานในรุ่นการเขียนแอปพื้นที่ทำงานล่าสุด

ส่วนประกอบของโค้ดที่เพิ่มใหม่อยู่ในขณะนี้ภายใต้ส่วน ส่วนประกอบของโค้ด สามารถเพิ่มลงในหน้าแบบที่กำหนดเองได้

ทดสอบส่วนประกอบของโค้ดภายในสตูดิโอและแอปที่เผยแพร่

เช่นเดียวกับแอปพื้นที่ทำงาน ส่วนประกอบของโค้ดเป็นแบบโต้ตอบและสามารถทดสอบได้ในสภาพแวดล้อมการสร้างสตูดิโอหน้าแบบกำหนดเอง อย่างไรก็ตาม API เฉพาะ เช่น Web APIs และ Navigation ซึ่งมีเฉพาะการรองรับรันไทม์ของหน้าแบบกำหนดเองเมื่อเรียกใช้ จะแสดงข้อความแสดงข้อผิดพลาด "ไม่ได้ใช้วิธีนี้"

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

ภาพด้านล่างแสดง การควบคุมตัวอย่าง API สำหรับเว็บ มาตรฐานและ การควบคุม API การนำทาง ที่เพิ่มไปยังหน้าแบบกำหนดเองที่ทำงานภายในแอปแบบจำลองที่เผยแพร่