What This Screen Does
This is where you see a summary of how many hours each employee has earned, used, and has left in their hour bank. Think of it like a bank statement, but instead of money it tracks time. You can search for specific employees, sort the list, and export the data to a spreadsheet file.
How to Get There
Open the dashboard.
In the left-hand menu, click Hour Bank.
You are now on the Hour Bank List screen.
Step-by-Step Guide
1. View the Hour Bank Table
When the page loads, you will see a table with one row per employee. The table shows data for the current month by default (from the 1st to the last day of the month).
Each row displays the following columns:
Column | What It Shows |
Name | The employee’s name. Click it to go to that employee’s detail page. |
Hours earned | The total hours (and minutes) the employee has earned during the selected period. |
Hours used | The total hours (and minutes) the employee has spent during the selected period. |
Hours remaining | The difference between earned and used — how much time the employee still has available. |
2. Filter by Status Tab
At the top of the card you will see a tab labelled All.
This tab shows the total number of records.
Click it to reset any status filters and see every entry.
3. Search for an Employee
Use the Search text field at the top of the table.
Start typing an employee’s name.
The table updates automatically as you type.
To clear the search, delete the text in the search field.
4. Sort the Table
Click any column header (Name, Hours earned, Hours used, Hours remaining) to sort the table by that column.
Click the same header again to toggle between ascending and descending order.
A small arrow on the header indicates the current sort direction.
5. Change Pagination Settings
At the bottom of the table you will find pagination controls.
Rows per page: Choose how many rows to display at once (e.g. 5, 10, 25).
Page navigation: Use the arrow buttons to move between pages.
Dense mode: Toggle the density switch to make rows more compact, which lets you see more data at a glance.
6. Print the Page
Click the three-dot menu (⋮) icon to the right of the search field.
Select Print.
Your browser’s print dialog will open so you can print the table or save it as a PDF.
7. Export to CSV
Click the three-dot menu (⋮) icon to the right of the search field.
Select Export.
A CSV file named
result.csvwill download to your computer.Open it with any spreadsheet application (Excel, Google Sheets, Numbers) to analyse the data further.
The export includes all matching records regardless of the current page, using your active search filter.
8. Clear Filters
If you have changed any filters (search text, status, or role), a summary bar appears below the toolbar showing your active filters and the number of results found.
Click the Clear button (with a trash icon) to reset all filters back to their defaults.
You can also remove individual filter chips by clicking the × on each chip.
What Happens Behind the Scenes
Page loads (or filters/sorting/page changes)
|
v
Date range is set to current month (1st – last day)
|
v
API call: GET /api/hour-bank
params: { fromDate, toDate, pageSize, pageNumber, sortBy, direction, searchString }
|
v
Server returns a list of hour bank records
+ "x-total-count" header with the total number of entries
|
v
Table renders one row per employee
|
v
URL query parameters update to preserve your current view
(rowsPerPage, page, orderBy, order, status, search, roles)
When you export:
You click "Export"
|
v
API call: GET /api/hour-bank
headers: { Accept: "text/csv" }
params: { pageSize: max, pageNumber: 0, searchString }
|
v
Server returns CSV data
|
v
Browser downloads the file as "result.csv"
Troubleshooting
“The table is empty and I do not see any employees”
Make sure you have the correct gym/location selected in the dashboard. The hour bank only shows employees for the currently selected gym.
If you recently added employees, they may not have any recorded hours yet. They will appear once hours are logged.
Check that you have not typed something in the Search field that does not match any employee names.
“The hours shown do not match what I expected”
The list defaults to the current month (1st to last day). If you are looking for hours from a different period, the data shown may not cover the dates you have in mind.
Hours are split into earned, used, and remaining. Make sure you are reading the correct column.
If an employee’s hours were recently updated, try refreshing the page to fetch the latest data.
“I clicked an employee’s name but nothing happened”
Clicking the employee name should take you to that employee’s detail page.
If the page does not navigate, check your internet connection and try again.
If you do not have permission to view employee details, the link may not work. Contact your administrator to check your role permissions.
“The Export button downloads a file but it is empty or looks wrong”
Open the downloaded
result.csvfile in a spreadsheet application. Some text editors may not display CSV data neatly.If the file is empty, it means no records matched your current search filter. Clear the search field and try exporting again.
If special characters (like accented names) look garbled, make sure your spreadsheet application is set to read the file as UTF-8 encoding.
“The page loads slowly or seems stuck”
A large number of employees can slow down the request. Try reducing the Rows per page setting to a smaller number (e.g. 10 or 25).
Check your internet connection. The data is fetched from the server each time you change a filter, page, or sort order.
If the problem persists, try refreshing the page or clearing your browser cache.
“My search filter disappeared after refreshing the page”
Your current filters (search text, page, sort order, status, and roles) are saved in the URL query parameters. If they disappeared, the URL may have been modified or reset.
Bookmark the page after applying your preferred filters to save them for quick access.
“I see a Delete action bar but cannot delete anything”
The table has a built-in selection and delete action bar. However, deletion from the hour bank list may not be enabled for your role.
If you need to remove hour bank entries, check with your administrator about the correct way to manage hours in your organisation.
“The Print option does not show the full table”
The print function uses your browser’s built-in print feature. Only the data currently visible on screen will be printed.
To print all records, either increase the Rows per page to show more entries, or use the Export option to get a full CSV and print from your spreadsheet application.