การผสานรวมระบบการให้คะแนนย้อนกลับ (GPB) ของ Instructure OneRoster รองรับการกำหนดค่าปลายทาง GPB แบบมาตรฐานหรือแบบแก้ไข เนื่องจากเป็นไปตามมาตรฐาน OneRoster อย่างเคร่งครัดกว่าข้อกำหนดการกำหนดค่าปลายทางแนะนำให้ใช้การตั้งค่า GPB มาตรฐาน
นอกจากนี้ เพื่อปรับปรุงประสิทธิภาพ ควรเพิ่มเอนด์พอยต์ด้านประสิทธิภาพลงในการกำหนดค่า GPB ของคุณด้วย
เรียนรู้เพิ่มเติมเกี่ยวกับ OneRosterการปฏิบัติตามข้อกำหนดของจุดสิ้นสุดสมุดบันทึกคะแนน.
บันทึก:Instructure เป็นลูกค้าของ OneRoster สำหรับคำจำกัดความของลูกค้าและผู้ให้บริการของ OneRoster โปรดดูที่นี่ข้อมูลเบื้องต้นเกี่ยวกับ OneRoster.
การสอบผ่านเกรดมาตรฐาน
จุดเชื่อมต่อการผสานรวม GPB มาตรฐานจะรวม sourcedId ของการมอบหมายงานเมื่อทำการซิงค์ข้อมูลสมุดบันทึกคะแนนจาก Canvas ไปยัง SIS ของคุณ
การเรียกใช้บริการ | จุดสิ้นสุด | คำกริยา HTTP | ที่จำเป็น |
|---|
รับหมวดหมู่ทั้งหมด | /หมวดหมู่ | รับ | ✓ |
รับรายการทั้งหมด | /รายการสินค้า | รับ | ✓ |
รับผลลัพธ์สำหรับคลาส | /คลาส/{class_id}/ผลลัพธ์ | รับ | ✓ |
รับรายการสินค้าสำหรับคลาส | /classes/{class_id}/lineItems | รับ | ✓ |
รับผลลัพธ์สำหรับรายการสินค้าสำหรับคลาส | /classes/{class_id}/lineItems/{li_id}/results | รับ | ✓ |
รับผลการเรียนของนักเรียนสำหรับชั้นเรียน | /classes/{class_id}/students/{student_id}/results | รับ | ✓ |
ใส่หมวดหมู่ | /หมวดหมู่/{id} | ใส่ | 𝗫 |
ใส่รายการ | /lineItems/{id} | ใส่ | ✓ |
putResult | /ผลลัพธ์/{id} | ใส่ | ✓ |
การสอบผ่านเกรดที่แก้ไขแล้ว
เอนด์พอยต์ GPB ที่ได้รับการแก้ไขจะละเว้น sourcedId ของงานที่ได้รับมอบหมายเมื่อซิงค์ข้อมูลสมุดบันทึกคะแนนจาก Canvas ไปยัง SIS ของคุณ
ในการตอบสนองต่อคำขอ PUT สำหรับระเบียนใหม่ sourcedId จะต้องถูกส่งกลับโดยผู้ให้บริการ OneRoster จากนั้นระบบจะจัดเก็บข้อมูลนี้ไว้เพื่อใช้ในอนาคตเมื่อทำการเรียกใช้ API
การเรียกใช้บริการ | จุดสิ้นสุด | คำกริยา HTTP | ที่จำเป็น |
|---|
รับหมวดหมู่ทั้งหมด | /หมวดหมู่ | รับ | ✓ |
รับรายการทั้งหมด | /รายการสินค้า | รับ | ✓ |
รับผลลัพธ์สำหรับคลาส | /คลาส/{class_id}/ผลลัพธ์ | รับ | ✓ |
รับรายการสินค้าสำหรับคลาส | /classes/{class_id}/lineItems | รับ | ✓ |
รับผลลัพธ์สำหรับรายการสินค้าสำหรับคลาส | /classes/{class_id}/lineItems/{li_id}/results | รับ | ✓ |
รับผลการเรียนของนักเรียนสำหรับชั้นเรียน | /classes/{class_id}/students/{student_id}/results | รับ | ✓ |
ใส่หมวดหมู่ | /หมวดหมู่/{id} | ใส่ | 𝗫 |
ใส่รายการ | /lineItems/{id} | ใส่ | ✓ |
putResult | /ผลลัพธ์/{id} | ใส่ | ✓ |
ใส่หมวดหมู่* | /หมวดหมู่* | ใส่ | 𝗫 |
ใส่รายการ* | /รายการ* | ใส่ | ✓ |
putResult* | /ผลลัพธ์* | ใส่ | ✓ |
*ละเว้น sourcedId ในการเรียก API เหล่านี้
จุดสิ้นสุดการส่งคืนเกรดประสิทธิภาพ
อย่างน้อยต้องมีการใช้งานวิธีการผสานรวม Performance Grade Passback อย่างน้อยหนึ่งวิธีต่อไปนี้
การเรียกใช้บริการ | จุดสิ้นสุด | คำกริยา HTTP | ที่จำเป็น |
|---|
รับหมวดหมู่คลาสที่กรองแล้ว | /categories?filter=metadata.classId='{class_id}' | รับ | ด* |
รับหมวดหมู่สำหรับคลาส | /คลาส/{class_id}/หมวดหมู่ | รับ | ✓** |
*แม้จะไม่จำเป็นอย่างยิ่ง แต่การใช้ตัวกรองนี้จะช่วยลดความจำเป็นในการดึงและแคชหมวดหมู่ทั้งหมด*
**หากคุณไม่ได้ใช้งานหมวดหมู่**เมตาเดตา.คลาสการดำเนินการนี้เป็นสิ่งจำเป็น ซึ่งจะช่วยให้คลาสต่างๆ สามารถเชื่อมโยงกับหมวดหมู่ได้