Documentation Issues and Updates for Mobile SDK

Read about updates, corrections, and clarifications to the documentation released with Sybase Unwired Platform 2.1.

CR #Description
686646
The instructions for installing the free Mobile Workflow container from the Apple App store for iOS devices has been updated. See Installing the Mobile Workflow Container from the Apple App Store.
NA
The procedure in the topic Enabling JPDA in the Developer Guide: Unwired Server is incorrect. Instead, follow this procedure to enable JPDA on Unwired Server:
  1. Stop Unwired Server.
  2. Add JPDA information from Sybase Control Center:
    1. Select Servers > ServerName > Server Configuration > Performance Configuration.
    2. Expand Show optional properties.
    3. Add JPDA information to the value of the User Options property. In this example 5005 is the port to which the Java debugger connects:
      -Xdebug -Xnoagent -Xrunjdwp:transport=dt_socket,server=y,suspend=n,address=5005
  3. Restart Unwired Server.
  4. Once Unwired Server is restarted, verify that JPDA mode is working and available at port 5005 by running:

    netstat -ano | findstr 5005

    Look for these results:
    TCP  0.0.0.0:<JPDAport>   0.0.0.0:0  LISTENING
  5. Use a standard Java debugger and attach it to Unwired Server by specifying the correct host and the JPDA port used.
  6. Begin debugging the result filter class with the Java debugger.
689774
If you do not have the supported version of Xcode and the iOS SDK, you need to download it from the Downloads for Apple Developers Web site.

See Supported Hardware and Software for the most current version information for mobile device platforms and third-party development environments.

  1. Go to http://developer.apple.com/downloads/.

    You must be a paying member of the iOS Developer Program. Free members do not have access to the supported version.

  2. Log in using your Apple Developer credentials.
  3. (Optional) Deselect all Categories except Developer Tools to narrow the search scope.
  4. Download the supported Xcode and SDK combination.
686355
SD card recommendations – Sybase recommends that customers use industrial grade SD cards using Single Level Cell (SLC) technology. SD cards that use SLC technology are generally more reliable and faster than MLC cards, although they may be more limited in size and more expensive per unit of storage. Not all SD cards perform equally, and it is advised that customers evaluate the benchmarks available from different suppliers.
684730
The topic Sybase Unwired WorkSpace – Mobile Workflow Package Development Online Help > Configuring Control Properties > Signature Control Properties incorrectly states that the signature control is not supported on iOS platforms. The signature control is supported on iOS platforms, but not supported on Windows Mobile platforms.

For information about supported platforms for all mobile workflow controls, see Developer Guide: Mobile Workflow Packages > Mobile Workflow Development > Develop a Mobile Workflow Using the Mobile Workflow Forms Editor > The Mobile Workflow Forms Editor > Mobile Workflow Controls.

680253
Images do not appear correctly on mobile devices.

Hybrid Web Container/Workflow applications can dsiplay pictures from binary enterprise information system (EIS) data. But when a MBO developer drags and drops a table that contains an image field to create the MBO, the image field maps to a binary type whose length is about 3k, which may not be large enough for the entire image. At runtime, the binary data of the image may be truncated in the cache database (CDB), and not display correctly on the device.

Workaround: when creating the MBO, manually modify the length of the binary field to make sure it is large enough to hold the image binary data.

676285
Clarification for using Query APIs with column names and aliases.
If an alias is defined for a selected column, you must use the alias to retreive results. For example: 
query.Select("m.MATERIAL as test"); 
... ... 
MaterialNumber = qrs.GetStringByName("test")
If there is no alias defined for a selected column, use the attribute name to retreive results. For example: 
query.Select("m.MATERIAL"); 
... ... 
MaterialNumber = qrs.GetStringByName("MATERIAL")
674889
Apple Push Notification Service (APNS) Works on iPad Devices.
These topics incorrectly state that APNS cannot be used with iPad devices:
  • Apple Provisioning for iOS in System Administration
  • Apple Push Notification Service Configuration in OData SDK Developer Guide
674115
For large database files, BlackBerry recommends using a secure digital (SD) card instead of persistent storage.
Use this code to store the package database on the device's SD card: 
getConnectionProfile().setProperty("databaseFile", "file:///SDCard/BlackBerry/documents/MyPackage1_0.ulj");
Where databaseFile is the name of the connection profile property and file:///SDCard/BlackBerry/documents/MyPackage1_0.ulj is the file path to a location on the SDCard. The path should start with file:///SDCard/ to store the database on the BlackBerry SD card. All folders in the path must exist, since they are not automatically created.
673555
Configuring Unwired Server client user account lockout properties
  • loginFailureLockThreshold – the number of unsuccessful login attempts before a user is locked out of their account
  • loginFailureLockTimeout – the amount of time, in seconds, the user is locked out of their account after they reach the loginFailureLockThreshold
Configure these properties by adding these two lines and values to the <UnwiredPlatform_InstallDir>\UnwiredPlatform\Servers\UnwiredServer\Repository\Instance\com\sybase\djc\security\SecurityDomain\default.properties file. For example: 
loginFailureLockThreshold=5 (locked out after five unsuccessful login attempts)
loginFailureLockTimeout=600 (locked out for 600 seconds)
670560
MBO relationship validation rule change

The Unwired WorkSpace validation rule that prevents a delete operation on the parent, because the child is related with a composite operation is not necessary and has been removed. In an MBO relationship, it is valid for a customer to model a parent delete only and allow the cache refresh to remove any children.

663867
Valid, supported value range for DateTime datatypes.

When a DateTime value is stored in the database, it will only be represented accurately if it is within the range 1600-02-28 23:59:59 to 7911-01-01 00:00:00. Attempting to store dates outside this range may result in incomplete and inaccurate information.

Workaround: None

634686
Support for UltraLite client authentication to a proxy server

The application developer can enable the UltraLite client to authenticate to a proxy server by including a username and password in the network stream parameters:

MyDatabase.DB.GetSynchronizationProfile().NetworkStreamParams=''http_userid=supAdmin;http_password=s3pAdmin''