TracCloud: Scheduling Preferences: Difference between revisions

From Redrock Wiki

No edit summary
 
(27 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{TracCloudGuideTabs}}
{{TracCloudGuideTabs}}
{| style="width:100%; vertical-align:top; "
<div class="tcWidgetPage">
| style="width:250px; vertical-align:top; padding:2px 15px 2px 2px;" | {{TracCloudGuideProfileTOC}}
<div class="categoryWide">
 
{{TracCloudGuideProfileTOC}}
{| id="um-toc" style="width:100%; padding:6px; cellspacing:0px; cellpadding:0px; vertical-align:top; margin:1.2em 6px 6px 0; border:1px solid #c2c2c2; text-align:left; color:#666666; "
</div>
 
|-
! <h2 id="um-toc-hdr" style="margin:3px; font-size:120%; text-align:left; color:#000000; ">Schedule Prefs Contents</h2>
 
|-
| | [[TracCloudGuideProfilePrefsSchedule#Time Restrictions|Time Restrictions]]
|-
| | [[TracCloudGuideProfilePrefsSchedule#Special Fields|Special Fields]]
|-
| | [[TracCloudGuideProfilePrefsSchedule#Other Schedule Options|Other Schedule Options]]
|-
| | [[TracCloudGuideProfilePrefsSchedule#Appointment Status and Management|Appointment Status]]
|-
| | [[TracCloudGuideProfilePrefsSchedule#Max Appointment Rules and Blocks|Max Appt Rules]]
|-
| | [[TracCloudGuideProfilePrefsScheduleDisplay|Appointment Display]]
|-
| | [[TracCloudGuideProfilePrefsSchedule#Search Availability Badges|Search Availability Badges]]
|}
 
 
| style="vertical-align:top; padding:20px 20px 20px 2px;" |
{| style="width:100%; vertical-align:top; "
<big><b>Scheduling Preferences</b></big><br><br>
<big><b>Scheduling Preferences</b></big><br><br>
Your scheduling preferences allow you to modify [[TracCloudGuideBasicsSchedule|appointment booking]] rules, controlling exactly when a student can book appointments, how many appointments they can book, and much more. These preferences will apply to all centers within the profile.
Your scheduling preferences allow you to modify [[TracCloudGuideBasicsSchedule|appointment booking]] rules, controlling exactly when a student can book appointments, how many appointments they can book, and much more. These preferences will apply to all centers within the profile. Your schedule preferences can be found in <i>Other > Other Options > Profiles > [Your Profile] > Prefs > Scheduling</i>.
<hr>
<div class="line"></div>
==Time Restrictions==
<!--------------------------------------- Time Restrictions --------------------------------------->
<div style="float: left; margin-top: 0em; margin-bottom: 1em"><big><b>Time Restrictions</b></big></div><div class="mw-collapsible mw-collapsed">
<br><br>
[[File:7158731.png|800px]]
[[File:7158731.png|800px]]
<br><br>
<br><br>
Line 53: Line 32:


* <b>Restrict duration to intervals</b>
* <b>Restrict duration to intervals</b>
::The durations specified here will control the appointment durations shown during the appointment booking process.
::The durations specified here will be used by default in your availabilities. Availabilities can be created with custom multi-slot times which can override this preference.
::[[File:4u3j4h1232rf23.png|400px]]
::[[File:4u3j4h1232rf23.png|400px]]


<hr>
<hr>
[[File:4807306.png|800px]]<br><br>
[[File:6752167.png|800px]]<br><br>


* <b>Prevent students from booking consecutive appointments same student (any consultant)</b>
* <b>Prevent students from booking consecutive appointments same student (any consultant)</b>
::This prevents students from booking consecutive appointments in TracCloud. For example, a student could book a 10am to 11am appointment, but couldn't book an 11am to 12pm. <b>Consecutive also means with same consultant</b> can be used to block consecutive bookings with the same consultant specifically, which would allow a student to book a 10am to 11am with Dave and an 11am to 12pm with Jane. The default consecutive limit is 2 (no back-to-back appointments), but this can be modified if needed. For example, a limit of "3" would allow a student to book a <i>1pm to 2pm</i>, and <i>2pm to 3pm</i>, but not a <i>3pm to 4pm</i>. <b>Warn staff when they attempt to book consecutive appointments</b> can also be enabled so that staff members are shown a warning when booking consecutive appointments on behalf of students.<br><br>
::This prevents students from booking consecutive appointments in TracCloud. For example, a student could book a 10am to 11am appointment, but couldn't book an 11am to 12pm. An appointment counts as consecutive if the start time is within 61 minutes of the end time of the prior appointment. <b>Consecutive also means with same consultant</b> can be used to block consecutive bookings with the same consultant specifically, which would allow a student to book a 10am to 11am with Dave and an 11am to 12pm with Jane. The default consecutive limit is 2 (no back-to-back appointments), but this can be modified if needed. For example, a limit of "3" would allow a student to book a <i>1pm to 2pm</i>, and <i>2pm to 3pm</i>, but not a <i>3pm to 4pm</i>. <b>Warn staff when they attempt to book consecutive appointments</b> can also be enabled so that staff members are shown a warning when booking consecutive appointments on behalf of students.<br><br>
 
* <b>Allow entry into online appointment session</b>
* <b>Allow entry into online appointment session</b>
::These preferences control how soon/late a student can join a remote tutoring session by restricting when the Join button is available. If you’d like the student to be able to join 5 minutes prior to the start time through to the end, you would need to set “No sooner than” to 00:05 and set “No later than” to a value such as “1:00” (assuming you’re holding 1-hour appointments). <b>No later than before end of appt</b> counts back from the end time of the appointment rather than the start, and is an alternate option to <b>No later than after start of appt</b>.<br><br>
::These preferences control how soon/late a student can join a remote tutoring session by restricting when the Join button is available. If you’d like the student to be able to join 5 minutes prior to the start time through to the end, you would need to set “No sooner than” to 00:05 and set “No later than” to a value such as “1:00” (assuming you’re holding 1-hour appointments). <b>No later than before end of appt</b> counts back from the end time of the appointment rather than the start, and is an alternate option to <b>No later than after start of appt</b>.<br><br>
Line 67: Line 46:
* <b>QR Codes expire after</b>
* <b>QR Codes expire after</b>
::This applies to Batch Visit QR Codes and Ad-hoc Drop-in QR codes. If this is left blank, these codes can be used up to the end time of the visit. By setting this to a higher value, you can allow students to retroactively create visits for themselves after the visit has already taken place (e.g., in a recording). This preference counts from the <i>start time</i> of the session.<br><br>
::This applies to Batch Visit QR Codes and Ad-hoc Drop-in QR codes. If this is left blank, these codes can be used up to the end time of the visit. By setting this to a higher value, you can allow students to retroactively create visits for themselves after the visit has already taken place (e.g., in a recording). This preference counts from the <i>start time</i> of the session.<br><br>
* <b>QR Codes active no sooner than</b>
::Similar to above, but in regards to how early a QR code can be used instead. By default (blank), QR codes can be used once they're created even if that visit would be days in the future.<br><br>


* <b>Block student from booking appointments between # and #</b>
* <b>Block student from booking appointments between # and #</b>
::This preference allows you to prevent students from booking appointments during a specific time of day. This is more commonly used if <b>Schedule no later than</b> is set to a low value, such as a few hours, allowing students to book close to the start time of the appointment. For example, if you want to prevent a student from booking a morning appointment in the middle of the night so that your tutors have more notice for their upcoming schedule, this is the preference you'll want to change. Default is blank, which does not apply any restrictions based on time of day.
::This preference allows you to prevent students from booking appointments during a specific time of day. This is more commonly used if <b>Schedule no later than</b> is set to a low value, such as a few hours, allowing students to book close to the start time of the appointment. For example, if you want to prevent a student from booking a morning appointment in the middle of the night so that your tutors have more notice for their upcoming schedule, this is the preference you'll want to change. Default is blank, which does not apply any restrictions based on time of day.
<hr>
</div>
==Special Fields==
<br><br><div class="line"></div>
<!--------------------------------------- Special Fields --------------------------------------->
<div style="float: left; margin-top: 0em; margin-bottom: 1em"><big><b>Special Fields</b></big></div><div class="mw-collapsible mw-collapsed">
<br><br>
[[File:1169066.png|800px]]
[[File:1169066.png|800px]]
<br><br>
<br><br>
Line 85: Line 70:
* <b>Appointment Fund Choices</b>
* <b>Appointment Fund Choices</b>
::Allows you to customize the funds available to choose from on Availability and Appointment entry. [[TracCloudGuideBasicsPayroll|More information on funds and payroll tracking in general can be found here.]]
::Allows you to customize the funds available to choose from on Availability and Appointment entry. [[TracCloudGuideBasicsPayroll|More information on funds and payroll tracking in general can be found here.]]
<hr>
</div>
==Other Schedule Options==
<br><br><div class="line"></div>
[[File:4448795.png|800px]]
<!--------------------------------------- Other Schedule Options --------------------------------------->
<div style="float: left; margin-top: 0em; margin-bottom: 1em"><big><b>Other Schedule Options</b></big></div><div class="mw-collapsible mw-collapsed">
<br><br>
[[File:9398858.png|800px]]
<br><br>
<br><br>
* <b>Allow students to cancel appointments</b>
* <b>Allow students to cancel appointments</b>
Line 102: Line 90:
</syntaxhighlight><br><br>
</syntaxhighlight><br><br>


* <b>Allow group online/in-person per time slot determined by first person that day and time</b>
* <b>Allow group availability meeting type to be determined by first scheduled appointment</b>
::If this is enabled, the first student booking an optional online/in-person multi-person [[TracCloudGuideBasicsSchedule|availability]] decides if the session will be online or in-person for other students going forward. If this is disabled, each student booking the same time slot can choose online/in-person independently of each other.<br><br>
::If this is enabled, the first student booking an optional online/in-person multi-person [[TracCloudGuideBasicsSchedule|availability]] decides if the session will be online or in-person for other students going forward. If this is disabled, each student booking the same time slot can choose online/in-person independently of each other.<br><br>


* <b>Allow student to upload [[TracCloudGuideGlobalDocs|documents]] to the appointment</b>
* <b>Allow student to upload [[TracCloud:_Documents|documents]] to the appointment</b>
::Controls whether or not students can upload documents to the appointment record.<br><br>
::Controls whether or not students can upload documents to the appointment record.<br><br>


Line 116: Line 104:
* <b>Allow availabilities to be asynchronous</b>
* <b>Allow availabilities to be asynchronous</b>
::Enables asynchronous availability/appointment functionality. [[TracCloudGuideBasicsSchedule|More information.]]<br><br>
::Enables asynchronous availability/appointment functionality. [[TracCloudGuideBasicsSchedule|More information.]]<br><br>
* <b>Allow message to be composed after conclusion</b>
::This determines whether or not students are allowed to re-open concluded asynchronous appointments to continue sending messages.<br><br>
* <b>Asynchronous appointment automatic message</b>
::The text entered here will be automatically sent as a message at the start time of the asynchronous appointment.<br><br>


* <b>Default value for availability max students</b>
* <b>Default value for availability max students</b>
::Determines the default "Max Students" value when creating [[TracCloudGuideBasicsSchedule|availabilities]]. This value can still be overridden when managing your schedule. 0 = drop-in, 1 = one-on-one, 2+ = group.
::Determines the default "Max Students" value when creating [[TracCloudGuideBasicsSchedule|availabilities]]. This value can still be overridden when managing your schedule. 0 = drop-in, 1 = one-on-one, 2+ = group.<br><br>
<hr>
 
==Appointment Status and Management==
* <b>Warning message to display when appointment modality is changed</b>
[[File:2596215.png|800px]]
::When a staff member changes the modality (in-person/online/asynchronous) of an existing appointment, a warning message will appear to confirm that they want to make that change. This text field allows you to add an additional custom message to that warning.
</div>
<br><br><div class="line"></div>
<!--------------------------------------- Appointment Status and Management --------------------------------------->
<div style="float: left; margin-top: 0em; margin-bottom: 1em"><big><b>Appointment Status and Management</b></big></div><div class="mw-collapsible mw-collapsed">
<br><br>
[[File:3687942.png|800px]]
<br><br>
<br><br>
* <b>Appointment Status Choices</b>
* <b>Appointment Status Choices</b>
::These are the statuses that appointments can be set to. Typically, this would be set to something similar to the above example, with an Attended, Missed, and Canceled status, however, you can modify the choices if needed. Statuses containing the phrase “Cancel” will always cancel the appointment, making it available for other users to book (provided they’re still within the “schedule no later than” time limit.)<br><br>
::These are the statuses that appointments can be set to. Typically, this would be set to something similar to the above example, with an Attended, Missed, and Canceled status, however, you can modify the choices if needed. Statuses containing the phrase “Cancel” will always cancel the appointment, making it available for other users to book (provided they’re still within the “schedule no later than” time limit.)<br><br>
* <b>Status for attended</b>
::This is the status that TracCloud views as “Attended.” When students log in and log out during their appointment time, this is the status that the appointment will be automatically set to. If a staff member manually marks an appointment as this Attended status, a visit record will be automatically created.<br><br>


* <b>Status for missed</b>
* <b>Status for missed</b>
::This is the status that TracCloud views as “Missed.” Just like the above preference, this is the status that appointments without matching visits will be automatically set to.<br><br>
::This is the status that TracCloud views as “Missed.” This should typically match the status set in your [[TracCloudGuideProfilePrefsEmails|Missed Appointment Emails "Change missed appointment to Status:"]] preference.<br><br>


* <b>Calc Missed Appointments Since</b>
* <b>Calc Missed Appointments Since</b>
Line 138: Line 135:
* <b>Additional text message for late cancellation prompt / warning</b>
* <b>Additional text message for late cancellation prompt / warning</b>
::This is an optional additional message that displays to students when they are cancelling an appointment outside of your time restriction. This appears in addition to the standard "This will be marked as missed" notice.
::This is an optional additional message that displays to students when they are cancelling an appointment outside of your time restriction. This appears in addition to the standard "This will be marked as missed" notice.
 
</div>
<hr>
<br><br><div class="line"></div>
==Max Appointment Rules and Blocks==
<!--------------------------------------- Max Appt Rules --------------------------------------->
<div style="float: left; margin-top: 0em; margin-bottom: 1em"><big><b>Max Appointment Rules and Blocks</b></big></div><div class="mw-collapsible mw-collapsed">
<br><br>
[[File:1693361.png|800px]]
[[File:1693361.png|800px]]
<br><br>
<br><br>
Line 146: Line 145:


<big>Max Appointment Rules</big><br>
<big>Max Appointment Rules</big><br>
[[File:5494722.png|600px]]
[[File:4089266.png|600px]]
<br><br>
<br><br>
* <b>Allow a maximum of X [hours/appointments] with:</b>
* <b>Allow a maximum of X [hours/appointments] with:</b>
Line 154: Line 153:
::Unique identifier for this rule, used for [[TracCloudGuideProfilePrefsTwig|twig logic]] in failure message.<br><br>
::Unique identifier for this rule, used for [[TracCloudGuideProfilePrefsTwig|twig logic]] in failure message.<br><br>


* <b>Same: [Consultant / Reason / Center / Subject / Location]</b>
* <b>Same: [Consultant / Reason / Center / Profile / Subject / Section / Location]</b>
::This allows you to narrow down the restriction to specific fields. Maybe you don’t want a student booking excessively with a specific consultant, or booking too many appointments for a specific reason, this is where you would apply these rules.<br><br>
::This allows you to narrow down the restriction to specific fields. Maybe you don’t want a student booking excessively with a specific consultant, or booking too many appointments for a specific reason, this is where you would apply these rules.<br><br>


* <b>add a search clause…</b>
* <b>add a search clause…</b>
::These clauses allow you to be more specific in where this rule applies. For example, you could add a search clause for Appointment Status and set it to "*Missed*" to apply max appointment rules to missed appointments, where a student wouldn't be able to book additional appointments once the limit is reached. You can also select specific Reasons, Centers, or Subjects where the rule should apply, to not affect unrelated appointments.<br><br>
::These clauses allow you to be more specific in where this rule applies. For example, you could add a search clause for Appointment Status and set it to "*Missed*" to apply max appointment rules to missed appointments, where a student wouldn't be able to book additional appointments once the limit is reached. You can also select specific Reasons, Centers, Subjects, or Statuses where the rule should apply, to not affect unrelated appointments. The | symbol can be used for "or" and # can be used for "not" in these search clauses.<br><br>


* <b>in X [Days / Weeks / Months / Terms / Years]</b>
* <b>in X [Minutes / Hours / Days / Weeks / Months / Terms / Years]</b>
::The time period for this rule. For example, you may want to restrict students from booking more than 3 appointments per week, or 10 appointments per month. This preference is where you’ll make that decision.
::The time period for this rule. For example, you may want to restrict students from booking more than 3 appointments per week, or 10 appointments per month. This preference is where you’ll make that decision.
::If “X week” is used, you can choose the start day of the week to count from. If “X month” is used, this will be the first to last day of the month. If you would prefer any 7 or 30-day window, you will need to use something like “7 Days” rather than “1 Week”.<br><br>
::If “X week” is used, you can choose the start day of the week to count from. If “X month” is used, this will be the first to last day of the month. If you would prefer any 7 or 30-day window, you will need to use something like “7 Days” rather than “1 Week”. The maximum value for "Minutes" is 180. If a longer range is desired, hours or days should be used instead.<br><br>


* <b>This rule is active for appointment dates in the time period</b>
* <b>This rule is active for appointment dates in the time period</b>
Line 168: Line 167:


* <b>This rule applies to</b>
* <b>This rule applies to</b>
::<b>This Student</b> applies to only the student booking the appointment. John Doe (a student) can’t book more than 3 appointments with the same consultant per week.
::<b>All students individually</b> applies to only the student booking the appointment. John Doe (a student) can’t book more than 3 appointments with the same consultant per week.
::<b>All Students</b> applies to every student. Jane Smith (a tutor) can’t be booked more than 3 appointments per day (by students).<br><br>
::<b>Students as a collective</b> applies to every student. Jane Smith (a tutor) can’t be booked more than 3 appointments per day (by students).<br><br>


*<b>For student</b>
*<b>For student</b>
Line 179: Line 178:
* <b>Students that fail this rule may be optionally added to a list</b>
* <b>Students that fail this rule may be optionally added to a list</b>
::This option requires that <b>Same:</b> and <b>In X time period</b> are both disabled. When the student attempts to book an appointment and is blocked by this rule, they will be added to the [[TracCloudGuideGlobalLists|student list]] that you select.<br><br>
::This option requires that <b>Same:</b> and <b>In X time period</b> are both disabled. When the student attempts to book an appointment and is blocked by this rule, they will be added to the [[TracCloudGuideGlobalLists|student list]] that you select.<br><br>
* <b>Fail Message to Student</b>
::This text field can be used to override the automatically generated description that would otherwise be shown to students. If you want to hide the text of the rule that students are limited by, enter your custom description here.<br><br>


* <b>Rule Failure Message</b>
* <b>Rule Failure Message</b>
Line 202: Line 204:


In your Maximum Appointment Rules, use the phrase "MaxHours" in the "Allow a maximum of [____]" field. When an appointment is booked, TracCloud will check the relevant consultant's maximum hours for use with this rule. If the newly scheduled appointment would be over the maximum number of hours set, it will be blocked.<BR>
In your Maximum Appointment Rules, use the phrase "MaxHours" in the "Allow a maximum of [____]" field. When an appointment is booked, TracCloud will check the relevant consultant's maximum hours for use with this rule. If the newly scheduled appointment would be over the maximum number of hours set, it will be blocked.<BR>
[[File:1919234.png|700px]]<br><br>
[[File:5197708.png|700px]]<br><br>


<big>Block Students to this Profile</big><br>
<big>Block Students to this Profile</big><br>
Line 213: Line 215:
* <b>Message to Display to a Blocked Student</b> is the message displayed when the student tries to login on a Kiosk or a staff member tries to log them in on the Log Listing.
* <b>Message to Display to a Blocked Student</b> is the message displayed when the student tries to login on a Kiosk or a staff member tries to log them in on the Log Listing.
:[[File:35j35j43k46k4k4635g.png|400px]]
:[[File:35j35j43k46k4k4635g.png|400px]]
<hr>
</div>
==Appointment Display==
<br><br><div class="line"></div>
<!--------------------------------------- Appointment Display --------------------------------------->
<div style="float: left; margin-top: 0em; margin-bottom: 1em"><big><b>Appointment Display</b></big></div><div class="mw-collapsible mw-collapsed">
<br><br>
[[TracCloudGuideProfilePrefsScheduleDisplay|Appointment Display has its own wiki article which can be found here.]]
[[TracCloudGuideProfilePrefsScheduleDisplay|Appointment Display has its own wiki article which can be found here.]]
<hr>
</div>
==Search Availability Badges==
<br><br><div class="line"></div>
Search Availability badges can be used to add information and indicators to availability slots. Each badge can appear in specific contexts, based on center, availability section/reason, location, skills/accommodations, etc.
<!--------------------------------------- Search Availability Badges --------------------------------------->
<div style="float: left; margin-top: 0em; margin-bottom: 1em"><big><b>Search Availability Badges</b></big></div><div class="mw-collapsible mw-collapsed">
<br><br>
<onlyinclude>
Search Availability badges can be used to add information and indicators to availability slots. Each badge can appear for certain conditions, based on center, availability section/reason, location, skills/accommodations, etc.
 
[[File:4452413.png|600px]]<br><br>
 
Click "New Availability Badge" to begin. This will open a form where you can enter the details for your badge.
 
[[File:6402679.png|800px]]<br><br>
 
<b>Manually Linked</b>
::Rather than the badge automatically appearing based on certain conditions, these badges appear in a menu to be manually selected on the availability itself.
::[[File:9026751.png|400px]]<br><br>
 
<b>Name</b>
::Name of the Badge. This will not be displayed for students<br><br>
 
<b>Availability Type</b>
::Drop In, 1-on-1, or Group availability<br><br>
 
<b>Consultant</b>
::Assign a specific Staff<br><br>
 
<b>Reason</b>
::Assign a specific Reason<br><br>
 
<b>Center</b>
::Assign a specific Center<br><br>
 
<b>Section</b>
::Assign a specific Subject<br><br>
 
<b>Special Needs</b>
::Select if applicable ([[TracCloudGuideGlobalSkills|more information]])<br><br>
 
<b>Online</b>
::Availability Type; Online, In Person, or Optional<br><br>
 
<b>Location</b>
::Location of the availability<br><br>
 
Once you've decided where the badge is needed and have made your selections from the options above, you can now determine which icon, colors, and info work best for the badge created.<br>
<b>Color:</b> Color of Icon<br>
<b>Icon:</b> Choose from the list or use a [https://fontawesome.com/v5/search custom icon]<br>
<b>Info Text:</b> Enter text that will display when users hover over the icon<br><br>
 
In the example screenshot above, this badge will only appear on availabilities of staff who have been assigned the “ASL” accommodation and are available in the Learning Center. Once saved, your badge will appear in the profile preferences if you need to edit/delete it later.
 
[[File:7189620.png|800px]]<br><br>
 
Any fields left blank will not be considered for where this badge appears, you can be as specific or non-specific as needed. You can also create as many badges as you'd like, more than 1 tag can appear for the same availability. When students search for an availability, the badges will display to the right of the screen as shown below.
 
[[File:6875813.png|800px]]<br><br>
</onlyinclude>
</div>
<br><br><div class="line"></div>
<!-------------------------------------------- Search Appointment Links  -------------------------------------------->
<div style="float: left; margin-top: 0em; margin-bottom: 1em"><big><b>Search Appointment Links (QR Codes)</b></big></div><div class="mw-collapsible mw-collapsed">
<br><br>
 
Appointment links allow you to create preset search availability widgets that can be easily shared to students with a QR code or a link from the dashboard. These links are assigned to an existing search availability widget, and you can add additional filters such as what subjects or reasons can be selected, which center or consultant will appear in the results, as well as the meeting modality and type.
 
[[File:9756052.png|700px]]<br><br>
 
Click <b>New Search Appointment Link</b> to begin.
 
[[File:5945806.png|700px]]<br><br>
 
* <b>Inactive</b>
::If checked, this link will not be accessible to those who scan the QR code.<br><br>
 
* <b>Show on Student Dashboard</b>::<br><br>
::Enabling this will add a button to the linked search availability widget to access this appointment link. This is only visible to students, the name of the button will be the <i>Link Name</i> unless overridden.
::[[File:4617624.png|600px]]<br><br>
 
* <b>Allow Dynamic Center/Consultant Codes</b>
::If a specific center and/or consultant are not selected, you will be able to make those fields dynamic. If checked, a new option called "Show Dynamic Codes" will appear. When clicked, you will be able to select a center/consultant and generate a unique QR code link with those records chosen rather than needing to create a completely new appointment link record.<br><br>
 
* <b>QR Code</b>
::This QR code will direct users to this search availability link. Hover your mouse over it to enlarge the code, click on it to visit the appointment link.<br><br>
 
* <b>Link Name</b>
::The name of this link. This will appear to students if <i>Show on Student Dashboard</i> is enabled. HTML is supported if you want to change the color of the button text or add icons. For example, <code><nowiki><i class="fa-solid fa-user-group"></i> <span style="color:green; font-weight:bold">Math Workshop</span></nowiki></code> would result in <code><i class="fa-solid fa-user-group"></i> <span style="color:green; font-weight:bold">Math Workshop</span></code>. An icon list can be found at [https://fontawesome.com/search fontawesome.com].<br><br>
 
* <b>Override Name with optional Twig (optional)</b>
::Choose custom text for the search availability link button, including [[TracCloudGuideProfilePrefsTwig|Twig]] support.<br><br>
 
* <b>Subtitle Additions (optional twig)</b>
::Add a custom description to the search availability link widget to provide additional instructions to students. [[TracCloudGuideProfilePrefsTwig|Twig]] and HTML are supported.<br><br>
 
* <b>Created</b>
::Used to keep track of different appointment links. Doesn't affect link functionality.<br><br>
 
* <b>Expires</b>
::The expiration date of the link (optional).<br><br>
 
* <b>Section Link</b>
::Which subject/section must be selected when searching availabilities using this link. "Subject" allows for wildcard entries, such as "MAT*" for all math courses. "Section" can be used to make a specific selection with a search box. "Course List" can be used to include a variety of different sections based on your existing [[TracCloudGuideBasicsCourses|course lists]].<br><br>
 
* <b>Reason Link</b>
::Similar to the above option, but for reason choices instead. "Reason Name" allows for wildcard entries and "Reason" allows you to select a specific reason with a search box.<br><br>
 
* <b>Specific Center</b>
::Used to filter search results to only a specific center.<br><br>
 
* <b>Specific Consultant</b>
::Used to filter search results to only a specific consultant.<br><br>
 
* <b>Modalities to Include</b>
::The modalities and meeting types that can be shown in search results. All are selected by default.<br><br>


[[File:7942458.png|800px]]<br><br>
<big>Availability Dynamic QR Codes</big>


Click <b>New Availability Badge</b> to begin creating your new badge.
Another component of appointment links is the ability to create dynamic links directly from availabilities. These links will be automatically assigned to the center and consultant of the availability they were created from. To give staff the ability to generate these appointment links, go to <i>Other > Other Options > Groups > [The group you want to update] > Scheduling</i>, and check <b>Allow user to generate a dynamic search appointment QR Code based on an existing search appointment link</b>. Additionally, you can check <b>Only allow links for self</b> to prevent consultants in this group from creating availability links for other consultant's schedules.


[[File:8036271.png|800px]]<br><br>
[[File:4626901.png|600px]]<br><br>


Any fields left blank will not be considered for where this badge appears, you can be as specific or non-specific as needed. You can also create as many badges as you'd like, more than 1 tag can appear for the same availability. <b>Info Text</b> appears when a user hovers their mouse over the badge in the search availability menu.
Once this access is provided, this will appear in a new tab in availabilities named "Dynamic QR Code." Choose the link to utilize for this search, and save or click on the QR code to access the search availability menu. Keep in mind that the consultant's section and reason specialties still apply when using these QR codes, so you'll want to ensure that the link used has those sections/reasons available so that this availability can be found in search results.


[[File:3529335.png|800px]]
[[File:6300327.png|500px]]


|}
</div>
<br><br><div class="line"></div>
[[Category:TracCloud]]
[[Category:TracCloud]]
</div>

Latest revision as of 15:53, 22 November 2024

Scheduling Preferences

Your scheduling preferences allow you to modify appointment booking rules, controlling exactly when a student can book appointments, how many appointments they can book, and much more. These preferences will apply to all centers within the profile. Your schedule preferences can be found in Other > Other Options > Profiles > [Your Profile] > Prefs > Scheduling.

Time Restrictions



7158731.png

  • Schedule no sooner than...And no later than
This preference controls how early or late a student can book an appointment. The example below visualizes how this preference works, but the time range would typically be larger for a production system (e.g., no later than 12 hours, no sooner than 14 days).
4810828.png

  • No Cancellation within
Determines how late the student can cancel an appointment. If a student attempts to cancel within this time limit, they will be informed that the appointment will be counted as a missed appointment instead. Internally, the status will be recorded as "Cancel - Missed" (by default).

  • Minimum and Maximum Appointment Duration
This preference controls the minimum/maximum possible appointment time. If you exclusively offer 30 or 60 minute availabilities, this should be set to match. If an availability is created with time slots outside of the limit specified here, it will not appear in search results to students.

  • Default appointment duration
The default duration of an appointment. Typically used in an open-schedule environment, where consultants are available for many hours at a time, this will be the default duration when a student goes to book an appointment.

  • Appointment start in increments of
Increments of time that booked appointments can start at. For example, if this preference is set to 15 minutes, appointments could be booked at 9:15, 9:30, 9:45, and so on. This is not commonly used outside of open-schedule environments.

  • Appointment duration in increments of
Increments of time that an appointment can be booked for. For example, if this is set to 10 minutes, appointments can be booked for 20 minutes, 30 minutes, 40, and so on. This is not commonly used outside of open-schedule environments.

  • Restrict duration to intervals
The durations specified here will be used by default in your availabilities. Availabilities can be created with custom multi-slot times which can override this preference.
4u3j4h1232rf23.png

6752167.png

  • Prevent students from booking consecutive appointments same student (any consultant)
This prevents students from booking consecutive appointments in TracCloud. For example, a student could book a 10am to 11am appointment, but couldn't book an 11am to 12pm. An appointment counts as consecutive if the start time is within 61 minutes of the end time of the prior appointment. Consecutive also means with same consultant can be used to block consecutive bookings with the same consultant specifically, which would allow a student to book a 10am to 11am with Dave and an 11am to 12pm with Jane. The default consecutive limit is 2 (no back-to-back appointments), but this can be modified if needed. For example, a limit of "3" would allow a student to book a 1pm to 2pm, and 2pm to 3pm, but not a 3pm to 4pm. Warn staff when they attempt to book consecutive appointments can also be enabled so that staff members are shown a warning when booking consecutive appointments on behalf of students.

  • Allow entry into online appointment session
These preferences control how soon/late a student can join a remote tutoring session by restricting when the Join button is available. If you’d like the student to be able to join 5 minutes prior to the start time through to the end, you would need to set “No sooner than” to 00:05 and set “No later than” to a value such as “1:00” (assuming you’re holding 1-hour appointments). No later than before end of appt counts back from the end time of the appointment rather than the start, and is an alternate option to No later than after start of appt.

  • QR Codes expire after
This applies to Batch Visit QR Codes and Ad-hoc Drop-in QR codes. If this is left blank, these codes can be used up to the end time of the visit. By setting this to a higher value, you can allow students to retroactively create visits for themselves after the visit has already taken place (e.g., in a recording). This preference counts from the start time of the session.

  • QR Codes active no sooner than
Similar to above, but in regards to how early a QR code can be used instead. By default (blank), QR codes can be used once they're created even if that visit would be days in the future.

  • Block student from booking appointments between # and #
This preference allows you to prevent students from booking appointments during a specific time of day. This is more commonly used if Schedule no later than is set to a low value, such as a few hours, allowing students to book close to the start time of the appointment. For example, if you want to prevent a student from booking a morning appointment in the middle of the night so that your tutors have more notice for their upcoming schedule, this is the preference you'll want to change. Default is blank, which does not apply any restrictions based on time of day.


Special Fields



1169066.png

Each group of settings—Reasons, Locations, Sections, Fund—can be precisely adjusted to control where they show up and whether or not they’re required.
Enter in avail determines whether or not the field shows up within the availability entry window.
Enter in appointment determines whether or not the field shows up within the appointment entry window.
Required for Search means that in order for appointments in this profile to appear in search results, this field must not be empty.
Required for Save marks the field as required, so it must be filled out prior to booking the appointment. This applies more-so to Staff, as the above option already requires a student to have this field selected before they have the chance to book.

  • Appointment Location Choices
Allows to you to customize the locations available to choose from on Availability and Appointment entry. If used, this would typically be a more specific location than what your centers already describe. E.g., "Room 42 (location) in Peer Tutoring (center)."

  • Appointment Fund Choices
Allows you to customize the funds available to choose from on Availability and Appointment entry. More information on funds and payroll tracking in general can be found here.


Other Schedule Options



9398858.png

  • Allow students to cancel appointments
Provides students the option to cancel appointments (as long as they’re outside the time range specified in the first menu.)

  • Display consultant alias on availability search
This will display the consultant’s alias (specified in their staff profile) rather than their full name when students are searching for availabilities. An alias can also be automatically generated based on your System Preferences if preferred (e.g., First Name Last Initial).

  • Display consultant email/phone on appointment entry
Displays the specified consultant fields within appointment display, the following twig tags will or won't contain data based on these preferences.
{{Consultant.PhoneToStudent}}
{{Consultant.EmailToStudent}}


  • Allow group availability meeting type to be determined by first scheduled appointment
If this is enabled, the first student booking an optional online/in-person multi-person availability decides if the session will be online or in-person for other students going forward. If this is disabled, each student booking the same time slot can choose online/in-person independently of each other.

  • Allow student to upload documents to the appointment
Controls whether or not students can upload documents to the appointment record.

  • Allow staff to upload documents to the appointment
Controls whether or not staff can upload documents to the appointment record.

  • Block students from booking recurring appointments
Prevents students from booking recurring appointments for themselves. Staff can still book recurring availabilities on behalf of students if needed.

  • Allow availabilities to be asynchronous
Enables asynchronous availability/appointment functionality. More information.

  • Allow message to be composed after conclusion
This determines whether or not students are allowed to re-open concluded asynchronous appointments to continue sending messages.

  • Asynchronous appointment automatic message
The text entered here will be automatically sent as a message at the start time of the asynchronous appointment.

  • Default value for availability max students
Determines the default "Max Students" value when creating availabilities. This value can still be overridden when managing your schedule. 0 = drop-in, 1 = one-on-one, 2+ = group.

  • Warning message to display when appointment modality is changed
When a staff member changes the modality (in-person/online/asynchronous) of an existing appointment, a warning message will appear to confirm that they want to make that change. This text field allows you to add an additional custom message to that warning.


Appointment Status and Management



3687942.png

  • Appointment Status Choices
These are the statuses that appointments can be set to. Typically, this would be set to something similar to the above example, with an Attended, Missed, and Canceled status, however, you can modify the choices if needed. Statuses containing the phrase “Cancel” will always cancel the appointment, making it available for other users to book (provided they’re still within the “schedule no later than” time limit.)

  • Status for missed
This is the status that TracCloud views as “Missed.” This should typically match the status set in your Missed Appointment Emails "Change missed appointment to Status:" preference.

  • Calc Missed Appointments Since
A student’s total number of missed appointments can be utilized in emails via the Twig tag below. This date determines how far back TracCloud searches for missed appointments. If this preference is blank, the global System Preferences date is used instead. Automatically Use Term Start can be used if you'd like to use the start date of your semester instead.
{{CalcMissedAppointments(Student.Sequence, Center.ProfileID)}}


  • Additional text message for late cancellation prompt / warning
This is an optional additional message that displays to students when they are cancelling an appointment outside of your time restriction. This appears in addition to the standard "This will be marked as missed" notice.


Max Appointment Rules and Blocks



1693361.png

These preferences allow you to restrict students from booking excessive appointments, or prevent booking/logins altogether. “Max Appointment Rules” allow you to create restrictions that will dynamically block students from booking appointments if their appointment threshold his met, while “Block Students to this Profile” allows you to block access to logging in for visits or booking appointments based whether or not the student is on a specific list.

Max Appointment Rules
4089266.png

  • Allow a maximum of X [hours/appointments] with:
Choose how many appointments/total hours a student can book within the restrictions assigned below.

  • ID Number (#1234ABCD)
Unique identifier for this rule, used for twig logic in failure message.

  • Same: [Consultant / Reason / Center / Profile / Subject / Section / Location]
This allows you to narrow down the restriction to specific fields. Maybe you don’t want a student booking excessively with a specific consultant, or booking too many appointments for a specific reason, this is where you would apply these rules.

  • add a search clause…
These clauses allow you to be more specific in where this rule applies. For example, you could add a search clause for Appointment Status and set it to "*Missed*" to apply max appointment rules to missed appointments, where a student wouldn't be able to book additional appointments once the limit is reached. You can also select specific Reasons, Centers, Subjects, or Statuses where the rule should apply, to not affect unrelated appointments. The | symbol can be used for "or" and # can be used for "not" in these search clauses.

  • in X [Minutes / Hours / Days / Weeks / Months / Terms / Years]
The time period for this rule. For example, you may want to restrict students from booking more than 3 appointments per week, or 10 appointments per month. This preference is where you’ll make that decision.
If “X week” is used, you can choose the start day of the week to count from. If “X month” is used, this will be the first to last day of the month. If you would prefer any 7 or 30-day window, you will need to use something like “7 Days” rather than “1 Week”. The maximum value for "Minutes" is 180. If a longer range is desired, hours or days should be used instead.

  • This rule is active for appointment dates in the time period
The date range that this rule is effective for. Maybe your current semester, or a monthly period.

  • This rule applies to
All students individually applies to only the student booking the appointment. John Doe (a student) can’t book more than 3 appointments with the same consultant per week.
Students as a collective applies to every student. Jane Smith (a tutor) can’t be booked more than 3 appointments per day (by students).

  • For student
Allows you to only apply this rule to a certain |list of students (or students not on a specific list).

  • And also applies to
Which appointment types should this apply do? E.g., only in-person 1-on-1 appointments. If left blank, this rule is applied to all appointment types.

  • Students that fail this rule may be optionally added to a list
This option requires that Same: and In X time period are both disabled. When the student attempts to book an appointment and is blocked by this rule, they will be added to the student list that you select.

  • Fail Message to Student
This text field can be used to override the automatically generated description that would otherwise be shown to students. If you want to hide the text of the rule that students are limited by, enter your custom description here.

  • Rule Failure Message
This is an optional custom message that can appear to students if they reach the limit of this rule.
9370938.png
Twig can also be used in this field to display student or consultant information. You can also modify the contents of the message based on which rule was broken. For example:
{% for failRule in failRules %}
{% if failRule.id == "1Y0GYPWS" %}
Sorry, you can only have one upcoming appointment at a time. Please try again later.
{% elseif failRule.id == "HKIEAATS" %}
You can only book 4 appointments per week.
If you think an exception needs to be made, reach out to us at help@school.edu.
{% endif %}
{% endfor %}


In addition to standard maximum appointment rules, you can also utilize these rules to set maximum tutoring/advising hours for your consultants.

In the consultant profile, set 'Max Hours' to your desired limit, e.g., "10".
9093257.png

In your Maximum Appointment Rules, use the phrase "MaxHours" in the "Allow a maximum of [____]" field. When an appointment is booked, TracCloud will check the relevant consultant's maximum hours for use with this rule. If the newly scheduled appointment would be over the maximum number of hours set, it will be blocked.
5197708.png

Block Students to this Profile

  • Prevent Scheduling is where you will select a list of students that you want to prevent from booking appointments.
  • Message to Display to a Blocked Student is the message displayed when a student on that list tries to book an appointment.
Oinwouigng2482y5.png


  • Prevent Login prevents the student from being logged in on the Log Listing or a Kiosk.
  • Message to Display to a Blocked Student is the message displayed when the student tries to login on a Kiosk or a staff member tries to log them in on the Log Listing.
35j35j43k46k4k4635g.png


Appointment Display


Search Availability Badges



Search Availability badges can be used to add information and indicators to availability slots. Each badge can appear for certain conditions, based on center, availability section/reason, location, skills/accommodations, etc.

4452413.png

Click "New Availability Badge" to begin. This will open a form where you can enter the details for your badge.

6402679.png

Manually Linked

Rather than the badge automatically appearing based on certain conditions, these badges appear in a menu to be manually selected on the availability itself.
9026751.png

Name

Name of the Badge. This will not be displayed for students

Availability Type

Drop In, 1-on-1, or Group availability

Consultant

Assign a specific Staff

Reason

Assign a specific Reason

Center

Assign a specific Center

Section

Assign a specific Subject

Special Needs

Select if applicable (more information)

Online

Availability Type; Online, In Person, or Optional

Location

Location of the availability

Once you've decided where the badge is needed and have made your selections from the options above, you can now determine which icon, colors, and info work best for the badge created.
Color: Color of Icon
Icon: Choose from the list or use a custom icon
Info Text: Enter text that will display when users hover over the icon

In the example screenshot above, this badge will only appear on availabilities of staff who have been assigned the “ASL” accommodation and are available in the Learning Center. Once saved, your badge will appear in the profile preferences if you need to edit/delete it later.

7189620.png

Any fields left blank will not be considered for where this badge appears, you can be as specific or non-specific as needed. You can also create as many badges as you'd like, more than 1 tag can appear for the same availability. When students search for an availability, the badges will display to the right of the screen as shown below.

6875813.png



Search Appointment Links (QR Codes)



Appointment links allow you to create preset search availability widgets that can be easily shared to students with a QR code or a link from the dashboard. These links are assigned to an existing search availability widget, and you can add additional filters such as what subjects or reasons can be selected, which center or consultant will appear in the results, as well as the meeting modality and type.

9756052.png

Click New Search Appointment Link to begin.

5945806.png

  • Inactive
If checked, this link will not be accessible to those who scan the QR code.

  • Show on Student Dashboard::

Enabling this will add a button to the linked search availability widget to access this appointment link. This is only visible to students, the name of the button will be the Link Name unless overridden.
4617624.png

  • Allow Dynamic Center/Consultant Codes
If a specific center and/or consultant are not selected, you will be able to make those fields dynamic. If checked, a new option called "Show Dynamic Codes" will appear. When clicked, you will be able to select a center/consultant and generate a unique QR code link with those records chosen rather than needing to create a completely new appointment link record.

  • QR Code
This QR code will direct users to this search availability link. Hover your mouse over it to enlarge the code, click on it to visit the appointment link.

  • Link Name
The name of this link. This will appear to students if Show on Student Dashboard is enabled. HTML is supported if you want to change the color of the button text or add icons. For example, <i class="fa-solid fa-user-group"></i> <span style="color:green; font-weight:bold">Math Workshop</span> would result in Math Workshop. An icon list can be found at fontawesome.com.

  • Override Name with optional Twig (optional)
Choose custom text for the search availability link button, including Twig support.

  • Subtitle Additions (optional twig)
Add a custom description to the search availability link widget to provide additional instructions to students. Twig and HTML are supported.

  • Created
Used to keep track of different appointment links. Doesn't affect link functionality.

  • Expires
The expiration date of the link (optional).

  • Section Link
Which subject/section must be selected when searching availabilities using this link. "Subject" allows for wildcard entries, such as "MAT*" for all math courses. "Section" can be used to make a specific selection with a search box. "Course List" can be used to include a variety of different sections based on your existing course lists.

  • Reason Link
Similar to the above option, but for reason choices instead. "Reason Name" allows for wildcard entries and "Reason" allows you to select a specific reason with a search box.

  • Specific Center
Used to filter search results to only a specific center.

  • Specific Consultant
Used to filter search results to only a specific consultant.

  • Modalities to Include
The modalities and meeting types that can be shown in search results. All are selected by default.

Availability Dynamic QR Codes

Another component of appointment links is the ability to create dynamic links directly from availabilities. These links will be automatically assigned to the center and consultant of the availability they were created from. To give staff the ability to generate these appointment links, go to Other > Other Options > Groups > [The group you want to update] > Scheduling, and check Allow user to generate a dynamic search appointment QR Code based on an existing search appointment link. Additionally, you can check Only allow links for self to prevent consultants in this group from creating availability links for other consultant's schedules.

4626901.png

Once this access is provided, this will appear in a new tab in availabilities named "Dynamic QR Code." Choose the link to utilize for this search, and save or click on the QR code to access the search availability menu. Keep in mind that the consultant's section and reason specialties still apply when using these QR codes, so you'll want to ensure that the link used has those sections/reasons available so that this availability can be found in search results.

6300327.png