Editing TechService on Android for SME

This application is now called SME Mobile for Android and can be downloaded from Google Play:
https://play.google.com/store/apps/details?id=com.h5sw.smm

Technicians can access and update their open orders using their native SME Android application.
<br>- Access and update open orders assigned to them in SME
<br>- Open an order and view that customers equipment list
<br>- Add Material, Labor, and Services to the order
<br>- Add Services Performed
<br>- Collect Customer Signature
<br>- Timer to track how long the tech worked on an order
<br>- Update order status and close orders
<br>- Clock In / Clock Out to tracking
<br>- Access to custom fields created for orders in SME


== Install ==
Download the Tech Service for SME on Android application from the Android Market.
<br>https://market.android.com/
<br>Search for “TechService for SME”. Download the application and open on your Android.

== Log In ==
You will need WebServices installed to run TechService for SME. Contact High5 support if it is not installed. Once installed, High 5 Software will provide you with your '''Company ID''' and '''Company Key''' which will be used when logging in.

<br>User needs to be assigned a '''TechID''' and '''Web Access Password''' to log in.
<br>[[File:AndroidLogin.png]]

<br> To assign a Tech ID and Tech Password:
<br>- Open SME and login.
<br>- Go to '''Setup''' module > '''Users'''.
<br>- Search for your technician or add the tech
<br>- On the Details and Settings tab, enter an '''Employee ID''' for the tech. When your technician enters services performed on an order, the note will be time and date stamped. In the time stamp line, you will also see the Employee ID.
<br>- On the Technician Settings tab, enter a '''Web Access Password'''.
<br>[[File:WebAccessPass.jpg]]


== Log Out ==
If you want to log out so you can login as another tech, tap '''Settings''' >''' Reset'''.
<br>[[File:AndroidLogout.png]]

== Choose sections of orders to show / hide (Preferences)==
You can choose which sections of the orders you are viewing such as customer equipment and signature. From the Settings button, tap preferences (image below - the Settings button is shown at the top in the screenshot, but on some Android devices it is a hard button at the bottom of your device)

<br>In the Preferences window, you will see all the options you can choose to show (checked) or not show (unchecked).
<br>[[File:PreferencesAndroid.png]]

== Timeclock ==
In the Settings menu tap Timeclock > Clock In. SME will track the time that you logged in and logged out.
<br>[[File:Timeclock_TechService.png]]
<br>Go to the Tech's User Record in the Setup module and click the Log tab to view your technicians Log in and Log out times.
<br>[[File:TechUserRecord_LogTab.png]]

== Assigning Orders to Techs ==
The technician logged into TechService on Android will see all of their open orders. This includes any open order where labor is scheduled for them or if their name is selected in the '''Assigned to''' field.

== Updating Open Orders ==
<h3>Search for orders</h3>
The order list shows all open orders assigned to the tech logged in. Use the filter field at the top to search and tap the order to open.
<br>[[File:OpenOrderListAndroid.png]]

<h3>Order Details</h3>
When you open an order, you will see the Order Navigation window. You will see the sections of the order you chose to show in your preferences. On this screen you can change the order status, select the various sections to see order details, start timer, close the order, and go back to your order list.
<br>[[File:OrderNavigationAndroid.png]]

<h3>Navigation through the order details</h3>
In each section of an order, you will see navigation at the bottom.
<br>'''Order List''' - goes back to your open order list
<br>'''Order Nav''' - goes back to the order navigation window where you can change the status and choose specific sections of the order
<br>'''Next''' - goes to the next order section
<br>[[File:OrderDetailsNavigationAndroid.png]]

<h3>Order Summary section</h3>
In the Order Summary section you can view the site address, contact info, due date, SLA Category and more. Tap the address to map the site address.
<br>[[File:OrderSummaryAndroid.png]]

<h3>Services Requested</h3>
Review the description of work to be completed for the order in this section. 

<h3>Services Performed</h3>
Add a description of services performed / completed by going to the Services Performed section. Click '''Append Note''' and enter description as shown in image below. The entry will be time and date stamped and immediately show in both SME and TechService for Android.
<br>[[File:ServicesPerformedAndroid.png]]

<h3>Time</h3>
View and add labor time for the order. Tap '''Add new labor task entry''' to add labor time. Labor time added in TechService will automatically update SME.
<br>[[File:LaborTasksAndroid.png]]

<h3>Materials</h3>
You can add material to an order in the Material section. 
<br>[[File:MaterialsTechService.png]]

<h4>Material List available on TechService on Android</h4>
The materials that will be available to add in TechService on Android are the inventory items that have''' Show on Tech Portal''' checked in SME. 
<br>[[File:ShowOnTechPortal_TechService.png]]

<h4>Allocating Stock for material added in TechService on Android</h4>
If you are creating a warehouse in SME for your technician's truck, you can assign that warehouse as your technician's default warehouse. That way, when your tech adds stock from TechService on Android, SME will allocate stock from your technician's default warehouse, rather than the item's default warehouse. 
<br>To set a default warehouse for your technician:
<br>1. Go to '''Setup''' module > '''Users'''
<br>2. Click '''Search''' > '''Search Active Users''' and select the technician.
<br>3. Click the '''Technician Settings''' tab. Locate the '''Warehouse''' field and select the warehouse you use for your technician's truck. (image below)
<br>[[File:TechPortal_TechWarehouse.png]]

<h3>Services</h3>
You can add service items to the order in the Services section. Tap '''Add new service item''' and tap the '''Service Name''' field to select item,
<br>[[File:Service_TechService.png]]

<h3>Customer Equipment</h3>
You can view the customer equipment for the customer the order is for. Tap the equipment to view details and edit custom fields if you have any setup for equipment.
<br>[[File:CustomerEquipment_TechService.png]]

<h3>Documents</h3>
We recommend using ES File Explorer to manage download and upload document.
https://play.google.com/store/apps/details?id=com.estrongs.android.pop.cupcake

In the Documents section you can view any documents added to the order in SME (the document must not be linked, but stored in the database to be accessible on TechService for Android)

<br>You can also take a picture and upload the picture to the order in TechService. The picture will be saved in SME immediately and found on the Stored Documents tab on the order. 
<br>[[File:TakePicture_TechService.png]]
<br>[[File:PictureUploadedFromTechsService.png]]

<h4>Document Download, Modify, and Upload Guide</h4>
This guide for managing documents is good if you have a document such as an inspection form that you want techs to download, update or modify the document and upload the modified document back into SME.  These instructions relate to using ES File Explorer app: https://play.google.com/store/apps/details?id=com.estrongs.android.pop.cupcake
Thanks to Pete from FirePro for providing these instructions!

1.       Start SME App

2.       Select the Service Order

3.       Go to Documents, and select appropriate file.

4.       VIEW the file, and use ES Downloader to download.

5.       Once downloaded, OPEN FILE..

6.       Choose application to open and modify the document.  For example, ezPDF can be used with PDF files.

7.       If document is modified, then SAVE AS (which is now placed in the DOCUMENT section of the Tablet)

8.       Bring up the Service Order, go to Documents, press SELECT A FILE, and select the modified document to upload to SME (on the server)

<h3>Custom Fields</h3>
The custom fields you created in SME for service orders will show in this section if the '''Show in Tech Portal''' box is checked in the Custom Table Designer window.
<br>[[File:CustomTableDesigner_ShowInTechPortal.png]]

<h3>Signature</h3>
In the signature section you can collect customer signature. The signature will be automatically saved in SME on the Work Requested tab. Click the Signature button to view the signature in SME.
<br>[[File:Signature_TechService.png]]

<br>If you want to show the signature on a printed work order, follow the instructions on this page: '''[[Add TechPortal Signature to Order Report]]'''