เมื่อไร การกำหนดค่าการจัดตารางเวรสำหรับการผสานรวม OneRoster ของคุณ คุณควรสนับสนุนการกำหนดค่าบริการการจัดตารางเวลาทั้งสองแบบ และปฏิบัติตามแนวทางปฏิบัติที่ดีที่สุด
การปฏิบัติตามแนวทางปฏิบัติที่ดีที่สุดสำหรับการบูรณาการระบบจะช่วยให้มั่นใจได้ว่าการถ่ายโอนข้อมูลรายชื่อผู้เข้าร่วมถูกต้อง และขจัดความไม่แน่นอนในการแก้ไขการลงทะเบียน
บันทึก:Instructure เป็นลูกค้าของ OneRoster สำหรับคำจำกัดความของลูกค้าและผู้ให้บริการของ OneRoster โปรดดูที่นี่ข้อมูลเบื้องต้นเกี่ยวกับ OneRoster.
ภาคการศึกษา/เทอมการศึกษา
หากระบบสารสนเทศนักเรียน (SIS) ของคุณใช้รหัสคำศัพท์ทั่วไปในการจัดกลุ่มคำศัพท์ โปรดระบุรหัสคำศัพท์ทั่วไปนั้นในคำตอบของ API รหัสคำศัพท์ทั่วไปนี้สามารถใช้ระบุคำศัพท์ได้หากจำเป็นต้องรวมคำศัพท์เหล่านั้นใน Canvas
เรียนรู้เพิ่มเติมเกี่ยวกับ OneRosterข้อกำหนดภาคการศึกษา.
ตัวอย่าง |
|---|
{
"title": "A 707 07/08",
"sourcedId": "{hash}-{schoolId}-{termIdentifer}",
...
}
|
ชุดข้อมูลที่มีอยู่
ตั้งค่าจุดสิ้นสุดการดึงข้อมูล OneRoster สำหรับปีการศึกษาปัจจุบัน โดยรวมข้อมูลในอดีตและข้อมูลในอนาคตทั้งหมดภายในปีการศึกษาตามที่ระบบของคุณกำหนดไว้ นอกจากนี้ ให้รวมวัตถุข้อมูลทั้งหมดในการดึงข้อมูลพร้อมวันที่สิ้นสุดที่จำเป็นเพื่อหลีกเลี่ยงการลบข้อมูลที่ไม่ต้องการในระบบเป้าหมาย
เรียนรู้เพิ่มเติมเกี่ยวกับ OneRosterจุดสิ้นสุดการจัดทำรายชื่อ และ การปฏิบัติตามข้อกำหนดของจุดสิ้นสุดการจัดทำรายชื่อ.
บันทึกการลงทะเบียนซ้ำซ้อน
หากผู้ใช้มีข้อมูลการลงทะเบียนหลายรายการสำหรับวิชาเดียวกัน โปรดระบุเฉพาะข้อมูลการลงทะเบียนปัจจุบันเท่านั้น
ตัวอย่างเช่น หากนักเรียน A ในชั้นเรียน 123 ลงทะเบียนเรียนในชั้นเรียนนั้นแล้ว ถูกถอนชื่อออกจากชั้นเรียน แล้วลงทะเบียนเรียนใหม่ ให้ระบุสถานะการลงทะเบียนที่เหมาะสมที่สุดในขณะที่มีการเรียกใช้ API แทนที่จะใช้ข้อมูลการลงทะเบียนหลายรายการของนักเรียน A
วันเริ่มต้นและวันสิ้นสุดการลงทะเบียน
บันทึกการลงทะเบียนทุกรายการต้องระบุทั้งวันเริ่มต้นและวันสิ้นสุด แม้ว่าวันเหล่านั้นจะตรงกับวันเปิด-ปิดภาคเรียนก็ตาม การเปรียบเทียบวันลงทะเบียนและวันเปิด-ปิดภาคเรียนช่วยให้ Canvas สามารถรักษาความถูกต้องของสถานะการลงทะเบียนได้
รับผู้ใช้ทั้งหมด/ผู้ใช้
หากสถาบันของคุณสนับสนุนการใช้บทบาทผู้สังเกตการณ์ใน Canvas (สำหรับผู้ปกครอง ผู้ดูแล ฯลฯ) ขอแนะนำให้คุณเพิ่มโปรไฟล์ผู้ใช้เหล่านี้ลงในการกำหนดค่าการใช้งานของคุณ
การซิงค์ข้อมูลแบบเพิ่มทีละน้อย
แทนที่จะดึงข้อมูลทั้งหมด คุณสามารถกำหนดค่าการซิงค์ข้อมูลแบบเพิ่มทีละน้อยได้โดยใช้วันที่แก้ไขล่าสุดตัวกรองคำค้นหา
บันทึก:เพื่อให้สามารถซิงค์ข้อมูลแบบเพิ่มทีละน้อยได้อย่างน่าเชื่อถือ คุณต้องระบุสถานะการลบหรือวันที่สิ้นสุดสำหรับบันทึกการลงทะเบียนทุกรายการ หากไม่มีข้อมูลนี้ การคำนวณการลดลงของการลงทะเบียนจะทำได้โดยการเปรียบเทียบผลการซิงค์ข้อมูลแบบเต็มครั้งใหม่กับผลการซิงค์ข้อมูลแบบเต็มครั้งก่อนเท่านั้น