App Implementation: Customer Reports

System Landscape Requirements

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 3 for SAP CRM 7.0 SPS 7
SAP HANA Content Component Delivered with (Product Version Stack)	SAP Smart Business 1.0 for SAP CRM SPS 4
VDM Contained (Product Version Stack)	SAP HANA Live for SAP CRM SPS 8
Front-End Components Delivered with (Product Version Stack)	SAP Smart Business 1.0 for SAP CRM SPS 4 Instance: Frontend Serv. Cont. for CRM Software Component Version: UISCRM01 100

Note Note

Even though SAP HANA 1.0 SPS06 Revision 69 has been mentioned as the prerequisite SAP HANA version for SAP Smart Business Cockpits, for apps related to the SAP Smart Business Cockpit in the SAP CRM area, SAP HANA 1.0 SPS07 Revision 71 is necessary.

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 Customer Reports analytical app uses a KPI tile to launch the app.

Required SAP Notes

For the Customer Reports app, the following SAP Notes must be implemented:

Back-End/Front-End Server	SAP Note Number	Description
Back-End Server (SP02)	2018211	Errors in applications using technical OData service CRM_ANA_ODATA_REPORTS_SRV after upgrade to CRM 7.0 EhP3 SP04

Implementation Tasks

The following sections list tasks that have to be performed to implement the Customer Reports tile. The tables contain the tile-specific data required for these tasks.

You can find the data required to perform these tasks in the SAP Fiori apps reference library at https://fioriappslibrary.hana.ondemand.com/sap/fix/externalViewer/index.html?appId=F0672.

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

SAP HANA Role	Needed for
Relevant roles under sap.hba.apps.crmhlq.roles, depending on the query you are consuming. For example, sap.hba.apps.crmhlq.roles::Activities for Activities query.	Read access to SAP CRM HANA Live report data (views and XS OData services)

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

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.

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

Needed for	How to generate?
Access to business data (only views)	To be generated by the customer using SAP HANA Live Authorization Assistant.

Front-End Server: Activate SAP UI5 Application

SAP UI5 Application	Technical Name
Customer Reports	/sap/bc/ui5_ui5/sap/crm_myhlreports

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 Tile 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:

On the back-end server, a dedicated authorization role (PFCG role) for the OData service is delivered as an example. You can copy this role and adjust it to your needs.
For more information, see Back-End Server: Assign OData Service Authorization to Users.
On the front-end server, you must assign the OData service authorization to a new or existing role, such as a business role that has been adjusted according to your needs.
For more information, see Add Start Authorizations for OData Services to Role on Front-End and Front-End Server: Assign Roles to Users.

OData Service (Version Number)	Front-End Server: AuthorizationRole
CRM_ANA_ODATA_REPORTS_SRV	Use an existing role or create a new one.