Updating Courses

These functions updates the given Coursein Itlearning, by changing the properties that are given in the Course object.

UpdateCourse

This function updates the given Course in Itslearning, by changing the properties that are given in the course object. Changing the SyncId of a Course has to be done with the ChangeCourseId function.

Syntax:

OperationResult warning = ImsEsClient.UpdateCourse(Course updatedCourse);

Parameters:

updatedCourse:

The Course object containing the updated properties.

Returns:

The OperationResult containing the warning that Itslearning has send back, or if there was none, null.

Exceptions:

  • ImsEsException: If IMS-ES encountered an error in Itslearning, this exception will be thrown.

  • ValidationException: If the updated Course is not valid (properties too long) this exception will be thrown.

UpdateCourses

This function updates the given Courses in Itlearning, by changing the properties that are given in the course objects.

Syntax:

BatchOperationResult warnings = ImsEsClient.UpdateCourses(ICollection<Course> updatedCourses);

Parameters:

updatedCourses:

An ICollection with the Course objects containing the updated properties.

Returns:

A BatchOperationResult with the list of warnings that Itslearning has send back (this list can be empty).

Exceptions:

  • ImsEsBatchException: If IMS-ES encountered an error in Itslearning, this exception will be thrown.

  • ValidationException: If one of the updated Courses is not valid (properties too long) this exception will be thrown.

ReplaceCourse

This function replaces the given Course in Itslearning, by changing the properties that are given in the course object, and deleting all the properties that are not given. Changing the SyncId of a Course has to be done with the ChangeCourseId function.

Syntax:

OperationResult warning = ImsEsClient.ReplaceCourse(Course updatedCourse);

Parameters:

updatedCourse:

The Course object containing the updated properties.

Returns:

The OperationResult containing the warning that Itslearning has send back, or if there was none, null.

Exceptions:

  • ImsEsException: If IMS-ES encountered an error in Itslearning, this exception will be thrown.

  • ValidationException: If the updated Course is not valid (required properties not filled in, other properties too long) this exception will be thrown.

ReplaceCourses

This function replaces the given Courses in Itslearning, by changing the properties that are given in the course objects, and deleting all the properties that are not given.

Syntax:

BatchOperationResult warnings = ImsEsClient.ReplaceCourses(ICollection<Course> updatedCourses);

Parameters:

updatedCourses:

An ICollection with the Course objects containing the updated properties.

Returns:

A BatchOperationResult with the list of warnings that Itslearning has send back (this list can be empty).

Exceptions:

  • ImsEsBatchException: If IMS-ES encountered an error in Itslearning, this exception will be thrown.

  • ValidationException: If one of the updated Courses is not valid (required properties not filled in, other properties too long) this exception will be thrown.