คุณสามารถกำหนดค่าตัวเลือกการผสานรวม Instructure OneRoster ได้ในแต่ละระดับการเชื่อมต่อไคลเอ็นต์
ในระหว่างขั้นตอนการทดสอบการผสานรวม (alpha testing) Instructure จะทำงานร่วมกับคุณเพื่อกำหนดค่าการตั้งค่าเริ่มต้นที่เหมาะสมสำหรับสถาบันของคุณ
เรียนรู้เพิ่มเติมเกี่ยวกับการกำหนดค่าบริการจัดตารางงาน และ แนวปฏิบัติที่ดีที่สุดสำหรับการบูรณาการการจัดตารางงาน.
บันทึก:Instructure เป็นลูกค้าของ OneRoster สำหรับคำจำกัดความของลูกค้าและผู้ให้บริการของ OneRoster โปรดดูที่นี่ข้อมูลเบื้องต้นเกี่ยวกับ OneRoster.
ความพร้อมกัน
การทำงานพร้อมกัน (Concurrency) คือจำนวนของเอนด์พอยต์ที่จะทำงานพร้อมกันในเวลาเดียวกัน หากตั้งค่าการทำงานพร้อมกันเป็นสาม ให้กำหนดค่าเอนด์พอยต์ที่ทำงานพร้อมกันได้สูงสุดสามเอนด์พอยต์ ตัวอย่างเช่น คุณสามารถใช้รับเงื่อนไข,getTeachers,รับคลาสปลายทางพร้อมกัน
เรียนรู้เพิ่มเติมเกี่ยวกับการกำหนดค่าจุดสิ้นสุดการลงทะเบียนเฉพาะโรงเรียนเพื่อให้สามารถซิงค์ข้อมูลการลงทะเบียนพร้อมกันได้
บันทึก:Instructure ไม่ได้ใช้การทำงานพร้อมกันกับระบบแบ่งหน้าข้อมูล ส่งผลให้การโหลดข้อมูลช้าเท่ากับเวลาตอบสนองของเอนด์พอยต์ที่ช้าที่สุดรวมกับการแบ่งหน้าข้อมูลบนเธรดเดียว
การจัดการข้อผิดพลาด
การจัดการข้อผิดพลาดเกี่ยวข้องกับการกำหนดค่ารหัสข้อผิดพลาดที่แสดงผล
ติดตาม OneRosterข้อกำหนดการจัดการข้อผิดพลาดนอกจากนี้ ขอแนะนำให้คุณใส่ชื่อ SIS ของคุณไว้ที่ต้นข้อความด้วยimsx_descriptionこれにより ระบบจะสามารถแสดงคำอธิบายข้อผิดพลาดที่เป็นประโยชน์แก่ผู้ใช้ปลายทางได้โดยอัตโนมัติ
จุดสิ้นสุดที่ยกเว้น
เอนด์พอยต์ที่ถูกยกเว้น คือ เอนด์พอยต์ที่ไม่รวมอยู่ในการเรียกใช้ API
หากปลายทางทั้งสองส่งคืนชุดข้อมูลที่เหมือนกัน ให้ตัดชุดข้อมูลหนึ่งชุดออกเพื่อลดจำนวนการเรียกใช้ API ตัวอย่างเช่นรับเซสชั่นวิชาการทั้งหมด และ รับเงื่อนไขทั้งหมดอาจให้ชุดข้อมูลที่เหมือนกัน ดังนั้นควรใส่เพียงชุดข้อมูลเดียวในการกำหนดค่าปลายทางของคุณ
ในระหว่างช่วงทดสอบอัลฟ่าของการผสานรวมระบบ โปรดแจ้ง Instructure เกี่ยวกับเอนด์พอยต์ใดๆ ที่ถูกยกเว้น
เรียนรู้เพิ่มเติมเกี่ยวกับ OneRosterการกำหนดค่าปลายทาง.
การค้นหาตัวกรอง
กรองข้อมูลที่รวมอยู่ในการซิงค์ข้อมูลโดยใช้คำสั่งกรอง คุณสามารถกำหนดค่าคำสั่งกรองได้ในแต่ละงาน ซึ่งจะช่วยให้สามารถซิงค์ข้อมูลได้ทั้งแบบเป็นกลุ่มและแบบเพิ่มทีละน้อย
ในระหว่างช่วงทดสอบอัลฟ่าของการผสานรวมระบบ โปรดแจ้ง Instructure เกี่ยวกับคำสั่งค้นหาตัวกรองที่คุณกำหนดค่าไว้สำหรับ OneRoster
เรียนรู้เพิ่มเติมเกี่ยวกับ OneRosterการค้นหาตัวกรองนอกจากนี้ เรียนรู้เพิ่มเติมเกี่ยวกับข้อกำหนดการใช้งานการซิงค์แบบเพิ่มทีละน้อย.
การแบ่งหน้า
เนื่องจากการเรียกใช้ API ไปยัง SIS อาจร้องขอข้อมูลจำนวนมาก การแบ่งหน้าจะช่วยจัดระเบียบผลลัพธ์การเรียกใช้ API ของคุณ เพื่อลดปริมาณการรับส่งข้อมูล HTTP และปรับปรุงเวลาในการซิงโครไนซ์ ขอแนะนำให้คุณกำหนดค่าการแบ่งหน้าให้รองรับได้สูงสุด 1,000 รายการต่อครั้ง
เรียนรู้เพิ่มเติมเกี่ยวกับ OneRosterข้อกำหนดการแบ่งหน้า.
บันทึก: แม้จะไม่แนะนำ แต่ Instructure สามารถรองรับการใช้งานที่รวมข้อมูลทั้งหมดที่ร้องขอไว้ใน API call เดียวได้ หากจำนวนการหมดเวลาไม่มากเกินไป
ลองใหม่
การลองใหม่คือจำนวนครั้งที่ระบบพยายามเรียกใช้ API ระบบ Instructure OneRoster จะลองเรียกใช้ API สูงสุดสามครั้งก่อนที่จะเกิดข้อผิดพลาด จะมีช่วงเวลาหน่วงระหว่างการลองแต่ละครั้ง และตัวคูณช่วงเวลาหน่วงจะเพิ่มช่วงเวลาหน่วงระหว่างการลองใหม่แต่ละครั้ง
จากตัวอย่างการตั้งค่าด้านล่าง การเรียกใช้ API จะพยายามสูงสุดสามครั้ง โดยจะรอ 5 วินาทีหลังจากเกิดข้อผิดพลาดครั้งแรก จากนั้นจะรอ 15 วินาทีสำหรับข้อผิดพลาดครั้งที่สองติดต่อกัน หากการเรียกใช้ล้มเหลวเป็นครั้งที่สาม งานการผสานรวมจะล้มเหลว
ตัวอย่างการกำหนดค่าการลองใหม่ | การตีความ |
|---|
“จำนวนครั้งที่ลองใหม่โดยค่าเริ่มต้น”: 2
| 3 ครั้ง |
“defaultDelay”: 5000
| 5 วินาที |
“ค่าตัวคูณความล่าช้าเริ่มต้น”: 3
| 15 วินาที |
หมดเวลา
การหมดเวลา (Timeout) เกิดขึ้นเมื่อการร้องขอ API ไปยังเว็บเซิร์ฟเวอร์ใช้เวลานานเกินไปเมื่อเทียบกับเวลาการรอของเซิร์ฟเวอร์เว็บไซต์ หากจำเป็น คุณสามารถเพิ่มเวลาการรอของเซิร์ฟเวอร์เว็บไซต์ได้ (เช่น 2 นาทีขึ้นไป) อย่างไรก็ตาม หากเป็นไปได้ คุณควรปรับการผสานรวมให้ตอบสนองได้รวดเร็วยิ่งขึ้น (เช่น น้อยกว่ายี่สิบวินาที)