Feedback and Account Methods

This document covers the account management and feedback submission methods available in the WebPortal class. These methods enable users to change their account password and submit automated feedback forms for enrolled courses.

For information about authentication and session lifecycle, see Authentication and Session Management. For other account-related data retrieval methods like personal information, see the respective API reference sections.

Overview

The jsjiit library provides two primary account-related operations:

Both methods are defined in the WebPortal class and require an active authenticated session.

Sources: src/wrapper.js223-237 src/wrapper.js577-670

Method Signatures

change_password

async change_password(old_password, new_password)

Changes the password for the currently logged-in student account.

Parameters:

• old_password (string): Current password for verification
• new_password (string): New password to set

Returns: Promise<Object> - Response object indicating success or failure

Throws: AccountAPIError - When password change fails due to incorrect old password, policy violations, or API errors

Sources: src/wrapper.js223-237

fill_feedback_form

async fill_feedback_form(feedback_option)

Automatically retrieves all registered courses for the current semester and submits feedback forms with the specified rating for all questions across all subjects.

Parameters:

• feedback_option (string): Rating value from FeedbackOptions enum

Returns: Promise<void> - Completes when all feedback forms are submitted

Throws: APIError - On API communication failures

Sources: src/wrapper.js577-670

FeedbackOptions Enumeration

The FeedbackOptions object defines valid rating values for feedback form submission. It is a frozen object that acts as an enumeration.

The enumeration is defined in src/feedback.js1-11 and exported as a frozen object to prevent modification at runtime.

Sources: src/feedback.js1-11

Password Change Flow

Implementation Details:

The change_password method constructs a payload containing:

• membertype: Retrieved from this.session.membertype
• oldpassword: The current password for verification
• newpassword: The new password to set
• confirmpassword: Duplicate of new password for confirmation

The method uses the /clxuser/changepassword endpoint and specifies AccountAPIError as the exception type for error handling, which is passed to the internal __hit method via the exception option.

Sources: src/wrapper.js223-237

Feedback Form Submission Flow

The fill_feedback_form method implements a complex multi-step process to automate feedback submission for all enrolled courses.

Sources: src/wrapper.js577-670

Feedback Submission Process Details

The feedback submission process consists of the following stages:

Stage 1: Retrieve Feedback Event

The method calls the /feedbackformcontroller/getFeedbackEvent endpoint to get available feedback events. It selects the latest event from response.eventList and extracts:

• eventcode: Semester code
• eventid: Event identifier
• eventdescription: Event description

Sources: src/wrapper.js578-587

Stage 2: Retrieve Grid Data

Using the eventid from Stage 1, the method calls /feedbackformcontroller/getGriddataForFeedback with a serialized payload containing:

• instituteid
• studentid
• eventid

The response contains gridData, an array of objects representing each enrolled subject-faculty combination.

Sources: src/wrapper.js589-596

Stage 3: Process Each Subject

For each item in gridData, the method constructs a question_feedback_payload containing:

Sources: src/wrapper.js601-616

Stage 4: Retrieve and Submit Questions

For each subject payload:

1. Fetch Questions: Call /feedbackformcontroller/getIemQuestion with the payload
2. Error Handling: Use try-catch to skip subjects that fail (continue to next iteration)
3. Validate Response: Check for questionList in response, skip if missing
4. Map Ratings: Transform each question object by adding rating: feedback_option
5. Serialize Payload: Create save payload with serialize_payload()
6. Submit: POST to /feedbackformcontroller/savedatalist

The final save payload structure:

{
  instituteid: string,
  studentid: string,
  eventid: string,
  subjectid: string,
  facultyid: string,
  registrationid: string,
  questionid: Array<{...question, rating: feedback_option}>,
  facultycomments: null,
  coursecomments: null
}

Sources: src/wrapper.js620-669

Code Entity Mapping

Sources: src/wrapper.js223-237 src/wrapper.js577-670 src/feedback.js1-11

Usage Examples

Changing Password

const portal = new WebPortal();
await portal.student_login('username', 'current_password');

try {
  const result = await portal.change_password('current_password', 'new_password');
  console.log('Password changed successfully:', result);
} catch (error) {
  if (error instanceof AccountAPIError) {
    console.error('Failed to change password:', error.message);
  }
}

Submitting Feedback

import { WebPortal } from 'jsjiit';
import FeedbackOptions from 'jsjiit/feedback';

const portal = new WebPortal();
await portal.student_login('username', 'password');

// Submit "EXCELLENT" rating for all courses
await portal.fill_feedback_form(FeedbackOptions.EXCELLENT);

// Alternative: use string directly
await portal.fill_feedback_form("VERY_GOOD");

Sources: test.html35 README.md33-38 src/feedback.js1-11

Error Handling

Both methods implement specific error handling strategies:

change_password Errors

The method specifies AccountAPIError as the exception type, which is thrown when:

• The old password is incorrect
• The new password violates password policy requirements
• The API endpoint returns a non-Success status
• Network or CORS errors occur

Sources: src/wrapper.js223-237 src/exceptions.js1

fill_feedback_form Errors

The method implements defensive error handling:

• Try-Catch Blocks: Each subject's question retrieval is wrapped in try-catch; errors cause the method to skip that subject and continue
• Response Validation: Checks for questionList existence before processing; missing data causes the iteration to continue
• Generic APIError: Inherits default error handling from __hit method
• Silent Failures: Individual subject failures do not abort the entire process

Sources: src/wrapper.js621-628 src/wrapper.js631-640

Authentication Requirements

Both methods are decorated with the authenticated wrapper, which verifies that this.session is not null before execution. The methods are listed in the authenticatedMethods array at src/wrapper.js692-715

If called without an active session, both methods will throw a NotLoggedIn exception before any API calls are made.

Sources: src/wrapper.js679-719

API Endpoint Reference

Note that fill_feedback_form uses serialize_payload() for the grid data and save data endpoints, indicating these payloads are encrypted using AES-CBC encryption. For details on the encryption mechanism, see Encryption and Security.

Sources: src/wrapper.js224 src/wrapper.js578 src/wrapper.js589 src/wrapper.js617 src/wrapper.js618