OneRoster (גרסה 1.2 וקבוצות מתקדמות)
OneRoster הוא תקן בינלאומי להחלפת ספריות בתי ספר (בהוצאת 1EdTech): הוא מתאר, בפורמט משותף, את המוסדות, את שנות הלימודים, את הקורסים, את הכיתות, את ההרשמות ואת המשתמשים של בית ספר. הוא משמש לחיבור SIS, ENT או LMS לכלי אחר ללא הזנה חוזרת וללא פורמט קנייני.
דף זה מיועד למחלקת מערכות המידע של המוסד. הוא מתאר מה Omniscol חושף וצורך ב-OneRoster, את האימות הנדרש, ואת ההיקף בפועל של כל כיוון של ההחלפה.
גרסאות נתמכות
Omniscol תומך ב-OneRoster 1.2 Rostering — הבסיס (Org, AcademicSession, Course, Class, Enrollment, User, Demographics) — וכן בשכבת OR-Groups (Advanced Groups Service), תקן הקבוצות המשלים שמוסיף שלוש ישויות (Group, GroupMembership, GroupAssociation) מעל גרסה 1.2.
שכבת OR-Groups היא תקן שהוצאתו לאור טרם הושלמה. היא תוספתית לחלוטין מעל גרסה 1.2: Group רק מפנה אל Class / User / Org / AcademicSession של גרסה 1.2, לקריאה בלבד. גרסה 1.3 של OneRoster אמורה להפוך את Class לתת-סוג של Group — מגמה שהמימוש של Omniscol כבר מתכנס אליה.
Omniscol כיצרן (Omniscol → ENT / LMS)
כיצרן, Omniscol חושף את ספריית המוסד לקריאה בלבד, באמצעות API מסוג REST התואם ל-OneRoster, כדי ש-ENT או LMS יקראו אותה.
- בסיס Rostering 1.2 מוגש תחת
/ims/oneroster/rostering/v1p2/…(למשל/orgs,/schools,/academicSessions,/courses,/classes,/enrollments,/users,/teachers,/students,/demographics, כל אחד עם הגרסאות המקוננות שלו). - שכבת הקבוצות מוגשת תחת
/ims/oneroster/groups/v1p0/…(/groups,/groupMemberships,/groupAssociationsוהגרסאות המקוננות שלהם). - ההיקף ברירת המחדל הוא שנת הלימודים הנוכחית; פרמטר מאפשר לבחור שנה אחרת או לכסות את כל השנים.
הנתונים משקפים את התכנון המאוחד של Omniscol (מערכות שעות שפורסמו). היצרן הוא לקריאה בלבד מתוך בחירה: לא נחשפת שום כתיבה (PUT / DELETE) — מערכת מרוחקת אינה מנהלת יצירה או מחיקה של ישויות ב-Omniscol.
אימות היצרן
נקודות הקצה של היצרן מוגנות ב-OAuth2 בזרימת
client_credentials (טוקן ממכונה למכונה, ללא משתמש),
שמונפק על ידי שרת ה-OAuth2 של Omniscol. הן אינן שמורות
לחשבונות Premium: הגישה נשלטת על ידי ה-scopes של OAuth2, לא על ידי
החבילה. כל scope ייחודי לשירות, והגישה לנתונים
הדמוגרפיים מופרדת בתוך גרסה 1.2:
| נקודות קצה | Scopes מתקבלים |
|---|---|
| Rostering 1.2 (ללא דמוגרפיה) | https://purl.imsglobal.org/spec/or/v1p2/scope/roster-core.readonly, https://purl.imsglobal.org/spec/or/v1p2/scope/roster.readonly |
Rostering 1.2 /demographics |
https://purl.imsglobal.org/spec/or/v1p2/scope/roster.readonly, https://purl.imsglobal.org/spec/or/v1p2/scope/roster-demographics.readonly |
| OR-Groups (כולן) | https://purl.imsglobal.org/spec/or-groups/v1p0/scope/roster-group.readonly |
טוקן OR-Groups אינו נותן גישה לבסיס Rostering, ולהפך. לא מוצהר שום scope של כתיבה. ה-scopes בעלי ההרשאה הגבוהה מוענקים על ידי הניהול של Omniscol בעת רישום לקוח ה-OAuth2; לקוח אינו יכול להעניק אותם לעצמו. ניהול לקוחות OAuth2 והטוקנים מתואר בדף OAuth2 / OIDC (ספק) וגם בדף Omniscol API.
היקף התלמידים מועבר דרך שכבת הקבוצות
בחירה מבנית: רשימת התלמידים של כיתה או של קבוצה נחשפת דרך OR-Groups (GroupMembership), לא דרך בסיס 1.2 לבדו. צרכן שקורא רק את Rostering 1.2 מקבל את הקטלוג (Courses, Classes), את הרשמות המורים לקורסים ואת ספריית המשתמשים, אך לא את השתייכות התלמידים. כדי לדעת מי נמצא באיזו כיתה או באיזו קבוצה, הצרכן חייב לממש את שכבת OR-Groups. בחירה זו משקפת את המודל הצרפתי: תלמיד רשום בכיתה או בקבוצה, לא מקצוע אחר מקצוע.
היצרן נחשף ב-REST. את פורמט צרור ה-CSV של OneRoster (ארכיון zip של קובץ לכל אוסף), לעומת זאת, Omniscol תומך בו בצד הייבוא, לספקים שמוסרים את הספרייה שלהם בקובץ ולא דרך API — ראו את סעיף הצרכן להלן.
Omniscol כצרכן (SIS → Omniscol)
כצרכן, Omniscol מייבא את הספרייה של SIS התואם ל-OneRoster ומיישב אותה במוסד. הגדרת הצריכה הזו היא חלק מהסנכרון עם מערכות חיצוניות: היא מוצעת בחשבונות Premium ונקבעת בפרויקט עם צוות Omniscol (ראו סנכרון עם מערכות חיצוניות).
- אופן ההעברה — או API מסוג REST של הספק (כתובת הבסיס
מוגדרת, ועימוד OneRoster הסטנדרטי נשמר), עם
אימות OAuth2 בזרימת
client_credentialsמול השרת של הספק; או צרור CSV (ארכיון zip). - פרופיל — פרופיל הגדרה קובע את ההיקף לקריאה: בסיס 1.2 בלבד, שכבת הקבוצות, או מיפוי צרפתי לחינוך בית-ספרי. ספק של גרסה 1.2 בלבד, ללא שירות קבוצות, מיובא ללא בעיה.
- החלה מבוקרת — הייבוא פועל באותו עיקרון כמו שאר המחברים: Omniscol אוסף ואז מיישב את הנתונים, ומנהל מערכת מאשר את ההחלה במוסד. המערכת המרוחקת אינה דוחפת לעולם ישירות אל Omniscol.
- ייבוא חוזר אידמפוטנטי — ההתאמות של מזהים חיצוניים נשמרות, כך שייבוא חוזר אינו יוצר כפילויות גם כשהספק משנה תווית.
הפרופיל הצרפתי (חינוך בית-ספרי)
הפרופיל הצרפתי לחינוך בית-ספרי ממפה את המושגים הצרפתיים
אל מודל OneRoster: division (הכיתה במובנה
בפועל) הופכת ל-Group מסוג ארגוני ראשי; קבוצה
הופכת ל-Group של הוראה; קבוצת קבוצות
ל-Group רוחבי; חלוקות ויישורים
הופכים לשיוכי קבוצות; שיוך מורה לקורס הופך להרשמת
מורה. מזהים כמו INE או מזהה העובד
נישאים ב-userIds של המשתמש.
מזהים ופרטיות
כל ישות שנחשפת נושאת מזהה יציב, ה-sourcedId.
- המזהים המבניים (מוסד, שנה, קורס, כיתה, קבוצה) יציבים ובלתי משתנים מייצוא לייצוא: צרכן יכול להסתמך עליהם כדי לקשר נתונים לאורך זמן.
- מזהה המשתמש הוא אנונימי: Omniscol אינו מעביר לעולם את המזהה השמי שלו. הטוקן המועבר נגזר בפונקציה חד-כיוונית (HMAC) ייחודית לחשבון; ההרשמות וההשתייכויות משתמשות שוב בטוקן זה ואינן חושפות לעולם את המזהה המקורי.
סטטוס
- יצרן — פועל וניתן להדגמה ללא שותף מרוחק (הייצוא עומד בפני עצמו). Rostering 1.2 ושכבת OR-Groups מוגשים לקריאה בלבד, עם אימות OAuth2.
- צרכן — הגדרת הייבוא היא חלק מהסנכרון של Premium. הפעלת סנכרון חי עם SIS תלויה בספק ובמידת הצורך בלוחות הזמנים של משרדי הממשלה: היא נקבעת לפי בקשה, מחבר אחר מחבר. אין מדובר בסנכרון מוכן להפעלה מיידית.