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