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 send one dispatch at a time, or dispatch a form to multiple devices at once, as explained below.

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://app.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.

If you'd like to queue the dispatches immediately, click Dispatch to devices when Send Now is enabled.

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.

View your uploading dispatches in the "Processing" tab where the file will be queued and show a 'Progress" bar. You also have the options to "Remove" or "Retry" the file using the settings icon to the right.
​

Not seeing this feature? For more information on enabling recurring scheduled dispatches for your organization, please contact support@devicemagic.com.

Schedule all dispatches for a specified date and time by selecting Schedule Dispatch.

Note, when Scheduled Dispatch is enabled, any Schedule at values specified in your uploaded XLSX or CSV will be overwritten.

When scheduling future dispatches, clicking the answer box will prompt a date and time picker to appear. Clicking Now will populate a value with the current date and time.

If you'd like these dispatches to occur on a recurring basis, enter a Repeat Every value.

You can also enter a Name and Description for the recurring scheduled dispatch when a Repeat Every value exists.

After, click Dispatch to devices.

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.

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: 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.

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.

When using this method, ensure you enable Send Now prior to clicking Dispatch to devices to ensure these file values are not overwritten.

Please note the following:

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