How 2 Implement Simple Application in Sybase Unwired Platform 2.0.0.0

7/28/2019 How 2 Implement Simple Application in Sybase Unwired Platform 2.0.0.0

1/33

SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com

2011 SAP AG 1

How to Implement a SimpleApplication using Sybase UnwiredPlatform 2.0

Applies to:

Sybase Unwired Platform 2.0. For more information, visit theMobile homepage.

Contributors:

Daniel Bianchin - SAP Solution Management - Mobility

Claudia Pacheco - SAP Customer Solution Adoption - Technology

Sam Lakkundi Sybase Global SWAT - NA

SummaryThis exercise shows all the steps to implement a simple application (workflow) for RIMs Blackberryenvironment using Sybase Unwired Platform 2.0 and a generic web service available on the internet.

The document is organized in sections covering installation, licensing, testing, implementation, etc. and youcan use as reference for multiple purposes other than web services or SUP workflows.
https://www.sdn.sap.com/irj/sdn/nw-mobilehttps://www.sdn.sap.com/irj/sdn/nw-mobilehttps://www.sdn.sap.com/irj/sdn/nw-mobilehttps://www.sdn.sap.com/irj/sdn/nw-mobile


2/33

How to Implement a Simple Application using Sybase Unwired Platform 2.0


2011 SAP AG 2

Table of Contents

Introduction ......................................................................................................................................................... 3

SUP Download ................................................................................................................................................... 3

Installation ........................................................................................................................................................... 3

Licensing ............................................................................................................................................................. 4

SUP Execution .................................................................................................................................................... 4RIMs Blackberry JDE 6.0 developer download and Installation ......................................................................... 5

RIM Environment Execution ............................................................................................................................... 5

SUP Server Configurations................................................................................................................................. 7

Device Configuration .......................................................................................................................................... 9

Web Service Implementation ............................................................................................................................ 12

Eclipse Configuration .................................................................................................................................... 12

Project Creation ............................................................................................................................................ 13

Connection Creation ..................................................................................................................................... 14

MBO Creation ............................................................................................................................................... 16Project Deployment ....................................................................................................................................... 20

Workflow Creation ......................................................................................................................................... 22

Execution in Device .......................................................................................................................................... 31

Related Content ................................................................................................................................................ 32

Copyright........................................................................................................................................................... 33


3/33



2011 SAP AG 3

Introduction

The example web service receives a source currency, target currency and a provider agency and it returns acurrency exchange rate (number). Provider AVERAGE can be used and typical currency ISO codes, mostof the main currencies are supported.

SUP Download

1. Go to forhttps://sybase.subscribenet.com/. Register and request join to download SUP 2.02. Once you got the approval go back tohttps://sybase.subscribenet.com/and download.

Installation

Unzip the files to (e.g.) sup directory:

Run setup.exe and follow the wizard

instructions
https://sybase.subscribenet.com/https://sybase.subscribenet.com/https://sybase.subscribenet.com/https://sybase.subscribenet.com/https://sybase.subscribenet.com/https://sybase.subscribenet.com/https://sybase.subscribenet.com/https://sybase.subscribenet.com/


4/33



2011 SAP AG 4

Licensing

a. Go to https://sybase.subscribenet.com/

b. Go to product List

c. Select SUP 2.0

d. Click on License Keys

e. Click on Generate License

f. Unserved type

g. Enteri. Host ID -> ipconfig /all (use "Physical Address" value)

ii. Host name

iii. Number of license

2. Configure license:

Copy the new license file to the \Servers\UnwiredServer\licenses

folder.

Open a command prompt.

Run license.bat (located in C:\Sybase\UnwiredPlatform\Servers\UnwiredServer\bin)

o license.bat

1. The valid values of PE are: EE,ED,PD

2. The valid values of LT are: CP,OT,SS,DT,AC,AS,ST

License example for PE and LT

Note the value of PE (product edition) and LT (license type) in the line following the line:

INCREMENT SUP_ENTDEV SYBASE 2012.08150 15-aug-2012 uncounted \VENDOR_STRING=PE=ED;LT=DT HOSTID=001c257e5fb6 PLATFORMS="i86_n \x64_n"ISSUER="CO=Sybase, \Inc.;V=1.5;AS=A;MC=20;MP=3394;CP=1;EGO=" ISSUED=18-apr-2011\NOTICE="Sybase, Inc.-for internal use only." \SN=9310607604-2430433 SIGN2="1046 3812 7510 1633A73F 4AA4 \504D 045F 6733 CDB1 7C13 2A83 29BA 266C F497 119D A754 3285 \3C20 A7C6 36AB 9958148D 23D9 0F0F 9D22 2FD3 498D 2B23 3DF2"

SUP Execution

IMPORTANT: since the infrastructure communicates internally via http, firewall may interfere. Youhave to disable the services if you want SUP running.

You can start/stop/restart yourSUP services from the start menu:

Right-Click on the link and Run asadministrator
https://sybase.subscribenet.com/https://sybase.subscribenet.com/https://sybase.subscribenet.com/


5/33



2011 SAP AG 5

RIMs Blackberry JDE 6.0 developer download and Installation

Go tohttp://us.blackberry.com/developers/and register as a developer

Go tohttp://us.blackberry.com/developers/javaappdev/javadevenv.jsp and download Blackberry JDE v6.0

Run the installation wizard.

RIM Environment Execution

Go to the start menu and find the JDEcomponents.

Since we SUP will use its container, youdont need to run JDE in this example

Start the MDS-CS server.

The MDS Server is the link between thedevice and the SUP Server

Start the Device Simulator and wait until itsready.

The simulator will automatically connect to

the MDS-CS server.
http://us.blackberry.com/developers/http://us.blackberry.com/developers/http://us.blackberry.com/developers/http://us.blackberry.com/developers/javaappdev/javadevenv.jsphttp://us.blackberry.com/developers/javaappdev/javadevenv.jsphttp://us.blackberry.com/developers/javaappdev/javadevenv.jsphttp://us.blackberry.com/developers/javaappdev/javadevenv.jsphttp://us.blackberry.com/developers/


6/33



2011 SAP AG 6

Load the generic SUP Workflow libraries. Itwill allow you to run any SUP workflow.

Go to File Load BlackBerry Application orTheme.

Select all together and load all files in

c:\Sybase\UnwiredPlatform\ClientAPI\MBS\BB\MoMessaging.

All in all you would be consuming something between 3 and 4 Gb, example processes:


7/33



2011 SAP AG 7

SUP Server Configurations

Start the Sybase Control Center.

If its not starting check if theuaservice.exe is running. Restart the

services if required.

Disregard certificate warnings.

Login supAdmin/s3pAdmin.

If you have login errors, restart the SUPservices.

Go to the Server Configuration form

Go to MessagingBlack berry PushConfiguration and simply check MDS-

CS (already started) is configured.


8/33



2011 SAP AG 8

Go to Device Users

Execute Devices Registerto create anew user and device.

Username : Daniel

Servename:

Select Specify activation code andtype CC (for currency conversion, theservice used as example)

Accept the Form.


9/33



2011 SAP AG 9

Device Configuration

Go to the device simulator and open themenu All

Go to Options

Scroll down to Thirt Party Applicaations

Choose Sybase Settings

Repeat exactly what you specified in theDevice User step above.


10/33



2011 SAP AG 10

Save

Go back to the application configuration

Check the log


11/33



2011 SAP AG 11

Let the systems synchronize and review thelog.

Now the device is connected to SUP server via MDS.


12/33



2011 SAP AG 12

Web Service Implementation

As an example we will be implementing a simple web service. The service WSDL can be found in this URL:http://www.currencyserver.de/webservice/currencyserverwebservice.asmx?WSDL

Eclipse Configuration

Start Eclipse and leave the welcomepage.

Hint: make sure you are using theMobile development Perspective

Go to the Enterprise Explore and openthe default SUP server properties

Configure Host, port, username andpassword.

Test Connection.
http://www.currencyserver.de/webservice/currencyserverwebservice.asmx?WSDLhttp://www.currencyserver.de/webservice/currencyserverwebservice.asmx?WSDLhttp://www.currencyserver.de/webservice/currencyserverwebservice.asmx?WSDL


13/33



2011 SAP AG 13

Project Creation

Right click in the Workspace Navigator andexecute NewMobile Application Project

Hint: make sure you are using the Mobiledevelopment Perspective

Name the project


14/33



2011 SAP AG 14

Connection Creation

IMPORTANT: Consider the need to configure a proxy to access internet from SUP! Check yourinternet browser connection for information.

In the Enterprise Explorer,select Web Services.

Execute New to create aconnection profile.

Name it.

Paste the URL to the WSDLfile.

URL:

http://www.currencyserver.de/webservice/currencyserverwebservice.asmx?WSDL
http://www.currencyserver.de/webservice/currencyserverwebservice.asmx?WSDLhttp://www.currencyserver.de/webservice/currencyserverwebservice.asmx?WSDLhttp://www.currencyserver.de/webservice/currencyserverwebservice.asmx?WSDLhttp://www.currencyserver.de/webservice/currencyserverwebservice.asmx?WSDLhttp://www.currencyserver.de/webservice/currencyserverwebservice.asmx?WSDLhttp://www.currencyserver.de/webservice/currencyserverwebservice.asmx?WSDLhttp://www.currencyserver.de/webservice/currencyserverwebservice.asmx?WSDL


15/33



2011 SAP AG 15

Double-click on theConnection profile created toconnect.

Then you can review the listof operation contained in theservice.


16/33



2011 SAP AG 16

MBO Creation

Right-click on Mobile BusinessObjectsand execute NewMobileBusiness Object.

Hint: You can optionally drag and dropand the web service from the

connection profile to the MobileApplication Diagram and create eitherthe MBO attributes or the operationsautomatically.

Name it and move to the next.

Select your data connection profile as

source and move to the next screen.

Select the GetCurrencyValueoperation that import a provider agency(or average among agencies), a sourceand destination currency and exportsthe exchange rate.

Move to the next.


17/33



2011 SAP AG 17

Fill up the parameters default values:

Provider: AVERAGE

Source Currency : ARS

Destination/Target Currency: USD

Move to the next screen and finish the

wizard

Now you have an MBO with oneattribute, returned by the test executionand no operations.

More attributes will be added so thatthey are available to the applications,but no operations since we wont becreating, updating or changing thecurrency rates, just reading.

Right-click on the main canvas and

switch to the advanced developerprofile.

The advanced developer profile allowsspecifying thesynchronization/replication policies.

Go to the Cache Groups and create anew one.

Hint: The cache group will determinethe polici to access the web serviceprovider and save the information in theSUP Service central database. Sincewe are executing online requests to theweb service provider via SUP, there is


18/33



2011 SAP AG 18

no caching, its online.

Name it and make it Online.

Drag and drop your MBO from thedefault group to the new online cachegroup.

The new MBO should be listed underthe online cache group.

Click on the MBO title

Go to the Attributes


19/33



2011 SAP AG 19

Select the Attribute Mapping tabstripand add 3 attributes:

dstCurrency (String Primary Key)

provider (String Primary Key)

srcCurrency (String Primary Key)

The system will use it to access the

webservice. For that, an Object Querywill be automatically created to executethe search from the Workflowapplication afterwards.

Save all your work.


20/33



2011 SAP AG 20

Project Deployment

Right-Click on Mobile BusinessObjects and execute Deploy Project.

Choose Message-basedsynchronization that is the methodused by RIMs Blackberries.

Continue moving to next screen untilyou reach TargetServerconfiguration.

Connect to the default server andmove to the next screen.

Select the CurrencyConverterconnection profile already created andfinish the deployment wizard.


21/33



2011 SAP AG 21

You can double-check the deploymentby browsing the services availableusing the control center(https://:8283)


22/33



2011 SAP AG 22

Workflow Creation

Right-click on the Projectand create a MobileWorkflow Forms Editor

Name and move to nextscreen.

Specify that this Workflowcan be started from themobile device.

It will create and icon inthe device to start theworkflow.

Go to the Flow Design

screen.

Click on the screen


23/33



2011 SAP AG 23

Move to the scren designtabstrip.

Click on the EditBoxcontrol.

Click on the screen todrop it.

Add a label to the control

Create a new key(variable) for the control

Name the key and save.

Repeat for target and provider


24/33



2011 SAP AG 24

Finally you must have 3fields: source, target andprovider to execute theMBO query (and WSbehind the scenes)

Click on the screencontrol

Click on the canvas tocreate a new screen.

Name it as shown.

This screen will beshowing the resultreturned from que query.It will be bound in thefollowing steps.

Click on the StartScreen (not the new!)

select Menu Item.

Click on the menu topaste a new option.

Name the menu itemcheck rate. Thefunctionality will trigger arequest to check thecurrencies exchangerates.

Switch the menu type toonline Request


25/33



2011 SAP AG 25

Search for the availableMBOs.

Execute Search

Select the MBO youcreated.

Select Invoke Object Query and select the findByParameters. This is the query created behindthe scenes with the MBO primary key specified above.

Invoke Object Query forwards the return values to the next screen.

Fill up a Submit error message which will be used on the mobile application if the request cannotbe achieved (contact SUP online) , time out, etc

Specify the success screen Current Rate you created and execute Generate Error Screen tohandle possible SUP side errors.


26/33



2011 SAP AG 26

Go to ParameterMapping tabstrip.

Map the MBO loadoperation parameters(Primary keys) with thekeys (variables) recentlycreated for the controls.

In the Flow Designtabstrip, Right click on thecanvas and executeArrange All.

Create a new a newempty screen to displaythe further exchange ratedetails.


27/33



2011 SAP AG 27

Now your screen flowshould look like this:

Click on the CurrentRate screen

Switch to the ScreenDesign and add a

ListView control.


28/33



2011 SAP AG 28

Click on the screen togenerate the control.

Select the Key Convert,which is a list of rows andfields returned by theprevious MBO query.

Go to the Cell tabstrip.

Add a row (or a list ofrows)


29/33



2011 SAP AG 29

Click on the cell created.

Add fields to the cell.

Add field to the screenfrom the Key field(Convert)

Save all, and right-clickon the Workflow.

Execute GenerateMobile WorkflowPackage


30/33



2011 SAP AG 30

Switch Deploy Mode toNew, and assign theworkflow to Daniel userby getting the users fromthe server.


31/33



2011 SAP AG 31

Execution in Device

Let the systems synchronize the application with the device . You will notice activity in the MDS console andDevice Sybase Configuration Log.

Click on Messages

Open the Menu ( ) and ExecuteWorkflows.

Start the Workflow and execute your

application!


32/33



2011 SAP AG 32

Related Content

For more information, visit theMobile homepage
https://www.sdn.sap.com/irj/sdn/nw-mobilehttps://www.sdn.sap.com/irj/sdn/nw-mobilehttps://www.sdn.sap.com/irj/sdn/nw-mobilehttps://www.sdn.sap.com/irj/sdn/nw-mobile


33/33


Copyright

Copyright 2011 SAP AG. All rights reserved.

No part of this publication may be reproduced or transmitted in any form or for any purpose without the express permission of SAP AG.The information contained herein may be changed without prior notice.

Some software products marketed by SAP AG and its distributors contain proprietary software components of other software vendors.

Microsoft, Windows, Excel, Outlook, and PowerPoint are registered trademarks of Microsoft Corporation.

IBM, DB2, DB2 Universal Database, System i, System i5, System p, System p5, System x, System z, System z10, System z9, z10, z9,iSeries, pSeries, xSeries, zSeries, eServer, z/VM, z/OS, i5/OS, S/390, OS/390, OS/400, AS/400, S/390 Parallel Enterprise Server,PowerVM, Power Architecture, POWER6+, POWER6, POWER5+, POWER5, POWER, OpenPower, PowerPC, BatchPipes,BladeCenter, System Storage, GPFS, HACMP, RETAIN, DB2 Connect, RACF, Redbooks, OS/2, Parallel Sysplex, MVS/ESA, AIX,Intelligent Miner, WebSphere, Netfinity, Tivoli and Informix are trademarks or registered trademarks of IBM Corporation.

Linux is the registered trademark of Linus Torvalds in the U.S. and other countries.

Adobe, the Adobe logo, Acrobat, PostScript, and Reader are either trademarks or registered trademarks of Adobe SystemsIncorporated in the United States and/or other countries.

Oracle is a registered trademark of Oracle Corporation.

UNIX, X/Open, OSF/1, and Motif are registered trademarks of the Open Group.

Citrix, ICA, Program Neighborhood, MetaFrame, WinFrame, VideoFrame, and MultiWin are trademarks or registered trademarks ofCitrix Systems, Inc.

HTML, XML, XHTML and W3C are trademarks or registered trademarks of W3C, World Wide Web Consortium, MassachusettsInstitute of Technology.

Java is a registered trademark of Sun Microsystems, Inc.

JavaScript is a registered trademark of Sun Microsystems, Inc., used under license for technology invented and implemented byNetscape.

SAP, R/3, SAP NetWeaver, Duet, PartnerEdge, ByDesign, SAP Business ByDesign, and other SAP products and services mentionedherein as well as their respective logos are trademarks or registered trademarks of SAP AG in Germany and other countries.

Business Objects and the Business Objects logo, BusinessObjects, Crystal Reports, Crystal Decisions, Web Intelligence, Xcelsius, andother Business Objects products and services mentioned herein as well as their respective logos are trademarks or registeredtrademarks of Business Objects S.A. in the United States and in other countries. Business Objects is an SAP company.

All other product and service names mentioned are the trademarks of their respective companies. Data contained in this documentserves informational purposes only. National product specifications may vary.

These materials are subject to change without notice. These materials are provided by SAP AG and its affiliated companies ("SAPGroup") for informational purposes only, without representation or warranty of any kind, and SAP Group shall not be liable for errors oromissions with respect to the materials. The only warranties for SAP Group products and services are those that are set forth in the

express warranty statements accompanying such products and services, if any. Nothing herein should be construed as constituting anadditional warranty.

Documents

How 2 Implement Simple Application in Sybase Unwired Platform 2.0.0.0