Oracle Mobile Workforce Cloud Service

Mobile Application Installation Guide for Oracle Utilities Mobile Workforce Management and Oracle Real-Time Scheduler,

Release 2.2.0.3

E58601-01

October 2015

Oracle Mobile Workforce Cloud Service Mobile Application Installation Guide Release 2.2.0.3

Copyright © 2000, 2015 Oracle and/or its affiliates. All rights reserved.

This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited.

The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to us in writing.

If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, then the following notice is applicable:

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs. No other rights are granted to the U.S. Government.

This software or hardware is developed for general use in a variety of information management applications. It is not developed or intended for use in any inherently dangerous applications, including applications that may create a risk of personal injury. If you use this software or hardware in dangerous applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure its safe use. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software or hardware in dangerous applications.

Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.

Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc. AMD, Opteron, the AMD logo, and the AMD Opteron logo are trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registered trademark of The Open Group.

This software or hardware and documentation may provide access to or information about content, products, and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products, and services unless otherwise set forth in an applicable agreement between you and Oracle. Oracle Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of third-party content, products, or services, except as set forth in an applicable agreement between you and Oracle.

Installing the Mobile Client

This chapter describes how to install the mobile client for Oracle Utilities Mobile Workforce Managementor Oracle Real-Time Scheduleron the Oracle Cloud. It is intended for implementers and system administrators responsible for configuration and initial setup of the mobile application.

This chapter includes:

•

Installing the Mobile Client on Windows

•

Installing the Mobile Client on Android

Installing the Mobile Client on Windows

This section describes how to install the mobile client runtime on Windows platforms. This section includes:

•

Installing on Windows 7

•

Installing on Windows Embedded

•

Mobile Device Registration

•

Uninstalling the Mobile Client

Installing on Windows 7

1.

Extract OracleMWM.msi from ORS-V2.2.0.0.0-Mobile-Client-Win.zip and copy it to a temporary directory.

2.

Double click the OracleMWM.msi file to start the installation process.

3.

Click Next to proceed with the installation of Oracle Utilities Mobile Workforce Management 2.2.0.0 Mobile Client on your machine.

4.

Select a folder/hard drive location to install the application to.

5.

Click Next to proceed with the installation.

6.

Click Close after the installation is successful.

The mobile client application is now accessible from shortcuts created on the Desktop or Start Menu.

Installing on Windows Embedded

Note : The operating system version supported by the mobile client is Windows Embedded Handheld 6.5 Professional.

1.

Extract OracleMWM.CAB from ORS-V2.2.0.0.0-Mobile-Client-WinMobile.zip and copy it to a temporary directory on the mobile device.

2.

Tap the OracleMWM.CAB file to start the installation process.

3.

If prompted, select Device as the location to be installed.

4.

Click Close after the installation is successful.

5.

After completing the MCP installation, delete the CAB file (OracleMWM.CAB) and reboot the mobile device.The mobile client application is now accessible from shortcuts created on the Start > Programs menu.

Mobile Device Registration

The mobile device needs to be registered with the Oracle Utilities Mobile Workforce Managementor Oracle Real-Time Scheduler application server before it can start using the application features. Ensure that the Oracle Utilities Mobile Workforce Managementor Oracle Real-Time Scheduler application is installed and running before registering the mobile device.

Please refer to the Mobile Application User Guide for the steps to register a device with the server.

Uninstalling the Mobile Client

Follow these procedures to remove the mobile client from Windows 7.

Uninstalling from Windows 7

1.

Ensure that all the data is synchronized on the server.

2.

Go to Start Menu -> Control Panel.

3.

Open Add or Remove Programs.

4.

Select Oracle Utilities Mobile Workforce Management 2.2.0.0 from the programs list and click Remove.

5.

Click Yes to confirm the removal of the mobile client.

6.

Click Close after the mobile client has been removed.

Uninstalling from Windows Embedded

1.

Ensure that all the data is synchronized on the server.

2.

Go to Start Menu -> Settings -> System tab

3.

Open Remove Programs.

4.

Select Oracle Utilities Mobile Workforce Management 2.2.0.0 from the programs list and click Remove.

5.

Click Yes to confirm the removal of the mobile client.

6.

Click Close after the mobile client has been removed.

Installing the Mobile Client on Android

This section describes how to install the Android Mobile Client Platform (Android MCP). It is intended for implementers and system administrators responsible for configuration and initial setup of the mobile application. This section includes:

•

Overview of the Android MCP

•

Installing the Android MCP

•

Launching Android MCP

•

Launching Android MCP Tools

•

Uninstalling Android MCP

Overview of the Android MCP

Android MCP provides the same runtime functionality as the Windows Embedded MCP. This functionality includes:

•

RSI: Communication between the device and the server

•

GPS: GPS services such as location logging and transferring logs to the server

•

BO Processing: Business Object Functionality

•

BS Processing: Business Service Functionality

•

SS Processing: Service Script Functionality

•

Authentication: Login processing

•

UI Rendering: User Interface Processing

•

Logging: Log File Support

There may be differences in UI layout or JavaScript support due to the different browser component provided by the Android platform. There will also be normal differences in the user interface behavior that are specific to Android applications.

Installing the Android MCP

The Android MCP is delivered as a standard Android APK file. This APK will need to be installed to the Android device in one of the following ways.

•

Using SD Card

•

Downloading the file from a hosted web server

•

Using device management software for Android

•

Using Android SDK (Advanced only)

This section describes the SD Card method only.

Note: You should uninstall previous versions of the Android MCP before installing a new version.

Installing the MCP Using the SD Card Method

To Install the Android Mcp Using the Sd Card Method

1.

Extract OracleMWM.apk from the ORS-V2.2.0.0.0-Mobile-Client-Android.zip file and copy it to a temporary directory.

2.

Connect the Android device to a desktop or laptop computer as a Media Drive.

3.

Copy the OracleMWM.apk file to the removable disk (select My Computer for the drive letter).

4.

Disconnect the device from the desktop or laptop, or choose the Charge only connection type.

5.

Verify that non-Market applications can be installed.

Open Settings -> Applications and select Unknown sources.

6.

Use a file explorer on the device such as ASTRO or File Expert (which can be downloaded from Android Market) to locate the APK file on the SD card. Launch the file.

7.

Confirm the installation by clicking Install.

8.

The application will now be installed.

9.

After the application is installed, click Done.

Launching Android MCP

To Launch the Android MCP on Your Device

1.

Under All apps, locate the Oracle MWM icon.

2.

Launch the application to register the device and download a deployment.

Note: Ensure that your device has data or WIFI connectivity.

Launching Android MCP Tools

The MCP Tools application provides functionality to import and export the MCP data folder to and from the SD card on the Android device. This can be very useful in debugging issues or for loading test data to the device.

To Launch the Android MCP Tools Application on Your Device

1.

Under All apps, locate the Oracle MWM Tools icon.

2.

Launch the application to access import and export functionality.

•

Export Data exports the application’s data folder to SD Card.

•

Import Data imports data from SD card’s /MWMApp/ folder into the application’s data folder.

Uninstalling Android MCP

To Uninstall the Android MCP

1.

Open Settings, Applications, Manage Applications and click the Oracle MWM application.

2.

Click Uninstall to remove Android MCP from your device. Do not select Clear data.