สำรวจและทดสอบ Dataverse ใน Web API Playground (ตัวอย่าง)

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

สำคัญ

ตัวเร่ง Dataverse, ระบบตรวจสอบปลั๊กอิน และคุณลักษณะ API playground ถูกลดลำดับความสำคัญและจะไม่ได้ส่งมอบเป็นคุณลักษณะ สําหรับข้อมูลเกี่ยวกับความพร้อมใช้งานของคุณลักษณะตัวอย่าง ไปที่โปรแกรมการแสดงตัวอย่าง Power Apps

API playground เป็นเครื่องมือทดสอบซอฟต์แวร์ที่ได้รับการรับรองความถูกต้องล่วงหน้า ซึ่งช่วยให้ผู้สร้างสามารถโต้ตอบกับ Microsoft Dataverse Web API ได้อย่างรวดเร็วและสะดวก

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

ใช้เครื่องมือนี้เพื่อสำรวจสิ่งที่เป็นไปได้ใน RESTful API ทดสอบเวิร์กโฟลว์ที่ผู้ใช้กำหนด และอื่นๆ อีกมากมาย

สำคัญ

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

คุณลักษณะสำคัญ

• ตรวจสอบสิทธิ์ล่วงหน้า: API Playground มีการตรวจสอบสิทธิ์ล่วงหน้า ดังนั้นนักพัฒนาจึงสามารถเริ่มการทดสอบและทดลองกับตำแหน่งข้อมูล API ได้ทันที
• บนเว็บ: ด้วย API Playground นักพัฒนาสามารถโต้ตอบกับ Dataverse Web API ได้อย่างรวดเร็ว โดยไม่จำเป็นต้องตั้งค่าเพิ่มเติม เช่น ดาวน์โหลดซอฟต์แวร์หรือตั้งค่าบัญชีที่ไม่ใช่ของ Microsoft คุณสามารถเข้าถึงเครื่องมือได้จาก Dataverse ตัวเร่งความเร็ว ซึ่งเป็นแอป Microsoft ที่พร้อมใช้งานในสภาพแวดล้อมใหม่ Dataverse และสามารถติดตั้งได้ในทุกสภาพแวดล้อม
• สะดวก: นำเสนอการดำเนินการและความสามารถต่างๆ ที่มีอยู่ใน Dataverse Web API ทำให้ง่ายต่อการเรียนรู้อย่างรวดเร็วว่าอะไรเป็นไปได้และวิธีการนำไปใช้

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

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

เริ่มต้น

หากต้องการเริ่มต้นใช้งาน API Playground เล่น Dataverse ตัวเร่งความเร็ว จากนั้นเลือกหน้า สนามเด็กเล่น API

ส่งคำขอไปยัง Dataverse Web API

บนหน้าจอ Landing Screen ให้เลือกประเภทคำขอเพื่อเปิดตัวแก้ไขคำขอโดยเลือก สร้าง บนการ์ดด้านบนรายการใดก็ได้

มีการนำเสนอคำขอสามประเภท:

ชนิด	คำอธิบาย
API ที่กำหนดเอง	ซึ่งรวมถึง Dataverse Web API การกระทำ, ฟังก์ชัน จาก Microsoft หรือสาธารณะใดๆ API แบบกำหนดเองที่ผู้ใช้กำหนด ลงทะเบียนในสภาพแวดล้อมการทำงาน
ปลั๊กอินแบบทันที	ปลั๊กอินทันที ถูกจัดประเภทเป็นเวิร์กโฟลว์ที่ผู้ใช้กำหนดใดๆ ที่ลงทะเบียนเป็น API แบบกำหนดเองในสภาพแวดล้อมที่มี FxExpression ที่เกี่ยวข้อง
ขอ OData	ช่วยให้สามารถควบคุมอินพุตคำขอที่จะส่งได้ละเอียดยิ่งขึ้น คำขอ OData

ขอ API แบบกำหนดเองหรือปลั๊กอินทันที

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

1. เลือกตัวเลือกจากรายการดรอปดาวน์หลักซึ่งแสดงปลั๊กอินที่พร้อมใช้งานในสภาพแวดล้อมปัจจุบัน

2. หากมีพารามิเตอร์ จะแสดงอยู่ในตาราง พารามิเตอร์แบบสอบถาม ที่ปรากฏขึ้น ให้ค่าสำหรับพารามิเตอร์ที่จำเป็น

   หมายเหตุ

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

3. เลือก ส่ง

4. สังเกต การตอบสนอง ในส่วนล่างของหน้าจอ

หมายเหตุ

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

ทำการร้องขอ OData

คำขอ OData อนุญาตให้มีตัวเลือกเพิ่มเติมสำหรับพารามิเตอร์คำขอ

1. เลือก วิธีการร้องขอ HTTP ในรายการดรอปดาวน์แรก

2. พิมพ์ จุดเชื่อมต่อ URL ใส่เฉพาะ URL คำขอที่อยู่ด้านหลังเท่านั้น [OrgUrl]/api/data/v9.2/

3. เพิ่ม พารามิเตอร์แบบสอบถาม โดยใช้วิธีใดวิธีหนึ่งจากสองวิธี:

   1. ใน URL

      1. หลังเครื่องหมายคำถาม (?) ใน URL ให้พิมพ์คีย์พารามิเตอร์การค้นหา

      2. พิมพ์อักขระเท่ากับ (=) หลังจากคีย์

      3. กรอกค่า

      คีย์และค่าจะเติมตารางพารามิเตอร์ในอินเทอร์เฟซโดยอัตโนมัติ

   2. เพิ่มพารามิเตอร์แบบสอบถามด้วยตนเองโดยการเลือก + เพิ่มพารามิเตอร์ ซึ่งจะเป็นการเพิ่มแถวพารามิเตอร์ว่างลงในตารางที่คุณสามารถพิมพ์ค่าลงไปได้ URL ได้รับการอัปเดตแบบไดนามิกเมื่อมีการป้อนค่า

4. ระบุเนื้อหา (หากใช้วิธีการร้องขอทั้งหมดยกเว้น GET) โดยเลือกแท็บ ร่างกาย จากนั้นป้อนค่าเนื้อหาในตัวควบคุมตัวแก้ไข

5. เลือก ส่ง

6. สังเกต การตอบสนอง ในส่วนล่าง

มุมมองการตอบสนอง

หลังจากส่งคำขอแล้ว การตอบกลับจะแสดงที่ครึ่งล่างของหน้าจอ

สถานะการตอบสนองจะให้การวัดผลอย่างรวดเร็วตามคำขอ:

• ข้อความสถานะ
• ระยะเวลา (มิลลิวินาที)
• ขนาด (เป็นกิโลไบต์)

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

คำถามที่พบบ่อย

ต้องใช้สิทธิ์อะไรบ้างในการเข้าถึงเครื่อง API playground

คุณต้องมีสิทธิ์เข้าถึง Dataverse เเอปตัวเร่งความเร็วเพื่อใช้เครื่องมือ

เครื่องมือ API Playground เชื่อมต่อกับ Dataverse Web API เท่านั้นหรือไม่

ใช่ เครื่องมือ API Playground เชื่อมต่อกับ Dataverse Web API เท่านั้น ไม่มีบริการอื่นใดให้เชื่อมต่อในอินเทอร์เฟซนี้

เครื่องมือ API Playground รับรองความถูกต้องกับ Dataverse Web API อย่างไร

เครื่องมือนี้ใช้โทเค็นการตรวจสอบสิทธิ์ของผู้ใช้ที่เข้าสู่ระบบซึ่งจำเป็นในการเล่นแอปพลิเคชัน Dataverse ตัวเร่งความเร็ว

คุณลักษณะ API playground พร้อมใช้งานในทุกสภาพแวดล้อมหรือไม่

ฟีเจอร์นี้ส่งมอบผ่าน Dataverse Accelerator และพร้อมใช้งานในทุกสภาพแวดล้อมที่ติดตั้งแอป แอปได้รับการติดตั้งโดยอัตโนมัติในสภาพแวดล้อมใหม่ทั้งหมด แต่ยังสามารถติดตั้งในสภาพแวดล้อมเก่าได้โดยทำตาม คำแนะนำในการติดตั้ง

ดูเพิ่มเติมที่

รับคุณลักษณะรุ่นพรีวิวก่อนใครด้ว Dataverse Accelerator (พรีวิว)