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