Guide
The ChronoHub Guide provides an overview of pages and functionalities in ChronoHub, details of how to configure your ChronoHub account, recommended steps for defining the master data, how to work in ChronoHub, and tips and tricks to improve the user experience when working in ChronoHub.
1. Overview of Master Data
1.1 Users
Path: Master Data → Users
There are 4 main user types and each of the roles has various permissions/roles to modules.
Worker – Can manage his working time, request absences, see the team’s availability, and see his own reports.
Manager – All of the above plus see the reports of people in the team and manage team approval requests.
HR – All of the above, write access to master data, creation of absence requests on behalf of other users.
Superuser – All of the above, plus write access to company details configuration and monitoring.
Permissions do not overlap, and you should assign one role for each user – the higher one that the user needs.
Detailed permission list:
Worker | Manager | HR | Superuser | |||||||||
Read | Create | Read | Create | Approve | Read | Create | Approve | Read | Create | Approve | ||
Dashboard / Home | x | x | x | x | ||||||||
Manage Time | Time Entries own | x | x | x | x | x | x | x | x | |||
Time Entries – Team Members | x | x | x | x | x | x | ||||||
Time Entries – All Users | x | x | x | x | ||||||||
Requests – Own | x | x | x | x | x | x | x | x | ||||
Clocking Events – Own | x | x | x | x | x | x | x | x | ||||
Clocking Events – Team Members | x | x | x | x | x | x | ||||||
Clocking Events – All Users | x | x | x | x | ||||||||
Reporting | Timesheets | x | x | x | x | |||||||
Vacation Overview – Own | x | x | x | x | ||||||||
Vacation Overview – Team Members | x | x | x | |||||||||
Vacation Overview – All Users | x | x | ||||||||||
CSV Export | x | x | x | |||||||||
Manage Effort | Parent Objects | x | x | x | x | |||||||
Tasks – Own | x | x | x | x | x | x | x | x | ||||
Efforts – Own | x | x | x | x | x | x | x | x | ||||
Approvals | Requests – Team Members | x | x | x | ||||||||
Master Data | Users | x | x | x | x | |||||||
Departments | x | x | x | x | ||||||||
Contracts | x | x | x | x | ||||||||
Holiday Adjustments | x | x | x | x | ||||||||
Time Categories | x | x | x | x | ||||||||
Target Times | x | x | x | x | ||||||||
Holiday Models | x | x | x | x | ||||||||
Public Holidays | x | x | x | x | ||||||||
Configuration | Settings | x | x | |||||||||
Synchronization | x | x | ||||||||||
Monitoring | Notification Events | x | x |
1.2 Departments
Path: Master Data → Departments
Enter the departments based on the organizational needs. One employee can be a member of multiple departments and a manager can manage people from one or multiple departments. This configuration allows employees to see the absence calendar of people in departments the person is a member of and gives a better overview of the team’s presence on the Home or Requests screens.
1.3 Contracts
Path: Master Data → Contracts
The concept of contracts helps you to change the Target Time or Holiday Models of users.
Users with Superuser or HR permission roles can add/modify/delete contracts of other users.
– There can be only one contract valid for a user at the same period of time.
– Change of Holiday Model or Target Time via creating a new contract will calculate the Holiday Balance accordingly.
– Is Settled flag means that the employee leaves the company on the date specified in the End Date field, gets all the remaining vacation days compensated, etc. Do not use it if the employee does not leave the company.
1.4 Holiday Adjustments
Path: Master Data → Holiday Adjustments
The Holiday Adjustments functionality allows changing holiday balance of users.
Users with Superuser or HR permission roles can increase/decrease the holiday balance of other users.
– If the holiday balance of a user needs to be decreased, the minus symbol (“-”) must be used in front of the hours/minutes values. This time will be then added/deducted to the Holiday Balance of a user.
– The Date field affects the calculation of the Holiday Balance of the Contract defined during the same period.
1.5 Time Categories
Path: Master Data → Time Categories
Define Time Categories such as Presence, Vacation, Sick leave, Wedding, etc., that allow employees to select various types of Time Entries representing their absence and/or working day.
If the company has specific allowance types, the company can define how many days per year. This concept is different from the Holiday Models and days specified in this configuration usually do not accumulate over years.
When defining the Time Categories, you can assign them to one of the following five
Types:
– Regular – is used to define the worktime.
– TimeOff – is used to define holidays (based on the Holiday Models).
– Flex – any worked overtime calculates to the Flex type.
– SickLeave – is used to define sick leave.
– Allowance – when defining additional (beneficial) working or off-days that usually do not accumulate over the years (such as the wedding, paternity leave, legal obligations, etc.)
Time categories of the Allowance type allow additional configuration:
– Requires Approval – this flag will trigger an approval process. The manager receives a notification via email (if configured) to approve/reject the request. The request will be displayed in the calendar as “Pending’ (orange color) until it is approved/rejected. Approving the request will change the color of the event to green.
– Anonymize – time category is displayed in the team calendar only as Absence, not showing the exact reason for absence (apartment move, wedding, sick, etc.).
– Allowance Per Year – defines how many days of specific time categories are allowed per year.
– Expires On – defines when specific time category expires. Bonus/beneficial days usually do not accumulate over years and they reset the balance at the beginning of every year.
1.6 Target Times
Path: Master Data → Target Times
Enter the working target times of your employees.
You can create multiple Target Times, depending on the working hours of your company (e.g. 8hr working time), or when your employees work only 80% of the time (6.4hr/day for 40 hour work week), etc.
The time (target and worked) is then automatically calculated into minutes, which is the basic time unit used for all the calculations in ChronoHub.
“Target Time” is set separately for every user you create at a later stage.
1.7 Holiday Models
Path: Master Data → Holiday Models
Enter the holiday models for your employees depending on the legislation and/or benefits. The value you enter here represents the workday holiday days.
Case 1:
The standard working hours of your company are 8 hours per day. Your company allows employees to take 25 days of vacation per year. The employee working 100% is allowed to have a holiday of 25 days of vacation per year.
The holiday balance of such an employee is considered by ChronoHub as 25 days * 8 hours = 200 hours (12000 min).
Case 2:
The standard working hours of your company are 8 hours per day. Your company allows employees to take 25 days of vacation per year. The employee working 50% is allowed to have 25-holiday half-days of vacation per year.
The holiday balance of such an employee is considered by ChronoHub as 25 days * 4 hours (50% of standard 8-hour days) = 100 hours (6000 min).
Case 3:
The employee is allowed to have 30 days of vacation based on e.g. his age or other benefits. In this case, define another holiday model representing/defining 30 days of vacation. If the working time of such an employee is different than 100% of the standard working time, the holiday allowance will be calculated in the same way as described in “Case 2”.
1.8 Public Holidays
Path: Master Data → Public Holidays
Select countries or regions your employees are from. This allows you to set a proper Region for every user you create at a later stage and public holidays are displayed then also in the calendar according to it.
2. Recommended Configuration Steps
2.1 Master Data
Path: Master Data
When the new super user is created (please see section 3.1.1), we recommend configuring the Master Data in the following order:
1. Departments 2. Time Categories 3. Target Times 4. Holiday Models 5. Public Holidays 6. Users
Note: Users are defined as the last point due to the fact, that all of the master data defined before users are used when you create users, so you would need to edit every user again after defining these master data at a later stage.
2.1.1 Configuration of Users
The initial user that is provided to you by us after the account (tenant) creation is a user admin@%CompanyEmailAddress% with a randomly generated password. This user has superuser permissions. We recommend configuring a new user with a superuser role with your own password and deactivating the initial admin user.
For now, we do not offer our own user management with authentication or other security features, however, basic user creation is available for you to explore the application.
We support full authentication and user management via Microsoft Entra (former Azure Active Directory), which links users in ChronoHub with your Windows account. This configuration adds an additional layer of security.
Please note that if users managed with Microsoft Entra are not used, access of the users is secured only with the passwords and the accounts can be accessed from any location or any device. Due to this, we recommend setting secure and complex passwords, and using Microsoft Entra.
Admin user creates other users with their work email addresses. The domain (suffix of the email address) of other users needs to be the same as the domain of the admin user. Admin provides a temporary password to users and users are asked to change their password when they log in.
Example:
The administrator user provided by us to you is: “admin@company123.com”
Users created must have the format: “user1@company123.com“, “user99@company123.com“, etc.
If a different domain (the string after the “@” character) is used for the user, the user will not be able to connect to the ChronoHub account.
If the Entra (former Azure Active Directory) is in place and email addresses are set according to it, users do not need to enter usernames and the passwords generated by the admin user, but they can log in by clicking on the Login with Microsoft button (please see the screenshot below). With this option, the user logged in to the Windows account will be used to log in to the ChronoHub automatically.
When the user is created, the first Contract is also automatically created based on the configured Start Date, End Date, Holiday Model, and Target Times.
The Holiday Balance of the user is calculated automatically according to the configured Holiday Model and the Start Date and/or End Date.
If you set a new user during the year and the Holiday Balance of the user does not match the current Holiday Model (e.g. due to carryover days, vacation taken already, etc.), you can further adjust the balance via Holiday Adjustments menu in Master Data.
2.2 Company Settings
2.2.1 Company
Path: Configuration → Settings → Company
On this screen, you can define details of your company. The company address and logo are displayed on the Timesheets report as the header.
2.2.2 Notifications
Path: Configuration → Settings → Notifications
On the Notifications screen, you can activate/deactivate various notifications:
Enable notifications: Activation/deactivate email notifications in general
Enable notifications for sick leave: If a user enters a sick leave in ChronoHub, the manager receives a notification about this action via email immediately.
Clockout overdue hours: If a user starts the working time and does not clock out (stop), the manager receives a notification via email based on the time defined. Please see the example of the configuration below.
Example:
If the standard working time of a company is 8 hours, and the manager wants to receive a notification 1 hour later after the user forgets to log out, the value inserted needs to be 9. The logic checks open clocking events every 5 minutes and if an open clocking event is found, the email is sent.
Notifications are dependent on the 3.2.3 Email configuration. For the time being, we support emailing via SMTP.
2.2.3 Email
Path: Configuration → Settings → Email
On this screen, you can configure your SMTP server configuration.
2.3 Synchronization
You can synchronize objects such as service calls, sales orders and projects from SAP Business One. The synchronization is performed via the service layer of SAP Business One.
If you want to synchronize these objects in your ChronoHub account and book efforts on them, the following connection has to be open in the firewall.
Initially, we connect to:
https://<Server Name/IP>:<Port>/b1s/v1/Login
The endpoints we contact later are based on the synchronized objects:
/b1s/v1/ServiceCalls
/b1s/v1/Orders
/b1s/v1/ProjectManagements
b1s/v1/ProjectManagementService_GetSubproject
3. Working in ChronoHub
3.1 Home
This is the main screen which is common for all types of users.
The Timesheets container provides a quick overview of the user’s working times and breaks. The user can start and stop the working time, which automatically calculates the defined target time and shows over or under times. The time can also be added for a specific day or a range if required.
The Time Off container shows the availability of the team, so the users in the same team/department can plan their holiday accordingly. You can find here both a Team view, or a Personal view with details about the Holiday Balance.
The Efforts container contains the list of efforts booked on the objects synchronized from SAP Business One or other application. Please see the section 3.3 for more details.
3.2 Manage Time
3.2.1 Time Entries
The Time Entries page contains a detailed view of time entries entered by users on the Home screen or Time Entries screen. It contains work time and sick leave related Time Entries.
Depending on the level of permissions, users can see or enter here also time entries on behalf of other users. You can also edit your Time Entries in case of need. Please see the section 2.1 for permission details.
3.2.2 Recording a Sick Leave
On the Time Entries page, click on the Create new button and select a sick leave-related Type of time entry (please see section 2.5).
If required by the company, users can attach the sick leave confirmation from a doctor or any other document.
– One file can be uploaded for one Time Entry.
– Supported file formats are jpeg, png, and pdf.
– ChronoHub is resizing picture formats to 1200px (the longer side).
– The Sick Leave-related time entries are displayed in the team calendar with gray color.
3.2.3 Requests
On the Requests page, users can ask for various types of time entries that require the approval of their manager. These categories depend on the company configuration (please see section 2.5). You can display Pending, Approved, Rejected, Canceled ,or All requests for the desired week, month, or year.
– The request can be done for a specific day, or a range of dates.
– If the public holiday or weekend is in the range of your absence request, these days off are not deducted from the holiday balance.
– If the number of days of the user’s request of a desired off-time category is higher than the days allowed by the company, the requestor will receive a dialog to confirm the request and a manager will receive information about over-booking in the email.
3.2.4 Clocking Events
In ChronoHub, every day is represented by one time entry which is closed at midnight. In case the user forgets to stop his working day by clicking on the Stop time on the Home page, the clocking event from the previous day will be open. The Clocking Events page allows users to close such clocking events and then in case of need, users can Add time if required.
Depending on your permissions level, you can see your own open clocking events, team members or all users.
3.2.5 Cancelation of Approved Vacation or Other Absence
Full cancelation: If a user wants to cancel the full approved vacation or any other time category that required approval, this can be done in Manage Time → Requests. Then open the desired request in the Approved tab, and click on the Cancel Request button.
Partial cancelation: If the approved request is for more days of vacation and the user wants to cancel only 1 day of the vacation, it can be done via Manage Time → Time Entries. Here, the user needs to find the time entry (day) he wants to remove and click on the Delete button.
3.2.6 Change of Approved Absence Type to Another Absence Type
If the user wants to change an approved time entry to a different type, the original time entry has to be canceled or deleted and then the correct type needs to be requested again.
In case the user cancels a time entry where the current date is higher than the date of a time entry, the manager will be notified about this action. The user is also informed about this before submitting the change.
3.3 Reporting
3.3.1 Timesheets
The Timesheets page gives the user a full overview for a desired period of time. From here, by clicking on Normal View, you can switch to Detailed View, where you can see the holiday balance, the time worked, or the time of the sick leave. The user can also save the report as a PDF or can export the timesheets as a CSV file.
3.3.2 Vacation Overview
The Vacation Overview report shows the carryover vacation days from the previous year, annual allowance as well as spent or remaining vacation days for the current year. The user can also see a detailed Calendar View for the specific month.
Depending on the level of permissions (please see section 2.1), the user can see own holiday balance or the holiday balance of other users from the team or the company.
– Depending on the Holiday Models and Target Times of users, users are entitled to have the same number of holiday days specified by the company, however, the number of hours of holidays is dependent on the workload (Target Times) of users. Please see section 2.7 for more details. Users can see their exact number of hours of vacation by switching to Hours on the Vacation Overview screen, or on the Home screen by switching to the Personal calendar in the Time Off container.
3.3.3 CSV Export
The CSV Export is a mass-export functionality. It allows managers or HR people to select a specific date range, multiple users, or multiple time categories and export them in one CSV file.
3.4 Manage Efforts
3.4.1 Parent Objects
The Parent Objects page shows the list of all the synchronized objects from the SAP Business One.
3.4.2 Tasks
On the Tasks page, you can create new tasks and link the synchronized objects from SAP Business One to them.
3.4.3 Efforts
The Efforts page allows the users to book an effort (add time) on objects synchronized from SAP Business One (Parent Objects) or on the Tasks.
3.5 Approvals
On the Requests page, managers can see the list of the requests sent by the users they are managing. Managers can approve or reject the request with a comment. In addition to pending, they can also see the list of past approved or rejected requests.
3.6 Removing Users
If the employee leaves the company, the user should be removed from ChronoHub.
To remove the user, two steps have to be done.
1. The contract has to be settled on the Master Data -> Contracts. The End Date and the flag Is Settled on the active Contract of the user needs to be set to calculate the Holiday Balance.
2. When the last date of the employee is reached, the user can be deleted in Master Data ->Users.
The step 2. secures that the user will not be displayed in the team’s calendar anymore.
3.7 Reactivation of Removed Users
In ChronoHub, an email address is a unique identifier and you can not create 2 users with the same email address. Due to this, if any removed user needs to be reactivated again, you can go to Master Data → Users and click on the Deleted tab. Then open the user you want to reactivate, set the Manager, Departments, and Roles, and click on the Reactivate button.
3.8 Password Change of Users
The logged-in users can change their passwords by clicking on the profile picture in the top right corner, then clicking the Reset Password menu item and entering a new password.
When this is done, the new password is valid immediately.
If the user forgets the password and can not log in to the application, the user needs to ask the user with the SuperUser permissions to reset the password. During this procedure, the SuperUser provides the temporary created password to the user. During the next login, the user will be asked to use the temporary password created by the SuperUser and at the same time also to set a new password.
SuperUser can reset the password of any user by clicking on the Reset Password menu item accessible via the profile picture in the top right corner, or by navigating to the Master Data → Users and then by clicking on the key icon of the respective user.
3.9 Monitoring
The Notification Events page in the Monitoring menu allows superusers to monitor the notifications sent/received. In case you configured notifications via SMTP and users stop receiving them, you can see the reason in the SMTP Status Message and contact your SMTP provider in case of need.
4. Tips and Tricks
4.1 Date Range Selection
If you see on any page 3 horizontal dots, by clicking on them you can switch to Weekly, Monthly or Yearly view.
4.2 Quick Item Search in Dropdown Lists
When you are on any dropdown list on any page and you are looking for a specific item/user, open the dropdown list and start typing on the keyboard to get you to the desired item. In this case, I typed “ma” and the “manager” is highlighted.
4.3 Filtering of Values in the Grid
When there is a grid on any page, you can filter based on many conditions. In the column grid you want to filter on, click on the three horizontal lines and pick your desired filtering. In our case below, we wanted to display the objects that are valid for customer “Tschannen Ingenieure”.
After filter is applied, you can see the filter icon in the column you used the filtering on.
Note: The filter will reset if you switch to other page.
4.4 Logging Out from ChronoHub with Entra
When Microsoft Entra is in place and users are logging in via the Login with Microsoft button, when they log out, to avoid logging out completely from internal Microsoft account, after clicking on the Logout button click on the X (close) button in the popup.
4.5 You Face any Issues
As there are various browsers and various browser technologies, in specific cases they process web page design differently and it can lead to graphical inconsistencies. When there is a new and fully tested functionality ready on our side, we deploy it to the production environment, which might affect also your experience. The first help in these scenarios is to refresh the cache of the browser via left Ctrl + F5 (or left Ctrl + Shift + R).
In case the cache refresh does not help, please contact us via opening a support ticket via Zendesk.