Optimization Horizon
Specify a time period for your Field Service optimization requests to focus optimization processing on the required dataset.
Required Editions
| Available in: both Salesforce Classic (not available in all orgs) and Lightning Experience |
| The Field Service core features, managed package, and mobile app are available in Enterprise, Unlimited, and Developer Editions. |
The optimization horizon defines the time period of data sent to the engine to be optimized as well as the time period in which appointments can be scheduled. The data consists of the service resources active during that time, operating hours, shifts, service appointments, and any other data that must be considered when building a schedule. An optimization horizon is specified in any of these scheduling services.
- Global or In-day optimization from the Classic Dispatch Console
- Resource Schedule Optimization
- Optimization of scheduled jobs
- Optimization methods in the OAAS class
Consider these two aspects when understanding which service appointments are sent to optimization within the optimization horizon:
Total Set of Service Appointments Sent to Optimizer
The optimizer needs information on the service appointments that can affect scheduling decisions, including appointments that can’t be optimized, such as pinned service appointments and service appointments not meeting filter criteria. For example, service appointments in a Completed status are sent to optimization, even though the optimization engine can’t move these appointments. The engine still needs information about the Completed service appointment to create a schedule around it.
Knowing the total number of service appointments sent to optimization in an optimization request is important to estimate any impact on optimization limits. See Field Service Limits and Limitations. The criteria of service appointments sent to optimization can be defined as:
-
Service Appointments that aren’t assigned to a service resource:
- Earliest Start Permitted < Optimization Horizon End + 24 hours AND
- Due Date > Optimization Horizon Start - 24 hours
-
Service Appointments that are assigned to a service resource:
- Scheduled Start < Optimization Horizon End + 24 hours AND
- Scheduled End > Optimization Horizon Start - 24 hours
Service Appointments That Can Be Optimized
The criteria for service appointments eligible to be optimized are defined as:
Service appointments that aren’t assigned to a service resource:
- Without an arrival window:
- Earliest Start Permitted < Optimization Horizon End AND
- Due Date > Optimization Horizon Start
- With an arrival window:
- Earliest Start Permitted < Optimization Horizon End AND
- Due Date > Optimization Horizon Start AND
- Arrival Window Start < Optimization Horizon End AND
- Arrival Window Start > Optimization Horizon Start
Service appointments that are assigned to a service resource:
- Scheduled Start < Optimization Horizon End AND
- Scheduled End > Optimization Horizon Start
Some considerations for service appointments that can be optimized.
- Service appointments classified as pinned and service appointments that don’t meet filter criteria aren’t optimizable.
- Service appointments included in the dataset but not in the list of service territories to be optimized can’t be optimized.
- When you’re not using Enhanced Scheduling and Optimization, rule-violating service appointments can’t be optimized. When you’re using Enhanced Scheduling and Optimization, the engine can find an acceptable schedule for rule-violating service appointments or drop these appointments from the schedule.
- Service appointments defined with Keep Scheduled Criteria can be optimized, but the optimization request can’t unschedule these appointments.

