RIO Ed - Session Grading (Aura)
rio_ed:gradingEnrolledStudents - Component for grading Sessions
Table of Contents
RIO Ed - Session Grading (Aura)
| Component Name | RIO Ed - Session Grading (Aura) |
| API Name | rio_ed:gradingEnrolledStudents |
| Type | Standalone |
| Recommended Pages | Session Page for both internal or digital experience |
| Supported In | Salesforce Internal |
Note:
The RIO Ed - Session Grading (Aura) is a component to grade Sessions.
It should not be confused with another different component, RIO Ed - Sessions For Grading (Aura), which lists out and displays the Sessions that need to be graded.
The RIO Ed - Session Grading (Aura) component enables faculty members to grade students' assignments and exams.
This component is featured in the Faculty Community (in the Grading section) as well as in the admin console (in Session records).
Important
Grade Criteria must be set up first, in order to view the grades on the component, and populate those grade values.
Also, if you have migrated grades, you must also create matching Grade Criteria, to avoid your migrated grades being deleted when you use the component.
See how to create and use Grade Criteria here.
When viewed in the Faculty Community portal:
When viewed in the admin console (the 'Students' tab under the Session record):
Displaying Term Grade
(See also: Grading students' Sessions.)
Grade values set up in Term Grades can be shown in the Session Grading component. From Session Grading component options, tick checkbox 'Show Calculated Grade', and input 'Calculated Grade Field API Name' and 'Calculated Grade Field Label'.
Grade value from the Term Grade record will now show in the Session Grading component.
Supported configuration
Profile Picture Source Object = Picklist (Account, Contact)
Admin can decide the object to retrieve the profile picture (where the profile picture is saved). For person account, please select Account.
Profile Picture File Description
Description of File of Contact to get profile picture from. Defaults to: Profile Picture.
Store Grade Points
(v3.10)
When the "Store Grade Points" is set to Grade, the lower or upper grade from the related grade settings will be stored on the Grade object's 'Grade Points' field.
Term Grade Field Set
(v3.14.3)
If there are custom fields on the Term Grade that you would like to display on the grading wizard, create a field set (on the Term Grade object) containing those custom fields.
Then, edit this component's attribute with the API name of that new field set you have created.
Keep Term Grade Fields Unlocked
(v3.14.3)
If you wish to allow users to continue editing/updating Term Grade fields on the grading wizard after they are locked, enable this attribute (TRUE).
Custom component to display profile images from external data source
(v3.14.4)
If you are storing students' profile images on an external data source, you can create a custom component to display them.
You will need to reference that custom component in the new attribute "Custom Picture Component Name" here.
See here for a generic guide.
Developer section
| Attribute Name | API Name | Description |
| Session Id | sessionId | Session Id to create grades for. |
| Filter Label | filterLabel | Term or Week. |
| Show Filter Search Bar | showFilterSearchBar | Show the filterWeek search bar. Only used for Weekly grading frequency. |
| Week Start Number | weekStart | What day is the start of the week? Monday = 1, Sunday = 7. |
| Show Filter Date Picker | showFilterDatePicker | Show the filterDate date picker. Only used for Weekly grading frequency. |
| Add Year to Week Label | addYearToWeekLabel | Add 2 digit year before the 2 digit week label e.g. Jan 1 2019 = 1901. |
| Course Connection Description Field Expression List | ccDescFieldExprList | Course Connection fields to use as student descriptors e.g. `CourseConnectionFieldName1` - `CourseConnectionFieldName2`, `CourseConnectionField3`. |
| Profile Picture Source Object | profilePicSourceObject | The object of where the profile picture is saved. For person account, please select Account. |
| Profile Picture File Description | profilePicFileDesc | Description of File of Contact to get profile picture from. Defaults to: Profile Picture. |
| Show Parent Grade Criteria | showParentGradeCriteria | Shows the parent Grades from Grade Criteria for marking. |
| Store Grade Points | storeGradePoints | Stores Grade Points when using a Value type grade. Options: None, Grade Points, Grade. |
| Show Grading Period Selection | showGradingPeriodPicklist | Shows the grading period picklist to allow faculty to switch and view the grade for different period. |
| Show Course Offering Grade Criteria | showCourseOfferingCustomGradeCriteria | Show grade criteria for course offering. |
| Show Session Grade Criteria | showSessionCustomGradeCriteria | Show grade criteria for session. |
| Allow Custom Grade Criteria | allowCustomGradeCriteria | Allow faculty to define custom grade criteria. |
| Allow Course Offering Custom Grade Criteria | allowCourseOfferingCustomGradeCriteria | Allow faculty to define custom grade criteria for course offering. |
| Allow Session Custom Grade Criteria | allowSessionCustomGradeCriteria | Allow faculty to define custom grade criteria for session. |
| Student Tile Action | studentTileAction | Action when user click on the student tile. |
| Overview Component Name | overviewCmpName | Lightning Component name to call for when clicking a Student for more details e.g. rio_ed:studentInfo. Takes contactId and programEnrollmentId as parameters. |
| Overview Header | overviewHeader | Header of overviewCmp popup modal. |
| Overview Modal Css Class | overviewModalCssClass | Css class for the overviewCmp popup modal e.g. slds-modal_large. |
| Debug Mode | enableDebug | Enable debug mode. |
| Show Calculated Grade | showCalculatedGrade | Show calculated grade from Term Grade. This is to show/hide the calculated grade field as the last column in the grading grid. |
| Calculated Grade Field API Name | calculatedGradeFieldName | The calculated grade field API name from Term Grade object. |
| Calculated Grade Field Label | calculatedGradeFieldLabel | The calculated grade field label. The field label to be displayed in the grading grid. If left blank, the field label of the "Calculated Grade Field API Name" will be used. |
| Show Save Button | showSaveButton | Show save button to allow users to save the grading. |
| Show Close Button | showCloseButton | Show close button to allow users to close and exit the grading wizard. |
| Student Column Max Width | studentColumnWidth | (v3.8.2) Student column max width e.g. 200px. Supports both px and rem. |
| Respect Grading Period Setting | respectGradingPeriodSetting | (v3.9) Respect the Grading Period Setting based on the selected grading period. |
| Show Grade Menu Items | showGradeMenuItems | (v3.9) Show menu items for each grade column. |
| Grade Menu Item Button Names | gradeMenuItemButtonNames | (v3.9) The grade menu item buttons to be displayed in comma separated value e.g., note, regrade. Supported values are: note, regrade, and resit. |
| Grade Note Field Set Name | gradeInfoFieldSetName | (v3.9) The field set API name for listing additional grade fields on note screen. |
| Grade Regrade Request Field Set Name | gradeRegradeRequestFieldSetName | (v3.9) The field set API name for listing additional grade fields on regrade request screen. The apex only copies across Grade Value and Grade Points. If an additional field is added in the Field Set, the grading component will not copy it. It is recommended to use a flow as a workaround. |
| Grade Resit Request Field Set Name | gradeResitRequestFieldSetName | (v3.9) The field set API name for listing additional grade fields on resit request screen. The apex only copies across Grade Value and Grade Points. If an additional field is added in the Field Set, the grading component will not copy it. It is recommended to use a flow as a workaround. |
| Term Grade Field Set | termGradeFieldSet | (v3.14.3) Term Grade API field set name for extra fields to be displayed on the Grading Wizard. Create a field set on the Term Grade object containing any custom fields, then, paste that field set's API name on this attribute. |
| Keep Term Grade Fields Unlocked | keepTermGradeFieldsUnlocked | (v3.14.3) If enabled (TRUE), the Term Grade Fields on the grading wizard will remain editable even after those fields are locked. |
| Custom Picture Component Name |
customPictureComponentName |
(v3.14.4) Name of a custom component to use in place of the student profile picture. Requires namespace (e.g. rio_ed:examplePictureCmp) See here for generic details. |