Properties installed with Field Service Management
System properties provided with the Field Service Management application.
| Property | Description |
|---|---|
| glide.ui.wm_order_activity.fields | Determines which fields are tracked in the activities list for work orders. The system automatically synchronizes the values in this property and the selections made by customizing activities.
|
| glide.ui.wm_task_activity.fields | Determines which fields are tracked in the activities list for work order tasks. The system automatically synchronizes the values in this property and the selections made by customizing activities.
|
| work.management.agent.geo.history.update.duration | Set the duration (in minutes) of the latest system update that you want to consider for calculating the agent's geolocation history relative to current time. If the duration of the last
geolocation history update is more than the duration set for this property, the system uses the agent's task or home location instead of the geolocation history to determine the agent's
current location.
|
| work.management.allow.doublebooking.dynamicscheduling | When set to true, dispatchers can double-book agents manually even when dynamic scheduling is enabled.
|
| work.management.allow.auto.metric_cleanup | The frequency in number of days that the metric instance table should be purged of work order task information to avoid an unnecessary amount of data in the table.
|
| work.management.default.end.time | Default end time for all work agents when no schedule is set, formatted in a 24-hour clock.
|
| sn_fsm.set_schedule_lock_by_state | Determines the state to lock work order task and also prevents from reassignment. For example, you can set the work order tasks to automatically get locked when the state is
Assigned and further excludes in automated scheduling mechanisms such as dynamic scheduling, intelligent task recommendations.
|
| sn_fsm.update_potential_assignment_groups | Calculates and automatically populates the potential assignment groups. Updates the wm_work_order_task_potential_assignment_groups table with potential assignment
groups for the work order task.
注: The wm_work_order_task_potential_assignment_groups table is populated only when:
|
| work.management.default.start.time | Default start time for all work agents when no schedule is set. This value sets the start time for a day other than the current day, when no scheduled task exists or
is continued from the previous day. This property uses a 24-hour clock.
|
| work.management.allow.auto.timecard | Automatically create a time card for a work order task when the task is . Every time the task is resumed, the time taken to work on the task is recorded in the time card. The
Actual Work Duration field captures the cumulative amount of time worked on the task.
|
| work.management.allow.travel.task.timecard | Enables recording the amount of time an agent spent to execute a work order task. The time card is generated when an agent clicks Start work.
|
| work.management.limit.location | By default, the list of available dispatch groups is filtered by their proximity to the work order task location. When this property is set to false, the system displays all dispatch
groups for selection without considering location.
|
| work.management.max.agents.processed | Sets the maximum number of agents processed by auto-dispatch at a time. The system has an absolute limit of 300 agents and sets the value at that level. If you specify more than 300,
then the system can’t auto-dispatch a task for a dispatch group that contains more agents than the value configured.
|
| work.management.work.spacing | 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.
|
| com.snc.wm.wo.task_window_days | Default days for a window of a task.
|
| work.management.use.mandatory.skills | Enables the mandatory skills feature and indicates that the Task Skills [task_m2m_skill] table is being used for work orders and work order tasks.
|
| work.management.rejected.technician.duration | The number of hours after which a work order task can be dynamically scheduled to the agent who rejected the work order task.
|
| skills_management.migration | Lists the task tables to migrate to the Task Skills [task_m2m_skill] table when an admin runs the Migrate Skills to Task Skill M2M script.
|
| com.snc.skills_management.task_skill_migrated_tables | Contains a list of tables for which the Skills field has already been migrated to the Task Skills [task_m2m_skill] table. If the table name is listed in this
property, the data has been migrated and will not be migrated again.
|
| work.management.assignment.ignoreTravelTimeCalculation | When set to true, ignores the travel calculation check for field service agents.
|
| sn_fsm_service_loc.max_new_location_per_day | Sets the maximum number of new locations allowed per day for external users.
|
| sn_fsm_crew.work.management.allow.undersized.crew.taskassignment | Enables dispatchers to assign task to a crew manually even when the crew size doesn’t meet the minimum required agents criterion.
|
| work.management.optimization.conflict_handling | Manages the assignment of tasks scheduled outside the agent working hours when optimizing the task route for agent. Choose any of the following route optimization behaviour to avoid
conflicts that may occur due to the overflow tasks:
|
| sn_fsm_crew.default.duration.in.days.of.crew.member | Sets the default number of days that an agent is part of a crew.
|
| sn_task_grouping.log.verbosity | Logs the details of Dynamic Bundling. Registers information such as how many tasks were bundled, bundle task numbers, subtask numbers, policies, rules, and qualifiers used to created bundles.
|
| work.management.default.scheduled.start | Default scheduled start date added to work order task. If value set to false, then the scheduled start won't populate until tasks enter the scheduled state. If the value is set to true,
then the schedule start will populate when tasks enter the pending dispatch state.
|
| sn_fsm.wm_weekly_resource_span | Turns table denormalization for Field Service Management on or off.
警告: Only system administrators should update this value. |
| sn_fsm.wm_weekly_resource_span.number_of_ weeks_in_past | The number of weeks in past that the denormalized table stores data. If you navigate past the default weeks in the past data is still available but isn’t retrieved from the denormalized
table. You can store a total of 20 weeks worth of data in the flat table. This must include one week for the current week, and then the sum of past and future weeks together can’t exceed 19 weeks.
警告: Only system administrators should update this value. |
| sn_fsm.wm_weekly_resource_span.number_of_weeks_in future | The number of weeks in the future that the denormalized table stores data. If you navigate past the default weeks in the future data is still available but isn’t retrieved from the
denormalized table. You can store a total of 20 weeks worth of data in the flat table. This must include one week for the current week, and then the sum of past and future weeks together can’t exceed 19 weeks.
|
| Enable/Disable Onsite Check-in for Agents | Enables a substate on tasks to reflect when technicians arrive at locations.
If enabled, you can set a value for any work order task. |
| sn_schedule_optim.schedule_state_type | Enables admin to adjust the drip feed requirements based on the number of tasks or the duration of the tasks.
|
| sn_schedule_optim.scheduled_state_count_of_task | Enables admin to control how many tasks are assigned to a technician at any given time.
|
| google.maps.map_id | Enables Field Service Management to use the map ID for Google Maps used for cloud-based maps styling, vector map, advanced markers. You must obtain your own map ID, to do so visit https://developers.google.com/maps/documentation/javascript/map-ids/get-map-id. 重要: You must add FSM_Map as the value to use advanced markers.
|
Properties for calculating estimated travel time and distance
| Property | Description |
|---|---|
| work.management.autodispatch.geolocation | Requires geolocation to be used to calculate the estimated travel time for dynamic scheduling and auto assignment of tasks.
注: To use the Google Maps API with dynamic scheduling, you must also enable the Use Google for travel time and traffic data check box on the Dynamic Scheduling Configuration form. |
| work.management.travel.calculation.dynamic_scheduling | Uses the Google Maps API or straight-line estimates to calculate estimated agent travel time and distance to task locations when agents are assigned tasks using
dynamic scheduling.
|
| work.management.travel.calculation.auto_assignment | Uses the Google Maps API or straight-line estimates to calculate estimated agent travel time and distance to task locations when agents are assigned tasks using auto assignment.
|
| work.management.travel.calculation.manual_assignment | Uses the Google Maps API, Beans.AI, or straight-line estimates to calculate estimated agent travel time and distance to task locations when tasks are manually assigned to agents.
注: Map providers operate on a bring your own license (BYOL) licensing model.
|
| work.management.travel.calculation.route_optimization | Uses the Google Maps API, Beans.AI, or straight-line estimates to calculate estimated agent travel time and distance to task locations when agent route is optimized. 注: Map providers
operate on a bring your own license (BYOL) licensing model.
|
| work.management.travel.calculation.bundle_route_optimization | Enables Route Optimization to optimize the subtasks within work order task bundles.
|
| work.management.travel.calculation.expected_arrival | Uses the Google Maps API or straight-line estimates to calculate estimated agent travel time and distance between the task location and the agent's location when agent starts to travel.
If an agent leaves before or after the Scheduled travel start time, then the Scheduled travel start, Scheduled start, Estimated end, and Estimated travel duration values for the task are updated.
注: Select Use Google API real time traffic as the default value to calculate the agent's estimated time of arrival using the real-time traffic
data. |
|
work.management.travel.calculation.schedule_assistant |
Uses the Google Maps API, Beans.AI, or straight-line estimates to calculate estimated agent travel time and distance to task locations for assignment assistance calculation.
|
| use_default_duration | The create work order task form displays two fields, Estimated travel duration and Estimated work duration. For both the fields, the
default duration is one hour, which is defined at the schema level, but the values can be changed manually in the form. If the property value is set to false, the
work order task records the values overridden by the user in these fields. However, if the property value is set to true, these two fields retain their default
values even if the user overrides them.
|
Part sourcing properties
| Property | Description |
|---|---|
| Part Search Criteria | Sets the criteria to search parts. The stockrooms that contains the parts with the requested quantity appear per the selected search criteria.
|
| Use part request approvals | Enables sending and receiving mobile notifications as field service agents request parts from peer agents.
|
| Create part requests for part requirement sourcing | Creates a part request when a part is added to the part requirement.
|
Geolocation properties
| Property | Description |
|---|---|
| work.management.map.merge.task.agent.markers | Merges task and agent markers on geolocation maps with a new purple marker. When this property is true, agent and task markers that are close together are merged into a purple cluster
that displays the count of both marker types. The pop-up information window for the purple marker displays the items for all agents and tasks. If this property is false, agents and tasks
will only be gathered into their own clusters and not into the single, purple cluster.
|
| work.management.evening.rush.hours | Evening rush hour span, formatted as 14:30-16:00. This property uses a 24 hour clock. All times are expressed as a range, separated by a dash with no spaces. Times not using this format
are ignored. This property must be used with the work.management.morning.rush.hours and work.management.rush.travel.buffer properties.
|
| work.management.morning.rush.hours | Morning rush hour span, formatted as 06:30-08:00. This property uses a 24 hour clock. All times are expressed as a range, separated by a dash with no spaces. Times not using this format
are ignored. This property must be used with the work.management.evening.rush.hours and work.management.rush.travel.buffer properties.
|
| work.management.rush.travel.buffer | Percentage to add to all rush hour travel times. The system uses this percentage to calculate schedules when optimizing task routes for agents. Use this property when both morning and
evening rush hour times are defined. An example of a valid time buffer percentage is 15.
|
| work.management.travel.buffer | Percentage to add to all travel times. An example of a valid percentage value is 15.
|
| work.management.allow.toll.roads | Allows the system to use toll roads when auto-routing or optimizing task routes for agents.
|
Dynamic Scheduling properties
| Property | Description |
|---|---|
| work.management.allow.doublebooking.dynamicscheduling | Enables dispatchers to double-book agents manually even when dynamic scheduling is enabled.
|
| com.snc.dynamic.scheduling.ignoreAgentTravelTimeDuringScheduling | When this property is set to true, the agent's assigned tasks using dynamic scheduling no longer have an estimated travel time calculated.
|
| work.management.travel.calculation.dynamic_scheduling | Uses the Google Maps API or straight-line estimates to calculate estimated agent travel time and distance to task locations when agents are assigned tasks using
dynamic scheduling.
|
| com.snc.dynamic.scheduling.optimize_travel_time_rating | Used to provide a more precise optimization rating for each work block for agents. Property includes work.management.morning.rush.hours and work.management.rush.travel.buffer.
|
| work.management.distance.calculation.dynamic_scheduling | Uses Google Maps API or straight line estimates to calculate estimated distance to task locations when agents are assigned tasks using dynamic scheduling.
|
| com.snc.dynamic.scheduling.showlogs | Enable this property to display recommended eligible agents to the dispatchers while scheduling the tasks using dynamic scheduling.
|
| com.snc.dynamic.scheduling.bundle_before_scheduling | Ensures dynamic bundling runs before dynamic scheduling. Tasks in the Pending Dispatch state are bundled before running dynamic scheduling.
|
| sn_fsm_multiday.minDurationForFirstWorkSchedule | Set minimum work duration to be booked for the first work schedule of the task (in minutes).
|
| work.management.enable.optimizing.travel | Enables dynamic scheduling to reassign work order tasks to the nearest agent regardless of availability.
|
| work.management.travel.time.threshold.minutes | Sets the travel time (in minutes) that assigns a work order task to the nearest agent if they are within the travel distance.
|
Dispatcher Workspace properties
| Property | Description |
|---|---|
|
sn_fsm_disp_wrkspc.dispatcher_workspace.agent_metrics_setting |
Enable agent metrics settings.
|
|
sn_fsm_disp_wrkspc.dispatcher_workspace.autorefresh |
Enable auto-refresh.
|
|
sn_fsm_disp_wrkspc.dispatcher_workspace.calendarDisplayDays |
Default number of days dispatcher can view on calendar.
|
|
sn_fsm_disp_wrkspc.dispatcher_workspace.calendar_resources_page_size |
Minimum number of resources to load on dispatcher workspace calendar. The value must be between 1 and 30.
|
|
sn_fsm_disp_wrkspc.dispatcher_workspace.cluster_label |
Set the label on marker clusters (marker for number of markers, item for total number of items).
|
|
sn_fsm_disp_wrkspc.dispatcher_workspace.cluster_zoom_level |
Set maximum auto zoom level for marker clustering. Valid values are 1 to 20.
|
|
sn_fsm_disp_wrkspc.dispatcher_workspace.dateTimeField |
Select the date/time property to use for calendar navigation to task assignment window.
|
|
sn_fsm_disp_wrkspc.dispatcher_workspace.enable_straight_line_location_history_route |
Enable simple straight line for drawing agent location history routes.
|
|
sn_fsm_disp_wrkspc.dispatcher_workspace.enable_straight_line_route |
Enable simple straight line for drawing routes.
|
|
sn_fsm_disp_wrkspc.dispatcher_workspace.event_hover_popover |
Enable on event hover popover on the dispatcher workspace.
|
|
sn_fsm_disp_wrkspc.dispatcher_workspace.firstDayOfWeek |
Default first day of the week.
|
|
sn_fsm_disp_wrkspc.dispatcher_workspace.group_metrics_setting |
Enable group metrics setting
|
|
sn_fsm_disp_wrkspc.dispatcher_workspace.hideOffShiftAgents |
Enable hiding off shift agents
|
|
sn_fsm_disp_wrkspc.dispatcher_workspace.hideOffShiftAgents |
Enable hiding off shift agents
|
|
sn_fsm_disp_wrkspc.dispatcher_workspace.hide_map |
Hide Map.
|
|
sn_fsm_disp_wrkspc.dispatcher_workspace.scheduled_travel_start_as_scheduled_start |
Schedule based on travel start time
|
|
sn_fsm_disp_wrkspc.dispatcher_workspace.showIconOnCalendarEvent |
Enable icon display on calendar event
|
|
sn_fsm_disp_wrkspc.dispatcher_workspace.taskDateFieldToCalendarSync |
Enable navigation to task assignment window.
|
|
sn_fsm_disp_wrkspc.dispatcher_workspace.task_panel_page_size |
Default page size of task panel on dispatcher workspace
|
|
sn_fsm_disp_wrkspc.dispatcher_workspace.use_task_assignment_modal |
Enable task assignment modal.
|
|
sn_fsm_disp_wrkspc.display_map_on_assignment_confirmation |
Displays the map on task assignment confirmation in Dispatcher Workspace
|
|
sn_fsm_disp_wrkspc.enable_optimize_route |
Enable dispatcher workspace optimize route
|
|
sn_fsm_disp_wrkspc.sn_fsm.dispatch_ws_map.initial_zoom_level |
Initial zoom level.
|
|
sn_fsm_disp_wrkspc.sn_fsm.dispatch_ws_map.map_style |
Apply a preferred style to light mode map.
|
|
sn_fsm_disp_wrkspc.sn_fsm.dispatch_ws_map.map_style_dark |
Apply a preferred style to dark mode map.
|
|
sn_fsm_disp_wrkspc.sn_fsm.dispatch_ws_map.map_type |
Select the map type to view locations
|
|
sn_fsm_disp_wrkspc.sn_fsm.dispatch_ws_map.maximum_auto_zoom_level |
Set maximum auto zoom level. Valid values are 1 to 20.
|
|
sn_fsm_disp_wrkspc.sn_fsm.dispatch_ws_map.route_enabled |
Enable display of agent routes on the map.
|
|
sn_fsm_disp_wrkspc.sn_fsm.dispatch_ws_map.route_type |
Select map route type.
|
|
sn_fsm_disp_wrkspc.sn_fsm.dispatch_ws_map.street_view_enabled |
Use street view on the map or use panoramas directly within the map
|
|
sn_fsm_disp_wrkspc.use_overlapping_territory_modal_for_opt |
Use overlapping territory modal for optimization.
|
|
sn_fsm.show_paginated_taskPanel_markers |
This toggle is to only show the paginated task panel task markers. Instead of displaying all the task panel task markers on the map. 警告: Setting this value to false will load all task markers at once which may cause performance issues.
|
|
sn_fsm_disp_wrkspc.dispatcher_workspace.task_panel_sla_timer |
Enable the SLA timer shown within the Work order task cards inside the Task Panel of Dispatcher Workspace.
|
| sn_fsm_disp_wrkspc.dispatcher_workspace.task_panel_sla_timer_type | Enable the SLA timer on work order task cards to update in real-time (Live) or update once on the initial Dispatcher Workspace load (NonLive).
|
| sn_fsm_disp_wrkspc.dispatcher_workspace.show_advanced_resource_filter | Property that controls the advanced resource filter in Dispatcher Workspace. When enabled dispatchers can use the advanced resource filter to create and save their own advanced filters. Administrators can setup advanced
filters for all dispatchers to use. 重要: The advanced resource filter is only available for filtering agents and crews. If you currently use contractors or equipment, continue to use the default filter shown in the contextual side panel.
|
| sn_fsm_disp_wrkspc.enableEmptyState | Property that controls if an empty state loads when Dispatcher Workspace opens. If true Dispatcher Workspace opens without Assignment Groups or Territories loaded until the dispatcher saves defaults.
|
|
work.management.task_state_color.use_hex |
Enable administrators to use hex colors to update the colors on work order tasks in Dispatcher Workspace. The default value, false, doesn't allow for updating task state colors.
|
|
work.management.enable.resource.time.indicator |
Controls time zone display for work order task. When set to "true", date time fields show on record page forms, task assignment confirmation forms and the time indicator in Dispatcher Workspace is segmented and corresponds with the technician's time zone.
|
Database View
The Field Service Mobile plugin (com.sn_fsm_mobile) adds the Mobile live location database view. The Field Service Mobile plugin is activated when you activate the Field Service Management (com.snc.work_management) plugin.
| Database view | Description |
|---|---|
| Mobile live location [sn_fsm_mobile_live_location_view] |
Mobile live location of Field Service agents. |