หมายเหตุ
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลอง ลงชื่อเข้าใช้หรือเปลี่ยนไดเรกทอรีได้
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลองเปลี่ยนไดเรกทอรีได้
API สินค้าคงคลังของ Power Platform มีข้อมูลสินค้าคงคลังในปัจจุบันผ่าน PowerPlatformResources ตารางใน Azure Resource Graph API ประกอบด้วยข้อมูลทรัพยากรหลัก ความเป็นเจ้าของ สภาพแวดล้อม และตัวเชื่อมต่อ แต่สคีมาของ API แตกต่างจากสคีมาของสินค้าคงคลังการส่งออกข้อมูล
บทความนี้อธิบาย:
- ข้อมูลสินทรัพย์คงคลังที่พร้อมใช้งานผ่าน API สินทรัพย์คงคลังของ Power Platform
- คุณสมบัติสินค้าคงคลังสำหรับการส่งออกข้อมูลที่ไม่พร้อมใช้งาน
- ทรัพย์สินที่มีความคุ้มครองบางส่วนหรือแตกต่างกัน
สําหรับข้อมูลเกี่ยวกับการคิวรีสินค้าคงคลัง โปรดดู API ของ Power Platform inventory สำหรับสคีมา API ที่สมบูรณ์ โปรดดู ข้อมูลอ้างอิงสคีมารายการของ Power Platform
Note
Microsoft จะเลิกใช้เวอร์ชันแสดงตัวอย่างของการส่งออกข้อมูล การส่งออกข้อมูลสินค้าคงคลังจะหยุดลงหลังจากวันที่ 1 ธันวาคม 2026 การส่งออกข้อมูลการใช้งานและสภาพแวดล้อมดําเนินการต่อไปผ่านการกําหนดค่าที่มีอยู่และการกําหนดค่าใหม่และข้อมูลที่คุณส่งออกแล้วยังคงอยู่ใน data lake ของคุณ คุณจะได้รับการแจ้งเตือนอีกครั้งจาก Microsoft เมื่อการส่งออกข้อมูลสินค้าคงคลังหยุดลง
เพื่อเตรียมพร้อม ให้ใช้ Power Platform inventory API เพื่อส่งออกข้อมูลสินทรัพย์ในระบบทางโปรแกรม ก่อนที่คุณจะโยกย้าย ให้ตรวจสอบ การแมปเขตข้อมูลและข้อจำกัดที่ทราบแล้ว ฟิลด์สินค้าคงคลังในการส่งออกข้อมูลบางรายการไม่พร้อมใช้งานผ่าน API หรือมีขอบเขตข้อมูลที่แตกต่างกัน
API สินค้าคงคลังของ Power Platform ไม่ส่งออกข้อมูลไปยังที่เก็บข้อมูลของลูกค้าเองโดยอัตโนมัติ หากต้องการสร้างการส่งออกที่เป็นกิจวัตร ให้ใช้บริการ Azure เช่น ฟังก์ชัน Azure, Azure Logic Apps หรือ Azure Automation เพื่อคิวรี API สินค้าคงคลังของ Power Platform ตามกําหนดการและเขียนผลลัพธ์ไปยัง Azure Blob Storage, Azure Data Lake Storage หรือปลายทางอื่นที่รองรับ
ชนิดทรัพยากรที่ได้รับการสนับสนุน
API รายการของ Power Platform ประกอบด้วยชนิดทรัพยากรต่อไปนี้:
| ทรัพยากร | ประเภท API ของ Power Platform |
|---|---|
| แอป Canvas | microsoft.powerapps/canvasapps |
| แอปที่ขับเคลื่อนด้วยโมเดล | microsoft.powerapps/modeldrivenapps |
| แอปโค้ด | microsoft.powerapps/codeapps |
| แอปที่มีการจัดการและตัวสร้างแอป | microsoft.powerapps/apps |
| การทำงานในระบบคลาวด์ | microsoft.powerautomate/cloudflows |
| โฟลว์ของเอเจนต์ | microsoft.powerautomate/agentflows |
| การทำงานโดยตัวแทนในเวิร์กโฟลว์ | microsoft.powerautomate/m365agentflows |
| เจ้าหน้าที่ Copilot Studio | microsoft.copilotstudio/agents |
| ตัวเชื่อมต่อ | microsoft.powerplatformconnector/connectors |
| Environments | microsoft.powerplatform/environments |
| กลุ่มสภาพแวดล้อม | microsoft.powerplatform/environmentgroups |
ข้อมูลสินค้าคงคลังที่พร้อมใช้งาน
ส่วนต่อไปนี้อธิบายเขตข้อมูลที่พร้อมใช้งานตามชนิดทรัพยากรและประเภทข้อมูล
- ข้อมูลทรัพยากรที่ใช้ร่วมกัน
- ข้อมูลแอป
- ข้อมูลโฟลว์
- การใช้ตัวเชื่อมต่อ
- ข้อมูลแค็ตตาล็อกตัวเชื่อมต่อ
- ข้อมูลสภาพแวดล้อม
ข้อมูลทรัพยากรที่ใช้ร่วมกัน
เขตข้อมูลต่อไปนี้จะพร้อมใช้งานสําหรับชนิดทรัพยากรที่ได้รับการสนับสนุน ตัวเชื่อมต่อเป็นเอนทิตีแค็ตตาล็อกและสนับสนุนเฉพาะเขตข้อมูลที่ใช้ร่วมกันที่ระบุในการอ้างอิงสคีมาสินค้าคงคลัง
| ประเภทข้อมูล | ข้อมูลที่มีอยู่ | เขตข้อมูล API รายการของ Power Platform |
|---|---|---|
| รหัสทรัพยากร | ตัวระบุทรัพยากรสินค้าคงคลังที่ไม่ซ้ํากัน | name |
| ชื่อทรัพยากร | ชื่อที่แสดงของทรัพยากร | properties.displayName |
| ชนิดของทรัพยากร | ประเภททรัพยากรของ Power Platform ที่ได้มาตรฐาน | type |
| ผู้เช่า | ตัวระบุผู้เช่า | tenantId |
| สถานที่ | ตําแหน่งที่ตั้งทางภูมิศาสตร์ของทรัพยากร | location |
| วันที่สร้าง | วันที่และเวลาที่สร้างทรัพยากร | properties.createdAt |
| สร้างโดย | ID ออบเจ็กต์ของผู้ใช้ที่สร้างทรัพยากร | properties.createdBy |
ข้อมูลแอป
ข้อมูลต่อไปนี้จะพร้อมใช้งานสําหรับชนิดแอปที่สนับสนุน
| ประเภทข้อมูล | ข้อมูลที่ใช้ได้ | เขตข้อมูล API รายการของ Power Platform |
|---|---|---|
| เจ้าของ | ID ออบเจ็กต์ของเจ้าของแอป | properties.ownerId |
| Environment | ตัวระบุของสภาพแวดล้อมที่มีแอป | properties.environmentId |
| การปรับเปลี่ยนครั้งล่าสุด | วันที่และเวลาที่แอปถูกแก้ไขครั้งล่าสุด | properties.lastModifiedAt |
| แก้ไขล่าสุดโดย | ID ออบเจ็กต์ของผู้ใช้ที่ปรับเปลี่ยนแอปครั้งล่าสุด | properties.lastModifiedBy |
| สถานะกักกัน | แอปถูกกักกันหรือไม่ | properties.isQuarantined |
| ID แอปแบบจำลอง | ตัวระบุโมดูลแอป Dataverse | properties.appModuleId |
| ชื่อตรรกะของแอปแบบจำลองเป็นหลัก | ชื่อตรรกะของ Dataverse | properties.logicalName |
| ประเภทย่อยของโค้ดแอป |
byocApp หรือ vibeApp |
properties.subType |
| ชนิดย่อยของแอปที่มีการจัดการ | microsoftApp |
properties.subType |
| ชนิดย่อยของ App Builder | appBuilderApp |
properties.subType |
ข้อมูลขั้นตอนการทำงาน
ข้อมูลต่อไปนี้จะพร้อมใช้งานสำหรับโฟลว์ระบบคลาวด์, โฟลว์ตัวแทน และโฟลว์เอเจนต์เวิร์กโฟลว์
| ประเภทข้อมูล | ข้อมูลที่พร้อมใช้งาน | เขตข้อมูล API inventory ของ Power Platform |
|---|---|---|
| เจ้าของ | ID ออบเจ็กต์ของเจ้าของโฟลว์ | properties.ownerId |
| Environment | ตัวระบุของสภาพแวดล้อมที่มีโฟลว์ | properties.environmentId |
| การปรับเปลี่ยนครั้งล่าสุด | วันที่และเวลาที่ปรับเปลี่ยนโฟลว์ครั้งล่าสุด | properties.lastModifiedAt |
| แก้ไขล่าสุดโดย | ID ออบเจ็กต์ของผู้ใช้ที่ปรับเปลี่ยนโฟลว์ครั้งล่าสุด | properties.lastModifiedBy |
| เอนทิตีของเวิร์กโฟลว์ | ตัวระบุเอนทิตีเวิร์กโฟลว์ Dataverse | properties.workflowEntityId |
| ตัวเชื่อมต่อ Trigger | ตัวเชื่อมต่อที่เริ่มต้นโฟลว์ | properties.trigger |
| เรียกใช้การดำเนินการ | การดำเนินการของตัวเชื่อมต่อที่เริ่มต้นโฟลว์ | properties.triggerOperation |
เขตข้อมูลทริกเกอร์จะว่างเปล่าเมื่อโฟลว์ใช้ทริกเกอร์ที่ไม่ใช่ตัวเชื่อมต่อ เช่น การเรียกซ้ำหรือทริกเกอร์ด้วยตนเอง
การใช้ตัวเชื่อมต่อ
การใช้ตัวเชื่อมต่อจะพร้อมใช้งานสําหรับแอป โฟลว์ และตัวแทนที่รองรับ
| ประเภทข้อมูล | ข้อมูลที่พร้อมใช้งาน | เขตข้อมูล API สินค้าคงคลังของ Power Platform |
|---|---|---|
| ตัวเชื่อมต่อที่ใช้ | ตัวระบุของตัวเชื่อมต่อที่ใช้โดยทรัพยากร | properties.powerPlatformConnectors[].connectorId |
| การดำเนินการที่ใช้ | ตัวระบุของการดําเนินการที่เรียกใช้บนตัวเชื่อมต่อ | properties.powerPlatformConnectors[].operations[].operationId |
| ทริกเกอร์โฟลว์ | ตัวเชื่อมต่อที่เริ่มต้นโฟลว์ที่ได้รับการสนับสนุน | properties.trigger |
| การดำเนินการของทริกเกอร์โฟลว์ | การดําเนินการเชื่อมต่อที่เริ่มต้นโฟลว์ที่ได้รับการสนับสนุน | properties.triggerOperation |
เขตข้อมูลการใช้งานตัวเชื่อมต่อและการดําเนินการอยู่ในรุ่นพรีวิวในขณะนี้
ข้อมูลแคตตาล็อกตัวเชื่อมต่อ
คุณยังสามารถค้นหาตัวเชื่อมต่อเป็นทรัพยากรในคลังแต่ละรายการได้
| ประเภทข้อมูล | ข้อมูลที่พร้อมใช้งาน | เขตข้อมูล API สินค้าคงคลังของ Power Platform |
|---|---|---|
| ID ตัวเชื่อมต่อ | ตัวระบุตัวเชื่อมต่อ | properties.connectorId |
| คำอธิบาย | คําอธิบายตัวเชื่อมต่อ | properties.description |
| สำนักพิมพ์ | Publisher ของตัวเชื่อมต่อ | properties.publisher |
| ระดับ | การจัดประเภทแบบมาตรฐานหรือแบบพรีเมียม | properties.tier |
| ขั้นตอนการเผยแพร่ | การกำหนดรุ่น เช่น Production หรือ Preview | properties.releaseTag |
| สถานะการเลิกใช้ | ตัวเชื่อมต่อถูกเลิกใช้หรือไม่ | properties.isDeprecated |
| Operations | การดําเนินการที่ตัวเชื่อมต่อรองรับ | properties.operations |
| รหัสการดำเนินการ | รหัสการดําเนินการเฉพาะ | properties.operations[].operationId |
| ชื่อการดำเนินงาน | ชื่อที่แสดงของการดำเนินการ | properties.operations[].displayName |
| คําอธิบายการดําเนินการ | คําอธิบายเกี่ยวกับการดําเนินงาน | properties.operations[].description |
| เมธอด HTTP | เมธอด HTTP ที่การดําเนินการนี้ใช้ | properties.operations[].method |
ข้อมูลสภาพแวดล้อม
คุณสามารถค้นหาข้อมูลต่อไปนี้ในระเบียนสินค้าคงคลังสภาพแวดล้อม
| ประเภทข้อมูล | ข้อมูลที่พร้อมใช้งาน | เขตข้อมูล API รายการทรัพยากรของ Power Platform |
|---|---|---|
| รหัสสภาพแวดล้อม | ตัวระบุสภาพแวดล้อมที่ไม่ซ้ำกัน | name |
| ชื่อสภาพแวดล้อม | ชื่อที่แสดงของสภาพแวดล้อม | properties.displayName |
| สถานที่ | ตําแหน่งที่ตั้งทางภูมิศาสตร์ของสภาพแวดล้อม | location |
| ชนิดสภาพแวดล้อม | การผลิต, ค่าเริ่มต้น, Sandbox, รุ่นทดลองใช้, นักพัฒนา หรือ Dataverse สําหรับ Teams | properties.environmentType |
| สถานะที่จัดการแล้ว | สภาพแวดล้อมเป็นสภาพแวดล้อมที่มีการจัดการหรือไม่ | properties.isManaged |
| กลุ่ม environment | ชื่อของกลุ่มสภาพแวดล้อมที่กําหนด | properties.environmentGroup |
| รหัสกลุ่มสภาพแวดล้อม | ตัวระบุของกลุ่มสภาพแวดล้อมที่กําหนด | properties.environmentGroupId |
| การปรับเปลี่ยนครั้งล่าสุด | วันที่และเวลาที่ปรับเปลี่ยนสภาพแวดล้อมการทำงานครั้งล่าสุด | properties.lastModifiedAt |
ข้อมูลไม่พร้อมใช้งาน
พร็อพเพอร์ตี inventory ของการส่งออกข้อมูลต่อไปนี้ไม่มีค่าเทียบเท่าโดยตรงในสคีมา API ของ inventory ของ Power Platform ที่เผยแพร่อยู่
| ประเภทข้อมูล | ข้อมูลสินค้าคงคลังของการส่งออกข้อมูลไม่พร้อมใช้งานใน Power Platform inventory API |
|---|---|
| คําอธิบายของแอป | คําอธิบายของแอป Canvas หรือแอปที่ขับเคลื่อนด้วยแบบจําลอง |
| ลิงก์แอปพลิเคชัน | App URI, URI ของเอกสาร ไอคอน URI และ SharePoint URL ของฟอร์ม |
| การแชร์ | จำนวนผู้ใช้และกลุ่มที่มีการแชร์แอปด้วย |
| สถานะการลบ | ตัวบ่งชี้ทรัพยากรที่ถูกลบอย่างชัดเจน |
| ประวัติการเปิดใช้งาน | วันที่ที่เปิดใช้งานแอปครั้งล่าสุดและผู้ใช้หรือบัญชีที่เปิดใช้งาน |
| ข้อมูลโซลูชันและ ALM | การเชื่อมโยงโซลูชันและโหมด ALM |
| การประเมิน DLP | สถานะการประเมิน วันที่ประเมิน ข้อความการละเมิด และการละเมิดตามนโยบาย |
| การกำหนดค่าแอป | การตั้งค่า ชนิดการสร้าง ชนิดอุปกรณ์ไคลเอ็นต์ การฝังโฮสต์ ส่วนขยายแบบกําหนดเอง และการตั้งค่าการปรับประสิทธิภาพให้เหมาะสม |
| การนําเสนอแอป | รูปภาพพื้นหลัง สีพื้นหลัง การกําหนดแอปฮีโร่ การกําหนดแอปที่แนะนํา และการจําแนกประเภทแอป |
| ความยินยอมและการให้สิทธิ์การใช้งาน | การตั้งค่าการข้ามการขอความยินยอมและคุณสมบัติในการใช้แอปพาส |
| รุ่นของเอกสาร | เวอร์ชันของเอกสารที่เกี่ยวข้องกับแอป |
| การใช้เกตเวย์ภายในองค์กร | ตัวบ่งชี้อย่างชัดเจนว่าแอปใช้เกตเวย์ข้อมูลภายในองค์กร |
| การใช้ตาราง Dataverse | ตัวบ่งชี้อย่างชัดเจนว่าแอปใช้ตาราง Dataverse |
| การใช้บริการภายนอกของ PCF | ตัวบ่งชี้อย่างชัดเจนว่าตัวควบคุมเฟรมเวิร์กคอมโพเนนต์ Power Apps ใช้บริการภายนอก |
Important
properties.isQuarantined ระบุว่าแอปถูกกักกันหรือไม่ ไม่ใช่ตัวบ่งชี้การลบการส่งออกข้อมูลที่เทียบเท่ากัน
ข้อมูลที่มีให้พร้อมขอบเขตข้อมูลที่แตกต่างกัน
เขตข้อมูล API รายการของ Power Platform บางเขตข้อมูลแสดงข้อมูลที่เกี่ยวข้อง แต่ไม่เทียบเท่ากับคุณสมบัติการส่งออกข้อมูลโดยตรง
| ประเภทข้อมูล | รายการส่งออกข้อมูล | ความครอบคลุมของ API ของ Power Platform |
|---|---|---|
| ชนิดของทรัพยากร | แยกค่า type และ subType |
ตัวระบุทรัพยากรแบบมาตรฐานใน type ทรัพยากรบางชนิดยังมีให้ properties.subType |
| สถานะและวงจรชีวิต | สถานะทรัพยากรและสถานะวงจรชีวิต | สถานะกักกันพร้อมใช้งานสําหรับชนิดแอปที่สนับสนุน แต่ไม่ได้ครอบคลุมค่าสถานะหรือค่าวงจรชีวิตทั้งหมด |
| เจ้าของ | ค่าของเจ้าของและรหัสออบเจ็กต์ของเจ้าของ |
properties.ownerId มีรหัสออบเจ็กต์หากมี ไม่มีชื่อที่แสดงของเจ้าของรวมอยู่ |
| การใช้งาน API แบบกําหนดเอง | ตัวบ่งชี้ API แบบกําหนดเองที่ชัดเจน | ตัวระบุตัวเชื่อมต่อพร้อมใช้งานสําหรับทรัพยากรที่ได้รับการสนับสนุน แต่ไม่มีตัวบ่งชี้ API แบบกําหนดเองที่เทียบเท่า |
| การใช้ตัวเชื่อมต่อแบบพรีเมียม | ตัวบ่งชี้ API พรีเมียมที่ชัดเจน | ระดับตัวเชื่อมต่อมีอยู่ในเรกคอร์ดสินค้าคงคลังของตัวเชื่อมต่อ แต่ไม่มีตัวบ่งชี้ระดับทรัพยากรที่เทียบเท่า |
| การกระทําของเวิร์กโฟลว์ | การดําเนินการเวิร์กโฟลว์และตัวบ่งชี้ที่เกี่ยวข้องกับตัวเชื่อมต่อ | ตัวเชื่อมต่อที่มีโครงสร้างและตัวระบุการดําเนินการพร้อมใช้งานสําหรับชนิดทรัพยากรที่ได้รับการสนับสนุน |
| ข้อมูลสภาพแวดล้อม | ตัวระบุสภาพแวดล้อมบนทรัพยากรและข้อมูลการส่งออกสภาพแวดล้อมที่แยกต่างหาก | ทรัพยากรประกอบด้วย properties.environmentId. รายละเอียดสภาพแวดล้อมจะพร้อมใช้งานผ่านระเบียนรายการสภาพแวดล้อม |
การแมปตัวระบุ
ตัวระบุทรัพยากรไม่ได้แสดงเหมือนกันในการส่งออกข้อมูลและ API สินค้าคงคลังของ Power Platform
แอปที่ขับเคลื่อนด้วยโมเดล
ใช้การแมปต่อไปนี้สําหรับแอปที่ขับเคลื่อนด้วยโมเดล:
| ฟิลด์รายการของการส่งออกข้อมูล | เขตข้อมูล API รายการของ Power Platform |
|---|---|
environmentId |
properties.environmentId |
resourceId |
properties.appModuleId |
name |
properties.displayName |
type และ subType |
type |
เขตข้อมูลระดับ name บนสุดของ API ของ Power Platform เป็นตัวระบุทรัพยากรอินเวนทอรีที่ไม่ซ้ํากัน ไม่เทียบเท่ากับการส่งออกข้อมูล resourceId สำหรับแอปแบบจำลองข้อมูล
เมื่อต้องการเชื่อมโยงแอปแบบจําลองข้อมูลระหว่างสอง Schema ให้ใช้ทั้ง properties.environmentId และproperties.appModuleId
ข้อจำกัดของสินค้าคงคลังคอนเน็กเตอร์
คลังตัวเชื่อมต่อมีข้อจํากัดที่มีการบันทึกไว้ดังต่อไปนี้:
- ตัวเชื่อมต่อตารางสามารถปรากฏพร้อมกับอาร์เรย์การดําเนินการที่ว่างเปล่า
- การดําเนินการ Power Automate ที่มีอยู่ภายใน รวมถึงการดําเนินการ HTTP, Control และการดำเนินการกับข้อมูล จะไม่แสดงเป็นตัวเชื่อมต่อ
- แอปโค้ด แอป Vibe แอปที่มีการจัดการ และแอปตัวสร้างแอปจะไม่ปล่อยข้อมูลการใช้งานตัวเชื่อมต่อ
- แอปที่ขับเคลื่อนด้วยโมเดลแทบจะไม่รายงานตัวเชื่อมต่อโดยตรง
- การใช้งานตัวเชื่อมต่อโดยหน้าแคนวาสแบบฝังตัวจะเชื่อมโยงกับระเบียนของหน้าแคนวาสแทนแอปที่ขับเคลื่อนด้วยแบบจำลอง
- ข้อมูลตัวเชื่อมต่อต่อทรัพยากรประกอบด้วยตัวเชื่อมต่อและตัวระบุการดําเนินการ แต่ไม่รวมชื่อที่แสดงของตัวเชื่อมต่อ ข้อมูลผู้เผยแพร่ หรือระดับ
- ชื่อที่แสดงของตัวเชื่อมต่อ ข้อมูลผู้เผยแพร่ และระดับมีอยู่ในเรกคอร์ดสินค้าคงคลังของตัวเชื่อมต่อ
- การมีอยู่ของตัวเชื่อมต่อไม่ได้ระบุว่ามีการใช้เกตเวย์ภายในองค์กรหรือไม่