TracCloudGuideBasicsResources: Difference between revisions

From Redrock Wiki

No edit summary
No edit summary
 
(38 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;" | {{TracCloudGuideBasicsTOC}}
<div class="categoryWide">
| style="vertical-align:top; padding:20px 20px 20px 2px;" |
{{TracCloudGuideProfileTOC}}
{| style="width:100%; vertical-align:top; "
</div>
<big><b>Resources</b></big><br>
<big><b>
==Resources==
</b></big>
Resources are items that may be checked in and out of your [[TracCloudGuideProfileCenters|Center]](s) and lent to students or staff. The borrowing of resources at your center(s) can be tracked, recorded, and the data collected can be displayed through [[TracCloudReports|Reports]]. Resources can be utilized in many ways, but common examples include Laptops, Calculators, or Books that users can reserve, checkout, and return.<br>


==what is a resource?==
[[File:9327007.png|800px]]


==creating a resource==
<hr>
<!-------------------------------------------- Creating resources -------------------------------------------->
<div style="float: left; margin-top: 0em; margin-bottom: 1em"><big><b>Creating a Resource</b></big></div><div class="mw-collapsible mw-collapsed"><br><br>
To begin creating a resource, go to Other > Resources > Resources > Hamburger menu {{#fas:bars}} > New Resource. [[TracCloudGuideGlobalCustom|Custom fields]] can also be added to this page.


==using a resource==
[[File:7114507.png|800px]]<br><br>


==resource reports==
* <b>BarCode</b> is the unique identifier for this item. Can be used to log resources in and out via a barcode scanner or swipe system, in addition to manually entering the value.


* <b>Title</b> is the name of this resource.


|}
* <b>Profile</b> is the linked [[TracCloudGuideProfileGeneral|Profile]] for this resource.
{{DISPLAYTITLE:<span style="position: absolute; clip: rect(1px 1px 1px 1px); clip: rect(1px, 1px, 1px, 1px);">{{FULLPAGENAME}}</span>}}
 
[[Category:rsc_internal]]
* <b>Checked Out To</b> shows which user currently has this item checked out (if applicable).
 
* <b>Collateral</b> will store the collateral item collected due to the option below being enabled. This should be left blank when creating a new resource, as it will be automatically filled in when the item is checked out and collateral is collected.
 
::* <b>Collateral Logic</b> enables Collateral functionality if checked. This will ask the staff member logging the resource in/out whether or not collateral has been gathered/returned.
 
* <b>Reserved For</b> shows who currently has this resource reserved.
 
* <b>Always Available</b> indicates that this resource doesn't need to be individually checked out or reserved, multiple users can check out the same resource at any time.
 
* <b>Reserved Date</b>, <b>Last Date Out</b>, and <b>Due Date</b> display the exact times of reservations, checkouts, and when the resource is due to be returned.
 
* <b>Resource Type</b> allows you to categorize this resource into a type for reporting purposes, or to restrict certain students from accessing this resource.
 
* <b>Length of Checkout</b> determines how long an item can be checked out for before an overdue notification is sent.
::* <b>Arbitrary Due Date</b> allows the staff member checking out the item to choose a due date during checkout.
::* <b>Due by end of semester</b> will be based on your current [[TracCloud:_Terms|semester end date]]. If chosen, a new field will appear to add a buffer before the end of the semester (i.e., to require the item be returned X days before semester end.)
::* <b>Days / Hours / Mins</b> will automatically set a due date based on the amount of time specified. If chosen, a new field will appear to set the maximum of number of times the checkout can be renewed.
 
* <b>Not Available to Students / Staff</b> allows you to restrict this resource to one user type or the other. By default (both unchecked), the item is available to either user type.
 
* <b>Description</b> is an internal description of this particular resource.
 
* <b>Keywords</b> are the related words for this resource, delimited by commas or semicolons. For example, if you have a Laptop as an available resource, you may want to create keywords like "Computer, PC, Macbook" to make this resource easier to search for.
 
* <b>Pickup/Return Instructions</b> can be entered and displayed in resource confirmation/return reminder emails as a twig tag.
 
</div>
<hr>
<!-------------------------------------------- Resource Types -------------------------------------------->
<div style="float: left; margin-top: 0em; margin-bottom: 1em"><big><b>Resource Types</b></big></div><div class="mw-collapsible mw-collapsed"><br><br>
Resource Types can be used to group resources together for the purpose of reporting or to block certain students from accessing certain resources. These can be managed by going to <i>Other > Resources > Resource Types</i>. Click the hamburger menu {{#fas:bars}} > <i>New Resource Type</i> to begin creating a new type.
 
[[File:6606629.png|800px]]<br><br>
 
After creating a new resource type or clicking on an existing one, you will find the following options.
[[File:1005878.png|800px]]<br><br>
 
* <b>Resource Type Name</b>
::The type/category for your resources.<br><br>
 
* <b>Resource Type Description</b>
::Information about this resource type.<br><br>
 
* <b>Linked to Profile</b>
::Allows you to link this Resource Type for use in a specific [[TracCloudGuideProfileGeneral|profile]].<br><br>
 
* <b>Allowed Student List</b>
::Allows you to only allow students on this [[TracCloudGuideGlobalLists|list]] to checkout this resource, blocking everyone else. If left blank, anyone can checkout this resource (assuming they aren't blocked from resource usage entirely).<br><br>
 
* <b>Display Notice and Require Initials when Checking Out Resources of this Type</b>
::If enabled, a prompt will appear during checkout requiring that the user agree to terms and conditions before continuing. Terms can be entered in the <b>Logout Notice to Student</b> field (HTML & [[TracCloudGuideProfilePrefsTwig|Twig]] supported), and a copy of the terms can be automatically forwarded to the student by checking <b>Send Terms and Conditions as Email to Recipient</b>.
::[[File:1164007.png|500px]]
 
</div>
<hr>
<!-------------------------------------------- Permissions -------------------------------------------->
<div style="float: left; margin-top: 0em; margin-bottom: 1em"><big><b>Permission Groups</b></big></div><div class="mw-collapsible mw-collapsed"><br><br>
 
There are a couple settings of note within your [[TracCloudGuideProfileGroups|permission group]](s) relating to Resources.
 
<span style="color:grey"><i>Other > Other Options > Groups > [Your Group] >  Log In/Out</i></span><br>
[[File:4838715.png|800px]]<br><br>
 
* <b>Allow user to log resources in and out</b> provides users in this group the ability to record resource usage.
 
* <b>Allow user to view what resource the student has logged out</b> provides users in this group the ability to view a student's currently logged out item.<br><br>
 
<span style="color:grey"><i>Other > Other Options > Groups > [Your Group] >  Admin/Modules</i></span><br>
[[File:1292806.png|800px]]<br><br>
 
* <b>Table Access</b> provides access to the <i>Other > Resources</i> view of resources. You can also assign <b>Resource Types</b> here to allow this group to view and edit these as well.
 
</div>
<hr>
<!-------------------------------------------- Utilization -------------------------------------------->
<div style="float: left; margin-top: 0em; margin-bottom: 1em"><big><b>Using Resources</b></big></div><div class="mw-collapsible mw-collapsed"><br><br>
 
After creating your resource and updating your groups, you're ready to start checking out resources. This option can be found by going to <i>Other > Log Resource</i>.
 
[[File:3393501.png|400px]]<br><br>
 
You will then be brought to the following screen with two text entry areas available. The first is where you select a resource (searching by Barcode, Title, or Keywords), the second allows you to select a student or staff member. Once one or both fields are selected, additional options become available to check out, return, or reserve this item. The {{#fas:maximize}} button can be used to full-screen the resource checkout pop-up, allowing you to leave it open to continuously checkout and return items.
 
[[File:4360537.png|450px]]<br><br>
 
In the event that Collateral Logic is being utilized, more options will be required in regards to collecting/returning the collateral item before and after checkout.
 
[[File:8676920.png|450px]]
 
</div>
<hr>
<!-------------------------------------------- Resource Reservation Options -------------------------------------------->
<div style="float: left; margin-top: 0em; margin-bottom: 1em"><big><b>Reservation Options</b></big></div><div class="mw-collapsible mw-collapsed"><br><br>
 
Students can be allowed to reserve resources from their dashboard if configured in global preferences. To enable this functionality, go to <i>Other > Other Options > Preferences > System Preferences > Resource Management</i>.
 
{{:TracCloud:_System_Preferences}}
 
</div>
<hr>
<!-------------------------------------------- Emails-------------------------------------------->
<div style="float: left; margin-top: 0em; margin-bottom: 1em"><big><b>Resource Emails</b></big></div><div class="mw-collapsible mw-collapsed"><br><br>
Resource emails can be customized to inform students of the due date of their checked-out resource, or if the resource is overdue. These options are part of your profile preferences, in <i>Other > Other Options > Profiles > [Your Profile] > Prefs > Emails > Resource Checkout Emails</i>.
 
Similar to your [[TracCloudGuideProfilePrefsEmails|other Profile Emails]], you can write a subject line and body of your email, an additional SMS text, and choose when this email is sent.
 
{{#lst:TracCloudGuideProfilePrefsEmails|resources}}
 
</div>
<hr>
<!-------------------------------------------- Reports -------------------------------------------->
<div style="float: left; margin-top: 0em; margin-bottom: 1em"><big><b>Resource Reporting</b></big></div><div class="mw-collapsible mw-collapsed"><br><br>
 
There are two resource reports available in TracCloud. These can be found by going to <i>Reports > Management > Resources</i>. <i>Resources</i> provides information on resource utilization, while <i>Resources Listing</i> provides information on the items themselves.
 
{{:TracCloud_Report:_Resources}}
 
<HR>
 
{{:TracCloudReportsManagement21}}
 
</div>
<HR>
[[Category:TracCloud]]
</div>

Latest revision as of 10:06, 20 November 2024

Resources

Resources are items that may be checked in and out of your Center(s) and lent to students or staff. The borrowing of resources at your center(s) can be tracked, recorded, and the data collected can be displayed through Reports. Resources can be utilized in many ways, but common examples include Laptops, Calculators, or Books that users can reserve, checkout, and return.

9327007.png


Creating a Resource


To begin creating a resource, go to Other > Resources > Resources > Hamburger menu > New Resource. Custom fields can also be added to this page.

7114507.png

  • BarCode is the unique identifier for this item. Can be used to log resources in and out via a barcode scanner or swipe system, in addition to manually entering the value.
  • Title is the name of this resource.
  • Profile is the linked Profile for this resource.
  • Checked Out To shows which user currently has this item checked out (if applicable).
  • Collateral will store the collateral item collected due to the option below being enabled. This should be left blank when creating a new resource, as it will be automatically filled in when the item is checked out and collateral is collected.
  • Collateral Logic enables Collateral functionality if checked. This will ask the staff member logging the resource in/out whether or not collateral has been gathered/returned.
  • Reserved For shows who currently has this resource reserved.
  • Always Available indicates that this resource doesn't need to be individually checked out or reserved, multiple users can check out the same resource at any time.
  • Reserved Date, Last Date Out, and Due Date display the exact times of reservations, checkouts, and when the resource is due to be returned.
  • Resource Type allows you to categorize this resource into a type for reporting purposes, or to restrict certain students from accessing this resource.
  • Length of Checkout determines how long an item can be checked out for before an overdue notification is sent.
  • Arbitrary Due Date allows the staff member checking out the item to choose a due date during checkout.
  • Due by end of semester will be based on your current semester end date. If chosen, a new field will appear to add a buffer before the end of the semester (i.e., to require the item be returned X days before semester end.)
  • Days / Hours / Mins will automatically set a due date based on the amount of time specified. If chosen, a new field will appear to set the maximum of number of times the checkout can be renewed.
  • Not Available to Students / Staff allows you to restrict this resource to one user type or the other. By default (both unchecked), the item is available to either user type.
  • Description is an internal description of this particular resource.
  • Keywords are the related words for this resource, delimited by commas or semicolons. For example, if you have a Laptop as an available resource, you may want to create keywords like "Computer, PC, Macbook" to make this resource easier to search for.
  • Pickup/Return Instructions can be entered and displayed in resource confirmation/return reminder emails as a twig tag.

Resource Types


Resource Types can be used to group resources together for the purpose of reporting or to block certain students from accessing certain resources. These can be managed by going to Other > Resources > Resource Types. Click the hamburger menu > New Resource Type to begin creating a new type.

6606629.png

After creating a new resource type or clicking on an existing one, you will find the following options. 1005878.png

  • Resource Type Name
The type/category for your resources.

  • Resource Type Description
Information about this resource type.

  • Linked to Profile
Allows you to link this Resource Type for use in a specific profile.

  • Allowed Student List
Allows you to only allow students on this list to checkout this resource, blocking everyone else. If left blank, anyone can checkout this resource (assuming they aren't blocked from resource usage entirely).

  • Display Notice and Require Initials when Checking Out Resources of this Type
If enabled, a prompt will appear during checkout requiring that the user agree to terms and conditions before continuing. Terms can be entered in the Logout Notice to Student field (HTML & Twig supported), and a copy of the terms can be automatically forwarded to the student by checking Send Terms and Conditions as Email to Recipient.
1164007.png

Permission Groups


There are a couple settings of note within your permission group(s) relating to Resources.

Other > Other Options > Groups > [Your Group] > Log In/Out
4838715.png

  • Allow user to log resources in and out provides users in this group the ability to record resource usage.
  • Allow user to view what resource the student has logged out provides users in this group the ability to view a student's currently logged out item.

Other > Other Options > Groups > [Your Group] > Admin/Modules
1292806.png

  • Table Access provides access to the Other > Resources view of resources. You can also assign Resource Types here to allow this group to view and edit these as well.

Using Resources


After creating your resource and updating your groups, you're ready to start checking out resources. This option can be found by going to Other > Log Resource.

3393501.png

You will then be brought to the following screen with two text entry areas available. The first is where you select a resource (searching by Barcode, Title, or Keywords), the second allows you to select a student or staff member. Once one or both fields are selected, additional options become available to check out, return, or reserve this item. The button can be used to full-screen the resource checkout pop-up, allowing you to leave it open to continuously checkout and return items.

4360537.png

In the event that Collateral Logic is being utilized, more options will be required in regards to collecting/returning the collateral item before and after checkout.

8676920.png


Reservation Options


Students can be allowed to reserve resources from their dashboard if configured in global preferences. To enable this functionality, go to Other > Other Options > Preferences > System Preferences > Resource Management.


1060876.png

  • 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.
1612619.png

  • 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.



Resource Emails


Resource emails can be customized to inform students of the due date of their checked-out resource, or if the resource is overdue. These options are part of your profile preferences, in Other > Other Options > Profiles > [Your Profile] > Prefs > Emails > Resource Checkout Emails.

Similar to your other Profile Emails, you can write a subject line and body of your email, an additional SMS text, and choose when this email is sent.


3583722.png

  • Send Overdue Emails
Disable this email, or choose what time it should be sent. This email will send if a student has an overdue checkout.


  • Student resource overdue email subject
The subject line of the email, supports Twig Tags just like the body of the email.


  • Resource overdue email
The body of the email to be sent to Students.


  • Resource overdue SMS Msg
A separate message sent to the Student's phone. Requires TextAlerts Module.


  • CC the Profile on Resource overdue emails
This option will send a copy of this email to your Profile email address if available.


  • Send additional overdue emails daily
Resend the above email on a daily basis until the item is returned.


  • Student resource confirmed subject
This email is sent immediately upon resource checkout. This option affects the subject line of the email, which supports Twig tags just like the body of the email.


  • Resource confirm email
The body of the email to be sent to Students.


  • Resource confirm SMS Msg
A separate message sent to the student's phone. Requires TextAlerts Module.


  • CC the Profile on confirmation emails
This option will send a copy of this email to your Profile email address if available.

1803308.png

  • Send Resource Reminder Emails (Pickup and Return)
Choose when reservation and overdue reminders are sent. The reservation email will notify the student that an item they reserved is available for pickup based on the first day of their reservation. The return reminder will send prior to the item becoming overdue.


  • Student resource pickup/return reminder email subject
The subject line of the email, supports Twig tags just like the body of the email.


  • Resource pickup/return reminder email
The body of the email to be sent to Students.


  • Resource pickup/return reminder SMS Msg
A separate message sent to the Student's phone. Requires TextAlerts Module.

5176821.png

  • Resource Return Confirmation
This email allows you to send an email to the user confirming that they have returned the resource.


  • Student resource return confirmation email subject
The subject line of the email, supports Twig tags just like the body of the email.


  • Resource return confirmation email
The body of the email to be sent to the user.


  • Resource return confirmation SMS Msg
A separate message sent to the user's phone. Requires TextAlerts Module.


  • CC the Profile on resource return confirmation emails
This option will send a copy of this email to your Profile email address if available.



Resource Reporting


There are two resource reports available in TracCloud. These can be found by going to Reports > Management > Resources. Resources provides information on resource utilization, while Resources Listing provides information on the items themselves.


Resources

This report exports resource usage, showing the students who have checked out a particular resource, the checkout date and time, as well as total hours. This can either be run on overall Utilization, or specifically on Past Due resources.

4560035.png


  • Time Frame
The date range for the data in this report. Beyond entering a date range manually, you can also choose a preset date range (Today, This Month, This Semester, etc) from the dropdown list above.


  • Show Inactive Resources
Include resources in results that have a status of 'Inactive.'


  • Show Summary
Only show data totals, excluding details of individual records.


  • For Past Due, Show All Checkouts
If this is checked, currently checked out resources will be included in report results. Unchecked would exclude these.


  • Include Checkout Notes
Adds the checkout notes field as an additional column in report results.


  • Show Totals Bar Chart
Adds a visual bar chart of totals to your report data.


  • Include Email in Utilization
Include the email address of the user who checked out the item.


  • Group by
Group records by the selected field. Some reports allow you to add secondary and tertiary groupings as well.


  • Student ID, Resource Type, Resource Title, Barcode, Keywords, Profile
Search by Student ID, Resource Type, Resource Title, Resource Barcode, Keywords, or the Profile of your resources.


  • Output format
Use HTML to view report data in your browser, or export this report to a CSV file (available for most reports). Some reports offer additional CSV options depending on if you want to include totals and/or data grouping in your export.


  • Deliver to
Display this report immediately in your browser ("Screen"), or send the report to a specified email address ("Email"). Multiple email addresses can be specified, use ; to separate them (example@example.edu;sample@example.edu).


  • View Utilization or View Past Due
Utilization will show all checked out resources and the individual checkouts. Past Due will only display overdue checkouts, items that were not returned soon enough, filtering out checkouts that were returned in time.



HTML
4917489.png

CSV
8374670.png




Resources Listing

The Resources Listing report will show you a list of resource records along with information about the item and how many times it's been checked out. Data can be grouped by Resource Type if set in the Sort by field.

6310180.png


  • Sort by
Choose how the selected data is sorted.


  • Show Inactive Resources
Include resources in results that have a status of 'Inactive.'


  • Show Current and Future Reservations
Include current and upcoming reservations in report results.


  • Resource Type, Resource Title, Barcode, Keywords, Profile
Search by Resource Type, Resource Title, Resource Barcode, Keywords, or the Pofile of your resources.


  • Additional Search
Filter your results by a selected field.
Use * as a wildcard (Subject: MAT*)
| as "or" (Major: Mathematics|Biology)
# as "Not" (Status: #Inactive)
&& as "And" (Major: #Mathematics&&#Biology)
blankornull as a keyword to find records where the field is blank (Reason: blankornull)
Multiple fields can be added to further narrow down your results.


  • Output format
Use HTML to view report data in your browser, or export this report to a CSV file (available for most reports). Some reports offer additional CSV options depending on if you want to include totals and/or data grouping in your export.


  • Deliver to
Display this report immediately in your browser ("Screen"), or send the report to a specified email address ("Email"). Multiple email addresses can be specified, use ; to separate them (example@example.edu;sample@example.edu).



HTML
2580564.png

CSV
6144013.png