---
sourceDocument: Brazil Field Service Management
sourceDocumentLink: https://www.servicenow.com/docs/r/field-service-management

 Release :

    - brazil

ft:locale :

    - en-US

ft:publication_title :

    - Brazil Field Service Management

ft:clusterId :

    - fsm

bundleId :

    - fsm

workflow :

    - Customer and Industry


---

# Properties installed

# Schedule Optimization properties {#ariaid-title1}

Release version: Brazil  
Updated September 10, 2026  
![](https://www.servicenow.com/docs/portal-asset/ico-clock) 9 minutes to read  
You can set parameters that control how optimization runs.

## Field Service
Schedule Optimization properties {#schedule-optimization-properties__section_pmz_pn3_cyb}

## Schedule Optimization general properties {#schedule-optimization-properties__section_hwf_ysj_21c}

{#schedule-optimization-properties__table_dy4_zsj_21c__entry__2}

| Property | Description |
|-|-|
| Exit buffer time | Amount of time (in minutes) to add between the end of a task and the travel start of the next. An example of a valid time value is 10. * Type: Integer * Default value: 0 * Location: AllField ServiceAdministrationProperties {#schedule-optimization-properties__ul_vns_rdh_sbc} |
| Qualifier type for schedule optimization | The qualifier type for schedule optimization determines the criteria used to optimize schedules. There are two qualifier types available: "Assignment group" and "Territory." When the Field Service Territory model is enabled, the qualifier type automatically switches to "Territory" and remains fixed. This means that when the Territory model is active, the optimization process focuses on territories instead of assignment groups. For more information, see [Enable the Field Service territory model](https://www.servicenow.com/docs/zHJzodYIDLqx6Ga7aso7Mg "Activate the territory model to display the Territory field in the work order task form so the task can be assigned to an agent or crew associated with the selected territory. The territory model maintains a record of territories mapped to it."). * Type: String * Default value: Assignment group * Location: AllField ServiceSchedule OptimizationAdministrationProperties {#schedule-optimization-properties__ul_vyn_zdh_sbc} |
| Number of seconds used for task scheduling resolution | Specifies the acceptable interval for scheduling a task. For example, the value is set to 300 seconds. Schedule Optimization will schedule tasks and the associated travel time, such as task start, travel start, or estimated end, to the nearest 5-minute start or end time. * Type: Integer * Default value: 300 * Location: AllField ServiceSchedule OptimizationAdministrationProperties {#schedule-optimization-properties__ul_zgh_n2h_sbc} |
| Maximum number of overlapping qualifiers in a qualifier set | Numeric value set to determine the maximum number of overlapping qualifiers that can be applied to a single qualifier set. * Type: Integer * Default value: 30 * Location: AllField ServiceSchedule OptimizationAdministrationProperties {#schedule-optimization-properties__ul_t4c_f2h_sbc} |
| Logging level | The logging level will determine the type of information displayed in the results of an optimization log entry, providing details about the Schedule optimization run. There are four options available: Error, Warning, Info, and Debug. * Type: Choice * Default value: Error * Location: AllField ServiceSchedule OptimizationAdministrationProperties {#schedule-optimization-properties__ul_zhs_wbh_5fc} |
[Table 1. General]

{#schedule-optimization-properties__table_dy4_zsj_21c}

## Schedule Optimization travel time estimate properties {#schedule-optimization-properties__section_nxs_wbh_5fc}

{#schedule-optimization-properties__table_rmt_mjt_bfc__entry__2}

| Property | Description |
|-|-|
| Maximum number of location points allowed in a map vendor call | Numeric value set to determine the maximum number of location points allowed in a map provider call. Beans.AI is the map provider that Schedule Optimization supports for travel time estimates. For more information, see [Schedule Optimization travel estimate providers](https://www.servicenow.com/docs/N~4Br86WGysDQYokeRRhxw "Travel estimate providers used by Schedule Optimization."). * Type: Integer * Default value: 300 * Location:AllField ServiceSchedule OptimizationAdministrationProperties {#schedule-optimization-properties__ul_wln_4jt_bfc} |
[Table 2. Travel Time Estimates]

{#schedule-optimization-properties__table_rmt_mjt_bfc}

## Schedule Optimization system properties {#schedule-optimization-properties__section_ggt_tbh_5fc}

The following system properties are installed with Schedule Optimization.  
{#schedule-optimization-properties__table_hgt_tbh_5fc__entry__2}

| Property | Description |
|-|-|
| sn_schedule_optim.so_max_batch_duration | Maximum duration between start and end time on a batch run, in hours. * Type: Non-zero integer (in hours) * Default value: 6 * Location: System Properties list \[sys_properties\] table {#schedule-optimization-properties__ul_egh_d51_n3c} |
| sn_schedule_optim.so_min_batch_duration | Minimum duration between start and end time on a batch run, in hours. * Type: Non-zero integer (in hours) * Default value: 2 * Location: System Properties list \[sys_properties\] table {#schedule-optimization-properties__ul_p1k_g51_n3c} |
| sn_schedule_optim.consider_overlapping_territories_for_scheduling | Controls whether overlapping territories are considered when scheduling tasks during optimization. * Type: True/False * Default value: True * Location: System Properties list \[sys_properties\] table {#schedule-optimization-properties__ul_jfh_p51_n3c} |
| sn_schedule_optim.max_priority_events | Maximum number of prioritized event types that can be configured to trigger optimization. * Type: Non-zero integer * Default value: 3 * Location: System Properties list \[sys_properties\] table Note: The 'maint' role is required to edit this property. This role is exclusive to internal users. Contact support to make changes. {#schedule-optimization-properties__ul_lgt_tbh_5fc} |
| sn_schedule_optim.intraday_assignment_horizon_offset | Specifies the time offset (in minutes) added to the current time when calculating the window start for tasks that have no defined window start. * Type: Non-zero integer * Default value: 60 * Location: System Properties list \[sys_properties\] table {#schedule-optimization-properties__ul_ovw_k11_n3c} |
| sn_schedule_optim.intraday_max_retry_count | Specifies how many times the solution processor retries submitting an intraday optimization job. * Type: Integer * Default value:1 * Location: System Properties list \[sys_properties\] table {#schedule-optimization-properties__ul_blb_m11_n3c} |
| sn_schedule_optim.intraday_minimum_frequency | Defines how frequently intraday optimization runs. * Type: Non-zero integer * Default value (in minutes): 15 * Location: System Properties list \[sys_properties\] table {#schedule-optimization-properties__ul_i5d_m11_n3c} |
| sn_schedule_optim.intraday_policy | Specifies the default policy for intraday optimization. This can be overridden at the group level. * Type: String * Default value: None * Location: System Properties list \[sys_properties\] table {#schedule-optimization-properties__ul_ysh_m11_n3c} |
| sn_schedule_optim.intraday_qualifier_type | Specifies whether intraday optimization runs by assignment group or territory. * Type: Choice list * Default value: Assignment group * Location: System Properties list \[sys_properties\] table {#schedule-optimization-properties__ul_qhk_m11_n3c} |
| sn_schedule_optim.intraday_window | Defines the default schedule that controls when intraday optimization can run. * Type: String * Default value: None * Location: System Properties list \[sys_properties\] table {#schedule-optimization-properties__ul_r4m_m11_n3c} |
| sn_schedule_optim.max_agent_count | Limits the number of technicians considered during on‑demand and intraday optimization runs. * Type: Non-zero integer * Default value: 50000 * Location: System Properties list \[sys_properties\] table {#schedule-optimization-properties__ul_tr4_m11_n3c} |
| sn_schedule_optim.max_task_count | Limits the number of tasks considered during on‑demand and intraday optimization runs. * Type: Non-zero integer * Default value: 50000 * Location: System Properties list \[sys_properties\] table {#schedule-optimization-properties__ul_kcr_m11_n3c} |
| sn_schedule_optim.processing_time_per_task | Specifies the maximum processing time, in seconds, that the optimizer can use to compute a solution. * Type: Non-zero integer * Default value: 150 * Location: System Properties list \[sys_properties\] table {#schedule-optimization-properties__ul_gs5_m11_n3c} |
| sn_schedule_optim.run_summary_packet_size | Controls how many records are grouped when generating optimization run details. * Type: Non-zero integer * Default value: 10 * Location: System Properties list \[sys_properties\] table {#schedule-optimization-properties__ul_pqw_m11_n3c} |
| sn_schedule_optim.scheduled_state_count_of_task | The number of work order tasks that can be in a scheduled state before being assigned to a technician. * Type: Non-zero integer * Default value: 1 * Location: System Properties list \[sys_properties\] table {#schedule-optimization-properties__ul_b3y_m11_n3c} |
| sn_schedule_optim.schedule_optimization_qualifier_type | Specifies whether schedule optimization runs by assignment group or territory. * Type: String * Default value: Assignment group * Location: System Properties list \[sys_properties\] table {#schedule-optimization-properties__ul_t31_n11_n3c} |
| sn_schedule_optim.schedule_state_type | Determines how tasks are scheduled. The choices are duration or number of tasks. * Type: Choice list * Default value: Duration * Location: System Properties list \[sys_properties\] table {#schedule-optimization-properties__ul_bt2_n11_n3c} |
| sn_schedule_optim.scheduling_resolution_time | The number of seconds Schedule Optimization uses to round task start times, travel times, and end times. For example, a value of 60 rounds all start times, travel times, and end times to the nearest minute. A value of 300 rounds them to the nearest 5 minutes. * Type: Non-zero integer * Default value: 1 (second) * Location: System Properties list \[sys_properties\] table {#schedule-optimization-properties__ul_f5g_n11_n3c} |
| sn_schedule_optim.logging.verbosity | Sets the level of detail captured in Schedule Optimization logs for each run. The choices are info, debug, warn, and error. * Type: Choice list * Default value: Error * Location: System Properties list \[sys_properties\] table {#schedule-optimization-properties__ul_htg_mv1_n3c} Note: The 'maint' role is required to edit this property. This role is exclusive to internal users. Contact support to make changes. |
| sn_schedule_optim.so_max_solution_threshold | Maximum number of ML solutions that can run simultaneously. When workload distribution is enabled with multiple jobs or multiple optimization modes run concurrently, increase this value. * Type: Non-zero integer * Default value: 3 * Location: System Properties list \[sys_properties\] table {#schedule-optimization-properties__ul_x4q_2bs_m3c} Note: The 'maint' role is required to edit this property. This role is exclusive to internal users. Contact support to make changes. |
| sn_schedule_optim.enable_qualifier_split | Determines which optimization modes use split qualifiers to distribute workloads across parallel jobs. Choices: * None -- No distribution; all qualifiers processed in a single job. * Only Batch -- Distribute qualifiers only for batch optimization runs. * Only Intraday -- Distribute qualifiers only for intraday optimization runs. * Both -- Distribute qualifiers for both batch and intraday optimization runs. {#schedule-optimization-properties__ul_pml_vks_4hc} Note: Split qualifiers work with batch, intraday, and prioritized optimization but not on-demand optimization. * Type: choice * Default value:none * Location: System Properties list \[sys_properties\] table {#schedule-optimization-properties__ul_bv5_4ks_4hc} |
| sn_schedule_optim.qualifier_distribution_splits | Number of splits to distribute qualifiers across parallel optimization jobs for each batch or intraday configuration. Higher split counts reduce processing time per job but require more ML capacity. If running multiple optimization modes simultaneously adjust `sn_schedule_optim.so_max_solution_threshold` to accommodate the total number of concurrent ML solutions needed. * Type: Integer * Default value: 1 * Location: System Properties list \[sys_properties\] table {#schedule-optimization-properties__ul_jmd_jzs_4hc} Note: The 'maint' role is required to edit this property. This role is exclusive to internal users. Contact support to make changes. |
| sn_schedule_optim.maximum_matrix_size | Determines the maximum number of locations that can be queried to a third‑party map provider when computing travel estimates. * Type: Integer * Default value: 40000 * Location: System Properties list \[sys_properties\] table {#schedule-optimization-properties__ul_jkx_bv1_n3c} |
[Table 3. Schedule Optimization system properties for Field Service Management]

{#schedule-optimization-properties__table_hgt_tbh_5fc}

## Intraday-Prioritized {#schedule-optimization-properties__section_sxf_l3d_jkc}

The following is the list of intraday prioritized event properties that are available with the Schedule Optimization\[var.schedule-optimization\] plugin. These properties configure prioritized event buffering, event thresholds, and
limits on agents and tasks to optimize performance for time-sensitive scheduling changes. To access these properties, navigate to AllSchedule OptimizationAdministrationProperties.
{#schedule-optimization-properties__table_xhm_z3d_jkc__entry__2}

| Property | Description |
|-|-|
| Number of minutes to shift task window start to prevent scheduling in the past `sn_schedule_optim.prioritized_event_assignment_horizon_offset` | Adjusts task window timing for prioritized events by shifting the start time forward to prevent scheduling tasks that appear to be in the past. * Type: Non-zero integer (in minutes) * Default value: 1 minute {#schedule-optimization-properties__ul_npy_lkd_jkc} |
| Time (in seconds) to wait before initiating the optimization process for prioritized events `sn_schedule_optim.prioritized_optimization_delay_buffer` | Buffer window that allows the system to collect prioritized events before triggering optimization. * Type: Non-zero integer (in seconds 60-900) * Default value: 180 seconds (3 minutes) {#schedule-optimization-properties__ul_xzg_4kd_jkc} |
| Number of events to decide if prioritized optimization can be triggered `sn_schedule_optim.prioritized_min_event_count` | Minimum number of prioritized events required before triggering optimization. * Type: Non-zero integer * Default value: 5 {#schedule-optimization-properties__ul_qqm_wkd_jkc} |
| Maximum number of agents to be considered for prioritized event optimization `sn_schedule_optim.prioritized_event_max_agent_count` | Limits the number of technicians sent to the optimization engine for each prioritized event. If exceeded, the job will not run and no assignments will be received. * Type: Non-zero integer * Default value: 20 {#schedule-optimization-properties__ul_uxh_1kd_jkc} |
| Maximum number of tasks to be considered for prioritized event optimization`sn_schedule_optim.prioritized_event_max_task_count` | Limits the number of tasks sent to the optimization engine for each prioritized event. If exceeded, the job will not run and no assignments will be received. * Type: Non-zero integer * Default value: 100 {#schedule-optimization-properties__ul_gj4_2kd_jkc} |
[ ]

{#schedule-optimization-properties__table_xhm_z3d_jkc}

## Performance-related Schedule Optimization properties {#schedule-optimization-properties__section_gny_btj_21c}

The following is the list of solution processing properties that are available with the Schedule Optimization plugin. To access these properties, navigate to AllSystem PropertiesAll Properties.{#schedule-optimization-properties__table_iqs_ntj_21c__entry__2}

| Property | Description |
|-|-|
| sn_schedule_optim.solution_processor_packet_size | Packet size to group events for solution processing (task updates). Sets the packet size for grouping events in solution processing, defining the capacity of each custom queue. It aims to distribute solution processing as widely as possible across the available custom queues specified in sn_schedule_optim.solution_processor_number_of_queues." * Type: Integer * Default value: 10 {#schedule-optimization-properties__ul_mbq_mgl_12c} |
| sn_schedule_optim.map_vendor_call_types | Controls whether a synchronous or asynchronous call type is made to the map vendor. Changing the default value of sync to async can improve performance and may result in more outbound requests. * Type: String * Default value: "beans": "sync" {#schedule-optimization-properties__ul_izg_1p3_qbc} |
| sn_fsm_map_integr.logging.verbosity | Captures additional logs for troubleshooting purposes. It is used for integration calls to map providers such as Beans.ai or Google, providing detailed insights to help diagnose and resolve issues. * Type: Choice * Default value: info {#schedule-optimization-properties__ul_i3f_pwl_pdc} |
| sn_schedule_optim.qualifier_data_agent_entity_split | Indicates how many sets of agents will be processed simultaneously in an optimization run, improving performance. * Type: Non-zero integer * Default value: 2 {#schedule-optimization-properties__ul_gjs_lbh_5fc} |
[Table 4. Schedule Optimization solution processing properties]

{#schedule-optimization-properties__table_iqs_ntj_21c}  
Note:  
The 'maint' role is required to edit any performance-related properties. This role is exclusive to internal users. Contact support to make changes.

The following is the list of queue registry properties that are available with the Schedule Optimization plugin. These properties configure parallel event and data processing queues to optimize performance for simulation and optimization runs. To access these properties, navigate to AllSystem PoliciesQueue Registry.  
{#schedule-optimization-properties__table_a5n_g51_3kc__entry__2}

| Property | Description |
|-|-|
| sn_schedule_optim.data_queue | Queue registry for Schedule Optimization data processing (GraphQL qualifier response). * Job Configuration Type: Scale with node * Default Value: 3 {#schedule-optimization-properties__ul_m2y_hx1_3kc} |
| sn_schedule_optim.event_queue | Queue registry for Schedule Optimization solution (event) processing. * Job Configuration Type: Scale with node * Default Value: 3 {#schedule-optimization-properties__ul_xfk_mx1_3kc} |
| sn_schedule_optim.event_attr_queue | Queue registry for Schedule Optimization break (event attribute) processing. * Job Configuration Type: Scale with node * Default Value: 3 {#schedule-optimization-properties__ul_xbn_mx1_3kc} |
[Table 5. Schedule Optimization Queue Registries]

{#schedule-optimization-properties__table_a5n_g51_3kc}

## Predictive Intelligence system properties used with Schedule Optimization {#schedule-optimization-properties__section_ajz_yk4_pkc}

The following system properties are available with the Predictive Intelligence plugin. To access these properties, navigate to AllSystem PropertiesAll Properties.
{#schedule-optimization-properties__simpletable_ihd_dl4_pkc__entry__2}

| Property | Description |
|-|-|
| glide.platform_ml.training.retry.limit | Controls how many times the optimization engine will retry if the machine learning service fails. Set to `0` to disable retries and prevent unexpected work reassignment. * Type: integer * Default value: set to 0 {#schedule-optimization-properties__ul_uwl_rl4_pkc} |
[Table 6. Predictive Intelligence properties]

{#schedule-optimization-properties__simpletable_ihd_dl4_pkc}
**Related concepts**   

* [Configuring Schedule Optimization](https://www.servicenow.com/docs/exLesNSFhvQN507LuH75eA "Use Schedule Optimization to automate task assignment, create efficient schedules, and respond to changing conditions as they occur throughout the day.")
* [Optimizing technician schedules at set intervals](https://www.servicenow.com/docs/FC2DKKmotYsmfsnhKm_93A "Efficiently reassign tasks and maximize productivity by continuously running schedule optimization at selected intervals throughout the day.")
* [Configuring log levels for detailed optimization analysis](https://www.servicenow.com/docs/MIaLyuoPnRRWYi8mRp8How "Schedule Optimization logs provide detailed information about each run, allowing you to gather specific information as needed.")

*[\>]: and then