Sup Sample Mobile Workflow Employee Directory

Sample: Mobile Workflow EmployeeDirectory

Sybase Unwired Platform 2.0ESD #1

DOCUMENT ID: DC01644-01-0201-02LAST REVISED: August 2011Copyright © 2011 by Sybase, Inc. All rights reserved.This publication pertains to Sybase software and to any subsequent release until otherwise indicated in new editions ortechnical notes. Information in this document is subject to change without notice. The software described herein is furnishedunder a license agreement, and it may be used or copied only in accordance with the terms of that agreement.To order additional documents, U.S. and Canadian customers should call Customer Fulfillment at (800) 685-8225, fax (617)229-9845.Customers in other countries with a U.S. license agreement may contact Customer Fulfillment via the above fax number. Allother international customers should contact their Sybase subsidiary or local distributor. Upgrades are provided only atregularly scheduled software release dates. No part of this publication may be reproduced, transmitted, or translated in anyform or by any means, electronic, mechanical, manual, optical, or otherwise, without the prior written permission of Sybase,Inc.Sybase trademarks can be viewed at the Sybase trademarks page at http://www.sybase.com/detail?id=1011207. Sybase andthe marks listed are trademarks of Sybase, Inc. ® indicates registration in the United States of America.SAP and other SAP products and services mentioned herein as well as their respective logos are trademarks or registeredtrademarks of SAP AG in Germany and in several other countries all over the world.Java and all Java-based marks are trademarks or registered trademarks of Sun Microsystems, Inc. in the U.S. and othercountries.Unicode and the Unicode Logo are registered trademarks of Unicode, Inc.All other company and product names mentioned may be trademarks of the respective companies with which they areassociated.Use, duplication, or disclosure by the government is subject to the restrictions set forth in subparagraph (c)(1)(ii) of DFARS52.227-7013 for the DOD and as set forth in FAR 52.227-19(a)-(d) for civilian agencies.Sybase, Inc., One Sybase Drive, Dublin, CA 94568.

http://www.sybase.com/detail?id=1011207

Contents

Context Summary ..................................................................1Usage Scenario ......................................................................3Get Started .............................................................................5

Prerequisites ...................................................................5Registering the Device in Sybase Control Center ..........6Importing the Sample .....................................................7Working with the Sample Project ....................................9Exploring the Database ..................................................9Exploring MBOs ............................................................10

Mobile Business Objects .....................................10The Mobile Application Diagram ..........................11

Exploring the Mobile Workflow Interface Design ..........12The Mobile Workflow Forms Editor ......................12

Try It Out ...............................................................................15Deploying the Sample MBOs to Unwired Server ..........15Installing the Mobile Workflow Package .......................16

Installing the Mobile Workflow Container on theiOS Simulator ..................................................17

Configuring the BlackBerry Simulator for MobileWorkflow Packages .........................................18

Configuring the Android Emulator for MobileWorkflow Packages .........................................19

Installing Sybase Messaging Runtime onWindows Mobile ..............................................20

Generating Code for a Mobile WorkflowPackage ...........................................................23

Running the Sample on an iOS Simulator ....................25Running the Sample on a BlackBerry Simulator ...........31Running the Sample on an Android Emulator ..............33Running the Sample on a Windows Mobile Emulator ...37Additional Modifications ................................................39

Sample: Mobile Workflow Employee Directory iii

Learn More ...........................................................................45Related Reference ........................................................45

Project Artifact Reference ....................................45Troubleshooting Mobile Device Connectivity

Issues ..............................................................46Learn More about Sybase Unwired Platform ................47Getting Help ..................................................................48

Index ..................................................................................49

Contents

iv Sybase Unwired Platform

Context Summary

Use the Sybase® Mobile Workflow Employee Directory sample to explore artifacts and theresulting mobile workflow package, the development environment, and the underlyingcomponents.

The Employee Directory sample is a mobile workflow. It is a secure mobile application that isaccessible from a supported smartphone. From their mobile devices, employees can use theEmployee Directory to:

• Search for an employee by first name, last name, phone number, or department name.• Navigate the organizational hierarchy (by manager and direct reports).• Create an employee favorites list. Employees can be added or removed from this list.• Initiate a phone call, open e-mail messages, or open a Google map of the employee’s office

location.• Sign up for notification of new hires or departures.

The Employee Directory sample is based on a development environment that uses:

• Sybase Unwired Platform• Sybase Unwired Workspace, an Eclipse development environment• Mobile Workflow device development• The iOS, Android, BlackBerry, and Windows Mobile device platforms

Using this sample provides a comprehensive preview of the benefits Unwired Platform canoffer. To learn how to create a mobile workflow package, see Tutorial: Mobile WorkflowPackage Development.

Next steps

1. Review the Usage Scenario on page 3, which explores the business context and use casefor the sample.

2. Follow the setup process in Get Started on page 5 to install and prepare artifacts in theEclipse edition of Unwired Platform.

3. Test functionality and features as described in Try It Out on page 15.

Context Summary

Sample: Mobile Workflow Employee Directory 1

Context Summary

2 Sybase Unwired Platform

Usage Scenario

A company provides its employees with a mobile workflow for their mobile devices thatallows them to use the company directory remotely.

Business requirements for the company include:

• Provide access to enterprise data sources – by supporting remote access to the employeedirectory, company employees can quickly communicate with their colleagues andunderstand with whom they need to interact.

• Reduced maintenance and more simplicity – the mobile workflow package must easilydeploy with little or no employee intervention. The employee user base does not want tospend time troubleshooting or self-supporting.

• Secure transactions – the employee (with credentials stored on an LDAP server) must beauthenticated, and secure transmission of confidential internal data across the wirelessnetwork ensured.

Next: Get Started on page 5 shows you how to set up the sample on your computer.

Usage Scenario


Usage Scenario


Get Started

You must complete the setup tasks before you can use the Employee Directory sample.

1. Review the Prerequisites on page 5.2. Bring all artifacts into the Unwired Platform development environment for Eclipse. See

Importing the Sample on page 7.3. Open connections to the servers that this sample depends on. See Working with the Sample

Project on page 9.4. In the sampledb database, explore the existing tables that are the foundation for the mobile

workflow package. See Exploring the Database on page 9.5. Explore the mobile business objects (MBOs) that perform operations against tables in the

sampledb database. See Exploring MBOs on page 10.6. Review the mobile workflow form interface design in the Mobile Workflow Forms Editor.

The design of the interface correlates to the MBOs that perform database operations. SeeExploring the Mobile Workflow Interface Design on page 12.

PrerequisitesBefore you begin importing and setting up the sample, review and complete the prerequisites.

• Install Unwired Platform.• For Windows Mobile, install:

• Windows Mobile emulator (or have access to an actual device)• Windows Mobile 6.0, 6.1, or 6.5 SDK• Active Sync 4.5• .NET Compact Framework 3.5

• For Blackberry, install:• BlackBerry JDE 6.0, which includes the BlackBerry 6.0 simulator and MDS. For more

information on configuring the BlackBerry Development Environment, see DeveloperGuide for BlackBerry.

Note: Sybase Mobile Workflow also supports BlackBerry JDE 5.0.

• For Android, install:• SDK Platform Android 2.2 and higher, or 3.0• Android SDK Platform-tools• Android SDK tools

• For iOS, install:• iOS simulator (or have access to an actual device)• Xcode 4 (MacBook or iMac) with iOS SDK 4.2.x, or 4.3

Get Started


Note: If you are using a different version, some steps may differ.

• Start the simulator or connect the device.• Start Unwired Server:

In Windows, select Start > Programs > Sybase > Unwired Platform > Start UnwiredPlatform Services.

• Start Sybase Control Center:In Windows, select Start > Programs > Sybase > Sybase Control Center.

• Log in using:User ID : supAdminPassword: s3pAdmin

Note: This was tested and verified using the versions indicated above. If you are using adifferent version, some steps may differ.

Registering the Device in Sybase Control CenterUse Sybase Control Center to register the device.

PrerequisitesYou must be connected to Sybase Control Center.

Task

1. Log in to Sybase Control Center using the supAdmin/s3pAdmin user name and password.

2. In Sybase Control Center, select View > Select > Unwired Server Cluster ManagementView.

3. In the left pane, select Device Users.

4. In the right pane, click Devices.

5. Click Register.

6. In the Register Device window, enter the required information:

• User name – enter a user name, such as user1.• Server name – the DNS name or IP address of the primary Unwired Server, such as

"myserver.mycompany.com". If using Relay Server, the server name is the IP addressor fully qualified name of the Relay Server host.

• Port – the port used for messaging connections between the device and UnwiredServer. If using Relay Server, this is the Relay Server port. Default: 5001

• Farm ID – a string associated with the Relay Server farm ID. Can contain only letters A– Z (uppercase or lowercase), numbers 0 – 9, or a combination of both. Default: 0

• Activation code length – the number of characters in the activation code. If you arereregistering or cloning a device, this value cannot be changed.

Get Started


• Activation expiration (hours) – the number of hours the activation code is valid.• (Optional) Select the check box adjacent to Activation Code to enter the code sent to

the user in the activation e-mail. This value can contain letters A – Z (uppercase orlowercase), numbers 0 – 9, or a combination of both. Acceptable range: 1 to 10characters.

Note: <server_name> should be the actual name of your machine.

Importing the SampleImport the sample project archived in EmpDir2_0.zip into Sybase Unwired Platform.

1. Start Unwired WorkSpace and choose your workspace by clicking Start > Programs >Sybase > Unwired Platform > Unwired WorkSpace.

Ensure that the Mobile Development Perspective is open.

2. Import EmpDir2_0.zip.

a) Click File > Import.b) In the Import wizard, select General > Existing Projects into Workspace and click

Next.

Get Started


c) Choose Select archive file and browse to the location where you savedEmpDir2_0.zip.

d) Click Finish to import the artifacts in the archive as a project.

3. Right-click the EmpDir project and select Open in Diagram Editor.

Ensure that the advanced developer profile is selected.

4. Copy the empDirImages folder from the Workspace Navigator to C:\.

5. Start the sample database by executing <UnwiredPlatform_InstallDir>\UnwiredPlatform\Servers\UnwiredServer\bin\sampledb.bat start from the command line.

6. In the Enterprise Explorer, create an ASA connection profile and connect to sampledbby following these steps:

a) In Enterprise Explorer, right-click the Database Connections folder and selectNew.

b) In New Connection Profile, select Sybase ASA as the connection profile type, inName, enter sampledeb, and click Next.

c) In Drivers, select ASA v 11.x for Unwired Server Default, and configure theseconnection properties:

Property Value

Host The default is localhost.

Port 5500

Database name sampledb

User name Use the default, dba.

Password Use the default, sql.

Save password Select this option.

When you are finished, click Test Connection.d) Click OK in the Ping Succeeded window.e) Click Finish.

A sampledb database connection profile is added.

This new profile should resolve any connection profiles errors you received when youimported the EmpDir project. If it does not, ping the server to see whether or not it isavailable.

7. Right-click the empDir.sql file, then select Execute SQL Files.

Provide values for the database server type, connection profile name, and database name.

8. Right-click the EmpDir project and select Deploy Project.

9. Select Message-based.

Get Started


For more information, see the section called Install and Configure the Mobile WorkflowContainer On the Device in Developer Guide for Mobile Workflow Packages.

10. Configure the Sybase Settings on the device for the newly created user.

11. In the Sybase Control Center, click Refresh and ensure that the status for the registereduser is Online.

12. Right-click EmpDir.xbw and select Generate Mobile Workflow Package.

13. On the device, open Workflow (for iOS) or go to the Inbox (for BlackBerry or WindowsMobile) and choose Workflows, then select the workflow named Empdir.

Working with the Sample ProjectOnce you have imported the sample and started the EmpDir database server, you can browseartifacts and open required server connections.

1. In WorkSpace Navigator, expand the EmpDir folder to view the project artifacts.

Project artifacts are contained in the Mobile Business Objects and Deployment folders.

2. Connect to the Unwired Server:

a) In Enterprise Explorer, expand the Unwired Server folder.b) Right-click the My Unwired Server icon and choose Connect.

When you connect to the server, a complete set of administrable elements appear belowthe server icon.

Exploring the DatabaseIf you have started and connected to the database, you can now explore its structure anddesign.

The tables have been explicitly designed for this sample. By understanding the structure of thedatabase, you can better understand how the business logic programmed into the mobileworkflow works with the database.

1. In Enterprise Explorer, expand Database Connections > sampledb > sampledb.

2. To browse the tables used by the mobile application, expand Tables.

Expand each table of interest, such as Emps or EmpFavorites, to review the table design foreach (columns, keys, constraints, and so on).

Get Started


Exploring MBOsReview the existing attributes and operations for mobile business objects, and explore howMBOs are bound to the EmpDir table as their back-end data source.

1. In WorkSpace Navigator, expand the EmpDir > Mobile Business Objects folder to viewthe MBOs created for this sample (EmpFavorites, Emps, and ListEmpFavorites).

EmpFavorites and Emps match two of the table names in sampledb.

2. To see the MBOs and understand the business logic behind them, right-click any MBO andselect Open in Diagram Editor.

Mobile Business ObjectsMobile business objects form the business logic for mobile applications and workflows.

A mobile business object (MBO) is derived from a data source (database server, Web Service,SAP® server, and so on). MBOs form the business logic for mobile workflows that can bedeployed to an Unwired Server and referenced in mobile devices (clients). MBOs include:

• Implementation-level details – read-only metadata columns that include informationabout the data in the implementation.

• Abstract-level details – attributes correspond to class-level properties on the mobile clientand map to columns. Parameters correspond to synchronization parameters on the mobileclient and map to arguments. MBOs can also contain operations, which themselvescontain parameters and arguments, and can be used to update, create, or delete data. Fornative applications a database runs on the mobile device. When users makes changes,those changes only apply to their local copy of the data. When a sync happens, the changesare sent to the Sybase Unwired Platform server and changes in the actual enterprisedatabase are sent to the mobile device. With Mobile Workflow, even though the userexchanges data with the server, there is no client-side store that is synchronized with theserver's consolidated database.

• Relationships – defined between MBOs, link attributes, and parameters in one MBO toattributes and parameters in another MBO.

You can define MBOs using either a top-down approach – designing attributes and parametersfirst, and later binding them to a data source, or a bottom-up approach – specifying a datasource, and automatically generating attributes and parameters from it.

A mobile application includes MBOs, as well as role and server mappings, and other artifactsthat are delivered to the Unwired Server during deployment.

Get Started


The Mobile Application DiagramEach mobile application project has an associated Mobile Application Diagram that providesa graphical representation of all mobile business objects (MBOs) within the project.

The Mobile Application Diagram is not only a static graphical representation of MBOs. Youcan copy and paste existing objects, create a new object, or even define data sources for MBOsthat are not yet bound to an enterprise data source. However, the application diagram used inthis sample is complete as provided.

For a larger project, you might want to create a filter to view only selected MBOs – either byexplicitly selecting the MBOs, or by creating a logical group. To explore this functionality,open the Unwired Platform online documentation and click Sybase Unwired WorkSpace -Mobile Business Object Development > Develop > Working with Mobile Business Objects >Mobile Business Object General Properties > Managing Mobile Application DiagramFilters and Logical Groups.

What the Mobile Application Diagram ShowsThe diagram shows the different objects and how they are related to each other :

• Emps MBO – represents employee information.• EmpFavorites MBO – represents a list of commonly contacted employees.• ListEmpFavorites MBO – represents a listing of an employee's favorites.

Get Started


Exploring the Mobile Workflow Interface DesignUse the Mobile Workflow Forms Editor to explore the mobile workflow package.

Business logic is not stored in the mobile workflow package. Instead, the mobile workflowpackage relies on the MBOs that are deployed to the Unwired Server to provide the businesslogic. The separation of the workflow interface from the processing and logic componentskeeps the workflow compact and makes more efficient use of the client device’s battery.

1. In WorkSpace Navigator, double-click empDir.xbw.

2. Click the Flow Design tab to explore the flow of all existing screens.

You can also see each individual screen by selecting it, then clicking the Screen Designtab.

The Mobile Workflow Forms EditorThe Mobile Workflow Forms Editor consists of views and pages that allow you to model theinterface of the device screens.

The Mobile Workflow Forms Editor has drag-and-drop functionality, which allows you todrag and drop mobile business objects onto the Flow Design page. You can also drag and dropmobile business object operations onto the Flow Design page. The Mobile Workflow FormsEditor contains three pages:

• IntroductionCreating a new custom device workflow, or double-clicking an existing one, opens theIntroduction section of the Mobile Workflow Forms Editor. This page is the starting pointfor designing your custom device mobile workflow. You can access help and launchtutorials from this page.

• Flow DesignUse this page to specify the manner in which screens link together. You can then linkspecific screens and actions to a mobile business object on a server. The Palette view showsavailable screens and connections.The Flow Design page displays an empty canvas with the Palette to the right, which showsthe available screens and connections. You can drag and drop items from the Palette to thecanvas. Screens that you drag to the Flow Design canvas are displayed as icons and showthe connection lines between them. Dragging a new screen into this page starts a newscreen. Double-clicking a screen opens the Screen Design page.Right-clicking anywhere in the Flow Design page displays a context menu.

• Screen DesignUse this page to design the screen of your custom device mobile workflow. The Paletteview shows the menu and controls you can use to design a new screen. Drag controls todesign the user interface on the device screen.

Get Started


The Device Workflow toolbar includes a list of existing screens. You can open a differentscreen by selecting the corresponding screen name from the list.

Get Started


Get Started


Try It Out

Deploy the sample MBOs, register device users, and run the sample on a device simulator.

Now that you have set up your sample project and understand the MBOs that are used, you candeploy those MBOs to Sybase Unwired Server and run the sample on a device simulator.

You can install a device simulator, then run the mobile workflow application on it. In thesections that follow you will be able to see basic usage of the Workflow application.

In addition, you will learn how to apply optional modifications to the sample, including thelook and feel on the device, the device cache, adding a confirmation dialog, and debugging.

Deploying the Sample MBOs to Unwired ServerDeploy the sample to the Unwired Server to make the MBO logic available to the userinterface (empDir.xbw).

PrerequisitesEnsure you are connected to an Unwired Server.

Task

There are multiple techniques you can use to deploy the mobile application. This sampledocuments how to deploy the sample from the project. For information on the other options,open the Unwired Platform online help and click Sybase Unwired WorkSpace - MobileBusiness Object Development > Develop > Packaging and Deploying Mobile BusinessObjects.

Note: Skip this section if you have already implemented the steps in Get Started > Setting Upthe Sample.

1. Right-click the EmpDir project and select Deploy Project.

Accept the defaults for the deploy mode, target version, and package name.

2. Select Message-based, and click Next.

Try It Out


3. Select all boxes to deploy all MBOs and click Next.

4. (Optional) In the Packager User-defined Classes window, click Next.This window is only seen if you are using the Advanced Developer Profile.

5. Select My Unwired Server and click Connect.

6. Accept the defaults for Domain and Security configuration, and click Next.

7. If you are using the Advanced profile, map the connection profile for sampledb to theServer connection profile of the same name.

a) From Server Connection, select New Server Connection.b) Accept the defaults and click OK. This mapping process creates a named endpoint to

the correct server that gives you access to the systems you require.

8. Click Finish to deploy the package to the Unwired Server.

Installing the Mobile Workflow PackageConfigure the emulator or simulator, install the Mobile Workflow package, and generate theMobile Workflow package files.

Try It Out


Installing the Mobile Workflow Container on the iOS SimulatorThe Workflow Container referenced in this procedure is a sample container. You can use theprovided source code in Xcode to build your own customized user interface and configureother resources.

Prerequisites

• Register the device in Sybase Control Center• Xcode 4 (MacBook or iMac) with iOS SDK 4.2.x

Task

1. From your Mac, connect to the Microsoft Windows machine where Sybase UnwiredPlatform is installed:

a) From the Apple menu, select Go > Connect to Server.b) Enter the name or IP address of the machine, for example, smb://<machine DNS

name> or smb://<IP Address>.

You see the shared directory.

2. Copy the MobileWorkflow-2.0.1.tar.gz from your Sybase Unwired Platforminstallation <UnwiredPlatform_InstallDir>\UnwiredPlatform\ClientAPI\Workflow\ios to a location on your Mac:

3. Unarchive the MobileWorkflow-2.0.1.tar.gz.

This creates a Workflow folder.

4. In the Workflow folder, double-click WorkFlow.xcodeproj so that it opens in the XCodeIDE.

5. If necessary, add these frameworks from the SDK to the project by selecting Project >Edit Active Target > <ProjectName> > General:

• Security.framework

• AddressBook.framework

• QuartzCore.framework

• CoreFoundation.framework

• libicucore.A.dylib

• libz.1.2.3.dylib

• libstdc++.dylib

6. In XCode, select Build > Build.The project builds and the simulator starts.

Configuring iOS Connection SettingsGoal: Configure the settings for the Mobile Workflow application.

Try It Out


1. Go to your iOS simulator Settings and click WorkFlows.

2. Enter the settings for the Mobile Workflow application:

• Server Name – the machine that hosts the server where the mobile application projectis deployed.

• Server Port – Unwired Server port number. The default is 5001.• Company ID – the company ID you entered when you registered the device in Sybase

Control Center, in this case, 0 (zero).• User Name – the user you registered in Sybase Control Center, such as user1.

• Activation Code – the activation code for the user, 123.

Configuring the BlackBerry Simulator for Mobile Workflow PackagesCopy the .cod files to the BlackBerry simulator directory.

1. Navigate to <UnwiredPlatform_InstallDir>\UnwiredPlatform\ClientAPI\Workflow\BB.

2. Copy the required .cod files to the BlackBerry simulator directory. These include:

• CommonClient.cod – shared code that can be used by native Sybase Unwired PlatformBlackBerry applications.

• MessagingClientApp.cod – the main Mobile Workflow application.• MessagingClientSettings.cod – Sybase Settings options screen where the user enters

the server connection information.• MocaClient.cod – messaging library.• WorkflowResources.cod – image resources for the Mobile Workflow application, for

example, the Mobile Workflow icons.

3. Start the MDS server by clicking Start > Research in Motion > BlackBerry JDE 6.0.0 >MDS-CS.

4. Start the BlackBerry simulator.

Configuring BlackBerry Connection SettingsConfigure the connection settings for the Mobile Workflow application on the BlackBerrysimulator.

1. On your simulator, navigate to Options > Third Party Applications > SybaseSettings.



• Server Port – Unwired Server port number. The default is 5001.• Company\Farm ID – the company or farm ID you entered when you registered the

device in Sybase Control Center, in this case, 0 (zero).

Try It Out


• User Name – the user you registered in Sybase Control Center.• Activation Code – the activation code for the user, for example, 123.

Select Menu > Save to save the settings.

3. Start the Mobile Workflow application. From the Sybase Settings screen, then selectMenu > show Log to verify that the connection is active.

The Settings log indicates if you are successfully connected to the server.

Configuring the Android Emulator for Mobile Workflow PackagesConfigure the Android emulator.

PrerequisitesInstall the Android SDK and run the SDK Manager to install SDK Platform Android version2.2 or higher, Android SDK Platform tools, and Android SDK Tools.

Task

1. Run the Android SDK Manager and select Virtual devices.

2. Click New, provide a name, and select 2.2 or higher for the target.

3. In the Android emulator, start the newly created virtual device.

4. (Optional) Select Wipe User Data.

5. Run platform-tools\adb and install SybaseDataProvider.apk andWorkflow.apk, which are located in \UnwiredPlatform\ClientAPI\Workflow\Android. If you encounter an error indicating the device is offline, repeatthese commands to ensure the files are properly installed. If you selected Wipe User Data,reinstall the apk files if they were previously installed, delete the device user previouslycreated in SCC, and recreate the device user in SCC.

The Sybase Mobile Workflow application should now appear in the emulator.

Configuring Android Connection SettingsConfigure the connection settings for the Mobile Workflow application on the Androidsimulator.

1. On your simulator, navigate to Settings > Sybase Settings.



• Server Port – Unwired Server port number. The default is 5001.• Company\Farm ID – the company or farm ID you entered when you registered the

device in Sybase Control Center, in this case, 0 (zero).

Try It Out


• User Name – the user you registered in Sybase Control Center.• Activation Code – the activation code for the user, for example, 123.

Select Save to save the settings.

3. Start the Mobile Workflow application. From the Sybase Settings screen, then selectShow Log to verify that the connection is active.

The Settings log indicates if you are successfully connected to the server.

Installing Sybase Messaging Runtime on Windows MobileStart the Device Emulator Manager and your synchronization software, cradle the device, andinstall Sybase Messaging Runtime.

Prerequisites

• The Sybase Messaging runtime client requires that you have Microsoft .NET CompactFramework 3.5 Redistributable installed.

• The synchronization software must be running, and the device must be connected andcradled.

Task

1. Start the Device Emulator Manager by navigating to C:\Program Files\Microsoft Device Emulator\1.0 and double-clicking dvcemumanager.

2. From the list of devices, right-click the device you want to use, and select Connect.

3. Right-click on the device again and select Cradle.The synchronization software appears.

4. Go to <UnwiredPlatform_InstallDir>\UnwiredPlatform\ClientAPI\Workflow\WM and copy the SUPMessaging_Pro.cab file to a folder on your mobiledevice, for example:

5. Use File Explorer on the device emulator to browse to the SUPMessaging_Pro.cabfile.

6. Click on SUPMessaging_Pro.cab once to start the installation.

Try It Out


Installing Microsoft Synchronization SoftwareInstall and configure Microsoft synchronization software so you can deploy and run a mobileapplication on a Windows Mobile emulator.

Note: Microsoft ActiveSync is for Windows XP. If you are using Windows Vista, Windows 7,or Windows 2008, install Virtual PC 2007 SP1 and Windows Mobile Device Center to managesynchronization settings. Download the Windows Mobile Device Center from http://www.microsoft.com/windowsmobile/en-us/downloads/microsoft/device-center-download.mspx.

1. Download Microsoft ActiveSync from http://www.microsoft.com/windowsmobile/en-us/help/synchronize/device-synch.mspx. Save it to your local machine. Windows XPrequires ActiveSync version 4.5.

2. In Windows Explorer, double-click setup.msi.

3. When installation is complete, restart your machine.

ActiveSync starts automatically, and its icon appears in the Windows toolbar.

4. Double-click the ActiveSync icon.

5. Select File > Connection Settings.

6. Select Allow Connections to One of the Following, then select DMA.

7. Under This Computer is Connected to, select Work Network.

8. Click OK.

Try It Out


http://www.microsoft.com/windowsmobile/en-us/downloads/microsoft/device-center-download.mspx



http://www.microsoft.com/windowsmobile/en-us/help/synchronize/device-synch.mspx

http://www.microsoft.com/windowsmobile/en-us/help/synchronize/device-synch.mspx

Configuring Windows Mobile Connection SettingsConfigure the connection settings on the Windows Mobile emulator.

PrerequisitesThe Sybase messaging runtime client must be installed on the Windows Mobile emulator.

Task

Note: This procedure uses a Windows Mobile 6.0 Professional Edition emulator. If you use adifferent emulator version, the user interface will vary slightly from this tutorial.

1. On the emulator, select Start > Programs > Sybase Settings.

2. In the Sybase Settings screen, click Connection.

3. In the Connection screen, enter the connection settings:• Server Name – the machine that hosts the server where the mobile application project

is deployed.• Server Port – Unwired Server port number. The default is 5001.• Farm/Company ID – the farm or company ID you entered when you registered the

device in Sybase Control Center, in this case, 0 (zero).• User Name – the user you registered in Sybase Control Center, such as user1• Activation Code – the activation code for the user, 123.

Try It Out


Note: "localhost" should be the name of your machine.

4. Click Done.

Generating Code for a Mobile Workflow PackageGenerate the files for the Mobile Workflow package and deploy them to the Unwired Server.

PrerequisitesComplete these tasks:

• The device must be registered in Sybase Control Center.• If Microsoft ActiveSync is not running, start it now. (Windows XP)• If Windows Mobile Device Center is not running, start it now. (Windows Vista, Windows

7, Windows 2008)

Task

1. In the Mobile Workflow Application Designer, click .

2. In the New Mobile Workflow Package Generation wizard, select:

Option Description

Favorite configurations (Optional) Select a configuration.

Generate Select Generate into the project.

Unwired Server Profile Select My Unwired Server as the profile withwhich to associate the mobile workflow pack-age.

Deploy to an Unwired Server Deploy the mobile workflow package to anUnwired Server, and in Deploy Mode, selectNew.

Assign workflow to users Select this option, and click Get Users. Select auser, for example, user1.

Try It Out


3. In the Mobile Workflow Package Generation wizard, click Finish.

The files for the mobile workflow package are generated and stored in the specifiedlocation as a .zip file.

The mobile workflow package appears in Enterprise Explorer in the Workflows folderunder Unwired Server.

Try It Out


Running the Sample on an iOS SimulatorRun the Workflow application to try out the Employee Directory sample on your iOSsimulator.

1. Launch the iOS simulator.You can see the Sybase mobile workflow client application.

2. Launch the Workflow application, then set a password.

Try It Out


The workflows are listed, and server notifications appear as e-mail messages in theMessages section.

3. Select the empDir application.

The Credential screen appears once.

Try It Out


4. Provide the user ID and password.

Your credentials are cached by the mobile workflow and are not requested again.

5. Search the employee directory in a variety of ways.

Use the % symbol to represent wildcards.

Try It Out


The following are example search results for employees whose names begin with Jo.

6. Select one of the results to display Employee Details.

Try It Out


7. In the Employee Details screen, do any of the following:

• View attachments such as images using the attachment viewer.• Navigate through the company hierarchy by selecting the Manager or Direct

Reports.

8. Add a commonly contacted employee to a favorites list, and request the list from theSearch screen.

Go to the Options screen, which allows you to enable or disable notifications.

9. Create a notification e-mail message when an employee is hired or terminated.

The e-mail message is sent to those employees who registered for notifications. Thisfunctionality requires additional setup and configuration of an e-mail server. The insert

Try It Out


and delete triggers provided in EmpDir.sql are provided as examples. To simulate thisprocess, use the Send a Notification wizard.

10. Provide the information to send to the device.

An e-mail notification now appears on the device.

Try It Out


Running the Sample on a BlackBerry SimulatorRun the Workflow application to try out the Employee Directory sample on your BlackBerrysimulator.

1. Launch the BlackBerry simulator.In the Messages section, the workflows are listed, and server notifications appear as e-mailmessages.

2. Select Workflows.

3. Select the empDir application.A help screen appears, followed by a credentials screen.

4. Provide the user ID and password.Your credentials are cached by the mobile workflow and are not requested again.

5. Search the employee directory in a variety of ways.Use the % symbol to represent wildcards.

6. In the Employee Details screen, do any of the following:• View attachments such as images using the attachment viewer.• Navigate through the company hierarchy by selecting the Manager or Direct

Reports.


Try It Out




The e-mail message is sent to those employees who registered for notifications. Thisfunctionality requires additional setup and configuration of an e-mail server. The insertand delete triggers provided in EmpDir.sql are provided as examples. To simulate thisprocess, use the Send a Notification wizard.


Try It Out


Running the Sample on an Android EmulatorRun the Workflow application to try out the Employee Directory sample on your Androidemulator.

1. Launch the Android emulator.

2. Launch the Workflow application, and enter your password.

Try It Out


The workflows are listed in the next screen, and server notifications appear under theSybase Workflows screen.

3. Select the empDir application.

4. Enter your user ID and password.

Your credentials are cached by the mobile workflow and are not requested again.

You can search the employee directory in a variety of ways. Use the % symbol to representwildcards:

5. Search the results for employees whose names begin with Jo.


Attachments such as images are displayed using the attachment viewer.

Try It Out


7. Navigate through the company hierarchy by selecting the Manager or Direct Reportsbuttons.

8. From the Search screen navigate to the Options screen, which allows you to enable ordisable notifications.

9. Simulate a notification e-mail message.

When an employee is hired or terminated, an e-mail message is sent to those employeeswho registered for notifications. This requires additional setup and configuration of an e-mail server. The insert and delete triggers provided in EmpDir.sql are provided asexamples. To simulate this process, use the Send a Notification wizard.

Try It Out


The information you provide in the Send Notification to a Device User dialog is sent tothe device:

A notification now appears on the device:

Try It Out


Running the Sample on a Windows Mobile EmulatorRun the Workflow application to try out the Employee Directory sample on your WindowsMobile emulator.

1. Launch the Windows Mobile emulator.

In Outlook E-mail the workflows are listed, and server notifications appear as e-mailmessages.

2. Select Workflows.

3. Select the empDir application.A help screen appears, followed by a credentials screen.

4. Provide the user ID and password.Your credentials are cached by the mobile workflow and are not requested again.

5. Search the employee directory in a variety of ways.

Use the % symbol to represent wildcards.

The following are example search results for employees whose names begin with Jo.

Try It Out



7. In the Employee Details screen, do any of the following:

• View attachments such as images using the attachment viewer.• Navigate through the company hierarchy by selecting the Manager or Direct

Reports.




The e-mail message is sent to those employees who registered for notifications. Thisfunctionality requires additional setup and configuration of an e-mail server. The insertand delete triggers provided in EmpDir.sql are provided as examples. To simulate thisprocess, use the Send a Notification wizard.


Try It Out


Additional ModificationsApply additional modifications to the sample, including the look and feel on the device, thedevice cache, adding a confirmation dialog, and debugging.

Basic Look and FeelWhen you develop a workflow, it is recommended that you begin with a basic look and feel.This will enable you to generate a smaller workflow package that you can deploy, start, anddebug easily. To use a basic look and feel, select Window > Preferences > Sybase, Inc >Mobile Development > Mobile Workflow Forms Editor:

Try It Out


When you generate the .zip file that is deployed to the device, all the contents under the htmlfolder are included in that .zip file. When you use the basic look and feel, delete the previouslygenerated contents if the sophisticated look and feel was previously selected.

Customized Look and FeelYou can further customize the look and feel by modifying the Custom.js file. For example,you could add a gradient background and footer by replacing thecustomBeforeWorkflowLoad and customAfterNavigateForward functionswith the contents of the Customization\gradientAndFooter.txt file included inthe EmpDir project. Then create an images folder under the generated html folder and copyEmpDirImages\gradient2.png into that folder. Ensure the look and feel setting is setto Basic for this example. Run the Package Generate wizard to redeploy the mobileworkflow. Note that this change does not apply to iOS, since that platform already uses buttonsinstead of native menus.

If you prefer to replace menu items with buttons instead of adding a gradient background andfooter, replace the contents of these same functions with the contents in Customization\menusToButtons.txt.

Try It Out


To make changes to the sophisticated look and feel, modify the html\css\jquery\jquery.mobile-1.0a3.css file. For example, you could modify the color-stopvalues in the following code:

For example, suppose you would like to modify this entry:.ui-body-a { … background-image: -webkit-gradient(linear,left top,left bottom, color-stop(0, 666666), color-stop(0, FFFFFF));

To use a color-stop value of #B2CFDA and white, modify

color: #FFF;

withcolor: black

Add a Confirmation DialogTo add a confirmation dialog, replace the contents of the customBeforeSubmit functionin Custom.js with the contents in Customization\beforeSubmit.txt includedin the EmpDir project, and run the Package Generation wizard to redeploy the mobileworkflow:

Try It Out


Add Clickable LinksYou can add custom code to replace the location, phone number, and e-mail text fields withclickable links to open Google Maps, dial the phone, and open e-mail messages. In addition,you can replace the attachment viewer link with an img tag so the employee's image can beshown without navigating to another screen. To make these changes, replace the contents ofthe customBeforeShowScreen function in Custom.js with the contents inCustomization\beforeShowScreen.txt included in the EmpDir project:

Improve SearchesTo improve your searches, set the On-device cache timeout property. For example, selectthe By First Name menu item on the Search page and enter a value of 240, which is equivalentto 4 minutes. This will result in faster results in subsequent searches, and the results will beavailable even when the device is not connected to the network if you invoke the search within4 minutes of the previous search.

Try It Out


Use a DebuggerAt times it is useful to be able to step through the customized code with a debugger. Thesimplest way to do this is to drag and drop the generated html file, such as workflow.html,onto a browser such as Chrome and press <Ctrl>-<Shift>-J to display the Java ScriptConsole. Add a parameter to the URL to indicate the screen to be displayed. For example,add ?screenToShow=Search.

To simulate the workflow message that would be passed into the workflow as a result of amenu action or a server notification, we can execute the menu action on a mobile device orsimulator and then copy the workflow message that was sent to the device.

Try It Out


1. Modify the TraceConfig.xml file located at C:\Sybase\UnwiredPlatform\Servers\MessagingServer\Data\TraceConfig.xml and ensure that theWorkflowClient is set to debug:

<Module Name = "WorkflowClient" Level = "Debug" Desc = "WorkflowClient"/>

2. Restart the Sybase Messaging Service by running the following commands from acommand prompt:net stop Sybase Messaging Servicenet start Sybase Messaging Service

3. On the device, perform a search to return the favorite items.In the folder C:\Sybase\UnwiredPlatform\Servers\UnwiredServer\logs\WorkflowClient locate a .txt file that contains the device user name in it.Within that file, copy the returned message and paste it into a file named rmi.xml in thehtml folder. The message should appear as follows:

<XmlWidgetMessage> <Header></Header> <WidgetScreen>Favorites</WidgetScreen> <RequestAction>Favorites</RequestAction> <Values> <Value key="ListEmpFavorites" type="LIST"> <Values key="100010" state=""> …</XmlWidgetMessage>

4. Copy the generated html folder to a Web server, such as the htdocs folder on Apache.

5. Open a desktop browser such as Chrome to the appropriate URL such as http://servername/EmpDir_Sol/EmpDir/html/workflow.html?screenToShow=Search.

6. Click on Favorites to view the data, which is derived from the rmi.xml file that containsthe workflow message with the data from a previous query.

7. Click on a favorites item to see the details screen.a. Press <Ctrl>-<Shift>-J to display the Java Script Console.b. Click the Scripts tab and select Custom.js.

Now you can add a breakpoint, for example, in the customBeforeSubmitfunction.To use that breakpoint, in the workflows shown in the browser, select Favorites, selectan employee, and click the Remove menu item.

Try It Out


Learn More

Learn about this sample, or get additional help on using Unwired Platform in your enterpriseenvironment.

• For information about project artifacts, database schemas, and other detailed informationon this sample, see Related Reference on page 45.

• For information on how to coordinate your self-directed exploration of Unwired Platformsamples, tutorials, and documentation, see Learn More about Sybase Unwired Platform onpage 47.

• To get help or more information, see Getting Help on page 48.

Related ReferenceReview reference information to understand the implementational and architectural details ofthis sample.

Project Artifact ReferenceFamiliarize yourself with artifacts of this sample.

All project artifacts are imported into Sybase Unwired Platform from the EmpDir.zip file.To explore the contents of the project, expand the project in WorkSpace Navigator. The top-level folder structure of this sample is

Folder Contents

Mobile Business Objects The source files for the MBOs used in this sample, as well as theirrequired attributes (for example, the table and columns the MBOsaccess), and the operations they perform if any.

Data Source References The pointers to the data source used by the MBos in the sample. In thiscase, there is only one: PurchaseOrderDB.

Roles The roles defined for the project. The sample project has no rolesdefined.

Personalization Keys The personalization keys defined for the project. The sample projecthas no personalization keys defined.

DB The database files used as the back-end repository for the sample.These files include the .BAT file that starts the database with all re-quired properties, the database file itself, and its corresponding logfile.

Learn More


Folder Contents

Deployment The folder where all applicable deployment files are saved. Theproject contains some sample/test deployment files. You can add yourown deployment files if you choose.

Troubleshooting Mobile Device Connectivity IssuesProvides troubleshooting information for mobile device connectivity issues to the UnwiredServer.

As a first step on the device or simulator choose Restart Client and then Show Log (notavailable on iOS). Viewing the device or simulator's log file can be helpful in determiningconnectivity problems.

Cannot Connect to Server

1. Verify that the server name and port are correct.2. Open a browser on the device or simulator or machine that is running the simulator to

http://MACHINE_NAME_WHERE_SUP_IS_INSTALLED:5001 where 5001 is themessaging based synchronization port number shown in SCC under Servers > ServerName > Properties > Messaging Based Synchronization Port. This is also the portnumber used when creating the device user. An empty white page should appear. If it doesnot, configure your firewall settings to unblock port 5001.

Out of NetworkThis may indicate a network problem. Check the device or simulator's network settings andverify connectivity by opening a browser to a website such as google.com. On a WindowsMobile simulator, ensure that there is an Active Sync (Windows XP) or Windows MobileDevice Center (Windows Vista, Windows 7) Active Sync connection.

Server Response TimeoutThis indicates that a networking problem exists. Check the device or simulator's networksettings and verify them by opening a browser to a website such as google.com. If you areusing a BlackBerry simulator, verify that MDS is running.

Bad User Name or CodeThis indicates that the activation code or user name specified is incorrect. Recheck the settingson the device and in SCC.

Wrong Device for CodeThis indicates that the user name specified is being used by another device. In SCC, create anew device user.

Learn More


Awaiting Server NotificationAfter you deploy a workflow, if it does not appear on the device and this message is seen, tryrestarting the client. If this works and the device is a BlackBerry, you may need to modify theBlackBerry Push Configuration in SCC. Select Servers > Server Name > ServerConfiguration > Messaging > BlackBerry Push Configuration.

Disabled: Low StorageThis issue may occur on a Windows Mobile simulator. On the device check Settings > System> Memory. If necessary, browse to Device\Program Files\Sybase\Messaging\AMP and delete the sub folder. Redeploy your workflow after performing this action.

Learn More about Sybase Unwired PlatformOnce you have finished, try some of the other samples or tutorials, or refer to otherdevelopment documents in the Sybase Unwired Platform documentation set.

Check the Sybase Product Documentation Web site regularly for updates: http://infocenter.sybase.com/help/index.jsp?topic=/com.sybase.infocenter.pubs.docset-SUP-2.0.0/doc/html/title.html.

TutorialsTry out some of the other getting started tutorials to get a broad view of the development toolsavailable to you.

SamplesSample applications are fully developed, working applications that demonstrate the featuresand capabilities of Sybase Unwired Platform.

Check the SAP Development Network (SDN) Web site regularly for updates: http://www.sdn.sap.com/irj/sdn/mobile. Click on Sybase Unwired Platform and navigate toSamples.

Online HelpSee the online help that is installed with the product, or the Product Documentation Web site.

Developer GuidesLearn about using the API to create device applications:

• Developer Guide for BlackBerry• Developer Guide for iOS• Developer Guide for Mobile Workflow Packages• Developer Guide for Windows and Windows Mobile

Customize and automate:

Learn More


http://infocenter.sybase.com/help/index.jsp?topic=/com.sybase.infocenter.pubs.docset-SUP-2.0.0/doc/html/title.html



http://www.sdn.sap.com/irj/sdn/mobile

http://www.sdn.sap.com/irj/sdn/mobile

• Developer Guide for Unwired Server Management API – customize and automate systemadministration features.

• Developer Guide for Unwired Server – customize and automate server-sideimplementations for device applications, and administration, such as data handling.

Javadoc and HeaderDoc are also available in the installation directory.

Getting HelpEach Sybase installation that has purchased a support contract has one or more designatedpeople who are authorized to contact Sybase Technical Support.

If you cannot resolve a problem using the online help or other technical documents, have thedesignated person contact Sybase Technical Support or the Sybase subsidiary in your area.

Learn More


IndexA

ActiveSync, installing and configuring 21Android 19Android emulator 33applications

generating code for device 23artifacts

reference 45

B

Basic look and feel 39BlackBerry simulator 31

C

Clickable links 39Confirmation dialog 39consolidated database, exploring 9

D

Debugging 39deploying

configuring ActiveSync for 21deploying to Unwired Server 15device applications

generating code for 23

E

Emulator 15emulator connection settings, configuring 22emulator, registering 6

F

Flow Design 12

G

generatingcode for a device application 23

H

help, getting 48

I

installingMicrosoft ActiveSync 21synchronization software 21

interface design 12iOS simulator 25

M

MBOsoverview 10

Microsoft ActiveSync, installing and configuring21

Mobile Application Diagram 11mobile applications

generating code for 23

P

prerequisites 5projects

artifact reference 45

R

referenceproject artifacts 45

registering the emulator in SCC 6

S

samplelearn more 45

Screen Design 12ServerDB, exploring 9Simulator 15Sophisticated look and feel 39SUPMessaging_Pro.cab 20

Index


Sybase Control Centerregister device 6registering the emulator 6status 6

Sybase Mobile Workflow 19Sybase Unwired Platform

getting help 48learning more about 47Technical Support, contacting 48

synchronization softwareinstalling 21

T

tutorialconfiguring the Android emulator 19

W

Windows emulatorconnection settings 22

Windows Mobile emulator 37

Index


Date post:	01-Dec-2014
Category:	Documents
Upload:	gian-carlo-ii
View:	917 times
Download:	0 times

Sup Sample Mobile Workflow Employee Directory

Documents