Allow agents to start traveling before their scheduled work hours
Support flexible work types by allowing agents to start traveling before their scheduled work hours. For example, you may want to add travel time outside of an agent's scheduled work hours in case bad weather suddenly increases travel time.
Before you begin
If you are an administrator, you can run a script and add travel time outside of work hours for all users.
Role required: wm_dispatcher, wm_manager, wm_admin, or admin
Procedure
Navigate to All > Field Service.
Do one of the following actions:
If you are a dispatcher, go to Dispatching > My Agents.
If you are a manager, go to Manager > My Team.
Select a user profile.
To add or update user records, do one of the following.
Option
Description
Add a new record for this user
Click the Work Parameters tab.
Click New.
Click the Travel outside of work hours drop-down menu.
Click Yes
Click Submit.
Updated an existing record
Click the Work Parameters tab.
Double-click the Travel outside of work hours column.
Click the new parameter.
Click Save (Enter).
To add travel time as work hours for all users, do the following:
Navigate to System Definition > Scripts - Background
In the Run Script window, add the script to include travel time as work hours for all users.
Option
Description
Add travel time as work hours for all users
Add this script:
createWorkParamsForAllAgents("yes");</p>
</li>
</ol>
<p>function createWorkParamsForAllAgents(travelOutsideWorkHours) {
var gr = new GlideRecord("sys_user_has_role");
gr.addEncodedQuery("role=26c324ba1b32200096f9fbcd2c0713c2"); // fetching users having wm_agent role
gr.query();
gs.info("total work agents found: "+gr.getRowCount());
var agentWorkParameter = {};</p>
<pre><code> while (gr.next()) {
var userId = gr.getValue("user");
if (!agentWorkParameter[userId]) {
var wp = new GlideRecord("wm_agent_work_configuration");
wp.initialize();
wp.setValue("user",userId);
wp.setValue("travel_outside_of_work_hours", travelOutsideWorkHours); // setting default value for travel_outside_of_work_hours
wp.insert();
agentWorkParameter[userId] = true;
}
}
}
Click Run Script.
Update travel time as work hours for all users
Add this script:
``` updateWorkParamsForAgents("yes"); // param1: default travel outside work hours value
function updateWorkParamsForAgents(travelOutsideWorkHours) { var gr = new GlideRecord("wm_agent_work_configuration"); gr.query(); gs.info("total agent work parameters found: "+gr.getRowCount()); var updateCount = 0;
while (gr.next()) {
var canTravelOutside = gr.getValue("travel_outside_of_work_hours");
if ( canTravelOutside != travelOutsideWorkHours) {
gr.setValue("travel_outside_of_work_hours", travelOutsideWorkHours);
if (gr.update())
updateCount ++;
}
}
gs.info("total agent work parameters updated: "+updateCount);