พื้นที่ทํางาน pac

ทํางานกับไฟล์ .msapp ของ Power Apps

[บทความนี้เป็นคู่มือรุ่นก่อนวางจำหน่าย และอาจจะมีการเปลี่ยนแปลงในอนาคต]

สําคัญ

• ไม่สนับสนุนpackคําสั่ง และunpack
• หากต้องการควบคุมแหล่งที่มาของแอปพื้นที่ทํางาน ให้ใช้ Power Platform Git Integration
• คําสั่ง create พร้อมใช้งานโดยทั่วไปแล้ว

คำสั่ง

Command	คำอธิบาย
สร้างพื้นที่ทํางาน pac	สร้างแอปพื้นที่ทํางานจากตัวเชื่อมต่อแบบกําหนดเอง
ดาวน์โหลดพื้นที่ทํางาน pac	ดาวน์โหลดแอปพื้นที่ทํางานเป็นไฟล์ .msapp
รายการพื้นที่ทํางาน pac	สร้างรายการแอปพื้นที่ทํางาน
แพคพื้นที่ทํางาน pac	(ตัวอย่าง) แพ็คแหล่งข้อมูลลงในไฟล์ msapp
unpack พื้นที่ทํางาน pac	(ตัวอย่าง) แยกไฟล์ msapp ลงในแหล่งข้อมูล
ตรวจสอบพื้นที่ทํางาน pac	(ตัวอย่าง) ตรวจสอบแหล่งข้อมูล .pa.yaml สําหรับไฟล์ msapp ที่คลายซิป

สร้างพื้นที่ทํางาน pac

สร้างแอปพื้นที่ทํางานจากตัวเชื่อมต่อแบบกําหนดเอง

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

ผู้สร้างสามารถนําเข้าที่สร้างขึ้น .msapp ลงใน Power Apps Studio เพื่อเล่นแอป หรือแก้ไขและทําการกําหนดค่าเพิ่มเติมได้ นําเข้าแอปที่สร้างขึ้นไปยัง Power Apps Studio โดยนําทางไปยัง ไฟล์>เปิด>เรียกดู ภายใน Studio

ตัวอย่าง

ตัวอย่างต่อไปนี้แสดงการใช้ pac canvas create คําสั่ง

• สร้างแอปพื้นที่ทํางานโดยยึดตาม Open API Definition ตามชื่อที่แสดง
• สร้างแอปพื้นที่ทํางานที่ยึดตามข้อกําหนด API เปิดตาม id

สร้างแอปพื้นที่ทํางานโดยยึดตาม Open API Definition ตามชื่อที่แสดง

ตัวอย่างนี้สร้างแอปพื้นที่ทํางาน (เป็นไฟล์ *.msapp) โดยยึดตาม Open API Definition โดยใช้ชื่อที่แสดงของตัวเชื่อมต่อ

pac canvas create --msapp HelloWorld.msapp --connector-display-name "My Custom Connector"

สร้างแอปพื้นที่ทํางานที่ยึดตามข้อกําหนด API เปิดตาม id

ตัวอย่างนี้สร้างแอปพื้นที่ทํางาน (เป็นไฟล์ *.msapp) โดยยึดตาม Open API Definition โดยใช้ ID ของตัวเชื่อมต่อ

pac canvas create --msapp HelloWorld.msapp --connector-id 00000000-0000-0000-0000-000000000000

จําเป็นต้องมี connector-display-name หรือconnector-id

พารามิเตอร์ที่จําเป็นสําหรับการสร้างพื้นที่ทํางาน

--msapp

เส้นทางไปยังไฟล์ .msapp ที่จะถูกสร้างขึ้น

พารามิเตอร์ตัวเลือกสําหรับการสร้างพื้นที่ทํางาน

--connector-display-name

ชื่อที่แสดงของตัวเชื่อมต่อเพื่อสร้าง Power App

--connector-id

ID ของตัวเชื่อมต่อเพื่อสร้าง Power App

--environment

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

หมายเหตุ

ข้อควรพิจารณาและข้อจํากัด:

• ตัวเชื่อมต่อแบบกําหนดเองที่อ้างอิงกับconnector-display-nameพารามิเตอร์ หรือ connector-id ต้องเป็นส่วนหนึ่งของโซลูชัน
• หลังจากนําเข้าแอปไปยัง Studio จะไม่มีการเชื่อมโยงไปยังตัวเชื่อมต่อแบบกําหนดเอง ผู้สร้างต้องเพิ่มการอ้างอิงด้วยตนเองไปยังตัวเชื่อมต่อแบบกําหนดเองที่สร้างแอปก่อนสามารถเล่นแอปได้ ดู เพิ่มการเชื่อมต่อข้อมูลไปยังแอปพื้นที่ทํางาน สําหรับขั้นตอน จนกว่าการดําเนินการนี้จะเสร็จสิ้น คุณอาจเห็นข้อผิดพลาดของสูตรในแอปซึ่งจะแก้ไขเมื่อมีการเพิ่มการอ้างอิงตัวเชื่อมต่อ ชื่อของตัวเชื่อมต่อแบบกําหนดเองที่คุณเพิ่มลงในแอปต้องตรงกับชื่อที่แสดงของตัวเชื่อมต่อแบบกําหนดเองที่อ้างอิงใน canvas create คําสั่ง
• แอปจะประกอบด้วยหน้าจอหนึ่งหน้าจอสําหรับแต่ละ POST และ GET การดําเนินการที่ตัวเชื่อมต่อกําหนด
  • คํากริยาอื่น ๆ ที่พร้อมใช้งานในตัวเชื่อมต่อแบบกําหนดเองไม่ได้รับการสนับสนุน
• ตัวควบคุมที่แสดงบนหน้าจอของแต่ละการดําเนินการจะถูกสร้างขึ้นแบบไดนามิกตามวิธีการกําหนดชนิดอินพุตและเอาท์พุตของแต่ละการดําเนินการ ข้อมูลเข้าและเอาท์พุตบางชนิดที่กําหนดไว้ในตัวเชื่อมต่อแบบกําหนดเองไม่ได้รับการสนับสนุนโดยcanvas create คําสั่งจะสร้างคําเตือนในคอนโซลเมื่อสิ่งเหล่านี้จะพบ กรณีเฉพาะ:
  • อาร์เรย์ของวัตถุและอาร์เรย์ของอาร์เรย์ไม่ได้รับการสนับสนุนเป็นข้อมูลป้อนเข้า
  • ตัวควบคุมไม่ได้ถูกสร้างขึ้นสําหรับวัตถุหรืออาร์เรย์ที่ซ้อนกันเกินความลึก 20
  • ชนิด "ไฟล์" และ "รูปแบบไบนารี" ไม่ได้รับการรองรับสําหรับอินพุตหรือเอาต์พุต

ดาวน์โหลดพื้นที่ทํางาน pac

ดาวน์โหลดแอปพื้นที่ทํางานเป็นไฟล์ .msapp

พารามิเตอร์ที่จําเป็นสําหรับการดาวน์โหลดพื้นที่ทํางาน

--name -n

แอปพื้นที่ทํางานที่แน่นอน ชื่อบางส่วน หรือ ID แอป

พารามิเตอร์ตัวเลือกสําหรับการดาวน์โหลดพื้นที่ทํางาน

--environment -env

ระบุ Dataverse เป้าหมาย ค่าอาจเป็น Guid หรือ https URL แบบสัมบูรณ์ เมื่อไม่ได้ระบุ องค์กรที่ใช้งานอยู่ที่เลือกสําหรับโพรไฟล์การรับรองความถูกต้องปัจจุบันจะถูกใช้

--extract-to-directory -d

ชื่อไดเรกทอรีที่จะแยกแอปพื้นที่ทํางานไปยัง

--file-name -f

ชื่อไฟล์ (โดยปกติจะมีนามสกุล .msapp) ถ้าไม่มีไฟล์ถูกบันทึกในไดเรกทอรีปัจจุบันด้วย 'appname'.msapp

--overwrite -o

อนุญาตให้เขียนทับไฟล์

พารามิเตอร์นี้ไม่จําเป็นต้องมีค่า มันเป็นการสลับ

รายการพื้นที่ทํางาน pac

สร้างรายการแอปพื้นที่ทํางาน

พารามิเตอร์ที่เลือกได้สําหรับรายการพื้นที่ทํางาน

--environment -env

ระบุ Dataverse เป้าหมาย ค่าอาจเป็น Guid หรือ https URL แบบสัมบูรณ์ เมื่อไม่ได้ระบุ องค์กรที่ใช้งานอยู่ที่เลือกสําหรับโพรไฟล์การรับรองความถูกต้องปัจจุบันจะถูกใช้

แพคพื้นที่ทํางาน pac

(ตัวอย่าง) แพ็คแหล่งข้อมูลลงในไฟล์ msapp

ตัวอย่าง

pac canvas pack --sources MyHelloWorldFiles --msapp HelloWorld.msapp

พารามิเตอร์ที่จําเป็นสําหรับชุดพื้นที่ทํางาน

--msapp

เส้นทางไปยังไฟล์ .msapp

--sources

ไดเรกทอรีไปยังแหล่งข้อมูลที่จะรวบรวม

หมายเหตุ

.msappสร้างไฟล์จากไฟล์ต้นฉบับที่ยังไม่ได้บรรจุก่อนหน้านี้ คุณสามารถเปิดผลลัพธ์ใน Power Apps Studio ได้โดยนําทางไปยังไฟล์>เปิด>เรียกดู

หลังจากยกเลิกการบรรจุ ไฟล์ต้นฉบับสามารถแก้ไข และจัดการด้วยเครื่องมือภายนอกเช่น Visual Studio Code และ GitHub

unpack พื้นที่ทํางาน pac

(ตัวอย่าง) แยกไฟล์ msapp ลงในแหล่งข้อมูล

ตัวอย่าง

pac canvas unpack --msapp HelloWorld.msapp --sources MyHelloWorldFiles

pac canvas unpack --msapp HelloWorld.msapp

ยกเลิกการบรรจุไปยังไดเรกทอรีเริ่มต้นHelloWorld_src

พารามิเตอร์ที่จําเป็นสําหรับ unpack พื้นที่ทํางาน

--msapp

เส้นทางไปยังไฟล์ .msapp

พารามิเตอร์ตัวเลือกสําหรับพื้นที่ทํางาน unpack

--sources

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

หมายเหตุ

ถอนการ .msapp บรรจุไฟล์ต้นฉบับ

.msappดาวน์โหลดไฟล์จาก Power Apps Studio โดยนําทางไปยังไฟล์>บันทึกเป็น>คอมพิวเตอร์เครื่องนี้

ถ้าไม่ได้ระบุพารามิเตอร์ แหล่งที่มา ไดเรกทอรีที่มีชื่อและตําแหน่งที่ตั้งเดียวกันกับ .msapp ไฟล์จะถูกใช้กับ _src คําต่อท้าย

โครงสร้างโฟลเดอร์

คุณสมบัติ Unpack และ pack ใช้โครงสร้างโฟลเดอร์ต่อไปนี้:

• \src - แฟ้มตัวควบคุมและคอมโพเนนต์ ซึ่งประกอบด้วยแหล่งข้อมูล
  • *.fx.yaml - สูตรที่แยกจาก control.json ไฟล์

    Note

    นี่คือตําแหน่งสําหรับแก้ไขสูตรของคุณ

  • CanvasManifest.json - ไฟล์รายชื่อแฟ้มที่ประกอบด้วยข้อมูลปกติในส่วนหัว คุณสมบัติ และ publishInfo
  • *.json - ไฟล์ดิบcontrol.json
  • \EditorState*.editorstate.json - ข้อมูลที่แคชไว้สําหรับ Power Apps Studio ที่จะใช้
• \DataSources - แหล่งข้อมูลทั้งหมดที่ใช้โดยแอป
• \Connections - อินสแตนซ์การเชื่อมต่อที่บันทึกกับแอปและใช้เมื่อโหลดลงใน Power Apps Studio อีกครั้ง
• \Assets - ไฟล์สื่อที่ฝังในแอป
• \pkgs - สําเนาที่ดาวน์โหลดของการอ้างอิงภายนอก เช่น เทมเพลต ไฟล์ข้อกําหนด API และไลบรารีคอมโพเนนต์ คล้ายกับการอ้างอิง NuGet/NPM
• \other - ไฟล์เบ็ดเตล็ดทั้งหมดจําเป็นต้องสร้าง .msappใหม่
  • entropy.json - องค์ประกอบเปลี่ยนแปลงได้ (เช่นประทับเวลา) จะถูกแยกไปยังไฟล์นี้ สิ่งนี้ช่วยลดความแตกต่างของเสียงดังในไฟล์อื่น ๆ ในขณะที่ทําให้แน่ใจว่าเราสามารถไปกลับได้
  • จัดเก็บไฟล์อื่น ๆ จาก msapp เช่น สิ่งที่อยู่ใน \rข้อผิดพลาด

รูปแบบไฟล์

ไฟล์.fx.yamlใช้ชุดย่อยของ YAML คล้ายกับ Excel นิพจน์ทั้งหมดควรเริ่มต้นด้วยเครื่องหมาย =เท่ากับ ข้อมูลเพิ่มเติม: ไวยากรณ์สูตร Power Fx YAML

ผสานการเปลี่ยนแปลงกับ Power Apps Studio

เมื่อผสานการเปลี่ยนแปลงที่เกิดขึ้นในเซสชัน Power Apps Studio ที่แตกต่างกันสองเซสชัน:

• ตรวจสอบให้แน่ใจว่าชื่อตัวควบคุมทั้งหมดไม่ซ้ํากัน ตัวอย่างเช่น การแทรกปุ่มในเซสชันที่แตกต่างกันสองเซสชันอาจส่งผลให้มีตัวควบคุมสอง Button1 ตัว เราขอแนะนําให้คุณตั้งชื่อตัวควบคุมในเร็ว ๆ นี้หลังจากที่คุณสร้างตัวควบคุมเหล่านั้น เครื่องมือไม่ยอมรับตัวควบคุมสองตัวที่มีชื่อเดียวกัน
• สําหรับไฟล์เหล่านี้ ให้รวมไฟล์เหมือนที่คุณทําตามปกติ:
  • \src*.fx.yaml
• หากมีข้อขัดแย้งหรือข้อผิดพลาด คุณสามารถลบไฟล์เหล่านี้ได้:
  • \src\editorstate*.json - ไฟล์เหล่านี้ประกอบด้วยข้อมูลเพิ่มเติมใน Power Apps Studio
  • เปิด \other\entropy.js
• สําหรับข้อขัดแย้งใด ๆ ในไฟล์เหล่านี้ คุณสามารถยอมรับเวอร์ชันล่าสุดได้:
  • เปิด \checksum.js
• ถ้ามีข้อขัดแย้งในการผสานใดๆ ภายใต้เส้นทางเหล่านี้ จะไม่ปลอดภัยที่จะผสาน แจ้งให้เราทราบว่าเหตุการณ์นี้เกิดขึ้นบ่อยหรือไม่ เราจะทํางานเกี่ยวกับการจัดโครงสร้างรูปแบบไฟล์ใหม่เพื่อหลีกเลี่ยงความขัดแย้ง
  • \คน รู้จัก*
  • \DataSources*
  • \pkgs*
  • CanvasManifest.json

โอเพนซอร์ส

คําสั่งพื้นที่ทํางานใน Microsoft Power Platform CLI เป็นโอเพนซอร์ส พูดคุยเกี่ยวกับการปรับปรุง เพิ่มปัญหา และเข้าถึงโค้ดจากที่เก็บเครื่องมือภาษาของ Power Apps

ตรวจสอบพื้นที่ทํางาน pac

(ตัวอย่าง) ตรวจสอบแหล่งข้อมูล .pa.yaml สําหรับไฟล์ msapp ที่คลายซิป

พารามิเตอร์ที่จําเป็นสําหรับการตรวจสอบพื้นที่ทํางาน

--directory -d

เส้นทางไปยังไดเรกทอรี msapp ที่แยกออกมาที่มีไฟล์ .pa.yaml เพื่อตรวจสอบ

ดูเพิ่มเติม

กลุ่มคําสั่ง Microsoft Power Platform CLI
ภาพรวม Microsoft Power Platform CLI