The ILT Attendance Feature https://rippleops.atlassian.net/browse/COREDEV-4735 was released in v4.2 and allows organizations to mark an Attended grade for a student's registration. This Attended grade is an external grade with 1/1.
It can be used in completion rules in the usual ways i.e. StudentResultBetterThan(99,Attended) would mark the registration as complete if the student was marked off in the feature.
A standard set up can be found on https://ccltest.marinels.com/Cnt/Root/Carnival/CCL/AttendanceTest/
Standard Permissions (LinkAttributes) Required
System.Capability.CanViewOrgProfileField should be on the org page for OrgAdmin : ALLOW : IsInstructor() and the ORG-Adminstrators group - or it could also be a more general permission group like IsLoggedIn()
System.Capability.CanViewRegistrations should be on the org page for OrgAdmin : ALLOW : IsInstructor() and the ORG-Adminstrators group
System.Capability.CanEditRegistrations is then the final permission needed to enable the Attendance App and this is not something we generally put as standard on the org page. Therefore we can use this to enable the Attendance app by putting it on the course home page for ones where customers want to use this feature.
Note: To work for SuperAdmins these will also need to exist on the Root link page (/Root).
User Filter
Filter by OrgProfileFields
The ILT Attendance allows users to filter the set of users by OrgProfileFields (OPFs). A page attribute needs to exist on the org page and/or course page to specify which OPFs are to be shown.
--AddNavPageAttribute [OrgPath] System.Customer.ILT.ProfileFilterList [comma separated OPF list] (this was used in V4.4 or before)
AddNavPageAttribute [OrgPath] System.Customer.UserProfileFilter.FieldList [comma separated OPF list]Example:
AddNavPageAttribute /Root/MyOrg System.Customer.UserProfileFilter.FieldList "Operating Line,Vessel,Department,Rank"Note, if lots of OPFs are listed this could affect performance.
Filter Pre-Selection
It is also possible to add an attribute to automatically filter to logged-in users' current profile field values e.g. it will automatically filter to my vessel. The page attribute is a follows:
System.Customer.ILT.ProfileFilterPreselectionList : [comma separated OPF list]
Example:
System.Customer.ILT.ProfileFilterPreselectionList : Vessel
Notes:
Selected fields must also exist in System.Customer.ILT.ProfileFilterList
If these attributes exist on the course page these settings will override anything on the org page. Otherwise the org page will be the default for all courses.
Course Grade Book
In order to view the ILT result a specific column (short name=Attended) needs to be added to the Course Grade Book of the course. This is optional as the external grade Attended will be recorded whether the Course Grade Book displays that external grade or not. However, it is highly recommended to add the column for visibility and customer workflow.
Commands to add ILT’s External Grade Columns to Course Grade Book
It is recommended to add 2 columns to the Course Grade Book for ILT grade visibility:
Display the ILT’s external score itself
Display the attendance date (when the external score was created).
The external grade has a hard-coded short name = Attended and must have 1 out of 1. Therefore, the commands to add the Course Grade Book columns are somewhat pre-filled. Fill in the missing parameters like [course_path], [display_order], [header_name] (=display name) below and execute:
AddCourseGradeBookExternalGradeColumn [course_path] [display_order] [header_name] Attended 1
AddCourseGradeBookDateOfAssessmentColumn [course_path] [display_order] [header_name] -shortName:AttendedExample:
AddCourseGradeBookExternalGradeColumn /Root/MyOrg/Covid19 6 "Attended score" Attended 1
AddCourseGradeBookDateOfAssessmentColumn /Root/MyOrg/Covid19 7 "Date Attended" -shortName:AttendedCommand to get the Course Grade Book schema of a course:
GetGradeBookSchema [course_path]
Badge Scanning Tab (ID Entry)
A new tab to scan badges is available if the org NavPage attribute System.Customer.Attendance.BadgeOPF is added at the org path. The value of the NavPage attribute is the OPF name which contains the scanned badge number.
For example addNavPageAttribute /Root/CUK System.Customer.Attendance.BadgeOPF PassNumber
Open Manage > Attendance > ID Entry tab
Click on Start and the PassNumber text box is focused
Scan the card with your scanner (i.e. RFID scanner)
The scanned string is entered into the PassNumber text box and the scanner sends a newline at the end
It automatically creates an attendance record (external grade) for the user identified by the Badge Id (PassNumber)
If more than one or no users are identified by this value the Entry Log will display an error
Note: COREDEV-5922