5,901
edits
Changes
Jump to navigation
Jump to search
Created page with "'''Working hours''' is a custom entity that allows you to configure working hours of your resources in the Schedule Board. This feature was designed for the resco.FieldS..."
'''Working hours''' is a custom entity that allows you to configure working hours of your resources in the [[Schedule Board]]. This feature was designed for the [[resco.FieldService]] project, but it can be potentially reused for other organizations that use Schedule Board.
== Necessary entities ==
The following entities are necessary for this feature:
* Working hours (fs_workinghours) - allow you to save different working hours under a name
* Company settings (fs_settings) - select one of the configured working hours as the company default (the entity must have a lookup to the Working hours entity)
* Resource (fs_resource) - select one of the configured working hours for each resource (or other entity that you are using for your Schedule Board; the entity must have a lookup to the Working hours entity)
== Defining working hours ==
When you create a form for the Working hours entity, the form automatically includes an editor.
[[File:Working hours editor.png|400px]]
The hours are saved in the Data field. If you need to work with the data directly, it is saved in JSON format. The numbers are in minutes.
<syntaxhighlight lang="JSON">
{
"workingHours": [
[],
[
{
"start": 480,
"end": 780
},
{
"start": 840,
"end": 1140
}
],
[
{
"start": 480,
"end": 960
}
],
[],
[],
[],
null
],
"workingHolidays": false
}
</syntaxhighlight>
== Associate resources with working hours ==
Once the working hours are defined, you can associate them, either as the default setting of the organization, or with a particular resource.
[[File:Working hours in company settings.png|300px]] [[File:Working hours in resource settings.png|300px]]
== Working hours in action ==
If everything is properly configured, you can see the working hours highlighted in the Schedule Board timetable. Note that Luke's working hours are different from other team members.
[[File:Schedule board timetable.png|600px]]
[[Category:Resco Field Service]]
== Necessary entities ==
The following entities are necessary for this feature:
* Working hours (fs_workinghours) - allow you to save different working hours under a name
* Company settings (fs_settings) - select one of the configured working hours as the company default (the entity must have a lookup to the Working hours entity)
* Resource (fs_resource) - select one of the configured working hours for each resource (or other entity that you are using for your Schedule Board; the entity must have a lookup to the Working hours entity)
== Defining working hours ==
When you create a form for the Working hours entity, the form automatically includes an editor.
[[File:Working hours editor.png|400px]]
The hours are saved in the Data field. If you need to work with the data directly, it is saved in JSON format. The numbers are in minutes.
<syntaxhighlight lang="JSON">
{
"workingHours": [
[],
[
{
"start": 480,
"end": 780
},
{
"start": 840,
"end": 1140
}
],
[
{
"start": 480,
"end": 960
}
],
[],
[],
[],
null
],
"workingHolidays": false
}
</syntaxhighlight>
== Associate resources with working hours ==
Once the working hours are defined, you can associate them, either as the default setting of the organization, or with a particular resource.
[[File:Working hours in company settings.png|300px]] [[File:Working hours in resource settings.png|300px]]
== Working hours in action ==
If everything is properly configured, you can see the working hours highlighted in the Schedule Board timetable. Note that Luke's working hours are different from other team members.
[[File:Schedule board timetable.png|600px]]
[[Category:Resco Field Service]]