OpenSAP Mobile1 Week 04 OData Slide

Week 4 Unit 1:Introduction to SAP NetWeaverGateway

2013 SAP AG. All rights reserved. 2Public

Introduction to SAP NetWeaver GatewaySAP NetWeaver Gateway 2.0: Product Features

Service enablement

Core functionalities

Front-end development support(on SCN)

SRM SCM ERPPLMCRM

SAP Business Suite

SAP NetWeaver Gateway

SAPHANA

Consumer/channel-specific infrastructure

OData

Sync

SAP NetWeaver BW

Easy query MDX

Generation of service based on RFC,BAPI, BOR, BOL, MDX, SAP HANA,OData, ABAP, and so on

Supporting the development of newservices

Error logging, serialization, traces

Pushing of back-end events

Generation of proxy classes and startedapps for iOS, Android, PHP, Java

Code snippets


Introduction to SAP NetWeaver GatewayFrom Conceptual Model to a Mobile App

Project to definescenario (UI

mockups, flow)

Back end

Analysis of requiredback-end services

Service creation/generation/test

Front end

UI layout analysis

Implementation


Introduction to SAP NetWeaver GatewayFirst Step: Definition of the OData Model


Introduction to SAP NetWeaver GatewaySecond Step: Service Development


Introduction to SAP NetWeaver GatewayThird Step: Generate User Interface/Consumer

SAP NetWeaver GatewayProductivity Accelerator(for Microsoft) to supportcreation of list/detail starterprojects (source code) for:y HTML5 (jQuery or SAPUI5)y PHPy Android*y iOS*y Java SE

* SAP Mobile Platform libraries included, which allows communication via SAP Mobile Platform orSAP NetWeaver Gateway

Thank you

Contact information:

[email protected]


2013 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.

National product specifications may vary.

These materials are provided by SAP AG and its affiliated companies ("SAP Group") for informational purposes only, without representation orwarranty of any kind, and SAP Group shall not be liable for errors or omissions with respect to the materials. The only warranties for SAP Groupproducts and services are those that are set forth in the express warranty statements accompanying such products and services, if any. Nothingherein should be construed as constituting an additional warranty.

SAP and other SAP products and services mentioned herein as well as their respective logos are trademarks or registered trademarks of SAP AG inGermany and other countries.Please see http://www.sap.com/corporate-en/legal/copyright/index.epx#trademark for additional trademark information and notices.







Week 4 Unit 2:Introduction to the ODataProtocol


SAPBusiness

Suite

SAP NetWeaver Gateway

Introduction to the OData ProtocolArchitecture of the World Wide Web

Desktop / HTML5 / Mobile or Web App UI

OData SDK

OData Services

SAPNetWeaver

BW

OData

OData

Application / UI

Connector

Web Infrastructure

Connector

Business Logic

R

RHTTP, uniform protocols

HTTP, uniform protocols

Client

Server


Introduction to the OData ProtocolFirst OData Example: The Service Document

OData service root URI:https://sapes1.sapdevcenter.com/sap/opu/odata/sap/ZGWSAMPLE_SRV/

BusinessPartner

SalesOrder

SalesOrderLineItem

ProductContact

1

n

n

1

1

n

1

1n

n


Introduction to the OData ProtocolFirst OData Example: The Service Document (2)


Introduction to the OData ProtocolFirst OData Example: The Service Metadata Document

OData service root URI:https://sapes1.sapdevcenter.com/sap/opu/odata/sap/ZGWSAMPLE_SRV/

OData service metadata URI := + $metadata

https://sapes1.sapdevcenter.com/sap/opu/odata/sap/ZGWSAMPLE_SRV/$metadata


Introduction to the OData ProtocolEntity Data Model: Overview

http:////SalesOrderItemshttp:////


Introduction to the OData ProtocolOData Operations

y Read collections of entities.

y Read entities.

y Follow relationships.

y Create new entities.

y Update or delete entities.


Introduction to the OData ProtocolHow to Find the Right Conceptual Model

y GET ~/BusinessPartners


Introduction to the OData ProtocolBusiness Partner Details and Sales Orders of a Business Partner

y GET ~/BusinessPartners(0100000000)


Introduction to the OData ProtocolList of Sales Orders

y GET ~/BusinessPartners(0100000000)/SalesOrders


Introduction to the OData ProtocolSales Order Items

y GET ~/SalesOrders(0500000000)/SalesOrderItemsy GET ~/SalesOrderItems(SalesOrderID=0500000000,Position=0000000020)


Introduction to the OData ProtocolShow Product Details

y GET ~/SalesOrderItems(SalesOrderID=0500000000,Position=0000000020)/Product


Introduction to the OData ProtocolGET /BusinessPartnerCollection Read an Entity Set

https://sapes1.sapdevcenter.com/sap/opu/odata/sap/ZGWSAMPLE_SRV?sap-ds-debug=true


Introduction to the OData ProtocolCRUD Operations

Operation on Resource HTTP Verb

Create POST

Read GET

Update PUT

Delete DELETE


$batch

Introduction to the OData ProtocolCRUD Operations (2)

POST $batch(multiple requests) : multiple responses

GET() : entryPUT(etag, entry) : nilPATCH(etag, partial entry) : nilDELETE() : nil

GET() : feedPOST(entry) : entry

Thank you


[email protected]

Week 4 Unit 3:OData Query Options


OData Query OptionsODBC for the Web: Simple Query Language

List of (most important) query options:

Reference: http://www.odata.org/developers/protocols/uri-conventions#QueryStringOptions

Operation Query OptionFiltering $filter

Projecting $select

Sorting $orderby

Paging $top and $skip

Inlining $expand


OData Query Options$filter and $select

ID Name

0100 SAP

0141 South AmericanIT Company

0142 Siwusha

0143 Sorali

Business Partners (4)

W1 2 3 4 5 X 01/04

S*

Filtering $filterhttps://sapes1.sapdevcenter.com/sap/opu/odata/sap/ZGWSAMPLE_SRV/BusinessPartnerCollection?$filter=startswith(CompanyName,'S')

y Get all business partners whose company name startswith the letter S.

Projecting $selecthttps://sapes1.sapdevcenter.com/sap/opu/odata/sap/ZGWSAMPLE_SRV/BusinessPartnerCollection?$select=BusinessPartnerID,CompanyName

y In a response from an OData service, only the ID and Name Propertyvalues are returned for each business partner entry in the collection ofbusiness partners identified (because the UI only displays theseproperties).


OData Query OptionsQuery Options: $filter & $select

Request:GET /BusinessPartners?$filter=startswith(CompanyName,S)&

$select=BusinessPartnerID,CompanyName

Result{

"BusinessPartnerID": "0100000000","CompanyName": "SAP},

{"BusinessPartnerID": "0100000041","CompanyName": "South American IT Company},

{"BusinessPartnerID": "0100000042","CompanyName": "Siwusha},

{"BusinessPartnerID": "0100000044","CompanyName": "Sorali}

SQL analogy:

SELECT BusinessPartnerID CompanyNameFROM BusinessPartnersWHERE CompanyName LIKE S%


OData Query OptionsODBC for the Web: Simple Query Language (2)

Sorting $orderby

https://sapes1.sapdevcenter.com/sap/opu/odata/sap/ZGWSAMPLE_SRV/BusinessPartnerCollection?$orderby=CompanyName

y All business partners are returned in ascendingorder when sorted by their company name.


OData Query OptionsPaged Results

ID Name

0100 SAP

0101 Becker Berlin

0102 DelBontIndustries

0103 Talpa

0104 PanoramaStudios

0105 TECUM

W1 2 3 4 5 X 01/06

ID Name

0106 Asia High tech

0107 Laurent

0108 AVANTEL

0109 Telecomunicaciones Star

0110 Pear ComputingServices

0111 Alpine Systems

Business Partners (45) Business Partners (45)

W1 2 3 4 5 X 07/12

ID Name

0112 New Line Design

0113 HEPA Tec


0115 Anav Ideon

0116 Mexican OilTrading Company

0117 Meliva

Business Partners (45)

W1 2 3 4 5 X 13/18

Use case:Tell the user that just 6 out of45 entries are displayed.Show a list in a paged view.Get the first 6 entries of a listonly.Avoid scrolling through longlists in mobile applications.


OData Query OptionsQuery Options: $top and $inlinecount

ID Name

0100 SAP

0101 Becker Berlin


0103 Talpa


0105 TECUM

W1 2 3 4 5 X 01/06

BusinessPartners (45)

Client-side paging:

Only a limited amount ofdata has to betransferred.

/BusinessPartnerCollection?

$top=6&$inlinecount=allpages&$select=BusinessPartnerID,CompanyName


OData Query OptionsQuery Options: $top and $inlinecount and $skip

ID Name

0100 SAP

0101 Becker Berlin


0103 Talpa


0105 TECUM

W1 2 3 4 5 X 01/06

ID Name

0106 Asia High tech

0107 Laurent

0108 AVANTEL



0111 Alpine Systems

BusinessPartners (45) BusinessPartners (45)

W1 2 3 4 5 X 07/12


$top=6&$inlinecount=allpages&$select=BusinessPartnerID,CompanyName&$skip=6


OData Query OptionsQuery Options: $top and $inlinecount and $skip (2)

ID Name

0100 SAP

0101 Becker Berlin


0103 Talpa


0105 TECUM

W1 2 3 4 5 X 01/06

ID Name

0106 Asia High tech

0107 Laurent

0108 AVANTEL



0111 Alpine Systems

BusinessPartners (45) BusinessPartners (45)

W1 2 3 4 5 X 07/12

ID Name

0112 New Line Design

0113 HEPA Tec


0115 Anav Ideon

0116 Mexican OilTrading Company

0117 Meliva

BusinessPartners (45)

W1 2 3 4 5 X 13/18


$top=6&$inlinecount=allpages&$select=BusinessPartnerID,CompanyName&$skip=12


OData Query OptionsQuery Options: $top and $inlinecount and $skip (3)

https://sapes1.sapdevcenter.com/sap/opu/odata/sap/ZGWSAMPLE_SRV/BusinessPartnerCollection?$top=6&$inlinecount=allpages&$select=BusinessPartnerID,CompanyName&sap-ds-debug=true

https://sapes1.sapdevcenter.com/sap/opu/odata/sap/ZGWSAMPLE_SRV/BusinessPartnerCollection?$top=6&$inlinecount=allpages&$select=BusinessPartnerID,CompanyName&$skip=6&sap-ds-debug=true

https://sapes1.sapdevcenter.com/sap/opu/odata/sap/ZGWSAMPLE_SRV/BusinessPartnerCollection?$top=6&$inlinecount=allpages&$select=BusinessPartnerID,CompanyName&$skip=12&sap-ds-debug=true


OData Query Options$expand

Use cases for navigation properties:Get all sales orders of a business partner.Get all sales order items of a sales order.Get all sales orders and all sales order items of abusiness partner.

Example:Without $expand 2 callsy First call /BusinessPartners(1)y Second call /BusinessPartners(1)/SalesOrders

With $expand 1 cally /BusinessPartners(1)?$expand=SalesOrders

SalesOrder#n

SalesOrderItem #1

SalesOrderItem #2

SalesOrderItem #n

SalesOrder#1

SalesOrderItem #1

SalesOrderItem #2

SalesOrderItem #n

BusinessPartner#1

SalesOrder#1

BusinessPartner#2


OData Query OptionsODBC for the Web: Simple Query Language (3)

Inlining $expand

https://sapes1.sapdevcenter.com/sap/opu/odata/sap/ZGWSAMPLE_SRV/BusinessPartnerCollection('0100000002')?$expand=SalesOrders

y Identifies a single BusinessPartneras well as each of the SalesOrdersassociated with thatBusinessPartner


OData Query OptionsDeep Insert

Updates of hierarchical data

Example:

Create a sales order together with salesorder items in just one request.

SalesOrder

SalesOrderItem#1

SalesOrderItem#2

SalesOrderItem#n

Thank you


[email protected]

Week 4 Unit 4:Modeling of OData Services


Modeling of OData ServicesArchitectural Overview: SAP NetWeaver Gateway Productivity Accelerator

Eclipse-based

Support for various consumersy HTML5y iOSy Androidy Javay PHP

OData modeler

Custom UI Add-On

HTML5App

Android/iOS App

Java,PHP

Eclipse

Consumer Layer

Productivity Accelerator

SAP NetWeaver

SAP Business Systems

SAP NetWeaver Gateway 2.0ServiceBuilder GW Core

GWContent


Modeling of OData ServicesOData Modeler

Graphical modelery Open OData Perspective.y Create a project.y Create a new OData model.y Export OData model.


Modeling of OData ServicesOData Perspective

Contenty xxx


Modeling of OData ServicesCreating a New OData Model

Direct integration intoEclipse

Various sources forOData model creationy Empty modely Metadata URLy Metadata Filey Service catalog


Modeling of OData ServicesOData Modeler (2)

Graphical Modelery Entitiesy Propertiesy Complex typesy Function importy Associations

Exportingy OData V2, V2 for SAP, OData V3


Modeling of OData ServicesAvailability

Available at:

https://tools.hana.ondemand.com/#gateway

Thank you


[email protected]

Week 4 Unit 5:How to Implement a GatewayService


How to Implement a Gateway ServiceIntroduction to SAP NetWeaver Gateway Service Builder

y Available as of SAP NetWeaver Gateway 2.0 SP4; many enhancements with SP5y Contained in add-on IW_BEP

Strong ABAP skillsFew or no ABAP skills


How to Implement a Gateway ServiceImport OData File into the Service Builder (SEGW)


How to Implement a Gateway ServiceGenerate Service


How to Implement a Gateway ServiceService Implementation

Implement CRUD methods

y CREATE_ENTITY

y READ GET_ENTITYSET (list) GET_ENTITY (single entry)

y UPDATE_ENTITY

y DELETE_ENTITY


How to Implement a Gateway ServiceTest and Activate the Service

y Gateway client

y Browser Use query option sap-ds-debug=true

y REST client


How to Implement a Gateway ServiceGet Your Own Gateway Demo System

See the following SCN document for more details:http://scn.sap.com/docs/DOC-41566

Thank you


[email protected]

Week 4 Unit 6: Generating anAndroid Application for an ODataService


Generating an Android Application for an OData ServiceSAP NetWeaver Gateway Productivity Accelerator: Toolkit for Android

Eclipse plug-in available at:https://tools.hana.ondemand.com/juno

Toolkits available for the followingplatforms:y Android*y HTML5 (SAPUI5 and jQuery)y iOS*y Java Platform, Standard Editiony PHP

* SAP Mobile Platform supportoptionally possible


Generating an Android Application for an OData ServiceTemplates: Android Starter Application

Starter applicationsy Basicy List/Detailsy Workflow


Generating an Android Application for an OData ServiceGenerate a Starter Application with a Few Clicks

Open Service Catalog (ODataPerspective).

Generate starter application project.

Select application template.

Define activities and select fields.

Generate the application.

Optionally enhance the application.


Generating an Android Application for an OData ServiceApp Overview

Login screen Product list Product details Supplier details

Thank you


[email protected]














openSAP_Mobile1_Week_4_Unit_1_Presentation_INTRONWGWopenSAP_Mobile1_Week_4_Unit_2_Presentation_INTROODPopenSAP_Mobile1_Week_4_Unit_3_Presentation_ODQOopenSAP_Mobile1_Week_4_Unit_4_Presentation_MODODSEopenSAP_Mobile1_Week_4_Unit_5_Presentation_IMPLGWSERVopenSAP_Mobile1_Week_4_Unit_6_Presentation_ANDAPP

Documents

OpenSAP Mobile1 Week 04 OData Slide