Let’s say that a company needs to send a technician out to a particular customer who has specific once-off work that needs to be done. The company can design a job-specific form to be sent to the technician’s mobile device. The technician can then capture the job-related data and submit the form once it's completed. The form itself will then disappear from the technician’s mobile device. Since this particular form will never be used again, this is a perfect way to keep the forms list on the mobile device concise and ordered.

Basically, this multi-device dispatch feature – which is the front end of the Push API – allows a pre-populated form to be sent to a specific device for a one-time job. Once the form is submitted, it is removed from the device.

You can access the Dispatch page via the button at the top of your organization page, or by typing “/dispatches” at the end of your account organization link.

For example: https://www.devicemagic.com/organizations/10/dispatches

Click on “Multiple Devices”.

Then, select the form you would like to dispatch. This will start a wizard that begins by asking for an Excel file containing which of the data you want dispatched to which of the available devices.

Once you’ve uploaded your Excel document (Stage 1) you will then be taken to Stage 2 where you can match up the columns in your Excel document with the question fields in your form.

More details on the "Lat/Long" and "Schedule at" options later on in this article.

Click the "Next: Preview dispatch data" button when ready.

Now you're able to preview and edit the forms. Click the blue "+" to open a dispatch to view the data and the blue "-" to minimize the dispatch.

Once you click on the “Dispatch to devices” button, you will see the dispatches start to process.

Then you will be taken to a page that shows your Dispatch Status. This will include a progress bar, number of processed dispatches and the estimated time remaining. Please keep this tab open until it is 100% complete. 

Once all your dispatches have been processed, you will be taken to a page that states your forms have been dispatched successfully, along with a record of what has been dispatched to each device, and an option to send another dispatch.

Excel Document Format

In the Excel document, there are four columns that are automatically filled in by Device Magic, based on the information provided by your organization. These columns identify the device name and associated device identifier that will receive the form, the form name and the description of the form.

You may edit the Excel document to include any other information you'd like to include in the dispatch.

Attach a Location to a Dispatch (Lat/Long)

It is also possible to associate a location with a dispatch. You may edit the "Lat/Long" column in the Excel spreadsheet to include coordinates. 

Note the format: 35.7773706, -78.6409542 

Note: This feature is only currently supported on iOS. If you are interested in this feature, please reach out to support@devicemagic.com to enable this for you. 

For more information on how this feature will look on the mobile device, click here.

Scheduling a Dispatch

In the Excel or CSV file associated with the form, you'll notice the column "Schedule at". By leaving the cell value blank in a row, the associated dispatch will be sent immediately after uploading the file and confirming the dispatches to be sent. If you'd like to schedule a dispatch to be sent at a future date, please use YYYY-MM-DDThh:mm:ss  format.

Other Useful Articles:

If you have any questions regarding this or would like further assistance, please contact our support team at support@devicemagic.com.

Did this answer your question?