1.1

Public Documents | Member Resources | Background

Summary

OneRoster® 1.1 solves a school’s need to securely and reliably exchange roster information, course materials and grades between systems. OneRoster supports the commonly used .csv mode for exchange and the latest real-time web services mode known as REST.  

See a brief OneRoster Video.   

Provision key roster related data including student, course and related enrollment information between various platforms such as a student information system (SIS) and a learning management system (LMS).

Flexible implementation options to align with an institution’s needs and capabilities, supporting simple spreadsheet-style (CSV) exchanges as well as system-to-system exchanges using REST API’s

Improves data exchange among multiple systems with roster and gradebook information, thus eliminating problems before they happen

Transmit scored results between applications, such as student scores from the LMS back to the SIS.

Public Documents

• Introduction to OneRoster 1.1
• OneRoster 1.1 Real World Scenarios

Specification Documents

• OneRoster 1.1 Specification  (CSV Tables)
• OneRoster 1.1 Specification (REST API)
• OneRoster 1.1 Best Practices and Implementation Guide
• OneRoster 1.1 Conformance Guide

Member Resources (Login Required)

Suppliers/Developers

• How to Get Your Product IMS Conformance Certified

Institutions

• Planning and Procurement Guide for OneRoster 1.1

Developers' Github Community 

• OpenAPI Derived Code Libraries 
• PHP Class Library for OneRoster [Future] 

REST Service Model Files

• OpenAPI (YAML) File 
• OpenAPI (JSON) File 

Earlier Versions of  the Specification

IMS OneRoster v1 Implementation - Final

IMS OneRoster v1 CSV Tables - Final

Background of 

OneRoster is a modern, easy to use data exchange for rostering, course setup and grade reporting.  OneRoster should be a key element in your digital curriculum and automation strategy including Common Cartridge and support for cloud-based content with LTI-enabled Thin Common Cartridge.   

Feedback on the specification is welcomed in our public forums.

Learning Information Services Background

The Learning Information Services (LIS) specification is the definition of how systems manage the exchange of information that describes people, groups, memberships, courses and outcomes within the context of learning. The LIS v2.x specification supersedes the IMS GLC Enterprise Services v1.0 specification. The LIS specification is based upon the aggregation of the Person Management, Group Management, Membership Management, Course Management, Outcomes Management and the Bulk Data Exchange Management Services specifications. The LIS v2.0 can be implemented using both a Web Services infrastructure (based upon a SOAP http transport mechanism) and the Lightweight Directory Access Protocol (LDAP). An implementation is not required to support each and every service. Neither is an implementation required to support each and every operation. Interoperability is best defined through the use of a Domain Profile. This specification includes such a profile for Higher Education. Interoperability is supported between systems that implement the same profile. The LIS documentation consists of:

• The LIS Specification - describes how the LIS is composed using its six component services;
• Information Models - these documents contain the normative description of the various service definitions, data structures, and their relationships. Each of the six services has its own Information Model;
• Binding documents - each of the Information models has an associated WSDL binding document. Some of the services also have an LDAP binding document;
• Best Practice & Implementation Guide - this is intended to provide vendors with an overall understanding of the IMS GLC LIS Specification, the relationship of the specification with other IMS GLC specifications, and a best practices guide derived from experiences of those using the specification. The guide also includes several actual examples that describe how vendors can make the best use of the IMS LIS Specification;
• Core Profiles & Conformance Specification - a set of profiles of the LIS specification has been created. The Core Profiles identify the minimal subset of the functionality that must be supported by systems developed for deployment in HE. These Profiles (there is a Core plus several Additions) define the set of operations and data models that must be supported by the systems supporting the set of services within the LIS. Each profile contains its Conformance Specification against which compliant systems are tested;
• The Binding Files - one of the outputs of the LIS specification is the set of Web Services Description Language/XML Schema Definition (WSDL/XSD) binding files. Each service has its own set of WSDL/XSD files. It is these files that are used by code-generation tools to create the source code that handles the SOAP messages and XML data structures. Some small changes are required to the WSDL files to map the SOAP messages to the actual server-based implementation of the Web Service. Each of the services has a set of vocabulary files that contain the set of default vocabularies defined in the Information Model. The vocabulary files are instances of the IMS GLC Vocabulary Data Exchange (VDEX) specification.

Feedback may be posted in the IMS public forums.

IMS Learning Information Services Specification - Version 2.0.1 Final Specification (30 September 2013)

The Learning Information Services v2.0.1 corrects some minor errors in the v2.0 specification and updates the Core Profile definition. The specification document set contains information models, binding documents, best practice and implementation guidance, profile and conformance specification, and supporting files.

IMS Learning Information Services Overview
IMS Learning Information Services Specification
Learning Information Services Core Profile Adoption Overview
Learning Information Services Core Profile
Learning Information Services Best Practice and Implementation Guide

IMS Person Management Service Information Model
IMS Course Management Service Information Model
IMS Group Management Service Information Model
IMS Outcomes Management Service Information Model
IMS Membership Management Service Information Model
IMS Bulk Data Exchange Management Service Information Model

IMS Person Management Service WSDL/XSD Binding
IMS Course Management Service WSDL/XSD Binding
IMS Group Management Service WSDL/XSD Binding
IMS Outcomes Management Service WSDL/XSD Binding
IMS Membership Management Service WSDL/XSD Binding
IMS Bulk Data Exchange Management Service WSDL/XSD Binding

WSDLs/XSDs (combined into a single file):

The WSDL bindings are for a Synchronous SOAP implementation only. The WSDL files, expressed using WSDLv1.1, are combined WSDL/XSD files:

• PersonManagementServicev2p0_SyncSingle_v1p0.wsdl
• CourseManagementServicev1p0_SyncSingle_v1p0.wsdl
• GroupManagementServicev2p0_SyncSingle_v1p0.wsdl
• OutcomesManagementServicev1p0_SyncSingle_v1p0.wsdl
• MembershipManagementServicev2p0_SyncSingle_v1p0.wsdl
• BulkDataExchangeManagementServicev1p0_SyncSingle_v1p0.wsdl

XSDs:

The XSDs for each data structure for use with the BDEMS:

• imspms_filemodel_v2p0.xsd
• imscms_filemodel_v1p0.xsd
• imsgms_filemodel_v2p0.xsd
• imsoms_filemodel_v1p0.xsd
• imsmms_filemodel_v2p0.xsd
• imsbdemsFileData_v1p0.xsd
• imsepav1p0_v1p0.xsd

Vocabularies:

The PMS vocabularies are:

• The type of formatted name vocabulary formatnmetypevocabularyv1p0.xml;
• The type of name vocabulary nametypevocabularyv1p0.xml;
• The type of name part-name vocabulary – partnamevocabularyv1p0.xml;
• The type of address vocabulary addresstypevocabularyv1p0.xml;
• The address part vocabulary addresspartvocabularyv1p0p2.xml;
• The type of contact information vocabulary contactinfotypevocabularyv1p0.xml;
• The type of demographics vocabulary demographicstypevocabulartv1p0p2.xml;
• The type of representations vocabulary representationtypevocabularyv1p0.xml;
• The demographics information vocabulary demographicsinfovocabulartv1p0.xml;
• The type of enterprise system role vocabulary epriserolestypevocabularyv1p0.xml;
• The type of institution role vocabulary institutionroletypevocabularyv1p0p2.xml;
• The type of system role vocabulary systemrolevocabularyv1p0.xml;
• The enrollment information vocabulary enrollmentinfovocabularyv1p0.xml;
• The type of agent vocabulary agenttypevocabularyv1p0.xml;
• The type of event date vocabulary eventdatevocabularyv1p0.xml;
• Extension data-types vocabulary extensionvocabularyv1p0p2.xml;
• Language codes languagecodesvocabularyv1p0p2.xml. The set of codes used to identifiy the language for a string (based upon RFC4646).

The CMS vocabularies are:

• Status values vocabulary statusvocabularyv1p0.xml. The permitted status codes;
• Extension data-types vocabulary extensionvocabularyv1p0.xml. The set of data-types for the extensions;
• Language codes languagecodesvocabularyv1p0p2.xml. The set of codes used to identify the language for a string (based upon RFC4646).

The OMS vocabularies are:

• Types of LineItem vocabulary lineitemtypevocabularyv1p0.xml;
• Status of Result vocabulary statusofresultvocabularyv1p0.xml;
• Replace Status Code vocabulary replacestatuscoesvocabularyv1p0.xml;
• Exension data-types vocabulary extensionvocabularyv1p0.xml;
• Language codes – languagecodesvocabularyv1p0p2.xml. The set of codes used to identifiy the langage for a string (based upon RFC4646).

The MMS vocabularies are:

• The set of role types that a Person can have for their Memberships vocabulary roletypevocabularyv1p0p2.xml;
• The set of sub-role types that a Person can have for their Memberships vocabulary subrolevocabularyv1p0p2.xml;
• Extension data-types vocabulary extensionvocabularyv1p0p2.xml;
• Language codes – languagecodesvocabularyv1p0p2.xml. The set of codes used to identify the language for a string (based upon RFC4646).

The BDEMS vocabularies are:

• Parameter types vocabulary parametertypevocabularyv1p0.xml;
• Filter types vocabulary filtertypevocabularyv1p0.xml;
• Filter types for filter objects vocabulary filtervalueobjectvocabularyv1p0.xml;
• Transaction failure status codes vocabulary transactionfailstatusvocabularyv1p0.xml;
• Announce failure reports vocabulary announcefailurereportvocabularyv1p0.xml.