TracCloudWhatsNew

From Redrock Wiki

Revision as of 16:58, 4 October 2022 by Redrock (talk | contribs)

This page highlights some of the recent changes made to the TracCloud platform, and how you can utilize them on your own instance. A list of past changes and a full changelog can be found in the tabs above.

If you have any questions about these changes, feel free to reach out to us on our helpdesk.


Latest posts

Formatting Text in TracCloud with Twig and HTML

Many text fields throughout TracCloud support Twig and HTML, giving you greater control in determining what data is displayed to your users based on the context of appointments, visits, and more, as well as formatting that data to be as clear as possible.

Twig will be the primary focus of this article. Twig is a template engine that serves two primary purposes in TracCloud:

  • 1. Print variables in text
Personalize your emails and messages. Greet the student by name, let them know what subject they selected in their appointment, what time their appointment takes place, the location, and more. These same variables are also used for purpose #2.
  • 2. Add logic to your text
Modify the email or message based on why it was sent. Add an extra paragraph if X center was selected, send a follow-up email after a visit if the student chose Y, prevent an email from being sent on a SAGE referral if Z recommendation was checked, and much more. Rather than creating a generic email for any context, create an email that formats itself to match the current context.

Twig (and HTML) are supported in profile emails, welcome messages, email templates, appointment display, and more. Most of the examples listed in this article are for appointment emails or SAGE referrals, but the same concepts apply in all other supported fields. It's also worth keeping in mind that Twig exists outside of TracCloud, and there are many resources online for how you can utilize it that will also work here. This guide likely covers everything you will need, but it doesn't cover everything Twig is capable of.

HTML will also be used throughout this article, but without much explanation as it's more ubiquitous than Twig. There are many excellent resources online explaining how to use this markup language, such as W3Schools. HTML is used to adjust font sizes and colors, embed images and videos, and more.


What are Twig tags?

if / if X then do Y

else / if X then do Y, otherwise do Z

elseif / if W then do X, otherwise if Y then do Z

if (arrays) / if X in Y

for (arrays) / for each X in Y, do Z

SAGE Questions & Actions

Special Twig Functions/Tags (General)

Special Twig Functions/Tags (Success Plans)

Special Twig Functions/Tags (Work Plans)

Special Twig Functions/Tags (SAGE)

Tag List




Appointment Display
Both students and consultants will see upcoming appointments on their dashboard, and staff will see them from the schedule view. The formatting of these appointment info boxes can be customized in your profile settings, allowing you to provide the necessary information in a visually appealing format.

Student View
Students will be able to view their upcoming appointments on the right-side of the dashboard. The fields visible and the format they're in is entirely customizable by modifying the Appointment Display preference.


Consultant View
Consultants have a similar view to students, which can be modified independently.


Schedule View
Lastly, the staff schedule view, which allows us to view and manage our consultants’ availabilities and upcoming appointments. The appointment text is also customizable.


Customization

Within the Appointment Display menu, you will see a text box available for Students, Staff, and the Schedule view for Staff. There's also a preview section beneath each text box allowing you to easily see how your changes will display.


These text boxes support HTML and Twig. HTML support is standard, allowing you to easily make text <b>bold</b>, <i>italic</i>, or <u>underlined</u>, or add hyperlinks. Twig on the other hand allows you to pull data from TracCloud into the message, as well as include logic that determines whether or not a portion text is included. For information on Twig, please take a look at our dedicated Twig article here.

The "Appointment Display to Staff on Schedule" field in particular has a unique Twig tag available for use: {{Appointment.SchedVisitStatusIcon|raw}} which will add a button to start and conclude a visit for that appointment directly on the appointment itself.

Other > Other Options > Profiles > [Your Profile] > Prefs > Scheduling > Appointment Display


If you want to reset to the default configuration, simply click on the clipboard icon on the right, which will confirm if you want to erase the existing configuration in favor of the standard one.



Here are a couple examples of how you can configure the schedule and upcoming appointment views. This is more-so to give you an idea of how this feature works rather than a direct suggestion of what to use (although you’re welcome to copy these as-is if you’d like). Hopefully this gives you an idea of how the feature can be used, and how you can configure it on your own system.


Schedule View
Here’s a configuration that provides basic information about the appointment. The student’s name and appointment time in bold lettering, the subject and reason, and the consultant’s name. The if statement checks if the appointment has a Reason, and if it does, include a comma after the subject then print the reason.

<div style="float:left; width: 75%;">
<p style="font-size:9px">
<b>{{Student.Full_Name}}</b> at <b>{{Appointment.StartTime}}</b><br>
{{Course.SubjectCourse}}

{% if Reason.ReasonName != "" %}
, {{Reason.ReasonName}}
{% endif %}

<br>With {{Consultant.FirstLast}}
</p></div>

Student View
Here’s an example student view configuration. This one reads more like a spoken paragraph, with the important information bolded. Whether the appointment is in-person or online determines the text in the second half.

<div style="float:left; width: 75%;">
{{Appointment.Icon|raw}}
<b>{{Center.Name}}</b><br>
Your appointment with <b>{{Consultant.NameToStudent}}</b> has 
been booked for <b> {{Appointment.StartTime}}. </b><br>
{% if Appointment.Online == "1" %}
This is an online appointment, please select the right arrow icon to join your session.
The icon will only appear within 10 minutes of your appointment start time.
{% else %}
This is an in-person appointment taking place at <b>{{Appointment.Location}}</b>. 
If any assistance is required, please reach out to <u>{{Consultant.Email}}</u>.
{% endif %}<br>
{% if Reason.ReasonName != '' %}
Reason: {{Reason.ReasonName}}<br/>
{% endif %}
{% if Course.Subject != '' %}
Subject: {{Course.Subject}}<br/>
{% endif %}<br>
</div>
<div style="line-height: 2;" >
{{Appointment.CancelLink|raw}}<br/>
{{Appointment.ActionLink|raw}}<br/>
{{Appointment.EnterOnlineLink|raw}}<br/>
</div>
<div style="clear: both;"> </div>

Consultant View
This one has a few more moving parts. Near the top, we’re saying “if the appointment has been cancelled, say “CANCELLED:” and strikethrough the rest of the contents.” We also have a series of “if this field isn’t blank, include it in the list” as well as the time saying the word “Today” rather than a standard date and time.

<div style="float:left; width: 75%;"> 
{{Appointment.Icon|raw}}<br>
{% if Appointment.isCancelled == 'true' %}
	CANCELLED: <span class="linethrough" >
{% endif %}<br>
<b>{{Center.Name}}</b>
<span title="{{Student.ID}}">{{Student.FirstLast}}</span> - {{Student.Email}}<br> 
{% if Reason.ReasonName != '' %}
	Reason: {{Reason.ReasonName}}<br/>
{% endif %}
{% if Course.Subject != '' %} 
	Subject: {{Course.SubjectCourseTitle}}<br/>
{% endif %}
{% if Appointment.Location != '' %}
	Location: {{Appointment.OnlineText}}{{Appointment.Location}}<br/> 
{% endif %}<br>
When: <strong>{{Appointment.DisplayDate|raw}}</strong> at 
<strong>{{Appointment.DisplayTime|raw}}</strong><br/><br>
{% if Appointment.isCancelled == 'true' %}
	</span>
{% endif %}<br>
</div>
<div style="line-height: 2;" >
	{{Appointment.CancelLink|raw}}<br/>
	{{Appointment.ActionLink| raw}}<br/>
	{{Appointment.EnterOnlineLink|raw}}<br/>
</div>
<div style="clear: both;"> </div>

A unique option available in the consultant view is the ability to start and stop a visit directly from the dashboard. This can be implemented by including the {{Appointment.LoginStudentToAppt|raw}} Twig tag in your appointment display configuration. It will display as a clickable button to your staff.


  • Online appointment link text
Allows you to modify the hyperlink/button visible to students within online appointment records. Default is "The location for this online appointment is here."

See Also


Groups
Permission groups determine what kind of access your staff have to various elements of TracCloud. Each group represents a set of permissions. Do you want this group to access the schedule? Which centers? Can they create students? Can they manage resources? These options and many more are available to modify in your permission groups.

From a profile perspective, this tab displays the groups assigned to the profile, allowing you to manage your staff permissions to ensure they only have the information they need, and nothing more. Groups can also be managed from their own dedicated list by going to Other > Other Options > Groups.


We can create a new, or add an existing permission group to the profile by clicking the hamburger icon. New group will prompt us to choose a name and which profile it’s assigned to. After saving, you will be brought to the settings menu where we can configure the permissions of this group.


Within each permission group, you will find multiple tabs to categorize different types of preferences. Details on each of these tabs and the preferences within can be found below.


Center Access

User List

Scheduling

Student / Visit

Log In/Out

Admin / Modules

Restrictions

Add existing group

If you already have a group assigned to another profile (or no profile at all) that you want to provide profile access to, you can use the "Add existing group" utility. This allows us to provide staff members assigned to that group the ability to schedule and manage visits in centers outside of their own profile.

To accomplish this, click the hamburger icon again, and choose “Add Existing Group.” Next, select the group you want to add, which adds it to the list of groups. When clicking on this group (that still primarily exists in another profile), we’re given a restricted set of options, as it’s only displaying options relevant to this secondary profile.


  • Group Name
Changing the name here will also change its name in the primary profile.

  • Profile
This shows the primary profile this group is assigned.

  • Scheduling and Visits access
This is exactly the same as assigning center permissions in standard groups. This controls which centers staff members can view/edit visits and schedules in.

Students Listing

Student data is one of the most important parts of your Trac System, on top of being the record that all their visits, appointments, documents, and more are assigned to, you also have the student's information directly. You can run reports on visits grouped by student majors, or send emails to students of a certain class, cohort, or any other field you have available. This article goes over some of the ways you can search for these records.



The Students Listing itself (found by clicking 'Students' in the Navigation Bar) contains all student records uploaded to your Trac System. From this page, we're able to manage student data in bulk, creating lists, sending emails, or submitting SAGE referrals, or we can open a specific student record and manage just one student profile at a time.

Each column of information displayed has a clickable header that will sort the listing accordingly. Clicking once sorts ascending, a second click will sort descending.



Using the Search Bar on this screen, we can easily perform quick searches to find specific students. Right clicking in the search bar (shown below) will provide a list of available student fields to search, click any of these to auto-fill the search bar.

Example Searches:

  • Find a student by a single value, such as ID. Specifying 'Students.ID=' actually isn't required for ID or Name searches, but it works well as an example.
Students.ID=1931

  • ...or name. Names should be formatted as 'Last, First' or 'First M Last'. 'First Last' will also work if middle names are not being imported.
Day, Rob

  • Search multiple fields at once, separate your searches by a space.
Students.Major=Mathematics Students.Class=Sophomore

  • When performing multiple searches where at least one field contains a space, make sure to surround the contents you're searching for with quotation marks.
Students.Major="Chemical Engineering" Students.Status=Active

  • Search in Custom Fields. It's recommended to use the right-click menu to select these, as it will always auto-fill the correct field name.
#sql:InState#=Yes

  • Date searches such as this are required to be formatted as YYYY-MM-DD
Students.BirthDate=1993-07-16

  • We also offer a special search to find students where today is their birthday.
birthdaytoday

  • Additionally, it's even possible to search for students who received a batch email from TracCloud. The search below would return all students who received a batch email from TracCloud on 2024-10-23 where the subject contained the phrase "Upcoming Event".
MailQueue.CreatedOn="2024-10-23@" MailQueue.Category=batch_email MailQueue.Subject="@Upcoming Event@"


Students Search

The Student Listing also has a unique Search utility found in the hamburger menu . This utility has the ability to search related tables to find relevant students. This includes the ability to run searches such as "students who have had appointments in the last 7 days" or "students who have ongoing referrals."



  • Search Type
This can be set to New Search, Search Selection, Remove found from Selection, or Add found to Selection, depending on the desired effect of this search.
  • General Info tab
This tab is where you can search for basic information about the student. ID, Status, Name, etc.
  • Appointments
This tab allows you to search for students by appointment information. For example, "students who had an appointment from 02/10 to 02/20 with a status of Missed." Any fields that support wildcards additionally support the | character for "or."
  • Visits
This tab allows you to search for students by visit info. For example, "students who visited more than 2 times from 02/10 to 02/20 where the subject was MAT100." Any fields that support wildcards additionally support the | character for "or."
  • Registration
This tab allows you to search for students by registration info. For example, "students who are actively enrolled in more than one math course." Any fields that support wildcards additionally support the | character for "or."
  • Documents
This allows you to search for students by documents. "Students who have a document of a certain filename uploaded in the last month."
  • Surveys
Students who have received or responded to a survey in a certain time period. Requires SurveyTrac.
  • SAGE Referrals
Students who have ongoing or completed referrals of a specific type in a specified date range. Requires SAGE. Any fields that support wildcards additionally support the | character for "or."
  • Assignments
This tab allows you to search by potential assignments. Any fields that support wildcards additionally support the | character for "or."
  • Resources
This tab allows you to search for students by their resource usage, whether they have certain items checked out or overdue. Any fields that support wildcards additionally support the | character for "or."
  • Terms & Conditions
Search by accepted terms and conditions. Any fields that support wildcards additionally support the | character for "or."
  • Success Plans
Search by assigned Success Plans.

Hamburger Menu

Every listing page in the Trac System features a hamburger menu with utilities to search for or interact with your list of records. Some of these options are specific to a certain listing/record-type, others are shared. The following list includes definitions for the hamburger menu options available on this listing, and how they can be utilized.



  • List All
This option will show all records on the current listing. Some listings have an additional toggle for only showing "Active" records, such as Students and Registrations, which will still override a "List All" search if checked.


  • Search
This utility will open a pop-up window unique to each Listing it's present on, allowing you to search your records by a number of different fields. In the case of the Student Listing, you could use this to search related records, such as 'Students who have at least 2 Visits in the Learning Center' or 'Students with a recent Document upload in their timeline.'



  • Power Search
This option provides a simple but powerful search utility to find the records you need. String together multiple searches, adding or removing results for each. Use Search Symbols to include ranges of data, and Save Searches for later use if needed. The search term 'blankornull' can be used to find all records with a value of nothing ("") or null ().



  • Search by Term Enrollment
Allows you to search based on the students' enrollment in a specific term or multiple terms. The example search below would show students who are enrolled in a 2023SP registration AND are not enrolled in a 2023FA registration.



  • Lists
See Student Lists and Watch Lists for more information.


  • Saved Searches
See Saved Searches for more information.


  • Find/Merge Duplicates
These utilities can be used to cleanup duplicate records in your Trac System. We highly recommend reaching out to Redrock Support directly for assistance in cleaning up this data.


  • Find by Values
This utility can be used to search one field for multiple values. If you have a spreadsheet containing a list of student IDs, this is an easy way to pull up the same list of students in TracCloud by copying the ID column into this search field.



  • Change Field Values
This utility allows you to make modifications in to your records in bulk. Similar to the Merge Duplicates utility, we highly recommend coordinating with Redrock Support directly on this setting.


  • Selected...
The Selection Tool offers several options to filter and manage your records. More information on this feature can be found in its own dedicated article here.


  • Views
See Views for more information.


  • Send Survey
Allows you to send a survey to the current user list. More information.


  • Register In
Allows you to quickly enroll a student in a new registration. Depending on your import configuration, manually recreated registrations may be deactivated during your auto-import.


  • Assign Success Plan
Allows you to assign a new Success Plan to the current student list. More information.


  • Create Referral
Allows you to create a batch referral through SAGE. More information.


  • Create Task
Allows you to send a task to the current student list. More information.


  • Toggle Photos
Enable or disable student photos on the Student Listing.


  • Create Chart
Based on the data currently being viewed a chart can be generated to visually illustrate the relationships in the data.


  • Export CSV
Export current listing contents to a CSV file.


  • Send Email
Allows you to send an email directly to a list of users.


  • Send Email to Faculty
This email utility allows you to email faculty linked to student registrations. The faculty recipients can be determined by subject, status, and grade. One email will be sent per linked registration, so if there are 3 students listed enrolled in MAT100 with Dave Smith, Dave Smith will receive 3 emails. Faculty recipients can also be filtered by scheduled day/time if section schedule is being imported.



  • Show these <records>
This utility takes your selection of records, finds the related records, and takes you to that listing with the resulting records. For example, on the Registration listing, you can "Show these Students" to display the student records for the registrations that you were viewing.


  • Print
Allows you to print the contents of the current listing, by extension this also allows you to export the current list as a PDF file.


  • New <Record>
Allows you to create a new record based on your selected listing.


See Also


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.



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



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.


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; In Person, Online, Online Optional, or Phone

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.



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.




Schedule Management

The TracCloud schedule is where you can create and manage your consultant’s availabilities. The availability blocks created here will appear when staff or students are searching for appointments based on the criteria chosen during the search process. This article will walk you through how to utilize these features, from creating availabilities to booking appointments.

The schedule can be reached by clicking the “Schedule” button at the top of the dashboard. Click the "Expand" options below to view more information on different parts of the schedule management process.


Navigating the Staff Schedule

Creating Availabilities / 1-on-1, group, and drop-in

Asynchronous Availabilities / Document sharing & asynchronous messaging

Reserve Blocks / Prevent booking and cancel appointments

Booking Appointments

Group Roster

Moving Appointments

Availability Blocks Listing

Troubleshooting Availability Searches

See Also

  • Emails - Appointment confirmations, reminders, etc.

TracCloud Reports

This portion of our wiki covers the individual reports available in the system, with descriptions and example screenshots showing what you can expect when you run the report on your own data. The list below on the left contains links to all of our available reports. You can also click the report category in the tabs above to begin.

If you have a question about any of these reports, feel free to reach out to us at helpdesk@go-redrock.com or by submitting a ticket.








Saving a Report as a Favorite

Find a report that you plan on coming back to? Save it as a favorite for quick access later. From the report results window itself, click the star icon in the top-left corner, choose a name for your favorite, and click save.

  • Allow Group Access will make this report visible to other staff members in your Permission Group.



This report can then be found from your dashboard under Reports > Favorites at any time. The button can be used to duplicate the favorite report.


Automating a Favorite Report

After saving your report as a favorite, you can automate it to run on a set schedule and be emailed to you or a group of users.

Start by going to Reports > Favorites > Edit Favorites. This will bring you to the following screen. Click on the Pencil icon of the report you want to automate.



  • Deliver to: should be set to Email in this case.
  • Email Address(es) is where you'll add your recipients' email addresses. Multiple addresses can be entered, delimited by a semicolon.
  • Enable Automation will enable automation and make the following options available.
  • Message to include in the report email will add in some custom messaging to your emailed report.
  • Automated report frequency. Do you want this report to run daily, weekly, monthly, or once on a specific date?
  • Time will determine the time that this report will run on your scheduled frequency.
  • Overwrite This Favorite Report will overwrite your existing report settings with your new automation rules.

Click save to apply your changes.

Reports Management

This utility (found in Other > Other Options > Preferences > Reports Management) allows you to manage and reassign Favorite reports. This can be used if you want to create a report for someone else or to recover existing favorite reports from inactive (or even deleted) accounts. Within this menu, you'll find the name of the report, the current owner, and a icon to delete the report. The owner drop-down will allow you to change ownership to another staff member. Changes are saved immediately.

Any favorite report belonging to the currently-logged-in sysadmin or an account without a known permission group (i.e., deleted accounts) can be reassigned to any active staff. Favorite reports belonging to staff as well as group favorite reports belonging to deleted staff can only be assigned to those also in the permission group of the original staff account.

In any case, reassigning favorite reports does not bypass report security in TracCloud. For example, it's not possible to give a regular staff account access to payroll reports by reassigning a payroll report to them in this menu. Reassigning ownership of a favorite report also does not change group access. Further modifications to the report must be made by editing the favorite report from the new owner's account.



  • Email reports with the report file attached in a single email
Rather than sending emailed reports as a link and a passcode in two separate emails, enabling this will instead send emailed reports as an attachment. This setting will be ignored if a generated report is greater than 10MB.

Search Operators

When using the 'Additional Search' utility in your report settings, you have additional operators available to better narrow down your results. Operators can be combined as needed to perform a more specific search.

  • | ('or' operator; search for multiple unique values)
  • * (wildcard; anything that starts with/ends with/contains a specified string)
  • # ('not' operator; exclude results that match this search)
  • && ('and' operator; typically used alongside 'not' to exclude multiple items at once)
  • blankornull (this keyword specifically finds records where the chosen field is blank)

TracCloud Reports

This portion of our wiki covers the individual reports available in the system, with descriptions and example screenshots showing what you can expect when you run the report on your own data. The list below on the left contains links to all of our available reports. You can also click the report category in the tabs above to begin.

If you have a question about any of these reports, feel free to reach out to us at helpdesk@go-redrock.com or by submitting a ticket.








Saving a Report as a Favorite

Find a report that you plan on coming back to? Save it as a favorite for quick access later. From the report results window itself, click the star icon in the top-left corner, choose a name for your favorite, and click save.

  • Allow Group Access will make this report visible to other staff members in your Permission Group.



This report can then be found from your dashboard under Reports > Favorites at any time. The button can be used to duplicate the favorite report.


Automating a Favorite Report

After saving your report as a favorite, you can automate it to run on a set schedule and be emailed to you or a group of users.

Start by going to Reports > Favorites > Edit Favorites. This will bring you to the following screen. Click on the Pencil icon of the report you want to automate.



  • Deliver to: should be set to Email in this case.
  • Email Address(es) is where you'll add your recipients' email addresses. Multiple addresses can be entered, delimited by a semicolon.
  • Enable Automation will enable automation and make the following options available.
  • Message to include in the report email will add in some custom messaging to your emailed report.
  • Automated report frequency. Do you want this report to run daily, weekly, monthly, or once on a specific date?
  • Time will determine the time that this report will run on your scheduled frequency.
  • Overwrite This Favorite Report will overwrite your existing report settings with your new automation rules.

Click save to apply your changes.

Reports Management

This utility (found in Other > Other Options > Preferences > Reports Management) allows you to manage and reassign Favorite reports. This can be used if you want to create a report for someone else or to recover existing favorite reports from inactive (or even deleted) accounts. Within this menu, you'll find the name of the report, the current owner, and a icon to delete the report. The owner drop-down will allow you to change ownership to another staff member. Changes are saved immediately.

Any favorite report belonging to the currently-logged-in sysadmin or an account without a known permission group (i.e., deleted accounts) can be reassigned to any active staff. Favorite reports belonging to staff as well as group favorite reports belonging to deleted staff can only be assigned to those also in the permission group of the original staff account.

In any case, reassigning favorite reports does not bypass report security in TracCloud. For example, it's not possible to give a regular staff account access to payroll reports by reassigning a payroll report to them in this menu. Reassigning ownership of a favorite report also does not change group access. Further modifications to the report must be made by editing the favorite report from the new owner's account.



  • Email reports with the report file attached in a single email
Rather than sending emailed reports as a link and a passcode in two separate emails, enabling this will instead send emailed reports as an attachment. This setting will be ignored if a generated report is greater than 10MB.

Search Operators

When using the 'Additional Search' utility in your report settings, you have additional operators available to better narrow down your results. Operators can be combined as needed to perform a more specific search.

  • | ('or' operator; search for multiple unique values)
  • * (wildcard; anything that starts with/ends with/contains a specified string)
  • # ('not' operator; exclude results that match this search)
  • && ('and' operator; typically used alongside 'not' to exclude multiple items at once)
  • blankornull (this keyword specifically finds records where the chosen field is blank)

Custom Fields

Custom fields can be configured throughout TracCloud to store additional data that your campus may require. These custom fields can be displayed in student profiles, appointments, visits, faculty, registrations, and more.

These fields can be viewed just like other standard fields, and can even be used in reports. This data can also be imported from your Student Information System just like the rest of the standard fields, more information on that can be found in our import article.

Custom Fields can be managed in Other > Other Options > Custom Fields.



Creating a new Custom Field

To begin creating your new custom field, go to Other > Other Options > Custom Fields and select the Add new field button. This will open the custom field entry screen where you can begin to customize your new field.



  • Profile
Determines which profile this custom field is active for, including “All Profiles” if preferred.

  • Location
This determines where the field displays. There are several locations available:
Student – Campus / Other Info / Custom1-5 displays within one of these tabs on student profiles. The name of the “Custom” tabs can be changed in your Student Entry Choices preferences.

Visit – Student / Consultant displays in the visit record. Typically used with “Asked on log in/out” enabled, that way the student or staff member can input this information from the Log Listing/Kiosk view.
Visit - Q2 Raise Hand displays on the Raise Hand prompt for Q2, applying to Q2Remote and when raising a hand from the Log Listing.
Appointment – Student / Consultant will appear during the appointment booking process, with separate tabs containing different questions for students or consultants. This location is also unique in that it's the only custom field location that can be center-specific. After selecting this location and a specific profile, additional options will become available to only show this field for a certain center or exclude it from a certain center.
Availability appears in availability blocks under the 'Notes' tab.
Consultant displays in consultant profiles under the “Contact & Other Data” tab.
Faculty displays within faculty profiles.
Registration appears within registration records. Frequently used for additional enrollment data or midterm grades.
Reason appears within each of your Reasons. Possibly a description of the purpose of the reason, or any additional information that staff may need to reference when making changes later.
Resource appears in each of your Resources. Typically used for resource location.
Section appears in each section record.
Certification appears within consultant certifications.
Document appears in the document entry screen and during document upload.

  • Inactive
Marks the field as inactive. This is recommended if you aren’t planning on utilizing a field anymore, but don’t want to remove the data associated with it. This way the data is still available if you want to re-enable it again in the future, but it won’t be visible throughout general TracCloud use.

  • Field Name
This is the internal name of this field, shown in the custom fields menu and in report field lists. This needs to be a shorter, unique name without spaces, something like “Student_Notes” instead of “Do you have any notes on your visit today?”.

  • Prompt Text
This is the text that’s shown to your users when viewed. Continuing from the example above, this one should be “Do you have any notes on your visit today?”. This is visible in the record itself.

  • Field Entry Type
The type of field. Text boxes, multiple choice questions, etc. A list of options with example screenshots can be found further into this article.

  • Show on KIOSK Login/Logout
These determine if the field is displayed during the login/logout process on the log listing/kiosk. This even applies to non-visit fields. The student could be asked a question relating to one of their student or registration fields, for example.

  • Required
Sets the field to required, so an answer must be provided before continuing/saving.

  • Show on Timeline
Displays this field on the student timeline alongside Visit Notes.

  • Hide from Consultants
Hides this Custom Field from consultant view (e.g., for Student Visit Remarks).

  • Hide on SI Batch Visit Entry
Hides this field on batch visit entry.

  • Field, Menu, or Radio Choices and # Lines
Depending on which Field Entry Type is used, this option will change. “Field, Menu, or Radio Choices” allows you to list out your various options for multiple-choice questions. “# Lines” determines the size of text boxes for essay fields.

  • Relative Width
This determines the size of the field. 100% will span the entire Info box, while 8% will only have enough space for a single letter to be visible. The example screenshot below displays our custom field at 100%, 33%, and 17%.


  • Start on a New Line
Custom Fields are formatted automatically. For example, if you have a 50% width field followed by another 50% width field, they will appear on the same line at the same height in the page. If this box is checked, it forces this custom field to start on a new line regardless of the width of the previous field.

  • Maximum # of choices allowed ("Multiple Checkboxes" fields only)
This field allows you to set the maximum number of selections a user can make from the set of choices. If left blank, the user can check up to every box.

  • Longer prompt (Optional) ("Image Pop Field" fields only)
Any text entered in this field will display between the prompt text and the answer field.

  • Menu Width ("Image Pop Field" fields only)
The horizontal size of the icon menu. If left blank, the default is 210.

  • Item Width ("Image Pop Field" fields only)
The distance between icons. Setting this below 35 is not recommended. If left blank, the default is 50.

  • Delete
Deletes the custom field. We would recommend deactivating the field instead, but if there’s no data tied to it yet or the data needs to be deleted, then this option is available.

Field Entry Type Examples


Custom Field Groups


Custom Field Listing Options

See Also




  • Choose to Block Students on List
This can be utilized to block resource access to certain students based on lists. When a staff member tries to log a resource out to a student on this list, a message will appear informing them that this student has been blocked from checking out resources.

  • Show resources widget on the student dashboard
Adds a widget to the student dashboard to review currently reserved or checked out resources.


  • Allow students to reserve a resource via the dashboard
Expands the above functionality to allow students to reserve resources for themselves.

  • Maximum # outstanding reservations overall
How many total outstanding reservations can a student hold for your resources?

  • Maximum # outstanding reservations for one resource
How many total outstanding reservations can a student hold for a single resource?

  • Maximum # of days for an individual reservation
How many days can a student reserve a resource for? For example, allowing the student to reserve the resource from the 11th of the month to the 17th, but no longer, would mean this preference needs to be set to 7.

  • Minimum time needed (days hrs:min) prior to reservation
Choose the minimum amount of time in advance needed in order to reserve a resource. This is to prevent students from reserving items in the very near future.



Appointment Display
Both students and consultants will see upcoming appointments on their dashboard, and staff will see them from the schedule view. The formatting of these appointment info boxes can be customized in your profile settings, allowing you to provide the necessary information in a visually appealing format.

Student View
Students will be able to view their upcoming appointments on the right-side of the dashboard. The fields visible and the format they're in is entirely customizable by modifying the Appointment Display preference.


Consultant View
Consultants have a similar view to students, which can be modified independently.


Schedule View
Lastly, the staff schedule view, which allows us to view and manage our consultants’ availabilities and upcoming appointments. The appointment text is also customizable.


Customization

Within the Appointment Display menu, you will see a text box available for Students, Staff, and the Schedule view for Staff. There's also a preview section beneath each text box allowing you to easily see how your changes will display.


These text boxes support HTML and Twig. HTML support is standard, allowing you to easily make text <b>bold</b>, <i>italic</i>, or <u>underlined</u>, or add hyperlinks. Twig on the other hand allows you to pull data from TracCloud into the message, as well as include logic that determines whether or not a portion text is included. For information on Twig, please take a look at our dedicated Twig article here.

The "Appointment Display to Staff on Schedule" field in particular has a unique Twig tag available for use: {{Appointment.SchedVisitStatusIcon|raw}} which will add a button to start and conclude a visit for that appointment directly on the appointment itself.

Other > Other Options > Profiles > [Your Profile] > Prefs > Scheduling > Appointment Display


If you want to reset to the default configuration, simply click on the clipboard icon on the right, which will confirm if you want to erase the existing configuration in favor of the standard one.



Here are a couple examples of how you can configure the schedule and upcoming appointment views. This is more-so to give you an idea of how this feature works rather than a direct suggestion of what to use (although you’re welcome to copy these as-is if you’d like). Hopefully this gives you an idea of how the feature can be used, and how you can configure it on your own system.


Schedule View
Here’s a configuration that provides basic information about the appointment. The student’s name and appointment time in bold lettering, the subject and reason, and the consultant’s name. The if statement checks if the appointment has a Reason, and if it does, include a comma after the subject then print the reason.

<div style="float:left; width: 75%;">
<p style="font-size:9px">
<b>{{Student.Full_Name}}</b> at <b>{{Appointment.StartTime}}</b><br>
{{Course.SubjectCourse}}

{% if Reason.ReasonName != "" %}
, {{Reason.ReasonName}}
{% endif %}

<br>With {{Consultant.FirstLast}}
</p></div>

Student View
Here’s an example student view configuration. This one reads more like a spoken paragraph, with the important information bolded. Whether the appointment is in-person or online determines the text in the second half.

<div style="float:left; width: 75%;">
{{Appointment.Icon|raw}}
<b>{{Center.Name}}</b><br>
Your appointment with <b>{{Consultant.NameToStudent}}</b> has 
been booked for <b> {{Appointment.StartTime}}. </b><br>
{% if Appointment.Online == "1" %}
This is an online appointment, please select the right arrow icon to join your session.
The icon will only appear within 10 minutes of your appointment start time.
{% else %}
This is an in-person appointment taking place at <b>{{Appointment.Location}}</b>. 
If any assistance is required, please reach out to <u>{{Consultant.Email}}</u>.
{% endif %}<br>
{% if Reason.ReasonName != '' %}
Reason: {{Reason.ReasonName}}<br/>
{% endif %}
{% if Course.Subject != '' %}
Subject: {{Course.Subject}}<br/>
{% endif %}<br>
</div>
<div style="line-height: 2;" >
{{Appointment.CancelLink|raw}}<br/>
{{Appointment.ActionLink|raw}}<br/>
{{Appointment.EnterOnlineLink|raw}}<br/>
</div>
<div style="clear: both;"> </div>

Consultant View
This one has a few more moving parts. Near the top, we’re saying “if the appointment has been cancelled, say “CANCELLED:” and strikethrough the rest of the contents.” We also have a series of “if this field isn’t blank, include it in the list” as well as the time saying the word “Today” rather than a standard date and time.

<div style="float:left; width: 75%;"> 
{{Appointment.Icon|raw}}<br>
{% if Appointment.isCancelled == 'true' %}
	CANCELLED: <span class="linethrough" >
{% endif %}<br>
<b>{{Center.Name}}</b>
<span title="{{Student.ID}}">{{Student.FirstLast}}</span> - {{Student.Email}}<br> 
{% if Reason.ReasonName != '' %}
	Reason: {{Reason.ReasonName}}<br/>
{% endif %}
{% if Course.Subject != '' %} 
	Subject: {{Course.SubjectCourseTitle}}<br/>
{% endif %}
{% if Appointment.Location != '' %}
	Location: {{Appointment.OnlineText}}{{Appointment.Location}}<br/> 
{% endif %}<br>
When: <strong>{{Appointment.DisplayDate|raw}}</strong> at 
<strong>{{Appointment.DisplayTime|raw}}</strong><br/><br>
{% if Appointment.isCancelled == 'true' %}
	</span>
{% endif %}<br>
</div>
<div style="line-height: 2;" >
	{{Appointment.CancelLink|raw}}<br/>
	{{Appointment.ActionLink| raw}}<br/>
	{{Appointment.EnterOnlineLink|raw}}<br/>
</div>
<div style="clear: both;"> </div>

A unique option available in the consultant view is the ability to start and stop a visit directly from the dashboard. This can be implemented by including the {{Appointment.LoginStudentToAppt|raw}} Twig tag in your appointment display configuration. It will display as a clickable button to your staff.


  • Online appointment link text
Allows you to modify the hyperlink/button visible to students within online appointment records. Default is "The location for this online appointment is here."

See Also



View more...