Pre-Calculation Overview
The pre-calculation flow starts whenever a work order is created or updated. Pre-calculation logic works when GBL007 Enable Dispatch Optimization Under (Module: Common and Submodule: Global Setting) is set to True.This flow is part of the Work Order Trigger.
The following check is performed:
Is the Locked By DC field in the work order blank?
If any of the above is true, the following field values in the work order are updated:
Work Order Field
How is it Updated?
Notes
Primary Territory
If Territory Match Rules and Territory Coverage are defined in the corresponding territory, the Primary Territory is populated on the work order if it meets the criteria defined at the Territory Match Rule level.
If more than one territory match rule’s entry criteria match a work order’s field values, the first territory match rule in the rule sequence is selected.
If a matching territory is not found, the work order is populated with PrimaryTerritory. Optimax error text This work order does not match the entry criteria for anydispatch process, or the matching dispatch process is deactivated is stamped onthe work order. For more information, see Configuring Territory Match Rules.
Territory is updated only if the Locked By DC field in the work order is blank.
It is necessary to remove the current populated dispatch process when a work order qualifies for another Territory match rule. Only then the new dispatch process and related Territory is populated on the WO.
Dispatch Process
The dispatch process for the work order is determined by matching work order field values with the corresponding dispatch process entry criteria and the primary territory populated on the work order.
If a work order is updated to qualify for any other dispatch process, the dispatch process field must be cleared while editing the work order to populate it with the latest dispatch process.
Dispatch Priority
Dispatch Priority is calculated based on work order field values matching any of the Dispatch Priority Rules defined in the corresponding dispatch process stamped on the work order.
Prioritization rule values defined at P1, P2, P3, or P4 can be defined at setting SET033, SET034, SET035, AND SET036 under Module: Optimax and Submodule: Dispatch Calculations.
If you want to define P3 rule directly, it is mandatory to define all the previous rules in the page such as P1 and P2 rules.
If the work order does not match any of the priority rules, dispatch priority is set to the default value of 1, which is the configuration setting Default Dispatch Priority.
Service Duration
Service Duration (In seconds) is calculated based on the MTTS rule criteria for which the work order qualifies.
Setting SET002 - Enable MTTS calculationUnder Module: Work Order and Submodule: Manage MTTS Rule must be set to True. For more information, see Configuring MTTS Rules.
If the work order does not match any MTTS rule, Service Duration is populated from the setting SET004 – Default Service Duration under Module: Optimax Submodule: Dispatch calculation.
When the work order is edited again to qualify for another MTTS rule, it is not necessary to remove the existing Service Duration. After saving the work order, the new Service Duration is updated automatically.
Skill
Skills Required are calculated based on work order field values matching any of the Skill Matching Rules.
Setting SET056 — Skill set calculation for work orders under Module: Optimax Submodule: Dispatch Calculations must be set to True. For more information, see Configuring Skill Match Rules.
If more than one skill matching rule matches a work order’s field values, the first skill rule in the rule sequence is selected.
Skill is updated only if the Locked By DC field in the work order is blank.
The value is stored in a JSON string in the skill set field.
Eligibility Requirements
Eligibility Requirements are calculated based on the Eligibility rules defined.
If more than one eligibility matching rule matches a work order’s field values, the first eligibility rule in the rule sequence is selected.
Preferred Technician
When a work order is linked to an Account with a Preferred Technician, the Preferred Technician field can be populated.
There is a higher chance that a work order is assigned to the preferred technician, provided that all other constraints, such as capacity and cost factors defined in the corresponding dispatch process, are met.
Qualified Technicians
Qualified Technicians are calculated based on the eligibility criteria for Technicians that the work order qualifies.
Qualified Technicians is a JSON string, and is stored in Qualified Technicians field on the work order.
Setting SET058 — Enable Technician Eligibility Rules Under Module: Optimax Submodule: Dispatch Calculation is set to True. For more information, see Configuring Technician Eligibility Rules.
When the work order is edited again to qualify for another Technician Eligibility Rule, it is necessary to remove the existing Qualified Technician list. After saving the work order, the new Qualified Technician list is updated automatically.
This is only updated when the work order matches any of the defined Technician Eligibility Rules.
Preferred Business Hours
With Preferred Business Hours, if a Booking Window is not applicable and the SLA Terms field is not null, this is set to the matching SLA timestamp’s business hour.
The matching SLA timestamp depends on the configuration setting SLA Timestamp for Work Order Scheduling.
Whether the timestamp is applicable for a given work order depends on the work order’s priority and order type matching one of the defined records for that timestamp.
Or else, if the SLA Terms field is null, this is set to the access hours from the component or account in that order, if they are not null.
Preferred Start and End Time
With Preferred Start and End Time, if the booking window is applicable to the work order’s case, then those values are taken.
Or, if an SLA is applicable, then set the Preferred Start Time equal to System.now(), and the Preferred End Time equal to the SLA Timestamp field value, based on the configuration setting, whose default is Onsite Response Customer By.
If either is not available, the manually entered value in the work order is persisted.
Resource Preference
Work order is linked to Company, Site, and Component. It fetches all the Resource Preferences for all the work orders and populate the list in the work order related section.
Setting SET051 — Enable Technician Eligibility Rules Under Module: Optimax Submodule: Dispatch Calculation is set to True. For more information, see ResourcePreferenceManagement.
With all these field updates, the work order is ready to be consumed by the Schedule Optimization engine.
Was this helpful?