purposesapidp/... · web viewin particular, sap se or its affiliated companies have no obligation...

SAP S/4HANA

Dec 2016

English

Integration Scenario Between SAP S/4HANA and SAP HANA Cloud Platform

SAP SEDietmar-Hopp-Allee 1669190 WalldorfGermany

Building Block Configuration Guide

SAP Best Practices

Integration Scenario between SAP S/4HANA and SAP HANA Cloud Platform

Copyright

© 2016 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://global.sap.com/corporate-en/legal/copyright/index.epx#trademark 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 SE’s 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 forward-looking 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.

© SAP SE of

http://global.sap.com/corporate-en/legal/copyright/index.epx#trademark

SAP Best Practices


Icons

Icon Meaning

Caution

Example

Note

Recommendation

Syntax

External Process

Typographic Convention

Type Style Description

Example Words or characters quoted from the screen. These include field names, screen titles, pushbuttons labels, menu names, menu paths, and menu options.Textual cross-references to other documents.

Example Emphasized words or expressions.

EXAMPLE Technical names of system objects. These include report names, program names, transaction codes, table names, and key concepts of a programming language when they are surrounded by body text, for example, SELECT and INCLUDE.

Example Output on the screen. This includes file and directory names and their paths, messages, names of variables and parameters, source text, and names of installation, upgrade and database tools.

Example Exact user entry. These are words or characters that you enter in the system exactly as they appear in the documentation.

<Example> Variable user entry. Angle brackets indicate that you replace these words and characters with appropriate entries to make entries in the system.

EXAMPLE Keys on the keyboard, for example, F2 or ENTER .

© SAP SE of

SAP Best Practices


Contents1. Purpose.................................................................................................................................. 52. Prerequisites.......................................................................................................................... 53. Configuration.......................................................................................................................... 5

3.1 Configure Web IDE on SAP HANA Cloud Platform.......................................................53.1.1 Enabling the SAP Web IDE and Portal Service in SAP HANA Cloud Platform..........5

3.1.2 Create Your First Fiori Launchpad Site (optional)......................................................6

3.1.3 Opening SAP Web IDE for the First Time..................................................................7

3.1.4 Entering the Git User Settings (Optional)...................................................................7

3.1.5 Installing and Configuring the SAP HANA Cloud Connector......................................7

3.1.6 Connecting the Remote Systems.............................................................................11

3.2 SAP Fiori Overview Page Package..............................................................................123.3 SAP Smart Business Service.......................................................................................13

3.3.1 Enabling SAP Smart Business Service....................................................................13

3.3.2 Smart Business Modeler Apps.................................................................................15

3.3.2.1 Create a New Destination................................................................................15

3.3.2.2 Using Create KPI.............................................................................................16

3.3.2.3 Using Create Evaluation..................................................................................17

3.3.2.4 Using Configure KPI Tiles................................................................................18

3.3.2.5 Using Configure KPI Drill-Down.......................................................................19

3.3.2.6 Add Tile to Home.............................................................................................20

3.3.2.7 Export a KPI or OPI (Optional).........................................................................20

3.3.2.8 Import a KPI or OPI (Optional).........................................................................21

© SAP SE of

SAP Best Practices


Integration Scenario Between SAP S/4HANA and SAP HANA Cloud Platform

1. PurposeThe purpose of this document is to describe the configuration steps required to build a SAP Fiori Analytics APP based on OData from SAP S/4HANA system.

2. PrerequisitesBefore you start the configuration of Integration Scenario between SAP S/4HANA and SAP HANA Cloud Platform, you need to make sure following system configurations are finished.

User Access for SAP S/4HANA system User Access for SAP HANA Cloud Platform with Developer and Cloud Connector Admin

roles assigned. The SAP HANA Cloud Platform is able to enable the corresponding services, for

example SAP Portal service, SAP Web IDE and SAP Smart Business Service.

3. Configuration3.1 Configure Web IDE on SAP HANA Cloud Platform3.1.1 Enabling the SAP Web IDE and Portal Service in SAP

HANA Cloud PlatformUseThe purpose of this section is to describe the steps of opening the SAP HANA Cloud system and enabling the SAP Web IDE service.

Procedure 1. Open SAP HANA Cloud Platform cockpit through the following links, in this case we log on in

Productive use (United States East).Option Description

Productive use

https://account.hana.ondemand.com /cockpit ( Europe)

https://account.us1.hana.ondemand.com( United States East)

https://account.us2.hana.ondemand.com( United States West)

https://account.ap1.hana.ondemand.com( Asia-Pacific)Trial use https://account.hanatrial.ondemand.com /cockpit

2. Click Log on.3. Enter the Username and Password. The user is an account member.4. Click Log on.5. In SAP HANA Cloud Platform Cockpit screen, click Services in the left navigation panel.

Initially when you log in, you will be in a different path. So follow the hierarchy Data center Global account Account, for example US East SaKP MS team SaKP.

© SAP SE of

https://account.hanatrial.ondemand.com/cockpit

https://account.ap1.hana.ondemand.com/

https://account.us2.hana.ondemand.com/

https://account.us1.hana.ondemand.com/

https://account.hana.ondemand.com/

SAP Best Practices

Integration Scenario between SAP S/4HANA and SAP HANA Cloud Platform6. Click on the tile SAP Web IDE in Dev &Ops group, you can see the icon on the top left

corner is grey and shows Not enabled .

7. Click on the Enable button to subscribe this service.8. Back to Service screen, click on the tile Portal Service in User Experience group.

9. Click on Enable button to subscribe this service.10. After the service is enabled, click on Configure Portal Service to check whether the role TENANT_ADMIN has been assigned to your account user.11. Select Roles in left pane.12. Select the role TENANT_ADMIN.13. In Individual Users list and Groups list, you can see the User IDs and Groups which the role has been assigned to. 14. Check whether your user id or the Group your user belong to is already in the Individual Users list or Groups list.15. If not, connect to your system administrator.

TENANT_ADMIN role must be assigned to user in order to register created apps to Fiori Launchpad and subscribe to SAP Smart Business Service. If you subscribe to Portal Service, by default TENANT_ADMIN role is assigned to your user. In case SAP HANA Portal Service is already subscribed previously, your user may not have TENANT_ADMIN role. In this case, you need to connect to system administrator to assign the TENANT_ADMIN role manually.

ResultThe Service Web IDE and Portal are enabled.

3.1.2 Create Your First Fiori Launchpad Site (optional)UseThis is an optional section. The purpose of this section is to describe how to create Fiori Launchpad Site. By default there will be a default Fiori Launchpad Site named Default after the Portal Service is enabled. If you want to create your own Fiori Launchpad site, you can refer to this section.

You must have the TENANT_ADMIN role to create a new site.

Procedure 1. Log on to the SAP HANA Cloud Platform cockpit.2. Go to SAP HANA Cloud Platform account.3. Click on Services section in left pane.4. Click on Portal Service tile in the User Experience group.5. Click on Go to Service.6. You will log on to SAP HANA Cloud Platform, Portal Service in a new tab.7. Click on Site Directory section in left pane.

8. Click plus icon to create a new Fiori Launchpad site.9. In Create Site dialog, enter a name for the site in *Site Name box, for example MyDefault.10. Select SAP Fiori Launchpad as site template.11. Click on Create, a new web page will be opened where you can set up this Fiori Launchpad Site.

© SAP SE of

SAP Best Practices


12. In the new page, click on Publish site button in the top-right of the screen.13. In the WARNING dialog, click on Publish.

ResultA new Fiori Launchpad Site has been created and published.

3.1.3 Opening SAP Web IDE for the First TimeUseThe purpose of this section is to describe the steps of opening SAP Web IDE tool.

Procedure 1. Login to the SAP HANA Cloud Platform cockpit.2. In SAP HANA Cloud Platform Cockpit screen, click Services in the left navigation panel.3. Click on the tile SAP Web IDE. You can see the icon turns green and shows Enabled.4. Click Open SAP Web IDE.

Opening multiple instances of SAP Web IDE in parallel may cause issues. For Known Issues, see Known Issues. You would also find more information at https://help.hana.ondemand.com/webide/frameset.htm?51321a804b1a4935b0ab7255447f5f84.html .

ResultYou can see your SAP Web IDE tool is getting loaded.

3.1.4 Entering the Git User Settings (Optional)UseBefore SAP Web IDE tool can be used with Git, you need to provide some information related to your name and your email address. The purpose of this section is to describe the steps of entering the Git User Setting.

Procedure 1. Open SAP Web IDE.

2. Choose Preferences .3. Select Git Settings.4. In Git Settings section, enter your name and your email address in Git Email Adress: box

and Git User Name: box.5. Click on Save.

ResultNow you can use SAP Web IDE tool with Git.

3.1.5 Installing and Configuring the SAP HANA Cloud Connector

UseSAP Web IDE is ready, but it cannot connect to remote systems yet. The steps listed in this section and in the next one, will do the job. You need to configure the SAP

© SAP SE of

https://help.hana.ondemand.com/webide/frameset.htm?51321a804b1a4935b0ab7255447f5f84.html

SAP Best Practices

Integration Scenario between SAP S/4HANA and SAP HANA Cloud PlatformHANA Cloud Connector in order to connect the destinations, which you are going to define in the next section, with the required systems.

Procedure 1. Download the SAP HANA Cloud Connector from the link

https://tools.hana.ondemand.com/#cloud2. Once download, unzip the installer package and move the resulting folder in a suitable place

on your local machine.

For windows you have also an installer package (the one with the .msi extension). If you use it, you can skip step 2.3. Go inside the extracted installer package folder.4. Run the file go.sh (or go.bat in case of Windows OS).5. When the Connector is started you should see the osgi> prompt.

If you need to close the Connector, you can simply type “close” in this console and the Connector will be closed6. Open browser (for example Google Chrome) and go to the link https://localhost:8443.

If you get the error: “Your connection is not private”, click on Advanced. This error comes because you don’t have yet any valid certificate for this localhost server. Click on Proceed to localhost(unsafe).7. Enter the following credentials in SAP HANA Cloud Connector Login dialog.

Parameters ValueUser Name Administrator

Password manage

8. Click on Login.9. In Choose Installation Type dialog box, choose Master (Primary Installation) as

the installation type since this is your first time you are installing the product and this is the only SAP HANA Cloud Connector in your system.

10. Click on Apply.11. In Mandatory Password Change dialog box, you need to change the password

because this is the first time you log in. Parameters Value

Old Password:* enter your old password manage

New Password:* enter a new passwordRepeat New Password:*

repeat the new password

12. Click on Save.13. In Set Up Initial Configuration dialog box, Provide the following initial

configuration.Parameters ValueLandscape Host:* select the landscape host which depend on how you log

on to the SAP HANA Cloud Platform, for example us1.hana.ondemand.com

The productive landscape is available on a regional basis,

© SAP SE of

https://localhost:8443/

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

SAP Best Practices

Integration Scenario between SAP S/4HANA and SAP HANA Cloud Platformwhere each region represents the location of a data center:

· Europe: hana.ondemand.com· United States: us1.hana.ondemand.com(US

East) and us2.hana.ondemand.com(US West)· Asis-Pacific: ap1.hana.ondemand.com

Account Name:* enter your account name on the landscape host

Display Name:Optional, you can define a Display Name, which allows you to easily recognize a specific account compared to the technical Account Name.

Account User:* enter your user name on the landscape hostPassword:* enter your passwordHost: only if required ( for SAP users is “proxy”)Port: only if required (for SAP users is “8080”)

For Account Name, Account User and Password, enter the values you obtained when you registered your account on SAP HANA Cloud Platform or add a new Account User with role Cloud Connector Admin from the Members tab in the SAP HANA Cloud cockpit and use the new user and password.

HTTPS Proxy information is only needed if you are in a network that requires a proxy, for example the SAP network.14. Click on Apply.15. The landscape is configured. Now you need to add some mappings with the real

systems. Click on Access Control in SAP HANA Cloud Connector Administration screen.

16. Click on Add… in the Mapping Virtual To Internal System section.17. In Add System Mapping dialog box, select back-end type of on-premise system,

for example ABAP System.18. Click Next.19. Select Protocol HTTPS for communication with on-premise system.20. Click Next.21. Enter internal (on-premise) host and port.

Parameters ValueInternal Host:* for example ldciuxs.wdf.sap.corp Internal Port:* for example 44321

22. Click Next.23. (Optionally) Enter virtual host and port (used on cloud-side), which of course can

be different from the real one.Parameters ValueVirtual Host: for example ldciuxsVirtual Port: for example 8000

The virtual host and port is same as the real one by default.

© SAP SE of

SAP Best Practices

Integration Scenario between SAP S/4HANA and SAP HANA Cloud PlatformPlease remember the virtual host and port which will be used to create Destination in the next chapter.24. Click Next.25. Select principal type None.26. Click Next.27. (Optionally) Enter a description.28. Click Next.29. Check the check box Check availability of internal host.30. Click on Finish.

What you was doing in above ten steps is to assign to a real backend system a virtual name. In this way you can decouple the SAP Web IDE from the backend infrastructure. You can also create a virtual port, which of course can be different from the real one. In this case, we use as virtual server name “ldciuxs” on the port 8000; this will be linked to the physical system UXS with the URL https://ldciuxs.wdf.sap.corp:44321.

Please be aware that the server used in this document (UXS) is just an example, you can map to your real system.31. Now you need to add all the Resources related to the Usages you want to have in

your SAP Web IDE.

These Resources are the paths to be concatenated with the server URL in order to have the complete paths to the resources. For example, if you want to configure your SAP Web IDE to consume the OData service at the address https://ldciuxs.wdf.sap.corp:44321/sap/opu/odata and extend some SAP Fiori applications at the address https://ldciuxs.wdf.sap.corp:44321/sap/bc/adt, you just need to add the common part (the server name and the port) in the system mapping and all the different paths of resources.32. In Mapping Virtual To Internal System section, select the particular Virtual Host

line item we just created.33. In Resources Accessible On ldciuxs.wdf.sap.corp:44321 section, Click on Add….

In this case let’s add just the following resources: “/sap/opu/odata”, “/sap/bc/adt” and “/sap/bc/ui5_ui5”, because for that server we want to use OData services, extend applications and also execute some SAPUI5 applications34. In Add Resource dialog box, enter the following resource information.

Parameters ValueEnabled : checkURL Path:* /sap/opu/odata

Access Policy: select Path and all sub-paths

35. Click on Save.36. Repeat step33 – step35 to add the remaining other resources according to the

following table.

Usage URL Path Access Policy Enabledodata_abap /sap/opu/odata Path and all sub-

paths Check

dev_abap /sap/bc/adt Path and all sub-paths Check

ui5_execute_abap /sap/bc/ui5_ui5 Path and all sub-

paths Check

© SAP SE of

https://ldciuxs.wdf.sap.corp:44321/sap/opu/odata

https://ldciuxs.wdf.sap.corp:44321/

SAP Best Practices


Each SAP HANA Cloud Platform account can be connected to one cloud connector only. A single cloud connector can expose an arbitrary number of back-end systems.

ResultSAP HANA Cloud connector has been properly configured. The status is green and it’sConnected. You have successfully installed and configured your SAP HANA Cloud Connector.

3.1.6 Connecting the Remote SystemsUseIn the previous section the SAP HANA Cloud Connector has been configured with a virtual server pointing to a given real server. This was pretty easy to do. Now you have to say to your SAP Web IDE to point to the virtual server you have created, mapping to it all the related resources. You are going to setup, in the SAP HANA Cloud Cockpit, a new destination: this destination will give to the SAP Web IDE, the information about where to look for the specified backend.

With the previous versions of SAP Web IDE you had to create several destinations for each Usage you wanted to include in your connection. Now all this has been heavily simplified: you have to create just one destination for each system you want to connect by simply specifying all the needed Usages in the WebIDEUsage property: all the Usages must be separated by commas with no spaces among them. Since you want to use the paths “/sap/opu/odata”, “/sap/bc/adt” and “/sap/bc/ui5_ui5”, you need to specify the Usages odata_abap, dev_abap and ui5_execute_abap according to the table at point 36 of the previous section.

Procedure 1. Log on to the SAP HANA Cloud Platform cockpit.2. Go to SAP HANA Cloud Platform account.

You must have an Administrator or Developer role to modify destinations.3. In SAP HANA Cloud Platform Cockpit screen, click Destinations in the left navigation

panel.4. Click on New Destination.5. In Destination Configuration section, make the following entries.

Parameters ValueName* for example S4HANA_BACKEND

Type select HTTPDescription for example S4HANA Backend

URL*

<protocol>://<virtual host>:<virtual port> for example, https://ldciuxs:8000

For protocol, virtual host and virtual port, enter the values you entered when you configured the Access Control in former section.

Proxy Type select OnPremise

© SAP SE of

https://ldciuxs:8000/

SAP Best Practices


Authenticationselect NoAuthentication or Basic Authentication depending on the authentication you need for the connection. For Basic Authentication you need to enter user/password credentials. For more information, see Creating HTTP Destinations

User Optional or your user ID in SAP S/4HANA backend system

Password Optional or the password

6. In Additional Properties panel, click on New Property.7. Select WebIDEEnabled in Additional Properties drop-down list.8. Enter a value for the property, like True.9. Repeat step6 – step7 to add another three properties according to the following

table.

Parameters ValueWebIDEEnabled True

WebIDEUsage

odata_abap,dev_abap,ui5_execute_abap

WebIDESystem

<SAP system_ID> for example, UXS

sap-client<SAP client form the ABAP system> for example, 400

10. Click on Save.

The WebIDEUsage is a concatenation of some of the usages taken from the table at point 36 of previous section: just the ones we want to include in our destination; the URL of destination is not really the address of the real server, but it’s just the name of a virtual server.

ResultThe destination has been configured, now you can connect to the remote systems.

3.2 SAP Fiori Overview Page PackageUseSAP Web IDE is ready, the purpose of this section is to describe how to import an Overview Page Application in SAP HANA Cloud Platform WebIDE and register the application to SAP Fiori Launchpad. A sample content will be built in this section.

In this sample, a destination named ‘S4HANA_BACKEND’ has been used as sample purpose. Please modify to your destination if required. Or please use the exactly the same name in destination definition. For SAP S/4HANA source system, the CDS ‘C_PURGMATLPRICECHANGE’ is used as sample.

Procedure 1. Log on to SAP Web IDE.2. In menu bar select File -> Import -> From File System. There are two other options for

you, Application from SAPUI5 ABAP Repository or Application from SAP HANA Cloud Platform.

© SAP SE of

https://help.hana.ondemand.com/help/frameset.htm?1e110da0ddd8453aaf5aed2485d84f25.html

SAP Best Practices

Integration Scenario between SAP S/4HANA and SAP HANA Cloud Platform3. In Import dialog, click on Browse… to select the application package you want import.4. Select the application package, for example OVP _Sample.zip.5. Click on Open.6. Check the check box Extract Archive and Click on OK.7. You can see a new project OVP_SAMPLE is created in the root file Workspace.8. Right click on the project folder OVP_SAMPLE. 9. Click Deploy -> Deploy to SAP HANA Cloud Platform from the context menu options.10. In Login to SAP HANA Cloud Platform dialog, enter your password in Password* box.11. Click on Login.12. In Deploy Application to SAP HANA Cloud Platform dialog box, keep the default setting.13. Click on Deploy.14. In Successfully Deployed dialog, Click on Register to SAP Fiori Launchpad.15. In Register to SAP Fiori Launchpad wizard, keep default setting in General Information

tab.16. Click on Next.17. In Tile Configuration tab, enter the following entries:

Parameters ValueType* select Static

Title* Enter a meaningful name for the title like Material Price Change

Subtitle Enter a meaningful name for subtitle like OVP Sample

Icon keep default setting

18. Click on Next.19. In Assignment tab, make the follow entries to assign the tile to the particular group.

Parameters ValueSite* select a site, for example

MyDefaultCatalog* for example select Sample

CatalogGroup* for example select Sample Group

20. Click on Next.21. In Confirmation tab, you can see an information message stating that a new file flp-

config.json is created in the project and a new tile <name> is created in SAP Fiori Launchpad.

22. Click on Finish.23. In Successfully Registered dialog box, you can see an information stating that the

application was successfully registered to the Fiori Launchpad.24. Click on Open SAP Fiori launchpad.

Result You can see a new tile named Material Price Change under the group Sample Group.

Please make sure the app is running under the logon user instead of ‘Guest’, so that there is sufficient authorization to get correct results.

3.3 SAP Smart Business Service

© SAP SE of

SAP Best Practices


3.3.1 Enabling SAP Smart Business Service

UseThe purpose of this section is to describe how to subscribe to Smart Business Service and get started.

Procedure 1. Log on to the SAP HANA Cloud Platform cockpit.2. Go to HANA Cloud Platform account.3. Click on Services section in left pane.4. You will see Portal Service tile in the User Experience group.5. Check whether the service is enabled. 6. If not, please enable the service referring to the chapter3.1.1.7. After confirming the service is enabled, please further confirm the role TENANT_ADMIN has

been assigned to your account user. You can refer to the chapter3.1.1.8. Switch to SAP HANA Cloud Platform cockpit.9. Click on Services section in left pane.10. You will see SAP Smart Business Service tile in Business Services group. Click on the

tile.

11. Click on Enable button to subscribe this service.12. After the service is enabled, click on Configure Service to add Smart Business Apps to

Fiori Launchpad Site.13. In the Smart Business Administration Applications screen, click on the tile SB

Configuration. 14. In the Smart Business Configuration screen, select Import Smart Business Apps tab.

15. Click on Select Site value help icon .16. This will show all the available sites, select the site where you want to add Smart Business

Apps, for example MyDefault.

The service role Services.SmartBusinessAdministrator is required to import Smart Business apps to FLP site. Please check whether the role has been assigned to your user, if not, connect to your system administrator.17. Click on Import Apps.

By default, when you enable the Portal Service, a new destination named flpuis will be automatically generated. You can see the Authentication of flpuis is set to BasicAuthentication by default, which is the reason why you can’t import Smart Business apps correctly. You need to set the authentication type of flpuis to AppToAppSSO.18. You can see there will be a prompt message which shows Smart Business apps successfully

imported to the site.

Smart Business Apps are added to the site. You can go to Fiori Launchpad to check it. You can also click on Access Smart Business Services tiles link to go to Fiori Launchpad. By default, this link directs to default site. In case you have imported your Smart Business apps to a different site, go to that particular site to access Smart Business apps.

If the Smart Business Apps are still not available in the FLP site, you can refer to the following steps (19-28) to re-publish your FLP site.

© SAP SE of

SAP Best Practices

Integration Scenario between SAP S/4HANA and SAP HANA Cloud Platform19. Back to SAP HANA Cloud Platform cockpit.20. Click on Services section in left pane.21. Click on Portal Service tile in the User Experience group.22. Click on Go to Service.23. You will log on to SAP HANA Cloud Platform, Portal Service in a new tab.24. Click on Site Directory section in left pane.25. Select the FLP Site to which you imported Smart Business Apps.26. Click on Edit.

27. In the new page, click on Publish site button in the top-right of the screen.28. In the Warning dialog, click Publish.

Result SAP Smart Business Service is enabled. Based on the roles assigned, you may see few or all the Smart Business apps in your site.

3.3.2 Smart Business Modeler AppsThe SAP Smart Business apps are a set of SAP Fiori apps that you use to create and manage SAP Smart Business entities.SAP Smart Business apps are categorized in 3 groups.

Smart Business Administrator Apps Smart Business Modeler Apps Smart Business Alerting Apps

We use the OData Service C_PURCHASEORDERVALUE_CDS as an example to go through following configuration steps. The service role Services.SmartBusinessModeler and font-end role SmartBusinessModeler are also required.

3.3.2.1 Create a New Destination

UseThe destinations which are to be used by Smart Business must follow some naming convention. The name should be BusinessSystem01 … BusinessSystem10. By default, when you enable the SAP Smart Business Service, a new destination named BusinessSystem00 will be automatically generated. Now we need to create a new destination named BusinessSystem01 which is to be used for KPI. We will use ldciuxs:8000 configured in above chapter as an example.

Procedure 1. Log on to the SAP HANA Cloud Platform cockpit.2. Go to SAP HANA Cloud Platform account.

You must have an Administrator or Developer role to modify destinations.3. In SAP HANA Cloud Platform Cockpit screen, click Destinations in the left navigation

panel.4. Click on New Destination.5. In Destination Configuration section, make the following entries.

Parameters Value

© SAP SE of

SAP Best Practices


Name* BusinessSystem01-10, for example BusinessSystem01

Type select HTTPDescription for example S4HANA Backend

URL*

<protocol>://<virtual host>:<virtual port> for example, https://ldciuxs:8000

For protocol, virtual host and virtual port, enter the values you entered when you configured the Access Control in former section.

Proxy Type select OnPremise

Authenticationselect NoAuthentication or Basic Authentication depending on the authentication you need for the connection. For Basic Authentication you need to enter user/password credentials. For more information, see Creating HTTP Destinations

User Optional or your user ID in SAP S/4HANA backend system

Password Optional or the password

6. Click on New Property.7. Select sap-client in Additional Properties drop-down list.8. Enter a value (<SAP client form the ABAP system>) for the property, for example 400.9. Click on Save.

Result The destination BusinessSystem01 is created, now you can use BusinessSystem01 as data source to create KPIs or OPIs.

3.3.2.2 Using Create KPI

UseThe purpose of this section is to describe how to use Create KPI app to create KPI or OPI. We will create a KPI in following steps, you can refer these steps to create OPI.

Procedure 1. Log on to the SAP Fiori Launchpad just created.2. Access the APP

Click the Tile Catalog and choose Create KPI from Smart Business Modeler Apps group. 3. The Create KPI or OPI screen displays. This screen should show 2 sections, Parameters

and Data Source.4. In Parameters section, make the following entries.

Parameters Value*ID: the ID will be automatically generated, you can keep

the default setting*Title: for example Purchase Order Value

Description: for example Purchase Order Value

Goal Type: select Maximizing(higher is better)

© SAP SE of

https://help.hana.ondemand.com/help/frameset.htm?1e110da0ddd8453aaf5aed2485d84f25.html

SAP Best Practices


5. In Data Source section, make the following entries.

Parameters ValueSource System:

Select a destination, for example BusinessSystem01

OData Service: Enter the path of OData Service, for example /sap/opu/odata/sap/C_PURCHASEORDERVALUE_CDS

Entity Set: select C_PurchaseOrderValueResultsValue Measure: select PurOrdNetAmountInDisplayCrcy

6. Click Activate or Activate and Add Evaluation.

When you click on Activate, the KPI will be saved first and then activated. If you click on Save, the KPI will only be saved and not activated. Has not been activated KPI can’t be used for subsequent configuration. You can activate a KPI in the KPI Workspace app.

Result The KPI (Purchase Order Value) is created. But now the KPI is just a shell, you need to add some content to it. This is what the next step will describe.

3.3.2.3 Using Create Evaluation

UseThe purpose of this section is to describe the process of using Create Evaluation app to add evaluations to the KPI created in previous section.

Procedure 1. Log on to the SAP Fiori Launchpad.2. Access the APP.

Click the Tile Catalog and choose Create Evaluation from Smart Business Modeler Apps group.

3. The Add Evaluation screen displays. This screen should show 3 sections, Parameters, Data Source and Input Parameters and Filters.

4. In Parameter section, make the following entries.

Parameters Value*Selected KPI or OPI: select the KPI just created, Purchase Order Value

*Evaluation ID: the ID will be automatically generated, you can keep the default setting

*Evaluation Title: enter a name for the Evaluation, for example Last 1 Year

When you select a KPI in *Selected KPI or OPI field, there will be a new section appears at the end of the page, Target, Thresholds, and Trend.If you choose Activate and Add Evaluation in step 6 in previous section, you can ignore step1- step 4.5. In Data Source section, keep the default settings.

© SAP SE of

SAP Best Practices

Integration Scenario between SAP S/4HANA and SAP HANA Cloud Platform6. In Input Parameters and Filters section, enter values for the Input Parameters according

to your requirements.

Dimension Operator ValuesP_DisplayCurrency for example Equal to for example USD

P_EvaluationTimeFrameInDays for example Equal to for example 365

7. In Target, Thresholds, and Trend section, make the following entries.

Parameters ValueValue Type select Fixed Value(3) Target for example 500000

(2) Warning for example 400000

(1) Critical for example 300000

8. Click Activate or Activate and Configure Tile.

When you click on Activate, the Evaluation will be saved first and then activated. If you click on Save, the KPI will only be saved and not activated. Has not been activated Evaluation can’t be used for subsequent configuration. You can activate an Evaluation in the KPI Workspace app.

Result The Evaluation (Last 1 Year) is created.

3.3.2.4 Using Configure KPI Tiles

UseThe purpose of this section is to describe the process of using Configure KPI Tiles app to create a tile to assign the KPIs.


Click the Tile Catalog and choose Configure KPI Tiles from Smart Business Modeler Apps group.

3. The Configure KPI Tiles Web page displays. This page should show 2 main pane, All Active Evaluations pane and Configured Tiles pane.

4. In All Active Evaluations section, select the Evaluation created above, Purchase Order Value.

You can see the Configured Tiles pane displays “No tiles have been created yet”.5. Click on Add Tile in the lower right corner of the page.6. The Add Tile screen displays.

If you choose Activate and Configure Tile in step 8 in previous section, you can ignore step1- step 5.

© SAP SE of

SAP Best Practices

Integration Scenario between SAP S/4HANA and SAP HANA Cloud Platform7. In Tile Configuration section, make the following entries.

Parameters ValueTile Format: for example, select Numeric Tile

*Select Catalogs: select a relevant catalog to assign the Tile, for example Sample Catalog

Select Groups: (optional) for example, select Sample Group

*Title (KPI): keep default setting or enter another meaningful name, for example Purchase Order Value

*Subtitle (Evaluation):

keep default setting or enter another meaningful name, for example Smart Business Service Sample

Keywords: leave empty

8. Click Save or Save and Configure Drill-Down.

Result The Tile (Purchase Order Value – Smart Business Service Sample) is created.

3.3.2.5 Using Configure KPI Drill-Down

UseThe purpose of this section is to describe the process of using Configure KPI Drill-Down app to configure drill down content for the KPI we just created by adding some charts and tables.


Click the Tile Catalog and choose Configure KPI Drill-Down from Smart Business Modeler Apps group.

3. The Configure KPI Drill-Down Web page displays. This page should show 2 main pane, All Active Evaluations pane and Drill-Down Configuration Details pane.

4. In All Active Evaluations section, select the Evaluation created above, Purchase Order Value.

You can see the Drill-Down Configuration Details pane displays “No drill-down has been configured yet”.5. Click on Configure in the lower right corner of the page.6. The Select dialog displays.

If you choose Save and Configure Drill-Down in step 8 in previous section, you can ignore step1- step 4.7. In Dimension tab, select Plant and Supplier.8. Tap on the Measure tab, select PO Net Amount (KPI Measure).9. Click on OK. 10. The Drill-Down Chart Configuration screen displays. By default, the data is shown by a

Column chart.11. In Visualization Type section, you can personalize your chart. There we keep the default

setting.

© SAP SE of

SAP Best Practices

Integration Scenario between SAP S/4HANA and SAP HANA Cloud Platform12. In *View Title field, enter a meaningful name for the chart for example Po Net Amount by

Plant and Supplier.13. There by default the column chart shows the Stock Value by Plant /Supplier, which is

determined by the sequence of Plant and Supplier.

14. Click on the Sort button in left navigation panel.15. In Change Order dialog, select Supplier.16. Click on the Move Up button .17. Click on OK.18. You can see the column chart shows the Po Net Amount by Supplier/Plant.19. Click Save View.20. The SAP Smart Business Generic Drill-Down screen displays.21. Click Save Configuration.22. Back to the Drill-Down Configuration Details pane, the view Po Net Amount by Plant

and Supplier displays in the pane.

Result The Drill-Down content (Po Net Amount by Plant and Supplier) is configured.

3.3.2.6 Add Tile to Home

UseThe purpose of this section is to describe the process of adding the tile to the My Home group.

Procedure 1. Log on to the SAP HANA Cloud Platform cockpit.2. Go to SAP HANA Cloud Platform account.3. Refer to section 3.3.1 to republish your SAP Fiori Launchpad Site, in this case it’s

MyDefault.4. Log on to the SAP Fiori Launchpad.5. You can see the Tile Purchase Order Value – Smart Business Service Sample

displays in Sample Group group.6. Click Personalize Home Page in the lower right corner of the page.7. Click plus icon in My Home group.8. The Tile Catalog – Personalize Group ”My Home” screen displays. 9. In Search in tile catalog field, enter the name of the Tile you have created, for example

Purchase Order Value.10. Press ENTER .

11. Click the icon at the bottom of the Tile.12. You can see there will be a prompt message which shows added successfully.

13. Click icon back to Home Page.14. You can see the Tile Purchase Order Value – Smart Business Service Sample

displays in My Home group.15. Click Exit Action Mode.

Result The Tile (Purchase Order Value – Smart Business Service Sample) has been added to My Home group.

© SAP SE of

SAP Best Practices


3.3.2.7 Export a KPI or OPI (Optional)

UseWhen you complete the creation of your KPIs or OPIs, you can export them to share with other accounts. In this section we will describe how to export a KPI by using the Transport Content app which allows you to transport Smart Business entities across accounts.

Procedure 1. Log on to your Fiori Launchpad.2. Access the APP. Click the Tile Catalog and choose Smart Business Content Transport from Smart

Business Modeler Apps group.3. The Content Transport Web page displays.

4. Click on Download icon .5. Select KPIs of Content to Download field.

6. Click on Add icon .7. In KPIs to Export dialog, select the KPIs you want to export.8. Click on OK.9. Click on Download.10. You can see there will be a prompt message which shows download successfully.11. Open the Downloads repository of your browser, you can see the exported KPI package which is a zip file.

Result You have downloaded a KPI successfully. The download entities can then be uploaded to the target system using the same app in the target account.

3.3.2.8 Import a KPI or OPI (Optional)

UseIn addition to create your own KPI step by step, you can also create KPI by importing a KPI created by other accounts. In this section we will describe how to import a KPI by using the Transport Content app which allows you to transport Smart Business entities across accounts.

Procedure 1. Log on to your Fiori Launchpad.2. Access the APP. Click the Tile Catalog and choose Smart Business Content Transport from Smart

Business Modeler Apps group.3. The Content Transport Web page displays.

4. Click on Upload icon .5. Select KPIs of Content to Upload field.6. Click on Browse….7. In Open dialog, select the exported KPI package you want import.8. Click on Open.9. Click on Upload.10. You can see there will be a prompt message which shows upload successfully.

© SAP SE of

SAP Best Practices

Integration Scenario between SAP S/4HANA and SAP HANA Cloud Platform11. Back to Home page.12. Click the Tile Catalog and choose KPI Workspace from Smart Business Modeler Apps group.13. The KPI Workspace Web page displays.14. You can see in the left pane ALL KPIs and OPIs there is a new KPI.

Result You have uploaded a KPI successfully. Now you can custom the new KPI by yourself, like configuring Tile, configuring Drill-Down and so on.

© SAP SE of

purposesapidp/... · web viewin particular, sap se or its affiliated companies have no obligation...

Documents