Dispatch Rules

Matisse van Rossum
Matisse van Rossum
  • Updated

In ServiceForms, Dispatch Rules are the part of the form that determine under what circumstances it is sent to a technician when they clock into a job. This article gives a brief overview of how Dispatch Rules work.Your Project Manager will help you set up Dispatch Rules for each of your forms during onboarding and implementation, so you may not even need to change anything once they are set. 


Dispatch Rules are set up in the ServiceForms Connector, the middleware integration between Device Magic and the ServiceTrade web application. Admin users of ServiceTrade can access the ServiceForms Connector at serviceforms.servicetrade.com. To edit a form’s Dispatch Rule, select the form from the list after logging in, and click the rule under “Dispatch to:.”


Forms can be set to dispatch based on:

  • Customer
  • Region
  • Offices
  • Job Types
  • Service Lines
  • Service Description
  • State
  • City
  • Asset Type
  • Service Frequency
  • Service Interval

If a Job meets the criteria of a form’s Dispatch Rule, that form will be dispatched to the technician’s mobile device when they clock-in to the Job on the ServiceTrade mobile application. 

So if, for example, on every fire extinguisher inspection job, you need technicians to fill out a specific inspection form, you could set up a Dispatch Rule for:

  • Job Types: Inspection
  • Service Lines: Portable Extinguisher


You will notice that if these fields are not given a specific input, they will default to “All.”


Note: In order for a form to dispatch, the Job in ServiceTrade must meet ALL of the criteria established by the Dispatch Rule.


If you have a form that only applies to very specific scenarios, you may want to add a unique Service Description in the Dispatch Rule that must be included on the service in ServiceTrade. 


This form would only dispatch for jobs where at least one service had “Dispatch testing” in its description.

Finally, the Dispatch Rule can be set to automatically pre-populate the form with assets from ServiceTrade. You have the option to either load only assets related to the services being performed on the appointment, or load all assets at the appointment’s location, depending on your workflow. 


At the bottom of the Dispatch Rule page is the Dispatch Mapping, the code that controls what information from ServiceTrade is pre-loaded into the dispatched form. DO NOT EDIT OR DELETE THIS SECTION


For information on testing Dispatch Rules, see this article.

If you would like to change what info is pre-loaded into a form, contact your ServiceForms Project Manager, or reach out to the ServiceForms team at serviceforms@servicetrade.com.

Was this article helpful?