Android User Guide. Last Updated On: April 07, 2018

Transcription

1 Android User Guide Last Updated On: April 07, 2018 Copyright Notice Copyright 2018 ClickSoftware Technologies Ltd. All rights reserved. No part of this publication may be copied without the express written permission of: ClickSoftware Technologies Ltd. Publication Notice The information contained herein does not constitute a warranty of any kind. ClickSoftware Technologies Ltd. reserves the right to revise this publication and make changes without notification. ClickSoftware Technologies Ltd. assumes no liability for losses incurred because of information contained herein.

2 Table of Contents 1. Mobile App Requirements Installation & Initial Setup Steps Launching ClickSoftware StreetSmart on Your Mobile Phone Logging Out Navigating the Mobile App Take a Phone Call Make a Phone call To suspend StreetSmart: To return to StreetSmart after your call: Timesheets Smart Notification for Timesheet Actions Forms Submit Forms Save Forms Picture Capture using StreetSmart: Capture Signature using StreetSmart: Completed Forms Jobs Job List Screen Job Summary Screen Job Details Screen Job Actions Mobile Job Create Android User Guide Page 2 of 53

3 8.6. Completed Jobs Job Invoice on Mobile App Trips Locations Messages Message Screen Message Detail Screen Barcode Scanning Settings Menu Change Battery Settings to enable continuous communication Android User Guide Page 3 of 53

4 1. Mobile App Requirements - The mobile app requires 12 MB of application space for installation - ClickSoftware StreetSmart requires a paid subscription. Contact your carrier sales representative to get the StreetSmart Mobile App added on your Android phone. Not all the features shown in the document below are available with all packages. Please contact your StreetSmart Sales representative, if you have any questions. Android User Guide Page 4 of 53

5 2. Installation & Initial Setup Steps - Configure GPS Location Settings - Download the app - Activate the mobile app - Agree to the End User License Agreement (EULA) Enabling location on device and downloading the App to the phone - Visit select your carrier/product and then click to the Supported Devices Page. - Choose the device your company is using, and follow the instructions listed on the popup. Activate the App and agree to the EULA - Once the StreetSmart application is installed, tap on StreetSmart to run the application. Note: Android 6.0 and above devices need permission to use contact, camera, location, SMS, and media. Click on Allow to give permission. - Device will activate using phone number of the device. - Device will automatically login to the mobile worker for that device. - The End User License Agreement (EULA) screen will appear. Read the agreement before continuing. If you agree to the terms stated, acknowledge by selecting I Agree. Note: If you decline the EULA, the application will exit, and the application will not be able to be used. Android User Guide Page 5 of 53

6 3. Launching ClickSoftware StreetSmart on Your Mobile Phone StreetSmart is a mobile app that runs on your Android mobile phone. To launch StreetSmart on your mobile phone: Select the StreetSmart logo from the Android main menu. Note: StreetSmart will automatically launch upon the mobile phone powering up or if Auto Application launch is enabled through the StreetSmart Web Management Application Hours of Operation. 4. Logging Out To exit StreetSmart: 1. Select the Exit option from the main menu. 2. Select the Yes option to confirm that you want to exit the application. Note: The StreetSmart Mobile App cannot collect GPS locations or send or receive information when it has been exited. Android User Guide Page 6 of 53

7 When a mobile worker closes the application from background or force stop the application from the task Manager, a warning message is displayed to the mobile worker. It is done to enable continuous running of StreetSmart application, so that it can exchange collected information with the server during the operational hours of the mobile worker. Android User Guide Page 7 of 53

8 5. Navigating the Mobile App Throughout StreetSmart, you will see the commands displayed as icons placed in a 3 by 3 grid. These commands are touch sensitive and once you tap on any one of these commands, the application will navigate to the item you selected. For example, in the image below, the Timesheets command will take you to the Timesheets page, from where you can perform the Timesheet actions such as Shift and Break. Android User Guide Page 8 of 53

9 Symbol Description Tap on this icon to get into the StreetSmart home page on your Android phone. Tap on this icon to perform server sync. This icon represents the GPS connectivity. If this icon turns Red that means no GPS connectivity. If turns Orange, that means initializing the GPS connectivity and if turns Grey, that means the Location is turned off on your mobile phone. If the color of the icon represents Green, that means good GPS connectivity Take a Phone Call When someone calls you, StreetSmart goes into Suspend mode automatically, so you can take your call as if StreetSmart wasn t even running Make a Phone call To place a phone call from within the application Press the home button to go to the phone home screen. Or Press the return button to go to the main menu To suspend StreetSmart: To suspend the StreetSmart application, click on the Home button or press the return button on your phone To return to StreetSmart after your call: Select the StreetSmart icon from the Main Menu. Note: While on a voice call, StreetSmart will attempt to collect GPS pts that will be sent upon hanging up the phone call. Android User Guide Page 9 of 53

10 6. Timesheets StreetSmart lets you log your hours quickly and easily. Just select the appropriate timesheet action from the list, and StreetSmart will automatically log the time and send the data back to the web management application. The administrator may also add a form to the time actions to collect data associated with your hours. To log your time: 1. Select Timesheets from the StreetSmart Main Menu. Android User Guide Page 10 of 53

11 2. Select Start Shift when you want to punch in action tab. Android User Guide Page 11 of 53

12 3. Select Start Break whenever you take a break in action tab. Android User Guide Page 12 of 53

13 4. Select End Break whenever you go back to work in action tab. Android User Guide Page 13 of 53

14 5. Select End Shift when you are ready to punch out in action tab. Note: You will see the Timesheet history at the bottom of the Timesheets screen under Recent Events. Android User Guide Page 14 of 53

15 6. The summary tab will display the reported time entries for the past days and weeks. It includes: History of timesheet actions grouped by days Sum of pay hours and break time for each shift Sum of pay hours and break time for each week. Android User Guide Page 15 of 53

16 6.1. Smart Notification for Timesheet Actions StreetSmart mobile app allows you to set reminder to perform your timesheet actions on schedule. Mobile Smart Notifications enables your field worker to get a notification in case an expected action wasn t performed on time. Field workers will have the option to turn on notification to perform various timesheet actions, such as Start Shift, End Shift, Start Break and End Break. Setup Smart Notification: The notification can be setup from the StreetSmart mobile app. Go to Settings > Notification on your mobile app and setup when you want to be notified on a specific type of timesheet action. Note: Hours of operation (HOO) from the StreetSmart web application should be defined to use Mobile Smart Notification. You will see following option in the Notification screen: Start Shift Set the timer to certain minutes or hours after which you will be notified to start your shift as per the Shift Start time set under Hours of Operation Start Break Specify the time when you want to start your break End Break Specify the time after which you should receive the End Break notification. Timer gets activated based on what time the break was started End Shift Set the timer to certain minutes or hours after which you will be notified to end your shift as per the Shift End time set under the Hours of Operation Enable those options for which you want to receive notification. Android User Guide Page 16 of 53

17 Smart Notification on Mobile Device Once you have completed setting up the Smart Notification on your mobile device, you will receive notification to perform certain timesheets actions as per the setup. The notification will be displayed at the top of the home screen of your mobile device. You can perform the timesheet action via a single touch from the home screen of your mobile device or from your phone s notification center. Just tap on the notification and complete the timesheet action. Note: If any form is attached to any of your timesheet actions, then you will get into the forms screen upon tapping the timesheet action from the phone s notification center. Android User Guide Page 17 of 53

18 7. Forms StreetSmart allows you to complete your paperwork using Forms on your mobile phone. Forms can be completed as a part of Timesheets, Jobs or Standard Forms. Standard Forms are available from the Forms menu on the mobile phone. The Administrator will create these forms from the web application and assign them to specific mobile workers. Forms are of three types: Ad-hoc Forms: Ad-hoc forms will be available under Forms from StreetSmart main menu. Timesheet Forms: Timesheet forms will be associated with the Timesheet action, such as shift and break. Job Forms: This type of forms will be associated with the Jobs. 7.1 Submit Forms To complete Ad-hoc form: 1. Select Forms from the StreetSmart Menu. 2. Select the Form you want to fill out. 3. Enter a value for each field. 4. Select Submit, once you have completed the form. The submitted form will immediately be sent to web application. Android User Guide Page 18 of 53

19 Notes: You will see the button By Name at the bottom of the Forms list screen. Once you tap on this button, the Forms get arranged in the alphabetical order (A Z) in the list. Submitting a form for Timesheet action or job action is done on the same manner only the form is being opened once choosing the action. You will get the following types of fields in the forms: Cascading List: This is a hierarchical list where the available options in one level depend on the selection of the previous level. Text / Numeric: This type of field allows you to enter text or numbers in the field. This field also allows you to create expandable text area for the betterment of the mobile data collection. Select List: This field contains a set of pre-defined options Multi Select List: This fields allows you to choose multiple options from a list of checkboxes Label: This field displays labels (notice, headlines, or any other information) on a form. The labels can be presented in regular font or the large bold font. Number: This field only captures numerical entries Checkbox: This field allows you to check or uncheck a box Odometer: This numeric field allows you to enter odometer readings from your vehicles which are used in specific reports to determine shift mileage. Money: This field allows you to enter a number with two decimal places. Text is entered right to left, so entering 123 will result in Picture Capture: This field allows you to capture picture using phone camera or add pictures form your phone gallery. Signature Capture: This type of field allows you to capture the signature of your customer on the phone. Time: Captures either phone time or custom time Date: Captures either phone date or custom date URL: lets your mobile worker access a configured web page on the mobile device Below we have given one sample illustration for the Drop-down list on the Forms page. Android User Guide Page 19 of 53

20 7.2 Save Forms Mobile workers can save ad-hoc forms on their mobile phones as drafts to be completed and submitted on a later stage. Draft tab is present in Forms menu and displays the list of all saved forms. Android User Guide Page 20 of 53

21 The mobile worker has two options to save a form as draft: I) Tap on the Save button at the bottom II) Close the form and choose Save. The user can access any form draft in order to edit details and/or submit it. A draft form can be deleted by swiping left and selecting Delete. A deleted draft form can never be recovered. Android User Guide Page 21 of 53

22 The maximum number of forms drafts on mobile device is 20. Draft Limit Reached message will be displayed while saving the 21 st form as draft. Notes: Saved forms will be only stored locally on the device of mobile worker. If StreetSmart app activation is cleared all saved forms will be deleted and never recovered. You need to upgrade your mobile app to v18.9 to use the draft forms feature. Android User Guide Page 22 of 53

23 7.3 Picture Capture using StreetSmart: Picture Capture is a feature that can be added as a field type on a form. Mobile workers can add multiple pictures from their mobile phone (camera or phone gallery) to a form as a proof of service. A mobile worker can also annotate the images in order to increase visibility on the work done. Tap on the form which is associated to the Picture Capture option from the Forms list. Android User Guide Page 23 of 53

24 Tap on the Picture capture icon to add the images. A pop-up window will appear to choose the image source option as Camera and Gallery. Tap on Camera to take the pictures from the phone s native camera. Tap on the Gallery to select the images from gallery. You can select a maximum of 5 images at once. To add more tap again on the camera icon and select the images from gallery. Android User Guide Page 24 of 53

25 You can annotate each of the added pictures by using the Draw button. To annotate a picture: o Tap on Draw button o Select the Pen size and color o Annotate the pictures (you can use eraser or clear buttons to remove markings) o Tap on Apply to save the annotations o Tap on Close to back on form fields. Android User Guide Page 25 of 53

26 You can add notes to each of the added pictures. Tap on the icon for preview at the top right corner of the phone screen. Tap on Submit or Save. Note: You need to upgrade your mobile app to v18.11 to use the above feature. Android User Guide Page 26 of 53

27 7.4. Capture Signature using StreetSmart: There is a StreetSmart feature on the Android phone that allows you to capture a customer's signature directly on the phone's screen. The main benefit of this feature is that it is a paperless solution to obtaining customers signatures and attaching them to a variety of activities. For example, you may want to use this feature in the following scenarios: Closing out a job that has been successfully completed Accepting deliveries Approving Change Orders to a job that has been pushed out to the phone Approving a Work Order that will allow you to start work. Tap on the form which is associated with the Signature capture option from the Forms list. Tap on the Sign icon. Android User Guide Page 27 of 53

28 The Signature capture screen appears. Capture the signature using your finger (hard objects like a stylus or finger nail will not work). Once done tap on Save. User can add multiple signatures to a form. A sample signature is shown in this image. Android User Guide Page 28 of 53

29 Now you will be brought back to the Signature capture form screen. Tap on the icon for preview of the signature at the top right corner of your phone screen. Tap on the Submit button to attach the signature with the form. Android User Guide Page 29 of 53

30 7.5. Completed Forms StreetSmart Mobile App allows you to the completed forms using your mobile device. Mobile worker will have the ability to send the completed forms via to multiple ids from the mobile device. You will get into the Form page as soon as you hit Submit after filling up a form on your mobile device. Enter valid IDs (separated by comma, space and semicolon) into the Enter ID(s) box and tap Send. You can also select ids from your phone s contact list. If you do not want to send any , just tap Skip. Android User Guide Page 30 of 53

31 8. Jobs StreetSmart receives job information that is dispatched from the StreetSmart Web Application. This job information is displayed on your mobile phone and supplies you with valuable information that helps you get your work done. The job functionality is different based on the package selected Job List Screen The Job List screen displays single-line summary information for each of the jobs that have been dispatched to you on your phone. To find a specified job from the list: Start typing the Job name, Job address, or Job ID in the search box, the search result will appear on the mobile screen. To view detailed job information for a specific job, tap on the searched job result. Note: Job titles will display only as many characters as can be displayed on-screen horizontally. To view the entire job title, select the job from the list. Android User Guide Page 31 of 53

32 At the bottom of the Job List screen, you will see the following five sorting options: - By Name: Tap on this option to sort the jobs in alphabetical order (A Z). - By Closest: Tap on this button to sort the jobs based on the distance of the job location. Such as, once you tap on this option, it will display those jobs at the top of the list which are closer to your current location. - By Schedule: Tap on this button to sort the jobs based on the schedule. - By Status: Tap on this button to sort the jobs based on their status. Such as, started, completed etc. - By Priority: Tap on this button to sort jobs based on their priority (from emergency to low or vice-versa). Note: You need to upgrade your mobile app to v18.10 to use the sort by priority feature. Once you tap on the job from the jobs list, you will see the below four options highlighted in orange: - Summary: Tap on this option to view the Job Summary page on your Android phone. - Actions: Tap on this option to get the Job Action screen. On this screen you can perform several job actions such as Job Start, Travel Start etc. - Navigate: Tap on this option to get the navigation screen where you will see the turn by turn driving direction towards your job location. - Call: Tap on this option to get the Call Job Contact screen from where you can make a call to your job contact. - Start Trip: Tap on this option to get the Trip screen where you can fill the Odometer readings and associated details. Android User Guide Page 32 of 53

33 8.2. Job Summary Screen The Job Summary screen lists high-level details regarding a job, including its current Status. From here, you can access the Job Detail screen, the Job Actions screen, Job Calendar screen, Job Navigation screen, and the Call Job Contact screen. Note: Once you tap on the Jobs button at the bottom of the screen, you will be brought back to the Jobs List screen. To add the job to your calendar, tap on the Scheduled Start time. Android User Guide Page 33 of 53

34 To view the Job location on the map or to get the turn by turn driving direction towards your job location, tap on the Address. Android User Guide Page 34 of 53

35 To get the Call Job Contact screen from where you will be able to make call to your job contact, tap on the Contact. Note: At the bottom of the Job Summary screen, you will see the following three options: Details: Tap on this option to get the Job Details screen on your phone. Actions: Tap on Actions to get the Job Actions screen displayed on your phone. From this screen you can perform several job actions, such as Travel Start, Job Start etc. Jobs: Tap on Jobs to go back to the Jobs List screen. Android User Guide Page 35 of 53

36 8.3. Job Details Screen The Job Details screen displays all the information that has been dispatched to your mobile worker. This information includes the customer s name, the scheduled start time, the estimated duration, the current status and a comments field. To return to the Job Summary screen, tap on the Summary at the bottom of the screen. To start the job actions, tap on Actions Job Actions The Jobs Actions screen allows you to perform several actions which are associated with the job Such as Travel Start, Job Start, or Job End etc. Android User Guide Page 36 of 53

37 8.5. Mobile Job Create StreetSmart allows you to create and start a new job from your mobile phone. Follow the below steps to create job from your mobile devices: Select Jobs from the StreetSmart main menu and tap on the icon as shown here. Select the appropriate Job Type from the dropdown and fill out all the necessary job details and tap Start Job. Note The create new Job option will get disabled, if the number of the jobs in the device has exceeded the limit. If the check box for Automatically Start Job is selected, then you will get into the job actions screen with the first action performed automatically on job creation. If any form is attached to the first job action, you will see the form page on your phone. If Automatically Start Job is unchecked, the job will be created and will get added to your Jobs List automatically and can be started in future. Notes: StreetSmart mobile app remembers your selection for Automatically Start Job and behaves accordingly next time you create a job from your mobile device. Android User Guide Page 37 of 53

38 Mobile Job Create screen now allows you to scan Barcodes using the camera in your phone. Please install Zxing barcode scanner from Play Store to scan using your Android phone Completed Jobs StreetSmart Mobile App allows you to the completed jobs using your mobile device. Mobile worker will have the ability to send the completed jobs via to multiple ids from the mobile device. You will get into the Job page as soon as you perform the Job End action on your mobile device. Enter valid ids (separated by comma, space and semicolon) into the Enter ID(s) box and tap Send. You can also select ids from your phone s contact list. If you do not want to send any , just tap Skip. Android User Guide Page 38 of 53

39 If the Job type is linked with a public form, after completion of job, Customer Submission window will appear. This contains the link of public form. By default, it will have the customer -address filled in job details. If option enabled, you can change the customer -address. Android User Guide Page 39 of 53

40 8.7. Job Invoice on Mobile App The Mobile App will show a menu Invoice which allows your mobile worker to report used parts and labor quickly. Note - You need to upgrade your mobile app to v18.9 to use the Invoice feature. Reporting used parts and labor: To report a used item on the device, tap on the Invoice icon from the main menu. Once in the Invoices page, you will see the following options: Select a Job Used items (parts or labor) information can only be submitted along with a job. You need to select any new or in progress job by clicking Select a Job button. Note: If an item has already been submitted along with a job, you can t select that job for another item submission Add Item The Add Item button will become enabled only after selecting a job in the previous step. Tap on the Add Item button and select item to submit along with the job. o You can select item by searching with the item name or number o You can also search for an item based on the item category on your mobile device o Unit Price and Tax Rate will be set automatically. Mobile user can change the Unit Price and the Tax Rate on their device. o You can change the quantity of each item. Labor items quantity accepts decimal values. o Once done, tap on Add. o You can add up to any number of Items. Tap on the Add Item icon to add more Items. Android User Guide Page 40 of 53

41 Summary: After an item is being added, a summary will be presented with the Parts, Labor and Tax subtotals. These values are calculated based on the chosen items and their quantities. The worker can then choose to add a comment to the invoice, in case this field was provided by his manager (controlled through a preference under Settings > Jobs). Android User Guide Page 41 of 53

42 9. Trips Using the StreetSmart application, you will be able to start and end your trips. This allows you to keep track of the miles traveled by your field worker and calculate the re-imbursement based on the data provided by the StreetSmart Web Application. Start Trip: Tap on the Trips icon from the StreetSmart home screen. The Start Trip page appears on your phone screen. Perform the following action on the Start Trip page: 1. Enter the Start Odometer value 2. Tap on the camera icon to add odometer picture. 3. Check the box for Auto-fill with last end odometer to fill in the Start Odometer field automatically with your last end odometer value 4. Select Category 5. Select Purpose 6. Select a job to link to your current trip Note You can only select those jobs which are already present in your Jobs List. 7. Enter Vehicle ID 8. Enter notes related to your trip 9. Tap Start End Trip: You will now see the End Trip screen on your phone. To end a trip: 10. Enter the End Odometer value 11. Odometer distance will automatically be calculated based on your start and end odometer entries 12. Enter Commuter Distance (non-business miles) 13. Enter Additional Expenses if any 14. Enter trip related notes 15. Tap End Android User Guide Page 42 of 53

43 View Trip List and Details: Once you end the trip, Trip log screen appears on your phone showing the list of all the trips performed by you. Trips can be sorted based on Date/Distance/Dollars from this screen. Clicking on any trip from this screen will display the Trip Details page for that particular trip on your mobile device. Android User Guide Page 43 of 53

44 10. Locations StreetSmart lets you receive Locations from your dispatcher and request turn by turn driving directions from your current address to the Location. To view the location on Map and get the Driving Directions towards the Location: 1. Select Locations from the StreetSmart Menu. 2. Locations List appears on your phone screen. Tap on the location you want to view on map. Android User Guide Page 44 of 53

45 3. You will be prompted with the below screen. Tap on Navigation. 4. You will see the Location highlighted on Google Map on your Android phone. Android User Guide Page 45 of 53

46 Delete Location: StreetSmart now also allows you to delete unwanted Locations from your device without affecting the web application. Go to Locations and select any location from the list. Click Delete as shown in the following screen. This action will only delete the Location from your device and not from the web application Android User Guide Page 46 of 53

47 11.Messages Message Screen The Message screen displays summary information for each of the messages that you have received on your mobile phone. Messages are sorted and displayed on screen in the order in which they were received. To view the contents of a specific message, tap on the message from the Message List. You can view messages by the following categories which are at the bottom of the screen: All, Unread, Read, and Latest Tap on All to view all the messages you have received from your supervisor. Tap on Unread to view only those messages which have not been read by you. Tap on Read to view only those messages which have been read by you. Tap on Latest to view those messages which you have received recently. Android User Guide Page 47 of 53

48 Mobile workers can delete all messages by taping on Clear All, in each category. A confirmation message is displayed before deleting all messages. Tap on Yes to confirm. Mobile workers can swipe left each message and tap on Delete button to delete the message. Android User Guide Page 48 of 53

49 11.2. Message Detail Screen The Message Detail Screen displays the contents of the message and details about the Sender. Android User Guide Page 49 of 53

50 12. Barcode Scanning The StreetSmart Mobile App allows you to scan barcodes using the camera built into the phone. To scan barcodes, follow these steps: Note: You need to install the Barcode scanner for the first time. On StreetSmart Mobile App, tap on any text form field and select the Barcode button at the bottom of the screen. Now, if the barcode scanner is not installed on your phone, you will have to install the Barcode scanner from the Android Market place on your phone. Go to Market/Play Store from your phone s main menu. Note: You do not have to press any button to scan the barcodes. It will be done automatically. Once the barcode is recognized, you will be brought back to the StreetSmart Mobile App screen. You can also press the BACK button if want to cancel the scanning. Android User Guide Page 50 of 53

51 Now you will get the StreetSmart Mobile App displayed on your phone screen containing the barcode value in the selected field. Android User Guide Page 51 of 53

52 13. Settings Menu Pressing the Settings will bring the user to the Settings menu. This menu offers administrative and troubleshooting features. Device Summary View detailed device info under device summary This contains helpful information when calling customer support. Send Current Location Send your current location to the StreetSmart server from your mobile phone. Send Log to Server This feature helps you to send the Log files to the StreetSmart server. Notifications Refer to section 6.1. Smart Notification for Timesheet Actions for more information. Alert Sounds Mobile workers can change the alert sound for notifications available in Settings>Alert sounds in the StreetSmart mobile application. Android User Guide Page 52 of 53

53 Advanced Options: Once trying to access Advanced Options, you will then be prompted to enter a pin number (default is 4321). Clear Activation Reset the device activation on the device and the server. Clear Record Store Clear all data stored on the device. Force Login Force the user to login upon the next application restart. Useful if the login mode is set to automatic and you need to log another user in. Note Settings menu could be made hidden from the StreetSmart home screen on your worker s mobile phone to prevent them from making any unwanted changes in the StreetSmart settings. 14. Change Battery Settings to enable continuous communication The Battery Manager feature provides you with a real time view of what features or applications are using the highest percentage of your battery. It can also be used to select an automatic or manually-selected battery saving profile. Go to Administration > Settings > Setup Wizard from the home screen on your StreetSmart web application. Now go to Other Settings page and select Max Battery check box. This preference will send GPS points less frequently to the StreetSmart server and will help the phone s battery to run for long time. Android User Guide Page 53 of 53