Revision as of 07:17, 15 April 2016 (view source) Marcin (Talk | contribs) (→‎{{anchor|Toc390862459}} Using Agility for Android) ← Older edit		Revision as of 07:36, 15 April 2016 (view source) Marcin (Talk | contribs) (→‎Response Target) Newer edit →
Line 611:		Line 611:
	*The Response Target counter shows under the Due Date counter with relevant labeling to distinguish which is which.		*The Response Target counter shows under the Due Date counter with relevant labeling to distinguish which is which.
	*The Response Target Time counter should be hidden once the Task has been Responded To.		*The Response Target Time counter should be hidden once the Task has been Responded To.
−	*The Task is Responded To when it reaches status specified in the system parameter (\\MobileLite\AgilityForAndroid\HideResponseTimerStatus).	+	*The Task is Responded To when it reaches status specified in the system parameter ([[:Mobile Lite Parameters|\\MobileLite\AgilityForAndroid\HideResponseTimerStatus]]).
	*If the system parameter (\\MobileLite\AgilityForAndroid\HideResponseTimerStatus) is BLANK, the Responded To status will be ‘ArrivedOnSite’.		*If the system parameter (\\MobileLite\AgilityForAndroid\HideResponseTimerStatus) is BLANK, the Responded To status will be ‘ArrivedOnSite’.
	*Job list can be sorted by Response Date.		*Job list can be sorted by Response Date.

---

Revision as of 07:36, 15 April 2016

Installing Agility for Android

Prerequisites and Installation

Android device requirements

• Supported android versions: 4.2 and above. Agility for Android works on much wider range of android versions, but at the moment supported are only versions mentioned above.
• Minimum screen resolution is HVGA (320x480 pixels), recommended resolution is WVGA (480x800 pixels)
• Minimum: 128MB RAM memory and 20MB of free storage.
• Agility for Android will work with any IP network connection (regardless of Physical Layer: GPRS, 3G, WIFI).

Preparing Android device

1.On home screen press menu button and select Settings

2.In the settings menu Tabs select “More…” and select “Security

3.In the Security menu, check Unknown Sources check-box:

4.In the message box, select OK.

Download and Installation

1. Click the version number or the aLite icon. The app will start downloading automatically.
2. When the download is complete slide down notification bar.
3. Tap on downloaded application file.
4. Follow instructions on the screen.

Configuration

Agility Configuration

Agility configuration file

<GeneralWebService

enabled="true"

.

.

.

/>

System parameters controlling Agility for Android

To enable Agility for Android functionality in Agility appropriate system parameter must be set. Go to System Configuration -> System Parameters. Open MobileLite folder and set MobileLiteMode value to true.

Other parameters allows customization of data presented on android from agility. System parameters allow also to control global upgrade of Agility for Android application on android devices (please refer Licensing And Software Update document for details).

System parameters for Agility for Android description:

• WarningDate

This parameter is used to turn countdown clock into warning state. Countdown timer color will turn orange if current time reach WarningDate.

• Alarm date

This parameter is used to turn countdown into alarm state. Countdown timer color will turn red if current time reach AlarmDate.

• Clock date

This parameter is used to control calculation of remaining time. In other words button in Agility for Android displays: NOW – ClockDate where NOW denotes current date and time.

• HtmlListDetails

• MobileLiteMode

• SortOrder

• TaskLocationDisplay

• Path: SYSTEMPARAMETERS\MobileLite\
• Name: TaskLocationDisplay
• Type: String
• Description: ‘This parameter will determine if the Location field on Job details on Agility for Android will be displayed as Asset Codes or Asset Descriptions. Possible values for this parameter are; CODE & DESCRIPTION.
• Default out of the box value: CODE.
• If the Parameter value is empty or any other value than Code/Description, the default will be to show Codes.

• TaskDescriptionVisibility

• Path: SYSTEMPARAMETERS\MobileLite\
• Name: TaskDescriptionVisibility
• Type: String
• Description: ‘This is a string expression parameter. The result value of the string expression will be TRUE/False, if the result is TRUE then the Task Description will be shown on the Job detail form, it will be hidden if the result is FALSE.’
• Default out of the box value: ‘TRUE’.
• If the Parameter value is empty then this will be same effect as TRUE value.

• FaultCodeVisibility

The Fault Group/Fault Code options have a visibility expression. Users can set the Fault Group/Fault Code option to be hidden by setting new ‘SYSTEMPARAMETERS\MobileLite\FaultCodeVisibility’ to false , however if the system parameter ‘SYSPARAM\ProcessMngt\MandatoryFaultOnWOCompletion’ is set to be true then the Fault Codes will always be VISIBLE regardless of the previous settings above.

• Path: SYSTEMPARAMETERS\MobileLite\
• Name: FaultCodeVisibility
• Type: Bool
• Description: ‘If the value is set to TRUE, the Fault Group/Code will be shown on Completion Task form, it will be hidden if the value is set to FALSE.
• Default out of the box value: ‘TRUE’
• If the Parameter value is empty or other than TRUE/FALSE then this will be same effect as TRUE value

• CompletionTypeVisibility

• Path: SYSTEMPARAMETERS\MobileLite\
• Name: CompletionTypeVisibility
• Type: Bool
• Description: ‘If the value is set to TRUE, the completion type will be shown on Completion Task form, it will be hidden if the value is set to FALSE.
• Default out of the box value: ‘TRUE’
• If the Parameter value is empty or other than TRUE/FALSE then this will be same effect as TRUE value

Set up labour for use with Agility for Android

The labour resource using Agility for Android software on the mobile device has to be configured as Mobile Lite user. Additionally, labour has to be paired with agility user profile. Once this is done, user should be able to login from mobile device (using agility user credentials).

Update Parameters

1. If export-import definitions need to be updated on the mobile device, “Update Mobile Parameters” button can be used to force definitions sending.

Using Agility for Android

Agility for Android is represented in a set of installed applications by the icon:

Once the icon is tapped, Agility for Android login screen will be presented.

Login screen

The screen below shows the layout of the Agility for Android login screen. Top text field is provided to enter Agility login name, the text field below should contain user’s password. Remember me option has been provided to allow storing user credentials to be prepopulated when the user logs into the application next time:

Jobs List

After successful login, Jobs list screen is presented to the user:

The icon on the left hand side of the job description, identifies current job status. It may be one of the following:

- New job has arrived and it has not been accepted yet

- Job has been accepted by the mobile device user

-Job has been suspended

- Mobile device user has departed to do the job

- Mobile device user has arrived on site to do the job

- Job has been completed

On the right of the icon, there is a job description which includes full job classification and additional information entered when the job was created.

On the top right corner, the figure is displayed representing time remaining until the job becomes overdue.

Tapping the description of the particular job will cause a detail screen for that job to be displayed. The layout and functionality of the details form is described in Job details section.

Form menu is located on the top-right corner of the form. Once the form menu icon is tapped, following options are displayed:

• Messages – Allows to filter job list
• Messages – directs to Messages forms, where message can be sent to Agility back office system, which are available for review using Labour resources -> Expert Messages form:

• Sort – allows to sort jobs list by start date, due date or select default sorting which can be configured by the Agility back office system
• Menu – expands window with more options and functions
• New Job – directs the system to the “New Job” form, which has been provided to support raising new job requests. The form is described in the next paragraph.
• Data view – allows to set visibility for completed and cancelled jobs.
• Issue/Return – directs the system to the “Issue/Return” form, which has been provided to support store movement requests.
• HD Request – directs the system to the “Help Desk Request” form, which has been provided to support raising help desk requests.

Job details

This form is displayed when particular job is tapped on the job list screen.

The screen is divided in to sections, where related information is displayed:

• Code – Job Code
• Due In/Overdue by – depending on the condition of the job being overdue or not, it displays the time remaining until the job becomes overdue or the time by which the job is already overdue.
• Status – current status of the job
• Location – placed below status information it summarises information about Dept/Ward, Room Number and the Asset against which the job has been raised.
• Section with key date information (Start/Latest Start/Due)
• Priority information
• Additional comments about the job
• Specific information regarding the task within the job
• Contact details of the person responsible for the job

Swipe Menu

Aditional functionalities can be accessed by swiping from left to right on Job Detail screen or by hiting menu button on top left corner.

Aditional functioanalities are:

• Checklists - Opens the “Checklist” form, allows to add checklist results for Main Asset. Displayed only if any checklist is attached.
• Feedback - Opens the “Feedback” form, allows to add comments and faults.
• Issue/Return - Opens the “Issue/Return” form.
• Follow-on Job - Opens the “Follow-on Job” form.
• Close - Close the Menu, also can be done by swiping from right to left.

Corresponding system parameters:

• TaskLocationDisplay
• TaskDescriptionVisibility

Job Status updates

Job status updates are performed on the details screen and are accessible using device’s menu button. After the button is pressed, the option to move the job to the next status will be displayed:

Only statuses, which are available to be accessed from the current status will be shown in the menu options displayed. In the example above, the job is currently Accepted, so there are 3 statuses available – Departed ,Suspended and Rejected

The last status in the flow is Completed status, which causes Job completion form to be displayed. Details of the form completion are described in the Job Completion section

Create/Attach Photo - Gallery

Create Photo

Once the job is completed, all photos done against the job will be transferred to back office and linked as job attachments.

Attach Photo

1. If you want attach photo for current job you should click icon “Attach” on form.

2. When you clicked icon “Attach photo”, you can see window how you can choose photo. If you want attach photo you will only click photo

3. If you attach photo you will see information about it.

Gallery

1. If you want see gallery for current job you should click icon “Gallery” on form

2. If you do not have any image you see information about it. If you want click icon delete images and you do not have images you will see information about it.

3. Gallery form have functionality: take a photo, attach a photo and delete photos

4. If your images will be deleted you will see information on white screen.

Job Completion

Separate form has been provided to gather all the information required during job completion process. Related information has been grouped in sections so the screen design is clearer for the user. Each section is separately explained below.

Job completion screen appears on the device once the status Completed is selected on the menu on the detail form. Once this option is selected, screen like on the right hand side below will be shown:

• Completion code: drop-down allowing to select appropriate completion code (fault code) for the job
• Response Failure Reason: when the job is overdue in relation to response KPI, this field will be presented to the user to specify the reason of KPI failure.
• Rectification Failure Reason: when the job is overdue in relation to rectification KPI, this field will be presented to the user to specify the reason of KPI failure.
• Additional information: depending on the job type and other factors, various additional attributes will be presented to be populated together with the job completion. The rules of the attributes set displayed are exactly the same as the rules used in the standard Agility job completion screen.

New Job

//TODO: change new AGV job to standard new job

Rules for data population are exactly as described for Agility system, described in AGV Request Release Notes document.

Once Submit Request button is tapped, new job request is created as shown on the right hand side screenshot above. Add New button can be used to create another AGV request. Using Back button on the device, the form might be closed to go back to Job List form.

Follow-on form

Note: This new functionality requires reinstallation of alite.apk or updating mobile parameters from Labour- >PDA tab. Follow-on form allow the user to raise a follow-on work order from the current job being worked on. The follow-on work order form will be initiated from within the current work order detail form and will be based on the existing ‘New Job’ form. The follow-on work order can be opened from the main job details on ‘Agility for Android’ and can be added against the main Asset/Equipment of the current Task or against any of the route sheet items attached to the current job.

Clicking on the ‘Follow-on Job’ button will open a new form for adding a new work order on Agility. The new added work order will be linked to the original job created from.

• The original JobCode will be auto populated on the new follow-on form. Greyed out and cannot be modified.
• The Asset code will be a drop-down list of the main Asset of Original work order and the Asset Codes of all route sheet items.
• The Asset Description field will be auto populated with the description of the selected Asset from the drop-down list.
• The generated follow-on job on Agility will be linked to the original job via the woJob.FollowOnID field.

All other fields will behave the same way as the ‘Add New Job’ form from the main menu on ‘Agility for Android’

Help Desk Request form

Help Desk Request form field’s description:

1. Scan Asset – Switches form between two states:
   1. 1st state allows user to pick asset from Equipment Dependency Structure.
   2. 2nd state allows user to enter Asset Code manually.
2. Site/Location/Sublocation/Asset – Lookups on Assets from pmAsset table.
   1. User permissions are taken into consideration.
   2. Only site is mandatory.
   3. Site is auto populated if user is allowed to only one site.
   4. Fields are hidden if ‘Scan Asset?’ switch is set to ‘Yes’.
3. Job Description – FullDescription field, free text, not mandatory. Changes height when long text is entered

Restrictions

1. Help Desk Request can be performed only if user is online.
2. Site/Location/Sublocation/Asset validation is performed instantly after value is changes, or focus changed.
3. Only site is mandatory.
4. The Helpdesk request can be raised against any level within the Asset structure, for example the user can select the SITE only, add description and submit, this will raise the Helpdesk against the selected Site. If the Site & Location are selected, the Helpdesk will be raised against the Location and so on.
5. The Job Type, Priority & Craft will default to as per the system parameter values, similar to the Agility Helpdesk form.
6. Every request have 10 second timeout. After that time error message is displayed and performing Help Desk Request action is not possible. If there is no connection, request is resend after 30 second.
7. If system parameter ‘ProcessMngt\AccountCodeEnabled’ is set to true, CostCode field is visible and mandatory. Otherwise field is hidden and not required.

Issue/Return form

Issue/return form fields description:

1. Select Action:
   1. Issue – allow to take items from stock
   2. Return – allow to return items back to stock
2. Action Against – determine with fields have to be entered:
   1. Work Order – Job Code and Job Task Code
   2. Equipment – Equipment and Job Type
   3. Cost Code – Cost Code.
3. Item Code – Code of an item i.e Fuse75Amp
4. Bin Location – List of available bins or message that there is no available bin.
5. Quantity – number of taken/returned items. Has to be greater than 0.
6. Job Code - Code of Work Order.
7. Job Task Code – List of available tasks.
8. Equipment – Code of Asset.
9. Job Type – List of job types.
10. Cost code – budget code the goods are issued against.

Restrictions

1. Issue/Return can be performed only if user is online.
2. W/O, Cost Code, Item validation is performed instantly after value is changes, or focus changed.
3. All displayed fields are mandatory.
4. Required System parameters :
   1. Inventory\Movement\CostCodesOnInventoryMovements
   2. Inventory\AllowNegativeStock
5. System parameter AllowNegativeStock can be set to true to allow taking an item from stock even if quantity of that item is lesser than 0.
6. Issue an item if AllowNegativeStock is set to false and quantity of that item is lesser than 0 is not possible.
7. Returning an item is always possible regardless of quantity level.
8. Every request have 10 second timeout. After that error msg is displayed and performing issue/return action is not possible.

Response Target

• The Response Target counter shows under the Due Date counter with relevant labeling to distinguish which is which.
• The Response Target Time counter should be hidden once the Task has been Responded To.
• The Task is Responded To when it reaches status specified in the system parameter (\\MobileLite\AgilityForAndroid\HideResponseTimerStatus).
• If the system parameter (\\MobileLite\AgilityForAndroid\HideResponseTimerStatus) is BLANK, the Responded To status will be ‘ArrivedOnSite’.
• Job list can be sorted by Response Date.
• If the system parameter (\\MobileLite\AgilityForAndroid\SecondTimerClockDate ) is BLANK, Second timer will be hidded on both list and details.
• In other functionalities Second timer is working in same way as Due Date Timer.