This release includes:
Accessing Attendance Tracker
To access Attendance Tracker, ensure you are on the My Apricot Tab. Expand My Apricot Tools in the left side navigation and click “Classes & Terms”.
Important note: Configuration options are available to both Administrators and Standard Users. Admins should caution users not to edit if they prefer to do all the configuration. Guest users do not have access.
As Apricot is a highly configurable product, we need to ensure we are using participant Tier 1s and selecting which Quick View fields are visible when enrolling participants in terms. This takes any guess work out and ensures the best user experience.
To do this, we use Feature Configuration. This is shared with Apricot Schedule, a feature that also relies on mapping.
Feature Configuration is accessed by either selecting the pencil icon next to “Classes & Terms” page title or linked in a term that has been created, but no enrollments have been completed.
Only Administrators can access Feature Configuration. Standard Users are shown an error if they try to access.
To begin using Attendance Tracker meaningfully, we need to understand which Tier 1s and associated Quick View fields should be used.
At least one Tier 1 (Participant Form), Name Field and one Quick View are required. Quick views are required to differentiate participants that may have the same name. The first Quick View is used in both the Attendance Table and the Enrollment Table; secondary Quick View is used to populate a column in the Enrollment Table.
Sites can have a maximum of two Tier 1s used in Attendance Tracker. Currently, those Tier 1s can be different than the Tier 1s chosen in the Schedule tab. However, we do not recommend this course of action.
When ready, click Save. You will be shown an additional confirmation.
Classes are the broadest and mostly static concept in the Attendance Tracker.
A class is Apricot’s representation of a course/meeting that recurs with different groups of students/participants over time. A class will generally have the same content/agenda no matter when it is offered.
Ex. Mental Health Counseling, Tax Prep, Accounting 101
Above is the Classes Table. Here, a site can see all previously configured classes. In this case, First Year Defense Against the Darks Arts has been offered 21 times, 4 of which are currently in progress.
The Classes Table’s columns are sortable, and the table can be searched. Clicking the eye icon will take you to the Terms Table (described in next section). Clicking the kebab menu open allows you to delete a Class.
Important Note: Currently, you can delete a Class with active terms. This is bad! That would mean you would lose access to all data, especially data you are currently recording, that Class holds. We going to fix this.
Adding a New Class
To add a new class, click “New Class”, located top right in the Classes Table. You will then be asked the Name, Description, Sites applies and Status of the Class.
Name and Sites are required. Sites are automatically populated with all Sites. You can click the “X” to remove or “Select All” in the dropdown to repopulate.
Sites are applied at the Site level. Programs are applied at the Term level.
All Class Names must be unique.
Active or Inactive is simply a way to signal to users which Class is currently being used, and which is not. Users can still access all previously recorded data for Inactive Classes. Currently, you can add terms to Inactive Classes. This is likely to change.
Editing a Class
If you need to adjust the Class after creation, Click the eye icon on the Classes Table.
This will take you to the Terms Table. You will always see Class Details above the Terms Table. Click Edit to make any changes.
Term is the most important construct of Attendance Tracker. A Term represents the particular iteration of a class in time. Schedule, days off, location, success criteria and roster are all attached to the Term.
Ex. Fall 2019, Summer 2020, Tax Prep 1A, Session 3.2
Above is the Terms Table. This will show you all offerings of the Class. In this case, 1Yr Transfiguration has been offered twice, one is in session.
Here I can see Term’s name, association programs, start and end date. The columns are sortable and searchable.
I can click the eye icon to view and record data against the term. I can also click the kebab menu to delete the term.
Important Note: Currently, you can delete ongoing terms, meaning user will lose access to the data in the interface. Be careful.
Creating a Term
Terms are created in three parts.
Term Completion Criteria
Note, any configured fields can be edited after a term is started should that become necessary. Ex. Change in schedule, change in requirements.
First, users need to choose a Name for the Term. Terms names need to be distinct within a Class. For example, you can have a Summer 2021 term under Math Camp and a Summer 2021 term under Reading Camp.
Next, users should select which Programs are associated with the term. Programs are important because only participants within that program show up in the Enrollment Table.
Location is an optional field that signals to users where a term is taking place. This is a free text box that is of course reportable.
This is where users set the schedule for their term. This is important because only days that are expected to have classes can have data recorded.
There are two ways to set a Term’s schedule: Recurring or Specific Date(s).
A recurring schedule function much like Outlook. Users can select the occurrence intensity: Daily, Weekly, Monthly and Yearly.
Then users can select the frequency within the chosen occurrence. Ex. every other week, every month.
Then, depending on your occurrence, the correct options will appear. Ex. days of the week (weekly), or first – fifth Monday (monthly).
Next, users should pick the start and end date. This also informs the calculation of which dates can have data recorded.
Start and end time may also be used if so inclined. Much like location, these are nice to have and will primarily be used in reporting.
Because we have set a recurring schedule, it is possible certain holidays breaks or off days for the site would be included automatically. Or, if a snow day happens within a term, users can include the snow day here, so attendance trends are calculated correctly.
To solve for this, users should use the Select Days Off calendar. Simply click the date. The date will be populated in list. Users can remove the date by clicking the trash can.
Specific Date(s) Schedules
For certain types of classes, there may be a limited number of meetings. For example, a workshop with only three dates or a training with only 1 date. Or it could be the case that a schedule does not fit neatly into recurring structure.
In these cases, it makes sense to use the Specific Date Scheduler.
User simply needs to click dates on the calendar that the term will be meetings. Dates will be populated in the right-hand list and can be removed by clicking the trash can icon.
Term Completion Criteria
Completion Criteria is one of the biggest value-adds of Attendance Tracker. If users tell us what good attendance means for the term, we can show how participants are progressing in their terms.
Good attendance differs from term to term. For a court-mandated class good attendance could be 90%. For Summer Camp, it could be six out of ten.
Using Completion Criteria is optional. User should uncheck Completion Criteria if they would not look to use.
There are two ways to set criteria: by percentage or by a specific number of “presents”. Select the radio button of your preference and enter your criteria as prompted below.
Knowing this information will also help Social Solutions as now we can reason about structured attendance data.
Risk indicators will show how close to/far from the needed completion criteria for a particular term a participant is.
There are two categories, the completed term values and the in progress term values.
Note: The check for these values runs nightly, so if I class concludes, the updated values will not be available until the next morning.
These values will appear if the term has completed as of the time the values are updated.
Complete - The participant met the completion criteria for a specific number of days. Ex. 7/10 days required for a class; the participant could have at most 3 absences during the term.
Incomplete - The participant did not meet the completion criteria for a specific number of days. Ex. 7/10 days required for a class, the participant had more than 3 absences during the term.
In Progress Terms
these values will appear if the term has not completed as of the time the values are updated.
On Track - As of now, the participant has enough days remaining in the session to be able to successfully complete the class. Ex 7/10 days required with 3 days remaining and the participant has 1 or 2 absences.
At Risk - A participant has the appropriate number of days remaining to complete the class, however the number of additional absences they could incur is less than 10 percent of the days remaining. Ex. 7/10 days required with 3 days remaining and a participant has 3 absences.
Behind - A participant does not have the requisite number of days remaining to complete a class. Ex 7/10 days required with 3 days remaining and a participant already has accrued 4 absences.
In certain cases, attendance needs to be taken more than once a day. This is a limitation of the Registration Grid.
Sessions may be configured to take attendance more than once a day.
To configure a Session for a Term, click the eye icon in the Terms Table. This will take you to the Attendance Table.
Click Session Manager on the right above the Attendance Table.
By default, Terms are assumed to be one session, i.e., attendance is expected to be taken once a day.
To add a session, click Add Session. Two Sessions will appear, one labeled Default and one ready to be named.
To change the names (including Default), click the pencil icon. Type desired name and click green checkbox. Rename all sessions as needed.
Note: Sessions will appear in the Attendance Table in the order they appear here. Make sure to double check order before saving.
Make sure to click save for changes to go live in the Attendance Table. When taking attendance, make sure you are in the correct Session tab.
Configuring Attendance Note Settings
For many organizations, just tracking present or absent is not enough for their operations or funder requirements.
To track additional data points, users should take advantage of Attendance Note Settings.
For the first release, the options of additional data points are standard:
Ability to tag present attendances as “make-up” or “tardy”
Ability to tag absent as “excused” or “suspended”
Time in / time out
Section for notes (with quick fill options)
To access Attendance Notes Settings, click the kebab menu to the right of Sessions Manager.
Users can select as many or as little options as they like. In this case, my term is using tagging, activities, and notes.
From Display Options, users pick which additional points they would like to collect. All, none, or some may be selected using the toggle on the right.
Attendance Tagging allows to tag present attendances as “make-up” or “tardy”. This is useful if you need to report on tardiness.
If turned on, this is how that data will be asked for:
Time In / Time Out allows users to record the amount of time a participant spent in class. This is useful is you need report on dosage metrics, or are billing based on time staff spent with participants.
If turned on, this is how data will be asked for:
The time zone associated with time in / time out is based on the device’s time zone, then stored as UTC.
Activities completed allows users to record what a participant did in their classes. This is important if you need to report on what happened, not just if someone was present. A good example is if a meal or snack was provided, that can be recorded here.
To configure Activities a user needs to both turn on the toggle and configure Activity Options.
Navigate to Activity Options tab within Attendance Note Settings. To add an activity click Add Activity and type desired input. Make sure to click both the checkmark and the Save button when done.
Users can input up to five activities.
If turned on, this is how data will be asked for:
Notes with Quick Note Options allows users take notes for an individual participant or for the entire roster. This is important when you need to capture context during classes, like who you need to follow up, if there was a disciplinary problem or other important information.
Notes can be used with or without Quick Notes.
Quick Notes are a usability enhancer. It is likely some notes are recorded repeatedly. Instead of typing the same note again and again, you can configure a Quick Note. With one tap, the quick note text is populated in the note box.
Like Activities Completed, there is an extra configuration step.
Navigate to the Quick Notes Options tab. Here you can add, edit and delete Quick Notes. To add a Quick Note, click “Add Quick Note” and click the green checkmark. Make sure to click Save.
If turned on, this is how data will be asked for:
If turned multiple data points are turned on, this is how data will be asked for:
Enrolling & Unenrolling Participants
The final step needed before users can begin taking attendance is building your roster. This is how we associate which Tier 1 records are enrolled in a term.
To build your roster, click Enroll Participants within the Term View.
The Enrollment Table will pop up and display participants within the Term’s assigned program. The Enrollment Table understands this from Feature Configuration. Neat!
The Enrollment Table is searchable and paged.
To add a participant to your roster, click the check mark next to their name. You can enroll all participants by clicking the checkbox next to the Name column header.
Click Save when ready. Your roster will now appear in the Attendance Table, ready for data entry.
Note: You cannot unenroll a participant from the Enroll Table. The check mark will persist.
Unfortunately, not all participants make it to the end of their courses. Or we may have enrolled someone in error.
To unenroll a student, click the kebab menu next to their name in the Attendance Table. Click unenroll.
Upon selecting unenroll, a popup will appear requiring an unenroll reason. These reasons are reportable.
These reasons are not customizable, but the list has several options that should cover most use cases.
Once a participant is unenrolled, you can no longer record data for them. All past recorded data is visible and editable.
Unenrolled students will only show in the Attendance Table if Show Unenrolled is checked.
To see reason enrolled, hover over the exclamation point icon.
It may be the case that we need to bring our participants back into the roster. To re-enroll a student. Open the kebab menu and select re-enroll.
Recording Attendance Data
Let us put it all together! Once all needed configurations have been completed, you are ready to record attendance data.
All data entry happens in the Attendance Table. The Attendance Table is searchable. The Name column is sortable A-Z and Z-A by First Name and Last Name.
The Attendance Table view will always be a weekly view. You can navigate week by week by click the arrow at the top. Dates are noted in the column headers. Clicking View Today will take you back to the week that today’s current date falls.
Only days that are on the schedule will have data entry controls.
If your term is using Sessions, make sure you are in the correct tab when entering data.
To mark an individual participant as present, click the green checkbox. To mark a participant as absent, select the red x.
To change the data that was entered, hover over the selection and make the appropriate change.
Users can also mark the entire roster as present or absent by using group controls, which are located beneath the date.
Important Note: It is possible when using group controls that any data entered for individual participants could be overwritten. Users are warned if this will happen.
Additional attendance data points are also recorded in the Attendance Table. To enter additional data points, click the notes icon in either the group controls or within the row.
If attendance data points have been recorded, the notes icon will appear in yellow and show a small yellow dot.
Note: If using group controls for attendance data points, it is possible to overwrite previously entered individual data.
Data Quality Flags
The Attendance Tracker also offers warnings if there is potential data missing. A green checkmark will appear next to a date if every participant has data recorded for the day. A yellow exclamation point will appear if some participants have data, and some do not.
Users can hover over the icon to see more details about the flag.
Reporting Attendance Data
Currently, Attendance Tracker is available in My Reports, not Apricot Results Reporting.
All Attendance Tracker data is available under the “Attendance Tracker” section (beneath Sites & Programs) in the Field Choices palette.
All the below pieces of information held in Attendance Tracker are reportable and can be combined with other Tier 1 & Tier 2 fields when building reports.
It is likely the most popular will be: Attendance Date, Attendance Status, which will tell you what term days a participant was present or absent.
ID – system field tied to each individual attendance record.
Student ID – system field tied to enrolled participant. Student ID will always be the same for the same participant T1 record, across Classes & Terms.
Attendance Date – date of individual attendance record.
Arrival & Departure Time – times recorded in attendance bubble, separate from the Term’s configured start and end time. “Actual” time in class.
Notes – any notes or quick notes recorded.
Activities – any activities selected from the Activities dropdown.
Attendance Event Category – if using Attendance Tagging, will display the tag “tardy” “excused” etc.
Attendance Status – present or absent.
Creation Date – system date field tied to each individual attendance record.
Modification Date - system date field tied to each individual attendance record.
Enrollment Date – date participant was enrolled in term.
Unenrollment Date – date participant was removed from a term.
Unenrollment Reason – a required selection when removing a participant from term.
Session Name – if not using sessions, session name will be “Default”.
Session Start Time, End Time – NOTE: This is extraneous and will be removed shortly.
Term Start Date, End Date
Term Start Time, End Time – configured start and end time, “planned” time in class vs. Arrival and Departure time is “actual” time in class.
Term Programs – configured programs associated with the term.
Class Status – if Class is active or inactive.
Class Sites – configured Sites associated with the class.
Risk Status – participant’s current risk status, “on track” “at risk” “behind”, or “in-, complete” if the term has concluded. This will appear if term is using “Risk Indicator”, configured on the Term.
Risk Status Modification Date – date when current risk status changed.
Historical Risk Status – all past risk statuses for the participant.
Historical Risk Status Modification Date – date when previous risk statuses changed.
Grouping, filtering, and other useful Apricot reporting tools can be applied to Attendance Tracker data.