การผสานรวมระบบข้อมูลของนักเรียนนักศึกษา (SIS) ที่เปิดใช้ OneRoster

Google Classroom รองรับการนำเข้าบัญชีรายชื่อและการซิงค์สมุดพกสำหรับระบบข้อมูลของนักเรียนนักศึกษา (SIS) ที่เป็นไปตามข้อกำหนดของ OneRoster Google เป็นพาร์ทเนอร์กับแพลตฟอร์ม SIS ที่เป็นไปตามข้อกำหนด OneRoster ที่ Google ระบุไว้

รูปที่ 1 เมื่อระบบข้อมูลของนักเรียนนักศึกษา (SIS) เป็นพาร์ทเนอร์กับ Classroom ผู้ดูแลระบบจะเลือก SIS ในเมนูแบบเลื่อนลงได้

เส้นทางการเริ่มต้นใช้งานพาร์ทเนอร์ SIS

ต่อไปนี้เป็นภาพรวมคร่าวๆ ของเส้นทางการเริ่มต้นใช้งานของพาร์ทเนอร์ SIS

  1. แสดงความสนใจ: หากสนใจเป็นพาร์ทเนอร์กับ Classroom โปรดกรอกแบบฟอร์มแสดงความสนใจ

  2. สำรวจและทำการทดสอบความสอดคล้อง: หากต้องการทราบว่า SIS ของคุณพร้อมที่จะผสานรวมกับ Classroom หรือไม่ คุณสามารถดูการทดสอบความสอดคล้องเพื่อทำความคุ้นเคยกับข้อกำหนดของ Google คุณมีตัวเลือกในการเรียกใช้การทดสอบความสอดคล้องก่อนที่จะแสดงความสนใจต่อทีม Google Classroom เพื่อพิจารณาว่าผลิตภัณฑ์ของคุณเป็นไปตามข้อกำหนดของ Google มากน้อยเพียงใด

  3. ติดต่อทีม Google Classroom: ทีม Classroom จะติดต่อกลับหลังจากที่คุณส่งแบบฟอร์มแสดงความสนใจหากมีโอกาสที่จะเป็นพาร์ทเนอร์กัน

  4. แชร์ผลการทดสอบและสร้างการผสานรวมแบบครบวงจร: เมื่อทีม Classroom ติดต่อคุณแล้ว ให้แชร์ผลการทดสอบความสอดคล้อง ทีมของคุณจะทำงานร่วมกับ Google เพื่อตรวจสอบและทำการผสานรวมให้เสร็จสมบูรณ์

การทดสอบความสอดคล้อง

การทดสอบความสอดคล้องที่ Google กำหนดมีไว้เพื่อให้พาร์ทเนอร์ SIS มีวิธีพิจารณาว่าผลิตภัณฑ์ของตนเป็นไปตามข้อกำหนดการใช้ OneRoster ของ Google หรือไม่ และเพื่อลดข้อผิดพลาดที่ผู้ใช้อาจพบเมื่อใช้การผสานรวม SIS ใน Classroom การทดสอบจะเผยแพร่ใน GitHub

เข้าถึงและเรียกใช้การทดสอบ

คุณต้องมีสิ่งต่อไปนี้จึงจะทำการทดสอบได้

  • URL ของโทเค็นเพื่อดึงข้อมูลเข้าสู่ระบบ OAuth 2.0
  • URL ของ One Roster ที่ลงท้ายด้วย /ims/oneroster/v1p2
  • รหัสไคลเอ็นต์
  • รหัสลับไคลเอ็นต์
  • อีเมลของครู

คุณทำการทดสอบได้โดยใช้ Google Colab หรือ Jupyter Notebook ทั้ง Colab และสมุดบันทึก Jupyter ช่วยให้คุณทำการทดสอบทั้งหมดพร้อมกันได้ ซึ่งจะช่วยให้คุณสร้างผลการทดสอบเพื่อแชร์กับทีม Google Classroom ได้

ข้อกำหนดและลักษณะการทำงานที่คาดไว้

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

ทดสอบ พอยเตอร์
ครู: GetAllTeachers ระบบจะเรียกใช้ปลายทาง GET /teachers ด้วยพารามิเตอร์การค้นหา limit ในการทดสอบครั้งต่อๆ ไป ระบบจะใช้พารามิเตอร์นี้เพื่อให้แน่ใจว่าผลิตภัณฑ์ของคุณรองรับขนาดหน้าเว็บ 10,000 รายการ
ครู: GetAllTeachers พร้อมตัวกรองอีเมล ระบบจะเรียกใช้ปลายทาง GET /teachers ด้วยพารามิเตอร์การค้นหา filter ที่ใช้เพื่อกรองตามอีเมลของครู ซึ่งจะใช้อีเมลของครูที่คุณระบุไว้ในส่วนข้อมูลเข้าสู่ระบบของการทดสอบ
Classes: GetClassesForTeacher ระบบจะเรียกใช้ปลายทาง /teachers/{teacher_sourced_id}/classes ด้วยพารามิเตอร์การค้นหา filter ที่ใช้เพื่อกรองตามชั้นเรียนที่ใช้งานอยู่
นักเรียน: GetStudentsForClass ระบบจะเรียกใช้ปลายทาง GET /classes/{class_sourced_id}/students ต้องแสดงอีเมลของนักเรียนในการตอบกลับ
GetGradingPeriodsForTerm ระบบจะทดสอบการรองรับระยะเวลาการให้คะแนนโดยใช้ term_sourced_id term_sourced_id นี้ใช้เพื่อดึงข้อมูลระยะเวลาการให้คะแนนในภาคการศึกษาโดยเรียกใช้ปลายทาง GET /terms/{term_sourced_id}/gradingPeriods
รายการโฆษณา: สร้าง ไม่จำเป็นต้องระบุระยะเวลาการให้คะแนนเมื่อเรียกใช้ PUT /lineItems/{line_item_sourced_id}
รายการโฆษณา: แก้ไข การเรียก API ไม่ควรแสดงข้อผิดพลาดหากมีชื่อการบ้านที่ยาว การทดสอบนี้รวมถึงความยาวของชื่องานที่มีอักขระมากกว่า 100 ตัว
ผลลัพธ์: แก้ไข คุณควรตั้งค่า score ให้มีค่ามากกว่า resultValueMax เพื่อแสดงเครดิตเพิ่มเติมได้
ผลลัพธ์: ลบ ต้องระบุปลายทาง DELETE /results/{result_sourced_id}
LineItem (ไม่บังคับ/ล้างข้อมูล): ลบและรับ ไม่จำเป็นต้องใช้ปลายทาง DELETE /lineItems/{line_item_sourced_id} ซึ่งเป็นตัวเลือกที่ไม่บังคับและใช้สำหรับการทำความสะอาดข้อมูล ปลายทาง GET /classes/{class_sourced_id}/lineItems ที่ตามมาก็ไม่บังคับเช่นกัน และจะทดสอบว่ารายการโฆษณาถูกลบไปแล้ว

แชร์ผลการทดสอบกับทีม Google Classroom

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

รับโดเมนสาธิตสำหรับนักพัฒนาซอฟต์แวร์

เมื่อทีม Google Classroom ตรวจสอบผลการทดสอบความสอดคล้องแล้ว โดเมนสาธิตสำหรับนักพัฒนาซอฟต์แวร์จะช่วยให้คุณตรวจสอบการผสานรวมตั้งแต่ต้นจนจบได้ โปรดทราบว่าการผ่านการทดสอบความสอดคล้องไม่ได้เป็นการรับประกันว่าจะได้รับการอนุมัติให้เป็นพาร์ทเนอร์หรือการผสานรวม

โดเมนสาธิตสำหรับนักพัฒนาแอปคือสภาพแวดล้อม Google Classroom เวอร์ชันทดลองที่ใช้งานได้จริง ซึ่งจะช่วยให้คุณตรวจสอบได้ว่าการผสานรวมทำงานได้ตามที่คาดไว้หรือไม่ ทำตามขั้นตอนเพื่อรับโดเมนเดโมสำหรับนักพัฒนาซอฟต์แวร์และขออัปเกรดโดเมนเดโม การอัปเกรดจะจัดสรรใบอนุญาต Google Workspace for Education Plus จำนวน 10 ใบให้กับโดเมนของคุณ ใบอนุญาตเหล่านี้ต้องได้รับการมอบหมายให้กับผู้ใช้ทดสอบในโดเมนนักพัฒนาซอฟต์แวร์เพื่อให้ผู้ใช้ทดสอบฟีเจอร์การผสานรวม SIS ใน Classroom ได้

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

1. Classroom คาดหวังโมเดลข้อมูลใดจาก SIS

Classroom เป็นไปตามข้อกำหนดเฉพาะของ OneRoster 1.2 หาก SIS ของคุณใช้โครงสร้างข้อมูลที่แตกต่างกัน คุณอาจพบพฤติกรรมที่ไม่คาดคิด ตัวอย่างเช่น หากระบบรองรับความสัมพันธ์แบบซ้อนกันระหว่างระยะเวลาการให้คะแนนและหมวดหมู่คะแนน กรณีนี้จะอยู่นอกข้อกำหนดเฉพาะของ OneRoster 1.2 และคุณควรทดสอบการผสานรวมอย่างละเอียดเพื่อให้แน่ใจว่ามีความเข้ากันได้อย่างเหมาะสม

2. ระบบจะส่งออกคะแนนและสถานะงานใดบ้างไปยัง SIS

ระบบจะส่งออกเฉพาะคะแนนที่ส่งคืนหรืองานที่ส่งที่ทำเครื่องหมายเป็น "ยังไม่ได้ส่ง" หรือ "ได้รับการยกเว้น" ไปยัง SIS ระบบจะไม่ส่งออกคะแนนฉบับร่าง

3. จะเกิดอะไรขึ้นกับรายการโฆษณาใน SIS หากลบงานใน Classroom

การลบงานใน Classroom จะไม่ลบรายการโฆษณาที่เกี่ยวข้องใน SIS ซึ่งจะช่วยป้องกันไม่ให้ข้อมูลสูญหายโดยไม่ตั้งใจและการลบแบบต่อเรียงกันโดยไม่ตั้งใจ