Revision as of 07:17, 13 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

Before installation, android device has to allow installation of applications from unknown sources. The process below describes all actions that need to be done to achieve that:

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

WARNING please ensure that IIS server of agility service have proper MIME-type for .apk files. Please follow IIS documentation and update MIME-types with application/vnd.android.package-archive for apk files!

On android device open web browser and type url of AliteUpdate.aspx web page. url to this page is relative to agility system url: http://agility.service.url/Services/AliteUpdate.aspx

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

Configuration

1.Run aLite application, press menu button and press Configuration button.

2.From configuration options select System Url. In text box type appropriate URL to agility system

3.You can additionally setup desired notification options

4.Back to login screen, and you can login into system with provided credentials.

Agility Configuration

Agility needs to be configured to use Agility for Android software. The section below describes all necessary steps to do so.

Agility configuration file

Agility for Android uses general interface stack to communicate with Agility. General interface must be enabled in configuration file in order to Agility for Android communication to work:

<GeneralWebService

enabled="true"

.

/>

GeneralWebService is a subsection of interface section in agility configuration xml. Mandatory option for this section is: enabled ="true". Other options are internal interface parameters and should not be altered from the default values already present in the file.

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.

Picture 1 System parameters example

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

Parameter contains string expression to calculate Html List Item in Agility for Android.

MobileLiteMode

If this parameter is set to true than communication with Agility for Android software is enabled.

SortOrder

Parameter contains string expression to calculate integer value for Default sorting option when it is selected on the jobs list screen using sort icon (string expression result must represent integer value)

TaskLocationDisplay

The Location field can be either Site Code/Location Code/SubLocation Code OR Site Description/Location Description/ SubLocation Description. This is determined by a new system parameter where the default value of the parameter will show CODES not descriptions. The Parameter details are:

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

The Task description visibility is controlled by jobType= ‘PPM’ and a new system parameter ‘ShowTaskDescription’. This system parameter is a string expression value andthe Task description will show if the parameter returns TRUE value, the default value for this parameter is ‘TRUE’:

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.

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.

New Job

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

New job request can be raised using “New Job” menu entry as described in the point above. The form layout is as shown on the screenshot below:

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.

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

Corresponding system parameters:

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 suspended, so there are 2 statuses available – Departed or Arrived

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

If you wish to create a photo in the context of the current job, “Camera” icon can be used on the top of job details screen:

:

Next step is take photo by camera. If you want save your image, you should click button “Save”, if not - click “Discard” button.

If any photos are saved against the job, additional information icon is displayed on the job list form.

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.

Once all the information are populated, Completed Job button may be used to finalize the completion process.

@@ Line 221: / Line 221: @@
 <div style="margin-left:0.5in;margin-right:0in;">Parameter contains string expression to calculate integer value for '''Default '''sorting''' '''option when it is selected on the jobs list screen using sort icon (string expression result must represent integer value)</div>
 *'''TaskLocationDisplay'''
-<div style="margin-left:0.5in;margin-right:0in;">The Location field can be either Site Code/Location Code/SubLocation Code OR Site Description/Location Description/ SubLocation Description. This is determined by a new system parameter where the default value of the parameter will show CODES not descriptions. The Parameter details are:</div>
+<div style="margin-left:0.5in;margin-right:0in;">The Location field can be either Site Code/Location Code/SubLocation Code OR Site Description/Location Description/ SubLocation Description.
+This is determined by a new system parameter where the default value of the parameter will show CODES not descriptions. The Parameter details are:</div>
 * <span style="color:#000000;">Path: SYSTEMPARAMETERS\MobileLite\</span>
@@ Line 237: / Line 240: @@
-<div style="margin-left:0.5in;margin-right:0in;">The Task description visibility is controlled by jobType= ‘PPM’ and a new system parameter ‘ShowTaskDescription’. This system parameter is a string expression value and </span><span style="color:#000000;">the Task description will show if the parameter returns TRUE value, the default value for this parameter is ‘TRUE’:</div>
+<div style="margin-left:0.5in;margin-right:0in;">The Task description visibility is controlled by jobType= ‘PPM’ and a new system parameter ‘ShowTaskDescription’. This system parameter is a string expression value and<span style="color:#000000;">the Task description will show if the parameter returns TRUE value, the default value for this parameter is ‘TRUE’:</span></div>
 * <span style="color:#000000;">Path: SYSTEMPARAMETERS\MobileLite\</span>
 * <span style="color:#000000;">Name: TaskDescriptionVisibility</span>

Difference between revisions of "Agility for Android"