New Features. SAP Mobile Platform 2.3 SP03

Transcription

1 New Features SAP Mobile Platform 2.3 SP03

2 DOCUMENT ID: DC LAST REVISED: September 2013 Copyright 2013 by Sybase, Inc. All rights reserved. This publication pertains to Sybase software and to any subsequent release until otherwise indicated in new editions or technical notes. Information in this document is subject to change without notice. The software described herein is furnished under a license agreement, and it may be used or copied only in accordance with the terms of that agreement. Upgrades are provided only at regularly scheduled software release dates. No part of this publication may be reproduced, transmitted, or translated in any form 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 Sybase and the 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 registered trademarks 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 Oracle and/or its affiliates in the U.S. and other countries. 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 are associated. Use, duplication, or disclosure by the government is subject to the restrictions set forth in subparagraph (c)(1)(ii) of DFARS for the DOD and as set forth in FAR (a)-(d) for civilian agencies. Sybase, Inc., One Sybase Drive, Dublin, CA

3 Contents New Platform Features...1 Agentry Features...1 OData SDK...3 Object API Development...3 Hybrid Web Container Development...4 Mobile Business Objects...5 MBO Graph Merge Using DCN...5 Administration...6 Security...7 Rebranding...8 Documentation Changes...9 New Features iii

4 Contents iv SAP Mobile Platform

5 New Platform Features New Platform Features This release introduces SAP Mobile Platform, which incorporates both the Sybase Unwired Platform and Syclo Agentry development environments. SAP Mobile Platform version 2.3 includes new features that support development and management of the system. Several product names have also changed in this release. See Rebranding on page 8. Note: See Supported Hardware and Software for the list of devices, operating systems, APIs, and tools that SAP Mobile Platform currently supports. Agentry Features New or changed features for Agentry development. User Lockout After Failed Login Attempts Within a mobile application, you can define a maximum number of failed login attempts on the client and to then define the required action to take when that maximum is reached. Documented in: Security > Overview of Security Features in Agentry Developer Guide: Agentry Language Reference > Configuring User Lockout for Failed Login Attempts Securing Attachments on ios Devices The Agentry Mobile Platform lets you attach documents to objects and to both download and upload them to and from the client application. When implemented for environments in which ios devices are used, the default storage location of the attached documents on the client device results in those documents being accessible to the device via itunes. A simple change to the storage location of the attached documents, made in the application project using the Agentry Editor, prevents these documents from being accessible through itunes. Documented in: Security > Overview of Security Features in Agentry Developer Guide: Agentry Language Reference > Securing Attachments on ios Client Devices Client-Side Data Encryption When defining an Agentry client application, you can use the Agentry Editor to set whether to encrypt data that is stored locally in the application definition. An encrypted client encrypts all production data and application data stored on the client device. Documented in: New Features 1

6 New Platform Features Security > Overview of Security Features in Agentry Developer Guide: Agentry Language Reference > Defining Client-Side Data Encryption Public/Private Key Length Configuration During initial synchronization between the Agentry client and Agentry server, a public key is provided by the server to the client. This key is a part of the public/private key pair used by the Agentry server and Agentry client to secure communications, and to encrypt data on the Agentry client. Security requirements for many environments dictate an increase in the length of this public/private key pair from the default length of 512. To do this, modify the configuration settings for the Agentry server and, for existing live implementations, also reset the Agentry client and force the Agentry server to generate a new key of a greater length. Documented in: Security > Overview of Security Features in Agentry and Configuring the Agentry Server Public/Private Key Length. Agentry Editor New features supported by Agentry Editor for 2.3 SP03: The Agentry Editor Visual Screen Editor (VSE) now supports Windows Presentation Foundation (WPF), which is the default mode for Windows Platform screens. The WPFbased client runs on Windows 7 and Windows 8 Professional, whereas the legacy Windows client runs on Windows XP. This works the same as Win32 screens, in that they draw to the same size as defined by the platform. You can continue to access the Win32 view as Windows XP. WPF supports these screen resolutions: 1024 x 600, 1280 x 1024, 1366 x 768, 640 x 480, and 800 x 600. VSE supports these Win32 screen resolutions: 1024 x 600, 1280 x 1024, 1366 x 768, 640 x 480, and 800 x 600. VSE lets you move controls up and down, and across columns with a VSE screen using drag and drop. For example, if the user drags a control over another, the other control moves down in the screen, assuming there is room available. This functionality is available for action buttons, toolbar buttons, and columns, but you cannot resize and align the controls, handle hidden controls and fields, and autoscroll while dragging a control. VSE supports the calendar view component for ipad. VSE can display the current month, with no interaction for each platform. The Android and ios control is available for tabletsized and phone-sized screens. Teamshare improvements in the Agentry Editor: When a user commits changes, the version control number is updated in Share.ini. If files associated with a Teamshare version are removed, the Compare feature allows you to select an export file for comparison. Teamshare supports updates when different developers have added different platforms to the same screen set. Teamshare performance improvements in the Agentry Editor: 2 SAP Mobile Platform

7 New Platform Features To reduce network transfers, all repository files are now zipped together, and revisions are cached locally. Teamshare changes now update the version number both in the share and within the project. Issues that prevented export file comparison when the share was corrupted or manually changed have been corrected. Agentry Client New features supported by the Agentry Client for 2.3 SP03 (available in both Android and ios, unless otherwise specified): Users can change passwords after logging on. Users can sort on a column in a list control. Users can reorder columns in a list view, and save the changes in user preferences. The client user interface now works with all navigation features in the Advanced wizard screens. Branding support has been added for the demo databases; the branding script now picks up the product's branded databases. (Android only) The Android client can now lock the application orientation (landscape or portrait) through branding. Agentry WPF (Windows 8 Desktop) Client. OData SDK New or changed features for OData SDK. Single and Mutual SSL Support for OData Applications Using Messaging Channel The OData SDK supports single and mutual SSL for OData applications using Messaging Channel for both ios and Android platforms. Documented in: Developer Guide: OData SDK > Enabling Single and Mutual SSL Authentication (for Android and ios). Object API Development New or changed features for Object API development. Resumable Synchronization In 2.3 SP03, you can add code to the application client that allows you to resume a long synchronization when an interruption occurs. Application developers determine whether clients can request a synchronization that resumes downloading after an interruption. Resumable synchronization is particularly useful when you synchronize large data sets and do not want to cancel or roll back the partially downloaded data. New Features 3

8 New Platform Features Documented in: Developer Guide: <Device Platform> Object API Applications (Android, ios, and Windows): Resumable Synchronization Resumable Synchronization Recommendations Disaster Recovery and Troubleshooting In 2.3 SP03, documentation has been added that describes how to: Recover from SAP Mobile Server failures see: Developer Guide: <Device Platform> Object API Applications (Android, ios, BlackBerry, and Windows) > Recovering From SAP Mobile Server Failures Troubleshoot client object API applications using API log tracing see: Troubleshooting > Troubleshooting Client Object API Application Issues Using API Log Tracing Windows CE 6.0 Support Object API application development is now supported on Windows CE 6.0. For dependencies, see Client Application Dependencies in Developer Guide: <Device Platform> Object API Applications (Windows). ios Object API Application Support for ios7 Devices ios OAPI applications built with SAP Mobile SDK version 2.3 SP03 work on ios7 devices in Apple backward compatibility mode. The Tutorial: ios Object API Application Development and Recipe Sample application have been updated accordingly. Hybrid Web Container Development New or changed features for Hybrid Web Container development. Cordova Plug-in (HTTPS Proxy) A new Cordova plugin (HTTPS Proxy) allows for X.509 mutual authentication from JavaScript. Documented in: Developer Guide: Hybrid Apps, see: Sending Requests Over HTTPS Using the HTTPS Proxy Exposed by the PhoneGap Plugin ios Hybrid Web Container APNS Notifications ios Hybrid Web Container APNS notifications always shows (1) as the badge number if there are pending notifications for relevant Application notifications. Earlier versions included badge count as part of system messages. 4 SAP Mobile Platform

9 New Platform Features ios Hybrid Web Container App Log ios Hybrid Web Container now has an App Log screen for viewing device connection status on the device. In earlier versions, ios was the only Hybrid Web Container platform that did not include this feature. onlinerequest Error Support The workflow message used to make an onlinerequest is now passed to the custom error callback handler, which was missing in earlier versions. jquery and jquery Mobile Upgraded Hybrid Apps generated with the Hybrid App Designer now use jquery Mobile version and jquery version ios Hybrid Web Container Runs in the Background The ios Hybrid Web Container is placed in the background when the Home button is pressed. In earlier releases, pressing the Home button caused the ios Hybrid Web Container to exit completely. Mobile Business Objects In 2.3 SP03, mobile business objects (MBOs) support BigString and BigBinary personalization keys, client parameters, and synchronization parameters. In earlier versions, only attributes were supported. Documented in: SAP Mobile WorkSpace - Mobile Business Object Development > Mobile Business Object Operation Properties MBO Graph Merge Using DCN This release adds the DCN merge command, which optimizes performance for certain applications, by merging an existing data graph within the SAP Mobile Server cache. A graph represents a complete composite data tree instance starting from a single root data node, while a graph part represents one level within a graph. Sublevels are not included in graph parts. If you do not use the merge command, individual DCN commands first delete each graph part within the cache, then send individual commands to reconstruct the graph within the cache. Documented in: Mobile Data Models: Using Mobile Business Objects > Merging a Composite Object Graph New Features 5

10 New Platform Features Administration New or changed features for administration. Log Correlation Utility SAP Mobile Platform now includes a command line utility (consolidate-logs.bat) for consolidating, correlating, and filtering the server log content. The utility is limited to the SAP Mobile Server and cluster logs. The utility is typically used by the SAP Mobile Platform support team, but can also be used by administrators to collect data for analysis or reporting to the support team. Documented in: Log Correlation Command Line Utility (consolidate-logs.bat) in System Administration. High Availability and Disaster Recovery In 2.3 SP03, additional information has been added to the documentation about planning your landscape based on your environment availability requirements. SAP recommends several SAP Mobile Platform scenarios, including individual development and test environment, shared development and test environment, and a fault-tolerant production environment. Documented in: Landscape Design and Integration: Assessing High Availability and Disaster Recovery Objectives Selecting a Landscape Design Based on High Availability and Disaster Recovery Requirements, and its subtopic Choosing Installation Scenarios to Implement Your Landscape Design System Administration > Backup and Disaster Recovery Troubleshooting an Unresponsive SAP Mobile Server Troubleshoot a SAP Mobile Server cluster that is unresponsive to client requests. Documented in: Troubleshooting > Troubleshooting an Unresponsive SAP Mobile Server Configuring Disk Cache Size In 2.3 SP03, you can develop client applications for resumable synchronization, which allows you to resume a long synchronization when an interruption occurs. Application developers determine whether clients can request a synchronization that resumes downloading after an interruption. The server cache stores synchronization data that has not been received by the client. The server cache must be large enough to store the data required for all resumable downloads. If the cache size is too small, the server releases the synchronization data, making it impossible to resume a synchronization. The server releases the cached download data when one of the following occurs: 6 SAP Mobile Platform

11 New Platform Features The client successfully completes the download. The client requests a synchronization without resume enabled. The cache is needed for incoming requests. The oldest unsuccessful download is cleared first. System administrators can configure the cache size using SAP Control Center. Documented in: SAP Control Center for SAP Mobile Platform: Configuring Java Virtual Machine Performance Properties Configuring Resumable Synchronization View Service Pack Information In 2.3 SP03, you can view service pack and patch information in SAP Control Center. This makes it easier to determine what service packs and patches have been installed, and to help troubleshoot upgrade problems. Documented in: SAP Control Center for SAP Mobile Platform, see Managing Service Pack Information Installation Guide for Runtime > Performing a Support Package Upgrade. Installation Guide for SAP Mobile SDK > Performing a Support Package Upgrade on an Existing SAP Mobile SDK Installation Security New or changed security-related features. X.509 Support In 2.3 SP03, all client types (replication, messaging, Hybrid Web Container, and OData native) can use HTTPS with mutual certificate authentication to authenticate at the network edge (relay server or third-party intermediary reverse proxy server). Administrators can now manage certificates from SAP Control Center: list, import, export, and delete certificates for the keystore. You can also use the imported certificate alias for security components (select an alias instead of typing in certificate name, password, and so forth). The keytool utility is no longer supported. Note: There is no longer a separate truststore. The JVM option property keystore and truststore both direct to keystore.jks file. Documented in: SAP Control Center for SAP Mobile Platform > Managing Certificates for SSL Encryption Security > X.509 Overview and Enabling HTTPS with Mutual Certificate Authentication New Features 7

12 Rebranding Developer Guide: SAP Mobile Server Runtime: Retrieve Certificates from the Key Store Import an X.509 Certificate to the Key Store Import a PKCS #12 Certificate to the Key Store Export an X.509 Certificate from the Key Store Export a PKCS #12 Certificate from the Key Store Delete a Certificate from the Key Store Developer Guide: <Device Platform> Object API Applications > Sample Code: Mutual Authentication Developer Guide: Android Object API Applications > settrustedcertificates Developer Guide: Windows and Windows Mobile Object API Applications > Importing the Private Key into the System Certificate Store Developer Guide: Hybrid Apps > Configure Connection Settings on the Device and Install and Test Certificates on Simulators and Devices Rebranding Sybase Unwired Platform and the Syclo Agentry development platform have been integrated, and the product rebranded to SAP Mobile Platform. Changes have been made to the user interface, and product documentation. See the key for new product names introduced in version SAP Mobile Platform 2.3. Table 1. Product Name Change Key Original Name Rebranded Name Comments Sybase SAP In some cases, Sybase continues to appear as a file, directory, or API name. Sybase Unwired Platform Unwired Platform SAP Mobile Platform In some cases, Sybase Unwired Platform continues to appear in file, directory, or API. Unwired Server SAP Mobile Server In some cases, Unwired Server continues to appear in a lowerlevel directory. Sybase Unwired WorkSpace Unwired WorkSpace Sybase Control Center SAP Mobile WorkSpace SAP Control Center 8 SAP Mobile Platform

13 Documentation Changes Original Name Rebranded Name Comments Sybase Hosted Relay Service Sybase Hosted Relay Server Sybase Mobile SDK Sybase Unwired Platform Runtime SAP Hosted Relay Service SAP Hosted Relay Server SAP Mobile SDK SAP Mobile Platform Runtime Documentation Changes In Fundamentals, see Documentation Roadmap to learn more about product documentation for developers and administrators. Note: Check the Product Documentation Web site regularly for updates: sybooks.sybase.com/sybooks/sybooks.xhtml? id=1289&c=firsttab&a=0&p=categories, then navigate to the most current version. Documentation Change Reference Reference for changes made throughout the documentation, sometimes over the span of several releases: Installation Path Variable the shorter installation path variable continues to be implemented: SMP_HOME represents the SAP Mobile SDK installation directory. The default installation directory is: C:\SAP\MobilePlatform. In earlier versions, this was represented as: SUP_HOME or <UnwiredPlatform_InstallDir>\UnwiredPlatform\. SCC_HOME represents the SAP Mobile Platform Runtime installation directory. The default installation directory is: C:\SAP\SCC-XX. In earlier versions, this was represented as: <UnwiredPlatform_InstallDir>\SCC-XX\. Hybrid App and Hybrid Web Container Name Changes several name changes have been made to SAP Mobile Platform to reflect the change from a workflow emphasis, to Hybrid Apps and Hybrid Web Container. These name changes can be seen in the Designer user interface, and the product documentation. See the key for new product names introduced in version SAP Mobile Platform 2.2. New Features 9

14 Documentation Changes Table 2. Hybrid App and Hybrid Web Container Name Change Key Original Name New Name Comments Workflow Workflow application Mobile Workflow package Workflow package Mobile Workflow Designer Mobile Workflow Forms Editor Mobile Workflow form Mobile Workflow Forms Editor Design palette Hybrid App Hybrid App package Hybrid App Designer, or Designer Hybrid App form Hybrid App Designer palette Close Workflow Close Menuitem type Submit Workflow Submit Menuitem type Mobile Workflow Container Sybase Messaging Client Hybrid Web Container Hybrid Web Container 10 SAP Mobile Platform