Show and optimize the agent task route in Dispatcher Workspace

  • Release version: Australia
  • Updated March 12, 2026
  • 2 minutes to read
  • View agent records, agent schedules, and view or optimize the scheduled task route of an agent for that day. You can help them manage their schedules and tasks more efficiently.

    Before you begin

    You must enable the sn_fsm_disp_wrkspc.sn_fsm.dispatch_ws_map.route_enabled system property to display the Route icon in your dispatcher workspace.

    You must select the work.management.optimization.conflict_handling system property to avoid conflicts due to overflow tasks when optimizing the route. For more information, see Properties installed with Field Service Management.

    Role required: wm_dispatcher and wm_manager

    About this task

    In the Dispatcher Workspace, you can view the routes of all the tasks for a single or multiple agents for that day by using the route feature. Routes show agent's completed route, future route, and the route that they take back to their home location after the tasks are complete.

    You can also optimize the task route for an agent to reorder the tasks as efficiently as possible. The route optimization feature considers the following attributes when reordering the agent tasks for the day:
    • Respects the agent personal time-off and reroutes the tasks before or after the break.
    • Doesn’t reorder the work order tasks that are scheduled lock.
    • Controls the scheduling of overflow tasks to avoid conflicts by selecting any one of the behavioral methods, such as stop route optimization, unassign overflow tasks, or adjust the overflow task by assigning it toward the end of the agent's schedule.
    • Considers the agent's start of the day and end of the day locations from the Resource Schedule Attributes table.
    Note:

    If your organization uses schedule attribute plans with territories and your agents have a temporary home location set, then the temporary home location shows for the duration on the map in Dispatcher Workspace. For more information, see Change schedule attributes for agents.

    Procedure

    1. Navigate to Field Service > Dispatching > Dispatcher Workspace.
    2. Select Dispatcher Workspace.
    3. Optional: Search for a field service agent whose route you want to view.
    4. Select Map or Hybrid from the Schedule drop-down list.
    5. Select and hold (or right-click) on an agent pin and do one of the following:
      • Show/ hide route- shows the route if the route is hidden, hides the route if the route is shown.
        Note:

        If you’re showing a route then you see the agent’s completed route. Completed routes are lighter in color, only show as straight line, and don’t necessarily match the exact route the agent actually took.

      • Optimize route- opens the route optimization window. In the Optimize Route dialog box, select Optimize.

      If you chose Optimize route, then the following happens:

      The tasks are rearranged based on the route sequence.

      The Optimize Route dialog box displays the compared details of the new and old routes, such as map visualization, driving time, driving distance, and number of tasks. The new route is displayed in blue, while and the old route is grayed out.

      The overflow tasks are managed based on the selected route optimization behavior.

    6. Optional: To clear the agent route from the map, select Hide all routes in the map view.