Courses

A Course is one class in a school, like Mathematics or Art. Because in IMS-ES there is no course object, instead Itslearning uses Groups (hierarchies) for this. So when you create a new Course through IMS-ES you actually are creating a Hierarchy, which has a Course attached to it. This also means that you cannot delete a Course through IMS-Es, you can only delete the linked Hierarchy, Courses must always be deleted through the Itslearning UI.

A Course has the following properties:

Property	Description	Requirements
SyncId	Unique identifier for this Course. (also known as Synchronization Identifier)	Required, max length is 255.
Title	The title of the Course, this is what will be shown in Itslearning.	Required, max length is 64.
Code	The Course Code.	Max length is 64.
Credit	The Course Credit(s), previously called Hours.	Max length is 64.
LinkedHierarchy	The Linked hierarchy of the Course.	Required

Creating a new Course

As with creating a User, when you are creating a new Course the SyncId must always be given. The other properties can be set later on, or when defining the object:

Course newCourse = new Course(“syncId”)
    {
        Title = “Title”,
        Code = “Code”,
        etc.
     };

It is also possible to give the linked hierarchy right when creating the Course, as the SyncIds of the Course and Hierarchy have to match:

Course newCourse = new Course(linkedHierarchy)
    {
        Title = “Title”,
        Code = “Code”,
        etc.
     };

Functions

In the IMS-ES Template the following functions are connected to a Course:

CreateCourse
CreateCourses

ReadCourses
ReadCoursesFromUser

UpdateCourse
UpdateCourses
ReplaceCourse
ReplaceCourses