Course Requests

Course requests cannot be entered via My BackPack at this time, but you can implement custom functionality to allow students to enter and/or update course requests for the next academic year. There are methods in the AcademicService to retrieve existing course requests, insert new course requests, update existing or pending course requests, and to delete existing or pending course requests. Any course requests entered or modified in this way do not immediately update the Ascendance database; they are subject to a review and approval process by school personnel, and therefore remain in a ‘pending’ status until that process is complete.

Note
If you need to obtain a master list of courses by school/division, see Courses and Sections.

Each of these operations (other than just retrieving existing course requests) returns a Result data object which includes the IsSuccess property to indicate whether the operation was successful, and if not, the object also provides an ErrorCode to identify the problem and Message which you can display to the user if applicable. See the Result.ErrorCode property for a list of all the possible errors so that you can provide appropriate logic to handle them.

Retrieving Existing Course Requests

The getCourseRequests method retrieves existing course requests. You can optionally use parameters to limit the retrieval to a specific student, grade, and/or course ID, and to indicate whether or not to include pending (unapproved) requests in the retrieval.

Inserting Course Requests

The insertCourseRequest method creates a new course request. The CourseRequest object must include at a minimum the school ID, student ID, and course ID, and can optionally include one or two alternate selections, a priority code, and/or a requested term.

Updating Course Requests

The updateCourseRequest method allows you to make changes to a course request. For pending requests, this method will update the pending record, and for existing course requests, this will create a pending change record which must be approved by school personnel. The parameters for this method require you to reference the previous request (by school ID, student ID, and course ID) and to provide the complete data object for the updated request.

Deleting Course Requests

The deleteCourseRequest method marks an existing course request for removal (which must still be approved by the school), and the deletePendingCourseRequest method completely removes a pending course request.