หมายเหตุ
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลอง ลงชื่อเข้าใช้หรือเปลี่ยนไดเรกทอรีได้
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลองเปลี่ยนไดเรกทอรีได้
ใช้ซโค้ดต้นฉบับสำหรับแอปพื้นที่ทำงานเพื่อตรวจสอบการเปลี่ยนแปลงที่ทำโดยผู้สร้างใน Power Apps Studio โค้ด แอปพื้นที่ทำงาน YAML ที่สร้างขึ้นเป็นแบบอ่านอย่างเดียวและไม่สามารถแก้ไขได้ การเปลี่ยนแปลงใดๆ ในไฟล์จะถูกละเว้นและอาจสูญหาย
- สคีมา YAML อยู่ในระหว่างการพัฒนา และเนื้อหาอาจไม่สมบูรณ์
- Schema แบบคงที่ปัจจุบันสำหรับไฟล์ *.pa.yaml มีอยู่ที่นี่
Power Fx และ YAML เป็นภาษาที่ใช้สำหรับโค้ดต้นฉบับ Power Apps YAML มีคุณค่าสำหรับรูปแบบที่มนุษย์อ่านได้ และได้รับประโยชน์จากการบรรณาธิการ เครื่องมือ และไลบรารีที่หลากหลายสำหรับการจัดการ
เข้าถึงไฟล์ซอร์สโค้ด
คุณสามารถเข้าถึงไฟล์ซอร์สโค้ดได้หากคุณใช้ Power Platform Git Integration เพื่อขจัดความจําเป็นสําหรับไฟล์ .msapp
Power Apps Studio จะสร้างซอร์สโค้ดสำหรับแอปพื้นที่ทำงาน ซึ่งจัดเก็บเป็นไฟล์ *.pa.yaml ภายในไฟล์ .msapp ไฟล์ .msapp เป็นไฟล์ไบนารีที่มีคอลเลกชันของไฟล์ รวมถึงซอร์สโค้ด
เคล็ดลับ
หากต้องการใช้การจัดการวงจรชีวิตของแอปพลิเคชัน (ALM) อย่างมีประสิทธิภาพ ขอแนะนำให้ใช้โซลูชัน แพคเกจแอปพื้นที่ทำงาน ไม่รองรับ ALM และควรใช้สำหรับความสามารถในการนำเข้าและส่งออกขั้นพื้นฐานเมื่อ Dataverse ไม่พร้อมใช้งานเท่านั้น
คุณยังสามารถรับไฟล์ซอร์สโค้ดได้จากไฟล์ .msapp หรือโดยใช้ Power Platform CLI
ไฟล์ *.pa.yaml สามารถพบได้ในโฟลเดอร์ \Src ของ .msapp ที่ดึงข้อมูล
สำคัญ
เฉพาะไฟล์ที่อยู่ในไดเรกทอรี \Src ของ .msapp ที่ดึงข้อมูลเท่านั้นที่มีไว้สำหรับใช้กับตัวควบคุมต้นฉบับ ไม่ควรใช้ไฟล์ JSON ใน .msapp เป็นซอร์สโค้ด เนื่องจากไฟล์เหล่านั้นไม่เสถียรระหว่างรอบการบันทึกและการโหลด
ดาวน์โหลดและแตกไฟล์ pa.yaml โดยใช้ Power Platform CLI
เชื่อมต่อกับสภาพแวดล้อมของคุณโดยใช้ Power Platform CLI จากนั้นใช้คำสั่งต่อไปนี้:
- เมื่อต้องการแสดงรายการแอปพื้นที่ทำงานในสภาพแวดล้อมปัจจุบันของคุณ ให้ใช้คำสั่ง: pac canvas list
- เมื่อต้องการแยกไฟล์ซอร์สโค้ด ให้ใช้การคำสั่ง: pac canvas download พร้อม parameter -d
แยกไฟล์ซอร์สโค้ดจากไฟล์ .msapp
ในการแยกไฟล์ซอร์สโค้ดจากไฟล์ msapp คุณมีสองตัวเลือก:
- การสนับสนุนและ .msapp ด้วยตนเอง
- หรือคุณสามารถใช้คำสั่งต่อไปนี้:
Expand-Archive -Path "C:\path\to\yourFile.msapp" -DestinationPath "C:\path\to\destination"
โครงสร้างไฟล์สำหรับไฟล์ .msapp
สำหรับไฟล์ .msapp ที่เก่าว่าที่ไม่มีโฟลเดอร์ \src ให้ทำตามขั้นตอนเหล่านี้เพื่อสร้างไฟล์ซอร์สโค้ด:
- นำเข้าและบันทึกใหม่และดาวน์โหลด .msapp ใหม่ใน Power Apps Studio
- หลังจากนั้น คุณสามารถดำเนินการต่อเพื่อแตกไฟล์ซอร์สโค้ดได้
ในโฟลเดอร์ \src ค้นหาไฟล์และโฟลเดอร์ต่อไปนี้:
- App.pa.yaml: หมายถึงแอป
- [ชื่อหน้าจอ].pa.yaml: หนึ่งไฟล์สำหรับแต่ละหน้าจอ แสดงถึงหน้าจอ
- \Component: โฟลเดอร์ที่มีหนึ่งไฟล์สำหรับแต่ละส่วนประกอบ ซึ่งแสดงเป็น [ชื่อส่วนประกอบ].pa.yaml
เฉพาะไฟล์ *.pa.yaml ภายในโฟลเดอร์ \src เท่านั้นที่สามารถใช้เป็นซอร์สโค้ดได้ ไม่ควรใช้ไฟล์อื่นเป็นซอร์สโค้ด
เวอร์ชันของ Schema YAML ของ Power Apps
ในปัจจุบัน เวอร์ชัน Schema ที่ใช้งานอยู่ของรหัสแหล่งข้อมูล Power Apps เท่านั้นคือ Source Code (*.pa.yaml) ตารางต่อไปนี้แสดงรูปแบบอื่น ๆ ในอดีต:
| ชื่อรูปแบบ | นามสกุลของไฟล์ | Description |
|---|---|---|
| ทดลอง | *.fx.yaml | เกษียณ เวอร์ชันที่ใช้โดยการควบคุมเวอร์ชัน Git ของ Power Apps เชิงทดลองและ pac canvas unpack ซึ่งไม่อยู่ในระหว่างการพัฒนาอีกต่อไป |
| พรีวิวก่อนกำหนด | - | เกษียณ เวอร์ชันที่ใช้โดยมุมมองโค้ด คัดลอกโค้ด และวางโค้ด ไม่มีข้อมูลเวอร์ชันใน Schema นี้ |
| โค้ดต้นฉบับ | *ไฟล์ pa.yaml | ใช้งานอยู่ รวมถึงการเพิ่มประสิทธิภาพและรายละเอียดเวอร์ชันสําหรับตัวควบคุมแหล่งข้อมูล |
รูปแบบการทดลอง (*.fx.yaml)
Schema นี้ถูกเลิกใช้แล้ว
Schema นี้อธิบายรูปแบบการทดลองที่ Power Platform CLI ใช้ในการประมวลผลและแปลงแอปพื้นที่ทำงานเป็นรูปแบบโค้ดต้นฉบับ รูปแบบนี้ไม่ได้รับการพัฒนาอย่างแข็งขันอีกต่อไป
คุณไม่สามารถแปลงไฟล์ *.fx.yaml เป็นรูปแบบใหม่ได้โดยตรง หากต้องการแปลงแอปรุ่นเก่า ให้บรรจุแอปพื้นที่ทำงานเป็นไฟล์ .msapp แล้วนำเข้าลงใน Power Apps Studio
พรีวิว
Schema นี้ถูกเลิกใช้แล้ว
เวอร์ชันนี้ถูกใช้โดยมุมมองโค้ดในช่วงการแสดงตัวอย่าง ออกแบบมาเพื่อสร้างแอปพื้นที่ทำงานใน Power Apps Studio ซึ่งช่วยให้คุณคัดลอกและวางตัวควบคุมได้อย่างง่ายดาย ในเวอร์ชันนี้ โค้ดต้นฉบับถูกใช้ใน Power Apps Studio แทนการแปลง เช่น รูปแบบการทดลอง
รูปแบบระหว่างพรีวิวเป็นแบบชั่วคราวและไม่ได้ใช้งานอีกต่อไป คุณไม่สามารถวางโค้ดจากรูปแบบการแสดงตัวอย่างได้
นี่คือการเปลี่ยนแปลงที่เกิดจากรูปแบบการทดลอง:
- การลบคุณสมบัติ ZIndex: คุณสมบัติ ZIndex จะถูกลบออก หน้าจอจะแสดงเป็นอาร์เรย์ของตัวควบคุมแทน ลำดับของตัวควบคุมจะกำหนดลำดับการซ้อน การควบคุมปกติจะเรียงลำดับจากน้อยไปหามากในขณะที่การควบคุมที่ตอบสนองจะเรียงลำดับจากมากไปน้อย
- การแทนที่การแสดงผลออบเจ็กต์ JSON: ไวยากรณ์ "As" ไม่ถูกใช้เพื่อกำหนดชนิดตัวควบคุมอีกต่อไป ด้านซ้ายของตัวระบุชื่อของตัวควบคุมจะยังคงไม่ซ้ำกัน เฉพาะคุณสมบัติที่แตกต่างจากค่าเริ่มต้นเท่านั้นที่จะถูกทำให้เป็นอนุกรม คุณสมบัติใหม่สองอย่างกำหนดชนิดตัวควบคุมและค่าเริ่มต้น:
- การควบคุม: แสดงถึงชนิดตัวควบคุมใน YAML
- รูปแบบย่อย: ระบุรูปแบบย่อยของชนิดตัวควบคุม ซึ่งอาจเปลี่ยนแปลงค่าคุณสมบัติเริ่มต้น เพิ่มหรือเอาคุณสมบัติออก หรือปรับเปลี่ยนลักษณะการทำงานหรือเค้าโครงของตัวควบคุม
คุณสมบัติเหล่านี้ใช้สำหรับการสร้างอินสแตนซ์ตัวควบคุมและไม่ยอมรับนิพจน์ Power Fx
ซอร์สโค้ด (*.pa.yaml)
สำคัญ
- โค้ดต้นฉบับ YAML สำหรับแอปพื้นที่ทำงานกำลังได้รับการพัฒนาอย่างจริงจัง เนื้อหาอาจไม่สมบูรณ์และอาจเปลี่ยนแปลงได้
- ไฟล์ pa.yaml เป็นแบบอ่านอย่างเดียวและควรใช้เพื่อตรวจสอบการเปลี่ยนแปลงที่ทำใน Power Apps Studio เท่านั้น ไฟล์เหล่านี้จะไม่ถูกใช้เมื่อกำลังโหลดแอป
- การแก้ไขภายนอก การผสาน และการแก้ปัญหาความขัดแย้งได้รับการสนับสนุนเฉพาะใน Power Platform Git Integration เท่านั้น
Schema นี้ออกแบบมาเพื่อวัตถุประสงค์ในตัวควบคุมต้นฉบับและอนุญาตให้ใช้ไฟล์ YAML ไฟล์เดียว
การอัปเดตจากรูปแบบก่อนหน้า ได้แก่:
- การจัดกลุ่มองค์ประกอบโหนดระดับบนสุด:
- คำหลักระดับบนสุด "แอป" และ "หน้าจอ" เป็นตัวอย่างของการจัดกลุ่มองค์ประกอบในโหนดระดับบนสุด
- ข้อกำหนดเวอร์ชันตัวควบคุม:
- ตอนนี้คุณสามารถระบุเวอร์ชันของตัวควบคุมได้โดยใช้คำสำคัญตัวควบคุม ตามด้วยตัวดำเนินการ @ หากไม่มีการระบุเวอร์ชัน จะใช้ตัวควบคุมเวอร์ชันล่าสุด เวอร์ชันนี้ใช้เพื่อดีซีเรียลไลซ์คุณสมบัติของโค้ดต้นฉบับ เวอร์ชันรันไทม์ของตัวควบคุมถูกกำหนดโดยเวอร์ชันการสร้าง
- ชื่อตัวแปรแบบง่าย:
- ตัวควบคุมบางอย่างไม่จำเป็นต้องมีตัวแปร
- ZIndex ที่สอดคล้องกันสำหรับตัวควบคุมทั้งหมด:
- ตอนนี้ตัวควบคุมทั้งหมดใช้ลำดับจากน้อยไปมากเพื่อกำหนดค่า ZIndex โดยเริ่มจาก 1 ลักษณะการทำงานนี้สอดคล้องกับข้อมูลจำเพาะ CSS 2