Skip to main content
ExLibris
  • Subscribe by RSS
  • Ex Libris Knowledge Center

    Configuring Attendance

    campusM Logo wh bkg sm1.png

    For an overview of campusM Attendance including Prerequisites, see campusM Attendance Overview.
    To configure Attendance, select Attendance > Attendance Configuration from the Main Menu. The following configuration page appears:

    The attendance configuration screen.

    Configuring Attendance
    The following sections describe the configuration options available on this page.
    • Enable Attendance — Select to enable Attendance on the user's campusM app.
    • Screen Title — The title that appears in the top header of the service.

    General

    The time and date settings in this section affect the times and dates for the events that are displayed to users. For information concerning acceptable formats, see Moment.js Documentation or https://devhints.io/datetime.
    • Suppress Attendance Excluded Events — Suppress events marked as excluded from the check-in screens.
    • Default Locale — Enter a default location.
    • Time Format — Enter the time format to be used in the service.
    • Date Format (short) — Enter the short date format to be used in the service.
    • Date Format (long) — Enter the long date format to be used in the service.
    • DateTime Format (short) — Enter the short date/time format to be used in the service.
    • DateTime Format (long) — Enter the long date/time format to be used in the service.

    Look and Feel

    • Primary Theme Color — Select a color for the main elements on the page.
    • Secondary Theme Color — Select a color for the secondary elements on the page.

    Student Check-in Settings

    • Student Menu Option Associations — select the menu options to associate with Attendance.
    • Display as Live Tile — select to have the tile display live Attendance information.
    • Add Menu Options — select to associate additional menu options with Attendance.
    • Student Timetable Webservice Endpoint — the name of the timetable that contains each student's class schedule. For more information, see campusM Timetable.
    • Timetable Refresh — Enable in order to call the student's timetable service to refresh their class data on entry to the student check-in screen. The student will only be able to check in once the time table is refreshed. This is only relevant in the case where the Timetable Refresh option is enabled (see Student Check-In Page Overview).

    Student Check-in Window

    • Check-in Window Start — The number of minutes before or after the start of the class that the student can check-in. (Enter a negative value to have the check-in window start before the class starts. Maximum of 60. Default is -5.)
    • Check-in Window End — The number of minutes before or after the end of the class that the student can no longer check-in. (Enter a negative value to have the check-in window end before the class ends. Maximum of 60. Default is 5.)
    • Check-in Window Close Time Based on Padding from Start Time — When checked, the Check-In window closes based on the Start Time instead of the End Time.

    Notification Settings

    • Student Can Disable — Select to allow students to disable attendance reminders.
    • Notification Padding — The number of minutes before or after the start of the class that the student receives a notification. (Enter a negative value to have the notification sent before the class starts. Maximum of 180. Default is -2.)
    • Notification Title (template) — The title of the notification message.
    • Notification Message (template) — The text of the notification message. (Maximum 120 characters). You can include the following substitution codes in curly braces:
      • {className}
      • {startTime}
      • {endTime}
      • {location}
      • {teacherName}
    • Add Notification — Select to add a notification. You can configure up to three notifications.

    Text/Labels

    Enter replacements for titles or labels that appear on the check-in page.

    Geolocation Message

    Enter replacements for titles or labels that appear in geolocation messages.

    Bluetooth Message

    Enter the title and message to display if Bluetooth permissions are required for check-in but are not yet enabled by the user.

    Navigation Bar Labels

    Enter replacements for titles or labels that appear on the check-in page navigation bar.

    Live Tile Configuration

    Enter replacements for titles or labels that appear in the check-in live tiles.

    Help Page

    Enter replacements for titles or labels that appear on the help page. To change the help page contents, select the edit icon in the Content Body field and edit the text or enter contents using the rich text editor.
    Student_Experience.png

    Lecturer Check-In Settings

    • Lecturer Menu Option Associations — Select the menu options to associate with Attendance Lecturers. Lecturer permissions are enabled only for users with access to one or more of these menu options.
    • Add Menu Options — Select to associate additional menu options with Attendance Lecturers.
    • Lecturer Timetable Webservice Endpoint — The name of the timetable that contains each student's class schedule to enable lecturers to check in students. For more information, see campusM Timetable.
    • Timetable Refresh — Enable in order to call the student's timetable service to refresh their class data on entry to the lecturer check-in screen.

    Alternative Lecturer Settings

    The alternative Lecturer feature provides the ability for lecturers or administration staff to search the timetable to locate other teachers’ events so that they can share the One Time Code or check students in if they are covering classes.

    Once enabled, you are required to complete the base URL and configuration for the two required — searchEventsLecture and getStudentsByEventRef.

    For more information on the configuration, see Alternative Lecturer Check-In.

    Notification Settings

    • Lecturer Can Disable — Select to allow lecturers to disable attendance reminders.
    • Notification Padding — The number of minutes before or after the start of the class that the lecturer receives a notification. (Enter a negative value to have the notification sent before the class starts. Maximum of 180. Default is -2.)
    • Notification Title (template) — The title of the notification message.
    • Notification Message (template) — The text of the notification message. (Maximum 120 characters). You can include the following substitution codes in curly braces:
      • {className}
      • {startTime}
      • {endTime}
      • {location}
      • {teacherName}
    • Add Notification — Select to add a notification. You can configure up to three notifications.

    Text/Labels

    Enter replacements for titles or labels that appear on the check-in page.

    Navigation Bar Labels

    Enter replacements for titles or labels that appear on the check-in page navigation bar.
    Lecturer_Experience.png

    Absence Settings

    • Absence Lecturer / Student Reasons — Enter possible reasons from which lecturers and students can select when they want to indicate a reason for an absence. (Maximum 200 characters.)
    • Add Item — Select to add an additional absence reason.
    • Absence Labels — Enter replacements for labels that appear on the Absence page.

    Check-In Types

    The default check-in types for capture and validation, when 'Hybrid Check-in Validation' and 'Check-in Validation By Customer Role' are not applicable.
    Configure the default check-in types used by students to indicate their attendance at a class. For each check-in type, you can select to just Capture the check-in for informational purposes only (Capture) or additionally validate the check-in (Validation), which rejects the check-in if the check-in type is not validated.
    You can select multiple check-in types for validation. However, if you select One Time code it is mandatory to validate the check-in, but if you select both Geolocation and Crowdsource, only one of the two is mandatory to validate the check-in. (However, both technologies must be enabled on the student's device.)
    • One Time Code (Client) — whether to enable one-time codes for checking in to each class. The lecturer receives the code for the class which is given to students with which to check-in.
      • Validate — Select to enable one-time codes.
    • QR Code (Client) — whether to enable QR code for checking in to each class. It can be used in conjunction with the One Time Code validation as an either-or option for checking into a class. The QR code for each location must be based on a text encoding with the following format:
      • {locationRef:"LOCATIONREFERENCE"} — Where the LOCATIONREFERENCE is the customer loc code parsed in the timetable integration feed. The QR check-in type validation is considered valid if the scanned LOCATIONREFERENCE matches that for the class in the timetable. If not, it is invalid.

      • Validate — Select to enable QR codes.

    • Geolocation — Whether to enable geolocation requirements. When students check-in, their current location is sent with their check-in attempt.
      • Capture — Select to enable geolocation data to be sent with the student check-in. If Validate is not also selected, this information is sent for informational purposes only.
      • Validate — Select to reject check-in if the student's current location is not physically close to the class location.
    • Crowdsource — Select to enable the capture of 'visible' iBeacons seen by the student's device when a check-in is made.
      • Capture — Select to enable visible iBeacon data to be sent with the student check-in. If Validate is not also selected, this information is sent for informational purposes only.
      • Validate — Select to reject the check-in if the student is not in range of a 'validated' iBeacon. An iBeacon is considered valid if it has been returned by more than the Valid Percentage of students who have checked in to the class with iBeacon data.
    • IP — Select to determine whether the IP address of the student's device at the time of check-in falls within a customer-defined range.
      • Capture — Select to enable IP data to be sent with the student check-in. If Validate is not also selected, this information is sent for informational purposes only.
      • Validate — Select to reject the check-in if the IP address of the student's device does not fall within a customer-defined range.

    Validation Configuration

    The default validation rules, when 'Hybrid Check-in Validation' and 'Check-in Validation By Customer Role' are not applicable. 

    • Geolocation
      • Tolerance Level — how close the student must be to the class location to allow the check-in to succeed. Set to a lower value if valid check-ins are not validating correctly. Select a value:LOW,MEDIUM(default),HIGH.
    • Crowdsource
      • Valid Percentage — the percentage of users that must have picked up a particular beacon configuration as part of their check-in transaction. An iBeacon is considered valid if it has been returned by more than the Valid Percentage of students who have checked in to the class with said iBeacon configuration.
      • UUID — enter your beacon's UUID
    • IP
      • IP Range From: The beginning of the IP address range to check on the student's device
      • IP Range To: The end of the IP address range to check on the student's device

    Hybrid Check-in Validation

    Custom check-in types for capture and validation, based on the API data returned for the event. This enables administrators to ensure that the check-in validation meets as wide and varied a range of requirements as possible.

    This overrides the Check-in Types and Validation Configuration above, for the users that are attending a matching event (based on the API data).

    Validation List — A list of Check-in TypesValidation Configuration and a Timetable Attribute. It is empty by default. The list is exclusionary, not additive, meaning that if an attribute appears twice, the first set of defined configurations are used, instead of both.

    Attendance Threshold Settings.

    Check-In Validation by User Role

    Check-in types for capture and validation, based on user role. Currently, this only works with customer roles.

    This overrides the Check-in TypesValidation Configuration and Hybrid Check-in Validation above, for the users that have the specified role(s).

    Validation List — A list of Check-in Types and Validation Configuration, separated by role name. By default it is empty. The list is exclusionary, not additive, meaning that if a role appears twice, the first set of defined configurations are used, instead of both.

    Check-In History Settings

    Configure the settings for the check-in history for students and lecturers.
    Check in history settings.
    • Display Dashboard Widget — You can select to display a summary of the student's check-in transactions at the top of their Check-in History. This optional component shows the current proportion of attendance in class, with a graphical breakdown of the check-in outcomes for the selected period.
    • Redirect to Alternative URL— Configure the Attendance page to redirect to a different URL from the History tab. This can be an internal campusM URL, or an external URL. When selecting this checkbox, the URL to Redirect To field appears, where you can fill the URL.
    • Number of Days to be Shown in Lecturer History — Configure
    • Enable Attendance Data Export — Enable lecturers to export attendance data to third party systems.
      • Text Fields — When selecting this option, a number of Text fields will appear. If you leave these fields empty, the default text will display to the lecturer for each field in the Check-in History page. If you want different text to display to the lecturer for any of these fields, add the text in the relevant field. 
      • Date Display Format — The moment.js date format to display dates in, in the Data Export screens.
      • Date Value Format — The moment.js date format to store dates in. This should only be changed if recommended.
      • Attendees Service Batch Call Size — The number of Retrieve Attendees API calls to make in parallel. It defaults to 10.
      • Show Error Details — Show specific error text, for any error during Data Export. 
      • Data Export Vendor — Settings to configure the third party vendor the data is being exported to.
        • Supported vendors:
          • Canvas LMS
        • Integration Profile — The profile (in App Settings > Integration Profiles) that Canvas requires for authentication.
        • API Configuration
          • URL to retrieve the information — The Canvas proxy URL provided to the client by Ex Libris, the same as how the Canvas PI works.
          • Use SIS User ID — Tick this box if exportVendorId in Retrieve Attendees returns the user's SIS ID, and not their actual Canvas ID.
          • Use SIS Course or Section ID — Tick this box if courseCode in the user's Timetable returns the course or course section's SIS ID, and not its actual Canvas ID.
        • Data Export Options
          • Assignment Title — A template that determines the name of the Canvas assignment created.
          • Default Checked-In Weight — Defaults to 100%.
          • Default Absence Weight (By Lecturer) — Defaults to 50%.
          • Default Absence Weight (By Student) — Defaults to 50%.
          • Default Invalid Check-In Weight — Defaults to 0%.
          • Automatically Publish Assignment
          • Default (Assignment) Points — Defaults to 100.
          • Default Display Type — The Canvas assignment grade type. Currently supported: Percentage, Points. Defaults to Percentage. 
    • Tab Labels — Configure the look and feel of the tab in the app that presents your check-in history. Enter replacements for titles or labels that appear in the check-in filter tabs. 
    • Check-in Statuses — For each status, select a color for the display of the status, and replace the default text, as required. The following statuses are defined:
      • Not Checked In
      • Check-In Validated — Checked in and validated.
      • Processing — Check-in is being validated.
      • Checked in (Offline) — Checked in; validation is not possible because the user's device does not have an internet connection.
      • Unable to validate — Checked in; validation is not possible for any other temporary reason.
        • How To Consider Unable to Validate Entries — Choose how this status should be displayed in the UI:
          • Valid — Marked with the Check-in Validated icon (Validated Check-In Icon sm.png).
          • Invalid — Marked with the Invalid Check-in icon (Invalid Check-In icon sm.png).
      • Invalid Check-in — Not checked in due to failed validation.
      • Student logged absence
      • Lecturer logged Absence
      • Absent (Offline)
      • Check-in not required
      • Absent
      • Other
    • Was this article helpful?