Service Optimization

Android PhoneGap

Product ClickApp by ClickSoftware
For use with ClickMobile Touch

ClickSoftware Confidential


[DO NOT DELETE THIS NOTE: The following Legal Notice paragraph is formatted in white. It is invisible in the book and PDF editions, but it is converted to black in the online help.]

Legal Notice

The software with this guide is furnished under a license agreement and may be used only according to the terms of that agreement.

Copyright

Copyright © ClickSoftware Technologies Ltd. All rights reserved.

No part of this publication may be copied without the express written permission of ClickSoftware Technologies Ltd.

Patent and Trademark

US Patent Number 6,985,872 B2

ClickAnalyze, ClickFix, ClickForecast, ClickMobile, ClickPlan, ClickRoster, ClickSchedule, and ClickSoftware are registered trademarks of ClickSoftware Technologies Ltd.

Contact Information

Contact information is available from the ClickSoftware web site: http://www.clicksoftware.com.

For general information, email to .

For ClickSoftware Worldwide Support, email to or see the support page on the ClickSoftware web site.

For Partner Enablement, email to .

Publication Notice

This guide has been carefully compiled. The information in this guide does not constitute a warranty of performance. Furthermore, ClickSoftware reserves the right to revise this publication and make changes from time to time in the content thereof, without obligation to notify any person of such revisions or changes. ClickSoftware assumes no liability for losses incurred as a result of out-of-date or incorrect information in this guide.

Version

Android PhoneGap
App number: 1162
App version: 30
Date: November 2013


Android PhoneGap 3

Contents

Android PhoneGap 4

Use 5

Opening ClickMobile 5

Prerequisites 7

Installation 7

Configuration 7

Technical Information 8

Customizing the App 8

Comments 8


Android PhoneGap 7

Android PhoneGap

This app enables Android users to access ClickMobile Touch conveniently. The app is required if you configure ClickMobile to use the push-notification and file-attachment features.

Use

This app enables you to launch ClickMobile Touch quickly. The app connects to the ClickMobile website.

The app enables the following ClickMobile features:

Push notifications

This feature enables the Service Optimization server to wake up the mobile device from sleep or power-save mode. It helps ensure that you do not miss important updates while the device is sleeping.

File attachments

This feature enables you to attach a photo to a task, to receive diagrams or instructions with a task, or to upload and download other file types.

If the system implementer has configured either of these features, the app is required. If the system implementer has not configured the features, the app is optional.

If you do not install the app, you can still access ClickMobile by browsing to the website. The push notifications and the file attachments are unavailable.

Opening ClickMobile

1. On the Android mobile device, tap the ClickMobile icon:

2. If this is the first time you are have opened ClickMobile, the app prompts you to enter the URL of the ClickMobile Touch website.

If the prompt is not displayed, press the Menu button or swipe two fingers upward. This opens the app settings, where you can verify or change the URL.

When you close and return to ClickMobile, the app remembers the setting. You do not have to enter the URL again, unless it changes.

3. At the prompt, log on and use ClickMobile as described in the ClickMobile Touch User's Guide.

Prerequisites

The app runs with ClickMobile Touch on Android devices.

Note: If you integrate ClickMobile Touch with IBM Worklight, do not install the Android PhoneGap app. Instead, install the ClickMobile app for Worklight.

Installation

You can deploy the app to the users in one of the following ways:

· You can send the file by email, or provide a download link to the file. The file has a name such as ClickMobileTouch.apk. Instruct the users to download the app from the URL.

· Instruct the users to download the app from the Google Play store (https://play.google.com/store). In the store, the app is called ClickMobile. The users must log on to a Google account.

· If you use a Mobile Device Management (MDM) system, the system administrator can deploy the app on the mobile devices, without user intervention.

Be sure to deploy the app version that is certified for your organization's ClickMobile version. If the organization upgrades to a new ClickMobile version or service pack, verify on the ClickSoftware AppStore whether you need a new version of the app.

You must tell the users the URL of the ClickMobile Touch website, which is located on the ClickMobile middle tier. The URL has the form:

http://middle-tier-host/ClickMobileWEB/Default.aspx

When the user first opens the app, it prompts for this URL.

Configuration

The app itself requires no configuration.

To make the push-notification and file-attachment features available, you must configure them in the Mobility Studio. For instructions, see the ClickMobile Touch chapter of the ClickMobile Configuration Guide.

Technical Information

PhoneGap is an open-source platform for mobile applications (http://phonegap.com). ClickMobile uses PhoneGap services to implement the push-notification and file-attachment features. To enable these features, the users must install a PhoneGap native container on the mobile devices. The Android PhoneGap app is the native container for ClickMobile Touch on Android devices.

There is another version of this app, called iOS PhoneGap, for iOS devices. The app is not required if you use ClickMobile Touch on Windows computers.

Customizing the App

ClickSoftware provides the app with source code. Optionally, you can customize and recompile the code. For example, you can insert a predefined ClickMobile middle-tier URL, so the users do not have to set the URL themselves.

For more information about customization, contact ClickSoftware Worldwide Support.

Comments

The ClickMobile appearance is configurable. The layout might differ on your device.