Week 1 Unit 7: SAP Mobile

Platform SDK Overview

SAP Mobile Platform SDK Overview

One SDK across cloud and on-premise versions
SAP Mobile
Platform SDK
One common SDK to span across
different deployment platforms and versions

HCPms

SAP Mobile Platform 2.3*

SAP Mobile Platform 3

Seamless operation across multiple back ends

* SAP Mobile Platform 2.3 supports original OData SDK APIs
2015 SAP SE or an SAP affiliate company. All rights reserved.

Public

SAP Mobile Platform SDK Overview

SAP Mobile Platform SDK features

2015 SAP SE or an SAP affiliate company. All rights reserved.

Public

SAP Mobile Platform SDK Overview

Support for all major operating systems

Native SDK and Apache Cordova

plugins (Kapsel)

Mobile platform REST APIs can be

used on all other platforms

iOS 6+

BlackBerry

Android 4+

Older Windows

Windows 8.1/Windows Phone 8.1

Etc.

2015 SAP SE or an SAP affiliate company. All rights reserved.

Public

SAP Mobile Platform SDK Overview

Moving forward but supporting the past
Client App
Third-Party
SDK

SDK

Harmonized
API

Kapsel

OData SDK

REST API*

SAP
Mobile
Platform
or HCPms

SAP Mobile Platform 3.0 or

HCPms

* SAP or NON-SAP SDK

Offline
Local Persistence and Cache

2015 SAP SE or an SAP affiliate company. All rights reserved.

Connectivity
Security

OData Service

Supportability and Configuration

Push Notifications
Public

SAP Mobile Platform SDK Overview

SAP Mobile Platform 3.0 SDK support packs

SP7
SP6

E2E Trace plugin for Kapsel

Technical cache for

Windows 8.1/Windows
Phone 8.1

Offline OData service

Windows 8.1 and Windows

Phone 8.1

Technical cache
enhancements

Windows 8.1 and

Windows Phone 8.1

Android 4.4 support

Android 5.0 support

Kapsel Calendar, Printer,

Attachment Viewer plugins

Kapsel offline support for

Windows 8.1/Windows
Phone 8.1

SP4/5
Harmonized API
Bug fixes

Technical cache for

Android/iOS

Offline for Windows 8.1 and

Windows Phone 8.1

Android 4.4 support

Kapsel offline support
Support for Apache
Cordova 3.5

2015 SAP SE or an SAP affiliate company. All rights reserved.

Support for Apache Cordova

3.6

Support for feature vector

Support for Apache

Cordova 4.2

Public

SAP Mobile Platform SDK Overview

Harmonized OData API overview
Provide a developer friendly API that
Is focused on the OData interface
Hides OData implementation details such as:
Fetching the OData service document and metadata
No need to worry about assembling OData results
(e.g., parsing Atom/XML or JSON)

Mapping of OData data types to native objects

Supports both online and offline access
Supported devices: iOS, Android, Windows 8.1,
Windows Phone 8.1

2015 SAP SE or an SAP affiliate company. All rights reserved.

Public

SAP Mobile Platform SDK Overview

Harmonized OData API online and offline store

Application
ODataStore API (send/recv OData req:
CREATE, READ, ...)
Payload API (Entity, Feed, ...)
ODataStore lifecycle API

Online Store

Parser

Request

2015 SAP SE or an SAP affiliate company. All rights reserved.

Metadata API (serviceDoc, metadata)

ODataAPI lib

ODataStore lifecycle API

Offline Store

Parser

UltraLite DB

Public

SAP Mobile Platform SDK Overview

Offline OData service

Always-available applications, OData everywhere,

harmonized online/offline API, integration with SAP
Mobile Platform services (authentication, supportability,
manageability)

HCPms
OData Offline Service

Features

UltraLite as client database (iOS, Android)

Optimized for OData services supporting v4 delta query

Middle-tier delta enablement for all other OData services

Middle-tier caching of generic OData collections

2015 SAP SE or an SAP affiliate company. All rights reserved.

OData Producer
Third Party

SAP HANA
Cloud Platform

Take remote OData services and run them locally on

device
SAP Gateway/
SAP Business
Suite

HCI OData
Provisioning

SAP Mobile Platform SDK

SAP HANA
extended
application
services

Benefits

Public

SAP Mobile Platform SDK Overview

Logon component
Makes authenticating and onboarding simple

Hides the complexity of authentication and

onboarding

Supports all SAP Mobile Platform/HCPms

authentication methods

Integrated with SAP Afaria, Client Hub, SAP

Mobile Place

Supports user pin to access the application

2015 SAP SE or an SAP affiliate company. All rights reserved.

Public

10

SAP Mobile Platform SDK Overview

Kapsel
Kapsel is a set of SAP-specific plugins for
Apache Cordova

Third-party plugin
Third-party plugin
AppUpdate

Provides enterprise capabilities to a

Cordova application

Supports Android (4.0+), iOS (6.0+),

Windows 8.1/Windows Phone 8.1
A single Web application can be provisioned
into the container

EncryptedStorage

Apache
Cordova

Logger
Logon

Push
OData
E2E

Kapsel Plugins

Fits cleanly within existing Cordova

development environments and processes

AuthProxy

Barcode Scanner
Online App
App Prefs
2015 SAP SE or an SAP affiliate company. All rights reserved.

Public

11

SAP Mobile Platform SDK Overview

SAP Fiori consumption option via SAP Mobile Platform
Desktop and mobile Web browser
(HTML5)
SAP Fiori Client mobile app
Improves caching, lifecycle management,
etc. (SAP Mobile Platform optional)

Enhanced with SAP Mobile Platform 3.0;

optimized for deployment in enterprise
infrastructure

SAP Mobile Platform as proxy for

SAP Fiori and SAP Fiori Client
Leverage SAP Mobile Platforms proxy
capability
Requires a patch to SAP Mobile Platform
2.3 and 3.0

SAP Fiori + Kapsel SDK

Desktop & Mobile

Web Browser
(HTML5)
Client Runtime

SAP Fiori
Client mobile
app

Desktop & Mobile

Web Browser
(HTML5)

SAP Fiori &

Kapsel SDK

Server Runtime

SAP Mobile Platform

SAP Gateway/SAP HANA Cloud Platform
SAP Business Suite

OData

Any DB / SAP HANA

SAP Enterprise plugins for mobile apps

2015 SAP SE or an SAP affiliate company. All rights reserved.

Public

12

SAP Mobile Platform SDK Overview

SAP Fiori Client
The SAP Fiori Client brings enhanced mobile support
for SAP Fiori.
Available on app stores or wrap your own
Caches content for enhanced performance
Can be integrated with SAP Mobile Platform/SAP HANA
Cloud Platform mobile services
Based on Apache Cordova and Kapsel plugins
Build your own Fiori Client with own branding

2015 SAP SE or an SAP affiliate company. All rights reserved.

Public

13

SAP Mobile Platform SDK Overview

SAP Mobile Platform REST API

2015 SAP SE or an SAP affiliate company. All rights reserved.

Public

14

SAP Mobile Platform SDK Overview

Onboarding
URL: https://<host:port>/odata/applications/{latest|v1}/<appid>/Connections
HTTP Verb: POST
Body:
<?xml version="1.0" encoding="UTF-8" ?>
<entry xmlns="http://www.w3.org/2005/Atom"
xmlns:m="http://schemas.microsoft.com/ado/2007/08/dataservices/metadata"
xmlns:d="http://schemas.microsoft.com/ado/2007/08/dataservices">
<content type="application/xml">
<m:properties>
<d:DeviceType>Android</d:DeviceType>
</m:properties>
</content>
</entry>

2015 SAP SE or an SAP affiliate company. All rights reserved.

Public

15

SAP Mobile Platform SDK Overview

Get application settings
URL:
https://<host:port>/odata/applications/{latest|v1}/<appid>/Connections('<appcid>')
HTTP Verb: GET
Response returns all users application settings

2015 SAP SE or an SAP affiliate company. All rights reserved.

Public

16

SAP Mobile Platform SDK Overview

Update application settings
URL:
https://<host:port>/odata/applications/{latest|v1}/<appid>/Connections('<appcid>')
HTTP Verb: PUT
Request Body:
<?xml version="1.0" encoding="UTF-8"?>
<entry >
<m:properties>

<d:AndroidGcmRegistrationId>GCM_VALUE</d:AndroidGcmRegistrationId>
</m:properties>
</content>
</entry>

2015 SAP SE or an SAP affiliate company. All rights reserved.

Public

17

SAP Mobile Platform SDK Overview

Access services through proxy reading data
URL:
https://<host:port>/[public/]/{connectionName}/[Collection]
HTTP Verb: GET
HTTP Headers: X-SMP-APPCID: <APPCID>
Response Service Data being requested

2015 SAP SE or an SAP affiliate company. All rights reserved.

Public

18

SAP Mobile Platform SDK Overview

Access SAP OData services through proxy updating data
URL:
https://<host:port>/[public/]/{connectionName}/[Collection]
HTTP Verb: POST / PUT / DELETE
HTTP Headers:

X-SMP-APPCID: <APPCID>
X-CSRF-TOKEN: <CSRF Token> (Needed for SAP Services)

Response depends on method

POST returns created entity (response code 201)
PUT returns nothing (response code 204)
DELETE returns nothing (response code 200)
2015 SAP SE or an SAP affiliate company. All rights reserved.

Public

19

SAP Mobile Platform SDK Overview

Retrieving resource bundles
URL:
https://<host:port>/[public/] bundles/{appid}/[{resourceBundleName:Version}]
HTTP Verb: GET
Response Binary Stream

2015 SAP SE or an SAP affiliate company. All rights reserved.

Public

20

SAP Mobile Platform SDK Overview

Recap week 1: Mobility @ SAP
SAP Fiori is a great first step to mobilizing your
company!
SAP HANA Cloud Platform is a Platform as a
Service Offering and support mobility with the
SAP HANA Cloud Platform mobile services
(HCPms).
The SAP Mobile Platform SDK supports Hybrid
and Native Mobile Application Development.

2015 SAP SE or an SAP affiliate company. All rights reserved.

Public

21

Thank you

Contact information:
open@sap.com

 2015 SAP SE or an SAP affiliate company. 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 SE or an SAP affiliate company.
SAP and other SAP products and services mentioned herein as well as their respective logos are trademarks or registered trademarks of SAP SE (or an SAP affiliate
company) in Germany and other countries. Please see http://global12.sap.com/corporate-en/legal/copyright/index.epx for additional trademark information and notices.
Some software products marketed by SAP SE and its distributors contain proprietary software components of other software vendors.
National product specifications may vary.
These materials are provided by SAP SE or an SAP affiliate company for informational purposes only, without representation or warranty of any kind, and SAP SE or its
affiliated companies shall not be liable for errors or omissions with respect to the materials. The only warranties for SAP SE or SAP affiliate company 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 an additional warranty.
In particular, SAP SE or its affiliated companies have no obligation to pursue any course of business outlined in this document or any related presentation, or to develop
or release any functionality mentioned therein. This document, or any related presentation, and SAP SEs or its affiliated companies strategy and possible future
developments, products, and/or platform directions and functionality are all subject to change and may be changed by SAP SE or its affiliated companies at any time
for any reason without notice. The information in this document is not a commitment, promise, or legal obligation to deliver any material, code, or functionality. All forwardlooking statements are subject to various risks and uncertainties that could cause actual results to differ materially from expectations. Readers are cautioned not to place
undue reliance on these forward-looking statements, which speak only as of their dates, and they should not be relied upon in making purchasing decisions.

2015 SAP SE or an SAP affiliate company. All rights reserved.

Public

23