เมื่อคุณกำหนดค่าการผสานรวม Instructure OneRoster โปรดตรวจสอบข้อควรพิจารณาในการผสานรวมการส่งต่อเกรด การผสานรวมการส่งต่อเกรด (GPB) ของ Instructure OneRoster ประกอบด้วยข้อกำหนด OneRoster ที่แตกต่างกันไปตามความต้องการของผู้ให้บริการ SIS ต่างๆ
หมวดหมู่การให้คะแนน
ขึ้นอยู่กับการตั้งค่าสมุดบันทึกคะแนน SIS ของคุณ คุณสามารถปรับแต่งได้รับหมวดหมู่คำสั่ง SQL เพื่อซิงค์งานที่มอบหมายจาก Canvas ไปยังสมุดบันทึกคะแนน SIS ของคุณอย่างถูกต้อง
ช่วงเวลาการให้คะแนน
เนื่องจากผู้ให้บริการ SIS ส่วนใหญ่จะคำนวณช่วงเวลาการให้คะแนนโดยอัตโนมัติตามวันครบกำหนดส่งงาน คุณจึงอาจไม่จำเป็นต้องรวมจุดเชื่อมต่อนี้ไว้ในการกำหนดค่าการส่งคะแนนกลับของคุณ
เพย์โหลดรายการ
คุณสามารถกำหนดค่าคำขอรายการของคุณได้ เรียนรู้เพิ่มเติมเกี่ยวกับ OneRosterโครงสร้างข้อมูลหมวดหมู่รายการ.
ผลลัพธ์ เพย์โหลด
คุณสามารถกำหนดค่าคำขอรายการของคุณได้ เรียนรู้เพิ่มเติมเกี่ยวกับ OneRosterผลลัพธ์.
บันทึก:Instructure เป็นลูกค้าของ OneRoster สำหรับคำจำกัดความของลูกค้าและผู้ให้บริการของ OneRoster โปรดดูที่นี่ข้อมูลเบื้องต้นเกี่ยวกับ OneRoster.
หมวดหมู่การให้คะแนน
เมื่อระบบ Instructure OneRoster ทำการซิงค์ข้อมูลเกรด ระบบจะ...รับหมวดหมู่ทั้งหมดคำขอจะส่งคืนหมวดหมู่การให้คะแนนทั้งหมดในสมุดบันทึกคะแนน SIS
หมวดหมู่การให้คะแนนใดๆ ที่ไม่รวมถึง...เมตาเดตา.คลาสไอด์ฟิลด์ถือเป็นหมวดหมู่สากลที่สามารถนำไปประยุกต์ใช้ได้ในทุกคลาส
หมวดหมู่ทั่วโลก
หากระบบบันทึกคะแนน SIS ของคุณรองรับเฉพาะหมวดหมู่การให้คะแนนแบบทั่วโลก การเชื่อมต่อก็จะทำงานได้อย่างถูกต้องโดยไม่ต้องใช้ฟิลด์ข้อมูลเมตา
ส่วนขยายออบเจ็กต์หมวดหมู่: metadata.classId
เพื่อให้ API ของ OneRoster เวอร์ชัน 1.1 สามารถเชื่อมโยงหมวดหมู่และวัตถุอื่นๆ ในข้อกำหนดการส่งต่อเกรดได้อย่างถูกต้องมากขึ้น จึงจำเป็นต้องมีฟิลด์หมวดหมู่
ส่วนขยายด้านล่างนี้ช่วยให้ระบบผสานรวมสามารถระบุหมวดหมู่การให้คะแนน SIS ที่จำเป็นสำหรับการส่งต่อเกรดได้อย่างถูกต้อง หมวดหมู่ใด ๆ ที่ไม่มีสิ่งนี้...เมตาเดตา.คลาสไอด์โดยทั่วไปแล้ว ฟิลด์ต่างๆ จะถูกกำหนดให้เป็นฟิลด์ส่วนกลาง และชื่อหมวดหมู่แรกที่ตรงกับชื่อกลุ่มงานที่ได้รับมอบหมายใน Canvas จะถูกนำมาใช้สำหรับ GPB
หากคุณเลือกที่จะสนับสนุนเมตาเดตา.คลาสไอด์นอกจากนี้ คุณควรเพิ่มคำสั่งค้นหาตัวกรองสำหรับ...รับหมวดหมู่จุดสิ้นสุด (endpoint) นี้ช่วยให้การผสานรวมสามารถดึงหมวดหมู่สำหรับส่วนเดียวได้
ส่วนขยายวัตถุหมวดหมู่ |
|---|
{
"หมวดหมู่": [
{
"สถานะ": "ใช้งานอยู่",
"ชื่อเรื่อง": "การประเมิน",
"sourcedId": "guid",
"href": "URI ไปยังทรัพยากรใน SIS",
"เมตาเดตา": {
"classId": "{class_id}"
},
"dateLastModified": null
}…
]
} |
ตัวเลือกปลายทาง: getCategoriesForClass
เพื่อเป็นการเตรียมพร้อมสำหรับข้อกำหนด API 1.2 ของ OneRoster คุณสามารถเพิ่มการสนับสนุนสำหรับฟีเจอร์ใหม่ได้รับหมวดหมู่สำหรับคลาสจุดสิ้นสุด (endpoint) นี้ช่วยให้ระบบสามารถระบุหมวดหมู่การให้คะแนน SIS ที่มีอยู่สำหรับแต่ละส่วนในระหว่างการซิงค์ข้อมูลการส่งคืนคะแนนได้
บันทึก:หากคุณใช้วิธีการนี้ คุณไม่จำเป็นต้องกำหนดค่าการสนับสนุนสำหรับ...เมตาเดตา.คลาสไอด์ สนาม.
ไม่พบหมวดหมู่ที่ตรงกัน
การผสานรวม Instructure OneRoster ของคุณอาจถูกตั้งค่าให้ซิงค์งานที่มอบหมายใน Canvas เข้ากับหมวดหมู่การให้คะแนนใน SIS ในระหว่างการซิงค์คะแนน หากไม่พบหมวดหมู่ที่ตรงกัน ระบบจะแสดงข้อความแสดงข้อผิดพลาด โดยระบุว่าไม่มีชื่อหมวดหมู่การให้คะแนนใดใน SIS ตรงกับชื่อกลุ่มงานที่มอบหมายใน Canvas
หมวดหมู่เริ่มต้น
ระบบ SIS ของคุณอาจมีค่าเริ่มต้นอยู่ด้วยแหล่งที่มาIdหมวดหมู่การให้คะแนนที่รองรับในสมุดบันทึกคะแนน SIS ทุกระบบ ในระหว่างการซิงค์คะแนนจาก Canvas หากงานที่มอบหมายไม่สามารถจับคู่กับหมวดหมู่การให้คะแนน SIS ได้ ระบบจะซิงค์ไปยังหมวดหมู่การให้คะแนนเริ่มต้น
ถ้าเป็นหมวดหมู่ทั่วไปแหล่งที่มาIdหากค่านี้ไม่พร้อมใช้งาน สามารถส่งค่านี้ได้เช่นกันโมฆะ.
ไม่ส่งหมวดหมู่
หากระบบ SIS ของสถาบันของคุณรองรับสมุดบันทึกคะแนนที่ไม่มีหมวดหมู่การให้คะแนน คุณสามารถกำหนดค่าการผสานรวม Instructure OneRoster เพื่อส่งข้อมูล JSON ของรายการงานโดยไม่มีฟิลด์หมวดหมู่ หรือส่งโดยมีฟิลด์หมวดหมู่ก็ได้“หมวดหมู่”: ว่างเปล่าการผสานรวมสามารถเลือกที่จะส่งเสมอได้ โมฆะหรือส่งอย่างเดียว โมฆะหากไม่พบหมวดหมู่ที่ตรงกัน
อีกทางเลือกหนึ่ง การผสานรวมระบบที่มีอยู่ของคุณอาจซิงค์รายการงานที่ไม่ได้จัดหมวดหมู่ไปยังหมวดหมู่การให้คะแนนที่ไม่ได้จัดหมวดหมู่ในสมุดบันทึกคะแนน SIS โดยอัตโนมัติ หากเป็นเช่นนั้นสำหรับการผสานรวมระบบของคุณ อาจารย์สามารถย้ายงานไปยังหมวดหมู่การให้คะแนน SIS ที่เหมาะสมได้ เพื่อป้องกันไม่ให้งานซิงค์กลับไปยังช่องที่ไม่ได้จัดหมวดหมู่ การผสานรวมระบบของคุณควรได้รับการกำหนดค่าให้รู้จักหมวดหมู่ที่กำหนดด้วยตนเองเป็นช่องคงที่
หมวดหมู่ที่แทนที่
ระบบบันทึกคะแนน SIS ของสถาบันของคุณอาจถูกตั้งค่าให้ใช้หมวดหมู่การให้คะแนนเริ่มต้นที่เลือกไว้ล่วงหน้า เพื่อรองรับการตั้งค่านี้ การผสานรวม Instructure OneRoster ของคุณสามารถรวมหมวดหมู่ที่กำหนดไว้ล่วงหน้าได้แหล่งที่มาIdสมุดบันทึกคะแนนของอาจารย์ทุกเล่มในระบบ SIS ของคุณต้องมีหมวดหมู่นี้ หรืออีกทางเลือกหนึ่ง คุณสามารถกำหนดค่าการผสานรวมโดยใช้การตั้งค่าที่แทนที่ได้โมฆะค่าหมวดหมู่
ช่วงเวลาการให้คะแนน
ระหว่างการซิงค์คะแนนจาก Canvas ระบบ SIS ส่วนใหญ่จะคำนวณและเชื่อมโยงช่วงเวลาการให้คะแนนที่ถูกต้องของงานที่มอบหมายโดยอัตโนมัติโดยใช้ข้อมูลดังกล่าววันครบกำหนดรายการย่อย การคำนวณอัตโนมัตินี้หมายความว่าช่วงเวลาการให้คะแนนสามารถละเว้นรายการหรือส่งเป็นแบบอื่นได้โมฆะ.
หากจำเป็นตามข้อกำหนดของการผสานรวมของคุณช่วงเวลาการให้คะแนนสามารถกำหนดค่ารายการได้ อย่างไรก็ตาม หากกำหนดค่าไม่ถูกต้อง ข้อผิดพลาดในการซิงค์เกรดจะเกิดขึ้นบ่อยขึ้น
เรียนรู้เพิ่มเติมเกี่ยวกับภาคการศึกษาของ OneRoster.
ข้อควรพิจารณาเกี่ยวกับปริมาณข้อมูลของรายการสินค้า
คุณสามารถกำหนดค่าคำขอรายการสินค้าที่จะรวมอยู่ในข้อมูลการซิงค์ GPB ของคุณได้
แผนภูมิด้านล่างแสดงรายการคำขอที่สามารถกำหนดค่าได้ ในขั้นตอนการกำหนดค่าไคลเอ็นต์แต่ละราย คุณสามารถปรับแต่งค่าเริ่มต้นส่วนใหญ่ได้ นอกจากนี้ คุณยังสามารถละเว้นค่าใดๆ เหล่านี้จากข้อมูลที่ส่งได้ หรือหากมีข้อมูลที่เกี่ยวข้องอยู่ในข้อมูลที่ดึงมาจาก Canvas คุณยังสามารถกำหนดค่าฟิลด์เมตาเดต้าเพิ่มเติมได้อีกด้วย
เรียนรู้เพิ่มเติมเกี่ยวกับ OneRosterโครงสร้างข้อมูลหมวดหมู่รายการ.
ชื่อฟิลด์รายการ OneRoster | ค่าเริ่มต้น |
|---|
แหล่งที่มาId
| ยูไอดีวี4 |
ชื่อ
| {assignment.name} |
สถานะ
| "คล่องแคล่ว" |
คำอธิบาย
| นำเข้าจาก Canvas:https://school.instructure.com/courses/{course_id}/assignments/{assignment_id} |
ค่าผลลัพธ์สูงสุด
| {assignment.points_possible} |
ค่าผลลัพธ์ขั้นต่ำ
| 0 |
กำหนดวันที่
| {assignment.unlock_at} หรือ {assignment.due_at} |
วันครบกำหนด
| {assignment.due_at} |
ระดับ
| {อ็อบเจ็กต์อ้างอิงคลาส OneRoster} |
หมวดหมู่
| {วัตถุอ้างอิงหมวดหมู่ OneRoster} หรือ null* |
ช่วงเวลาการให้คะแนน
| null หรือ {ออบเจ็กต์อ้างอิง OneRoster academicSession}** |
*ดู หมายเหตุเกี่ยวกับการดำเนินการส่งเกรดคืนสำหรับหมวดหมู่ต่างๆ
**โปรดดูหมายเหตุเกี่ยวกับการดำเนินการส่งเกรดกลับสำหรับช่วงเวลาการให้เกรด**
ตัวอย่างการกำหนดค่าเพย์โหลด
ตัวอย่างข้อมูลเพย์โหลดพร้อม SourceID |
|---|
{
"lineItem": {
"sourcedId": "799e2caf-728d-4ef6-8ff9-5325e64cecd5"
"status": "active",
"title": "แบบฝึกหัดทดสอบ Canvas ครั้งที่ 1",
"description": "นำเข้าจาก Canvas:https://school.instructure.com/courses/5582/assignments/135”,
"resultValueMax": 10,
"resultValueMin": 0,
"assignDate": "2021-03-10T23:59:59",
"dueDate": "2021-03-10T23:59:59",
"metadata": {
"vendorId": ""
},
"class": {
"href": "~/ims/oneroster/v1p1/classes/100453379",
"sourcedId": "100453379",
"type": "class"
},
"category": {
"href": "~/ims/oneroster/v1p1/categories/C5C3AC8C-8D0F-48EB-96F4-31437B640D16",
"sourcedId": "C5C3AC8C-8D0F-48EB-96F4-31437B640D16",
"type": "category"
},
"gradingPeriod": null
}
} |
ตัวอย่างข้อมูลเพย์โหลดที่ไม่มี SourceID |
|---|
{
"lineItem": {
"status": "active",
"title": "Canvas Test Assignment 1",
"description": "Imported from Canvas:https://school.instructure.com/courses/5582/assignments/135”,
"resultValueMax": 10,
"resultValueMin": 0,
"assignDate": "2021-03-10T23:59:59",
"dueDate": "2021-03-10T23:59:59",
"metadata": {
"vendorId": ""
},
"class": {
"href": "~/ims/oneroster/v1p1/classes/100453379",
"sourcedId": "100453379",
"type": "class"
},
"category": {
"href": "~/ims/oneroster/v1p1/categories/C5C3AC8C-8D0F-48EB-96F4-31437B640D16",
"sourcedId": "C5C3AC8C-8D0F-48EB-96F4-31437B640D16",
"type": "category"
},
"gradingPeriod": null
}
} |
ข้อควรพิจารณาเกี่ยวกับน้ำหนักบรรทุกของผลลัพธ์
คุณสามารถกำหนดค่าข้อมูลผลลัพธ์ที่จะรวมอยู่ในการซิงค์ GPB ของคุณได้
แผนภูมิด้านล่างแสดงรายการคำขอที่สามารถกำหนดค่าได้ ในขั้นตอนการกำหนดค่าไคลเอ็นต์แต่ละราย คุณสามารถปรับแต่งค่าเริ่มต้นส่วนใหญ่ได้ นอกจากนี้ คุณยังสามารถละเว้นค่าใดๆ เหล่านี้จากข้อมูลที่ส่งได้ หรือหากมีข้อมูลที่เกี่ยวข้องอยู่ในข้อมูลที่ดึงมาจาก Canvas คุณยังสามารถกำหนดค่าฟิลด์เมตาเดต้าเพิ่มเติมได้อีกด้วย
เรียนรู้เพิ่มเติมเกี่ยวกับ OneRosterผลลัพธ์.
ชื่อฟิลด์ OneRoster | ค่าเริ่มต้น |
|---|
แหล่งที่มาId | {sourcedId} |
รายการ | {อ็อบเจ็กต์อ้างอิงรายการ OneRoster} |
นักเรียน | {อ็อบเจ็กต์อ้างอิงผู้ใช้ OneRoster} |
คะแนนสถานะ | "ตรวจให้คะแนนครบถ้วน" หรือ "ไม่ได้ส่ง" หรือ "ได้รับการยกเว้น" |
คะแนน | {คะแนนการส่ง} |
ความคิดเห็น | โดยค่าเริ่มต้นจะถูกละเว้น* |
คะแนนวันที่ | ละเว้นโดยค่าเริ่มต้น** |
*โปรดดูหมายเหตุเกี่ยวกับการดำเนินการส่งเกรดคืนสำหรับความคิดเห็น
**โปรดดูหมายเหตุเกี่ยวกับการดำเนินการส่งเกรดคืนสำหรับ scoreDate**
ตัวอย่างข้อมูลบรรทุก |
|---|
{
"ผลลัพธ์": {
"sourcedId": "0031e9ee-5bd0-4d80-a5f7-5c14fe75acc0",
"รายการ": {
"href": "~/ims/oneroster/v1p1/lineItems/0ea49ae5-4a6b-45d5-a0c2-b01facbfbc5f",
"sourcedId": "0ea49ae5-4a6b-45d5-a0c2-b01facbfbc5f",
"ประเภท": "รายการ"
},
"นักเรียน": {
"href": "~/ims/oneroster/v1p1/students/S100051158",
"sourcedId": "S100051158",
"type": "student"
},
"scoreStatus": "fully graded",
"score": 10
}
} |
คะแนน
ใน Canvas ผู้สอนสามารถกำหนดคะแนนติดลบได้ รวมถึงกำหนดคะแนนเกินค่าสูงสุดได้ด้วย พิจารณาว่าระบบของคุณจะจัดการกับสถานการณ์เหล่านี้อย่างไร
ในบางกรณี เช่น กรณีที่ได้รับการยกเว้นคะแนนสถานะการเชื่อมต่อของคุณควรได้รับการกำหนดค่าให้ส่งผ่านค่าโมฆะค่าคะแนน มิฉะนั้นจะเป็น0ค่าคะแนนจะถูกส่งไปยังระบบ SIS
ค่าสถานะคะแนนจาก Canvas | หมายเหตุ |
|---|
ได้รับเกรดเต็ม |
สถานะเวิร์กโฟลว์การส่งงาน = ผ่านการประเมินควรมีคะแนนกำกับไว้เสมอ
|
ไม่ได้ส่ง |
การส่งข้อมูลหายไป = จริงโดยส่วนใหญ่แล้วจะผ่านก็ต่อเมื่อมีคะแนนกำกับ แต่ก็เป็นไปได้ที่จะมีคะแนนไม่ตรงตามเกณฑ์คะแนน = null
|
ได้รับการยกเว้น |
submission.excused = trueคะแนนจะเป็นโมฆะโดยค่าเริ่มต้นหรือ0
|