Loading
Salesforce Enforces New Security Requirements in Summer 2026Read More
Agentforce Field Service and Operations
Gain Visibility into Optimizations with Field Service Optimization Insights

Gain Visibility into Optimizations with Field Service Optimization Insights

In Field Service, learn at a glance if a global or in-day optimization reduces travel time or improves utilization. As you refine a scheduling policy, view a snapshot of optimization results and KPI changes.

Required Editions

Available in: Lightning Experience
The Field Service core features, managed package, and mobile app are available in Enterprise, Unlimited, and Developer Editions.
User Permissions Needed
To create and edit Lightning pages: Customize Application
To add components to optimization request pages:

One of these custom permission sets:

  • FSL Admin Permissions
  • FSL Dispatcher Permissions

Package icon This is a Field Service managed package feature.

Insights are available for global and in-day optimization requests that complete successfully. They aren’t supported for resource schedule optimization.

Note
Note Optimization Insights is not available when using Enhanced Scheduling and Optimization.
  1. In Field Service Settings | Optimization, enable Optimization Insights.
    Note
    Note Make sure that the Optimization Profile has access to the OAASRestInsights and OAASRestHealthCheck Apex classes.
  2. Edit an optimization request page in Lightning App Builder.
  3. From the custom managed package components, add the optimization insights components.
  4. Save your changes, and activate the page if necessary.
  5. Submit a global or in-day optimization.
    If the optimization completes successfully, insights appear on the optimization request.

There are four optimization insights components: summary (1), metrics (2), key performance indicators (3), and health check (4).

Optimization insights shows the impact on travel and utilization.

The summary component shows details about the optimization request, such as status, horizon, and territories. It displays the Time per Appointment from Field Service optimization settings, and lists Boolean filters that selected appointments in the request. As you refine a scheduling policy, the summary gives you a point-in-time snapshot of the policy, including the work rules and weighted service objectives, that produced the insights.

Note
Note Some details are only available for global optimization requests.

Metrics provide an overview of scheduling information, such as how many appointments were scheduled from the pool of optimizable appointments. Optimizable appointments are unpinned and can be moved.

The KPI component displays key performance indicators by territory before and after the optimization.

KPI How the KPI is Calculated
Average Travel per Appointment with Homebase Total estimated travel time, including travel from and to the resource’s home base, divided by the count of scheduled service appointments.
Average Travel per Appointment without Homebase Total estimated travel time, excluding travel from and to the resource’s home base, divided by the count of scheduled service appointments.
Total Travel with Homebase Total estimated travel, including travel from and to the resource’s home base, for all scheduled service appointments.
Total Travel without Homebase Total estimated travel, excluding travel from and to the resource’s home base, for all scheduled service appointments
Total Scheduled Appointments Count of scheduled service appointments.
Total Duration Scheduled Total duration for the scheduled service appointments.
Utilization Total duration and travel time for the scheduled appointments, divided by overall resource capacity. To learn how we calculate capacity, see Considerations.
Utilization Wrench Total duration for the scheduled service appointments, divided by the overall resource capacity. Utilization wrench represents total direct labor. To learn how we calculate capacity, see Considerations.

The Health Check component summarizes the results of a suite of tests and validates your data. For example, the tests check if the appointment exceeds the available time to complete or whether the required resource has the necessary skills. Before you drill down into your KPIs, make sure that all the tests passed successfully.

  • For Utilization and Utilization Wrench KPIs, capacity is the total available work time from shifts and operating hours in primary territory memberships, including overtime. We subtract breaks, absences, and crew allocations; we also add or subtract availability from relocations.
    Note
    Note We subtract absences only if the entire absence of a resource is included in the time period of that resource's service territory membership record.
  • For the Total Duration Scheduled KPI, we subtract appointments’ Scheduled Start times from Scheduled End times. For multiday appointments, we include them in the total if the appointments are completely within the horizon; for those appointments, we add the Duration fields.
  • In metrics, the resource count excludes capacity-based resources and partial or full crew assignments that occur during the horizon.
  • The components list metrics and KPIs by territory. For resources with secondary territory memberships, there are some nuances for allocating time to territories. For example, we allocate travel time to the territory referenced in a service appointment. We also allocate scheduled duration based on an assigned resource’s primary service territory membership.
  • Optimization insights only support service appointments that have territories. Service appointments without a territory don’t affect metrics and KPIs.
 
Loading
Salesforce Help | Article