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) қабатын қолдайды. Бұл — 1.2 үстіне үш нысан (Group, GroupMembership, GroupAssociation) қосатын топтардың қосымша стандарты.

OR-Groups қабаты — жариялану үстіндегі стандарт. Ол 1.2 үшін қатаң қосымша: Group тек 1.2-нің Class / User / Org / AcademicSession нысандарына оқу режимінде сілтейді. OneRoster 1.3 нұсқасында Class-ты Group-тың жеке жағдайы ету жоспарланған — Omniscol іске асыруы бұл бағытқа қазірдің өзінде жақындаған.

Omniscol — өндіруші (Omniscol → ENT / LMS)

Өндіруші ретінде Omniscol мекеменің анықтамалығын OneRoster-ге сәйкес REST API арқылы тек оқуға ұсынады, оны 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-да нысандарды құруды немесе жоюды басқармайды.

Өндірушінің аутентификациясы

Өндірушінің қол жеткізу нүктелері client_credentials ағынындағы OAuth2 арқылы (пайдаланушысыз, машинадан машинаға токен) қорғалған; токенді Omniscol-дың OAuth2 сервері береді. Олар Premium есептік жазбаларына арналмаған: қол жеткізуді тариф емес, OAuth2 рұқсат ауқымдары (scopes) бақылайды. Әр рұқсат ауқымы белгілі бір қызметке тән, ал демографиялық деректерге қол жеткізу 1.2 ішінде бөлектенген:

Қол жеткізу нүктелері Қабылданатын рұқсат ауқымдары
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 негізіне қол жеткізу бермейді, және керісінше. Ешқандай жазу рұқсат ауқымы көрсетілмейді. Айрықша рұқсат ауқымдарын Omniscol әкімшілігі OAuth2 клиентін тіркеу кезінде береді; клиент оларды өзіне бере алмайды. OAuth2 клиенттері мен токендерді басқару OAuth2 / OIDC (провайдер) және Omniscol API беттерінде сипатталған.

Оқушылардың аясын топтар қабаты қамтамасыз етеді

Құрылымдық таңдау: сыныптың немесе топтың оқушылар тізімі тек 1.2 негізі арқылы емес, OR-Groups (GroupMembership) арқылы беріледі. Тек Rostering 1.2 оқитын тұтынушы каталогты (Courses, Classes), мұғалім → курс тіркеулерін және пайдаланушылар анықтамалығын алады, бірақ оқушылардың тиесілігін алмайды. Кім қай сыныпта немесе қай топта екенін білу үшін тұтынушы OR-Groups қабатын іске асыруы керек. Бұл таңдау француз моделін көрсетеді: оқушы пәндер бойынша емес, сыныпқа немесе топқа тіркеледі.

Өндіруші REST арқылы ұсынылады. OneRoster CSV пакеті пішімі (әр жиынтыққа бір файлдан тұратын zip архиві) болса, анықтамалығын API арқылы емес, файлмен жеткізетін провайдерлер үшін импорт жағында қолдау табады — төмендегі тұтынушы бөлімін қараңыз.

Omniscol — тұтынушы (SIS → Omniscol)

OneRoster анықтамалығын импорттау (SIS → Omniscol): Omniscol OneRoster стандартына сәйкес SIS анықтамалығын — мекеме, жылдар, курстар, сыныптар, топтар, пайдаланушылар және демографиялық деректер — провайдердің REST API-і немесе CSV пакеті арқылы импорттап, мекемеде үйлестіре алады. Бұл тұтыну баптауы сыртқы жүйелермен синхрондаудың бөлігі, Premium есептік жазбаларында қолда бар және Omniscol командасымен жоба бойынша келісіледі.

Тұтынушы ретінде Omniscol OneRoster-ге сәйкес SIS анықтамалығын импорттап, оны мекемеде үйлестіреді. Бұл тұтыну баптауы сыртқы жүйелермен синхрондаудың бөлігі: ол Premium есептік жазбаларында қолда бар және Omniscol командасымен жоба бойынша келісіледі (Сыртқы жүйелермен синхрондау бетін қараңыз).

  • Тасымалдау — не провайдердің REST API-і (базалық мекенжай бапталады, OneRoster-дің стандартты беттеуі сақталады), провайдер серверіне қарсы client_credentials ағынындағы OAuth2 аутентификациясымен; не 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-пен тікелей синхрондауды іске қосу провайдерге және қажет болса, министрлік күнтізбелеріне байланысты: ол сұраныс бойынша, коннекторлап келісіледі. Бұл бірден дайын синхрондау емес.

Сондай-ақ қараңыз