Grade Management using API

Colleges using the Woolf API for resource creation, grade weight assignment, and score submission can follow this guide to ensure seamless grade synchronization with the Academic Management System (AMS).

1. Assign Grade Weights via API

Step 1: Retrieve Grade Weight IDs

Use the course query to fetch a course and view available grade weights.

Step 2: Create Resource and Assign Grade Weight

Use the addResource mutation and include the weightIds field to link the resource to the relevant grade weight.

Important: Do not manually assign weights in AMS for API-integrated colleges as this may cause synchronization errors. Always use the API.

2. Submit Scores

Step 1: Submit Grades

Use the addGrade mutation to submit scores. Include the resourceId, weightId, and studentId.

Step 2: Retrieve Submitted Grades

Use the activities query to retrieve submitted grades for auditing or reporting.

3. Marking Resources as Non-Graded

If a resource does not require grading, set isGradeRequired to false during creation.

Additional Considerations

Error Prevention: Ensure all gradeWeightId and resourceId values match AMS configurations.
Multiple Submissions: The API allows re-submission; the latest grade is used in calculations.

By following these steps, colleges using the Airlock API can manage resource creation, grading weights, and score submissions in full alignment with Woolf AMS.