TABLE OF CONTENTS
Tasks can be added in the Current Tasks screen. Navigate here via Tasks & Dispatch > Current Tasks to see all tasks that are currently active. You can sort the Tasks and also filter using the Search box. By default, any Completed Tasks will not show, but you can display these by checking the Show Completed box.
Create a New Task
To create a new Task, “ADD NEW” button in the upper-right corner of the page. Next you select between Creating a Task from a Template or Creating a new Blank Task. For the purposes of this tutorial, select Create a New Blank Task (you can read up on Task Templates in our Task Templates page). You will then see the Create Task Screen.
- Enter a brief description for the Task. This what will show to mobile app users.
- Select an app user to whom to assign the Task.
- Specify a date and time by which the Task must be completed. If the app user does not complete the Task by this date, the Task will show in red as overdue until they complete it.
- Enter any additional information for the Task. Use this field to enter notes and other useful information that the app user should know about the Task.
- If you are using Groups, you will also see a Restrict To field. Should you select a specific group to which to restrict the Task, then only web and app users in that Group will be able to view and access the Task. The External Id field is optional and allows you to enter a code or identifier from any other system you are using. This way you have a link to systems like a CRM.
- Location is an optional field that allows you to specify a street address where the Task is to be performed. You can optionally search for the Street name and mark it on the provided map. If you do this, the GPS coordinates of the Location will be included in the Task for the app user to view on a map in the mobile app.
- The Must Complete Within field allows you to force the Task to be completed within a specified radius of the selected Location. If you choose one of the available Complete Within options, then the system will use mobile device GPS to detect how close the app user is to the Location. The app user will not be able to complete the Task until the GPS confirms that they are within the specified radius. Be careful with this option: the GPS systems in mobile devices can be inaccurate indoors, which may result in your app user being unable to complete the Task.
- Once you've filled out the fields, hit the Create button to create the Task.
Edit Task Activities
After creating a new Task, you will enter the Task Activities screen. As mentioned earlier, every Task must have at least one Activity in order for you to send the Task to the assigned app user. You manage the Task activities in the Task Activities screen, which is accessed via the “edit activities” link displayed in top-left options bar of the Edit Task screen and is also accessible from the Tasks Listing screen when you roll over a row.
The Activities screen contains the list of Task activities and is also updated by the app user’s actions as the Task is progressed and completed in the field. For a new Task, add activities by using the “Add Activity” link. You can change the order of the activities by using the arrowhead buttons to the right of each row, and delete activities using the X button. Each activity must have an Activity Type and relevant Activity Details specified:
- For the Fill Out Form type, you must specify the Form from the list of published Forms.
- The Read Doc activity type requires that you select a Doc from the published Doc list
- The Instruction type requires that you enter some text describing the instruction.
Once a Task is sent to the app user, the Activities screen is no longer editable. As the app user completes the Task activities, the activities will be updated with completion times and links to any data received such as Form entries filled out. Once you have entered all the activities for the Task, make sure you click the “save changes” link in the options bar to save the contents. After saving your changes, you can use the “edit details” link in the options bar to go on and send the Task out to the app user.
Delete a Task
To delete a task seen on the Current Tasks page, click the checkbox to the left of the row and click the "MANAGE" button in the upper-right corner of the page and click "TRASH." Confirm the choice on the resulting modal to send the task to the trash bin. Note that the task's assigned user must Force Sync on their app to see the task removed from the device.
Import a Task
In addition to creating a new task from scratch in the designer, you can also import a task from an Excel spreadsheet or CSV file. Click the "IMPORT TASK" button to the right of the "ADD NEW" and "MANAGE" buttons to select a file for importing.
Within the resulting modal you will also see a downloadable link for an example template that you can modify and upload. When using this template, be sure to complete all fields, including the "Complete By" field. Details for the various fields can be found in the "Column Definitions" tab in the template worksheet; this tab should be consulted for any errors encountered when trying to import the sheet.
Please note that 3 things at minimum must be addressed for the template to be accepted:
- The "someone@example.com" value in the Assigned To column (B) must be replaced with the email address of an actual user.
- The date value in Complete By (D) must be formatted according to the date format specified in Organization Setup > Regional Settings.
- If ActivityType (M) is FillOutForm, the value of ActivityDetail (N) must be the name of an actual form within the organization.
You also have the option to, Trash and Send a task.
Once a task is created and all activities or files have been added, be sure to hit save and then send.
Once a task is sent, monitoring and editing tasks are achieved via the web portal where the task's Details page allows for task status changes, reassigning and location updates, etc.
However, task activities are uneditable when viewing the Activities page of a sent task, which is updated on the user's actions/progress/completion out in the field.
Create Task
Task Details | |
Description | Enter in text. |
Assigned To | Select the app user to assign this Task to or:
Note, if Restricted To Group, only users within the specified group will be assignable from the list. |
User Can Reassign | If checked, app users will be able to reassign this Task to another user and provide a reassignment reason in the notes/comments section in-app. Note, in the web portal, notes/comments can be viewed on the task's activities page under Field User Notes / Comments. |
Reassign Target | If the user can reassign, controls the user list shown during the reassignment process in-app. Select user list to display:
|
All Day Task | If checked, select a date and time. Note, replaces Expected Sart/Complete By options. |
Expected Start | Select a date and time. |
Complete By | Select a date and time. |
Time Zone | All dates and times specified on this Task will be in this time zone. |
Additional Information | Enter in text. |
Restrict To Group | Restrict access to a specific User Group. Note, Users with a level of Administrator and higher override these restrictions entirely and are able to access all content in all groups. |
Task Location | |
Location | Enter the location (Number, Street Name, Suburb/Town, Post Code), and find the address to acquire GPS coordinates, where the task is to be completed or drag a map marker to the exact location. Note, if the map marker is used, GPS coordinates of the location will be included in the Task for the app user to view on a map in-app. |
Must Complete Within | Select a radius distance the task must be completed within from the GPS coordinates acquired. The app uses the device's GPS to detect location proximity, and the user will only be able to complete the task within the specified radius. |
Advanced Options | |
External ID | Enter an external id for the task. Useful for external system integration scenarios when using our exposed APIs. Can also be used as a code or identifier from any other system you are using. This way, you have a link to systems like a CRM. |
Icon To Display | Select the task icon that appears in-app. |
User Can Reject Task | If checked, the user can reject the task and provide a rejection reason. Note, in the web portal, rejection reasons can be viewed on the task's details page under Task History. |
Disable Notes | If checked, users will not be able to add notes to the task. Note, in the web portal, notes/comments can be viewed on the task's activities page under Field User Notes / Comments. |
Task Activities
Activities | |
Activity Type |
|
Activity Details | Select or enter the activity's details based on the type selected, mentioned above. |
Optional Activity Name | Enter in text. |
Optional | If checked, the activity will be optional. |
Data | When viewing in-progress or completed task activities, a link will be available to view the activity's form-captured data. |
File Attachments | |
Add/Choose File | Upload numerous various files from your device. Note, depending on file type, the user's device will require respective file type readers to view added files on their device. |
Description | Enter in text. Note, option becomes available after saving. |
On-Demand |
Default is to download the file in the background ahead of the user accessing it. Once the file is downloaded, it is stored on the device for offline use. Note, option becomes available after saving. |
Assigned To | |
First Available Person |
A user is considered to be available if they do not have any existing Tasks already scheduled during the start/end period of this new Task. This is useful for Tasks that any user can be assigned and saves time spent searching calendars for availability; instead, the system smartly allocates this Task according to existing assignments. |
First User To Claim |
Once the first user accepts the Task, it will be removed from all other assigned users. Users must have an internet connection when attempting to claim the Task. |
All Users To Complete |
|