Dispatch as a Destination allows a form to be sent to any number of users once another form has been submitted. For example, you could have a vehicle inspection report which, after being submitted on one device, gets routed to a manager's device for approval.

Below are instructions to guide you through the process of setting up the Dispatch Transport:

Go to your "Forms" page and click the link in the destinations column of the form you would like to add the destination to. (the one that has to be submitted before the other form is dispatched).

Note: If there are no Destinations added to your account, this button will read "0".

You'll then be brought to the Destinations page, where you can click "New Destination".

A new page will load, and on it you will see different Destinations to send your data. Click on "Dispatch". Then, you will be asked to choose a format for your form data. Select "XML".

At this point, the "Dispatch options" will appear. Here, you will choose the form you want to dispatch to the device. You will also select the devices to which you want to send the form (you can select multiple devices from the drop-down menu).

Below that, there are fields that ask for you to fill in the name of the form as well as a description (both of which can be customized using the placeholders provided). These are optional.

The next set of fields are the form fields that can be preset, so they're filled in automatically once the form has arrived on the device. You can also use placeholders in these fields to determine what you want these fields to say.

For example, you can specify that "Date" is determined by the previous forms date, represented by the "#{{fields.Date}}" placeholder. Please note, at this time we're unable to transfer repeat group entries from the submitted form to the Dispatch Transport destination .

You can fill out any of the form fields, but remember to leave blank the ones you want the user to fill out.

When you're done, click "Create Destination".

Next, if you look at the device to which the Dispatch Transport has been assigned, you will see the initial form when you open Forms (once the forms list has synced).

Fill out this form, and submit it.

Once the form has been submitted, it will be uploaded to the server where it will be processed. After the submission has finished processing, the form you selected will be dispatched to the selected devices. Refresh the forms lists on these devices, and you should see that the dispatched form has arrived.

Open it, and you will see that certain fields have already been filled in.

Those that have not are ready to be completed by the user.

Lastly, you can submit your form, which will then be sent to any destinations linked to the Customer Feedback Form.

Advanced Usage:

It is possible to use placeholders to select which device to dispatch the form to.

Using placeholders you can dynamically dispatch the form. Using #{{device_id}} for example will dispatch the form to the device that made the submission.

An advanced use case would be to optionally dispatch a form. For example

{% if fields.test == 'Yes' %}#{{device_id}}{% endif %}

Would only dispatch to #{{device_id}} if the test answer is 'Yes'. You could put a static device identifier there like iPhone_9-4E45-4RR-62GGDASD08410.

You could also have a Select question in your form to decide who to dispatch to. Just make sure that the device identifiers are correct.

#{{fields.DeviceSelectQuestion}}

You can download a CSV of your devices Name/Identifiers from the dispatch transport settings box.

This concludes our overview of the Dispatch Transport destination. If you have any questions or comments feel free to send us a message at support@devicemagic.com or leave us a comment below.

Did this answer your question?