1EdTech Final Release

1EdTech logo

1EdTech Learning Information Services Specification

Version 2.0.1

Final Release

Date Issued: 30 September 2013

Latest version: http://www.imsglobal.org/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 1EdTechs procedures with respect to rights in 1EdTech specifications can be found at the 1EdTech Intellectual Property Rights web page: http://www.imsglobal.org/ipr/imsipr_policyFinal.pdf.

Use of this specification to develop products or services is governed by the license with 1EdTech found on the 1EdTech website: http://www.imsglobal.org/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 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 a Web Services infrastructure (based upon a SOAP/http transport mechanism).

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. 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. 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.

The LIS documentation set consists of:

· Information Models – these documents contain the normative description of the various service definitions, data structures and their relationships. These descriptions use the Unified Modeling Language (UML). Each of the six services has its own Information Model;

· WSDL Bindings – these documents contain the Platform Specific Model (PSM) for the service. This PSM has been transformed into the corresponding WSDL/XSD files using the 1EdTech Binding Auto-generation Tool-kit (I-BAT). The Binding document describes the underlying structure of the WSDL/XSD, the associated vocabulary files and the formats of the corresponding SOAP messages;

· Best Practice & Implementation Guide – this document is intended to provide vendors with an overall understanding of the 1EdTech LIS Specification, the relationship of the specification with other 1EdTech specifications, and a best practices guide derived from experiences of those using the specification. The guide also includes several examples that describe how vendors can make the best use of the 1EdTech LIS Specification;

· Core Profile & Conformance Specification – the Core Profile defines the minimal subset of the functionality that must be supported by systems developed for deployment between a Student Information System and a Learning Management System. This Profile (there is a Core plus several Additions) defines the set of operations and data models that must be supported by the systems implementing 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 Profile.

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. This includes a summary of the changes from the 1EdTech Enterprise Services v1.0 specification;
4. Using the New Version	Provides an overview of the various ways in which this specification can be used to support different learning administration requirements;
5. The Document Set	Lists and explains the set of documents produced as part of the specification. This includes an explanation of the relevant set of 1EdTech GLC Specification Development Notes;
Appendix A: Person Management Service 2.0 Overview	An overview of the operations provided in the Person Management Service;
Appendix B: Group Management Service 2.0 Overview	An overview of the operations provided in the Group Management Service;
Appendix C: Membership Management Service 2.0 Overview	An overview of the operations provided in the Membership Management Service;
Appendix D: Course Management Service 1.0 Overview	An overview of the operations provided in the Course Management Service;
Appendix E: Outcomes Management Service 1.0 Overview	An overview of the operations provided in the Outcomes Management Service;
Appendix F: Bulk Data Exchange Management Service 1.0 Overview	An overview of the operations provided in the Bulk Data Exchange Management Service.

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 General Web Services, to support the exchange of the information based upon the Enterprise v1.1 data model.

Operation	Description
createPerson	To request the creation of a populated Person object on the target system where the source is responsible for the allocation of the unique identifier.
createByProxyPerson	To request the creation of a populated Person object on the target system where the target is responsible for the allocation of the unique identifier.
deletePerson	To request the deletion of a Person object. The Person object is deleted and all of its associated Memberships.
readPerson	To read the full contents of the identified Person object. The target must return all of the data it has for the identified Person object.
readPersonCore	To read the minimal mandatory contents of the identified Person object. Only the data structures that form the core of a Person object must be returned.
readAllPersonIds	To obtain the set of identifiers which have been assigned to Person objects.
readPersonIdsFromSavePoint	To obtain the set of identifiers for Person objects which have been altered since the requested reference point. The reference point is set as ‘zero’ at creation and incremented after every write operation.
readPersons	To obtain the Person objects for a defined set of identifiers. This results in a single transaction that may require the exchange of a large volume of data in the response message.
readPersonsFromSavePoint	To obtain the set of Person objects which have been altered since the requested reference point. The reference point is set as ‘zero’ at creation and incremented after every write operation. This results in a single transaction that may require the exchange of a large volume of data in the response message.
updatePerson	To write new content into the identified Person object. The target must write the new data into the Person object. This is an additive operation.
replacePerson	To replace the content of the identified Person object. The target must write the new data into the Person object. This is a destructive write-over of all of the original information. If the Person object does not exist, this operation acts as per a ‘createPerson’ request.
discoverPersonIds	To obtain the set of identifiers for Person objects whose properties agree with those defined in the query.
changePersonIdentifier	To change the SourcedId of the Person object. The completion of this operation will result in later actions using the original SourcedId reporting an unknown identifier status.

Operation	Description
createGroup	To request the creation of a populated Group object on the target system where the source is responsible for the allocation of the unique identifier.
createByProxyGroup	To request the creation of a populated Group object on the target system where the target is responsible for the allocation of the unique identifier.
deleteGroup	To request the deletion of a Group. All of the associated Membership objects are also deleted.
addGroupRelationship	To request the creation of a relationship between two Group objects. This does not create the Group objects themselves.
removeGroupRelationship	To request the deletion of a relationship between two Group objects. This does not delete the Group objects themselves.
readGroup	To read the full contents of the identified Group object. The target must return all of the data it has for the identified Group object.
readAllGroupIds	To obtain the set of identifiers which have been assigned to Group objects.
readGroupIdsForPerson	To read the identifiers for all of the Group objects associated with the identified Person object.
readGroupIdsFromSavePoint	To obtain the set of identifiers for Group objects which have been altered since the requested reference point. The reference point is set as ‘zero’ at creation and incremented after every write operation.
readGroups	To obtain the Group objects for a defined set of identifiers. This results in a single transaction that may require the exchange of a large volume of data in the response message.
readGroupsFromSavePoint	To obtain the set of Group objects which have been altered since the requested reference point. The reference point is set as ‘zero’ at creation and incremented after every write operation. This results in a single transaction that may require the exchange of a large volume of data in the response message.
updateGroup	To write new content into the identified Group object. The target must write the new data into the Group object. This is an additive operation.
replaceGroup	To replace the content of the identified Group object. The target must write the new data into the Group object. This is a destructive write-over of all of the original information. If the Group object does not exist, this operation acts as per a ‘createGroup’ request.
discoverGroupIds	To obtain the set of identifiers for Group objects whose properties agree with those defined in the query/filter.
changeGroupIdentifier	To change the identifier of the Group object. The completion of this operation will result in later actions using the original identifier reporting an unknown identifier status.

Operation	Description
createMembership	To request the creation of a populated Membership object on the target system where the source is responsible for the allocation of the unique identifier.
createByProxyMembership	To request the creation of a populated Membership object on the target system where the target is responsible for the allocation of the unique identifier.
deleteMembership	To request the deletion of a Membership object. The Membership object is deleted along with all of its associated relationships (the associated Group, Course and Person objects are not deleted).
readMembership	To read the full contents of the identified Membership object. The target must return all of the data it has for the identified Membership object.
readMembershipIdsForPerson	To obtain the set of identifiers for all of the Membership objects for the identified Person object.
readMembershipIdsForPersonWithRole	To obtain the set of identifiers for all of the Membership objects for the identified Person object with a specific Member Role.
readMembershipIdsForCollection	To obtain the set of identifiers for all of the Membership objects for the identified collection object i.e., Group, CourseTemplate, CourseOffering, CourseSection or SectionAssociation.
readAllMembershipIds	To obtain the set of identifiers which have been assigned to Membership objects.
readMembershipIdsFromSavePoint	To obtain the set of identifiers for Membership objects which have been altered since the requested reference point. The reference point is set as ‘zero’ at creation and incremented after every write operation.
readMemberships	To obtain the Membership objects for a defined set of identifiers. This results in a single transaction that may require the exchange of a large volume of data in the response message.
readMembershipsFromSavePoint	To obtain the set of Membership objects which have been altered since the requested reference point. The reference point is set as ‘zero’ at creation and incremented after every write operation. This results in a single transaction that may require the exchange of a large volume of data in the response message.
updateMembership	To write new content into the identified Membership object. The target must write the new data into the Membership object. This is an additive operation.
replaceMembership	To replace the content of the identified Membership object. The target must write the new data into the Membership object. This is a destructive write-over of all of the original information. If the Membership object does not exist, this operation acts as per a ‘createMembership’ request.
discoverMembershipIds	To obtain the set of identifiers for Membership objects whose properties agree with those defined in the query.
changeMembershipIdentifier	To change the SourcedId of the Membership record. The completion of this operation will result in subsequent actions using the original SourcedId reporting an unknown identifier status.

Operation	Description
createCourseTemplate	To request the creation of a populated CourseTemplate object on the target system where the source assigns the unique identifier.
createByProxyCourseTemplate	To request the creation of a populated CourseTemplate object on the target system where the target assigns the unique identifier.
deleteCourseTemplate	To request the deletion of a CourseTemplate object. The CourseTemplate object is deleted and all of its associated relationships.
readCourseTemplate	To read the full contents of the identified CourseTemplate object. The target must return all of the data it has for the CourseTemplate object.
readAllCourseTemplateIds	To obtain the set of SourcedIds which have been assigned to CourseTemplate objects.
readCourseOfferingIdsForCourseTemplate	To obtain the set of SourcedIds of the CourseOfferings associated with the CourseTemplate.
readCourseTemplateIdsFromSavePoint	To obtain the set of SourcedIds for CourseTemplates objects which have been altered since the requested reference point. The reference point is set as zero at creation and incremented after every write operation.
readCourseTemplates	To get the CourseTemplate objects for a defined set of SourcedIds. This results in a single transaction that may require the exchange of a large volume of data in the response message.
readCourseTemplatesFromSavePoint	To obtain the set of CourseTemplate objects which have been altered since the requested reference point. The reference point is set as ‘zero’ at creation and incremented after every write operation. This results in a single transaction that may require the exchange of a large volume of data in the response message.
updateCourseTemplate	To write new content into the identified CourseTemplate object. The target must write the new data into the CourseTemplate object. This is an additive operation.
replaceCourseTemplate	To replace the content of the identified CourseTemplate object. The target must write the new data into the CourseTemplate object. This is a destructive write-over of all of the original information. If the CourseTemplate object does not exist, this operation acts as per a ‘createCourseTemplate’ request.
discoverCourseTemplateIds	To obtain the set of SourcedIds for CourseTemplate objects whose properties agree with those defined in the query.
changeCourseTemplateIdentifier	To change the SourcedId of the CourseTemplate record. The completion of this operation will result in later actions using the original SourcedId reporting an unknown identifier status.

Operation	Description
createCourseOffering	To request the creation of a populated CourseOffering object on the target system where the source is responsible for the allocation of the unique identifier.
createByProxyCourseOffering	To request the creation of a populated CourseOffering object on the target system where the target is responsible for the allocation of the unique identifier.
createCourseOfferingFromCourseOffering	To create a new CourseOffering from the supplied CourseOffering for a particular academic session.
deleteCourseOffering	To request the deletion of a CourseOffering object. The CourseOffering object is deleted and all of its associated relationships.
readCourseOffering	To read the full contents of the identified CourseOffering object. The target must return all of the data it has for the identified CourseOffering object.
readAllCourseOfferingIds	To obtain the set of SourcedIds which have been assigned to CourseOffering objects.
readAllActiveCourseOfferingIdsForAcademicSession	To obtain the set of SourcedIds for all of the active CourseOfferings for the identified academic session.
readCourseSectionIdsForCourseOffering	To obtain the set of SourcedIds of the CourseSections associated with the CourseOffering.
readCourseOfferingIdsFromSavePoint	To obtain the set of SourcedIds for CourseOfferings objects which have been altered since the requested reference point. The reference point is set as ‘zero’ at creation and incremented after every write operation.
readCourseOfferings	To obtain the CourseOffering objects for a defined set of identifiers. This results in a single transaction that may require the exchange of a large volume of data in the response message.
readCourseOfferingsFromSavePoint	To obtain the set of CourseOffering objects which have been altered since the requested reference point. The reference point is set as ‘zero’ at creation and incremented after every write operation. This results in a single transaction that may require the exchange of a large volume of data in the response message.
replaceCourseOffering	To replace the content of the identified CourseOffering object. The target must write the new data into the CourseOffering object. This is a destructive write-over of all of the original information. If the CourseOffering object does not exist, this operation acts as per a ‘createCourseOffering’ request.
updateCourseOffering	To write new content into the identified CourseOffering object. The target must write the new data into the CourseOffering object. This is an additive operation.
updateCourseOfferingStatus	To change the status of the identified CourseOffering to the supplied value.
discoverCourseOfferingIds	To obtain the set of SourcedIds for CourseOffering objects whose properties agree with those defined in the query.
changeCourseOfferingIdentifier	To change the SourcedId of the CourseOffering record. The completion of this operation will result in later actions using the original SourcedId reporting an unknown identifier status.

Operation	Description
createCourseSection	To request the creation of a populated CourseSection object on the target system where the source is responsible for the allocation of the unique identifier.
createByProxyCourseSection	To request the creation of a populated CourseSection object on the target system where the target is responsible for the allocation of the unique identifier.
createCourseSectionFromCourseSection	To create a new CourseSection from the supplied CourseSection for a particular academic session.
deleteCourseSection	To request the deletion of a CourseSection object. The CourseSection object is deleted along with all of its associated Memberships.
readCourseSection	To read the full contents of the identified CourseSection object. The target must return all of the data for the identified CourseSection object.
readAllCourseSectionIds	To obtain the set of sourcedIds which have been assigned to CourseSection objects.
readCourseSectionIdsFromSavePoint	To obtain the set of sourcedIds for CourseSection objects which have been altered since the supplied reference point. The reference point is set as ‘zero’ at creation and incremented after every write operation.
readCourseSections	To obtain the CourseSection objects for a defined set of identifiers. This results in a single transaction that may require the exchange of a large volume of data in the response message.
readCourseSectionsFromSavePoint	To obtain the set of CourseSection objects which have been altered since the requested reference point. The reference point is set as ‘zero’ at creation and incremented after every write operation. This results in a single transaction that may require the exchange of a large volume of data in the response message.
replaceCourseSection	To replace the content of the identified CourseSection object. The target must write the new data into the CourseSection object. This is a destructive write-over of all of the original information. If the CourseSection object does not exist, this operation acts as per a ‘createCourseSection’ request.
updateCourseSection	To write new content into the identified CourseSection object. The target must write the new data into the CourseSection object. This is an additive operation.
updateCourseSectionStatus	To change the status of the identified CourseSection.
discoverCourseSectionIds	To obtain the set of SourcedIds for CourseSection objects whose properties agree with those defined in the query.
changeCourseSectionIdentifier	To change the SourcedId of the CourseSection record. The completion of this operation will result in later actions using the original SourcedId reporting an unknown identifier status.

Operation	Description
createSectionsAssociation	To request the creation of a populated SectionsAssociation object on the target system where the source is responsible for the allocation of the unique identifier.
createByProxySectionsAssociation	To request the creation of a populated SectionsAssociation object on the target system where the target is responsible for the allocation of the unique identifier.
deleteSectionAssociation	To request the deletion of a SectionAssociation object. The SectionAssociation object is deleted and all associated relationships.
readSectionAssociation	To read the full contents of the identified SectionAssociation object. The target must return all of the data it has for the identified SectionAssociation object.
readAllSectionsAssociationIds	To obtain the set of SourcedIds which have been assigned to SectionAssociation objects.
readSectionAssociationIdsFromSavePoint	To obtain the set of SourcedIds for SectionAssociations objects which have been altered since the requested reference point. The reference point is set as ‘zero’ at creation and incremented after every write operation.
readCourseSectionAssociations	To obtain the SectionAssociation objects for a defined set of identifiers. This results in a single transaction that may require the exchange of a large volume of data in the response message.
readSectionAssociationsFromSavePoint	To obtain the set of SectionAssociation objects which have been altered since the requested reference point. The reference point is set as ‘zero’ at creation and incremented after every write operation. This results in a single transaction that may require the exchange of a large volume of data in the response message.
addCourseSection	To add a new Course Section identifier to the SectionAssociation.
removeCourseSection	To remove a Course Section identifier from the SectionAssociation.
replaceSectionAssociation	To replace the content of the identified SectionAssociation object. The target must write the new data into the SectionAssociation object. This is a destructive write-over of the original information. If the SectionAssociation object does not exist, this operation acts as per a ‘create SectionAssociation’ request.
updateSectionAssociation	To write new content into the identified SectionAssociation object. The target must write the new data into the SectionAssociation object. This is an additive operation.
discoverSectionAssociationIds	To obtain the set of sourcedIds for SectionAssociation objects whose properties agree with those defined in the query.
changeSectionAssociationIdentifier	To change the sourcedId of the SectionAssociation record. The completion of this operation will result in later actions using the original sourcedId reporting an unknown identifier status.

Operation	Description
createLineItem	To request the creation of a populated LineItem object on the target system where the source is responsible for the allocation of the unique SourcedId.
createByProxyLineItem	To request the creation of a populated LineItem object on the target system where the target is responsible for the allocation of the unique SourcedId.
deleteLineItem	To request the deletion of a LineItem object. The LineItem object is deleted with all of its associated relationships.
readLineItem	To read the full contents of the identified LineItem object. The target must return all of the data it has for the identified LineItem object.
readAllLineItemIds	To obtain all the SourcedIds assigned to LineItem objects.
readLineItemIdsWithLineItemType	To obtain the set of SourcedIds for the LineItem objects which have a particular state.
readLineItemIdsForPerson	To obtain the set of SourcedIds for the LineItem objects which are associated with a particular Person object.
readLineItemIdsForCourseOffering	To obtain the set of SourcedIds for the LineItem objects which are associated with a particular CourseOffering object.
readLineItemIdsForCourseSection	To obtain the set of SourcedIds for the LineItem objects which are associated with a particular CourseSection object.
readLineItemIdsForCourseSectionWithLineItemType	To obtain the set of SourcedIds for the LineItem objects with the required state, which are associated with a particular CourseSection object.
readLineItemIdsFromSavePoint	To obtain the set of SourcedIds for LineItem objects which have been altered since the requested reference point. The reference point is set as ‘zero’ at creation and incremented after every write operation.
readLineItems	To obtain the LineItem objects for a defined set of SourcedIds. This results in a single transaction that may require the exchange of a large volume of data in the response message.
readLineItemsFromSavePoint	To obtain the set of LineItem objects which have been altered since the requested reference point. The reference point is set as ‘zero’ at creation and incremented after every write operation. This results in a single transaction that may exchange a large volume of data in the response.
updateLineItem	To write new content into the identified LineItem object. The target must write the new data into the LineItem object. This is an additive operation.
replaceLineItem	To replace the content of the identified LineItem object. The target must write the new data into the LineItem object. This is a destructive write-over of all of the original information. In the case of the object not existing, this operation acts as an implied ‘createLineItem’.
discoverLineItemIds	To obtain the set of SourcedIds for LineItem objects whose properties agree with those defined in the query/filter.
changeLineItemIdentifier	To change the SourcedId for a LineItem object.

Operation	Description
announceBulkDataExchange	To announce the availability of a bulk data object that is ready to be retrieved by service consumers. This call suspends real-time event notification
announceFailureBulkDataExchange	To inform the service consumer that a previously issued, and acknowledged, requestBulkDataExchange transaction cannot be serviced by the service provider.
reportBulkDataExchange	To report the retrieval of the bulk data object whose availability was announced previously. This signals real-time event processing should be restarted.
requestBulkDataExchange	Issued by the service consumer to request a bulk data exchange from the service provider.
ignoreBulkDataExchange	Issued by the service consumer to inform the service provider that a previously issued announce bulk data exchange request will be ignored. Real-time processing should be resumed by both consumer and server.
cancelBulkDataExchange	Issued by the service consumer to inform the service provider that a previously requested bulk data exchange request has now been cancelled. Real-time processing should be resumed by both consumer and server.

Operation	Description
createResult	To request the creation of a populated Result object on the target system where the source allocates the unique SourcedId. The Result object is tied to a LineItem object.
createByProxyResult	To request the creation of a populated Result object on the target system where the target allocates the unique SourcedId. The Result object is tied to a LineItem object.
deleteResult	To request the deletion of a Result object. The Result object is deleted but the associated ResultValue and LineItems remain.
readResult	To read the full contents of the identified Result object. The target must return all of the data it has for the identified Result object.
readAllResultIds	To obtain the set of SourcedIds assigned to Result objects.
readResultIdsForPerson	To obtain the set of SourcedIds for the Result objects which are associated with a particular Person object.
readResultIdsForLineItem	To obtain the set of SourcedIds for the Result objects which are associated with a particular LineItem object.
readResultIdsForCourseOffering	To obtain the set of SourcedIds for the Result objects which are associated with a particular CourseOffering object.
readResultIdsForCourseSection	To obtain the set of SourcedIds for the Result objects which are associated with a particular CourseSection object.
readResultIdsForCourseSectionWithStatus	To obtain the set of SourcedIds for the Result objects that are associated with a particular CourseSection object and have results of a particular status.
readResultIdsForLineItemWithLineItemType	To obtain the SourcedIds for the Result objects that are associated with a LineItem that has a particular LineItemType state.
readResultIdsFromSavePoint	To obtain the set of identifiers for Result objects which have been altered since the requested reference point. The reference point is set as ‘zero’ at creation and incremented after every write operation.
readResults	To obtain the Result objects for a defined set of identifiers. This results in a single transaction that may exchange of a large volume of data.
readResultsFromSavePoint	To obtain the set of Result objects which have been altered since the requested reference point. The reference point is set as ‘zero’ at creation and incremented after every write operation. This results in a single transaction that may require the exchange of a large volume of data in the response message.
updateResult	To add content to the identified Result object. The target must write the new data into the Result object. This is an additive operation.
replaceResult	To replace the content of the identified Result object. The target must write the new data into the Result object. This is a destructive write-over of all of the original information. In the case of the object not existing, this operation acts as an implied ‘createResult’.
replaceResultsForLineItem	To replace the content of the identified Result objects for a given result status for the specified LineItem. The target must write the new data into the Result object. This is a destructive write-over of all of the original information.
discoverResultIds	To obtain the set of SourcedIds for Result objects whose properties agree with those defined in the query/filter.
changeResultIdentifier	To change the SourcedId of a Result object.

Operation	Description
createResultValue	To request the creation of a populated ResultValue object on the target system. The source is responsible for the allocation of the unique SourcedId.
createByProxyResultValue	To request the creation of a populated ResultValue object on the target system. The target is responsible for the allocation of the unique SourcedId.
deleteResultValue	To request the deletion of a ResultValue object. The ResultValue object is deleted along with all of its associated relationships.
readResultValue	To read the full contents of the identified ResultValue object. The target must return all of the data it has for the identified ResultValue object.
readAllResultValueIds	To obtain the set of SourcedIds that have been assigned to ResultValue objects.
readResultValueIdForLineItem	To obtain the SourcedId for the ResultValue object which has been associated with a particular LineItem object.
readResultValueIdForResult	To obtain the SourcedId for the ResultValue object which is associated with a particular Result object.
readResultValueIdsFromSavePoint	To obtain the set of identifiers for ResultValue objects which have been altered since the requested reference point. The reference point is set as ‘zero’ at creation and incremented after every write operation.
readResultValues	To obtain the ResultValue objects for a defined set of identifiers. This results in a single transaction that may require the exchange of a large volume of data in the response message.
readResultValuesFromSavePoint	To obtain the set of ResultValue objects which have been altered since the requested reference point. The reference point is set as ‘zero’ at creation and incremented after every write operation. This results in a single transaction that may exchange of a large volume of data in the response message.
updateResultValue	To write new content into the identified ResultValue object. The target must write the new data into the ResultValue object. This is an additive operation.
replaceResultValue	To replace the content of the identified ResultValue object. The target must write the new data into the ResultValue object. This is a destructive write-over of all of the original information. In the case of the object not existing, this operation acts as an implied ‘createResultValue’.
discoverResultValueIds	To obtain the set of SourcedIds for ResultValue objects whose properties agree with those defined in the query/filter.
changeResultValueIdentifier	To change the SourcedId for a ResultValue object.

Version No.	Release Date	Comments
LIS Final Release v2.0	30 June 2011	The first formal release of the Final Release version of this document.
Final Release v2.0.1	30 September 2013	Corrections

Executive Summary

1 Introduction

1.1 Learning Information Service Systems

1.2 The Scope and Context

1.3 Structure of this Document

1.4 Nomenclature

1.5 References

2 The Learning Information Services Specification

2.1 Core Use-cases

2.1.1 Management and Manipulate Information about People

2.1.2 Management and Manipulate Enrolment of People on Courses

2.1.3 Management and Manipulate Organizational Structures

2.1.4 Management and Manipulate Course Structure Information

2.1.5 Management and Manipulate of Grade Book Information

2.1.6 Batch Processing

2.2 An Abstract Representation

2.3 Building Real Systems

3 The Historic Perspective

3.1 Past Versions

3.2 A Summary of Changes from Version 1

3.2.1 Person Management Service

3.2.2 Group Management Service

3.2.3 Membership Management Service

3.2.4 Course Management Service

3.2.5 Outcomes Management Service

3.2.6 Bulk Data Exchange Management Service

3.3 Version 2 and Version 1 Compatibility

4 Using the New Version

4.1 Building an Interoperable Solution

4.2 The Core Profiles

4.3 Creating a Profile

4.4 Conformance to a Profile

5 The Document Set

5.1 The Set of Documents

5.1.1 The LIS Specification

5.1.2 Information Models

5.1.3 WSDL Bindings

5.1.4 Best Practice & Implementation Guide

5.1.5 Core Profile & Conformance Specification

5.1.6 Related Documents

5.2 The Binding Files

5.2.1 WSDL Files

5.2.2 XSD Files

5.2.3 Vocabulary Files

5.3 Using the Documents

Appendix A Person Management Service 2.0 Overview

A1 PMS Description

A2 PMS Operations

Appendix B Group Management Service 2.0 Overview

B1 GMS Description

B2 GMS Operations

Appendix C Membership Management Service 2.0 Overview

C1 MMS Description

C2 MMS Operations

Appendix D Course Management Service 1.0 Overview

D1 CMS Description

D2 CMS Operations

D2.1 CourseTemplateManager Interface Description

D2.2 CourseOfferingManager Interface Description

D2.3 CourseSectionManager Interface Description

D2.4 SectionAssociationManager Interface Description

Appendix E Outcomes Management Service 1.0 Overview

E1 OMS Description

E2 OMS Operations

E2.1 LineItemManager Interface Description

E2.2 ResultManager Interface Description

E2.3 ResultValueManager Interface Description

Appendix F Bulk Data Exchange Management Service 1.0 Overview

F1 BDEMS Description

F2 BDEMS Operations

About This Document

List of Contributors

Revision History