Dispatch Forms to a User

DispatchClosed The term "dispatch" refers to the act of sending a form to a mobile user or customer. Typically, a dispatched form includes some information pre-filled to give the recipient context for the work to be done. Dispatch can be manual or automated (using a Dispatch Data Destination or the TrueContext REST API). a form when you want to send work to specific users. You can prefill answers and add Notes, Priority, Due Date, and Location metadata to help users prioritize jobs. This topic describes how to dispatch a form from the Web Portal and how to bulk dispatch jobs.

Available on all tiers, with more options on the Advanced and Enterprise tiers:

Essentials
Advanced
Enterprise

Info:If you're on the Enterprise tier, you can dispatch a record to a user, a group, or to all groups in a FormSpaceClosed FormSpaces are where forms are stored and organized in the TrueContext Web Portal. A TrueContext Team may have multiple FormSpaces, depending on their needs. Admins can set FormSpace permissions to control which users have access to the forms in that FormSpace.. The topic Introduction to Group Dispatching describes this feature in detail.

Contents

Overview

Benefits of dispatching

In many cases, starting with a blank form just doesn’t make sense. You know in advance who should be filling out the form, and you know some of the data that belongs there. Dispatching allows an administrator to choose which mobile user should fill out a form and to provide important information about the task.

For example, you can direct a technician to a customer location and provide instructions about the work to be done. This can help mobile workers arrive prepared for their site visit so that they can get right to the task at hand.

Ways to dispatch a form

There are four ways to dispatch forms to users:

This topic describes the first two options.

Info:The topic Supported Question and Data Types for Dispatching lists the data and question types that each dispatch method supports. It also describes the formatting requirements for specific types of questions, such as Barcode Scanner and Geolocation.

Video demo

Dispatch a form with the Web Portal

We make it quick and easy to dispatch forms to users with the user-friendly dispatch interface.

Prerequisites

Steps to dispatch a form

  1. Navigate to the desired form, and then select Dispatch beside the form name.

    Note:If you don’t see the Dispatch option, make sure the form is set up for dispatching.

    Tip:If your group has the Can Manage Assignments permission but not Can Create, users can’t open a specific form definitionClosed A Form Definition is a template for an actual form or record that field users interact with. Using the Form Builder, you define the structure, layout, fields and data types, and logic of a form. A Form Definition also specifies resources available to users on their devices, such as Images and Documents, and mappings for data brought in from external sources.. Instead, they should follow these steps to dispatch a record:
    1. Go to Forms & Integrations > List Forms.

    2. Find the form that you want to dispatch, hover over the gear icon, and then select Dispatch Form.

      One form in the list of forms that shows the gear icon at the top right and the Dispatch Form menu option

      Result: The Dispatch Form page opens.

  2. Select a user to dispatch to.

    Info:If you're on the Enterprise tier, you can dispatch a record to a user, a group, or to all groups in a FormSpace.

  3. Fill out any fields you want prefilled. Leave all other fields blank.

  4. At the bottom of the page, select Dispatch.

Metadata that you can dispatch

Easily assign notes, priorities, due dates, and locations to dispatches, giving mobile users the tools they need to efficiently plan their work in the field. Your mobile users can get a higher-level look at their assigned jobs without needing to look at each individual form. Also, they can sort based on the metadata.

You can dispatch metadata into the following fields:

  • Notes: These can be a maximum of 256 characters.
  • Priority: This can be Low, Medium, or High. If you don’t assign a priority, the dispatch defaults to No Priority.
  • Due Date: If you don’t supply a time zone, the dispatch defaults to the dispatcher's team time zone.
  • Location: Enter an address. The Web Portal provides a map so that you can confirm the location.

Steps to dispatch metadata with the Web Portal

Use the additional boxes at the top of the dispatch page to fill in the metadata information. Simply add the information that you need—you don’t have to add all of the metadata.

2017-12-11-WebDispatch01.png

Field users can find the notes under the dispatched form name in their Inbox or Group Inbox (Enterprise tier only).

Two dispatched forms in a mobile user's inbox. Both dispatches include a note.

The other types of metadata act as a filter when a user selects a tab at the top of the Inbox or Group Inbox.

Dispatch an image

By dispatching an image, you can provide details about a job, such as a:

  • Site-specific floor plan.

  • Reference chart.

  • Sketch produced in TrueContext from an earlier site visit or job estimate.

Note:You can dispatch a .jpg, .jpeg, or .png file to an Image, Sketch Pad, or Signature question.

To dispatch an image, select Choose File.

Dispatch a language

Info: The Multi-Language feature is available as an add-on to the Advanced and Enterprise tiers. With the Multi-Language feature, you can create a single form and provide it to your field users in multiple languages. You can also set up some types of Documents and files to translate content based on the form’s selected language.

If you set up a form as a Multi-Language FormClosed A Multi-Language Form is a form that’s set up with different translations so that field users can choose their preferred language. Translated content includes page and section names, question text, help text, and other form content., you can preselect a language or let users select a language themselves. Translations for the selected language apply to:

Dispatch Form page that shows the Select Language list with the following options: All (user selects), English, Spanish. You can dispatch a language or let the user select. "All" refers to all of the languages that have translations set up on the form.

Tip: If you dispatch a form with a preselected language, choose one that all users who interact with that form can understand.

Note:Dispatch Destinations do not give you the option to dispatch a language. The user selects a language when they open the dispatched form.

Bulk Dispatch with a CSV File

Need to dispatch multiple records? Our CSV template allows you to bulk dispatch using one CSV file.

Info:If you're on the Enterprise tier, you can dispatch a record to a user, a group, or to all groups in a FormSpace. The topic Send a bulk dispatch from the Web Portal describes the steps to bulk dispatch to users, groups, and FormSpaces.

  1. At the top of the dispatch page of the selected form, select Bulk Dispatch.

  2. Select the link to download the dispatch template.

  3. Starting with the first empty row, enter the user IDs for the users you want to dispatch to.

    Each row is a new dispatched form.

    Info:The topic Supported Question and Data Types for Dispatching describes how to format Barcode Scanner and Geolocation values for bulk dispatch.

  4. Enter the data and metadata that you want to dispatch.

  5. Does your team have the Multi-Language Forms add-on?

    • If no, go to step 6.

    • If yes, and you want to preselect a language, enter one of the supported language codes in the Language Code cell.

      Bulk Dispatch CSV file that shows "Language (Optional)", "Language Code", and "es" entered as the code.

      Note:Check that the form has a translation file for the selected language.

    • If yes, and you want users to select a language themselves, leave the Language Code cell empty.

  6. To upload the file that contains the dispatch information, select Choose File, and then select the file.

  7. Select Dispatch at the bottom of the page.

Info:The following topics provide more details about Bulk Dispatch functionality: