Creating CourseGroups

With the IMS-ES Template you can easily create CourseGroups in Itslearning. First you have to create a CourseGroup object, as described in the section "CourseGroups". Make sure that the Parent of this CourseGroup is an actual Course in Itslearning! Then you can send this CourseGroup (or even an array of CourseGroup) to Itslearning, where they will be created.

CreateCourseGroup

This function creates a new CourseGroup in Itslearning, with the properties of the given CourseGroup object.

Syntax:

OperationResult warning = ImsEsClient.CreateCourseGroup(CourseGroup newCourseGroup);

Parameters:

newCourseGroup:

The CourseGroup object to be created in Itslearning.

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 new CourseGroup is not valid (required properties not set, other properties too long) this exception will be thrown.

CreateCourseGroups

This function creates several new CourseGroups in Itslearning, with the properties of the given CourseGroup objects.

Syntax:

BatchOperationResult warning = ImsEsClient.CreateCourseGroup(ICollection<CourseGroup> newCourseGroups);

Parameters:

newCourseGroups:

An ICollection with the CourseGroup objects to be created in Itslearning.

Returns:

A BatchOperationResult containing 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 new CourseGroups is not valid (required properties not set, other properties too long) this exception will be thrown.