01. Jobs

Introduction

Central to TaroWorks is the concept of Jobs and Tasks. A Job is a defined process to be completed by a mobile user. A Task is an ordered step in that process. It is also possible to have Jobs consisting of only a single Task.

Steps to complete a Job and share it with the rest of your organization are:

1. Open the Job
2. Complete all Tasks.
3. Sync.

The following high level topics will be covered in this article:

• A. Job Navigation - Accessing and navigating Jobs
• B. Input Types - The various types of questions the mobile user could be asked to answer
• C. Saved Jobs - Accessing and deleting Saved Jobs
• D. Submitted Jobs - Viewing a list of Job names that have been submitted to Salesforce
• E. Context Menu - Menu options from within a Job
• F. Completing a Job - Options like Sync Later, Sync Now, Repeat Job
• G. Search Function - finding a Salesforce record in a long drill-down hierarchy menu

A. Job Navigation

1. From the TaroWorks home page, all of processes the mobile user can execute are located under the Jobs icon.
2.  Select the Job you want to start.
3. To start a new Job, click New Job.
4. To view the instructions for the job click the Instructions button.
5. Once the Job is selected, the list of Tasks within that Job are displayed. You can select a particular Task, or click Start Job.
6. If this Job requires working with existing records from Salesforce, you'll select those first before answering any questions. The purpose of your selection should be in the first row in the black bar at the top. The type of item you're currently selecting is in the second row (the bread crumb menu).
7. Once you've selected the record(s) that you need for this Job, click Next. 
8. To navigate forward through questions in a Form, click Next.
9. To navigate backward to a previous question in a Form click Prev, or you can use your Android's native back button.

B. Various Field Types in Jobs

1. You complete a Single Select question by clicking on the circle next to the option you want to select.
2. You complete a multi-select question but checking the boxes next to all the options you want to select.
3. You complete a free text field by clicking on the field to complete, and then using the keyboard to type in your response. TIP: To hide the keyboard, click on the back arrow of the device like this one shown here. 
4. You complete a photo question by clicking Take Picture, and then clicking the capture button in your native camera app.TIP: If you'd like to change the photo you took or to replace it, click on Retry.
5. To complete a signature question click Gather Signature, then use your finger to sign on the next screen. Click Save and Close.TIP: If you'd like to change the signature, click again on Gather Signature, click Reset, and input again a signature.
6. To complete a GPS question, ensure your location services are enabled and then click Record Location. When the accuracy level is acceptable, click Record Location. Otherwise, when the accuracy is less than 5m the location will automatically be captured.TIP: Here are some tips to improve accuracy of GPS location.
   TIP: To edit the coordinates, click on Record Location again.

C. Saved/Incomplete Jobs

In TaroWorks, you can save a Job and access it later. For example, lets say the person you are collecting information from, does not have the particular information you need at the initial interview. You can save the job and complete it later. It is important to name the job in a manner that if you come later to review saved jobs you can know which job to edit. For example, if you are registering new farmers, you could save the Job as the name of that farmer so that when the farmer returns with the remaining information it's clear which Job to resume.

To save a job without marking it complete:

1. Tap on the three dots (contextual menu) on the top right.
2. Select Leave Job.
3. Input a name for the Job in progress.
4. Click Save.

To access saved Jobs:

1. From the TaroWorks home screen, click Jobs.
2. Select the Job containing the saved Jobs you want to open.
3. Select Saved Jobs.
4. You'll find saved jobs that have not been marked complete under the Incomplete Jobs tab.
5. Click on the Job you'd like to resume.

D. View List of Submitted Jobs

Once a Job has been marked complete and succesfully synced, you can view a list of the Jobs that had previously been sent into Salesforce.

1. From the TaroWorks home screen click Jobs.
2. Select the Job for which you'd like to review the list.
3. Select Saved Jobs.
4. Click the Synced Jobs tab.
5. Here you will see the name of the Jobs that have been sucessfully submitted/synced.

E. Context Menu

Anytime you have additional actions available to you, there will be a 3-dot menu in the upper right-hand corner. These actions will change based on where you are accessing the menu from. The following the are actions you can take from within a Form.

1. View Index: This shows you all the questions and responses on the Form and you can easily navigate to a specific question by clicking on it.
2. Form Version: Gives information regarding the name of the Form and the version of the form. This may be requested by your system administrator.
3. Go to Start: This will take you to the beginning of the Form.
4. Go to End: This will take you to the end of Form.
5. Leave Job: Leave Job will give you options whether to save or discard the job.

F. Sync Later

For situations where a mobile user knows they have limited connectivity, TaroWorks has the ability to Sync Later after completing a Job.

Steps to complete a Job and Sync Later:

1. Mark the final Task in the Job Complete.
2. Rename the Job(optional) and select Sync Later.

To access Jobs that have been Marked Complete but have not been synced into Salesforce:

1. From the TaroWorks home page, click Jobs.
2. Select the Job you'd like to access.
3. Click Saved Jobs.
4. Click Completed Jobs tab.
5. Once you are in an area with internet, you can click Sync from the same screen, from the TaroWorks home page, or after completing a Job.

G. Repeat Job

Repeat job is an easy way to start the Job again without navigating through all your Salesforce record menus again. At the end of the Job, you will see a page like the one below. If you want to do the same Task again starting at the last Salesforce record selection you have to make for this Job, click on Repeat Job.

H. Search Function

The Search function automatically appears when the list of Salesforce records to choose from for a Job is longer than can be displayed on the screen. When you start typing, the list will filter down to only those records containing the string you have entered.