Show TOC

 App Implementation: SAP Smart Business for Retail Promotion Execution

System Landscape Requirements

The app consists of front-end components and back-end components. The back-end components and the front-end components are delivered in separate products and have to be installed in a system landscape that is enabled for SAP Fiori.

Before you can start to implement the app, ensure that your system landscape has been set up to enable SAP Fiori and that this system landscape already includes the front-end components and back-end components for your app:

SAP Fiori System Landscape Options

Setup of SAP Fiori System Landscape with SAP HANA XS

Configuration of Front-End Server

Configuration of SAP Fiori Infrastructure

Back-End Components (Product Version Stack)

SAP enhancement package 7 for SAP ERP 6.0 SPS 6 (Insight to Action)

SAP enhancement package 7 for SAP ERP 6.0 SPS 5 (for pure analytical apps)

SAP HANA Content Component Delivered with (Product Version Stack)

SAP Smart Business 1.0 for retail promotion execution SPS 2

(Technical name: SAP SMART BUSINESS FOR RTL 1.0)

VDM Contained (Product Version Stack)

SAP HANA Live 1.0 for Retail SPS 3

(Technical name: SAP HANA ANALY. F. RTL 1.0)

Front-End Components Delivered with (Product Version Stack)

SAP Smart Business 1.0 for retail promotion execution SPS 2

Frontend Serv. Cont RTL NW 7.4

Software component version: UISRTL01_100

Note Note

The SAP Smart Business for Retail Promotion Execution analytical app is not released for MAC OS 10.8.

End of the note.

For more information about the installation of the front-end components, see Installation Requirements (Analytical Apps).

Tile Type for Launching App

The SAP Smart Business for Retail Promotion Execution analytical app uses 4 KPI tiles to launch the app.

These KPI tiles require evaluations that specify one or more input parameters. For more information about these configuration requirements, see

Configuration Settings: Overdue Issues in Promotions - Logistics Manager View

Configuration Settings: Overdue Issues in Promotions - In All Process Steps

Configuration Settings: Promotions Containing Issues

Configuration Settings: Total Issues in Promotions

Configuration Settings: Overdue Issues in Promotions - Per Area of Responsibility

Required SAP Notes

For the SAP Smart Business for Retail Promotion Execution app, the following SAP Notes must be implemented:

Back-End/Front-End Server

SAP Note Number

Description

Backend Server

2000139Information published on SAP site

Additional Customizing for operational reporting in the retail promotion environment

Backend Server

2063409Information published on SAP site

List of tables to be replicated for SAP Hana Live for Retail when using a side-by-side scenario

Note Note

To install and configure the SAP Smart Business for Retail Promotion Execution app in a side-by-side scenario, some database tables that are used by the SAP Smart Business for Retail Promotion Execution need to be replicated from the corresponding SAP Business Suite back-end system into the SAP HANA database. This is done using SAP Landscape Transformation Replication Server. SAP Note 2063409Information published on SAP site contains the list of these tables.

In an integrated scenario, it is not necessary to create and replicate database tables, as they are already available in the SAP HANA database.

End of the note.
Optional SAP Notes

For the SAP Smart Business for Retail Promotion Executionapp, the following SAP Notes needs to be implemented if you want to use the Insight to Action feature:

Back-End/Front-End Server

SAP Note Number

Description

Backend Server

2057754Information published on SAP site

Smart Business Fiori app Promotion Execution Cockpit – Insight to Action

Implementation Tasks

The following sections list tasks that have to be performed to implement the SAP Smart Business for Retail Promotion Execution app. The tables contain the app-specific data required for these tasks.

You can find the data required to perform these tasks in the SAP Fiori apps reference library at

HANA Server: Assign SAP HANA Roles to Users and Roles

You can find the data required to perform this step in the SAP Fiori apps reference library at https://www.sap.com/fiori-apps-libraryInformation published on SAP site.

SAP HANA Role

Needed for ...

sap.hba.apps.rtl.s.roles::RetailPromotionCockpit

Retail Promotion Cockpit execution

sap.hba.r.rtl.roles::RetailPromotionCockpitKpi

Retail Promotion Cockpit KPI execution

As a prerequisite for read-access to KPI definition, ensure you have assigned the generic role Smart Business Runtime Role (sap.hba.r.sb.core.roles::SAP_SMART_BUSINESS_RUNTIME) to all users or roles.

As a prerequisite for KPI modeling, ensure you have assigned the generic role Smart Business Administration Role (sap.hba.r.sb.core.roles::SAP_SMART_BUSINESS_MODELER) to specific users (e.g. key user, administrator).

For more information about SAP HANA roles, see Assigning Roles for Accessing SAP HANA Data.

HANA Server: Generate and Assign Analytic Privileges to Users and Roles

You can find the KPI data required to perform these steps in the SAP Fiori apps reference library at https://www.sap.com/fiori-apps-libraryInformation published on SAP site.

Needed for

How to generate?

Access to KPI data (only views)

To be generated by the customer using SAP HANA Live Authorization Assistant.

Access to KPI definition in KPI catalog

To be assigned by the customer using SAP Smart Business modeler app Manage KPI Authorizations.

Precondition: ITo assign analytic privileges from the backend, you first need to have defined PFCG roles in the backend. In most cases, these PFCG roles are already defined so that the users in the backend have access to only the organizational units for which they are responsible. The SAP Smart Business for Retail Promotion Execution app evaluates the following authorization objects of the SAP Business Suite backend

  • W_WAKH_EKO: IS-R Auth. promotion: Purchasing Organization/Purch. Group

  • W_WAKH_VKO: IS-R Auth. Promotion: Sales Organization/Distrib. Channel

You need to select the following query views during the creation of the analytic privileges, so that the users of the SAP Smart Business for Retail Promotion Execution can see all the information they are authorized:

  • sap.hba.apps.rtl.s.v.RetailPromnPrepIssuesQuery

  • sap.hba.r.rtl.v.RetailPromnPrepIssuesTileQuery

  • sap.hba.apps.rtl.s.v.RetailPromnProcessStepsQuery

  • sap.hba.apps.rtl.s.v.RetailPromnPurPriceItmIssuesQuery

  • sap.hba.apps.rtl.s.v.RetailPromnSlsPriceItmIssuesQuery

  • sap.hba.apps.rtl.s.v.RetailPromnSOSDetnItmIssuesQuery

  • sap.hba.apps.rtl.s.v.RetailPromnAllocTableItmIssuesQuery

  • sap.hba.apps.rtl.s.v.RetailPromnDCPriceItmIssuesQuery

  • sap.hba.apps.rtl.s.v.RetailPromnListingItmIssuesQuery

  • sap.hba.apps.rtl.s.v.RetailPromnBlockedItmIssuesQuery

  • sap.hba.apps.rtl.s.v.RetailPromnAllocPurOrdItmIssQuery

  • sap.hba.apps.rtl.s.v.RetailPromnAllocStkTransptItmIssQuery

  • sap.hba.apps.rtl.s.v.RetailPromnGdsRcptFromDCItmIssQuery

  • sap.hba.apps.rtl.s.v.RetailPromnGdsRcptFromVendorItmIssQuery

  • sap.hba.apps.rtl.s.v.RetailPromnGdsRcptFromDCSchedLineIssQuery

  • sap.hba.apps.rtl.s.v.RetailPromnGdsRcptFromVendorSchedLineIssQuery

Front-End Server: Activate SAP UI5 Application

SAP UI5 Application

Technical Name

Promotion Execution Cockpit

/sap/bc/ui5_ui5/sap/promn_cockpit

Promotion Execution Cockpit

/sap/bc/bsp/sap/promn_cockpit

Optional: Generic Drill-Down Application. This application is only needed if you define own KPI tiles with generic drill-down.

/default_host/sap/bc/ui5_ui5/ui2/ushell

For more information about how to activate the SAP UI5 application (ICF service), see Front-End Server: Activate ICF Services of SAP UI5 Application.

Front-End Server: Enable App for Access in SAP Fiori Launchpad

The SAP Fiori launchpad is the entry point to SAP Fiori apps. From a user perspective, it displays those SAP Fiori apps that have been assigned to the catalog designed for this user's role.

This presupposes that an administrator has made the necessary assignments in the launchpad designer to enable a user's access to the respective SAP Fiori apps in the SAP Fiori launchpad. For more information, see Setup of Catalogs, Groups, and Roles in the SAP Fiori Launchpad.

SAP delivers technical catalogs for groups of SAP Fiori apps as repositories to create your own catalogs in the launchpad designer. Along with these catalogs, more technical content is delivered for each SAP Fiori app. You can find the delivered technical content for each SAP Fiori app in the SAP Fiori apps reference library.

Front-End Server and Back-End Server: Assign OData Service Authorizations to Users

You must assign OData service authorizations for the KPI to your users.

Caution Caution

Several authorization default values are connected to the OData service. To ensure that all these default values are assigned to a user, you have to follow the instructions given under the documentation links provided.

End of the caution.

Make the assignment on the back-end server and on the front-end server:

OData Service (Version Number)

Back-end Server: Delivered Authorization Role (PFCG Role)

Front-End Server: AuthorizationRole

INSIGHT_TO_ACTION_PROMO_ODATA_SRV (1)

No specific role available.

Use an existing role or create a new one.

Note Note

  • The OData service INSIGHT_TO_ACTION_PROMO_ODATA_SRV mentioned above is used to trigger the insight-to-action feature “List All”.

  • The authorizations that are needed to execute transaction Promotion Listing (WAK18) in the Business Suite are sufficient to execute the OData service INSIGHT_TO_ACTION_PROMO_ODATA_SRV. As an example for a PFCG role, you can use SAP_ISR_PROMOTION.

  • For a user to execute the INSIGHT_TO_ACTION_PROMO_ODATA_SRV OData service, he or she must also have the authorization to execute the RFC in the Gateway system.

End of the note.

SAP Jam Integration

For information on how to configure SAP Jam, see http://help.sap.com/sapjamInformation published on SAP site

Navigation Targets for Fact Sheet Integration

The app offers the possibility to directly access other apps which are accessing further apps for details.

Note Note

Note: These linked apps have to be already available in your system landscape or you have to implement them along with this app.

  • Retail Promotion Fact Sheet

  • Article Fact Sheet

  • Allocation Table Fact Sheet

  • Site Fact Sheet

  • Vendor Fact Sheet

End of the note.

These fact sheets need to be installed/configured in addition to the SAP Smart Business for Retail Promotion Execution app. For more information, see SAP Library at http://help.sap.comInformation published on SAP site under Start of the navigation path SAP Business Suite Next navigation step SAP Fiori for SAP Business Suite Next navigation step SAP Fiori Apps Next navigation step App Documentation Structured per Area Next navigation step SAP Fiori Apps for SAP ERP Next navigation step Apps for Logistics Next navigation step Retail End of the navigation path