1EdTech GLC Learning Information Services Specification Primer
Version 2.0
Final Release
Version 1.0
Date Issued: 30 June 2011
Latest version: /lis/
IPR and Distribution Notices
Recipients of this document are requested to submit, with their comments, notification of any relevant patent claims or other intellectual property rights of which they may be aware that might be infringed by any implementation of the specification set forth in this document, and to provide supporting documentation.
1EdTech takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation or use of the technology described in this document or the extent to which any license under such rights might or might not be available; neither does it represent that it has made any effort to identify any such rights. Information on 1EdTech’s procedures with respect to rights in 1EdTech specifications can be found at the 1EdTech Intellectual Property Rights web page: /sites/default/files/imsipr_policyFinal.pdf.
Copyright © 2011 1EdTech Consortium. All Rights Reserved.
Use of this specification to develop products or services is governed by the license with 1EdTech found on the 1EdTech website: /license.html.
Permission is granted to all parties to use excerpts from this document as needed in producing requests for proposals.
The limited permissions granted above are perpetual and will not be revoked by 1EdTech or its successors or assigns.
THIS SPECIFICATION IS BEING OFFERED WITHOUT ANY WARRANTY WHATSOEVER, AND IN PARTICULAR, ANY WARRANTY OF NONINFRINGEMENT IS EXPRESSLY DISCLAIMED. ANY USE OF THIS SPECIFICATION SHALL BE MADE ENTIRELY AT THE IMPLEMENTER'S OWN RISK, AND NEITHER THE CONSORTIUM, NOR ANY OF ITS MEMBERS OR SUBMITTERS, SHALL HAVE ANY LIABILITY WHATSOEVER TO ANY IMPLEMENTER OR THIRD PARTY FOR ANY DAMAGES OF ANY NATURE WHATSOEVER, DIRECTLY OR INDIRECTLY, ARISING FROM THE USE OF THIS SPECIFICATION.
Executive Summary
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.0 specification supersedes the 1EdTech 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 is implemented using a Web Services infrastructure. 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, the Core Profiles, for Student Information System/Learning Management System (SIS/LMS) interactions. 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 Web Services Description Language (WSDL) binding document;
· Best Practice & Implementation Guide – this is intended to provide vendors with an overall understanding of the 1EdTech GLC LIS Specification, the relationship of the specification with other 1EdTech GLC specifications, and a best practices guide derived from experiences of those using the specification. The guide also includes a several actual examples that describe how vendors can make the best use of the 1EdTech LIS Specification;
· Core Profiles & Conformance Specification – a set of profiles of the LIS has been created for SIS/LMS interactions. The Core Profiles identify the minimal subset of the functionality that must be supported by systems developed for SIS/LMS deployment. The Core Profiles (there is a Core plus several Additions) define the set of operations and data 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 WSDL/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 1EdTech GLC Vocabulary Data Exchange (VDEX) specification.
Table of Contents
2 The Learning Information Services Specification
1 Introduction
1.1 Learning Information Service Systems
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. This document is the 1EdTech GLC Learning Information Services v2.0 Specification Primer; the specification is available in [LIS, 11a]. The LIS specification supersedes the 1EdTech GLC Enterprise Services v1.0 specification [ES, 04]. This 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 Learning Information Services Specification 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).
1.2 Structure of this Document
The structure of this document is:
2. The Learning Information Services Specification |
Provides an overview of the specification as a whole and explains how the six component services are orchestrated to provide the full range of services; |
3. The Historic Perspective |
Provides the historic context for this specification as it has evolved from a pure data model to this current service description; |
4. Using the New Version |
Provides an overview of the ways in which the specification can be adapted to fit specific implementation requirements; |
5. The Document Set |
Lists and explains the set of documents produced as part of the specification. |
1.3 Nomenclature
BDEMS Bulk Data Exchange Management Service
CMS Course Management Service
GMS Group Management Service
1EdTech GLC 1EdTech Consortium Inc.
LDAP Lightweight Directory Access Protocol
LIP Learner Information Packaging
LIS Learning Information Services
MMS Membership Management Service
OMS Outcomes Management Service
PMS Person Management Service
UML Unified Modelling Language
URL Uniform Resource Locator
VDEX Vocabulary Definition Exchange
WSDL Web Services Description Language
XSD XML Schema Description
1.4 References
[BDEMS, 11a] 1EdTech GLC Bulk Data Exchange Management Service v1.0 Information Model v1.0 Final Release, L.Feng, W.Lee and C.Smythe, 1EdTech Consortium, June 2011.
[BDEMS, 11b] 1EdTech GLC Bulk Data Exchange Management Service v1.0 WSDL Binding v1.0 Final Release, L.Feng, W.Lee and C.Smythe, 1EdTech Consortium, June 2011.
[CMS, 11a] 1EdTech GLC Course Management Service v1.0 Information Model v1.0 Final Release, L.Feng, W.Lee and C.Smythe, 1EdTech Consortium, June 2011.
[CMS, 11b] 1EdTech GLC Course Management Service v1.0 WSDL Binding v1.0 Final Release, L.Feng, W.Lee and C.Smythe, 1EdTech Consortium, June 2011.
[ES, 04] 1EdTech GLC Enterprise Services Specification Final Release v1.0, C.Smythe and C.Vento, 1EdTech Consortium, June 2004.
[GMS, 11a] 1EdTech GLC Group Management Service v2.0 Information Model v1.0 Final Release, L.Feng, W.Lee and C.Smythe, 1EdTech Consortium, June 2011.
[GMS, 11b] 1EdTech GLC Group Management Service v2.0 WSDL Binding v1.0 Final Release, L.Feng, W.Lee and C.Smythe, 1EdTech Consortium, June 2011.
[GWS, 06a] 1EdTech GLC General Web Services Base Profile Final Release, C.Schroeder, J.Simon and C.Smythe, V1.0, 1EdTech Consortium, January 2006.
[GWS, 06b] 1EdTech GLC General Web Services WSDL Binding Guidelines Final Release, C.Schroeder, J.Simon and C.Smythe, V1.0, 1EdTech Consortium, January 2006.
[LIS, 11a] 1EdTech GLC Learning Information Services v2.0 Specification v1.0 Final Release, L.Feng, W.Lee and C.Smythe, 1EdTech Consortium, June 2011.
[LIS, 11b] 1EdTech GLC Learning Information Services v2.0 Best Practices & Implementation Guide v1.0 Final Release, L.Feng, W.Lee and C.Smythe, 1EdTech Consortium, June 2011.
[LIS, 11c] 1EdTech GLC Learning Information Services v2.0: Core Profiles v1.0 Final Release L.Feng, W.Lee and C.Smythe, 1EdTech Consortium, June 2011.
[MMS, 11a] 1EdTech GLC Membership Management Service v2.0 Information Model v1.0 Final Release, L.Feng, W.Lee and C.Smythe, 1EdTech Consortium, June 2011.
[MMS, 11b] 1EdTech GLC Membership Management Service v2.0 WSDL Binding v1.0 Final Release, L.Feng, W.Lee and C.Smythe, 1EdTech Consortium, June 2011.
[OMS, 11a] 1EdTech GLC Outcomes Management Service v1.0 Information Model v1.0 Final Release, L.Feng, W.Lee and C.Smythe, 1EdTech Consortium, June 2011.
[OMS, 11b] 1EdTech GLC Outcomes Management Service v1.0 WSDL Binding v1.0 Final Release, L.Feng, W.Lee and C.Smythe, 1EdTech Consortium, June 2011.
[PMS, 11a] 1EdTech GLC Person Management Service Information Model v2.0 Final Release, L.Feng, W.Lee and C.Smythe, 1EdTech Consortium, June 2011.
[PMS, 11b] 1EdTech GLC Person Management Service v2.0 WSDL Binding v1.0 Final Release, L.Feng, W.Lee and C.Smythe, 1EdTech Consortium, June 2011.
[VDEX, 04] 1EdTech GLC Vocabulary Definition Exchange Information Model v1.0, A.Cooper, 1EdTech Consortium, February 2004. /vdex/
2 The Learning Information Services Specification
The basic architectural model for the LIS specification is shown in Figure 2.1. In this architecture the scope of the data exchange provided by the services is shown as the dotted line. The scope of the interoperability is the data and behavioral models of the objects being exchanged.
Figure 2.1 Schematic architecture of the learner information services.
Six services are defined. Instances of the data models are stored in the service consumer/provider object repositories. It is the persistence of the data in these repositories that reflects the dynamic changes in the system. The set of services are realized as SOAP messages to exchange the XML-based data objects[1].
An implementation is not required to support each and every service. Neither is an implementation required to support each and every operation. The specific requirements are defined in the corresponding profile[2]. Interoperability is supported between systems that implement the same profile. Cross-profile interoperability may occur but this is a by-product and should NOT be used as the basis for any system realization.
3 The Historic Perspective
The release history for the LIS is listed in Table 3.1. The original Enterprise v1.0 data model was the second specification released by 1EdTech GLC. It has undergone several revisions in response to feedback from the experience gained in the various implementations.
Table 3.1 Release history for Enterprise/LIS specifications.
Version |
Release Date |
Description |
Enterprise 1.0 |
November, 1999 |
Original data model for Enterprise systems interoperability. |
Enterprise 1.0.1 |
January, 2000 |
Correction of a small number of bugs identified in version 1. |
Enterprise 1.1 |
July, 2002 |
Revised data model to introduce new functionality based on commonly used extensions. |
Enterprise Services v1.0 |
August, 2004 |
Introduction of services, based upon the 1EdTech GLC General Web Services, to support the exchange of the information based upon the Enterprise v1.1 data model. |
LIS v2.0 is a radical reworking of both the original services and data models. LIS has replacement services for the Person Management Service (PMS), Group Management Service (GMS) and Membership Management Service (MMS); these have some significant changes but are similar in objective. There are three new services:
· Course Management Service (CMS) – in Enterprise Services v1.0 this functionality was supported using the 1EdTech GLC Group Management Service v1.0 [GMS, 04] specification in a variety of different ways. This created interoperability problems hence the creation of the CMS specification. The Course Management Service v1.0 is closely linked to the Group Management Service v2.0 and Membership Management Service v2.0;
· Outcomes Management Service (OMS) – in Enterprise Services v1.0 a simplified form of functionality was supported using the 1EdTech GLC Membership Management Services v1.0 [MMS, 04]. In general, there is NO backwards compatibility between the usage of the OMSv1.0 and the ways in which MMSv1.0 has been implemented to support outcomes management. Vendors may define compatibility bridges for their own implementations but these are outside the scope of this specification.
· Bulk Data Exchange Management Service (BDEMS) – this is a bulk exchange service used to support initialization and synchronization use-cases.
The release of the Learning Information Services v2.0 creates the issue of compatibility between version 1 and version 2 implementations. Compatibility issues occur when:
a) A version 1 service implementation initiates data exchange with a version 2 implementation;
b) A version 2 service implementation initiates data exchange with a version 1 implementation.
The binding of the Information Model recommends that the Uniform Resource Locator (URL) for the messaging actions is dependent on the type and version number of the source specification: in such a case it is not possible for cross-interaction between implementations of version 1 and 2. However, if a common URL is used then cross-interaction becomes possible. The definition of the behavior for interactions between different versions is beyond the scope of this specification.
4 Using the New Version
4.1 Building an Interoperable Solution
The LIS consists of a set of services, each of which has a number of operations which themselves act upon the core data objects. The interoperability is between a service provider (the LIS would expect this to include the Reference Agent) and a service consumer (in LIS also termed a Sync Agent). A system that claims conformance to the LIS specification is not, in general, expected to support all of the services and service features. However, interoperability between two LIS implementations requires common service support.
The LIS specification enables interoperability in many forms i.e., it does not impose a best practice; it is the role of Profile(s) to establish a best practice for a particular community. When establishing the degree of interoperability provided by two LIS implementations the following must be considered:
· Identify which of the six services are common to both implementations;
· For each service identify the set of operations that are complementary to both implementations;
· For each operation identify the set of status codes that are commonly supported;
· For each data model in each service identify which parts of any vocabulary are commonly supported;
· For each data model identify the set of objects. In particular, inspect which optional features are common.
Persistence of data is a key feature for any system for which conformance to this specification is claimed. A service provider must persist the data it is required to support (note that the specification makes no imposition on how the data is stored – it is only concerned with interoperability). This persistence enables conformance testing. A service consumer is only required to persist the data if it also acts to forward the data to another LIS-compliant system or if it also acts as a service provider i.e., permitting another system to read from it.
There is no interoperability between an Enterprise Service v1.0 and LIS v2.0. This is because the data models have been subject to significant changes, the services themselves have been refactored and new services added in LIS.
4.2 Profiles & Profiling
The Core Profiles identify the minimal subset of the functionality that must be supported by systems developed for deployment for Student Information System/Learning Management System (SIS/LMS) interaction. 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. A system can support greater functionality but there is no guarantee of interoperability for those extra features. Interoperability is only guaranteed for the functionality described in the Core Profiles.
If the Core Profile, either alone or in combination with one or more of the Addition Profiles, is inadequate then a new profile can be created and registered with 1EdTech GLC.
5 The Document Set
Apart from this Primer, the LIS documentation set consists of:
· The LIS Specification – describes how the LIS is composed using its six component services [LIS, 11a].
· 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 [PMS, 11a], [GMS, 11a], [MMS, 11a], [CMS, 11a], [OMS, 11a] and [BDEMS, 11a].
· Binding documents – each of the Information models has an associated WSDL binding document;
· Best Practice & Implementation Guide – this is intended to provide vendors with an overall understanding of the 1EdTech GLC LIS Specification, the relationship of the specification with other 1EdTech GLC specifications, and a best practices guide derived from experiences of those using the specification[3]. The guide also includes several actual examples that describe how vendors can make the best use of the LIS Specification;
· Core Profiles & Conformance Specification – a set of profiles of the LIS has been created for SIS/LMS exchange [LIS, 11c]. The Core Profiles identify the minimal subset of the functionality that must be supported for SIS/LMS exchanges. These Profiles (the Core and 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. This Core Profiles includes the Conformance Specification against which compliant systems are tested;
· The Binding Files – this is the set of WSDL and XSD files that realize the binding. 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 conform to the 1EdTech GLC Vocabulary Definition Exchange (VDEX) specification [VDEX, 04].
The documentation set of the 1EdTech GLC Learning Information Services Specification is daunting. However, a few simple guidelines make it considerably easier for even a newcomer to work through the documents. The recommended approach to reviewing the documentation set is:
a) The LIS Best Practices & Implementation Guide is an excellent way to understand the why, what and how of a specification. The set of examples described in the guide is an excellent way to understand what is being created by the specification. The guide should always be read before attempting to work through either the Information Models or the WSDL/LDAP Bindings;
b) The LIS Specification [LIS, 11a] describes the overall structure of the specification in terms of its component services. It provides the context for the details given in each of the Information Model and Binding documents;
c) Once the set of examples has been digested, it is time to work through the Information Models. These models provide the formal definition of all of the service operations, data structures and their behaviors and relationships;
d) Finally, work through the WSDL Binding documents. Often, only the implementation/engineering team needs to understand the details of these documents. Each binding document is the definitive statement of how interoperability is achieved using WSDL. The WSDL Bindings are formally realized as the WSDL/XSD files (these files can be used to generate the corresponding SOAP messages);
e) The LIS Core Profiles [LIS, 11c] should be used as the basis for providing the core service capability for SIS/LMS exchanges. This profile identifies the minimal set of service operations that are required to create a ‘useful’ learning information service (the profile identified less than 5% of the full set of service operations as necessary).
About This Document
Title: 1EdTech GLC Learning Information Services Specification Primer
Editor: Colin Smythe (1EdTech GLC)
Co-chairs: Linda Feng (Oracle) and Bill Lee (Desire2learn)
Version: 2.0
Version Date: 30 June 2011
Release: Final 1.0
Status: Final Release
Summary: This document is a primer for the 1EdTech GLC Learning Information Services (LIS) specification. LIS is a collection of six component services that are combined to provide the required functionality. These component services are: Person Management Service; Group Management Service; Membership Management Service; Course Management Service; Outcomes Management Service; and Bulk Data Exchange Management Service. As part of the specification a profile for Higher Education has been created.
Revision Information: The original release.
Purpose: This document is made available for adoption by the public community at large.
Document Location: /lis/
List of Contributors
The following individuals contributed to the development of this document:
Kerry Blinco DEEWR (Australia)
Kirk Bunte SungardHE (USA)
Angus Chan Desire2Learn (Canada)
Adam Cooper JISC/JISC-CETIS (UK)
Michael Feldstein Oracle (USA)
Linda Feng Oracle (USA)
Chris Hatton Pearson (USA)
Jon Fontaine Blackboard (USA)
Karen Kuffner University of Michigan (USA)
Zack Leavitt Pearson (USA)
Bill Lee Desire2Learn (Canada)
Richard Moon SungardHE (USA)
Mike Parkhill Desire2Learn (Canada)
Colin Smythe 1EdTech GLC (UK)
Reinhold Staudinger Blackboard (USA)
Nick Terrible University of Wisconsin (USA)
Jason Zhong SungardHE (USA)
Revision History
Version No. |
Release Date |
Comments |
Final Release v1.0 |
30 June 2011 |
The first formal release of the Final Release version of this document. |
|
|
|
Index
A
Addition Profiles......................... 7
Attributes
Common
email.................................... 1
Org
type...................................... 6
Person
email.................................... 1
RecordMetaData
comments........................... 1
Role
status................................... 7
StatusInfo
description.................. 2, 3, 8
TypeValue
type...................................... 6
B
Binding technologies
LDAP............................... 3, 5, 8
SOAP........................... 2, 3, 5, 8
WSDL.......................... 2, 3, 4, 8
XSD.................................. 2, 3, 8
Bulk Data Exchange Management Service 2, 3, 6, 8, 9
C
Classes
Group...................... 2, 3, 4, 6, 9
Description................. 2, 3, 6
Membership........... 2, 3, 4, 6, 9
Person..................... 2, 3, 4, 6, 9
Conformance......................... 2, 8
Core Profile..................... 2, 4, 7, 8
Core Profiles................... 2, 4, 7, 8
Course............................. 2, 3, 6, 9
Course Management Service 3, 6, 8, 9
G
Group Management Service 3, 4, 6, 9
L
LDAP................................... 3, 5, 8
Learning Information Services 1, 2, 3, 4, 5, 6, 8, 9
Lightweight Directory Access Protocol 3, 5, 8
LIS
Bulk Data Exchange Management Service 2, 3, 6, 8, 9
Course Management Service 3, 6, 8, 9
Group Management Service 3, 4, 6, 8, 9
Membership Management Service 3, 4, 6, 8, 9
Outcomes Management Service 3, 4, 6, 8, 9
Person Management Service 3, 4, 6, 8, 9
M
Membership Management Service 3, 4, 6, 9
O
Outcomes Management Service 3, 4, 6, 9
P
Person Management Service 3, 4, 6, 9
Profiling........................................ 7
S
Services
Bulk Data Exchange Management 2, 3, 6, 9
Course Management Service 3, 6, 9
Group Management. 3, 4, 6, 9
Membership Management 3, 4, 6, 9
Outcomes Management Service 3, 4, 6, 9
Person Management 3, 4, 6, 9
SOAP............................... 2, 3, 5, 8
Specifications
Other
LDAP.......................... 3, 5, 8
W
WDSL.............................. 2, 3, 4, 8
X
XSD...................................... 2, 3, 8
1EdTech Consortium, Inc. (“1EdTech GLC”) is publishing the information contained in this document (“Specification”) for purposes of scientific, experimental, and scholarly collaboration only.
1EdTech GLC makes no warranty or representation regarding the accuracy or completeness of the Specification.
This material is provided on an “As Is” and “As Available” basis.
The Specification is at all times subject to change and revision without notice.
It is your sole responsibility to evaluate the usefulness, accuracy, and completeness of the Specification as it relates to you.
1EdTech GLC would appreciate receiving your comments and suggestions.
Please contact 1EdTech GLC through our website at .
Please refer to Document Name: 1EdTech LIS Specification Primer v2.0 Final Release v1.0
Date: 30 June 2011
[1] The LDAP bindings use a different set of message and data structures.
[2] 1EdTech GLC has created one such profile for Student Information System/Learning Management System exchanges [LIS, 11c].
[3] We recommend that new users of the 1EdTech GLC LIS Specification start with the 1EdTech GLC LIS Best Practices & Implementation Guide. The examples in this document show how we intend the specification to be used, whereas the Information Model and WSDL Binding documents contain the formal description of the services, data structures, their syntax and semantics.