INSTALLATION GUIDE | PUBLIC

Document Version: 1.2 – 2019-11-15

Common Installation Guide for SAP Customer

Activity Repository applications bundle 4.0
FPS02
© 2019 SAP SE or an SAP affiliate company. All rights reserved.

THE BEST RUN

Content

1 How to Use this Common Installation Guide. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4

1.1 Naming Conventions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
1.2 Information Available on SAP Help Portal. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

2 Plan your System. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

2.1 System Landscape. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
2.2 Central Hub Deployment (Recommended). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
2.3 Integration with Source Master Data Systems. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

3 Install the Prerequisites. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

4 Prepare the Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

4.1 Implement SAP Notes for the Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
4.2 Verify SAP HANA Users and Privileges. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
4.3 Verify Correct Schema Mapping. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
4.4 Generate Time Data - Gregorian Calendar. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
4.5 Configure AFL Usage. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .47
Enable Usage of PAL Functions (SAP Assortment Planning). . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
Check the OFL Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48

5 Install the Software. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50

5.1 Verify Prerequisites and SAP Notes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
5.2 Install ABAP Back-End Server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .51
Download and Install the Application Function Library (SAP RTL AFL FOR SAP HANA). . . . . . . . . 51
Install SAP Customer Activity Repository applications bundle (Back-End Product Version)
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
Set Up SAP Client. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
5.3 Install ABAP Front-End Server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
Install SAP Gateway on the ABAP Front-End Server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
Verify Installation of Central SAP Fiori UI Component. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
Install Product-Specific SAP Fiori UI Component (Front-End Product Version). . . . . . . . . . . . . . . 61
5.4 Install Alternate Storage (Optional). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
Install and Set Up Integration with SAP IQ. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
Install and Set Up Integration with Apache Hadoop. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
Install and Set Up Integration with SAP HANA Dynamic Tiering. . . . . . . . . . . . . . . . . . . . . . . . . .71
Create the Remote Source in SAP HANA Studio. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
Create the Virtual Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
Activate Alternate Storage. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
2 PUBLIC Content
6 Set Up the Applications. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
6.1 SAP Customer Activity Repository. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
Core (Mandatory for All Applications). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
Advanced (Optional). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .105
Troubleshooting. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166
6.2 SAP Merchandise Planning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183
Perform Core Steps for SAP Customer Activity Repository. . . . . . . . . . . . . . . . . . . . . . . . . . . . 183
Configure SAP Merchandise Planning. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .183
Verify the Connection Between the SAP Merchandise Planning System and SAP Analysis for
Microsoft Office. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188
Activate SAP Merchandise Planning Omnichannel BI Planning Framework Content. . . . . . . . . . 188
Configure Data Replication Steps. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225
Create Market Hierarchy. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .233
Specify Analysis Workbook Settings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234
6.3 SAP Assortment Planning. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235
Perform Core Steps for SAP Customer Activity Repository. . . . . . . . . . . . . . . . . . . . . . . . . . . .236
Configure Assortment Planning. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .236
Maintain Fiscal Year Variant for Retail Week. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 237
Maintain Fiscal Year Variant for Month. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239
Generate Time Data - Fiscal Calendar. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .241
Activate Planning Framework Content (SAP Assortment Planning). . . . . . . . . . . . . . . . . . . . . . 242
Configure Data Replication. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251
Run the Validation Report. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251
Configure Front-End. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252
Additional Information for Retail SAP BW Structure. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257
6.4 SAP Promotion Management. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261
Perform Core Steps for SAP Customer Activity Repository. . . . . . . . . . . . . . . . . . . . . . . . . . . .262
Activate Internet Communication Framework (ICF) Services. . . . . . . . . . . . . . . . . . . . . . . . . . 262
6.5 SAP Allocation Management. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262
Perform Core Steps for SAP Customer Activity Repository. . . . . . . . . . . . . . . . . . . . . . . . . . . .263
Activate SAP Allocation Management SAP HANA Content. . . . . . . . . . . . . . . . . . . . . . . . . . . . 263
Check Procedure Associated with Function GENIOS_SOLVE Is Active. . . . . . . . . . . . . . . . . . . . 267
Preselect Product Data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .268
Configure SAP Allocation Management. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 268
Configure Data Replication. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269
Configure Front End. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 272
6.6 Configure Access to Documentation Provided on SAP Help Portal (Optional for All Applications)
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Content PUBLIC 3
1 How to Use this Common Installation
Guide

This guide describes how to install and set up the applications delivered with SAP Customer Activity Repository
applications bundle 4.0 FPS02.

 Caution

If you already have an existing installation of any of these applications, you must perform a software
upgrade rather than a new installation. In this case, see the Common Upgrade Guide at https://
help.sap.com/viewer/p/CARAB under <Version> Installation and Upgrade .

Applications in this Release

SAP Customer Activity Repository applications bundle 4.0 FPS02 includes the following applications:

● SAP Customer Activity Repository 4.0 FPS02

● SAP Allocation Management 4.0 FPS02
● SAP Assortment Planning 4.0 FPS02
● SAP Merchandise Planning 4.0 FPS02
● SAP Promotion Management 4.0 FPS02

 Note

You can find the product documentation for all of these applications on SAP Help Portal for SAP Customer
Activity Repository applications bundle at https://help.sap.com/viewer/p/CARAB.

If you wish to connect your system to consume documentation directly from the SAP Help Portal, see
section Configure Access to Documentation Provided on SAP Help Portal (Optional for All Applications)
[page 274] for more information.

What to Install

Technically, SAP Customer Activity Repository applications bundle 4.0 FPS02 is delivered in the form of two
installable product versions: one for the back-end and one for the front-end.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
4 PUBLIC How to Use this Common Installation Guide
 Product Versions for this Release Description

SAP CARAB 4.0 FPS02 Back-end product version

Contains several software components that provide the

ABAP back-end functionality and the business content
(such as SAP HANA views and SQLScript procedures, lo­
cal BI Content, application function libraries, and work­
books, where applicable).

SAP FIORI FOR SAP CARAB 4.0 FPS02 Front-end product version

Contains all the SAP Fiori apps included in SAP Customer

Activity Repository applications bundle. It is also referred
to as the product-specific SAP Fiori UI component.

 Tip

If you need more information about a product version, log on to the SAP ONE Support Launchpad at
https://launchpad.support.sap.com/#/productsearch and search for SAP CARAB or SAP FIORI FOR
SAP CARAB. You will find download information, SAP Knowledge Base articles, guided answers, and more.

Installation at a Glance

1. First you prepare the installation. For example, you ensure that the technical prerequisites are installed.
You also implement mandatory corrections, verify authorizations, and do other preparatory tasks. These
steps are described in sections Install the Prerequisites [page 17] and Prepare the Installation [page
26].
2. Then you install the back-end product version and the front-end product version. These steps are
described in section Install the Software [page 50]. You must do these steps regardless of the application
that you want to set up later on.
3. Once you have installed the product versions, you set up the desired applications. These steps are
described in section Set Up the Applications [page 73]. First you do the general setup steps in section
Core (Mandatory for All Applications) [page 73]. You must do the core steps regardless of the application
that you want to set up. After the core setup, you only need to do the steps that are required for your
application. You do not need to read sections that do not apply to your application.

 Tip

This guide references several SAP Notes that are regularly updated with new information. If you want to be
informed of such updates because a particular note is relevant for your scenario, you can easily set up
email notifications for it. For information on how to do this, see SAP Note 2478289 (How to get
notifications for SAP Notes or KBAs).

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
How to Use this Common Installation Guide PUBLIC 5
1.1 Naming Conventions

Learn about important terms and variables used throughout this guide.

Terminology

Term Definition

Common Installation Guide Common guides for the applications included in SAP Customer Activity Repository
applications bundle.
Common Upgrade Guide
You can find the guides on SAP Help Portal at https://help.sap.com/viewer/p/CARAB under

<Version> Installation and Upgrade .

consuming application An application designed to consume and utilize data obtained from the SAP Customer
Activity Repository platform.

 Example
● SAP Allocation Management
● SAP Assortment Planning
● SAP Merchandise Planning
● SAP Promotion Management

back-end server / system The SAP NetWeaver-based ABAP back-end server on which the back-end product version
of SAP Customer Activity Repository applications bundle (that is, SAP Customer Activity
Repository and its consuming applications) is installed.

front-end server / system The SAP NetWeaver-based ABAP front-end server on which the SAP Gateway, central SAP
Fiori UI component with the SAP Fiori launchpad, and the product-specific SAP Fiori com­
ponent (front-end product version including the SAP Fiori apps for SAP Customer Activity
Repository applications bundle) are installed.

source master data system SAP Customer Activity Repository applications bundle must be deployed alongside an SAP
ERP (SAP Retail, SAP Fashion Management) or SAP S/4HANA (SAP S/4HANA Retail) cen­
tral component as the single source of truth for all master data.

Whenever this guide refers to a source master data system, it refers to the SAP ERP or SAP
S/4HANA central component that you choose for your implementation.

For more information, see Integration with Source Master Data Systems [page 15].

SAP ERP Unless otherwise specified, references in this guide to SAP ERP are comprehensive. That is,
they apply to SAP Retail and SAP Fashion Management.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
6 PUBLIC How to Use this Common Installation Guide
Naming Differences

Due to naming differences between the underlying technical objects, the following terms are used
interchangeably in this guide:

SAP Customer Unified Demand SAP Assortment SAP Promotion SAP Retail or SAP
Activity Forecast (UDF) Planning / SAP Management S/4HANA
Repository (all and Demand Data Merchandise
modules except Foundation (DDF) Planning SAP Allocation
for UDF and DDF) Management

article product product product product article

material

article variant product variant product variant product variant product variant or article variant
product/color/size

store location (used as location location store store

an umbrella term
site
for stores, distribu­
tion centers, etc.)

Variables

The variables are used as placeholders in the guides for objects that are user defined. When this variable is
used in an instruction, you are expected to substitute your customer defined name for the object. For example,
on the back-end application server where you have installed CARAB database objects, you have named your
schema ABC01. An instruction states to verify the list of packages in your SAP<SID>. You would look for
packages in the ABC01 schema.

To find the name of your SAP<SID>, sign on to your target system using SAP Logon. Use the file menu
System Status . In the lower right section titled Database Data the name of your Schema is shown. This
same schema is also listed as an object in your HANA catalog.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
How to Use this Common Installation Guide PUBLIC 7
Variables Used Across All Guides

Variable Description

SAP<SID> Physical schema name

 Note
In this guide your physical schema is referred to as SAP<SID> and is
your database system ID. This name is customer-defined.

To find the name of your SAP<SID>, log on to your target system using

SAP Logon. Choose System Status . In the lower right-hand sec­

tion titled Database data, the name of your Schema is shown. This same
schema is also listed as an object in your SAP HANA studio, under
Catalog. Substitute this schema name whenever the SAP<SID> variable
is used in this guide.

<sapsid> SAP system ID in lowercase letters

<SAPSID> SAP system ID in uppercase letters

<DBSID> Database ID in uppercase letters

<dbsid> Database ID in lowercase letters

<INSTDIR> Installation directory for the SAP system

<DVD_DIR> Directory on which a DVD is mounted

<OS> Operating system name within a path

1.2 Information Available on SAP Help Portal

Information on prerequisite platforms, applications, and other components as well as quick links to SAP sites

Information on Prerequisite Platforms, Applications, Other Components

Information On Path Title

Installing SAP HANA http://help.sap.com/viewer/p/ SAP HANA Server Installation and Up­
SAP_HANA_PLATFORM date Guide

<Version> Installation and

Upgrade SAP HANA Server

Installation and Update Guide

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
8 PUBLIC How to Use this Common Installation Guide
 Information On Path Title

Installing SAP HANA database clients http://help.sap.com/viewer/p/ SAP HANA Client Installation and Up­
SAP_HANA_PLATFORM date Guide

<Version> Installation and

Upgrade SAP HANA Client

Installation and Update Guide

Installing SAP HANA studio http://help.sap.com/viewer/p/ SAP HANA Studio Installation and Up­
SAP_HANA_PLATFORM date Guide

<Version> Installation and

Upgrade SAP HANA Studio

Installation and Update Guide

Installing SAP LT (Landscape Transfor­ http://help.sap.com/viewer/p/ Installation Guide - Trigger-Based Data

mation) Replication Server for SAP SAP_HANA_REAL_TIME_REPLICATION Replication Using SAP Landscape Trans­
HANA <Version> Installation and formation Replication Server

Upgrade

Managing major operational aspects of http://help.sap.com/viewer/p/ Application Operations Guide - SAP

the SAP LT Replication Server SAP_HANA_REAL_TIME_REPLICATION Landscape Transformation Replication

<Version> Operations Server

Using SAP HANA http://help.sap.com/viewer/p/ SAP HANA Administration Guide

SAP_HANA_PLATFORM

<Version> Administration SAP

HANA Administration Guide

Using the SAP HANA development http://help.sap.com/viewer/p/ SAP HANA Developer Guide
tools to create comprehensive analyti­ SAP_HANA_PLATFORM
cal models and to build applications
<Version> Development SAP
with SAP HANA interfaces and inte­
HANA Developer Guide (For SAP HANA
grated development
Studio)
(for developers)

Defining data models for use in SAP http://help.sap.com/viewer/p/ SAP HANA Modeling Guide
HANA SAP_HANA_PLATFORM

(for modelers, business analysts) <Version> Development SAP

HANA Modeling Guide (For SAP HANA

Studio)

Installing Foundation on SAP NetWea­ https://help.sap.com/viewer/p/ SAP NetWeaver Master Guide

ver AS for ABAP 7.52, version for SAP SAP_NETWEAVER_AS_ABAP_752
HANA <Version> Installation and

Upgrade Master Guide

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
How to Use this Common Installation Guide PUBLIC 9
Information On Path Title

Installing SAP ERP 6.0 http://help.sap.com/viewer/p/ Installation Guide

SAP_ERP <Version> Installation

and Upgrade Installation Guide

Installing SAP S/4HANA http://help.sap.com/viewer/p/ Installation Guide for SAP S/4HANA

SAP_S4HANA_ON-PREMISE

<Version> Product Documentation

Installation Guide

Installing SAP Enhancement Package 2 http://help.sap.com/viewer/p/ Installation Guide, SAP Customer Rela­
for SAP CRM 7.0 or SAP Enhancement SAP_CUSTOMER_RELATION­ tionship Management 7.0 Including En­
Package 2 for SAP CRM 7.0, Version for SHIP_MANAGEMENT Version 7.0 hancement Package 2 Java and ABAP
SAP HANA or higher
EHP2 Installation and Upgrade Administrator's Guide, SAP Enhance­
ment Package 2 for SAP CRM 7.0, Ver­
Installation Guide
sion for SAP HANA
http://help.sap.com/crm_hana

Installation and Upgrade

Administrator's Guide Administrator's

Guide SAP CRM 7.0 EHP2, Version for

SAP HANA

General Quick Links

SAP Site Path

SAP Help Portal http://help.sap.com

Knowledge Base Articles and SAP Notes https://support.sap.com/en/index.html

Product Availability Matrix (PAM) http://support.sap.com/pam

Maintenance and release strategy https://support.sap.com/en/release-upgrade-maintenance.html

SAP Software Download Center http://support.sap.com/swdc

SAP Solution Manager http://support.sap.com/solutionmanager

SAP Security Optimization Services Portfolio https://support.sap.com/en/offerings-programs/support-services/

security-optimization-services-portfolio.html

Data Protection and Privacy https://www.sap.com/about/cloud-trust-center/data-ownership-pri­

vacy.html

2590321 Upgrade recommendations to support GDPR compliance

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
10 PUBLIC How to Use this Common Installation Guide
 SAP Site Path

Support information (quick access via SAP ONE https://launchpad.support.sap.com/#/productsearch

Support Launchpad; requires login)

Support package stacks, latest versions, patch http://support.sap.com/patches

level requirements

System sizing http://www.sap.com/sizing

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
How to Use this Common Installation Guide PUBLIC 11
2 Plan your System

System Landscape [page 13]

System landscape diagram for SAP Customer Activity Repository applications bundle

Central Hub Deployment (Recommended) [page 14]

Central hub deployment is the recommended deployment option for the applications in SAP Customer
Activity Repository applications bundle.

Integration with Source Master Data Systems [page 15]

Overview of the source master data systems for deployment scenarios of SAP Customer Activity
Repository applications bundle

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
12 PUBLIC Plan your System
2.1 System Landscape

System landscape diagram for SAP Customer Activity Repository applications bundle

System Landscape

The applications included in SAP Customer Activity Repository applications bundle require a layered system
landscape, as illustrated in the following diagram:

System Landscape Example

For information about the components not specific to SAP Customer Activity Repository applications bundle,
see https://help.sap.com/viewer/p/FIORI_IMPLEMENTATION <Version> Installation and Upgrade SAP
Fiori: Setup and Configuration Setup of SAP Fiori System Landscape .

System Landscape Prerequisites

● For information on the versions required for this release, see Install the Prerequisites [page 17].
● For information on the supported interoperability scenarios between the back-end product version and the
front-end product version, see SAP Note 2815026 (Back-end and front-end interoperability in SAP
Customer Activity Repository applications bundle 4.0).

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Plan your System PUBLIC 13
2.2 Central Hub Deployment (Recommended)

Central hub deployment is the recommended deployment option for the applications in SAP Customer Activity
Repository applications bundle.

What is Central Hub Deployment

With central hub deployment, the back-end product version is installed in the back-end system, while the front-
end product version and the SAP Fiori front-end server are installed in a separate front-end system.

As a result, the SAP Fiori apps are deployed in separate systems (UIs in the front-end system, related OData
services in the back-end system).

 Note

In general, when an SAP solution includes SAP Fiori apps, you could alternatively choose the “embedded
deployment” option. Here you would use the same SAP NetWeaver server for back-end and front-end
components. The advantage of this option is that you do not require a separate SAP NetWeaver front-end
server.

For the applications described in this guide, however, we recommend central hub deployment because of
the advantages listed below.

This guide is therefore based entirely on the “central hub deployment” option.

Advantages

Central hub deployment decouples the lifecycle of the SAP Fiori apps from the back-end components
(separate shipments). This option has the following advantages:

● Faster iterations for SAP Fiori apps

● Central place for theming and branding SAP Fiori apps
● Single point of maintenance for user interface issues, such as browser support and updated versions of
SAPUI5 libraries
● Changes to user interfaces are possible without having development authorizations in the back-end.
● The SAP Fiori front-end server offers a central deployment of the UIs and a central enablement of OData
access for multiple SAP application back-end systems.

More Information

● For interoperability information, see SAP Note 2815026 (Back-end and front-end interoperability in SAP
Customer Activity Repository applications bundle 4.0).
● For more information on deployment options for SAP Fiori, see the following:
○ https://help.sap.com/viewer/p/FIORI_IMPLEMENTATION <Version> Installation and Upgrade
SAP Fiori: Getting Started SAP Fiori Deployment Options Deployment of SAP Fiori Front-End
Server
○ SAP Fiori Deployment Options and System Landscape Recommendations
○ https://help.sap.com/viewer/p/SAP_GATEWAY Installation and Upgrade Master Guide SAP
Gateway Master Guide Deployment Options as well as Embedded Versus Hub Deployment

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
14 PUBLIC Plan your System
2.3 Integration with Source Master Data Systems

Overview of the source master data systems for deployment scenarios of SAP Customer Activity Repository
applications bundle

Overview

You can deploy your SAP Customer Activity Repository applications bundle solution in parallel with one of the
following source master data systems:

Source Master Data System Flavor More Information

SAP ERP SAP Retail (add-on to SAP ERP) https://help.sap.com/viewer/p/

(including the SAP ERP Central Compo­ SAP_ERP <Version> Application

nent, SAP ECC) Help SAP Library Industries in SAP

ERP SAP Retail

SAP Fashion Management (add-on to https://help.sap.com/viewer/p/

SAP Retail) SAP_ERP <Version> Application

Help SAP Library Industries in SAP

ERP Fashion Management

SAP S/4HANA Retail SAP S/4HANA Retail for merchandise https://help.sap.com/s4hana

management <Version> Product Assistance

<Language> Industries in SAP S/

4HANA Consumer Industries

Retail

 Note

Unless otherwise specified, the following terms are used in this guide:

● References to the source master data system are comprehensive; that is, they apply to SAP ERP
(including SAP ECC) and SAP S/4HANA Retail.
● References to SAP ERP are comprehensive; that is, they apply to SAP Retail and SAP Fashion
Management.

Prerequisites

For information on what versions of the source master data systems are required for this release, see Install the
Prerequisites [page 17].

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Plan your System PUBLIC 15
More Information
If a migration to SAP S/4HANA is in scope for your business, see the following information for guidance:

● SAP Transformation Navigator at https://go.support.sap.com/transformationnavigator/#/welcome

● SAP Readiness Check at https://help.sap.com/viewer/p/SAP_READINESS_CHECK

For cross-scenario planning information, see the following whitelists:

● SAP Note 1661202 - Support multiple applications one SAP HANA database / tenant DB: Support and
special considerations for multiple applications on a single SAP HANA database or, in the case of MDC, on
a single tenant DB
● SAP Note 1826100 - Multiple applications SAP Business Suite powered by SAP HANA: Support and
special considerations for multiple applications on a single SAP HANA database within SAP Business Suite
powered by SAP HANA

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
16 PUBLIC Plan your System
3 Install the Prerequisites

This section lists all the prerequisite platforms, applications, and components that must be installed and
configured to prepare the system landscape for a new installation of this release.

 Note

If you are upgrading from a previous release, you must not follow this Common Installation Guide and
rather proceed with the Common Upgrade Guide, available at https://help.sap.com/viewer/p/CARAB under
Installation and Upgrade .

For your convenience, the prerequisites are presented to you in two categories:

● Common Prerequisites, which must be installed regardless of the business scenario you are planning to
implement
● Application-Specific Prerequisites, which are only relevant for specific applications under specific
conditions

 Caution

The prerequisites should be installed and configured by an experienced SAP Basis administrator.

 Note

Should there be important updates to the prerequisites after the publication of this guide, we will
communicate this information in the Important Notice document, which you can find on SAP Help Portal.
Navigate to https://help.sap.com/viewer/p/CARAB and see under Installation and Upgrade.

 Tip

This chapter references several SAP Notes that are regularly updated with new information. If you want to
be informed of such updates because a particular note is relevant for your scenario, you can easily set up
email notifications for it. For information on how to do this, see SAP Note 2478289 (How to get
notifications for SAP Notes or KBAs).

Common Prerequisites

1. Foundation on SAP NetWeaver AS for ABAP, version for SAP HANA

 Caution

You must install the foundation prior to installing other back-end components.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Install the Prerequisites PUBLIC 17
 The minimum requirement for this release is as follows, regardless of the business scenario you are
planning to implement:

Foundation Minimum Requirement Installation Information

1709 ABAP FND 1709 ON HANA SPS ○ SAP Note 2534199 (ABAP FND 1709 ON HANA: Re­
02 (05/2018) (foundation 1709 lease Information Note)
on SAP NetWeaver AS for ABAP ○ Master Guide for SAP NetWeaver under https://
7.52, version for SAP HANA) help.sap.com/viewer/p/SAP_NETWEA­

VER_AS_ABAP_752 <Version> Installation and

Upgrade

 Caution

Before installing or upgrading the foundation in your system landscape, always check for the latest
support information at https://help.sap.com/viewer/p/CARAB. Select your version at the top and see
under Installation and Upgrade Important Notice .

This is also where you will find support information on higher releases of the foundation.

2. SAP HANA Platform 2.0

○ SAP HANA database component:
The minimum requirement for this release is follows, regardless of the business scenario you are
planning to implement:
○ either SAP HANA database 2.0 SPS03 revision 37.00
○ or SAP HANA database 2.0 SPS04 revision 44.00
○ Before installing a revision, always check for the latest support information. See SAP Note
2818378 (Which releases of SAP HANA Platform are supported for which releases of SAP
Customer Activity Repository applications bundle (SAP CARAB)?).

 Caution

Guidance for Selecting a Higher Revision than the Minimum Revision

If you wish to use a higher revision, we recommend that you select one of the “maintenance
revisions”. See SAP Note 2378962 (SAP HANA 2.0 Revision and Maintenance Strategy) and
consult the information under Last Released Revision or Maintenance Revision.

Use this same strategy also, should the minimum revision no longer be available for download from
the Software Download Center. This situation might occur depending on when you perform the
actual installation and how long ago the revision was released.

If you wish to use the latest SAP HANA support package stack, be aware that there are no
maintenance revisions for it. In this case, we recommend the following:

1. To avoid incompatibilities, first consult SAP Note 2818378 (Which releases of SAP HANA
Platform are supported for which releases of SAP Customer Activity Repository applications
bundle (SAP CARAB)?).
Select a supported combination of releases. This applies not only during a new installation or
an upgrade, but is equally relevant if you decide to upgrade your SAP HANA Platform to a
higher revision or even support package stack later on

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
18 PUBLIC Install the Prerequisites
 2. Install the latest SAP HANA support package stack in your test system. Test it carefully to
evaluate its impact on your customer system landscape. Only roll it out to your productive
system when you are sure that it integrates well with your day-to-day business processes.

○ SAP HANA AFL component:

The minimum requirement for this release is the SAP HANA AFL revision that is compatible with the
selected SAP HANA database revision.
For installation information, see the following:
○ SAP Note 2818378 (Which releases of SAP HANA Platform are supported for which releases of SAP
Customer Activity Repository applications bundle (SAP CARAB)?)
○ SAP Note 2378962 (SAP HANA 2.0 Revision and Maintenance Strategy, lists the available
maintenance revisions)
○ SAP HANA 2.0 Revision Strategy (what are revisions, what are support package stacks, what is the
SAP HANA product availability and maintenance strategy)
○ Depending on your selected database revision:
SAP Note 2551355 (SAP HANA Platform 2.0 SPS 03 Release Note)
SAP Note 2656575 (SAP HANA Platform 2.0 SPS 04 Release Note)
○ SAP HANA Server Installation and Update Guide for your SAP HANA Platform version under https://
help.sap.com/viewer/p/SAP_HANA_PLATFORM <Version> Installation and Upgrade
○ Overview and download of SAP HANA Platform 2.0: http://support.sap.com Download Software
By Alphabetical Index (A-Z) H SAP HANA PLATFORM EDITION SAP HANA PLATFORM EDITION
2.0 INFO .
○ SAP Note 2339267 (HANA Client version and installation manifest file doesn't match currently
available HANA server version information)
○ If you are planning to upgrade from SAP HANA Platform 1.0 to SAP HANA Platform 2.0, additionally
see the following:
○ SAP Note 1948334 (SAP HANA Database Update Paths for SAP HANA Maintenance Revisions)
○ SAP Note 2372809 (Mandatory Preparation Steps for Upgrading a SAP HANA 1 System to SAP
HANA 2)
○ SAP Note 2422421 (Guideline for upgrading a SAP HANA system with extended application
services, advanced model)

 Tip

(Optional) To get the latest technical recommendations related to your SAP HANA landscape, you can
activate the SAP EarlyWatch Alert (EWA) in your SAP HANA environment. For more information, see
SAP Note 1958910 .

3. SAP RTL AFL FOR SAP HANA

 Caution

SAP RTL AFL FOR SAP HANA is a back-end software component of SAP Customer Activity
Repository applications bundle. However, you must always install it together with the SAP HANA
Platform. You must do this before installing the SAP CARAB back-end product version. This guide leads
you through the correct steps.

The minimum requirement for this release is the SAP RTL AFL FOR SAP HANA revision that is
compatible with the selected SAP HANA database revision, regardless of the business scenario you are

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Install the Prerequisites PUBLIC 19
 planning to implement. When you download an AFL revision from the SAP Support Portal, the compatible
SAP HANA database revision is always indicated.

 Note

What is SAP RTL AFL FOR SAP HANA:

The component contains back-end functionality for two modules of SAP Customer Activity Repository:
Unified Demand Forecast (UDF) and On-Shelf Availability (OSA).

You must always install the component, regardless of the scenario you are planning to implement.

You only need to set up and configure UDF and/or OSA if you wish to use the functionality in your
scenario.

4. SAP Landscape Transformation Replication Server

The minimum requirement for this release is SAP Landscape Transformation Replication Server 2.0 for
SAP HANA, regardless of the business scenario you are planning to implement.

 Note

If your source master data system is SAP S/4HANA 1909, be aware that as of that release, the SAP LT
Replication Server is no longer available as a standalone component. Instead, SAP S/4HANA 1909
includes an embedded SAP LT Replication Server by default.

To set up the data replication from an SAP S/4HANA 1909 system, you need to do some preparatory
steps. This guide leads you through the correct procedure in the data replication section (Create/
Replicate Source Master Data System Tables [page 81]). The preparatory steps have the added
advantage that they give you the option to still use a standalone SAP LT Replication Server.

For installation information and possible dependencies to other components, see the following:
○ Installation Guide (Replicating Data to SAP HANA) under https://help.sap.com/viewer/p/
SAP_LANDSCAPE_TRANSFORMATION_REPLICATION_SERVER <Version> Installation and
Upgrade
○ SAP Fiori Deployment Options and System Landscape Recommendations .
If your source master data system is SAP S/4HANA, see especially the minimum requirements in
section SAP S/4HANA with standalone SAP Fiori Front-End Server.
○ SAP Note 1605140 (SAP Landscape Transformation Replication Server (SLT)): This is the central
note for enabling trigger-based data replication (functional overview, download, installation, upgrade,
corrections, implementation).
○ SAP Note 2014562 (FAQ: SAP HANA LT Replication Server (SLT))
5. SAP Fiori
SAP Fiori front-end server is an add-on product version for SAP NetWeaver AS ABAP and defines the front-
end software components required to run SAP Fiori apps.
The minimum requirement for this release is SAP FIORI FRONT-END SERVER 4.0 - SAP FRONTEND
SERVER 7.52, regardless of the business scenario you are planning to implement. The minimum SAPUI5
version is 1.52.4.
For installation and implementation information, see the following:
○ SAP Fiori Implementation Information
○ Overview of SAP Fiori front-end server components and versions

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
20 PUBLIC Install the Prerequisites
 ○ For planning information and a helpful version overview (front-end server, application server ABAP,
SAP Gateway, SAPUI5), see SAP Note 2217489 (Maintenance and Update Strategy for SAP Fiori
Front-End Server).
○ 2484979 (SAP-Fiori-Frontend-Server 4.0 - General Information)
○ 2524632 (General Information: FIORI UI Infrastructure Components for products on SAP Frontend
Server 4.0 (S4H))
For information on possible dependencies to other components or if you are planning to use a higher
version, see the following:
○ SAP Note 2590653 (SAP Fiori front-end server deployment for SAP S/4HANA)
○ SAP Note 2618605 (SAP-Fiori-Frontend-Server 5.0 - General Information)
○ SAP Note 2775163 (SAP-Fiori-Frontend-Server 6.0 - General Information)
6. Source master data system
○ Either SAP ERP or SAP S/4HANA must be installed.

 Note

Unless otherwise specified, references in this guide to SAP ERP are comprehensive. That is, they
apply to SAP Retail and SAP Fashion Management. For more information, see Naming Conventions
[page 6].

○ The minimum requirements for this release are as follows, regardless of the business scenario you are
planning to implement:

Source Master Data Sys­

tem Minimum Requirement Installation Information

SAP ERP ○ SAP ERP 6.0 Enhancement Package 7 https://help.sap.com/viewer/p/

SP16 or higher
SAP_ERP <Version>
○ SAP ERP 6.0 Enhancement Package 8
Installation and Upgrade
SP09 or higher
Installation Guide

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Install the Prerequisites PUBLIC 21
 Source Master Data Sys­
tem Minimum Requirement Installation Information

SAP S/4HANA ○ SAP S/4HANA 1709 FPS2 or higher ○ https://help.sap.com/viewer/p/

○ SAP S/4HANA 1809 Initial Shipment Stack SAP_S4HANA_ON-PREMISE
or higher <Version> Implement
○ SAP S/4HANA 1909 Initial Shipment Stack Product Documentation
or higher
Installation Guide

 Note ○ SAP Note 2655761 (SAP S/

4HANA - restrictions and rec­
If your source master data system is
ommendations regarding spe­
SAP S/4HANA 1909, be aware that as
cific revisions of SAP HANA da­
of that release, the SAP LT Replication
tabase for use in SAP S/4HANA)
Server is no longer available as a
standalone component. Instead, SAP ○ SAP Note 2482453 (SAP S/

S/4HANA 1909 includes an embed­ 4HANA 1709: Release Informa­

ded SAP LT Replication Server by de­ tion Note)

fault. ○ SAP Note 2625407 (SAP S/

4HANA 1809: Release Informa­
To set up the data replication from an
tion Note)
SAP S/4HANA 1909 system, you need
○ SAP Note 2769531 (SAP S/
to do some preparatory steps. This
4HANA 1909: Release Informa­
guide leads you through the correct
tion Note)
procedure in the data replication sec­
tion (Create/Replicate Source Master
Data System Tables [page 81]). The
preparatory steps have the added ad­
vantage that they give you the option
to still use a standalone SAP LT Repli­
cation Server.

 Tip

If you are planning to convert from SAP ERP to SAP S/4HANA, you can use the SAP Readiness
Check to check the readiness of your SAP ERP system. For more information, see SAP Note
2758146 (SAP Readiness Check 2.0 & Next Generation SAP Business Scenario
Recommendation).

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
22 PUBLIC Install the Prerequisites
Application-Specific Prerequisites

SAP Customer Activity Repository

Prerequisites for SAP Customer Activity Repository

Prerequisite Minimum Requirement Mandatory/Optional Installation Information

SAP CRM The minimum requirement Optional, depending on https://help.sap.com/

for this release is one of the whether or not you choose to viewer/p/
following: implement customer deter­ SAP_CUSTOMER_RELA­
mination with SAP CRM. TIONSHIP_MANAGEMENT
● SAP Enhancement
Package 2 for SAP CRM <your version>
7.0 Installation and Upgrade
● SAP Enhancement
Installation Guide
Package 2 for SAP CRM
7.0, Version for SAP
HANA or higher

SAP Smart Business SAP Smart Business founda­ Optional, depending on SAP Note 2018360
tion component 1.0, most re­ whether or not you choose to
cent SPS implement the SAP Smart
Business for Multichannel
Sales Analytics dashboard
within SAP Customer Activity
Repository.

SAP Marketing (formerly, SAP Marketing 1.10 or higher Optional, depending on https://help.sap.com/
SAP Hybris Marketing) whether or not you choose to viewer/product/
implement customer deter­ SAP_HYBRIS_MARKETING/
mination with SAP 1702%20YMKT/en-US
Marketing. <your version>

Installation and Upgrade

Installation and Configuration

Guide

SAP Commerce (formerly, SAP Commerce 1811 or Optional, depending on https://help.sap.com/

SAP Hybris Commerce) higher (in particular, the Ac­ whether or not you choose to viewer/p/SAP_COMMERCE/
celerator, the Data Hub, and implement Omnichannel Ar­
SAP Asynchronous Order ticle Availability and Sourc­
Management) ing (OAA) or Omnichannel
Promotion Pricing (OPP)
within SAP Customer Activity
Repository.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Install the Prerequisites PUBLIC 23
Prerequisite Minimum Requirement Mandatory/Optional Installation Information

SAP Commerce, integration SAP Commerce, integration Optional, depending on See the Administration Guide
package for SAP for Retail package for SAP for Retail whether or not you choose to delivered with the software
(formerly, SAP Hybris Com­ 1811 or higher implement Omnichannel Ar­ package or from https://
merce, integration package ticle Availability and Sourc­ help.sap.com/viewer/p/IPR.
for SAP for Retail) ing (OAA) or Omnichannel
Promotion Pricing (OPP)
within SAP Customer Activity
Repository.

SAP Analytics Cloud Content Innovation 12 Optional, depending on System Requirements and
whether or not you choose to Technical Prerequisites
implement Omnichannel Ar­
ticle Availability and Sourc­
ing (OAA) within SAP
Customer Activity
Repository.

You only need to run and

connect this application if
you want to use the set of
OAA analyses that has been
predefined in SAP Analytics
Cloud and that is part of the
standard delivery of SAP An­
alytics Cloud. If you are using
a different analytics tool, or if
you do not run analytics at
all, you do not need this ap­
plication.

SAP IQ SAP IQ 16.0, SP8 or higher Optional, depending on https://help.sap.com/

whether or not you choose to viewer/p/SAP_IQ <your
use the Table Content Aging
version> Installation and
report to move data from
SAP Customer Activity Upgrade <various SAP IQ
Repository to SAP IQ. Installation and Configuration

Guides>

SAP HANA Dynamic Tiering SAP HANA Dynamic Tiering Optional, depending on https://help.sap.com/
is delivered with the SAP whether or not you choose to viewer/p/
HANA Platform. See the use the Table Content Aging SAP_HANA_DYNAMIC_TIER­
Common Prerequisites sec­ report to move data from ING <your version>
tion above. SAP Customer Activity
Installation and Upgrade
Repository to extended stor­
SAP HANA Dynamic Tiering:
age using SAP HANA Dy­
Installation and Update
namic Tiering.
Guide

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
24 PUBLIC Install the Prerequisites
 Prerequisite Minimum Requirement Mandatory/Optional Installation Information

SAP HANA extended applica­ SAP HANA XSA, version Optional, depending on https://help.sap.com/
tion services, advanced 1.0.88 or higher whether or not you choose to viewer/p/SAP_HANA_PLAT­
model (XSA) use Omnichannel Promo­ FORM <your version>
We recommend that you use
tion Pricing (OPP) within
the highest version available. Installation and Upgrade
SAP Customer Activity
SAP HANA Server Installation
Repository.
and Upgrade Installing an

SAP HANA System

Installing XS Advanced

Runtime

SAP Allocation Management

SAP Allocation Management requires only the common prerequisites.

SAP Assortment Planning

Prerequisites for SAP Assortment Planning

Prerequisite Minimum Requirement Mandatory/Optional Installation Information

SAP Analysis SAP Analysis for Microsoft Mandatory https://help.sap.com/

Office 2.6 SP03 viewer/p/SAP_BUSINES­
SOBJECTS_ANALYSIS_OF­

FICE <your version>

Installation, Configuration,
Security, and Administration

Administrator Guide

SAP Promotion Management

SAP Promotion Management requires only the common prerequisites.

SAP Merchandise Planning

Prerequisites for SAP Merchandise Planning

Prerequisite Minimum Requirement Mandatory/Optional Installation Information

SAP Analysis SAP Analysis for Microsoft Mandatory https://help.sap.com/

Office 2.6 SP03 viewer/p/SAP_BUSINES­
SOBJECTS_ANALYSIS_OF­

FICE <your version>

Installation, Configuration,
Security, and Administration

Administrator Guide

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Install the Prerequisites PUBLIC 25
4 Prepare the Installation

Before you start with the actual installation of SAP Customer Activity Repository applications bundle 4.0
FPS02, you must first perform several preparatory tasks.

1. Implement SAP Notes for the Installation [page 26]

This section lists SAP Notes (corrections) that you must read and — when appropriate — implement at
different points in the installation process. The section also points you to the release-specific back-
end RIN and front-end RIN, where you can find the very latest corrections.
2. Verify SAP HANA Users and Privileges [page 39]
SAP Customer Activity Repository applications bundle is installed in a multi-level system landscape
(SAP HANA database, ABAP back-end server, ABAP front-end server with SAP Gateway and SAP Fiori
apps). Each level requires specific users and privileges. In this procedure, you set up the users and
privileges for the SAP HANA database (level 1 below).
3. Verify Correct Schema Mapping [page 43]
In SAP HANA studio, verify that all “authoring schemas” of SAP Customer Activity Repository
applications bundle are mapped to the correct “physical schema” of your customer back-end system.
If necessary, create any mappings that are missing. This procedure is mandatory for all the
applications.
4. Generate Time Data - Gregorian Calendar [page 45]
Perform a generic calendar setting in SAP HANA studio.
5. Configure AFL Usage [page 47]
Perform configuration tasks to enable the usage of application function libraries (such as the PAL and
the OFL) for the applications SAP Assortment Planning and SAP Allocation Management.

4.1 Implement SAP Notes for the Installation

This section lists SAP Notes (corrections) that you must read and — when appropriate — implement at
different points in the installation process. The section also points you to the release-specific back-end RIN
and front-end RIN, where you can find the very latest corrections.

 Note

Make sure that you have the up-to-date version of each SAP Note, which you can always find on the SAP
Support Portal at http://support.sap.com/notes .

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
26 PUBLIC Prepare the Installation
Release Information Notes (RINs) with Latest Corrections for all
Applications

After the publication of this guide, additional corrections might have become available. You can find these
additional corrections in the RINs for this release:

● For the latest back-end corrections, see SAP Note 2788603 .

● For the latest front-end corrections, see SAP Note 2788586 .

 Caution

Always consult the table for SAP Customer Activity Repository, regardless of your scenario. Notes listed
here are often common corrections, applicable to all applications.

SAP Notes for SAP Customer Activity Repository

SAP Notes for SAP Customer Activity Repository

Implement Area SAP Note Description

Prior to the installa­ Back-end 2548843 Mandatory correction for all the applications of SAP Customer
tion Activity Repository applications bundle.
DD: data ele­
ment changes
from DEC to
CURR, error for
dependent
views

During the installa­ Back-end 2298340 Troubleshooting information for error messages during the “move
tion nametabs” phase.
SAP HANA DB:
CDS views with
external views
as base ob­
jects cannot be
created in the
DB

During the installa­ Back-end 2340418 Troubleshooting information for error messages during the
tion RUTDDLSCREATE phase.
SAP HANA DB:
RUTDDL­
SCREATE re­
turns errors for
CDS views with
external views
as base object

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Prepare the Installation PUBLIC 27
Implement Area SAP Note Description

During the installa­ Back-end 2377525 Troubleshooting information for error messages during the
tion CREATE VIEW phase.
External view
in view hierar­
chy

During the installa­ Back-end 2330184 Troubleshooting information for error messages during various
tion RSDB02CK-related phases (SUM only). For example, 2EETG002
Appearance of
View "/AMR/C_P_A_L_C" does not exist in the database or
Non-Exis­
2EETG002 View "/AMR/V_APITSLOC" does not exist in the data­
tence/Activa­
base.
tion Errors of
Views/DDL
Sources within
installation of
CARAB 1.0
FP03 and
CARAB 2.0

After the installation Back-end 2845868 Mandatory correction for the Demand Data Foundation (DDF)
module. Relevant for all the applications of SAP Customer
Dump during
Activity Repository applications bundle.
Import of Time
Series

After the installation Front-end 2183947 Information on how to install add-on object UISAFND1 100 when
installing the SAP Smart Business Modeler Apps Framework with
Smart Busi­
User Interface Add-On 2.0 for SAP NetWeaver.
ness for SoH
(Suite on
Hana) delivery

After the installation Back-end 1778607 Optional (only relevant if you choose to implement SAP HANA
Live for SAP Business Suite). Release information and implemen­
SAP HANA
tation considerations.
Live for SAP
Business Suite

After the installation Back-end 2623953 Mandatory if you are using omnichannel article availability and
sourcing (OAA) and using the functionality in sales channel mode.
SADL GW: Ex­
Not required for functions other than OAA. Not required if you are
posure for An­
using OAA in OAA profile mode.
notations on
Entity Con­
tainer with
namespace

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
28 PUBLIC Prepare the Installation
 Implement Area SAP Note Description

After the installation Back-end 2625428 Mandatory if you are using omnichannel article availability and
sourcing (OAA) and using the functionality in sales channel mode.
SADL GW: Ex­
Not required for functions other than OAA. Not required if you are
posure for An­
using OAA in OAA profile mode.
notations on
Entity Con­
tainer with
namespace

After the installation Front-end 2547022 Only required if your front-end server is version SAP NetWeaver
7.50 or lower:
Service cannot
be consumed Mandatory if you are using omnichannel article availability and
in SDK IOS due sourcing (OAA) and using the functionality in sales channel mode.
to invalid char­ Not required for functions other than OAA. Not required if you are
acter '.' in Enti­ using OAA in OAA profile mode.
tyContainer
namespace

After the installation Back-end 2853038 Mandatory if you are using omnichannel article availability and
sourcing (OAA) and using the functionality in sales channel mode,
"Context" field
with an SAP Retail source system (ERP scenario).
used for DC
stock separa­ Not required for functions other than OAA.
tion is not hid­
Not required if you are using OAA in OAA profile mode.
den in ERP
scenario Not required if you are using OAA in sales channel mode with an
SAP S/4HANA source system.

After the installation Back-end 2849052 Mandatory if you are using omnichannel article availability and
sourcing (OAA) and using the functionality in sales channel mode,
CARAB 4.0
with an SAP S/4HANA 1709 or 1809 source system.
FPS02 HANA
Content Acti­  Note
vation Issue for
Implement this SAP Note before activating the SAP HANA
OAA
content.

Not required for functions other than OAA.

Not required if you are using OAA in OAA profile mode.

Not required if you are using OAA in sales channel mode with an
SAP S/4HANA 1909 source system.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Prepare the Installation PUBLIC 29
Implement Area SAP Note Description

After the installation SAP S/4HANA 2835297 Only required if your ERP version is SAP S/4HANA 1909.
1909 back-end
Missing OAA Mandatory if you are using omnichannel article availability and
ATP Change sourcing (OAA), for both sales channel mode and OAA profile
Indicator en­ mode. Not required for functions other than OAA and ERP ver­
tries for S/ sions other than SAP S/4HANA 1909.
4HANA 1909

After the installation Back-end 2576497 Note for errors produced when the material number is longer that
SQL Error 18 characters.
Code 274: in­
serted value
too large for
column

After the installation Back-end 2777415 Mandatory correction for all the applications of SAP Customer
Activity Repository applications bundle. Implement this note re­
SAP Allocation
gardless of the scenario that you wish to set up.
Management:
Activating /AM
R/* views ends
in Error

After the installation Front-end 2845197 Note listing all the corrections for Analyze Forecast, Adjust
Forecast, and Manage Demand Influencing Factors that you need
Corrections for
for this release.
the Analyze
Forecast, Ad­
just Forecast
and Manage
Demand Influ-
encing Factors
apps in SAP
Customer Ac­
tivity Reposi­
tory 4.0 FPS02

After the installation Front-end and 2859379 This note is a collection of corrections for all layers of Demand
Back-end Planning for CARAB 4.0 FPS02
Demand Plan­
ning CARAB
4.0 FPS02 -
Collective Note
after ECC

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
30 PUBLIC Prepare the Installation
 Implement Area SAP Note Description

After the installation Front-end 2842109 Mandatory if you are using omnichannel promotion pricing.

Offer has more

than one term
with transac­
tion discount

After the installation Back-end 2857334 Mandatory if your source master data system is SAP S/4HANA
1909. In that case, the note is required for all the scenarios.
Unsupported
data type DEC­
FLOAT34 /
D34N when
replicating
from an SAP
S/4HANA
1909 on prem­
ise system

SAP Notes for SAP Merchandise Planning

 Note

Always consult the table for SAP Customer Activity Repository, regardless of your scenario. Notes listed
there are often common corrections, applicable to all consuming applications.

SAP Notes for SAP Merchandise Planning

Implement Area SAP Note Description

After the installation Back-end 1919631 Embedded BW-IP features explicitly needs the NW BPC10.1 li­
cense along with the PAK.
Activating the
BPC imbedded
is necessary

After the installation Back-end 2600370 The time-independent navigation attribute table of the character­
istic (X table) is fully or partially empty.
The input help
for time char­
acteristics
used as navi­
gation attrib­
utes does not
return any data

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Prepare the Installation PUBLIC 31
Implement Area SAP Note Description

After the installation Back-end 2667189 In the BW Query monitor (transaction RSRT or RSRT2) a dynamic
RSRT: Error filter is set on a structure, which is part of a hierarchical axis.
when filter on
UDH Axis

After the installation Back-end 2724048 A BW-IP planning scenario runs in PAK and fails with an error
BW-IP:col­ message "column store error: fail to create scenario." The error
umn store er­ message mentions 0REQTSN or 0REQTSN_KEY.
ror: fail to cre­
ate scenario
(0REQTSN
0REQTSN_KEY
)

After the installation Back-end 2726582 A planning scenario running in PAK dumps with an error
BW-IP: GETWA_NOT_ASSIGNED class CL_RSDRC_TREX_QUERY_LAYER,
GETWA_NOT_A method IS_LAYER_POSSIBLE_FOR_CHANM.
SSIGNED in
CL_RSDRC_TR
EX_QUERY_LA
YER
IS_LAYER_PO
SSIBLE_FOR_
CHANM

After the installation Back-end 2673356 You are executing a planning enabled query using a client that
ABAP BICS: makes use of the ABAP BICS API as BW provider like RSRT BICS
missing values (transaction RSRT/RSRT2 in mode ABAP BICS).
when planning
single values
and Universal
Display Hierar­
chy

After the installation Back-end 2671629 You are executing a planning enabled query using a client that
ABAP BICS: makes use of the ABAP BICS API as BW provider like RSRT BICS
Dump on plan­ (transaction RSRT/RSRT2 in mode ABAP BICS).
ning single val­
ues and Uni­
versal Display
Hierarchy

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
32 PUBLIC Prepare the Installation
 Implement Area SAP Note Description

After the installation Back-end 2750861 The extended program check and CVA terminate with the short
Termination dump ASSERTION_FAILED in the class
ASSERTION_F CL_SLIN_FLOW_IR_COMPILER.
AILED in ex­
tended pro­
gram check
and CVA

After the installation Back-end 2716617 A query aborts with error EXTRACT_RGC_INDEXES-01- in class
Error CL_RSR_RRK0_NORM_CONTEXT.
EXTRACT_RGC
_INDEXES-01
- in
CL_RSR_RRK0
_NORM_CONTE
XT

After the installation Back-end 2860688 When executing the top down planning function in the 1.3 work­
Invalid version book, the user may receive an error "/RAP/VERSN:M5R is not in­
returned in 1.3 cluded in the selection".
Top Down

SAP Notes for SAP Assortment Planning

 Note

Always consult the table for SAP Customer Activity Repository, regardless of your scenario. Notes listed
there are often common corrections, applicable to all consuming applications.

SAP Notes for SAP Assortment Planning

Implement Area SAP Note Description

Prior to the installa­ SAP Retail sys­ 2196351 Corrections to SAP Retail data elements.
tion tem
Pre-requisite
for SAP Note
#2196323

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Prepare the Installation PUBLIC 33
Implement Area SAP Note Description

Prior to the installa­ SAP Retail sys­ 2196323 Article Hierarchy Transfer replication will transfer all node and ar­
tion tem ticle assignments irrespective of the validity.
DRFOUT: Only
valid current
node assign­
ments and ar­
ticle assign­
ments are
transferred
during Article
Hierarchy Rep­
lication

Prior to the installa­ SAP Retail sys­ 2209621 Functionality on the SAP Retail side to enable PIR integration with
tion tem SAP Assortment Planning.
Assortment
Listing API:
List by DC fix

Prior to the installa­ SAP Retail sys­ 2286994 Supports:

tion tem
New Listing ● Different listing periods for different products within an as­
API for Retail sortment
Assortment ● Changes in the listing after a product has been listed
Planning ● In-season listing changes
● Multiple validity time periods for the same location

Prior to the installa­ Back-end 1656983 Information on changing the default ResultSetSizeLimit set­
tion ting.
Result Set Size
Limit Exceeded
Message

After the installation Back-end 2706022 This note is relevant if you use the Retail SAP BW Structure. This
note contains instructions for solving a BW issue in the Plan
When Current Products by Week worksheet of the Plan Assortment workbook.
Member is ac­
tivated on
0FISCYEAR,
the calculation
was not possi­
ble

After the installation Back-end 2768113 This note includes instructions to avoid creating corrupt data in
database tables and issues with the Match Placeholders and My
PHP Number Assortment Lists apps.
Range Config-
uration Infor­
mation

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
34 PUBLIC Prepare the Installation
 Implement Area SAP Note Description

After the installation Back-end 2856695 This mandatory note for the My Assortment Lists app includes
corrections regarding market hierarchy nodes issues.
CARAB 4.0 As­
sortment List -
Market hierar­
chy node is­
sues

After the installation Front-end This mandatory note for the My Assortment Lists app includes the
2772899
following:
Assortment
List 4.0 - Sta­ ● Stable ids to be able to assign hotspots for Web Assistant
ble ids for UI ● Bug fixes for the Manage Products screen
elements

After the installation Front-end This mandatory note for the Manage Option Plans app includes
2767553
several bug fixes.
APR 4.0 FP01 -
Manage Option
Plans UI OP­
TION PLAN­
NING - UI Fixes

After Both 2857864 Mandatory. Location Hierarchy Nodes aren't showing up in the
Option Plan Application display mode even though they are as­
signed to the Option Plan

SAP Notes for SAP Promotion Management

 Note

Always consult the table for SAP Customer Activity Repository, regardless of your scenario. Notes listed
there are often common corrections, applicable to all consuming applications.

SAP Notes for SAP Promotion Management

Implement Area SAP Note Description

After the installation Front-End Mandatory. Fiori - Latest version of Manage Promotional Offers
2756450

Promotional
Offers CARAB
4.0

After Both 2858360 Mandatory. Event Preview Template Box CDS

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Prepare the Installation PUBLIC 35
SAP Notes for SAP Allocation Management

 Note

Always consult the SAP Notes for SAP Customer Activity Repository, regardless of your scenario. Notes
listed there are common corrections, applicable to all consuming applications.

SAP Notes for SAP Allocation Management

Implement Area SAP Note Description

After the installation Back-end 2841488 This note comprises all back-end corrections of SAP Allocation
Management up to the RTC date of 4.0 FPS02.
SAP Allocation
Management
4.0 FPS02 -
Back End Cor­
rections until
RTC

After the installation Front-end 2842371 This note comprises all front-end corrections of SAP Allocation
Management up to the RTC date of 4.0 FPS02.
SAP Allocation
Management
4.0 FPS02 -
Front End Cor­
rections until
RTC

After the installation Follow-On Sys­ 2618509 Implement the correction to facilitate the creation of allocation ta­
tem bles from SAP Allocation Management in the SAP S/4HANA fol­
Blacklisted
low-on system.
RFC for Crea­
tion of Alloca­
tion Table in
S4H System

After the installation Back-end 2631613 Follow the instructions to create a valid business scenario ID.

SAP Allocation
Management -
Customizing -
Define Busi­
ness Scenarios

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
36 PUBLIC Prepare the Installation
 Implement Area SAP Note Description

After the installation Back-end 2632881 This note contains corrections regarding the SAP HANA database.

SHDB: Low
and High Val­
ues are clipped
during conver­
sion of Selec­
tionTables into
WHERE
clauses

After the installation Back-end 2502917 This note is only relevant if the back-end component SAP_GWFND
752 is below SP 2.
Unable to reg­
ister the serv­
ice /AMR/
OD_WORKLOAD
_SRV with
namespace

After the installation Back-end 2474287 This note resolves inconsistent maintenance of units of measure
between SAP ECC and SAP Customer Activity Repository.
Handling of
units of meas­
ure inside SAP
Allocation
Management

After the installation SAP S/4HANA 2522603 This note can be implemented for calling ATP (available-to-prom­
Retail for mer­ ise) for multiple products in the target SAP S/4HANA or ECC sys­
Wrapper RFC
chandise man­ tem. This note is intended to increase the performance of the ATP
for ATP via
agement call to the target system
Controller

After the installation Back-end 2641286 This note is relevant for SADL implementation services based on
CDS views for back-end software component SAP_GWFND 752
Internal server
error This note is mandatory.
LCX_MISS­
ING_PARAME­
TER in
CL_SADL_ABQ
I

After the installation Back-end 2636746 This note is mandatory for OData services based on CDS views
with parameters relevant for GW_FND version ABAP 7.52 and
OData Naviga­
above.
tion not work­
ing

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Prepare the Installation PUBLIC 37
Implement Area SAP Note Description

After the installation Back-end 2441184 The manual instructions in the note must be implemented for the
successful activation of SAP Allocation Management applications.
Static ABAP
generation er­ This note is mandatory.
ror of
classes /AMR/
CL... when in­
stalling CARAB
1.0 FP03,
CARAB 2.0,
and CARAB
4.0

After the installation Back-end 2777415 Mandatory correction

SAP Allocation
Management :
Activating /AM
R/* views ends
in Error

After the installation Follow-on sys­ 2416853 Enhanced functionality for the transfer of allocation data to an
tem ECC system.
RFC function
module to cre­
ate allocation
table for SAP
Allocation
Management

After the installation Follow-on sys­ 2524857 Creation of an allocation table from SAP Allocation Management
tem in SAP S/4HANA system for the transfer of allocation plans.
RFC function
module to cre­
ate allocation
table for SAP
Allocation
Management
in S4H system

After the installation Back-end 2850366 This note is mandatory if your source system is SAP S/4HANA
1909; otherwise, it is optional. It is highly recommended that it be
HANA Content
installed to ensure the correctness of SAP Allocation
helper report
Management code.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
38 PUBLIC Prepare the Installation
 Implement Area SAP Note Description

After the installation Back-end 2850296 This note is mandatory for distribution curve functionality.

Support for
S/4H 1909
source system
in
report /DMF/
CRE­
ATE_SLT_TA­
BLES

Parent topic: Prepare the Installation [page 26]

Next: Verify SAP HANA Users and Privileges [page 39]

4.2 Verify SAP HANA Users and Privileges

SAP Customer Activity Repository applications bundle is installed in a multi-level system landscape (SAP
HANA database, ABAP back-end server, ABAP front-end server with SAP Gateway and SAP Fiori apps). Each
level requires specific users and privileges. In this procedure, you set up the users and privileges for the SAP
HANA database (level 1 below).

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Prepare the Installation PUBLIC 39
Overview

The following figure shows the three levels of the system landscape and explains the authorizations that must
be set up in each level:

Authorization Levels in SAP Customer Activity Repository applications bundle

 Caution

Level 1: You must set up the users and privileges for the SAP HANA database before installing SAP
Customer Activity Repository applications bundle on the ABAP back-end server and the ABAP front-end
server. This procedure is described below.

 Note

Level 2 and Level 3: You can only set up these authorizations after the installation.

● Level 2: Generally, the back-end users and roles only need to be set up in a new installation scenario. In
an upgrade scenario, they should already be available. The setup is described in section Verify Back-
End Users and Roles.
● Level 3: The required front-end authorizations depend on the application and SAP Fiori apps that you
wish to set up. See the following sections, for example:
Assign Roles, Catalogs, and Groups in SAP Fiori Launchpad (SAP Assortment Planning), Assign Roles,
Catalogs, and Groups in SAP Fiori Launchpad (SAP Allocation Management), or Set Up SAP Fiori Apps
for SAP Customer Activity Repository [page 116]

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
40 PUBLIC Prepare the Installation
Procedure

To set up the authorizations for level 1 (SAP HANA database), follow these steps:

1. Log on to your back-end system in SAP HANA studio.

2. Ensure that the SAP HANA database users listed below exist and that they have the required roles/
privileges.

 Caution

Users marked * must be identical on all three levels: that is, on the SAP HANA database level, on the
back-end server, and on the front-end server.

Users Privileges / Roles

SAP<SID> ○ Privilege REPO.IMPORT

○ Privilege ROLE ADMIN
This is the generic database user
○ Privilege STRUCTUREDPRIVILEGE ADMIN
specified for the connection from the
SAP NetWeaver back-end server to ○ Privilege EXECUTE on procedure TRUNCATE_PROCEDURE_OBJECTS
the SAP HANA database. ○ Privilege EXECUTE on procedure GET_PROCEDURE_OBJECTS
○ Privilege SELECT on schema SAP_ECC (required if your source master
data system is SAP Retail)
○ Privilege SELECT on schema SAP_S4H (required if your source master
data system is SAP S/4HANA)
○ Role CONTENT_ADMIN
○ Role AFLPM_CREATOR_ERASER_EXECUTE
This role must be assigned to execute functions of the PAL library (re­
quired by SAP Assortment Planning, for example).
For more information, see Enable Usage of PAL Functions [page 47] and
SAP Note 2046767 .
○ Role AFL__SYS_AFL_OFL_AREA_EXECUTE
○ Grant the following additional privileges, with option Grantable to others,
on these schemas:
On schema _SYS_BIC:
○ Privilege CREATE ANY
○ Privilege ALTER
On schema <SAP Retail or SAP S/4HANA schema name>:
○ Privilege SELECT

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Prepare the Installation PUBLIC 41
 Users Privileges / Roles

_SYS_REPO ○ Privilege SELECT, with option Grantable to others, on the following physical
database schemas:
○ Physical database schema of your back-end system, this is referred to
as SAP<SID> in this guide
○ Physical database schema that contains the SAP Retail or SAP S/
4HANA tables
○ Physical database schema that contains the SAP CRM tables
○ Physical database schema that contains the SAP Marketing tables
○ Authoring schema SAP_ECC (required if your source master data sys­
tem is SAP Retail)
○ Authoring schema SAP_S4H (required if your source master data sys­
tem is SAP S/4HANA)
You can use the following example SQL statement to grant the privilege:
GRANT SELECT ON SCHEMA <Your schema name> TO
_SYS_REPO WITH GRANT OPTION;
○ Role UDF_DEPLOY_SYS_REPO. For information about the privileges auto­
matically assigned via this role, see Set Up Authorizations for Unified De­
mand Forecast (UDF) [page 78].
○ For SAP Allocation Management, you need the following additional privi­
leges:
○ Privilege CREATE ANY
○ Privilege CREATE SCHEMA

<Your User Name> * ○ Privilege SELECT on schema _SYS_BI

○ Privilege SELECT on schema SAP<SID>
○ Privilege EXECUTE on procedure REPOSITORY_REST
○ Privilege SELECT on schema SAP_ECC (required if your source master
data system is SAP Retail)
○ Privilege SELECT on schema SAP_S4H (required if your source master
data system is SAP S/4HANA)
○ The Session Client of this database user must be set to the appropriate
back-end system client.
This step is necessary to use the SAP Assortment Planning planning
framework, where SAP Analysis for Microsoft Office workbooks obtain
data from SAP HANA views.
For more information, see the Assign Default Client section in the SAP
HANA Modeling Guide.
1. Log on to SAP HANA studio.
2. Open the Modeler perspective and use the Navigator to access your
back-end system.
3. Under Security, select a user.
4. Set the Session Client to the client number created in the Set Up SAP
Client procedure .

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
42 PUBLIC Prepare the Installation
Parent topic: Prepare the Installation [page 26]

Previous: Implement SAP Notes for the Installation [page 26]

Next: Verify Correct Schema Mapping [page 43]

4.3 Verify Correct Schema Mapping

In SAP HANA studio, verify that all “authoring schemas” of SAP Customer Activity Repository applications
bundle are mapped to the correct “physical schema” of your customer back-end system. If necessary, create
any mappings that are missing. This procedure is mandatory for all the applications.

Context

What are Authoring Schemas and Physical Schemas

The SAP HANA content of SAP Customer Activity Repository applications bundle is delivered with several
authoring schemas (for different scenarios and different source master data systems).

You must map multiple authoring schemas to the same physical schema:

● The authoring schema is the logical database schema with which the SAP HANA objects were originally
created in the SAP source system. The authoring schema is listed in each object's properties in SAP HANA
studio. Different objects can have different authoring schemas.
● The logical database schema of your customer back-end system is the physical schema. When you
replicate tables from the source master data system later on, this back-end system with its physical
schema is the target system. This is why all authoring schemas must be mapped to this one physical
schema of your customer system (n:1 relationship).

What is Your SAP<SID> Name (Schema Name, User Name)

In this guide, your physical schema is referred to as SAP<SID>. This is your customer-defined database system
ID.

Substitute this schema name whenever the SAP<SID> variable is used in this guide.

If you don't know the SAP<SID> name for your system, there are two easy ways to find it:

● Log on to your ABAP back-end system using SAP Logon. Choose System Status . In the lower right-
hand section titled Database data, see the name for Schema.
● In SAP HANA studio, the schema name is listed as an object under Catalog.

Why Schema Mapping

Schema mapping is essential when the source system and the target system have different physical schemas
(SAP<SID> names).

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Prepare the Installation PUBLIC 43
● Schema mapping allows you to transport SAP HANA objects from the source system to the target system.
For example, from the SAP delivery system to your test system, and from your test system to your
production system. After schema mapping, you can access and deploy the transported objects.
● Schema mapping is a prerequisite for activating the SAP HANA content.
● Schema mapping is also a prerequisite for replicating the required SLT tables from the source master data
system to your SAP Customer Activity Repository back-end system.

Authoring Schemas

Two sets of authoring schemas are relevant for this release:

Table 1: Authoring Schemas in SAP Customer Activity Repository applications bundle

SAP_CAR SAP HANA objects for SAP Customer Activity Repository

SAP_DDF SAP HANA objects for Demand Data Foundation and Unified
Demand Forecast

SAPOSA SAP HANA objects for On-Shelf Availability

SAP_RAP SAP HANA objects for consuming applications (such as SAP

Assortment Planning or SAP Merchandise Planning)

SAP_RTLRAP_AMR SAP HANA objects for SAP Allocation Management

Table 2: Authoring Schemas for Source Master Data Systems

SAP_CRM SAP Customer Relationship Management

SAP_CUAN SAP Marketing

SAP_ECC SAP ERP (SAP Retail)

SAP_S4H SAP S/4HANA Retail

Prerequisites

You have set up the authorizations as described in Verify SAP HANA Users and Privileges [page 39].

Procedure

1. In SAP HANA studio, log on to your back-end system.

2. Choose Window Perspective Open Perspective SAP HANA Modeler .
3. Choose Help Quick View Schema Mapping .

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
44 PUBLIC Prepare the Installation
 4. Select the system and choose Add.
5. Enter the authoring schema and physical schema that need to be mapped.
○ Map all authoring schemas from table 1 to the same physical schema (SAP<SID>) in your customer
system. If necessary, add new mappings.
○ Map each authoring schema from table 2 to the physical schema for the respective source master
data system in your customer system. If necessary, add new mappings.
6. Choose OK.

 Note

If you are using an SAP HANA system with multiple isolated tenant databases to perform cross
database access between tenants, you must provide the authoring database name and the physical
database name in the schema mapping definition.

Use the SYS_BI.M_DATABASE_SCHEMA_MAPPING table to maintain schema mapping definitions.

For more information, see https://help.sap.com/viewer/p/SAP_HANA_PLATFORM Development

SAP HANA Modeling Guide (SAP HANA Studio) . Consult the https://help.sap.com/viewer/
fc5ace7a367c434190a8047881f92ed8/2.0.03/en-US/
4cba3069bc39448581e7f83d52218bc5.htmlMap Authoring Schema to Physical Schema section,
including its subsections.

Parent topic: Prepare the Installation [page 26]

Previous: Verify SAP HANA Users and Privileges [page 39]

Next: Generate Time Data - Gregorian Calendar [page 45]

4.4 Generate Time Data - Gregorian Calendar

Perform a generic calendar setting in SAP HANA studio.

Use

Execute this procedure to generate time data for the calendar type Gregorian. This setting is required for
several SAP Fiori apps in SAP Customer Activity Repository applications bundle, for example.

 Note

Specific scenarios of SAP Customer Activity Repository applications bundle might require you to select the
Fiscal calendar type (instead of the Gregorian). If so, this will be indicated later in the guide, when you get to
the setup procedures for the different consuming applications (under Set Up the Applications [page 73]).

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Prepare the Installation PUBLIC 45
Prerequisites

Read the following calendar information for SAP HANA Platform: Navigate to https://help.sap.com/viewer/p/
SAP_HANA_PLATFORM and select your version at the top. Under Development, choose the SAP HANA
Modeling Guide (for SAP HANA Studio). See the Generate Time Data section and its subsections.

Procedure

1. Open SAP HANA studio and log in to your back-end system.

2. Open the SAP HANA Modeler perspective.
3. On the Quick View tab, choose Generate Time Data.
4. Select your back-end system and choose Next.
5. Select the calendar type Gregorian.
6. Enter a From Year and a To Year.

 Note

The range of years should include all the years of data that you plan to store in SAP Customer Activity
Repository.

 Example

If you plan to start using SAP Customer Activity Repository on January 1, 2019, enter 2019 as your
starting year. But if you plan to access sales documents created in SAP Retail that date back to January
2017, enter 2017 as your starting year.

7. Select the granularity.

 Note

Day is the minimum granularity required by SAP Customer Activity Repository. You can choose a finer
level of granularity, for example Hour, if necessary.

8. Choose Finish.

Parent topic: Prepare the Installation [page 26]

Previous: Verify Correct Schema Mapping [page 43]

Next: Configure AFL Usage [page 47]

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
46 PUBLIC Prepare the Installation
4.5 Configure AFL Usage

Perform configuration tasks to enable the usage of application function libraries (such as the PAL and the OFL)
for the applications SAP Assortment Planning and SAP Allocation Management.

Enable Usage of PAL Functions (SAP Assortment Planning) [page 47]

To enable the usage of the PAL algorithm for SAP Assortment Planning, perform the required setup
steps.

Check the OFL Installation [page 48]

Confirm that the OFL algorithm was installed successfully as prerequisite for SAP Assortment Planning
and SAP Allocation Management.

Parent topic: Prepare the Installation [page 26]

Previous: Generate Time Data - Gregorian Calendar [page 45]

4.5.1 Enable Usage of PAL Functions (SAP Assortment

Planning)

To enable the usage of the PAL algorithm for SAP Assortment Planning, perform the required setup steps.

Use

The installation of SAP HANA Platform includes the installation of the PAL algorithm, a prerequisite for SAP
Assortment Planning.

To enable the usage of the PAL algorithm, as required by SAP Assortment Planning, perform the following
procedure.

 Note

You do not need to create the AFL_WRAPPER_GENERATOR or AFL_WRAPPER_ERASER procedures, nor do

you need to generate any special PAL procedures; this is done automatically.

Procedure

1. To confirm that the PAL functions were installed successfully, you can run SELECT statements in the three
relevant public views as follows:
○ SELECT * FROM SYS.AFL_AREAS WHERE AREA_NAME = 'AFLPAL';
In the case of a successful installation, the statement should return 1 row.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Prepare the Installation PUBLIC 47
 ○ SELECT * FROM SYS.AFL_PACKAGES WHERE AREA_NAME = 'AFLPAL';
In the case of a successful installation, the statement should return 1 row.
○ SELECT * FROM SYS.AFL_FUNCTIONS WHERE AREA_NAME = 'AFLPAL';
In the case of a successful installation, the statement should return many rows. Verify that the function
KMEANS is part of the list.

More Information

● Section Install the Prerequisites [page 17] Common Prerequisites SAP HANA Platform
● http://help.sap.com/hana_platform <Version> Reference SAP HANA Predictive Analysis Library
(PAL)

4.5.2 Check the OFL Installation

Confirm that the OFL algorithm was installed successfully as prerequisite for SAP Assortment Planning and
SAP Allocation Management.

Use

The installation of SAP HANA Platform includes the installation of the OFL algorithm, a prerequisite for SAP
Assortment Planning.

Procedure

1. To confirm that the OFL was installed successfully, you can run SELECT statements in the three relevant
public views as follows:
○ SELECT * FROM SYS.AFL_AREAS WHERE AREA_NAME = 'OFL_AREA';
In the case of a successful installation, the statement should return 1 row.
○ SELECT * FROM SYS.AFL_PACKAGES WHERE AREA_NAME = 'OFL_AREA';
In the case of a successful installation, the statement should return 1 row.
○ SELECT * FROM SYS.AFL_FUNCTIONS WHERE AREA_NAME = 'OFL_AREA';
In the case of a successful installation, the statement should return 4 rows. Verify that the function
GENIOS_SOLVE is part of the list.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
48 PUBLIC Prepare the Installation
Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Prepare the Installation PUBLIC 49
5 Install the Software

For a correct installation, you must first install the required prerequisites and pre-installation SAP Notes. Then
you install the back-end components and the front-end components. Lastly, you check for SAP Notes that
must be implemented after the installation.

1. Verify Prerequisites and SAP Notes [page 50]

Ensure that the required prerequisites and SAP Notes have been implemented in your system
landscape.
2. Install ABAP Back-End Server [page 51]
Install the SAP RTL AFL FOR SAP HANA component in the SAP HANA database. In your back-end
system, then install the back-end product version of SAP Customer Activity Repository applications
bundle and set up an SAP client.
3. Install ABAP Front-End Server [page 59]
Install the complete UI layer in the front-end system. This UI layer consists of SAP Gateway, the central
SAP Fiori UI component (SAP Fiori front-end server), and the product-specific SAP Fiori UI component
(front-end product version of SAP Customer Activity Repository applications bundle).
4. Install Alternate Storage (Optional) [page 63]
You only need to implement this procedure if you plan on using the Table Content Aging report delivered
with SAP Customer Activity Repository. This report allows you to copy your transaction log (TLOG)
data and its extensions from your SAP HANA database to an alternate storage technology (such as
SAP IQ or Apache Hadoop), thereby reducing your total cost of hardware ownership.

5.1 Verify Prerequisites and SAP Notes

Ensure that the required prerequisites and SAP Notes have been implemented in your system landscape.

1. Verify that you have installed and configured the required prerequisites for your scenario. See Install the
Prerequisites [page 17] under Common Prerequisites and Application-Specific Prerequisites.
2. Verify that all SAP Notes that must be applied before the installation and that are required for your
scenario have been implemented.
See Implement SAP Notes for the Installation [page 26].

 Note

Always consult the table for SAP Customer Activity Repository, regardless of your scenario. Notes
listed there are often common corrections, applicable to all consuming applications.

Parent topic: Install the Software [page 50]

Next: Install ABAP Back-End Server [page 51]

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
50 PUBLIC Install the Software
5.2 Install ABAP Back-End Server

Install the SAP RTL AFL FOR SAP HANA component in the SAP HANA database. In your back-end system,
then install the back-end product version of SAP Customer Activity Repository applications bundle and set up
an SAP client.

Context

The ABAP back-end server is based on SAP NetWeaver. It contains the products that provide the business logic
and the back-end data, including users, roles, and authorizations.

 Note

For a general system landscape overview, see https://help.sap.com/viewer/p/FIORI_IMPLEMENTATION

<Version> Installation and Upgrade SAP Fiori: Setup and Configuration Setup of SAP Fiori System
Landscape .

1. Download and Install the Application Function Library (SAP RTL AFL FOR SAP HANA) [page 51]
Install compatible revisions of the SAP RTL AFL FOR SAP HANA component, the SAP HANA AFL
component, and the SAP HANA database. You must do this before you install the back-end product
version of SAP Customer Activity Repository applications bundle.
2. Install SAP Customer Activity Repository applications bundle (Back-End Product Version) [page 54]
Install the SAP CARAB 4.0 FPS02 back-end product version of SAP Customer Activity Repository
applications bundle 4.0 FPS02 in your back-end system. First create a stack XML file with Maintenance
Planner. Then install this file with Software Update Manager (transaction SUM).
3. Set Up SAP Client [page 57]
Set up an SAP client on your back-end system. The steps to follow depend on whether your scenario
uses the Demand Data Foundation (DDF) module in SAP Customer Activity Repository or not.

Parent topic: Install the Software [page 50]

Previous: Verify Prerequisites and SAP Notes [page 50]

Next: Install ABAP Front-End Server [page 59]

5.2.1 Download and Install the Application Function Library

(SAP RTL AFL FOR SAP HANA)

Install compatible revisions of the SAP RTL AFL FOR SAP HANA component, the SAP HANA AFL component,
and the SAP HANA database. You must do this before you install the back-end product version of SAP
Customer Activity Repository applications bundle.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Install the Software PUBLIC 51
Overview

There is one software component in SAP Customer Activity Repository applications bundle that you must
always install first: SAP RTL AFL FOR SAP HANA.

You must download compatible revisions of SAP RTL AFL FOR SAP HANA, SAP HANA AFL, and SAP HANA
DATABASE, and install them together. For this, you need to be aware of the following dependencies.

Dependencies Between the AFLs and the SAP HANA Database

Even though SAP RTL AFL FOR SAP HANA is part of SAP Customer Activity Repository applications bundle,
the component is released independently.

The reason is that AFL components (such as SAP RTL AFL FOR SAP HANA and SAP HANA AFL) follow the
release cycle of the SAP HANA database. The releases are called “revisions”. Whenever a new revision of the
SAP HANA database is released, a new revision of each AFL is released. As a result, there are always multiple
revisions of each component available for download.

 Caution

Compatible Revisions

For each revision of an AFL component, there is only one compatible revision of the SAP HANA database.
Whenever you upgrade the AFL components to a new revision, you must also upgrade the database.
Whenever you upgrade the database to a new revision, you must also upgrade the AFL components.

This applies not only during a new installation or an upgrade, but is equally relevant if you decide to
upgrade your SAP HANA Platform to a higher revision or even support package stack later on.

Patches

Within the same revision, however, you can still upgrade an AFL component to a newer patch. Example:

● Your current revision of SAP RTL AFL FOR SAP HANA is:
Revision 37.200 for SAP HANA Platform 2.0 SPS03 Revision 37.02
● A new patch of SAP RTL AFL FOR SAP HANA might be:
Revision 37.201 for SAP HANA Platform 2.0 SPS03 Revision 37.02

Download and Install SAP RTL AFL FOR SAP HANA

 Note

When you download an AFL from the SAP Support Portal, the compatible revision of the SAP HANA
database is always indicated.

1. Determine which revision of the SAP HANA database and the AFL components you wish to install.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
52 PUBLIC Install the Software
 To select the best revision for your scenario, see the Common Prerequisites in section Install the
Prerequisites [page 17]. Carefully read the information under SAP HANA Platform 2.0 and SAP RTL AFL
FOR SAP HANA:
○ Note the minimum revision of the SAP HANA database and the AFL components. You need at least
this revision for the current release.
○ Note what you need to do if you wish to select a higher revision than the minimum revision.
Once you have selected a revision, this gives you the compatible revisions of the other components.
2. Download the compatible revisions from the SAP Support Portal at http://support.sap.com Download
Software :

 Tip

Alternatively, you can log in to the SAP ONE Support Launchpad at https://
launchpad.support.sap.com/#/softwarecenter/ and follow the navigation from there.

○ SAP RTL AFL FOR SAP HANA:

This component is included in the SAP CARAB back-end product version. You can find the available
revisions under By Alphabetical Index (A-Z) C CAR RETAIL APPLICATIONS BUNDLE SAP
CARAB 4.0 Support Packages and Patches DOWNLOADS COMPRISED SOFTWARE
COMPONENT VERSIONS SAP RTL AFL FOR SAP HANA 200 .

 Note

When downloading SAP RTL AFL FOR SAP HANA, you might also see another AFL component
called SAP XRP AFL. You can ignore this component and don't need to download nor install it.

○ SAP HANA AFL and SAP HANA DATABASE:

These components are included in SAP HANA Platform. You can find the available revisions under
By Alphabetical Index (A-Z) H SAP HANA PLATFORM EDITION SAP HANA PLATFORM
EDITION 2.0 Support Packages and Patches DOWNLOADS SAP HANA AFL 2.0 and SAP HANA
DATABASE 2.0.
○ If applicable, other AFLs provided with the SAP HANA Platform that might be relevant for your
scenario. For an overview, see the Managing SAP HANA System Components section of the SAP HANA
Server Installation and Update Guide at https://help.sap.com/viewer/p/SAP_HANA_PLATFORM under
<Version> Installation and Upgrade .
3. Install the selected revisions of SAP RTL AFL FOR SAP HANA, SAP HANA AFL, and SAP HANA
DATABASE in your back-end system.
See SAP Note 2377894 and carefully follow the steps for the new installation scenario.

 Tip

If you encounter issues during the installation, see the Troubleshooting [page 166] section for possible
solutions.

Result

You have successfully installed the SAP RTL AFL FOR SAP HANA component.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Install the Software PUBLIC 53
  Remember

For future updates of your system landscape, remember that the dependencies between the AFL
components and the SAP HANA database still apply.

For example, should you later decide to upgrade your SAP Customer Activity Repository applications
bundle scenario to a higher release requiring a higher AFL revision, you will also need to upgrade the
database.

Vice versa, should you decide to upgrade your SAP HANA database to a higher revision (for example, to use
new features in SAP HANA), you will also need to upgrade all AFL components to the compatible revision.

Parent topic: Install ABAP Back-End Server [page 51]

Next: Install SAP Customer Activity Repository applications bundle (Back-End Product Version) [page 54]

5.2.2 Install SAP Customer Activity Repository applications

bundle (Back-End Product Version)

Install the SAP CARAB 4.0 FPS02 back-end product version of SAP Customer Activity Repository
applications bundle 4.0 FPS02 in your back-end system. First create a stack XML file with Maintenance
Planner. Then install this file with Software Update Manager (transaction SUM).

Prerequisites

● You have completed all of the procedures described in the previous sections of this guide. In particular, see
section Prepare the Installation [page 26].
● You have installed compatible revisions of the SAP HANA database, the SAP HANA AFL component, and
the SAP RTL AFL FOR SAP HANA component. If you need information on the required revisions, see
Install the Prerequisites [page 17].
● (Optional) For information on the supported interoperability scenarios between the back-end product
version and the front-end product version, see SAP Note 2815026 (Back-end and front-end
interoperability in SAP Customer Activity Repository applications bundle 4.0).

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
54 PUBLIC Install the Software
Overview

In the procedures below you do the following:

Use this tool... To do this...

Maintenance Planner Plan your system landscape and create a stack XML file
based on the required product versions.
More information: https://help.sap.com/viewer/p/MAINTE­
NANCE_PLANNER

Software Update Manager (SUM) Install or upgrade components using the stack XML file.

More information: https://support.sap.com/en/tools/soft­

ware-logistics-tools/software-update-manager.html

 Note

It may be possible to install or upgrade components using the SAP Add-On Installation Tool (transaction
SAINT) or the Support Package Manager (transaction SPAM), but these alternative procedures are not
described in this guide. For information on whether they are possible for your implementation scenario and
on how to proceed, see SAP Note 1803986 .

Create the Stack XML File Using Maintenance Planner

 Note

If you encounter issues with Maintenance Planner, see the following SAP Notes for possible solutions:

● 2596901 : NetWeaver 7.51 and 7.52 targets are not available when selecting the option "Update SAP
NetWeaver" in Maintenance Planner
● 2535751 : Can not select the higher release for Netweaver in Maintenance Planner
● 2314463 : Required file K-XXXxxxxxxxx.SAR is not visible for your user Sxxxxxxx

1. Log on to Maintenance Planner at http://support.sap.com Maintenance Maintenance Information

Maintenance Planner Access Maintenance Planner .
2. Choose Plan a New System.
3. Choose Plan.
4. Enter a three-character system ID.
5. Select Install an SAP NETWEAVER System.
6. Select one of the following product versions and support package stacks:
○ ABAP FND 1709 ON HANA and SPS02 (05/2018) (or a higher support package stack)
○ ABAP FND 1809 ON HANA and Initial Shipment Stack (or a higher support package stack)
7. Select a valid instance (for example, SAP Foundation).
8. Choose Confirm Selection.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Install the Software PUBLIC 55
9. Choose Install or Maintain an Add-On.
10. Select the back-end product version SAP CARAB 4.0 and the support package stack FPS02 (11/2019).
11. Select the instance CAR Retail Application Bundle.
12. Choose Confirm Selection.
13. Choose Next.
14. Select the operating system and database for your scenario.
15. Choose Confirm Selection.
16. Review the details of your stack dependent and independent files, then choose Next.
17. Choose Download Stack XML.
You have now created the stack XML file.

Install the Stack XML File Using Software Update Manager (SUM)

1. Download and install the SUM tool:

1. See the SAP Support Portal at https://support.sap.com/en/tools/software-logistics-tools/software-
update-manager.html .
2. Consult the information for SUM 2.0 SP xx and follow the instructions.
2. In SUM, install your add-on product using the stack XML file that you have created in the first procedure.

Result

You have successfully installed the back-end product version.

 Note

With this installation, the SAP HANA content for Unified Demand Forecast (UDF) has already been
activated automatically. This saves you a manual activation step later on.

Continue with the next section.

Parent topic: Install ABAP Back-End Server [page 51]

Previous: Download and Install the Application Function Library (SAP RTL AFL FOR SAP HANA) [page 51]

Next: Set Up SAP Client [page 57]

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
56 PUBLIC Install the Software
5.2.3 Set Up SAP Client

Set up an SAP client on your back-end system. The steps to follow depend on whether your scenario uses the
Demand Data Foundation (DDF) module in SAP Customer Activity Repository or not.

Procedure for All Scenarios Using DDF

Choose this procedure in the following cases:

● You want to model and forecast demand using the UDF module in SAP Customer Activity Repository.
● You want to use the Omnichannel Promotion Pricing (OPP) module in SAP Customer Activity Repository.
● You want to use SAP Allocation Management.
● You want to use SAP Assortment Planning.
● You want to use SAP Merchandise Planning.
● You want to use SAP Promotion Management.

Follow these steps:

1. In transaction SCC4, create the necessary client on your back-end system.

 Caution

If you are performing a client copy, only do this after you have successfully imported all related
software components. Also, only import or transfer Customizing tables after the client copy is
complete. For instructions, see SAP Note 337623 (Customizing after installation or upgrade).

2. In Customizing (transaction SPRO), choose Cross-Application Components Demand Data Foundation

Basic Settings Define Logical Systems .
Define the logical systems you need and make all required settings. Here you also define the master data
system type (SAP Retail or SAP S/4HANA).

 Note

If you have multiple source master data systems and/or clients, you must define a logical system for
each system/client.

Carefully read the activity documentation and verify that your settings are correct.

Procedure for Scenarios Not Using Demand Data Foundation

Choose this procedure if you are implementing a non-DDF scenario:

● POS Data Transfer and Audit

● Multichannel Transaction Data Management
● Inventory Visibility
● On-Shelf Availability

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Install the Software PUBLIC 57
Follow these steps:

1. Verify the client numbers in the source master data systems:

○ source SAP Retail system
○ source SAP S/4HANA system
○ source systems of any optional products that you wish to implement with SAP Customer Activity
Repository (such as SAP CRM and SAP Marketing)
SAP Customer Activity Repository includes SAP HANA content that provides views on a combination of
client-dependent data authored in these source master data systems. For instance, sales documents are
created in a source SAP Retail system and are replicated to the repository. Likewise, customer information
can be optionally replicated from a source SAP CRM or SAP Marketing system.
2. In transaction SCC4, create the necessary client on your back-end system.

 Caution

If you are performing a client copy, only do this after you have successfully imported all related
software components. Also, only import or transfer Customizing tables after the client copy is
complete. For instructions, see SAP Note 337623 (Customizing after installation or upgrade).

Using the same client number might not be possible due to the specifics of your implementation and client
setup rules. In this case, you must use SLT transformation rules before replicating data to transform the
source SAP Retail or SAP S/4HANA, and optionally, the source SAP CRM or SAP Marketing clients to
match the client on your back-end system.

 Example

If SAP Retail and SAP CRM (or SAP Marketing) are set up on client 100 in your implementation, you
should also set up your installation on client 100. If, for any reason, you are unable to do so, you can
transform the source client to 100 using SLT transformation rules.

Cross-system information is client-dependent. As a result, the SAP Client (MANDT) attribute must be used
as one of the join attributes in the SAP HANA views to combine cross-system sales and master data. All
data (whether created or replicated) must be affiliated with the same client number.
3. If required, enable the support of multiple source master data systems and do the client mapping for each
of these systems.
In Customizing, choose SAP Customer Activity Repository General Settings Client Mapping For
Multiple ERP Systems and make the required settings.

More Information

For more information about the client concept, see https://help.sap.com/viewer/product/

SAP_NETWEAVER/ALL/en-US and select your version of SAP NetWeaver. Then choose Application Help
SAP NetWeaver Library: Function-Oriented View Application Server ABAP Other Services Services for
Administrators Client Concept .

Parent topic: Install ABAP Back-End Server [page 51]

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
58 PUBLIC Install the Software
Previous: Install SAP Customer Activity Repository applications bundle (Back-End Product Version) [page 54]

5.3 Install ABAP Front-End Server

Install the complete UI layer in the front-end system. This UI layer consists of SAP Gateway, the central SAP
Fiori UI component (SAP Fiori front-end server), and the product-specific SAP Fiori UI component (front-end
product version of SAP Customer Activity Repository applications bundle).

Context

The ABAP front-end server contains all the infrastructure components to generate an SAP Fiori app-specific
UI for the client and to communicate with the back-end systems. The UI components and SAP Gateway are
based on SAP NetWeaver.

The central SAP Fiori UI component is a framework that provides the common infrastructure for all SAP Fiori
apps: The SAP Fiori launchpad is the basis of all SAP Fiori UIs, and provides fundamental functions for SAP
Fiori apps (such as logon, surface sizing, navigation between apps, and role- based app catalogs). End-users
access the SAP Fiori apps from the SAP Fiori launchpad.

 Note

For a general system landscape overview, see https://help.sap.com/viewer/p/FIORI_IMPLEMENTATION

<Version> Installation and Upgrade SAP Fiori: Setup and Configuration Setup of SAP Fiori System
Landscape .

1. Install SAP Gateway on the ABAP Front-End Server [page 60]

SAP Gateway (SAP_GWFND) is a component in SAP NetWeaver. In this procedure, you ensure that the
required SAP NetWeaver version is installed on your ABAP front-end server.
2. Verify Installation of Central SAP Fiori UI Component [page 60]
The central SAP Fiori UI component includes the SAPUI5 control library and the SAP Fiori launchpad. It
is delivered as part of the SAP Fiori front-end server. Verify that the required version of the SAP Fiori
front-end server is installed in your front-end system.
3. Install Product-Specific SAP Fiori UI Component (Front-End Product Version) [page 61]
Install the SAP FIORI FOR SAP CARAB 4.0 FPS02 front-end product version in your front-end system.
The product version contains the SAP Fiori apps for SAP Customer Activity Repository applications
bundle. First create a stack XML file with Maintenance Planner and then install the stack XML file with
Software Update Manager (transaction SUM).

Parent topic: Install the Software [page 50]

Previous: Install ABAP Back-End Server [page 51]

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Install the Software PUBLIC 59
Next: Install Alternate Storage (Optional) [page 63]

5.3.1 Install SAP Gateway on the ABAP Front-End Server

SAP Gateway (SAP_GWFND) is a component in SAP NetWeaver. In this procedure, you ensure that the required
SAP NetWeaver version is installed on your ABAP front-end server.

Context

SAP Gateway (sometimes called SAP Gateway Foundation) handles the communication between the ABAP
back-end server and the client on the front-end. It establishes a connection between SAP Business Suite or
application data and target clients, platforms, and programming framework.

 Note

With the recommended central hub deployment option, you use separate servers for the back-end and the
front-end components. For a landscape diagram and more information about deployment options, see
System Landscape [page 13].

Procedure

1. Ensure that the required SAP NetWeaver version is installed on your front-end server. For more
information, see the following:
○ For the required version, see Install the Prerequisites [page 17] and consult the information under
Common Prerequisites Foundation on SAP NetWeaver AS for ABAP, version for SAP HANA and
SAP Fiori.
○ For installation and upgrade information for SAP Fiori, see https://help.sap.com/viewer/p/
FIORI_IMPLEMENTATION <Version> Installation and Upgrade SAP Fiori: Setup and
Configuration Setup of SAP Fiori System Landscape , including the Installation subsection.

Parent topic: Install ABAP Front-End Server [page 59]

Next: Verify Installation of Central SAP Fiori UI Component [page 60]

5.3.2 Verify Installation of Central SAP Fiori UI Component

The central SAP Fiori UI component includes the SAPUI5 control library and the SAP Fiori launchpad. It is
delivered as part of the SAP Fiori front-end server. Verify that the required version of the SAP Fiori front-end
server is installed in your front-end system.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
60 PUBLIC Install the Software
Context

The add-on product SAP Fiori front-end server contains the technology software components that are required
to run SAP Fiori scenarios on an ABAP front-end server.

Procedure

1. Verify what version of SAP Fiori front-end server is required for this release.
See Install the Prerequisites [page 17] under Common Prerequisites SAP Fiori . The section also
points you to the installation information.
2. Ensure that the required version is installed on your front-end server.

Parent topic: Install ABAP Front-End Server [page 59]

Previous: Install SAP Gateway on the ABAP Front-End Server [page 60]

Next: Install Product-Specific SAP Fiori UI Component (Front-End Product Version) [page 61]

5.3.3 Install Product-Specific SAP Fiori UI Component (Front-

End Product Version)

Install the SAP FIORI FOR SAP CARAB 4.0 FPS02 front-end product version in your front-end system. The
product version contains the SAP Fiori apps for SAP Customer Activity Repository applications bundle. First
create a stack XML file with Maintenance Planner and then install the stack XML file with Software Update
Manager (transaction SUM).

Prerequisites

● You have completed the previous procedures in this guide.

● (Optional) For information on the supported interoperability scenarios between the back-end product
version and the front-end product version, see SAP Note 2815026 (Back-end and front-end
interoperability in SAP Customer Activity Repository applications bundle 4.0).

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Install the Software PUBLIC 61
Overview

In the procedures below you do the following:

Use this tool... To do this...

Maintenance Planner Plan your system landscape and create a stack XML file
based on the required product versions.
More information: https://help.sap.com/viewer/p/MAINTE­
NANCE_PLANNER

Software Update Manager (SUM) Install or upgrade components using the stack XML file.

More information: https://support.sap.com/en/tools/soft­

ware-logistics-tools/software-update-manager.html

 Note

It may be possible to install or upgrade components using the SAP Add-On Installation Tool (transaction
SAINT) or the Support Package Manager (transaction SPAM), but these alternative procedures are not
described in this guide. For information on whether they are possible for your implementation scenario and
on how to proceed, see SAP Note 1803986 .

Create the Stack XML File Using Maintenance Planner

 Note

If you encounter issues with Maintenance Planner, see the following SAP Notes for possible solutions:

● 2596901 : NetWeaver 7.51 and 7.52 targets are not available when selecting the option "Update SAP
NetWeaver" in Maintenance Planner
● 2535751 : Can not select the higher release for Netweaver in Maintenance Planner
● 2314463 : Required file K-XXXxxxxxxxx.SAR is not visible for your user Sxxxxxxx

1. Log in to Maintenance Planner at https://help.sap.com/viewer/p/MAINTENANCE_PLANNER Additional

Information Launch Maintenance Planner .
2. Choose Plan a New System.
3. Choose Plan.
4. Choose a system type (ABAP system) and enter a three-character system ID.
5. Choose Install an SAP NetWeaver System.
6. Select a valid product version (for example, SAP NETWEAVER 7.5) and a valid support package stack.
7. Select a valid instance (for example, Application Server ABAP).
8. Choose Confirm Selection.
9. Choose Install or Maintain an Add-On.
10. Select the SAP FIORI FOR SAP CARAB 4.0 FPS02 front-end product version.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
62 PUBLIC Install the Software
 11. Select a valid front-end server instance.
12. Choose Confirm Selection.
13. Choose Next.
14. Select the operating system and database for your implementation scenario.
15. Choose Confirm Selection.
16. Review the details of your stack-dependent and stack-independent files, then choose Next.
17. Choose Download Stack XML.

Install the Stack XML File Using Software Update Manager (SUM)

1. Download and install the SUM tool:

1. See the SAP Support Portal at https://support.sap.com/en/tools/software-logistics-tools/software-
update-manager.html .
2. Consult the information for SUM 2.0 SP xx and follow the instructions.
2. In SUM, use the stack XML file that you have created in the first procedure to install your add-on product.

Result

You have successfully installed the front-end product version for this release.

Continue with the next section.

Parent topic: Install ABAP Front-End Server [page 59]

Previous: Verify Installation of Central SAP Fiori UI Component [page 60]

5.4 Install Alternate Storage (Optional)

You only need to implement this procedure if you plan on using the Table Content Aging report delivered with
SAP Customer Activity Repository. This report allows you to copy your transaction log (TLOG) data and its
extensions from your SAP HANA database to an alternate storage technology (such as SAP IQ or Apache
Hadoop), thereby reducing your total cost of hardware ownership.

Use

For more information, see SAP Help Portal at https://help.sap.com/viewer/p/CARAB <Version>

Application Help SAP Customer Activity Repository POS Data Transfer and Audit Implementing a POS
Transaction Data Storage Strategy Using the Table Content Aging Report .

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Install the Software PUBLIC 63
  Note

If your scenario includes demand modeling and forecasting with the Unified Demand Forecast (UDF)
module, we recommend retaining the historical sales data in memory.

Process Flow

In order to successfully install alternate storage, you must execute the following procedures:

1. Do one of the following:

○ Install and set up integration with SAP IQ, or
○ Install and set up integration with Apache Hadoop, or
○ Install and set up integration with SAP HANA Dynamic Tiering
2. Create the remote source in SAP HANA studio (not applicable for integration with SAP HANA Dynamic
Tiering).
3. Create the virtual table.
4. Set the deploy mode in SAP HANA Transport for ABAP.

Parent topic: Install the Software [page 50]

Previous: Install ABAP Front-End Server [page 59]

5.4.1 Install and Set Up Integration with SAP IQ

You use these procedures to install and set up SAP IQ to support the Table Content Aging report
(transaction /CAR/TABLE_AGING) delivered with SAP Customer Activity Repository.

The SAP HANA database points to your SAP IQ database using SAP HANA smart data access (SDA), which
exposes data from SAP IQ remote sources as virtual tables.

For more information, see SAP Help Portal at https://help.sap.com/viewer/p/CARAB <your release>
Application Help SAP Customer Activity Repository POS Data Transfer and Audit Implementing a POS
Transaction Data Storage Strategy Using the Table Content Aging Report .

Install SAP IQ

A detailed procedure is described in the SAP IQ Installation and Update Guide.

For more information, see SAP Help Portal at https://help.sap.com/viewer/p/SAP_IQ Installation and
Upgrade SAP IQ Installation and Update Guide for <your operating system> .

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
64 PUBLIC Install the Software
Configure SAP IQ

1. Allocate sufficient space into which your data will be loaded.

 Note

The default DBSpaces provided during installation are intended to be used for SAP IQ system
management. You should create your own DBSpace under the Main store with a DB File that is large
enough to satisfy your sizing requirements.

For more information, see SAP Help Portal at https://help.sap.com/viewer/p/SAP_IQ Reference

SAP IQ SQL Reference SQL Statements CREATE DBSPACE Statement .

2. Create an in-memory row-level versioning (RLV) store.

For more information, see SAP Help Portal at https://help.sap.com/viewer/p/SAP_IQ Administration
SAP IQ Administration: In-Memory Row-Level Versioning About In-Memory Row-Level Versioning .

 Note

Click View All if topic does not appear in initial list.

3. Create a database under the content created at the beginning of this procedure.

 Note

Ensure the following:

○ The SAP IQ stores are configured with a large enough cache configuration, main memory, and
temporary memory.
○ The page size should be set to 128KB.
○ The concurrency aligns with the amount of processes that will be triggered during the data copy.

For more information, see SAP Help Portal at https://help.sap.com/viewer/p/SAP_IQ Configuration

Performance and Tuning Guide .
4. Create the following tables in the DBSpace created at the beginning of the procedure:
○ /POSDW/TLOGF
○ /POSDW/TLOGF_EXT
○ /POSDW/TLOGF_X
○ /POSDW/PLOGF

 Note

These tables should have the same structure as the tables in your SAP HANA system. One possible
way is to export the table structure via Export SQL on the SAP HANA side, and import it on the SAP IQ
side using the SQL console.

The SQL statement requires some modifications, such as:

○ Converting all the column names in the exported SQL statement to lower case (for example,
“RETAILSTOREID becomes “retailstoreid”).
You can simply convert the entire SQL statement into lower case and then only convert the table
name to upper case to keep the table name unchanged.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Install the Software PUBLIC 65
 ○ Renaming of NVARCHAR to VARCHAR.
○ Removing references to CS_* (for example, CS_FIXED).

5. Enable the RLV for the tables you just created.

6. Set the snapshot versioning property of the transaction to row-level.

 Example

set option Snapshot_Versioning = 'Row-level';

7. Enable connection blocking and set the blocking timeout threshold.

 Example

set option blocking = 'On';

set option blocking_timeout = '0';

Install SAP IQ Drivers

Install and configure the ODBC database drivers required to connect to the remote source.

 Note

Each data source driver setup is described in its own section. The prerequisites are given as a simple guide;
you will need to consult the original driver documentation provided by the driver manufacturer for more
detailed information.

A detailed procedure is described in the SAP HANA Administration Guide.

For more information, see SAP Help Portal at http://help.sap.com/viewer/p/SAP_HANA_PLATFORM

Administration SAP HANA Administration Guide for SAP HANA Platform Data Access SAP HANA
Smart Data Access Setting Up ODBC Drivers SAP IQ ODBC Driver .

5.4.2 Install and Set Up Integration with Apache Hadoop

You use these procedures to install and set up Apache Hadoop to support the Table Content Aging report
(transaction /CAR/TABLE_AGING) delivered with SAP Customer Activity Repository.

The SAP HANA database points to your Hadoop cluster using SAP HANA smart data access (SDA), which
exposes data from Hadoop remote sources as virtual tables.

For more information, see SAP Help Portal at http://help.sap.com/viewer/p/CARAB <Version>

Application Help SAP Customer Activity Repository POS Data Transfer and Audit Implementing a POS
Transaction Data Storage Strategy Using the Table Content Aging Report .

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
66 PUBLIC Install the Software
Process Flow

To successfully install and set up integration with Apache Hadoop, you must execute the following procedures:

1. Install Apache Hadoop.

2. Do one of the following:
○ Install and set up the Apache Hive ODBC driver, or
○ Install and set up the SAP HANA Spark controller.
3. Create and partition tables in Apache Hive.
4. Create a NFS mount on SAP NetWeaver.

Install Apache Hadoop

According to the SAP HANA Administration Guide for SAP HANA Platform, SAP HANA smart data access is
supported by Hortonworks Distribution for Apache Hadoop: version 2.3 (supported on Intel-based hardware
platforms only).

For more information on integration between SAP HANA and Apache Hadoop, see SAP Help Portal at http://
help.sap.com/viewer/p/SAP_HANA_PLATFORM Administration SAP HANA Administration Guide for
SAP HANA Platform Data Access SAP HANA Smart Data Access .

For more information on installing Apache Hadoop, see http://docs.hortonworks.com All HDP 2.3
HDP 2.3.0 (GA) .

Install and Set Up Apache Hive ODBC Driver

 Note

Integration between SAP HANA and Apache Hadoop requires either an Apache Hive ODBC driver or an
SAP HANA Spark controller.

Implement this procedure only if you wish to integrate SAP HANA with Apache Hadoop via the Apache Hive
ODBC driver.

1. According to the SAP HANA Administration Guide for SAP HANA Platform, SAP HANA smart data access is
supported by Hortonworks Distribution for Apache Hadoop: version 2.3 (This includes Apache Hadoop
version 1.0.3 and Apache Hive 0.9.0; supported on Intel-based hardware platforms only).
For more information on integration between SAP HANA and Apache Hadoop, see SAP Help Portal at
http://help.sap.com/viewer/p/SAP_HANA_PLATFORM Administration SAP HANA Administration
Guide for SAP HANA Platform Data Access SAP HANA Smart Data Access .
For more information on installing the Apache Hive ODBC driver, see http://docs.hortonworks.com All
HDP 2.3 HDP 2.3.0 (GA) .
2. Set up the driver as described in the SAP HANA Administration Guide for SAP HANA Platform at http://
help.sap.com/viewer/p/SAP_HANA_PLATFORM Administration SAP HANA Administration Guide for
SAP HANA Platform Data Access SAP HANA Hadoop Integration .

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Install the Software PUBLIC 67
Install and Set Up the SAP HANA Spark Controller

 Note

Integration between SAP HANA and Apache Hadoop requires either an Apache Hive ODBC driver or an
SAP HANA Spark controller.

Implement this procedure only if you wish to integrate SAP HANA with Apache Hadoop via the SAP HANA
Spark controller.

1. Confirm the right combination of versions required between SAP HANA, Apache Spark, and the SAP HANA
Spark controller. Use the SAP HANA Spark Controller Compatibility Matrix to do this. This document is
available under https://help.sap.com/viewer/p/SAP_HANA_SPARK_CONTROLLER. Navigate to
Additional Information SAP HANA Spark Controller Compatibility Matrix .
2. Install and set up the SAP HANA Spark controller as described in SAP Note 2273047 .

For more information on installing and setting up the SAP HANA Spark controller, see SAP Help Portal at
http://help.sap.com/viewer/p/SAP_HANA_PLATFORM Administration SAP HANA Administration Guide
for SAP HANA Platform Data Access SAP HANA Hadoop Integration .

Create and Partition Tables

Create the SAP schema, tables, and table partitions as described in SAP Note 2317597 .

Create a NFS Mount on SAP NetWeaver

The TLOG data and its extensions are copied from your SAP HANA database to Hadoop using the HDFS NFS
Gateway on your Hadoop system. To enable this you must create a mount point on your SAP NetWeaver
system for the data files to be created directly in the Hadoop File System (HDFS).

 Note

The following steps are only guidelines which provide an example of how to mount Network File System
(NFS) on an SAP NetWeaver Linux-based client.

1. Make sure the NFS client is installed based on the examples provided:

Operating System Command

Red Hat, CentOS sudo yum install nfs-utils

Ubuntu sudo apt-get install nfs-common

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
68 PUBLIC Install the Software
 Operating System Command

SUSE sudo zypper install nfs-client

2. List the NFS shares exported on the server.

Example
showmount -e <host>
3. Set up a mount point for an NFS share.
Example
sudo mkdir <folder>

 Note

You must ensure that the folder paths share the same naming conventions, as follows:

Temporary data folder /tmp/tct_csv_out/temp

Data folder /tmp/tct_csv_out/data

4. Mount the cluster using NFS.

Example
sudo mount -o hard, nolock <host> <folder>

On your HDFS, the different tables are stored under a folder using the following convention:

<data directory>/<schema>/<table>/<businessdaydate=partition_value>/{files}

On the SAP NetWeaver file system, the Hadoop files are stored under a physical path and file name that is
derived from a customer-definable logical path or file name. The configuration is provided via the FILE
transaction. Inside the FILE transaction, you also need to make use of parameters PARAM_1 and PARAM_2.
PARAM_1 will be populated during runtime by the program (generated file name) and PARAM_2 will be
populated by the program during runtime <schema>/<table>/<businessdaydate=partition_value>.

Example (Data Directory)

If the Hadoop data files are stored in Unix/Linux folder ,<schema>/<table>/businessdaydate=partition_value/

{files}PARAM_1.CSV and physical directory /tmp/tct_csv_out/data/hdp/apps/hive/warehouse/
<PARAM_2><FILENAME>.

You create the following logical path in the FILE transaction as follows:

Logical path /CAR/HDFS_DATA

Name HDFS Data

Syntax group UNIX

Physical path /tmp/tct_csv_out/data/hdp/apps/hive/

warehouse/<PARAM_2><FILENAME>

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Install the Software PUBLIC 69
You create the following logical file in the FILE transaction as follows:

Logical file /CAR/HDFS_DATA

Name HDFS Data

Physical file <PARAM_1>.CSV

Data format WK1

Application area IS

Logical path /CAR/HDFS_DATA

Example (Temporary Directory)

/tmp/tct_csv_out/data/hdp/apps/hive/warehouse/On top of the Hadoop data files, you also need to provide
a temporary directory in which the program will populate script files and also temporarily store data files to be
compressed.

If the temporary files are stored in Unix/Linux folder /tmp/tct_csv_out/temp/{files}, you create the
following logical path in the FILE transaction as follows:

Logical path /CAR/HDFS_TEMP

Name HDFS Temp

Syntax group UNIX

Physical path /tmp/tct_csv_out/temp/<FILENAME>

You create the following logical file in the FILE transaction as follows:

Logical file /CAR/HDFS_TEMP

Name HDFS Temp

Physical file <PARAM_1>.SH

Data format

Application area IS

Logical path /CAR/HDFS_TEMP

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
70 PUBLIC Install the Software
5.4.3 Install and Set Up Integration with SAP HANA Dynamic
Tiering

You use these procedures to install and set up SAP HANA Dynamic Tiering to support the Table Content Aging
report (transaction /CAR/TABLE_AGING) delivered with SAP Customer Activity Repository.

SAP HANA Dynamic Tiering adds the SAP HANA dynamic tiering service to your SAP HANA system. You use
this service to create the extended store and extended tables. Extended tables behave like all other SAP HANA
tables, but their data resides in the disk-based extended store.

For more information, see SAP Help Portal at http://help.sap.com/viewer/p/CARAB <your release>
Application Help SAP Customer Activity Repository POS Data Transfer and Audit Implementing a POS
Transaction Data Storage Strategy Using the Table Content Aging Report .

Install SAP HANA Dynamic Tiering

A detailed procedure is described in the SAP HANA Dynamic Tiering: Installation and Update Guide.

For more information, see SAP Help Portal at http://help.sap.com/hana_options_dt Installation and
Upgrade .

Create Extended Storage

A detailed procedure is described in the SAP HANA Dynamic Tiering: Administration Guide.

For more information, see SAP Help Portal at http://help.sap.com/hana_options_dt Administration SAP
HANA Dynamic Tiering: Administration Guide and consult the following subsections:

● System Administration Managing Extended Storage

● System Administration Managing Tables Extended Store Tables Convert HANA Tables to Extended
Store Tables Using the SAP HANA Cockpit

5.4.4 Create the Remote Source in SAP HANA Studio

 Note

This step is not applicable if you are integrating the alternate storage feature with SAP HANA Dynamic
Tiering.

Create a remote source by selecting the appropriate adapter and configuring the connection properties and
user credentials.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Install the Software PUBLIC 71
A detailed procedure is described in the SAP HANA Administration Guide for SAP HANA Platform.

For more information, see SAP Help Portal at http://help.sap.com/viewer/p/SAP_HANA_PLATFORM

Administration SAP HANA Administration Guide for SAP HANA PLatform Data Access SAP HANA
Smart Data Access Managing Remote Sources Creating a Remote Source .

5.4.5 Create the Virtual Table

Create the following virtual tables to access the data stored in remote tables:

Virtual Table Remote Table

VT_TLOGF_NLS /POSDW/TLOGF

VT_TLOGF_X_NLS /POSDW/TLOGF_X

VT_TLOGF_EXT_NLS /POSDW/TLOGF_EXT

VT_PLOGF_NLS /POSDW/PLOGF

A detailed procedure is described in the SAP HANA Administration Guide for SAP HANA Platform.

For more information, see SAP Help Portal at http://help.sap.com/viewer/p/SAP_HANA_PLATFORM

Administration SAP HANA Administration Guide for SAP HANA Platform Data Access SAP HANA
Smart Data Access Managing Virtual Tables .

5.4.6 Activate Alternate Storage

1. In your back-end system, execute report /CAR/ACTIVATE_HTA.

2. Confirm or set the following:
○ In the ECC Mode section, choose the relevant ECC mode for your system.
○ In the External Systems section, choose Nearline Storage.
3. Press Execute.

This deploys package sap.is.retail.car.nls for ECC mode SAP ERP, or sap.is.retail.car_s4h.nls
for ECC mode S/4HANA. Each package contains views that combine TLOG data from SAP HANA with TLOG
data from the alternate storage system.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
72 PUBLIC Install the Software
6 Set Up the Applications

You have installed the back-end components and front-end components of SAP Customer Activity Repository
applications bundle. Now you must first do the setup steps under SAP Customer Activity Repository Core
(Mandatory for All Applications) . These steps are required for all the applications. Then you either continue
with the setup steps under SAP Customer Activity Repository Advanced (Optional) or do the setup steps
for your application.

For SAP Allocation Management, first consult the information in section SAP Allocation Management. Then
do the setup steps under SAP Customer Activity Repository Core (Mandatory for All Applications) .

6.1 SAP Customer Activity Repository

First do the setup steps under SAP Customer Activity Repository Core (Mandatory for All Applications) .
Then you can continue with the setup steps under SAP Customer Activity Repository Advanced
(Optional) or do the setup steps for your application.

Core (Mandatory for All Applications) [page 73]

Perform the core steps to set up SAP Customer Activity Repository as the common platform. The core
steps are mandatory for SAP Customer Activity Repository and for all the consuming applications.

Advanced (Optional) [page 105]

Perform optional steps to set up specific functionality in SAP Customer Activity Repository.

Troubleshooting [page 166]

Diagnose and resolve issues that may arise when you install, upgrade, and set up your scenario. If you
need to report a customer incident, see the information at the end of this section.

6.1.1 Core (Mandatory for All Applications)

Perform the core steps to set up SAP Customer Activity Repository as the common platform. The core steps
are mandatory for SAP Customer Activity Repository and for all the consuming applications.

 Caution

Always do the core steps first. Then you can continue with the Advanced (Optional) steps for SAP
Customer Activity Repository or with the setup steps for your application.

1. Check SAP Notes and RINs [page 75]

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 73
 There are notes that can only be implemented after you have installed the back-end product version
and the front-end product version. You must therefore do this additional check and implement the
required notes, before you do the next steps.
2. Verify Back-End Users and Roles [page 75]
Ensure that the required users on the SAP HANA database level and on the back-end application level
have the privileges, roles, and authorizations required for your scenario.
3. Set Up Authorizations for On-Shelf Availability (OSA) [page 77]
In SAP HANA studio, grant the AFL__SYS_AFL_POSDM_AREA_EXECUTE role to the SAP<SID> user in
your back-end system. This short procedure is mandatory for all the applications, because it is
required for the successful activation of the SAP HANA content later on.
4. Set Up Authorizations for Unified Demand Forecast (UDF) [page 78]
In SAP HANA studio, create three roles for UDF, grant the required privileges, and assign two roles to
the SAP<SID> user and one role to the _SYS_REPO user. This procedure is mandatory for all the
applications because the authorizations are needed for the successful activation of the SAP HANA
content later on.
5. Create/Replicate Source Master Data System Tables [page 81]
Create the tables in SAP Customer Activity Repository that are required for replicating data from your
source master data system. Then do the actual replication of the tables. You need SAP HANA studio
and the SAP Landscape Transformation Replication Server (SLT) for this procedure. For reference, you
can download a spreadsheet that lists the required tables for each source master data system (SAP
Retail, SAP S/4HANA).
6. Activate SAP HANA Content [page 85]
Activate the SAP HANA content for your scenario by running the /CAR/ACTIVATE_HTA report in the
back-end system. You can run this report as many times as required. For example, if you choose to
extend your scenario at a later point in time, you run the report again to activate the SAP HANA content
for the added options.
7. Activate SAP HANA Content for Distribution Curves [page 87]
If your scenario includes the calculation of distribution curves, do the additional steps described here
to activate the required SAP HANA content.
8. Activate SAP HANA Script Server [page 89]
Activate the script server for the SAP HANA database. This step is mandatory for all the applications.
9. Configure Demand Data Foundation [page 90]
Configure the DDF module in SAP Customer Activity Repository as required for your scenario.
10. Configure SAP Gateway [page 95]
Perform several configuration steps for SAP Gateway and the OData services. The steps to follow
depend on the SAP NetWeaver version on your front-end server.
11. Configure SAP Fiori Launchpad [page 102]
Perform the general configuration of the SAP Fiori launchpad. You must do this procedure before you
can set up SAP Fiori apps for any of the applications.
12. Calculate SAPUI5 Application Index for SAP Fiori Apps [page 103]
Configure and run the /UI5/APP_INDEX_CALCULATE (Calculation of SAPUI5 Application Index for
SAPUI5 Repositories) report in your front-end system. The report updates the SAPUI5 application
index. If the index is up-to-date, the system can find data related to SAP Fiori apps significantly faster.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
74 PUBLIC Set Up the Applications
6.1.1.1 Check SAP Notes and RINs

There are notes that can only be implemented after you have installed the back-end product version and the
front-end product version. You must therefore do this additional check and implement the required notes,
before you do the next steps.

Prerequisites

Make sure that you have the up-to-date version of each note, which you can find on the SAP Support Portal at
http://support.sap.com/notes .

The release information notes (RINs) in particular are continuously updated, as new corrections for the current
release of SAP Customer Activity Repository applications bundle become available.

Procedure

See the Implement SAP Notes for the Installation [page 26] section. Check whether there are SAP Notes that
can only be implementedafter the installation. Make sure to implement all the required notes.
a. Always see the table for SAP Customer Activity Repository. Notes listed there are often common
corrections, applicable to all consuming applications.
b. Then see the table for your application.
c. For the latest back-end corrections, see the back-end RIN.
d. For the latest front-end corrections, see the front-end RIN.

Task overview: Core (Mandatory for All Applications) [page 73]

Next: Verify Back-End Users and Roles [page 75]

6.1.1.2 Verify Back-End Users and Roles

Ensure that the required users on the SAP HANA database level and on the back-end application level have
the privileges, roles, and authorizations required for your scenario.

Prerequisites

● You are aware that the names of the front-end application users must be the same as those in the SAP
HANA database and the back-end application.
● You have read and performed the steps in section Verify SAP HANA User and Privileges [page 39].

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 75
Procedure

Ensure that your back-end application user has the following roles/authorizations.

User Role / Authorization

<Your User Name>* ● SAP_ISR_DDF_MASTER

● SAP_ISR_AP_MASTER
● /RAP/BW_AP_WORKBOOKS
● /RAP/BW_MPR_WORKBOOKS
● In transaction RS2HANA_VIEW, set SAP HANA User Mapping to C (DBMS
user, else SAP HANA user with same name as BW user).
● In transaction RS2HANA_CHECK, verify that authorizations for generating
SAP HANA views out of local BI Content objects are set up. Correct any re­
sulting issues.
For more information, see http://help.sap.com/viewer/p/SAP_NETWEA­

VER_750 (or choose a higher version). Navigate to Application Help

SAP NetWeaver Library: Function-Oriented View SAP Business Warehouse

Using the SAP HANA Database Data Modeling When Using a SAP HANA

Mixed Modeling (SAP BW and SAP HANA) Generating SAP HANA Views

from the BW System Authorizations for Generating SAP HANA Views .

● If you need detailed information about PAK execution, the user profile must
have the following parameters maintained. Be aware that as a result of the
additional logging, these settings might slow down the performance.
In transaction SU3, select the Parameters tab. Enter the parameter and the
desired value as shown below and choose Save.

Parameter Value

RSPLS_HDB_PE_TRACE Y

More Information

For information on setting up front-end application users, see the following:

● For SAP Assortment Planning: Assign Roles, Catalogs, and Groups in SAP Fiori Launchpad [page 256]
● For SAP Allocation Management: Assign Roles, Catalogs, and Groups in SAP Fiori Launchpad [page 273]

Parent topic: Core (Mandatory for All Applications) [page 73]

Previous task: Check SAP Notes and RINs [page 75]

Next: Set Up Authorizations for On-Shelf Availability (OSA) [page 77]

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
76 PUBLIC Set Up the Applications
6.1.1.3 Set Up Authorizations for On-Shelf Availability
(OSA)

In SAP HANA studio, grant the AFL__SYS_AFL_POSDM_AREA_EXECUTE role to the SAP<SID> user in your
back-end system. This short procedure is mandatory for all the applications, because it is required for the
successful activation of the SAP HANA content later on.

Context

The AFL__SYS_AFL_POSDM_AREA_EXECUTE role enables the SAP<SID> user to call the OSA application
function library (part of the SAP RTL AFL FOR SAP HANA component) in the SAP HANA database.

Prerequisites

● You have installed the SAP RTL AFL FOR SAP HANA component as described in Download and Install the
Application Function Library (SAP RTL AFL FOR SAP HANA) [page 51].
● You have an SAP<SID> user and an SAP<SID> physical schema in your SAP HANA database. The names
must be identical. If you need more information on database users and schema mapping, see Verify Back-
End Users and Roles [page 75] and Verify Correct Schema Mapping [page 43].
● You know what the name of the SAP<SID> user is in your system landscape. For information on how to find
this name, see Verify Correct Schema Mapping [page 43].
● You have database administrator rights so that you can grant roles to users.

Procedure

 Tip

● If you encounter issues related to authorization or authentication, see the Security-Related Issues
section of the SAP HANA Troubleshooting and Performance Analysis Guide, which you can find under
https://help.sap.com/viewer/p/SAP_HANA_PLATFORM <Version> Administration .
● We have provided an example SQL statement below that you can adapt as needed for your system
landscape.

1. In SAP HANA studio, access your back-end system and open the SAP HANA Administration Console.
2. Choose Security Users .
3. Select your SAP<SID> user and open the user details (or double-click the user).
4. On the Granted Roles tab, choose the plus icon and select AFL__SYS_AFL_POSDM_AREA_EXECUTE as the
role name.
SQL example: grant AFL__SYS_AFL_POSDM_AREA_EXECUTE to SAP<SID>;

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 77
5. Save your changes by choosing the Deploy (F8) icon at the top right.

Result

You have successfully set up the authorizations for OSA.

Parent topic: Core (Mandatory for All Applications) [page 73]

Previous: Verify Back-End Users and Roles [page 75]

Next: Set Up Authorizations for Unified Demand Forecast (UDF) [page 78]

6.1.1.4 Set Up Authorizations for Unified Demand Forecast

(UDF)

In SAP HANA studio, create three roles for UDF, grant the required privileges, and assign two roles to the
SAP<SID> user and one role to the _SYS_REPO user. This procedure is mandatory for all the applications
because the authorizations are needed for the successful activation of the SAP HANA content later on.

Context

The three roles for UDF have the following purpose:

Role Purpose

UDF_EXECUTE Required to execute UDF. Enables the SAP<SID> user to call the UDF applica­
tion function library (AFL) in the SAP HANA database.

UDF_DEPLOY Required to activate the SAP HANA content for UDF. Enables the SAP<SID>
user to deploy the SAP HANA content for UDF.

UDF_DEPLOY_SYS_REPO Required to activate the SAP HANA content. Defines additional privileges for
the _SYS_REPO standard user.

Prerequisites

● You have installed the SAP RTL AFL FOR SAP HANA component as described in Download and Install the
Application Function Library (SAP RTL AFL FOR SAP HANA) [page 51]. This component contains the
application function library for UDF.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
78 PUBLIC Set Up the Applications
 ● You have mapped authoring schemas to physical schemas as described in Verify Back-End Users and
Roles [page 75].
● You know what the name of the SAP<SID> schema/user is in your system landscape. For information on
how to find this name, see Verify Correct Schema Mapping [page 43].
● You have database administrator rights so that you can create roles, grant privileges, and assign roles to
users.

Procedure

 Tip

● If you encounter issues related to authorization or authentication, see the Security-Related Issues
section of the SAP HANA Troubleshooting and Performance Analysis Guide. You can find this guide at
https://help.sap.com/viewer/p/SAP_HANA_PLATFORM, select your version at the top right, and see
under Administration.
● We have also provided example SQL statements below that you can adapt as needed for your system
landscape.

1. In SAP HANA studio, log on to your back-end system and open the SAP HANA Administration Console.
2. Navigate to Security Roles and select New Role from the context menu.
3. In the Role Name field, specify UDF_EXECUTE.
SQL example: create role UDF_EXECUTE;
4. Make the following settings for this role:
○ On the Granted Roles tab: Choose the plus icon and select the
AFL__SYS_AFL_UDFCORE_AREA_EXECUTE role from the list.
SQL example: grant AFL__SYS_AFL_UDFCORE_AREA_EXECUTE to UDF_EXECUTE;
○ On the Object Privileges tab: Add the following catalog objects and grant them the following privileges:
○ Catalog object (schema name) SAP<SID>: privileges SELECT, INSERT, UPDATE, DELETE
SQL example: grant SELECT, INSERT, UPDATE, DELETE on schema SAP<SID> to
UDF_EXECUTE;
○ Catalog object (schema name) _SYS_BIC: privileges SELECT, EXECUTE
SQL example: grant SELECT, EXECUTE on schema _SYS_BIC to UDF_EXECUTE;
○ On the Analytic Privileges tab: Add the _SYS_BI_CP_ALL privilege.
SQL example: call
GRANT_ACTIVATED_ANALYTICAL_PRIVILEGE('_SYS_BI_CP_ALL','UDF_EXECUTE');
5. Save your changes by choosing the Deploy (F8) icon at the top right.
6. Navigate to Security Users .
7. Select the SAP<SID> user from the list and open the details screen (or double-click the user).
8. On the Granted Roles tab, add the UDF_EXECUTE role.
SQL example: grant UDF_EXECUTE to SAP<SID>
9. Save your changes by choosing the Deploy (F8) icon at the top right.

 Note

You have created the first role with the required privileges and granted the role to the SAP<SID> user.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 79
10. Now create the second role. Navigate again to Security Roles and select New Role from the context
menu.
11. In the Role Name field, specify UDF_DEPLOY.
SQL example: create role UDF_DEPLOY;
12. Make the following settings for this role:
○ On the Granted Roles tab: Choose the plus icon and select the CONTENT_ADMIN role from the list.
SQL example: grant CONTENT_ADMIN to UDF_DEPLOY;
○ On the System Privileges tab: Add the CATALOG READ privilege.
SQL example: grant CATALOG READ to UDF DEPLOY;
13. Save your changes by choosing the Deploy (F8) icon at the top right.
14. Navigate again to Security Users .
15. Select the SAP<SID> user from the list and open the details screen (or double-click the user).
16. On the Granted Roles tab, add the UDF_DEPLOY role.
SQL example: grant UDF_DEPLOY to SAP<SID>;
17. Save your changes by choosing the Deploy (F8) icon at the top right.

 Note

You have created the second role and granted the role to the SAP<SID> user.

18. Now create the third role. Navigate again to Security Roles and select New Role from the context
menu.
19. In the Role Name field, specify UDF_DEPLOY_SYS_REPO.
SQL example: create role UDF_DEPLOY_SYS_REPO;
20.On the Object Privileges tab, make these settings:
Add catalog object (schema name) SAP<SID> and grant the privileges SELECT, INSERT, UPDATE, and
DELETE.
SQL example: grant SELECT, INSERT, UPDATE, DELETE on schema SAP<SID> to
UDF_DEPLOY_SYS_REPO;
21. Save your changes by choosing the Deploy (F8) icon at the top right.
22. Navigate again to Security Users .
23. Select the _SYS_REPO user from the list and open the details screen (or double-click the user).
24. On the Granted Roles tab, add the UDF_DEPLOY_SYS_REPO role.
SQL example: grant UDF_DEPLOY_SYS_REPO to _SYS_REPO;
25. Save your changes by choosing the Deploy (F8) icon at the top right.

 Note

You have created the third role with the required privileges and granted the role to the _SYS_REPO user.

Result

You have successfully set up the authorizations for UDF.

Parent topic: Core (Mandatory for All Applications) [page 73]

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
80 PUBLIC Set Up the Applications
Previous: Set Up Authorizations for On-Shelf Availability (OSA) [page 77]

Next task: Create/Replicate Source Master Data System Tables [page 81]

6.1.1.5 Create/Replicate Source Master Data System

Tables

Create the tables in SAP Customer Activity Repository that are required for replicating data from your source
master data system. Then do the actual replication of the tables. You need SAP HANA studio and the SAP
Landscape Transformation Replication Server (SLT) for this procedure. For reference, you can download a
spreadsheet that lists the required tables for each source master data system (SAP Retail, SAP S/4HANA).

Prerequisites

● You have completed the previous procedures in this guide.

● You have installed the SAP Landscape Transformation Replication Server. For the minimum version
required, installation and implementation information, see the Common Prerequisites in section Install the
Prerequisites [page 17].

 Note

If your source master data system is SAP S/4HANA 1909, be aware that as of that release, the SAP LT
Replication Server is no longer available as a standalone component. Instead, SAP S/4HANA 1909
includes an embedded SAP LT Replication Server by default.

To be able to replicate the data from an SAP S/4HANA 1909 system, you first need to prepare the
replication. This preparation has the added advantage that it gives you the option to still use a
standalone SAP LT Replication Server. Follow the steps in SAP S/4HANA 1909 Only - Prepare Data
Replication with SAP Landscape Transformation Replication Server [page 84]. Then return to this
procedure here.

Context

SAP Customer Activity Repository applications bundle can use data originating from a single or multiple source
master data systems.

The list of tables to create and replicate depends on your leading source master data system:

● SAP Retail: for installations based on the SAP_ECC schema

● SAP S/4HANA Retail: for installations based on the SAP_S4H schema

In this procedure, you first create and then replicate the required tables.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 81
  Note

It is possible to combine the steps create and replicate.

Procedure

1. Download the spreadsheet with the SLT tables for your version of SAP Customer Activity Repository
applications bundle:
a. Navigate to SAP Help Portal at https://help.sap.com/viewer/p/CARAB and select your version at the
top.
b. Download the archive SLT Tables for SAP Customer Activity Repository applications bundle 4.0 (all
versions) from under Installation and Upgrade.
c. Extract the spreadsheet and see the tables listed for your source master data system.

2.  Caution

You must always create and replicate all the tables listed for your source master data system in the
spreadsheet. This is necessary not only for the data replication itself but also for the successful
activation of the SAP HANA content later on.

 Note

To be able to activate the SAP HANA content for SAP Allocation Management, you must replicate
both the SAP Retail tables and the SAP Fashion Management tables. The replication of the SAP Fashion
Management tables is mandatory, even if you do not use SAP Fashion Management.

Create all the tables listed for your source master data system.
a. Configure access from the SAP Landscape Transformation Replication Server to the source SAP Retail
or SAP S/4HANA Retail system (RFC connection) and from the SAP Landscape Transformation
Replication Server to the target SAP HANA database of your SAP Customer Activity Repository back-
end system.

For more information, see section Technical Prerequisites and Authorization Aspects and section
Accessing the Configuration and Monitoring Dashboard under https://help.sap.com/viewer/p/
SAP_LANDSCAPE_TRANSFORMATION_REPLICATION_SERVER <Version> Operations
Application Operations Guide (Replicating Data to SAP HANA) .
b. Ensure that your SAP Customer Activity Repository back-end system is connected to SAP HANA
studio.

If necessary, set the connection as follows:

1. Log on to SAP HANA studio.

2. Right-click in the Navigator pane and select Add System.
3. In the Specify System dialog, enter the Host Name, Instance Number, and Description.
4. In the Connection Properties dialog, enter your system User Name and Password.
5. Save your changes.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
82 PUBLIC Set Up the Applications
 c. Ensure that the database schemas are created on the SAP HANA database of your back-end system.
These are the schemas on your SAP HANA database to which the SAP Retail and/or SAP S/4HANA
data will be replicated.

 Note

For more information, see the Create a Schema section of the SAP HANA Developer Guide.

d. Create all the tables for your source master data system.
1. Log on to the SAP Landscape Transformation Replication Server.
2. Execute transaction LTRC (SAP LT Replication Server Cockpit)).
3. Define and select your replication configuration.
See https://help.sap.com/viewer/p/
SAP_LANDSCAPE_TRANSFORMATION_REPLICATION_SERVER <Version> Operations
Application Operations Guide (Replicating Data to SAP HANA) and search for Creating a
Configuration.
4. Choose Execute (F8) . A screen opens that shows the details of this replication configuration.
5. Select the table overview tab. On top, the data provisioning function will get visible.
6. Execute the table overview function. On the subsequent pop-up, select the function for table
creation.
7. Choose the multiple selection push-button next to the table name field.
8. In the next screen, you can either enter table names manually or upload a text file with the table
names (recommended):
Create this text file from the spreadsheet that you downloaded before. Make sure that the text file
contains only the table names and no other data. Then upload the text file.
9. Choose Copy (F8) to return to the previous screen.
10. Choose Execute (F8) to trigger the creation of the tables.

You have successfully created the tables in your SAP Customer Activity Repository back-end system.
3. Replicate all the tables listed for your source master data system.

 Note

If your SAP Retail or SAP S/4HANA Retail system and your back-end SAP Customer Activity
Repository system are co-deployed on the same SAP HANA database, you do not need to replicate the
tables.

a. Save a CSV file of the required tables. You will later load the tables from this file.
b. In SAP HANA studio, choose Window Perspective Open Perspective and open the SAP HANA
Modeler perspective.
c. In the Quick View panel, choose Data Provisioning to open the Data Provisioning Editor for your system.

If the Quick View panel is not displayed, choose Help Quick View .
d. In the Data Provisioning Editor, make any necessary adjustments: remove or add tables, select the
appropriate source system, and select the target schema for replication.
e. Choose Replicate to open the Replicate Request screen.
f. Choose Load from file, browse to the location where you saved the CSV file and select it.
g. The tables in the file are added to the Selected column on the right-hand side. Choose Finish.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 83
 In the Data Provisioning Editor, you can monitor the action status of the tables using Data Load
Management.

You have successfully replicated the tables from your source master data system into your SAP Customer
Activity Repository back-end system. Continue with the next section.

Task overview: Core (Mandatory for All Applications) [page 73]

Previous: Set Up Authorizations for Unified Demand Forecast (UDF) [page 78]

Next task: Activate SAP HANA Content [page 85]

6.1.1.5.1 SAP S/4HANA 1909 Only - Prepare Data

Replication with SAP Landscape Transformation
Replication Server

Only perform this procedure if your source master data system is SAP S/4HANA 1909. If so, you must do the
steps described here before doing the actual replication.

Context

If your source master data system is SAP S/4HANA 1909, be aware that the SAP LT Replication Server is no
longer available as a standalone component. Instead, SAP S/4HANA 1909 includes an embedded SAP LT
Replication Server by default.

To be able to replicate data from SAP S/4HANA 1909 into SAP Customer Activity Repository, you first need to
prepare the replication as described below.

This preparation has the added advantage that it gives you the option to still use a standalone SAP LT
Replication Server.

Procedure

Prepare data replication from SAP S/4HANA 1909 to SAP Customer Activity Repository, using an embedded or
a standalone SAP LT Transformation Server:

1. Pause your current SLT replication routine with the SAP LT Replication Server.
2. Upgrade your source master data system to SAP S/4HANA 1909 as described in the corresponding
product documentation. For more information, see SAP Help Portal for SAP S/4HANA 1909.
3. Implement SAP Note 2857334 (Unsupported data type DECFLOAT34 / D34N when replicating from a
S/4 HANA OP1909 system) in your SAP S/4HANA 1909 system.
4. Adjust your SLT configuration as described in the note.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
84 PUBLIC Set Up the Applications
 5. Now you can resume the data replication. Return to section Create/Replicate Source Master Data System
Tables [page 81] and follow the instructions.

6.1.1.6 Activate SAP HANA Content

Activate the SAP HANA content for your scenario by running the /CAR/ACTIVATE_HTA report in the back-end
system. You can run this report as many times as required. For example, if you choose to extend your scenario
at a later point in time, you run the report again to activate the SAP HANA content for the added options.

Prerequisites

You have successfully completed all the previous procedures in this guide.

Context

The /CAR/ACTIVATE_HTA report activates the SAP HANA Transport for ABAP (HTA) objects for your scenario.

 Tip

If you encounter issues during the activation, see the Troubleshooting [page 166] section for possible
solutions.

Procedure

1. Start transaction SE38.

2. Enter /CAR/ACTIVATE_HTA as the program (report) and choose Execute ( F8 ).
3. On the Activate SAP HANA Content for SAP CARAB screen, select all the options for which you wish to
activate the SAP HANA content. Use the following table for reference:

 Note

If the SAP HANA content is already active for an option, you can see this directly on the screen.

You want to activate the SAP HANA

content for... Select at least these options...

SAP Allocation Management Follow the instructions in Activate SAP Allocation Management SAP HANA
Content [page 263].

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 85
 You want to activate the SAP HANA
content for... Select at least these options...

Distribution Curves (without SAP Follow the instructions in Activate SAP HANA Content for Distribution
Allocation Management) Curves [page 87].

SAP Assortment Planning ○ ECC Mode: Select your source master data system. If you use Fashion
Management, select it.
○ Business Scenarios Activation: Select Assortment Planning.

Unified Demand Forecast (UDF) and de­ No action required.

mand planning SAP Fiori apps (Analyze
The SAP HANA content was activated automatically during the installation
Forecast, Adjust Forecast, Manage De­
of the back-end product version.
mand Influencing Factors)

On-Shelf Availability ○ ECC Mode: Select your source master data system.
○ Business Scenarios Activation: Select On-Shelf Availability and
Customer Activity Repository.

Omnichannel Article Availability and ○ ECC Mode: Select your source master data system.

Sourcing (OAA) ○ Business Scenarios Activation: Select Omnichannel Article Availability.

SAP Merchandise Planning Follow the instructions in Activate SAP HANA Content for SAP Merchan­
dise Planning [page 189].

SAP Promotion Management No action required.

4. Check your selections:

a. Select Perform Prerequisite Check and choose Execute ( F8 ).
b. Read the system log and first resolve any issues found during the check. See the Troubleshooting
[page 166] section for possible solutions.
5. Activate the SAP HANA content for real:
a. Deselect Perform Prerequisite Check.
b. Choose Execute ( F8 ) again.
6. Verify that the activation was successful. There are three ways how you can do this:
a. Simply rerun the report. You can see all the options that are now active.
b. Or: Execute transaction SCTS_HTA. Specify a SAP HANA content package (for example,
sap.is.retail), select Include subpackages, and choose Execute ( F8 ). You can see all the packages
and objects including their status.
c. Or: Navigate to the same package in SAP HANA studio or SAP Web IDE and check whether all its views
are active.

Results

You have successfully activated the SAP HANA content for your scenario. Continue with the next section.

Task overview: Core (Mandatory for All Applications) [page 73]

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
86 PUBLIC Set Up the Applications
Previous task: Create/Replicate Source Master Data System Tables [page 81]

Next: Activate SAP HANA Content for Distribution Curves [page 87]

6.1.1.7 Activate SAP HANA Content for Distribution Curves

If your scenario includes the calculation of distribution curves, do the additional steps described here to
activate the required SAP HANA content.

Run the Report for Creating the Dummy Schema and Dummy Tables

The report checks for a missing physical schema and creates this physical schema and the corresponding
dummy tables in the schema if necessary. The successful completion of this step is a prerequisite for activating
the SAP HANA content for distribution curves.

Prerequisites
● To be able to run the report, you need an SAP HANA database user in the ABAP back-end system with the
authorization to create the dummy schema. See section Verify SAP HANA Users and Privileges [page 39]
and search for create.
● Ensure that you have implemented SAP Note 2850296 (Support for S/4H 1909 source system in
report /DMF/CREATE_SLT_TABLES).

Procedure
1. In your ABAP back-end system, start transaction SE38. Enter /DMF/CREATE_SLT_TABLES (Create SLT
Tables) as the program and choose Execute.
2. Select your source master data system. For S/4HANA, select also the version.
3. Enter the name of the physical source and the name of the dummy schema. For the Physical Source
Schema, enter the physical schema name into which your SLT tables should be replicated. For the Physical
Dummy Schema, enter the name for the schema to be created. If the physical source schema already
exists in the SAP HANA database, then only the dummy tables in this schema are created when you
execute the report.
4. Select the simulation mode for a test run. After the simulation run, check for errors in the application log.

Maintain Schema Mapping

Check the names you use for your physical schema. If you are using the default names below, no further action
is required:

● SAP_S4H, for your SAP S/4HANA schema

● SAP_ECC, for your SAP Retail (ECC or FMS) schema

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 87
If you have chosen names for your physical schema that are different from the names above, you must do the
following:

1. Maintain a schema mapping in your SAP HANA database where your customer-specific names are used as
authoring schemas for the physical schema. For instructions, see Verify Correct Schema Mapping [page
43].

Set PREWORK_DONE Indicator for DDF Packages

A precondition for activating SAP HANA Transport for ABAP (HTA) objects is that the PREWORK_DONE indicator
is set for all packages with activation mode P – prework needed.

 Note

You can check this setting in table CTS_HOT_PACKAGE in field HOT_ACTIVATION_MODE.

You must set this indicator for all Demand Data Foundation (DDF) packages that are relevant for calculating
distribution curves:

● sap.is.ddf.ecc
● sap.is.ddf.fms
● sap.is.ddf.fms_s4h
● sap.is.ddf.cross.ecc
● sap.is.ddf.cross.fms
● sap.is.ddf.cross.fms_s4h
● sap.is.ddf.cross

Follow these steps:

1. Call transaction SE16 (Data Browser) and display the contents of table CTS_HOT_PREWORK (HANA
Transport for ABAP: Prework for SAP HANA Deployment).
2. Enter the ABAP_HANA_PACKAGE_ID for all DDF packages listed above.
You can obtain the ABAP_HANA_PACKAGE_ID for the HANA_PACKAGE_ID from table CTS_HOT_PACKAGE.
3. Check if the indicator PREWORK_DONE is set to X for all the DDF packages listed above. If not, set the
indicator to X.

Check and Activate DDF SAP HANA Content

Based on your scenario, there can be inactive packages in DDF, even though you have already activated the
content via the report /CAR/ACTIVATE_HTA (Activate SAP HANA Content for SAP CARAB), as described in
section Activate SAP HANA Content [page 85].

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
88 PUBLIC Set Up the Applications
Make sure that all the DDF packages are activated:

1. Call transaction SCTS_HTA_DEPLOY (SAP HANA Transport for ABAP - Deployment) to check and, if
necessary, deploy each of the following packages:

 Caution

Do this in exactly the same order in which the packages are listed here.

Do not select the Include subpackages option.

○ sap.is.ddf.ecc
○ sap.is.ddf.fms
○ sap.is.ddf.fms_s4h
○ sap.is.ddf.cross.ecc
○ sap.is.ddf.cross.fms
○ sap.is.ddf.cross.fms_s4h
○ sap.is.ddf.cross

 Note

The package names are case-sensitive.

Parent topic: Core (Mandatory for All Applications) [page 73]

Previous task: Activate SAP HANA Content [page 85]

Next task: Activate SAP HANA Script Server [page 89]

6.1.1.8 Activate SAP HANA Script Server

Activate the script server for the SAP HANA database. This step is mandatory for all the applications.

Context

The script server is an auxiliary SAP HANA server that is required to execute application function libraries
(AFLs). For example, this applies to the SAP HANA AFL component (which includes the SAP HANA Predictive
Analysis Library (PAL) and other libraries) and to the SAP RTL AFL FOR SAP HANA component (which
includes the libraries for Unified Demand Forecast and On-Shelf Availability).

 Note

The operating system process is hdbscriptserver.

The service name is scriptserver.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 89
 The operating system process can be started while the SAP HANA database is already running.

Procedure

1. In SAP HANA studio, verify if the script server is active.

2. If the script server is not active, restart it manually as described in SAP Note 1650957 SAP HANA
Database: Starting the Script Server.

Task overview: Core (Mandatory for All Applications) [page 73]

Previous: Activate SAP HANA Content for Distribution Curves [page 87]

Next: Configure Demand Data Foundation [page 90]

6.1.1.9 Configure Demand Data Foundation

Configure the DDF module in SAP Customer Activity Repository as required for your scenario.

Required Configuration

The configuration of DDF is mandatory for the following scenarios:

● You want to model and forecast demand using the UDF module in SAP Customer Activity Repository.
● You want to use the Omnichannel Promotion Pricing (OPP) module in SAP Customer Activity Repository.
● You want to use SAP Allocation Management.
● You want to use SAP Assortment Planning.
● You want to use SAP Merchandise Planning.
● You want to use SAP Promotion Management.

 Note

The configuration of DDF is optional for the following SAP Customer Activity Repository scenarios:

● POS Data Transfer and Audit

● Multichannel Transaction Data Management
● Inventory Visibility
● On-Shelf Availability

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
90 PUBLIC Set Up the Applications
For additional configurations and integration information, see the following documentation on SAP Help Portal
at http://help.sap.com/viewer/p/CARAB <Version> :

● Application Help SAP Customer Activity Repository Demand Data Foundation Integration
Information Master Data Replication from SAP ERP to Demand Data Foundation
● Administration SAP Customer Activity Repository Administration Guide : sections Configure Demand
Data Foundation (DDF), Configure Data Replication from SAP ERP to DDF

 Note

If you encounter issues during the configuration, see the Troubleshooting [page 166] section for possible
solutions.

Overview of DDF Configuration Tasks

1. Perform General Demand Data Foundation Configuration [page 92]

Perform various configuration steps in Customizing for DDF. DDF must be fully configured and
operational for all the scenarios for which it is mandatory.
2. Configure Automatic Flattening of Hierarchies [page 92]
Configure the system so it automatically creates and updates flat structures for the product and
location hierarchies in DDF. The flat structures are required so that the consuming applications can
correctly recognize the hierarchies.
3. Import SAP NetWeaver Portal Roles for DDF [page 93]
Set up user authorizations for DDF using the PFCG roles from the SAP NetWeaver Business Client
(NWBC) and from the SAP NetWeaver Portal (optional). Both sets of roles operate in the same manner.
4. Check Performance-Related Configuration Options (Optional) [page 94]
Use additional configuration options for Demand Data Foundation (DDF) to optimize performance for
different use cases.

Parent topic: Core (Mandatory for All Applications) [page 73]

Previous task: Activate SAP HANA Script Server [page 89]

Next: Configure SAP Gateway [page 95]

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 91
6.1.1.9.1 Perform General Demand Data Foundation
Configuration

Perform various configuration steps in Customizing for DDF. DDF must be fully configured and operational for
all the scenarios for which it is mandatory.

Procedure

1. Perform all of the Customizing activities that are required for DDF.
For more information, see the Configure Demand Data Foundation (DDF) section of the SAP Customer
Activity Repository Administration Guide.

Parent topic: Configure Demand Data Foundation [page 90]

Next task: Configure Automatic Flattening of Hierarchies [page 92]

6.1.1.9.2 Configure Automatic Flattening of Hierarchies

Configure the system so it automatically creates and updates flat structures for the product and location
hierarchies in DDF. The flat structures are required so that the consuming applications can correctly recognize
the hierarchies.

Context

Flat structures describe the parent-child relationships of hierarchies in a flattened format. A hierarchy can be
vertically or horizontally flattened. Each row of the resulting flat structure contains one parent-child
relationship.

When you create (or update) a product hierarchy, product group, location hierarchy, or location group in
Demand Data Foundation (DDF), the system should create (or update) the corresponding flat structure.
Without this, you get hierarchy errors in the consuming applications.

To configure the automatic flattening of hierarchies, follow these steps:

Procedure

1. Carefully read SAP Note 1425876 and follow the instructions.

2. Execute transaction SWETYPV and ensure that you have activated all required event type linkages and have
enabled the specified event queues. In particular, check that the Linkage Activated and Enable Event Queue

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
92 PUBLIC Set Up the Applications
 options are for each of the following events: LOCATION_CREATED, LOCATION_UPDATED,
CREATE_LOC_HIER, CREATE_PROD_HIER. If you need to change a setting, you can do so in the Details
screen of each event.

For more information about event handling, see SAP Note 1098805 , in particular sections Events and
Transactions for troubleshooting.

Results

You have set up the automatic flattening of the hierarchies. When you now create (or update) a hierarchy, the
system will automatically run the /DMF/TREE_FLATTENER_PROD_INS report (for product hierarchies) or
the /DMF/TREE_FLATTENER_LOC_INS report (for location hierarchies) and create (or update) the
corresponding flat structure.

Task overview: Configure Demand Data Foundation [page 90]

Previous: Perform General Demand Data Foundation Configuration [page 92]

Next: Import SAP NetWeaver Portal Roles for DDF [page 93]

6.1.1.9.3 Import SAP NetWeaver Portal Roles for DDF

Set up user authorizations for DDF using the PFCG roles from the SAP NetWeaver Business Client (NWBC) and
from the SAP NetWeaver Portal (optional). Both sets of roles operate in the same manner.

Use

The roles have been designed for use in SAP NetWeaver Business Client. To use the functions of these roles in
SAP NetWeaver Portal, you must upload the roles from the SAP back-end system to the portal. The uploaded
objects are converted into portal objects.

Procedure

1. Use the Role Upload tool to generate the SAP NetWeaver Portal roles automatically. For information about
this tool, see SAP Note 1685257 .
You can also enhance the SAP NetWeaver Portal roles; for example, you can create your own iViews.
You can upload the following roles for DDF:
○ SAP_ISR_DDF_MASTER
○ SAP_ISR_DDF_READONLY_MASTER

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 93
For descriptions of these roles and information about maintaining roles in SAP Customer Activity Repository,
see section Authorizations in the SAP Customer Activity Repository Administration Guide.

Parent topic: Configure Demand Data Foundation [page 90]

Previous task: Configure Automatic Flattening of Hierarchies [page 92]

Next: Check Performance-Related Configuration Options (Optional) [page 94]

6.1.1.9.4 Check Performance-Related Configuration

Options (Optional)

Use additional configuration options for Demand Data Foundation (DDF) to optimize performance for different
use cases.

Procedure

See the following options and implement those that are relevant for you:

Use Case Configuration Option

You have a great number of products and locations, so that Consider table partitioning.
the resulting tables are very large.
For information, see the Partition Tables for UDF and DDF
section of the SAP Customer Activity Repository Administra­
tion Guide.

You want to optimize workload distribution. Consider setting up load balancing.

For information, see https://help.sap.com/viewer/p/CARAB

<Version> Application Help SAP Customer Activity

Repository Demand Data Foundation General Services

Configure Load Balancing .

You are using DDF together with UDF to model and forecast Optimize performance for modeling and forecasting proc­
consumer demand. esses.

For information, see the Optimize UDF PerformanceOptimize

UDF Performance section of the SAP Customer Activity
Repository Administration Guide.

Parent topic: Configure Demand Data Foundation [page 90]

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
94 PUBLIC Set Up the Applications
Previous: Import SAP NetWeaver Portal Roles for DDF [page 93]

6.1.1.10 Configure SAP Gateway

Perform several configuration steps for SAP Gateway and the OData services. The steps to follow depend on
the SAP NetWeaver version on your front-end server.

Perform General SAP Gateway Configuration [page 95]

Make several general configuration settings (for example, set profile parameters, activate ICF services,
or make language settings). The settings may vary depending on the SAP NetWeaver version installed
on your front-end server, or on other specifics related to your system landscape.

Connect SAP Gateway to Your Back-End System [page 96]

Set up the connection between SAP Gateway on your front-end server and your back-end system. In
other words, set up the OData Channel (ODC).

Activate SAP Gateway [page 97]

Before you can use SAP Gateway, you must activate it globally on your front-end server.

Activate OData Services [page 97]

First activate all the common OData services for SAP Fiori (mandatory). Then select the OData
services for the application and SAP Fiori apps that you wish to use and activate these services as well.

Parent topic: Core (Mandatory for All Applications) [page 73]

Previous: Configure Demand Data Foundation [page 90]

Next: Configure SAP Fiori Launchpad [page 102]

6.1.1.10.1 Perform General SAP Gateway Configuration

Make several general configuration settings (for example, set profile parameters, activate ICF services, or make
language settings). The settings may vary depending on the SAP NetWeaver version installed on your front-end
server, or on other specifics related to your system landscape.

Use

The steps are not specific to this guide and are described in the product documentation of your SAP
NetWeaver version.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 95
Procedure

1. Determine the SAP NetWeaver version on your front-end server.

2. Consult the product documentation for your SAP NetWeaver version to determine what settings to make.
For SAP Gateway for SAP NetWeaver 7.52, see https://help.sap.com/viewer/p/
SAP_NETWEAVER_AS_ABAP_752 and choose <Version> Application Help SAP Gateway Foundation
(SAP_GWFND) SAP Gateway Foundation Configuration Guide General Configuration Settings .
3. Perform the general SAP Gateway configuration specific to your SAP NetWeaver version.

 Note

If you encounter issues, see SAP Note 1797736 (SAP Gateway Troubleshooting Guide) for possible
solutions.

6.1.1.10.2 Connect SAP Gateway to Your Back-End System

Set up the connection between SAP Gateway on your front-end server and your back-end system. In other
words, set up the OData Channel (ODC).

Use

The steps are not specific to this guide and are described in the product documentation for your SAP
NetWeaver version.

Procedure

1. Determine the SAP NetWeaver version on your front-end server.

2. Set up the OData Channel as described in the product documentation for your SAP NetWeaver version.
For SAP Gateway for SAP NetWeaver 7.52, see https://help.sap.com/viewer/p/
SAP_NETWEAVER_AS_ABAP_752 <Version> Application Help SAP Gateway Foundation
(SAP_GWFND) SAP Gateway Foundation Configuration Guide SAP Gateway Configuration User,
Developer, and Administrator Roles and Connection Settings for the SAP Gateway Hub System.
3. Set up the required roles on the front-end server and assign your user to these roles.
4. Specify the connection settings on the SAP Gateway hub system. They include:
○ Connection from SAP Gateway to consumer systems
These settings allow you to connect the SAP Gateway host to the consumer systems (clients from
which you access the SAP Fiori apps).
○ Connection from SAP Gateway to SAP back-end system

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
96 PUBLIC Set Up the Applications
 These settings allow you to connect SAP Gateway to your back-end system. They include the following
steps:
○ Creating a type 3 connection from the SAP Gateway host to your back-end system
○ Defining a trust relationship between your back-end system and the SAP Gateway host
○ Configuring your back-end system to accept SAP assertion tickets from the SAP Gateway host
○ Configuring your SAP Gateway host to accept SAP assertion tickets from your back-end system
○ Configuring the necessary system aliases

6.1.1.10.3 Activate SAP Gateway

Before you can use SAP Gateway, you must activate it globally on your front-end server.

Use

The steps are not specific to this guide and are described in the product documentation for your SAP
NetWeaver version.

Procedure

1. Determine the SAP NetWeaver version on your front-end server.

2. Carry out the instructions specific to your SAP NetWeaver version:
For SAP Gateway for SAP NetWeaver 7.52, see https://help.sap.com/viewer/p/
SAP_NETWEAVER_AS_ABAP_752 <Version> Application Help SAP Gateway Foundation
(SAP_GWFND) SAP Gateway Foundation Configuration Guide SAP Gateway Configuration Activating
SAP Gateway .

6.1.1.10.4 Activate OData Services

First activate all the common OData services for SAP Fiori (mandatory). Then select the OData services for the
application and SAP Fiori apps that you wish to use and activate these services as well.

Context

For security reasons, the OData services are delivered in an inactive state:

● The common OData services are delivered as part of the SAP Fiori front-end server. They are required for
the SAP Fiori launchpad and you must always activate them.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 97
● The application-specific OData services are delivered with SAP Customer Activity Repository
applications bundle. You only need to activate the services that are relevant for your application.

Procedures

Mandatory: Activate Common OData Services for SAP Fiori

1. Log on to your front-end server (your SAP Gateway system).

2. In transaction SPRO, navigate to SAP Reference IMG SAP NetWeaver SAP Gateway OData Channel
Administration General Settings Activate and Maintain Services and execute the Customizing
activity.

 Tip

As a quick shortcut to the same screen, use transaction /n/IWFND/MAINT_SERVICE.

The Service Catalog shows you all the services that are currently active in your SAP Gateway system.
3. To add and activate more services, choose Add Service.
The Add Selected Services screen is displayed.
4. In System Alias, select the alias of your local back-end system.
This is the alias that you have created in Connect SAP Gateway to your Back-End System [page 96]. For
example, LOCAL.
5. In Technical Service Name, specify /UI2*.
6. Choose Get Services (or press ENTER ).
7. Select all the common OData services for SAP Fiori:

Common OData Services for SAP Fiori

/UI2/PAGE_BUILDER_CONF

/UI2/PAGE_BUILDER_CUST

/UI2/PAGE_BUILDER_PERS

/UI2/TRANSPORT

/UI2/INTEROP

8. Choose Add Selected Services and follow the instructions.

Result

The common OData services are now active in your SAP Gateway system.

Activate Application-Specific OData Services for SAP Customer Activity Repository

applications bundle

1. Log on to your front-end server (your SAP Gateway system).

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
98 PUBLIC Set Up the Applications
 2. In transaction SPRO, navigate to SAP Reference IMG SAP NetWeaver SAP Gateway OData Channel
Administration General Settings Activate and Maintain Services and execute the Customizing
activity.

 Tip

As a quick shortcut to the same screen, use transaction /n/IWFND/MAINT_SERVICE.

The Service Catalog shows you all the services that are currently active in your SAP Gateway system.
3. Activate the services that are required for your application:
1. Choose Add Service.
The Add Selected Services screen is displayed.
2. In System Alias, select the alias of your back-end system.
3. Choose Get Services (or press ENTER ).
The available services are displayed.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 99
 4. Use the following table for reference and select the services for your application:

For this Application... Activate These OData Services...

SAP Customer ○ For POS Data Transfer and Audit: none

Activity Repository ○ For Multichannel Transaction Data Management: none

○ For Unified Demand Forecast and the demand planning apps (Analyze Forecast,
Adjust Forecast, Manage Demand Influencing Factors):
○ /DMF/ANALYZEFORECAST_SRV
○ /DMF/DEMAND_PLAN_UTILITIES_SRV
○ /DMF/OD_DEMAND_PLAN_SRV
○ /DMF/OD_FC_TIME_SERIES_VIZ_SRV
○ /DPL/OD_ADJUST_FORECAST_SRV
○ For Demand Data Foundation (optional; alternative to using the DRF data replication
framework for importing master data):
○ /DMF/API_DOCUMENT
○ /DMF/API_GENERIC_TIME_SERIES
○ /DMF/API_INVENTORY
○ /DMF/API_LOCATION
○ /DMF/API_LOCATION_HIERARCHY
○ /DMF/API_PRODUCT
○ /DMF/API_PRODUCT_HIERARCHY
○ /DMF/API_PRODUCT_LOCATION
○ /DMF/API_SALES_HISTORY
○ /DMF/API_TRANSPORTATION_LANE
○ /DMF/API_ATTRIBUTES
○ /DMF/API_IMAGES
○ /DMF/API_MERCHANDISE_PLAN_KPI
○ /DMF/API_PHPS
○ For the Manage Product Attributes app:
○ /DMF/API_ATTRIBUTES_SRV (optional, to import external attributes for inte­
gration scenarios with non-SAP source master data systems)
○ For Omnichannel Promotion Pricing: none
○ For Omnichannel Article Availability and Sourcing (part of Inventory Visibility):
○ With SAP S/4HANA back-end:
/OAA/F3391_MSN_SRV
/OAA/F2586_MSS_SRV
/OAA/F2659_MSC_SRV
/OAA/F3392_MS_SRV
○ With SAP Retail back-end:
/OAA/F2530_MSN_SRV
/OAA/F2586_MSS_SRV
/OAA/F2659_MSC_SRV
/OAA/F3003_MS_SRV

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
100 PUBLIC Set Up the Applications
 For this Application... Activate These OData Services...

○ For On-Shelf Availability:

○ /OSA/ON_SHELF_AVAILABILITY
○ For SAP Smart Business for Multichannel Sales Analytics: none

Distribution Curves For the Configure Distribution Curves app and the calculation of distribution curves:

○ /DMF/DIST_CURVE

SAP Allocation ○ /AMR/OD_ALLOCATIONPLAN_SRV

Management ○ /AMR/OD_COMMON_SRV
○ /AMR/OD_MARKETUNIT_SRV
○ /AMR/OD_PARAM_SRV
○ /AMR/OD_WORKLOAD_SRV
○ /AMR/OD_PRODUCT_FLOW_SRV
○ /AMR/OD_KPI_CONFIG_SRV
○ /AMR/OD_ALLOCATIONRESULT_SRV
○ /AMR/OD_BASKET_SRV
○ /AMR/OD_ALLOCATIONPLAN_SEARCH_SRV
○ /AMR/OD_CAPACITYMANAGEMENT_SRV

SAP Assortment ○ /DMF/CURRENCY_LIST_SRV

Planning ○ /DMF/LOCATION_CLUSTERSET_SRV
○ /DMF/MASTER_DATA_SRV
○ /DMF/MODULE_MANAGEMENT_SRV
○ /DMF/OBJ_ATTRIBUTE_SRV
○ /DMF/PLAN_CONFIG_SRV
○ /DMF/SEARCH_LOCATIONS_SRV
○ /DMF/SEARCH_PRODUCTS_SRV
○ /DMF/SEASONS_SRV
○ /RAP/ASSORTMENT_LIST_SRV
○ /RAP/OPTION_PLAN_SRV
○ /RAP/PHP_MATCH_SRV
○ /RAP/VALIDITY_PERIOD_SRV
○ /RAP/V_OP_KPI_Q_CDS_CDS
○ /RAP/OPT_PLN_KPI_SRV
○ /RAP/V_OP_OCLST_PRSL_Q_CDS_CDS

SAP Merchandise Not applicable (this application does not have SAP Fiori apps)
Planning

SAP Promotion ○ /DMF/PROD_MD_SRV (Master Data Retrieval)

Management ○ /DMF/OFFER_MANAGEMENT_V2_SRV (Manage Promotional Offers)

○ /DMF/PRODUCT_GROUP_SRV (Manage Product Groups)
○ /DMF/LOCATION_SUBGROUP_SRV (Manage Location Subgroups)
○ /PRM/OFFER_CONTENT_SRV (Offer Content Assignment)

4. Choose Add Selected Services and follow the instructions.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 101
  Note

User roles are only needed if you want to have connections to multiple back-end systems or multiple
clients on the same back-end. The user roles are system-specific and are not delivered by default. If
required, you must create them manually. If you define multiple user roles for different connections,
make sure you have only one role assigned to your user at any time. If you need to change roles, first
remove the old role from your user, then assign the new role.

Result

The application-specific services that you have selected are now active in your SAP Gateway system.

6.1.1.11 Configure SAP Fiori Launchpad

Perform the general configuration of the SAP Fiori launchpad. You must do this procedure before you can set
up SAP Fiori apps for any of the applications.

Context

SAP Fiori launchpad is a shell that hosts SAP Fiori apps, and provides the apps with services such as
navigation, personalization, embedded support, and configuration.

The configuration steps are not specific to this guide and are described in the product documentation of your
SAP NetWeaver version on the front-end server.

Prerequisite

The central SAP Fiori UI component is installed on the front-end server. The component contains the SAP Fiori
launchpad.

Procedure

1. Determine the SAP NetWeaver version on your front-end server.

2. Set up and configure the SAP Fiori launchpad as described in the corresponding product documentation.
For example, for SAP NetWeaver 7.52 see https://help.sap.com/viewer/p/
SAP_NETWEAVER_AS_ABAP_752 <Version> Application Help UI Technologies in SAP NetWeaver
SAP Fiori Launchpad Administration Guide .
If required, select a different version at the top.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
102 PUBLIC Set Up the Applications
 3. (Optional) Configure additional settings to improve the performance of the SAP Fiori Launchpad. These
settings are relevant for the following scenario:
○ Your source master data system is SAP S/4HANA 1809 or higher.
○ You are using Web Dynpro applications or SAP GUI for HTML transactions as tiles on the SAP Fiori
launchpad.
For more information, see the Upgrade Guide for SAP S/4HANA 1809 at https://help.sap.com/viewer/
product/SAP_S4HANA_ON-PREMISE/1809.00latest/en-US and search for section SAP Fiori Launchpad
Settings for Improved Performance.

Parent topic: Core (Mandatory for All Applications) [page 73]

Previous: Configure SAP Gateway [page 95]

Next: Calculate SAPUI5 Application Index for SAP Fiori Apps [page 103]

6.1.1.12 Calculate SAPUI5 Application Index for SAP Fiori

Apps

Configure and run the /UI5/APP_INDEX_CALCULATE (Calculation of SAPUI5 Application Index for SAPUI5
Repositories) report in your front-end system. The report updates the SAPUI5 application index. If the index is
up-to-date, the system can find data related to SAP Fiori apps significantly faster.

Context

The SAPUI5 application index provides indexing and caching for data related to SAP Fiori apps, components,
and libraries. This data is contained in SAPUI5 repositories on the SAP NetWeaver Application Server for ABAP.

Initially, the index is empty. It is calculated and updated each time you run the report.

Configuration Options

To configure how the index should be calculated, you can choose from several options in the report:

● Tab Complete Index, option Depending on Expiry Period and Import of Transport Requests:
This option updates those SAPUI5 repositories and the distribution layer where either the specified
expiration period (in hours and minutes) has elapsed or where a transport has changed the content of the
repositories and the distribution layer since the last update.

 Note

This is the default mode with an expiration period of 24 hours. We recommend that you use this mode
when scheduling the report for periodic execution.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 103
● Tab Complete Index, option Full Calculation:
This option performs a full update of all SAPUI5 repositories and the distribution layer regardless of any
expiration dates.
● Single SAPUI5 Repository Only
● SAPUI5 Distribution Layer Only

Use

Configure and run the report in all your front-end systems.

You can run the report manually, but we recommend the following best practices:

● Schedule the report as a job with periodic execution for all follow-up systems where the changes are
transported to. This ensures that the application index is updated based on the transports imported by the
system.
● Always run the report in the following situations:
○ after any changes to the content of the SAPUI5 ABAP repository (for example, implementation of SAP
Notes, upgrades, changes to SAP Gateway systems)
○ after installing a new version of the distribution layer
○ after implementing an SAP Note containing changes to an SAP Fiori app

Prerequisites

You are familiar with the prerequisites, configuration options, and requirements of the report. For more
information, see the following:

● SAP Note 2227577 (Recalculation of the SAPUI5 Application Index After Implementing an SAP Note)
● Report documentation in transaction SE38
● SAPUI5: UI Development Toolkit for HTML5: Here you can find detailed information on the SAPUI5
application index and the report. Consult the documentation for the SAP NetWeaver version on your front-
end server.
For example, for SAP Gateway for SAP NetWeaver 7.52 see https://help.sap.com/viewer/p/
SAP_NETWEAVER_AS_ABAP_752 <your SP> Application Help UI Technologies in SAP NetWeaver
SAPUI5: UI Development Toolkit for HTML5 Developing Apps The SAPUI5 ABAP Repository and the
ABAP Back-End Infrastructure SAPUI5 Application Index , including the subsections.

Procedure

1. Log on to your front-end system.

2. Execute transaction SE38, specify /UI5/APP_INDEX_CALCULATE as the program (report), and choose
Execute ( F8 ).
3. Configure the report.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
104 PUBLIC Set Up the Applications
 4. Choose Execute ( F8 ) again to run the report manually.

 Tip

Schedule the report to run on a regular basis in all your front-end systems.

Parent topic: Core (Mandatory for All Applications) [page 73]

Previous: Configure SAP Fiori Launchpad [page 102]

6.1.2 Advanced (Optional)

Perform optional steps to set up specific functionality in SAP Customer Activity Repository.

6.1.2.1 Configure SAP Smart Business for Multichannel

Sales Analytics

6.1.2.1.1 Install the SAP Smart Business Modeler Apps

Framework

The SAP Smart Business for Multichannel Sales Analytics apps included in this installation are based on the
SAP Smart Business Modeler Apps Framework. Installation and setup of this framework includes the following:

● Installation of SAP Smart Business Modeler apps on the front-end server

● Installation of SAP Smart Business products on the SAP HANA Server
● Installation of SAP Web Dispatcher
● Communication channels
● App implementation

For more information on these topics, see https://help.sap.com/viewer/p/UI_ADD-

ON_FOR_SAP_NETWEAVER_10 Application Help SAP Library SAPUI5: UI Development Toolkit for HTML5
SAPUI5 Application Frameworks SAP Smart Business Setting up the SAP Smart Business Modeler Apps
Framework .

 Note

If you are installing User Interface Add-On 2.0 for SAP NetWeaver, you must download and install add-on
object UISAFND1 100 as described in SAP Note 2183947 .

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 105
6.1.2.1.2 Configure SAP Web Dispatcher for the SAP Smart
Business Modeler Apps

SAP Web Dispatcher lies between the Internet and your SAP system. It is the entry point for HTTP(s) requests
into your system. As a “software web switch”, SAP Web Dispatcher can reject or accept connections. It
contributes to security and also balances the load in your SAP system.

Where to Find Configuration Information

To find the SAP Web Dispatcher information for your SAP NetWeaver release, see the following:

● Central SAP Web Dispatcher note: 908097 SAP Web Dispatcher: Release, Installation, Patches,
Documentation
● Product documentation: https://help.sap.com/viewer/p/SAP_NETWEAVER. Choose your SAP NetWeaver
Platform and select the support package stack at the top right.
For configuration information, search for “Administration of the SAP Web Dispatcher”.
For a configuration example, search for “SAP Web Dispatcher Configuration Reference”.
For architecture information, search for “Architecture and Functions of the SAP Web Dispatcher”.

How to Configure SAP Web Dispatcher for the SAP Smart Business Modeler
Apps

The following parameters values are required:

● Source master data system: SAP ECC

Parameter wdisp/system_542 requires the following URL: /sap/is/retail/car/mcsa/odata
Resulting setting: wdisp/system_542 /sap/is/retail/car/mcsa/odata
● Source master data system: SAP S/4HANA
Parameter wdisp/system_542 requires the following URL: /sap/is/retail/car_s4h/mcsa/odata
Resulting setting: wdisp/system_542 /sap/is/retail/car_s4h/mcsa/odata

Other Solutions

If you use any other reverse proxy, see the manufacturer's documentation for more information.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
106 PUBLIC Set Up the Applications
6.1.2.2 Configure On-Shelf Availability

Configure the On-Shelf Availability (OSA) module in SAP Customer Activity Repository. All steps are optional
and depend on your implementation scenario.

 Note

The configuration of OSA is mandatory if you want to generate intraday forecasts. For information about
this feature, see https://help.sap.com/viewer/p/CARAB <Version> Application Help SAP Customer
Activity Repository Unified Demand Forecast General Services Generate Intraday Forecasts .

 Note

If you encounter any issues when upgrading OSA, see Troubleshooting [page 166] for a possible solution.

6.1.2.2.1 Generate Run IDs for OSA Processing Steps

Use

Each scheduled run of a processing step of On-Shelf Availability (OSA) has a generated run ID. This is the
unique identification for a job.

The run ID is used to distinguish several runs within one period. Each processing step has its own ID generator:

Processing Step Transaction for the ID Generator

Intraweek Pattern /OSA/NR_IWP

Estimation /OSA/NR_EST

Monitoring /OSA/NR_MON

Analysis /OSA/NR_ANA

For each of the four ID generator transactions, you must define the range of run IDs.

Procedure

Do the following steps for each transaction:

1. Log on to your back-end system.

2. Execute the transaction by specifying either /n<transaction> or /o<transaction>.
Example for the first transaction: /n/OSA/NR_IWP
3. Choose Intervals in change mode.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 107
4. In the first row of the table, enter the following values for the following fields:
○ Field No: 01
○ Field From No.: 0000000000000001
○ Field To Number: 9999999999999999
5. Save your changes.

6.1.2.2.2 Check Field Contents in SAP HANA Content for

On-Shelf Availability

Use

There are two OSA-specific SAP HANA views that can be customized:

● AN_TRANSACTION
● PROMOTION_TRANS

You must check if the fields in these views contain the mappings or formulas you need.

 Caution

If you need to modify a view, be aware that a new installation will rewrite the modifications. It is therefore
recommended to back up the modified views.

Procedure

To change the mapping or the formula of a field, do these steps:

1. Define the data foundation that is the source for the view, that is, the table /POSDW/TLOGF.
2. Define filters for the view.
3. Map the fields from source to target.
4. Create measures and calculation fields.

For more information, see the documentation under https://help.sap.com/viewer/p/SAP_HANA_PLATFORM

<Version> Development .

Definitions for a View (Using the AN_TRANSACTION View as an Example)

The following definitions are set by default for the AN_TRANSACTION view:

● The source of the view is the table /POSDW/TLOGF.

● Examples of filters for the views:
○ RECORDQUALIFIER = '5': Only sales records are used.
○ DATASTATUS in ('2' , '3'): Only those records are used that passed the SAP Customer Activity
Repository validation.
○ RETAILQUANTITY > 0.0: Negative quantities are not used by On-Shelf Availability.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
108 PUBLIC Set Up the Applications
 ○ VOIDEDLINE = '': Canceled transactions are not used by On-Shelf Availability.
● Examples of fields mappings:
○ MANDT: Client ID. This field is mapped to the MANDT column of the /POSDW/TLOGF table.
○ STORE_ID: Store ID. This field is mapped to the RETAILSTOREID column of the /POSDW/TLOGF table.
○ BUSINESSDAYDATE: Business day. This field is mapped to the BUSINESSDAYDATE column of the /
POSDW/TLOGF table.
● Examples of measures:
○ RETAILQUANTITY: Amount of units sold. Refers to the SALESUOM (Sales Unit of Measure) field that is
also defined in the /POSDW/TLOGF table. Contains the value of the RETAILQUANTITY field.
○ PRICE: Price specified in the store currency. Contains the value of the ACTUALUNITPRICE field.
● Examples of calculated fields:
○ TRANS_TIME_DBL: Value of the TRANS_TIME output field of type DOUBLE. The format of the
transaction time that is stored in BEGINTIMESTAMP and ENDTIMESTAMP is <YYYYMMDDhhmmss>.
○ DISCOUNT: Total relative discount applied on the item.
Calculated as (ITEMDISC + DISTDISC) / (RETAILQUANTITY * ACTUALUNITPRICE). If the price
is not a positive number, 0 is returned.
Definitions:
○ DISTDISC: global discount on the whole purchase; currently not used.
○ ITEMDISC: item-specific discount; currently used.

6.1.2.3 Ensure that Third Party CRM Sales Orders are

Transferred to SAP ERP

Use

Sales documents are accessed by SAP Customer Activity Repository (either through replication or direct data
access) from a source SAP ERP system. One way that sales documents of type Sales Order can be generated in
a SAP ERP system is through the transfer of sales orders created using an SAP CRM source system or a third
party CRM system.

When customers create sales orders using SAP CRM systems, these sales orders are inherently compatible to
the sales document structure in SAP ERP. They are transferred to SAP ERP via Data Exchange for Sales Orders:
CRM Enterprise - ERP System process. For more information, see SAP Library for SAP CRM on SAP Help Portal
at http://help.sap.com/crm . Select the applicable version of SAP CRM and under Application Help, open
SAP Library and choose Basic Functions Business Transaction Data Exchange for Business
Transactions .

Customers who use third party CRM systems to create sales orders, and who want to access these sales orders
from SAP Customer Activity Repository, must ensure that their sales order data:

● Includes the information required by SAP Customer Activity Repository

● Has been transferred to SAP ERP prior to being able to access this data from SAP Customer Activity
Repository

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 109
Procedure

1. Ensure that the fields required by SAP Customer Activity Repository are filled during the transfer of sales
order data from your third party CRM system to SAP ERP.
2. Ensure that sales order data has been transferred from your third party CRM system to SAP ERP.

6.1.2.4 Partition /POSDW/TLOGF and Aggregation Tables

Use

SAP Customer Activity Repository application contains the Point of Sale Data Management software
component, which is used to receive a large volume of data from your connected stores. Point of Sale Data
Management, or more specifically, its POS Inbound Processing Engine (PIPE), processes the incoming
transactions and stores them in the /POSDW/TLOGF table.

Since every transaction line item is stored as a separate row in the /POSDW/TLOGF table, the table can quickly
grow to become very large. To improve standard database operations, such as inserting, updating, deleting and
reading and mass operations, such as archiving or index merging, SAP recommends that you partition the /
POSDW/TLOGF table.

Also, you can select to store extension segments in a dedicated /POSDW/TLOGF_EXT table using the Store
Extensions in Separate Table option of the Define General Settings Customizing activity. Table /POSDW/
TLOGF_EXT should be partitioned in the same way as the /POSDW/TLOGF table.

For more information on extension segments, see the Appendix of the Operations Guide, SAP Customer Activity
Repository.

 Note

Partitioning is typically used in distributed system, but it may also be beneficial for single-host systems.

Procedure

1. Read the Table Partitioning in the SAP HANA Database section of the SAP HANA Administration Guide.
2. Plan your partition specifications in accordance to the following guidelines:
○ A single partition should not contain more than 1 billion rows.
○ The total amount of partitions of a single table should not exceed 1000.
○ Because the actual act of partitioning a table does use system resources, do not start partitioning
the /POSDW/TLOGF table until its volume has surpassed 250 million rows.
3. Partition the /POSDW/TLOGF table as required according to SAP Note 1719282 . Depending on your
requirements, you may also optionally partition the following tables. The same SAP Note is relevant for
these as well.
○ /POSDW/TLOGF_EXT

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
110 PUBLIC Set Up the Applications
 ○ /POSDW/AGGR01
○ /POSDW/ACCRTB

6.1.2.5 Customize Copies of SAP HANA Views

Use

In this optional procedure, you create copies of views included in SAP HANA Live for SAP ERP or in the SAP
HANA content for SAP Customer Activity Repository. You then customize these copies to reflect your specific
data model extensions.

 Caution

Do not modify standard SAP HANA content.

For example, you would need to execute this procedure if you have extended your POS transaction data model.
The views delivered with the SAP HANA content for SAP Customer Activity Repository are built on the
standard /POSDW/TLOGF table. If you have added custom fields to the /POSDW/TLOGF table, you will have to
create views that expose these fields.

In general, if you have extended any standard SAP data models, you must copy and adapt the standard SAP
HANA content.

 Caution

If you have created a copy of a view shipped as part of the standard SAP HANA content and have made
modifications to this copy, a subsequent upgrade of SAP HANA Live for SAP ERP or SAP HANA content for
SAP Customer Activity Repository will not update your copied and modified version of the view. SAP Notes
or enhancements shipped by SAP will also have to be manually implemented on the copied, and
subsequently modified, SAP HANA content.

Procedure

1. Log on to SAP HANA studio.

2. Open the Modeler and use the Navigator to access the folder that contains the view that you want to copy.
For example, <Your System Name> Content sap is retail car Calculation Views .
3. Identify the view you want to copy. For example, sap.is.retail.car/POSSalesQuery.
4. Use the Auto Documentation feature of SAP HANA studio to identify all reuse and private views that are
consumed by your selected view, as well as any query views that might consume your view. To do so:
1. Right-click on the selected view, and choose Auto Documentation from the context menu.
2. Browse to the location where you want to save the file and choose Finish.
3. Open the generated *.pdf file, and locate the Cross-References section of the document.
The Cross-References section displays the hierarchy of calculation (query, reuse, and private) views
that are accessed by the selected view. Affected underlying, as well as all consuming views, in this
hierarchy must also be copied and modified as a result of your extension.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 111
 For example, calculation views sap.is.retail.car/POSSales, sap.is.retail.car/
POSLogItem, and sap.is.retail.car/TLOGF_ITEM_COM are all consuming the /POSDW/ TLOGF
table and are consumed by the sap.is.retail.car/POSSalesQuery view. Therefore, if you have
extended the /POSDW/TLOGF table, all these views must be copied and modified.
5. For each view identified in the previous step, do the following:
1. In the Navigator panel, select an object and in the context menu, choose Copy.
2. Navigate to the package where you want to paste the view and choose Paste.

 Note

You must have write permissions on the target package to which you are pasting the view. Also, you
should copy the view to your own package. Do not modify the original sap package.

3. Modify the copied view as required.

For more information, see the Creating Views section of the SAP HANA Developer Guide.
4. Right-click on the copied and modified view and select Activate.

6.1.2.6 Complete UDF Setup

Set up the Unified Demand Forecast (UDF) module in SAP Customer Activity Repository to enable demand
modeling and forecasting for any scenario. To be able to use UDF, you must at least do the mandatory steps.
We also point to helpful performance information for UDF.

Use

UDF supports the following scenarios:

Scenario Set Up and Configure UDF

Demand planning apps in SAP Customer Activity Repository Mandatory

(Analyze Forecast, Adjust Forecast, Manage Demand
Influencing Factors)

SAP Promotion Management Mandatory (for what-if forecasts)

Optional (without what-if forecasts)

SAP Allocation Management Mandatory (if forecasting is associated with your scenario)

SAP Assortment Planning

SAP Merchandise Planning

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
112 PUBLIC Set Up the Applications
Prerequisites

● You have configured the DDF module as described in Configure Demand Data Foundation [page 90].
● You have set up the users, roles, and privileges for UDF as described in Set Up Authorizations for Unified
Demand Forecast (UDF) [page 78].

Procedure

 Note

If you encounter issues during the setup, see the Troubleshooting [page 166] section for possible solutions.

Perform Mandatory Setup Steps

1. Log on to your ABAP back-end system.
2. Implement the following corrections for UDF in SAP Customer Activity Repository 4.0 FPS02:

SAP Note Guidance

2847721 : Cannibalization Effect During Non-promo­ Correction to the new promotion cannibalization feature in
tional Dates this release.

2845543 Modeling and forecasting services run signifi- Correction to the new promotion cannibalization feature in
cantly slower with cannibalization pairs configured this release.

2847712 : Parameters in model and forecast reports are Relevant for both demand modeling and demand forecast­
not respected ing.

2847134 : Unused fields in model and forecast by hierar­ Relevant for the Model by Hierarchy and Forecast by
chy reports Hierarchy services in transaction NWBC.

2844046 : UDF forecast fails with SAP HANA Platform Only relevant if you are using SAP HANA Platform 2.0
2.0 SPS04 SPS04. The note prevents UDF runtime issues that might
occur on this SAP HANA support package stack.

3. In transaction SPRO, do the Customizing for UDF that you need for your scenario:

 Note

For more information about the following Customizing activities, see the accompanying system
documentation.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 113
 What to do... Your scenario is... Customizing

Define the time series source with his­ All scenarios Cross-Application Components
torical demand data that you wish to Demand Data Foundation Imported
import to DDF.
Data Time Series Define Time

Series for Key Figure Configuration

You want to generate what-if forecasts Additionally, configure the following

in SAP Promotion Management. activity for this scenario:

Cross-Application Components

Demand Data Foundation Data

Maintenance Define Time Series

Source

Define general settings for modeling All scenarios Activities under Cross-Application
and forecasting. Components Demand Data

Foundation Modeling and

Forecasting

4. Check and, if necessary, change the default setting for how the covariance matrix is generated during
modeling.
1. Navigate to Cross-Application Components Demand Data Foundation Modeling and Forecasting
Define Modeling Control Settings .
2. Execute the Customizing activity and choose New Entries.
3. Configure the MOD_COV_REDUCED parameter to generate either the “full” or the “reduced” covariance
matrix:

Your scenario is... What to do...

○ You want to calculate hierarchical priors (HPRs). The reduced covariance matrix is sufficient for those
○ You want to use SAP Promotion Management, but scenarios and also saves runtime.
without generating the forecast confidence index
Enable the MOD_COV_REDUCED parameter:
(FCI).
○ You do not want to use SAP Promotion Enter the parameter name under Configuration Type
Management. Code and set the Value to X to override the default.
Make the other settings as required and save your
changes.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
114 PUBLIC Set Up the Applications
 Your scenario is... What to do...

You want to generate the FCI in SAP Promotion The full covariance matrix is mandatory for the FCI.
Management.
No additional configuration is required (the
MOD_COV_REDUCED parameter is disabled by default,
which is correct for this scenario).

Be aware that the generation of the full covariance ma­

trix is performance-intensive.

 Note

To calculate either the full or the reduced covariance matrix, the MOD_OUTPUT_COV parameter
must be enabled. As it is enabled by default, no additional configuration is required unless you have
previously disabled the parameter for a different scenario.

5. Configure the modeling and forecasting features that you wish to use in your scenario.
See section Configure Unified Demand Forecast (UDF) of the SAP Customer Activity Repository
Administration Guide.
6. Optimize the performance of modeling and forecasting. Again in the SAP Customer Activity Repository
Administration Guide, see section Optimize UDF Performance.

 Tip

We highly recommend that you read this information and implement any performance tips that are
relevant for your scenario. For example, using SAP HANA workload management and optimizing the
performance of SAP HANA Platform are beneficial for any scenario.

Perform Optional Setup Steps

You have the following additional options:

1. (Highly recommended) Set up table partitioning for your scenario.

See the Partition Tables for UDF and DDF section of the SAP Customer Activity Repository Administration
Guide.
2. Implement the following SAP Note(s) if relevant for your scenario:
○ 2161484 : Information about an ABAP validation report that you can use to check the input data for
modeling and forecasting and solve potential issues
3. Set up the demand planning apps (Analyze Forecast, Adjust Forecast, Manage Demand Influencing Factors).
See Set Up SAP Fiori Apps for SAP Customer Activity Repository [page 116].
4. Set up data integration and replication between your source master data system and your SAP Customer
Activity Repository system.
For more information, see the following sections of the SAP Customer Activity Repository Administration
Guide:
○ Integration information for UDF and DDF: Introduction to SAP Customer Activity Repository and
Configure DDF Integration Scenarios
○ Using the data replication framework (DRF, transaction DRFOUT) for replicating master and
transactional data: Configure Data Replication from SAP ERP to DDF.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 115
6.1.2.7 Set Up SAP Fiori Apps for SAP Customer Activity
Repository

Verify that the prerequisites are fulfilled and prepare the system landscape for the apps included in SAP
Customer Activity Repository.

Context

For a list of the apps included in SAP Customer Activity Repository, see SAP Help Portal at SAP Fiori for SAP
Customer Activity Repository.

 Note

Depending on your scenario, some prerequisites might already be available in your system landscape.

General Prerequisites

● Front-end server: You have installed the required version of SAP FIORI FRONT-END SERVER. For version
information, see Install the Prerequisites [page 17] and choose Common Prerequisites SAP Fiori .
● SAP Fiori launchpad: You have set up the launchpad as described in the Common Installation Guide, in
section .
● SAP Fiori launchpad designer: You have set up the designer as described for the SAP NetWeaver version
on your front-end server. See https://help.sap.com/viewer/p/SAP_NETWEAVER and choose SAP
NetWeaver Platform <Version> Application Help UI Technologies in SAP NetWeaver SAP Fiori
Launchpad Setting up the Launchpad and Using the Launchpad Designer.
For some apps, app-specific settings will be required in the designer.
● SAP Gateway: You have done the general SAP Gateway configuration and you have activated the common
OData services and Internet Communication Framework (ICF) services. See the following:
○ , including all subsections
○ SAP Note 1560585 (SAP Gateway 2.0 Release Note)

Prerequisites Specific to SAP Customer Activity Repository applications

bundle

1. You have installed the correct SAP RTL AFL FOR SAP HANA revision for the current release. See
Download and Install the Application Function Library (SAP RTL AFL FOR SAP HANA) [page 51].
2. You have installed the back-end system. See Install ABAP Back-End Server [page 51].
3. You have installed the front-end system. See .

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
116 PUBLIC Set Up the Applications
 4. You have implemented all the mandatory SAP Notes for the apps that you wish to set up. See Implement
SAP Notes for the Installation [page 26] and consult the release information notes (RINs) mentioned there
as well as the table for SAP Customer Activity Repository.
5. You have performed all mandatory setup steps for SAP Customer Activity Repository. For example, this
includes activating the OData services for the apps or calculating the SAPUI5 application index. For a
complete list of the steps, see Core (Mandatory for All Applications) [page 73].
6. You have set up the system connections:
○ You have set up dedicated RFC connections between your front-end system and your back-end
system, and between your front-end system and your source master data system.
○ You have defined a system alias for your back-end system.

 Caution

You must set the back-end system client to the same value for the SAP Gateway OData services (via
the system alias and the RFC connection) and the SAP HANA services (via the bk-client parameter
in the SAP Fiori launchpad designer). Otherwise, the apps will not work correctly.

7. For the apps Analyze Forecast, Adjust Forecast, and Manage Demand Influencing Factors: You have set up
the Unified Demand Forecast (UDF) module as the forecasting engine in the back-end. You must at least do
the mandatory setup steps for UDF. See Complete UDF Setup [page 112].
8. To set up the apps included in OAA, see section Configure Omnichannel Article Availability and Sourcing for
Use with SAP Customer Activity Repository.

Result

After you have prepared the system landscape in this way, you can now set up the apps that you wish to use.

Set Up the Analyze Forecast App [page 118]

Perform several tasks on the front-end server and the back-end server to set up the Analyze Forecast
app.

Set Up the Adjust Forecast App [page 125]

Perform several tasks on the front-end server and the back-end server to set up the Adjust Forecast
app.

Set Up the Manage Demand Influencing Factors App [page 130]

Perform several tasks on the front-end server and the back-end server to set up the Manage Demand
Influencing Factors app.

DDF Apps: Assign Roles, Catalogs, and Groups in SAP Fiori Launchpad [page 135]
Perform this procedure to set up the SAP Fiori apps provided by Demand Data Foundation (Configure
Distribution Curves, Manage Location Clusters, Manage Product Attributes, Manage Product Groups,
Manage Promotional Offers). All of these apps are available to you as part of SAP Customer Activity
Repository. They support different scenarios and consuming applications.

Set Up the Manage Product Attributes App [page 136]

Perform several tasks on the front-end server and the back-end server to set up the transactional app
Manage Product Attributes. This is one of the Demand Data Foundation (DDF) apps included in SAP
Customer Activity Repository.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 117
6.1.2.7.1 Set Up the Analyze Forecast App

Perform several tasks on the front-end server and the back-end server to set up the Analyze Forecast app.

 Note

If you are already using the app and only wish to upgrade it to the current release, see the Set Up the
Analyze Forecast App (Upgrade Scenarios) section of the Common Upgrade Guide for this release.

Prerequisites

● You are aware of the following technical changes as of SAP Customer Activity Repository 4.0 FPS02:
○ You no longer need SAP Web Dispatcher to be able to run the app.

 Tip

(Optional) If you already have SAP Web Dispatcher installed from a previous release and only
needed it for the app, you can now remove it from your system landscape.

○ You no longer need SAP HANA XS Classic (SAP HANA Extended Application Services, classic model).
The app-specific XS OData service
(sap.hba.t.rtl.udf.afc.odata::AnalyzeForecast.xsodata) has been deprecated.

 Note

This XS OData service is only valid anymore in interoperability scenarios. Here you would use the
current front-end product version (SAP FIORI FOR SAP CARAB 4.0, current support package
stack) in combination with an older back-end product version (SAP CARAB 4.0 Initial
Shipment Stack or SAP CARAB 4.0 FPS01).

If you have such a scenario, please set up the app as described in the Common Upgrade Guide for
the back-end product version. For example, if your back-end product version is SAP CARAB 4.0
FPS01, use the Common Upgrade Guide for SAP Customer Activity Repository applications bundle
4.0 FPS01.

For more information on the supported interoperability scenarios, see SAP Note 2815026
(Back-end and front-end interoperability in SAP Customer Activity Repository applications bundle
4.0).

● You have verified the prerequisites and prepared the system landscape as described in Set Up SAP Fiori
Apps for SAP Customer Activity Repository [page 116].
● You know where to find additional information on the app if necessary:
○ Technical details for each delivery are available in the SAP Fiori apps reference library. For the latest
delivery (latest wave), see https://fioriappslibrary.hana.ondemand.com/sap/fix/externalViewer/
index.html?appId=F1773A.
○ For information on the app features and supported time series, see https://help.sap.com/viewer/p/
CARAB Application Help SAP Customer Activity Repository and search for section Analyze
Forecast (Version 2).

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
118 PUBLIC Set Up the Applications
Procedure

To set up Analyze Forecast, follow these steps:

 Tip

If you encounter issues during the setup, see the Troubleshooting [page 166] section for possible solutions.

1. Verify that the OData services for Unified Demand Forecast and the demand planning apps are active.
If a service is not active, activate it
See Activate OData Services [page 97].
2. Configure user access to the SAP HANA data for the app.

 Note

You can find the general SAP Fiori Help for this step at SAP Fiori Implementation Information 7.40
under Implementation App Implementation App Implementation for Analytical Apps
Configuring Access to SAP HANA Data .

Use this section as your starting point. However, to configure Analyze Forecast, you only need to do
some of the steps described there.

1. Synchronize the SAP HANA database users. Each user of the app requires a front-end user on the
ABAP front-end server (to enable navigation in the SAP Fiori launchpad) and a back-end user in the
SAP HANA database (to enable access to the relevant SAP HANA views).
Follow the steps in Configuring Access to SAP HANA Data Synchronizing SAP HANA Database
Users .
2. Assign the app-specific SAP HANA role
sap.hba.t.rtl.udf.afc.roles::AnalyzeForecast.hdbrole to the back-end users of the app.
The role gives them access to the app-specific SAP HANA data so they can view this data in the app
(for example, sales, modeling results, forecasts).
Follow the steps in Configuring Access to SAP HANA Data Assigning Roles for Accessing SAP
HANA Data .
3. Create the analytic privileges to give the users read-only access to the SAP HANA views for the app
(SAP HANA content package sap.hba.t.rtl.udf.afc.v).
Follow the steps in Configuring Access to SAP HANA Data Creating Analytic Privileges .

 Note

If you need more information about analytic privileges, see the Create Classical XML-based Analytic
Privileges section under https://help.sap.com/viewer/p/SAP_HANA_PLATFORM <Version>
Development SAP HANA Modeling Guide (for SAP HANA Studio) Defining Data Access
Privileges .

3. Customize the navigation target for the app in the SAP Fiori launchpad on the front-end server.
Execute transaction LPD_CUST (Launchpad Customizing) and display the role UICAR001 in instance
TRANSACTIONAL.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 119
 From the list of applications, select the entry with AnalyzeForecast in the Params column and make the
following settings:
○ Link Text: AnalyzeForecast
○ Application Type: URL
○ URL: /sap/bc/ui5_ui5/sap/analyzfcst_v2
○ Application Alias: AnalyzeForecast
○ Additional Information: SAPUI5.Component=retail.udf.analyzeforecastv2
○ Portal Parameters: Leave the default settings.
○ Switch Support: Leave the default settings.

 Note

If you need more information on navigation targets, see https://help.sap.com/viewer/p/

SAP_NETWEAVER and choose your SAP NetWeaver Platform. Select your support package stack at
the top right and search for Customizing Navigation Targets in LPD_CUST.

4. Configure the SAP Fiori launchpad designer for Analyze Forecast.

1. Launch the designer in one of the following modes:
○ For the CUST mode, use this URL:
https://<server>:<port>/sap/bc/ui5_ui5/sap/arsrvc_upb_admn/main.html?sap-
client=<client>#/Catalog/X-SAP-UI2-CATALOGPAGE:SAP_ISR_CAR_TC_A
Use this mode for client-specific configurations, replacing <client> with the respective client.
○ For the CONF mode, use this URL:
https://<server>:<port>/sap/bc/ui5_ui5/sap/arsrvc_upb_admn/main.html?sap-
client=<client>&scope=<CONF>#/Catalog/X-SAP-UI2-
CATALOGPAGE:SAP_ISR_CAR_TC_A
Use this mode for global configurations across all clients. This URL additionally includes the
<CONF> parameter.
2. Configure the app tile in the SAP Fiori launchpad designer.

 Note

You can configure tiles only in catalogs. By default, the tile for Analyze Forecast is in the SAP: CAR –
Analytical Apps catalog (which is delivered with the launchpad configuration).

For more information about configuring tiles, see https://help.sap.com/viewer/p/

SAP_NETWEAVER and choose your SAP NetWeaver Platform. Select your support package stack
at the top right and search for Adding or Removing Tiles or Target Mappings, Configuring Tiles, and
Static App Launcher Tiles.

If the app tile has not yet been created, create it as a static tile using the following settings:
○ Title: Analyze Forecast
○ Icon: sap-icon://Fiori5/F0812
○ Use semantic object navigation: Select this option.
○ Semantic Object: ForecastDemand
○ Action: showUDFAnalyzeForecast
○ Parameters: bk-client=<backend client>

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
120 PUBLIC Set Up the Applications
  Caution

In the SAP Fiori launchpad designer, you specify the back-end system client using the bk-
client parameter. You must specify the same back-end system client for the SAP Gateway
OData services (system alias and RFC connection) and for the SAP HANA services. Otherwise,
the app will not work correctly.

○ Leave the other options empty.

3. Configure the target mapping in the SAP Fiori launchpad designer.
If the target mapping has not yet been created, choose Target Mappings and create a new entry with
the following settings:
○ Semantic Object: ForecastDemand
○ Action: showUDFAnalyzeForecast
○ Application Type: SAP Fiori App using LPD_CUST
○ Launchpad Role: UICAR001
○ Launchpad Instance: TRANSACTIONAL
○ Application Alias: AnalyzeForecast
○ Device Types: Select Desktop and Tablet.
○ Allow additional parameters: Select this option.

 Note

If you need more information about configuring target mappings, see https://help.sap.com/
viewer/p/SAP_NETWEAVER and choose your SAP NetWeaver Platform. Select your support
package stack at the top right and search for Configuring Target Mappings.

5. Complete the app setup on the front-end server.

 Note

You can find the general SAP Fiori Help for this step at SAP Fiori Implementation Information 7.40
under Implementation App Implementation App Implementation for Analytical Apps
Implementation Tasks on Front-End Server .

Use this section as your starting point. However, to configure Analyze Forecast, you only need to do
some of the steps described there.

1. Activate the SAP Gateway OData services for the app:

 Caution

In the SAP Fiori launchpad designer, you specify the back-end system client using the bk-client
parameter. You must specify the same back-end system client for the SAP Gateway OData services
(system alias and RFC connection) and for the SAP HANA services. Otherwise, the app will not
work correctly.

Follow the steps in Activate OData Services [page 97].

2. Activate the Internet Communication Framework (ICF) services for the app:
Execute transaction LPD_CUST (Launchpad Customizing) and display the role UICAR001 in instance
TRANSACTIONAL.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 121
 Select AnalyzeForecast from the list of applications and verify that the following ICF services are active:
○ /sap/bc/bsp/sap/analyzfcst_v2
○ /sap/bc/lrep
○ /sap/bc/ui5_ui5/sap/analyzfcst_v2
○ /sap/bc/bsp/sap/udfreuse
○ /sap/bc/ui5_ui5/sap/udfreuse
If a service is not active, activate it as follows:
1. Execute transaction SICF (Define Services).
2. As Service Path, specify the <service path/service name> and execute the search.
3. As Virtual Hosts / Services, select the analyzfcst_v2 entry and choose Service/Host
Activate .

 Note

If you need more information on how to activate ICF services and OData services, see
Implementation Tasks on Front-End Server Front-End Server: Activate ICF Services of SAPUI5
Application .

3. Create your custom copy of the SAP_CAR_TCR_A standard role on the front-end server:

 Caution

Standard roles are delivered as templates. They begin with the prefix SAP_*. Never change the
standard roles, but only your custom copies of these roles (Z_*). Otherwise, any standard roles
that you have changed will be overwritten by newly delivered standard roles during a later upgrade
or release change.

1. Execute transaction PFCG (Role Maintenance) and search for the SAP_CAR_TCR_A standard role.

 Note

SAP_CAR_TCR_A is the front-end server authorization role delivered for analytical apps in SAP
Customer Activity Repository. The role contains the catalogs, groups, and start authorizations
for the OData services required to access the app.

2. Choose Role Copy and enter a name from the customer namespace for your copied role.

 Note

If you need more information on copying standard roles and adjusting custom roles, see the
Changing Standard Roles section in the User and Role Administration of Application Server
ABAP.

3. Switch to change mode and adjust the copied role as needed for your scenario.
4. Assign the required launchpad catalogs and groups.
Follow the steps in Implementation Tasks on Front-End Server Create PFCG Role on Front-End
and Assign Launchpad Catalogs and Groups .
5. Save your changes.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
122 PUBLIC Set Up the Applications
 4. Create your custom copy of the SAP_DPL_TCR_T standard role on the front-end server:

 Note

This step is similar to the previous one, and you can consult the same references.

1. Execute transaction PFCG (Role Maintenance) and search for the SAP_DPL_TCR_T standard role.

 Note

SAP_DPL_TCR_T is the front-end server authorization role delivered for the demand planning
apps in SAP Customer Activity Repository (Analyze Forecast, Adjust Forecast, Manage Demand
Influencing Factors).

2. Choose Role Copy and enter a name from the customer namespace for your copied role.
3. Switch to change mode and adjust the copied role as needed for your scenario.
4. Assign the required launchpad catalogs and groups.
Follow the steps in Implementation Tasks on Front-End Server Create PFCG Role on Front-End
and Assign Launchpad Catalogs and Groups .
5. Save your changes.

 Tip

If you already have SAP Fiori launchpad open, clear your browser cache to apply all the changes.

6. Set up the catalogs, groups, and roles in the SAP Fiori launchpad.
Follow the steps in Implementation Tasks on Front-End Server Setup of Catalogs, Groups, and Roles in
the SAP Fiori Launchpad .
7. Assign the two custom copies (which you have just created from the two standard roles) to the users
of the app.
Follow the steps in Implementation Tasks on Front-End Server Front-End Server: Assign Roles to
Users .
8. Complete the setup on the back-end server.
1. Log on to the back-end server.
2. Execute transaction PFCG (Role Maintenance) and search for the /DMF/DPL standard role.

 Caution

Standard roles are delivered as templates. They begin with the prefix SAP_*. Never change the
standard roles, but only your custom copies of these roles (Z_*). Otherwise, any standard roles
that you have changed will be overwritten by newly delivered standard roles during a later upgrade
or release change.

3. Create your custom copy of /DMF/DPL on the back-end server:

 Note

/DMF/DPL is the back-end server authorization role. It is also required for the cross-navigation
between the demand planning apps (Analyze Forecast, Adjust Forecast, Manage Demand
Influencing Factors).

Choose Role Copy and enter a name from the customer namespace for your copied role.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 123
 4. Switch to change mode and adjust the copied role as needed for your scenario.

 Note

If you need more information on copying standard roles and adjusting custom roles, see the
Changing Standard Roles section in the User and Role Administration of Application Server ABAP.

5. Assign the required launchpad catalogs and groups.

Follow the steps in Implementation Tasks on Front-End Server Create PFCG Role on Front-End and
Assign Launchpad Catalogs and Groups .
6. Save your changes.

Optional Setup Steps

If relevant for your scenario, implement any of the following options:

● Single Sign-On (SSO): If you haven't already done so, set up SSO between the front-end server and the
back-end server.
The available SSO mechanisms can differ depending on the system landscape. For more information, see
the following:
○ https://help.sap.com/viewer/p/FIORI_IMPLEMENTATION Security SAP Fiori: Security User
Authentication and Single Sign-On (SSO)
○ https://help.sap.com/viewer/p/SAP_HANA_PLATFORM Security SAP HANA Security Guide for
SAP HANA Platform SAP HANA Authentication and Single Sign-On Single Sign-On Integration
● Area of Responsibility (AOR): Assign an AOR to each user of the app (recommended).
This step is required if you wish to use the Product Hierarchy filter or the Market Hierarchy filter in the app.
If so, each front-end user of the app must have a user in the ABAP back-end system. You assign an AOR to
the ABAP back-end user. The front-end user can then see the assigned hierarchies or nodes in the app.
To assign an AOR, use the Maintain Area of Responsibility service in transaction NWBC. For instructions, see
https://help.sap.com/viewer/p/CARAB Application Help SAP Customer Activity Repository and
search for section Maintain Area of Responsibility.
● App Extensibility: Extend the app with custom content.
For information on the available extension points and controller hooks, see the SAP Fiori apps reference
library at https://fioriappslibrary.hana.ondemand.com/sap/fix/externalViewer/index.html?appId=F1773A.
Choose IMPLEMENTATION INFORMATION, select the delivery, and consult the information under
Extensibility.
● Set up the other demand planning apps: To best support your forecast-related processes, also set up
Adjust Forecast and Manage Demand Influencing Factors.
For more information, see Set Up the Adjust Forecast App [page 125] and Set Up the Manage Demand
Influencing Factors App [page 130].

Result

You have successfully set up the Analyze Forecast app.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
124 PUBLIC Set Up the Applications
6.1.2.7.2 Set Up the Adjust Forecast App

Perform several tasks on the front-end server and the back-end server to set up the Adjust Forecast app.

Prerequisites

● You have checked that the prerequisites described in Set Up SAP Fiori Apps for SAP Customer Activity
Repository [page 116] are fulfilled.
● You are aware of the implementation information for the app in the SAP Fiori apps reference library: For the
latest delivery (latest wave), see: https://fioriappslibrary.hana.ondemand.com/sap/fix/externalViewer/
index.html?appId=F3479
You have set up the SAP Fiori app Analyze Forecast, as described in Set Up the Analyze Forecast App [page
118].

Procedure

To set up Adjust Forecast, follow these steps:

 Tip

If you encounter issues during the setup, see the Troubleshooting [page 166] section for possible solutions.

1. To prepare the setup, read the app-specific information on SAP Help Portal at https://help.sap.com/
viewer/p/CARAB <Version> Application Help SAP Customer Activity Repository SAP Fiori for SAP
Customer Activity Repository Standalone SAP Fiori Apps for SAP Customer Activity Repository Adjust
Forecast .
2. Customize the navigation target for the app in the SAP Fiori launchpad on the front-end server.
In Launchpad Customizing (transaction LPD_CUST), choose UIDPL001 TRANSACTIONAL Demand
Planning Apps and make the app-specific settings for all of the apps:
Application Settings for Adjust Forecast
○ Link Text: AdjustForecast
○ Application Type: URL
○ URL: /sap/bc/ui5_ui5/sap/adjustforecast
○ Application Alias: AdjustForecast
○ Additional Information: SAPUI5.Component=retail.dpl.adjustforecast
○ Portal Parameters: Leave the default settings.
○ Switch Support: Leave the default settings.
Application Settings for Forecast Correction Overlapping Rules
○ Link Text: Forecast Correction Overlapping Rules
○ Application Type: TRA Transaction
○ Transaction Code: /DMF/FCC_MAINT_RULES
○ System Alias: Enter the HTTP connection to the back-end client in the format SYSID_CLNT_HTTPS

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 125
 ○ Application Alias: ForecastCorrOverlapRules
○ GUI Type: WEB_GUI_SAP GUI for HTML
○ Entries Once Started: S Initial Screen
○ Portal Parameters: Leave the default settings.
○ Switch Support: Leave the default settings.
Application Settings for Forecast Correction Classification
○ Link Text: Forecast Correction Classification
○ Application Type: TRA Transaction
○ Transaction Code: /DMF/FCC_MAINT_CLSCF
○ System Alias: Enter the HTTP connection to the back-end client in the format SYSID_CLNT_HTTPS
○ Application Alias: ForecastCorrClassification
○ GUI Type: WEB_GUI_SAP GUI for HTML
○ Entries Once Started: S Initial Screen
○ Portal Parameters: Leave the default settings.
○ Switch Support: Leave the default settings.
If you need more information about navigation targets, see SAP Help Portal at https://help.sap.com/
viewer/p/SAP_NETWEAVER and choose your SAP NetWeaver Platform. Select your support package
stack at the top right and search for “Customizing Navigation Targets in LPD_CUST”.
3. Configure the SAP Fiori launchpad designer for CAR Demand Planning Apps.
1. Launch the SAP Fiori launchpad designer either in the CUST or in the CONF mode:
○ CUST mode:
Use this mode for client-specific configurations, specifying the respective client. For the CUST
mode, use this URL:
https://<server>:<port>/sap/bc/ui5_ui5/sap/arsrvc_upb_admn/main.html?sap-
client=<client>#/Catalog/X-SAP-UI2-CATALOGPAGE:SAP_DPL_TC_T
○ CONF mode:
Use this mode for global configurations across all clients. Note that in this URL, you additionally
specify the scope parameter.
For the CONF mode, use this URL:
https://<server>:<port>/sap/bc/ui5_ui5/sap/arsrvc_upb_admn/main.html?sap-
client=<client>&scope=CONF#/Catalog/X-SAP-UI2-CATALOGPAGE:SAP_DPL_TC_T
Use this mode for global configurations across all clients. Note that in this URL, you additionally
specify the scope parameter.
2. Configure the app tile in the SAP Fiori launchpad designer.

 Note

By default, the tiles for Adjust Forecast, Analyze Forecast, Forecast Correction Classification, and
Forecast Correction Overlapping Rules are in the SAP: CAR – Deman Planning Apps catalog (which
is shipped with launchpad configuration).

If the app tiles have not yet been created, create them as static tiles using the following settings:
Adjust Forecast
○ Title: Adjust Forecast
○ Icon: sap-icon://Fiori5/F0819
○ Use semantic object navigation: Select this option.
○ Semantic Object: ForecastDemand

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
126 PUBLIC Set Up the Applications
 ○ Action: editUDFAdjustForecast
○ Leave the other options empty.
Forecast Correction Classification
○ Title: Forecast Correction Classification
○ Icon: sap-icon://group-2
○ Information: /DMF/FCC_MAINT_CLSCF
○ Use semantic object navigation: Select this option.
○ Semantic Object: DemandPlanConfiguration
○ Action: create
○ Leave the other options empty.
Forecast Correction Overlapping Rules
○ Title: Forecast Correction Overlapping Rules
○ Icon: sap-icon://Fiori2/F0306
○ Information: /DMF/FCC_MAINT_RULES
○ Use semantic object navigation: Select this option.
○ Semantic Object: DemandPlanConfiguration
○ Action: manage
○ Leave the other options empty.
If you need more information about configuring tiles, see SAP Help Portal at https://help.sap.com/
viewer/p/SAP_NETWEAVER and choose your SAP NetWeaver Platform. Select your support package
stack at the top right and search for “Static App Launcher Tiles”.
3. Configure the target mapping in the SAP Fiori launchpad designer.
If the target mapping has not yet been created, choose Target Mappings and create entries with the
following settings:
Adjust Forecast
○ Semantic Object: ForecastDemand
○ Action: editUDFAdjustForecast
○ Application Type: SAP Fiori App using LPD_CUST
○ Launchpad Role: UIDPL001
○ Launchpad Instance: TRANSACTIONAL
○ Application Alias: AdjustForecast
○ Device Types: Select Desktop and Tablet.
○ Allow additional parameters: Select this option.
Forecast Correction Classification
○ Semantic Object: DemandPlanConfiguration
○ Action: create
○ Application Type: SAP Fiori App using LPD_CUST
○ Launchpad Role: UIDPL001
○ Launchpad Instance: TRANSACTIONAL
○ Application Alias: ForecastCorrClassification
○ Information: /DMF/FCC_MAINT_CLSCF
○ Device Types: Select Desktop and Tablet.
○ Allow additional parameters: Select this option.
Forecast Correction Overlapping Rules

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 127
 ○ Semantic Object: DemandPlanConfiguration
○ Action: manage
○ Application Type: SAP Fiori App using LPD_CUST
○ Launchpad Role: UIDPL001
○ Launchpad Instance: TRANSACTIONAL
○ Application Alias: ForecastCorrOverlapRules
○ Information: /DMF/FCC_MAINT_RULES
○ Device Types: Select Desktop and Tablet.
○ Allow additional parameters: Select this option.
If you need more information about configuring target mappings, see SAP Help Portal at https://
help.sap.com/viewer/p/SAP_NETWEAVER and choose your SAP NetWeaver Platform. Select your
support package stack at the top right and search for “Configuring Target Mappings”.
4. Complete the implementation on the front-end server.

 Note

You can find the general SAP Fiori Help section for this step at https://help.sap.com/viewer/p/
FIORI_IMPLEMENTATION Version: SAP NW 7.40 Implementation App Implementation App
Implementation for Analytical Apps Implementation Tasks on Front-End Server .

Use this section as your starting point. However, to configure Adjust Forecast, you only need to perform
a subset of the steps described there. Proceed as follows:

1. Check that the app-specific Internet Communication Framework (ICF) service

AdjustForecast /sap/bc/ui5_ui5/sap/adjustforecast is active. If the service is not active,
activate it as follows:
1. Execute transaction SICF.
2. As Service Path, specify the <service path/service name> and execute the search.
3. As Virtual Hosts / Services, select the ADJUSTFORECAST entry and choose Service/Host
Activate .
For more information on how to activate ICF services and OData services, see Implementation Tasks
on Front-End Server Front-End Server: Activate ICF Services of SAPUI5 Application .
2. Activate and Maintain OData Services
Call up transaction Activate and Maintain Services (/IWFND/MAINT_SERVICE) and check if the
following services are already existing in your service catalog:
○ Adjust Forecast OData Service
○ Type: BEP
○ Technical Service Name: ZOD_ADJUST_FORECAST_SRV
○ Service Description: DPL Fiori Adjust Forecast App OData Service
○ External Service Name: OD_ADJUST_FORECAST_SRV
○ Namespace: /DPL/
If the service is not available, choose Add Service, enter back-end system alias, and choose Get
Services. Search for /DPL/OD_ADJUST_FORECAST_SRV, select the entry and choose Add Selected
Services. Take over the provided data and enter the local package assignment.
○ Time Series OData Service
○ Type: BEP

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
128 PUBLIC Set Up the Applications
 ○ Technical Service Name: ZOD_FC_TIME_SERIES_VIZ_SRV
○ Service Description: OData Srv. for Forecast-Related Time Series Visualization
○ External Service Name: OD_FC_TIME_SERIES_VIZ_SRV
○ Namespace: /DMF/
If the service is not available, choose Add Service, enter back-end system alias, and choose Get
Services. Search for /DMF/OD_FC_TIME_SERIES_VIZ_SRV, select the entry and choose Add
Selected Services. Take over the provided data and enter the local package assignment.
○ Demand Plan OData Service for Reuse
○ Type: BEP
○ Technical Service Name: ZDEMAND_PLAN_UTILITIES_SRV
○ Service Description: Demand Plan OData Service for Reuse
○ External Service Name: DEMAND_PLAN_UTILITIES_SRV
○ Namespace: /DMF/
If the service is not available, choose Add Service, enter back-end system alias, and choose Get
Services. Search for /DMF/DEMAND_PLAN_UTILITIES_SRV, select the entry and choose Add
Selected Services. Take over the provided data and enter the local package assignment.
3. Copy the SAP_DPL_TCR_T PFCG role on the front-end server and enter a name from the customer
namespace. Assign the required launchpad catalogs and groups. SAP_DPL_TCR_T is the front-end
server authorization role delivered for all demand planning apps in SAP Customer Activity Repository.

 Tip

If you already have an SAP Fiori launchpad open, clear your browser cache to apply the
modifications to your user roles. Otherwise, you cannot see the changes on the user interface.

Follow the steps in Implementation Tasks on Front-End Server Create PFCG Role on Front-End and
Assign Launchpad Catalogs and Groups .
4. Set up the catalogs, groups, and roles in the SAP Fiori launchpad.
Follow the steps in Implementation Tasks on Front-End Server Setup of Catalogs, Groups, and Roles
in the SAP Fiori Launchpad .
5. Take the front-end PFCG role that you created before and assign it to the users of the app. The role
contains the catalogs, groups, and start authorizations for the OData service that the users need.
Follow the steps in Implementation Tasks on Front-End Server Front-End Server: Assign Roles to
Users .
5. Complete the implementation on the back-end server.
Copy the role /DMF/DPL in the Role Maintenance (PFCG) of the back-end server and enter a name from the
customer namespace. /DMF/DPL is the back-end server authorization role. It is also required for accessing
the Adjust Forecast app via forward navigation from the Analyze Forecast app in SAP Customer Activity
Repository.
6. (Optional) Assign area of responsibility.
This step is only required if you wish to use the Product Hierarchy filter in the app. In this case, each user of
the app must have an area of responsibility (AOR) assigned to their ABAP back-end user. This assignment
enables the display of product hierarchies in the app. You assign AORs using the Maintain Area of
Responsibility Web Dynpro service in DDF.
Follow the steps in the Maintain Area of Responsibility section under https://help.sap.com/viewer/p/
CARAB <Version> Application Help SAP Customer Activity Repository Demand Data Foundation
General Services Maintenance Services .

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 129
7. (Optional) Set up Single Sign-On (SSO) between the front-end server and the back-end server.
For information on available SSO mechanisms depending on your system landscape, see the following:
○ https://help.sap.com/viewer/p/FIORI_IMPLEMENTATION <Version> SAP Fiori: Security User
Authentication and Single Sign-On (SSO)
○ https://help.sap.com/viewer/p/SAP_HANA_PLATFORM <Version> Security SAP HANA Security
Guide SAP HANA Authentication and Single Sign-On Single Sign-On Integration

Result

You have successfully set up the Adjust Forecast app.

 Note

In a next step, you define the overlapping rules for percentage, additive, and absolute corrections.

For more information, see section Settings for Forecast Corrections in the application help for SAP
Customer Activity Repository on SAP Help Portal at https://help.sap.com/viewer/p/CARAB.

Related Information

Activate OData Services [page 97]

6.1.2.7.3 Set Up the Manage Demand Influencing Factors

App

Perform several tasks on the front-end server and the back-end server to set up the Manage Demand
Influencing Factors app.

Prerequisites

● You have checked that the prerequisites described in Set Up SAP Fiori Apps for SAP Customer Activity
Repository [page 116] are fulfilled.
● You are aware of the implementation information for the app in the SAP Fiori apps reference library: For the
latest delivery (latest wave), see: https://fioriappslibrary.hana.ondemand.com/sap/fix/externalViewer/
index.html?appId=F3885

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
130 PUBLIC Set Up the Applications
Procedure

To set up Manage Demand Influencing Factors, follow these steps:

 Tip

If you encounter issues during the setup, see the Troubleshooting [page 166] section for possible solutions.

1. To prepare the setup, read the app-specific information on SAP Help Portal at https://help.sap.com/
viewer/p/CARAB <Version> Application Help SAP Customer Activity Repository SAP Fiori for SAP
Customer Activity Repository Standalone SAP Fiori Apps for SAP Customer Activity Repository Manage
Demand Influencing Factors .
2. Customize the navigation target for the app in the SAP Fiori launchpad on the front-end server.
In Launchpad Customizing (transaction LPD_CUST), choose UIDPL001 TRANSACTIONAL Demand
Planning Apps and make the app-specific settings for all of the apps:
Application Settings for Manage Demand Influencing Factors
○ Link Text: Manage Demand Influencing Factors
○ Application Type: URL
○ URL: /sap/bc/ui5_ui5/sap/managedifs
○ Application Alias: DIFManagement
○ Additional Information: SAPUI5.Component=retail.dpl.managedif
○ Portal Parameters: Leave the default settings.
○ Switch Support: Leave the default settings.
Application Settings for Demand Influencing Factors Library
○ Link Text: Demand Influencing Factors Library
○ Application Type: TRA Transaction
○ Transaction Code: /DMF/DIF_LIBRARY
○ System Alias: Enter the HTTP connection to the back-end client in the format SYSID_CLNT_HTTPS
○ Application Alias: DIFLibrary
○ GUI Type: WEB_GUI_SAP GUI for HTML
○ Entries Once Started: S Initial Screen
○ Portal Parameters: Leave the default settings.
○ Switch Support: Leave the default settings.
If you need more information about navigation targets, see SAP Help Portal at https://help.sap.com/
viewer/p/SAP_NETWEAVER and choose your SAP NetWeaver Platform. Select your support package
stack at the top right and search for “Customizing Navigation Targets in LPD_CUST”.
3. Configure the SAP Fiori launchpad designer for CAR Demand Planning Apps.
1. Launch the SAP Fiori launchpad designer either in the CUST or in the CONF mode:
○ CUST mode:
Use this mode for client-specific configurations, specifying the respective client. For the CUST
mode, use this URL:
https://<server>:<port>/sap/bc/ui5_ui5/sap/arsrvc_upb_admn/main.html?sap-
client=<client>#/Catalog/X-SAP-UI2-CATALOGPAGE:SAP_DPL_TC_T
○ CONF mode:
Use this mode for global configurations across all clients. Note that in this URL, you additionally
specify the scope parameter.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 131
 For the CONF mode, use this URL:
https://<server>:<port>/sap/bc/ui5_ui5/sap/arsrvc_upb_admn/main.html?sap-
client=<client>&scope=CONF#/Catalog/X-SAP-UI2-CATALOGPAGE:SAP_DPL_TC_T
Use this mode for global configurations across all clients. Note that in this URL, you additionally
specify the scope parameter.
2. Configure the app tiles in the SAP Fiori launchpad designer.

 Tip

By default, the tiles for Manage Demand Influencing Factors and Demand Influencing Factors
Library are in the SAP: CAR – Demand Planning Apps catalog (which is shipped with launchpad
configuration).

If the app tile for Manage Demand Influencing Factors has not yet been created, create it as static tile
using the following settings:
Manage Demand Influencing Factors
○ Title: Manage Demand Influencing Factors
○ Icon: sap-icon://create-entry-time
○ Use semantic object navigation: Select this option.
○ Semantic Object: ForecastDemand
○ Action: manage
○ Leave the other options empty.
Demand Influencing Factors Library
○ Title: Demand Influencing Factors Library
○ Icon: sap-icon://FioriInAppIcons/Hierarchical Tree
○ Information: /DMF/DIF_LIBRARY
○ Use semantic object navigation: Select this option.
○ Semantic Object: ForecastDemand
○ Action: change
○ Leave the other options empty.
If you need more information about configuring tiles, see SAP Help Portal at https://help.sap.com/
viewer/p/SAP_NETWEAVER and choose your SAP NetWeaver Platform. Select your support package
stack at the top right and search for “Static App Launcher Tiles”.
3. Configure the target mapping in the SAP Fiori launchpad designer.
If the target mapping has not yet been created, choose Target Mappings and create entries with the
following settings:
Manage Demand Influencing Factors
○ Semantic Object: ForecastDemand
○ Action: manage
○ Application Type: SAP Fiori App using LPD_CUST
○ Launchpad Role: UIDPL001
○ Launchpad Instance: TRANSACTIONAL
○ Application Alias: DIFManagement
○ Device Types: Select Desktop and Tablet.
○ Allow additional parameters: Select this option.
Demand Influencing Factors Library
○ Semantic Object: ForecastDemand

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
132 PUBLIC Set Up the Applications
 ○ Action: change
○ Application Type: SAP Fiori App using LPD_CUST
○ Launchpad Role: UIDPL001
○ Launchpad Instance: TRANSACTIONAL
○ Application Alias: DIFLibrary
○ Device Types: Select Desktop
○ Allow additional parameters: Select this option.
If you need more information about configuring target mappings, see SAP Help Portal at https://
help.sap.com/viewer/p/SAP_NETWEAVER and choose your SAP NetWeaver Platform. Select your
support package stack at the top right and search for “Configuring Target Mappings”.
4. Complete the implementation on the front-end server.

 Note

You can find the general SAP Fiori Help section for this step at https://help.sap.com/viewer/p/
FIORI_IMPLEMENTATION Version: SAP NW 7.40 Implementation App Implementation App
Implementation for Analytical Apps Implementation Tasks on Front-End Server .

Use this section as your starting point. However, to configure Manage Demand Influencing Factors, you
only need to perform a subset of the steps described there. Proceed as follows:

1. Check that the app-specific Internet Communication Framework (ICF) service Manage Demand
Influencing Factors /sap/bc/ui5_ui5/sap/managedifs is active. If the service is not active,
execute these steps:
1. Execute transaction SICF.
2. As Service Path, specify the <service path/service name> and execute the search.
3. As Virtual Hosts / Services, select the MANAGEDIFS entry and choose Service/Host
Activate .
For more information on how to activate ICF services and OData services, see Implementation Tasks
on Front-End Server Front-End Server: Activate ICF Services of SAPUI5 Application .
2. Activate and Maintain OData Services
Call up transaction Activate and Maintain Services (/IWFND/MAINT_SERVICE) and check if the
following services are already existing in your service catalog:
○ Demand Plan OData Service
○ Type: BEP
○ Technical Service Name: ZOD_DEMAND_PLAN_SRV
○ Service Description: Demand Plan OData Service
○ External Service Name: OD_DEMAND_PLAN_SRV
○ Namespace: /DMF/
If the service is not available, choose Add Service, enter back-end system alias, and choose Get
Services. Search for /DMF/OD_DEMAND_PLAN_SRV , select the entry and choose Add Selected
Services. Take over the provided data and enter the local package assignment.
○ Demand Plan OData Service for Reuse
○ Type: BEP
○ Technical Service Name: ZDEMAND_PLAN_UTILITIES_SRV
○ Service Description: Demand Plan OData Service for Reuse

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 133
 ○ External Service Name: DEMAND_PLAN_UTILITIES_SRV
○ Namespace: /DMF/
If the service is not available, choose Add Service, enter back-end system alias, and choose Get
Services. Search for /DMF/DEMAND_PLAN_UTILITIES_SRV, select the entry and choose Add
Selected Services. Take over the provided data and enter the local package assignment.
3. Copy the SAP_DPL_TCR_T PFCG role on the front-end server and enter a name from the customer
namespace. Assign the required launchpad catalogs and groups. SAP_DPL_TCR_T is the front-end
server authorization role delivered for all demand planning apps in SAP Customer Activity Repository.

 Tip

If you already have an SAP Fiori launchpad open, clear your browser cache to apply the
modifications to your user roles. Otherwise, you cannot see the changes on the user interface.

Follow the steps in Implementation Tasks on Front-End Server Create PFCG Role on Front-End and
Assign Launchpad Catalogs and Groups .
4. Set up the catalogs, groups, and roles in the SAP Fiori launchpad.
Follow the steps in Implementation Tasks on Front-End Server Setup of Catalogs, Groups, and Roles
in the SAP Fiori Launchpad .
5. Take the front-end PFCG role that you created before and assign it to the users of the app. The role
contains the catalogs, groups, and start authorizations for the OData service that the users need.
Follow the steps in Implementation Tasks on Front-End Server Front-End Server: Assign Roles to
Users .
5. Complete the implementation on the back-end server.
Copy the Demand Planner (Retail) role (/DMF/DPL) in the Role Maintenance (PFCG) of the back-end server
and enter a name from the customer namespace. Assign the users. This role /DMF/DPL is the back-end
server authorization role delivered for accessing the Manage Demand Influencing Factors app.
6. (Optional) Assign area of responsibility.
This step is only required if you wish to use the Product Hierarchy filter in the app. In this case, each user of
the app must have an area of responsibility (AOR) assigned to their ABAP back-end user. This assignment
enables the display of product hierarchies in the app. You assign AORs using the Maintain Area of
Responsibility Web Dynpro service in DDF.
Follow the steps in the Maintain Area of Responsibility section under https://help.sap.com/viewer/p/
CARAB <Version> Application Help SAP Customer Activity Repository Demand Data Foundation
General Services Maintenance Services .
7. (Optional) Set up Single Sign-On (SSO) between the front-end server and the back-end server.
For information on available SSO mechanisms depending on your system landscape, see the following:
○ https://help.sap.com/viewer/p/FIORI_IMPLEMENTATION <Version> SAP Fiori: Security User
Authentication and Single Sign-On (SSO)
○ https://help.sap.com/viewer/p/SAP_HANA_PLATFORM <Version> Security SAP HANA Security
Guide SAP HANA Authentication and Single Sign-On Single Sign-On Integration

Result

You have successfully set up the Manage Demand Influencing Factors app.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
134 PUBLIC Set Up the Applications
Related Information

Activate OData Services [page 97]

6.1.2.7.4 DDF Apps: Assign Roles, Catalogs, and Groups in

SAP Fiori Launchpad

Perform this procedure to set up the SAP Fiori apps provided by Demand Data Foundation (Configure
Distribution Curves, Manage Location Clusters, Manage Product Attributes, Manage Product Groups, Manage
Promotional Offers). All of these apps are available to you as part of SAP Customer Activity Repository. They
support different scenarios and consuming applications.

Context

For an up-to-date overview of the DDF apps, see SAP Help Portal at https://help.sap.com/viewer/p/CARAB and
choose Additional Information SAP Fiori Apps for SAP CARAB .

Different Scenarios for the DDF Apps

● You can use the apps standalone, that is, to support generic scenarios. In this case, perform the procedure
below.
● Or you can integrate the apps with consuming applications installed on top of SAP Customer Activity
Repository. In this case, perform the procedure in Assign Roles, Catalogs, and Groups in SAP Fiori
Launchpad [page 256].

Procedure

To be able to access the DDF apps from the SAP Fiori launchpad, your front-end system user must have the
necessary roles assigned. Based on the roles assigned to your user, you can then access certain business
catalogs and business catalog groups for the apps.

1. Log on to your front-end system.

2. Execute transaction SU01 to open the User Maintenance screen.
3. Enter your front-end user name in the User field and choose Change.
4. On the Roles tab, assign the Demand Data Foundation Administrator (SAP_ISR_BR_DDF_ADMIN) role to
your user.
5. Save your changes.

 Tip

If you already have an SAP Fiori launchpad open, clear your browser cache to see the changes.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 135
6.1.2.7.5 Set Up the Manage Product Attributes App

Perform several tasks on the front-end server and the back-end server to set up the transactional app Manage
Product Attributes. This is one of the Demand Data Foundation (DDF) apps included in SAP Customer Activity
Repository.

Context

The Manage Product Attributes app supports different scenarios and consuming applications (such as SAP
Allocation Management, SAP Assortment Planning, the similar products search, or the calculation of
distribution curves). The app enables planning administrators to create, configure, assign, and maintain
product attributes for a selected product hierarchy.

Prerequisites

● You are aware of the technical implementation information for the app in the SAP Fiori apps reference
library:
For the latest delivery (latest wave), see: https://fioriappslibrary.hana.ondemand.com/sap/fix/
externalViewer/index.html?appId=F0829A
● You have performed all setup tasks under Core (Mandatory for All Applications) in this guide.
● You have checked whether there are any corrections for the app in the current release:
See section Implement SAP Notes for the Installation [page 26]. Implement any corrections relevant for
the app.
● You have done the general setup for the DDF apps. See DDF Apps: Assign Roles, Catalogs, and Groups in
SAP Fiori Launchpad [page 135].

 Note

To set up the app, do the steps in the following sections.

If your scenario includes SAP Allocation Management or SAP Assortment Planning, some steps might
already have been performed in your system landscape. If so, skip the step and continue with the next one.

Activate ICF Services

Context
For security reasons, the Internet Communication Framework (ICF) services are delivered in an inactive state.
You must activate the services that are required for the app.

Procedure
1. Log on to your front-end server.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
136 PUBLIC Set Up the Applications
 2. Execute transaction SICF.
3. In the Define Services screen, make the following selections:
○ Hierarchy Type: SERVICE
○ Virtual Host: DEFAULT_HOST
○ Service Path: /sap/bc/ui5_ui5/sap/attribmgmt_v2/
4. Choose Execute ( F8 ).
5. Under Virtual Hosts / Services, double-click the attribmgmt_v2/ service to open the Create/Change a
Service screen.
6. To activate a service, choose Service/Host Activate .

 Note

You can check the activation status by selecting the service and opening the context menu. If the
Activate Service option is grayed out, this means the service is already active.

7. Repeat steps 3 to 6, this time using /sap/bc/ui5_ui5/sap/ddfreuse_v2/ as the service path.

Activate OData Services

1. See section Activate OData Services [page 97] and consult the table for SAP Customer Activity Repository.
2. Make sure that all mandatory OData services for the app are active.

Enable the App for SAP Fiori Launchpad

Context
To be able to access the app from the SAP Fiori launchpad, your front-end system user must have the
necessary role(s) assigned. This allows you to access the business catalogs and business catalog groups
required for the app.

The app requires the following business role: Demand Data Foundation Administrator
(SAP_ISR_BR_DDF_ADMIN)

 Note

Should you wish to use the app for SAP Allocation Management or SAP Assortment Planning, use the
Planning Administrator (SAP_RAP_BCR_PLANNING_ADMIN) business role instead.

Procedure
1. Log on to your front-end system.
2. Execute transaction SU01 to open the User Maintenance screen.
3. Enter your front-end user name in the User field and choose Change.
4. On the Roles tab, assign the Demand Data Foundation Administrator (SAP_ISR_BR_DDF_ADMIN) role to
your user.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 137
5. Save your changes.

 Tip

If you already have an SAP Fiori launchpad open, clear your browser cache or you won't be able to see
the changes.

6. Verify role settings for SAP Fiori launchpad.

1. Execute transaction LPD_CUST to open the Overview of Launchpads.
2. Double-click the role UIRAP001 to view the role details.
3. Expand the role Planning Administrator and select the Manage Product Attributes app.
4. Display the advanced parameters and check that the app has all the mandatory settings listed below.
You do not need to make any additional settings.
○ Link Text: Manage Product Attributes
○ Application Type: URL
○ URL: /sap/bc/ui5_ui5/sap/attribmgmt_v2
○ Application Alias: AssignProductAttribute
○ Additional Information: SAPUI5.Component=retail.ddf.attributemgmtv2
○ Navigation Mode: EXT_HEAD Leaderless Portal Window
○ History Mode: 1 Navigation Entry can Occur Once in History
○ Parameter Forwarding: G Get Parameters
If you have updated any settings, save your changes.

Assign Area of Responsibility (AOR) to ABAP Back-End User

You can only display and select product hierarchies in the app that have been assigned as AOR to your ABAP
back-end user.

1. Log on to your ABAP back-end system.

2. Execute transaction NWBC to open the SAP NetWeaver Business Client.
3. Choose Services Maintain Area of Responsibility Product Hierarchy .
4. Select your ABAP back-end user, choose Continue, and define the AOR.
For instructions, see the application help for SAP Customer Activity Repository at https://help.sap.com/
viewer/p/CARAB. Search for section Maintain Area of Responsibility and follow the instructions.

6.1.2.8 Configure Omnichannel Article Availability and

Sourcing for Use with SAP Customer Activity
Repository

You need to integrate SAP S/4HANA or SAP Retail, SAP Customer Activity Repository, SAP Commerce, and
SAP Commerce, integration package for SAP for Retail, as well as set up asynchronous order management and
the data replication between SAP S/4HANA or SAP Retail, SAP Commerce, and SAP Customer Activity
Repository.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
138 PUBLIC Set Up the Applications
6.1.2.8.1 Set up Data Replication Between SAP S/4HANA
or SAP Retail, and SAP Commerce

In SAP S/4HANA or SAP Retail, and SAP Commerce, set up the asynchronous order management scenario
as follows:

1. Set up asynchronous replication of articles via the Data Hub from SAP S/4HANA or SAP Retail to SAP
Commerce.
For more information, see the documentation for SAP Commerce at https://help.sap.com/viewer/
50c996852b32456c96d3161a95544cdb/latest/en-US/8bc6b884866910148532f2e1e500f95f.html
Getting Started with SAP S/4HANA or SAP ERP Integration. Follow the steps for the asynchronous order
management scenario.
2. Set up asynchronous replication of orders via the Data Hub from SAP Commerce to SAP S/4HANA or
SAP Retail (see link above).
3. Configure asynchronous order management.
For more information, see the documentation for SAP Commerce at https://help.sap.com/viewer/
50c996852b32456c96d3161a95544cdb/latest/en-US/e2be57a501da41cc9ebdf7cf7d3aa229.html
Configuring Order Management for SAP Commerce with One or More SAP Back Ends.

6.1.2.8.2 Set Up Data Replication Between SAP Commerce

and SAP Customer Activity Repository

1. In SAP Commerce, in the Backoffice application under SAP Integration HTTP Destination , create the
HTTP destination of SAP Customer Activity Repository that is used for availability calculation and sourcing.
2. In SAP Commerce, in the Backoffice application under SAP Integration SAP Global Configuration
Backend Connectivity , enter the HTTP destination of SAP Customer Activity Repository created before.

 Note

In the standard Solr configuration for products in SAP Commerce, ProductStoreStockValueProvider

is used to replicate the store availability situation from the SAP Commerce database into the Solr index.

If you use OAA, availability information is provided through synchronous calls into SAP Customer Activity
Repository for every article/store combination instead. If your product catalog is rather large, this is why
indexing the complete product catalog can take very long. In this case, we recommend to either deactivate
the value provider or to create a custom one. If you deactivate the value provider, faceted search according
to store availability is not possible in the product catalog. OAA functionality is not affected.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 139
6.1.2.8.3 Set Up Live Connection Between SAP Customer
Activity Repository and SAP Analytics Cloud

This step is optional. You only need to execute it if you want to use the set of OAA analyses that has been
predefined in SAP Analytics Cloud and that is part of the standard delivery of SAP Analytics Cloud. If you are
using a different analytics tool, or if you do not run analytics at all, you may skip this step.

Context

Procedure

1. Configure SAP Customer Activity Repository to support cross-origin resource sharing (CORS), for cross-
domain communication from the browser.

For more information, see Live Data Connection to SAP BW Using a Direct Connection and Password
Authentication, steps 1 and 2 of the procedure.

2. In SAP Analytics Cloud, navigate to Home Connection and select live connection SAPRTOAA (SAP
Retail Omnichannel Article Availability and Sourcing). This connection is part of the standard delivery.
3. Click Edit Connection and enter your custom details for Host, HTTPS Port, and Client.

6.1.2.8.4 Activate OData Services for Omnichannel Article

Availability and Sourcing

A number of OData services are required to run the SAP Fiori apps for omnichannel article availability and
sourcing (OAA).

Context

Make sure that you have activated the OData services required for OAA, as described and listed in Activate
OData Services [page 97]. Depending on your back end, different services are required.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
140 PUBLIC Set Up the Applications
6.1.2.8.5 Trigger Initial Full Run of ATP Snapshot
Replication (SAP S/4HANA 1909 Only, Sales
Channel Mode Only)

Sales channel mode only; SAP S/4HANA 1909 only: With SAP Customer Activity Repository 4.0 FPS02, the
delta mode of the ATP snapshot replication was changed.

Context

The delta mode of the ATP snapshot replication works correctly only after an initial full run of the replication.

Trigger a full run of report /OAA/ATP_SNP_CALC (Generation and Replication of ATP Snapshot).

6.1.2.9 Configure Omnichannel Promotion Pricing for Use

with SAP Customer Activity Repository

To use omnichannel promotion pricing, you have to activate the functionality in Customizing and configure it
according to your specific needs.

 Tip

For more information about the configuration of the promotion pricing service in SAP Commerce, see the
Administrator Guide of SAP Commerce, integration package for SAP for Retail on SAP Help Portal under
https://help.sap.com/viewer/p/IPR <Version> Administration Omnichannel Promotion Pricing
Configuration .

Related Information

Activate Omnichannel Promotion Pricing (OPP) [page 142]

Activate the Data Replication Framework (DRF) [page 144]
Configure the Transformation of Offers into OPP Promotions [page 142]
Configure the Local Deployment of the Promotion Pricing Service [page 143]
Configure the Central Deployment of the Promotion Pricing Service [page 157]
Update the PPS SAP HANA XSA Application

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 141
6.1.2.9.1 Activate Omnichannel Promotion Pricing (OPP)

To use omnichannel promotion pricing for the calculation of the effective sales price, you have to activate the
functionality.

In Customizing for SAP Customer Activity Repository, choose Omnichannel Promotion Pricing Configure
Omnichannel Promotion Pricing Activate OPP .

6.1.2.9.2 Configure the Transformation of Offers into OPP

Promotions

Related Information

Enforce the Compatibility to Transform Offers into OPP Promotions [page 142]
Enable Offers with Enhanced Product Groups [page 142]
Enable Offers with Zero Discount [page 143]

6.1.2.9.2.1 Enforce the Compatibility to Transform Offers into

OPP Promotions

To transform offers into OPP promotions, it is recommended to enforce the compatibility to make sure that an
offer can only be set to an operative status, for example Approved, if the transformation into an OPP promotion
was successful.

In Customizing for SAP Customer Activity Repository under Omnichannel Promotion Pricing (OPP)
Configure Omnichannel Promotion Pricing Enforce Compatibility .

6.1.2.9.2.2 Enable Offers with Enhanced Product Groups

If you want to include or exclude product groups from your offers or use them in mix-and-match offers, you
have to enable enhanced product groups.

In Customizing for SAP Customer Activity Repository under Omnichannel Promotion Pricing (OPP)
Configure Omnichannel Promotion Pricing Enable Product Groups .

Additionally, you have to enable product groups for the promotion pricing service. For more information about
the configuration of product groups, see the Development and Extension Guide for OPP on SAP Help Portal at

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
142 PUBLIC Set Up the Applications
https://help.sap.com/viewer/p/CARAB <Version> Development Development and Extension Guide for
Omnichannel Promotion Pricing under Promotion Pricing Service PPS Module calcengine-gk Default
Settings and Properties .

6.1.2.9.2.3 Enable Offers with Zero Discount

By default offers with discount type Everyday Low Price (EDLP) are transformed into OPP promotions like
offers with discount type Regular Price. If a monetary discount of zero should be applied to the previous price,
you can enable the discount type Zero Discount. In this case, a retail price modifier is returned in the calculation
response, but the previous price does not change.

You can enable this discount type in Customizing for SAP Customer Activity Repository under Omnichannel
Promotion Pricing (OPP) Configure Omnichannel Promotion Pricing Enable Zero Discount .

6.1.2.9.3 Configure the Local Deployment of the Promotion

Pricing Service

For a local deployment scenario, you have to replicate regular prices and OPP promotions from the central
price and promotion repository (SAP Customer Activity Repository) to an external system to create a local
storage for prices and promotions. This replication can be done via IDocs. For that, you have to configure
application link enabling (ALE) and Data Replication Framework (DRF). For OPP promotions, there are two
options to configure this replication: the promotion-centric outbound processing and the location-specific
outbound processing.

Prerequisites

● You have defined receiving systems and clients in the system landscape directory (SLD).

Procedure

1. Activate OPP functionality as descirbed in Activate Omnichannel Promotion Pricing (OPP) [page 142].
2. Activate DRF functionality, as described in Activate the Data Replication Framework (DRF) [page 144].
3. Define numer ranges, as described in Define Number Ranges [page 144].
4. Configure the Application Link Enabling for the outbound processing of regular prices and OPP promotions
(promotion-centric or location-specific outbound processing):
○ Configure Application Link Enabling for the outbound processing of regular prices and promotion-
centric OPP promotions. [page 144]
○ Configure Application Link Enabling for the location-specific outbound processing of OPP promotions
[page 152]

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 143
5. Configure the Data Replication Framework for the outbound processing of regular prices and OPP
promotions (promotions-centric or location-specific outbound processing):
○ Configure the data replication for the outbound processing of regular prices and OPP promotions
(promotion-centric outbound processing) [page 147]
○ Configure the data replication for OPP promotions (location-specific outbound processing) [page 155]

6.1.2.9.3.1 Activate the Data Replication Framework (DRF)

To send regular prices and OPP promotion to an external system via IDocs, you have to activate the Data
Replication Framework (DRF) functionality.

In transaction SFW5, activate business function DRF_FOUNDATION.

6.1.2.9.3.2 Define Number Ranges

To send OPP promotions to an external system via IDocs, you can define numer ranges to generate unique
identifiers for all promotion-related entities.

In Customizing for SAP Customer Activity Repository, choose Omnichannel Promotion Pricing (OPP)
Define Number Ranges .

6.1.2.9.3.3 Configure the Outbound Processing for Regular

Prices and OPP Promotions

Configuration of the outbound processing of regular prices and promotion-centric OPP promotions.

Application Link Enabling

In Customizing for SAP NetWeaver, under Application Server IDoc Interface / Application Link Enabling
(ALE) , see the system documentation to check the settings for distributing data between application
systems based on Application Link Enabling and IDoc interface technology. With omnichannel promotion
pricing, this functionality is used to distribute OPP promotions and regular prices from SAP Customer Activity
Repository to an external system, for example an SAP Commerce system. You need to perform the following
steps:

Transaction BD54: Defining a Logical System

With ALE IDoc distribution, you can exchange data between logical systems. You use the logical system name
to identify a system uniquely within the network. If you already use ALE IDoc distribution, the logical system for

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
144 PUBLIC Set Up the Applications
the sending system has already been defined. In this case, you only need to define a logical system for the
receiving system. In SAP Customer Activity Repository, do the following:

In Display View "Logical System": Overview, create a new logical system. Enter the following values:

Field Name Value

Log. System <receiving system>

Name <receiving system>

Transaction SM59: Defining an RFC Destination

1. Create the RFC destination in the HTTP Connections to External Server folder and enter the following
values:

Field Name Value

RFC Destination <name of the RFC destination>

Connection Type Enter connection type G HTTP Connection to External

Server.

Description Enter at least Description 1 in the description section.

2. In Technical Settings, enter the following values for Target System Settings:

Field Name Value

Target Host <name of the target host>

Path Prefix /sapppspricing/idocinbound

Port <service number for https or http

connection>

 Note
With OPP, an https connection is recommended.

3. In Logon and Security, select Basic Authentication for Logon with User, and enter the following values:

Field Name Value

User <user name that you have created in SAP

Commerce Backoffice>

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 145
 Field Name Value

Password <password that you have created in SAP

Commerce Backoffice>

In Security Options select SSLActive to send your data via https connection and enter an appropriate
certificate.

 Note

We strongly recommend to use Secure protocols (SSL, SCN) whenever possible.

For more information, see Transport Layer Security and Web Services Security in the SAP NetWeaver
Security Guide.

Transaction WE21: Defining a Port

1. Create this ALE port in the XML HTTP folder and enter the following values:

Field Name Value

Port <name of port>

Description <description of port>

RFC destination <name of the RFC destination created in

the previous step>

2. Select Text/XML for Content Type.

Transaction WE20: Defining a Partner Profile

A partner profile contains parameters that define the electronic interchange of data between systems using the
IDoc interface. There is only one partner profile required for the receiving system and it needs to contain all the
parameters that your scenario requires for sending OPP promotions and regular prices to that receiving
system.

Basic Partner Profile Information

To set up the basic partner profile information, do the following:

1. In Partner Profiles, create a logical system partner. Enter the following values:

Field Name Value

Partner No. <partner number>, which must be the same as the receiving system that you
defined in section Defining a Logical System

Partner Type LS for regular prices and OPP promotions sent via promotion-centric outbound
processing

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
146 PUBLIC Set Up the Applications
 2. In the Post processing: permitted agent tab, enter the following values:

Field Name Value

Ty. US (for User)

Agent <users to be notified> should be an agent who can process IDocs with
errors

Lang. <notification language>

Outbound Parameters

Field Name Value

Message Type ● /ROP/BASE_PRICE for regular prices

● /ROP/PROMOTION for OPP promotions

Outbound Options tab

Receiver port <receiver port> as defined in section Defining a Port

Output Mode ● Pass IDoc Immediately

○ Select this option to transfer IDocs directly after creation for a better integra­
tion to the DRF transfer log.
○ Select this option to make sure that IDocs are sent in the same order in
which they have been created.
● Collect IDocs
○ Select this option to collect IDocs and transfer them sequentially with trans­
action WE14.

IDoc Type ● /ROP/BASE_PRICE01 for regular prices

● Depending on the receiving system /ROP/PROMOTION01 or /ROP/PROMOTION02
for OPP promotions

Cancel Processing After Syntax Ensure that this field is selected to avoid sending erroneous IDocs.
Error

Data Replication Framework

In Customizing for Cross-Application Components under Processes and Tools for Enterprise Applications
Master Data Governance, Central Governance General Settings Data Replication Overall Information ,
see the system documentation to check how data is sent to one or more target systems. With OPP, the Data

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 147
Replication Framework functionality is used to send regular prices and OPP promotions from an SAP Customer
Activity Repository system to external systems. You need to perform the following steps:

Transaction DRFIMG: Defining Custom Settings for Data Replication

In Customizing, you have to perform the following configuration steps under Data Replication Define
Custom Settings for Data Replication :

1. In Customizing activity Define Technical Settings for Business Systems, define a business system and a
logical system for the receiving systems. The following business object types are available to send OPP
promotions and regular prices, and can be assigned to the business system:

Business Object Type Description Communication Channel

ROP_PROMO OPP promotion Replication via IDoc

ROP_PRICE Regular price Replication via IDoc

2. In Customizing activity Define Replication Models, specify the content of the replication model (regular
prices or OPP promotions), the outbound implementation that is to be used, and the business system to
which this object is to be sent. You can specify a different destination system for each outbound
implementation that contains business object, filter object, and business logic. You can also add an
expiration time for the log. The following predefined outbound implementations exist:

Outbound Imple­ Supported Replication

mentation Description Model Filter Object

ROP_PRICE Outbound implementation Initialization, Change, and ROP_PRICE

for regular prices Manual
 Note
For this outbound implementa­
tion, the filter application time
needs to be set to Filter Before
Change Analysis.

ROP_PROMO Outbound implementation Initialization, Change, and ROP_PROMO

for OPP promotions sent Manual
via promotion-centric out­
bound processing

Outbound Parameters

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
148 PUBLIC Set Up the Applications
 The following outbound parameters must be assigned to each replication model:

Outbound Parameter for

Regular Prices Description Typical Value*

/ROP/PACK_SIZE_BULK This parameter sets the maximum number of regular prices that 20,000-100,000
are processed per IDoc. This is an approximate value because
regular prices are assigned to different IDocs for each group of
business unit with items and prices.

 Note
If this parameter is set to 0, restricting regular prices is not
possible and it is only the number of products that deter­
mines the IDoc size.

PACK_SIZE_BULK This parameter controls the number of products for which regu­ 200-1,000
lar prices can be stored in a compressed format at the same
time, and sets the maximum number of products that are proc­
essed per IDoc.

 Note
If this parameter is not set, the default is 1. If you increase
this value, performance at runtime is improved since fewer
IDocs need to be processed.

TASK_SIZE_PROCMSG This parameter is only relevant if you execute the data replication 400-2,000
using parallel processing . This parameter sets the maximum
number of products that are processed per parallel package. It
must be greater or equal to the PACK_SIZE_BULK parameter.

 Note
This parameter value does not define the number of regular
prices per package. If this parameter is set to 0, all products
are processed in one package. This means that parallel proc­
essing is not possible.

/ROP/SEQ_READ_SIZE This parameter sets the maximum number of products for which 100-200
the regular prices are read in one select statement. In this way
you can limit memory consumption for products with a large
number of regular prices.

 Note
If this parameter is set to 0, all products of the correspond­
ing package are read within one call.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 149
 Outbound Parameter for
Regular Prices Description Typical Value*

/ROP/DAY_OFFSET_PAST This parameter is only used, if the selection of prices in the past 30
is restricted with the validity end date as a filter criteria and if the
validity end date is not too far in the past.

During a delta replication, this parameter defines a time range in

days that lies before the date of the last replication run. The sys­
tem subtracts this value from the last replication date and uses
the resulting date to construct the select-option for the validity
end date.

During an initial replication the system calculates a date (current

date minus the time range in days defined in this parameter). If
the date that you entered for the validity end is earlier than the
calculated date, the calculated date is used automatically.

In this way you ensure that also regular prices with a validity end
date in the specified past time range are transferred.

 Note
If this parameter is not set, relevant regular prices might not
be transferred. See SAP Note 2338714 . In this case the
default is set to 30 days.

Outbound Parameter for

OPP Promotions Description Typical Value*

PACK_SIZE_BULK This parameter sets the maximum number of OPP promotions 100-1,000
that are processed per IDoc. It must be smaller than the
TASK_SIZE_PROCMSG parameter and is relevant for both, the se­
quential and the parallel execution of DRF outbound.

 Note
If this parameter is not set, the default is 1. If you increase
this value, performance at runtime is improved since fewer
IDocs need to be processed.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
150 PUBLIC Set Up the Applications
 Outbound Parameter for
OPP Promotions Description Typical Value*

TASK_SIZE_PROCMSG This parameter is only relevant with parallel processing . It sets 100-5,000
the maximum number of OPP promotions that are processed
per parallel package. It must be greater or equal to the
PACK_SIZE_BULK parameter.

 Note
This parameter value does not define the number of OPP
promotions per package. If this parameter is set to 0, inde­
pendently of the value that you enter in transaction
DRFOUT, parallel processing is not possible.

/ROP/Generic_ENH_MAP This parameter activates the automatic mapping of customer- x

specific fields that are stored in the CI-Inlcudes of promotional
entities to the corresponding extension segments in the OPP
promotion IDocs.

 Note
Internal tables, structures, and so on, are not supported.

*This value gives you an idea of usable values for the replication of regular prices and OPP promotions, it is
not a recommendation.

3. Optional: In Customizing activity Define Business Object Settings, specify the application link enabling
(ALE) message type that is to be used for each business object. In this way, you can determine the
retention period for change pointers that are related to the business object. For the outbound processing of
regular prices, no change pointers are used and the retention period is not relevant. The following message
types are relevant for the outbound processing of regular prices and OPP promotions from the central
price and promotion repository:

Business Object Type Message Type

ROP_PRICE /ROP/BASE_PRICE

ROP_PROMO /ROP/PROMOTION

For more information, see Customizing for Cross Application Components under Processes and Tools for
Enterprise Applications Master Data Governance, Central Governance General Settings Data
Replication Overall Information .

Transaction DRFF: Defining Filter Criteria

In Define Filter Criteria, specify your data selection for each replication model and business object. The filter
criteria are valid for Initial replication and Change replication.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 151
Parallel Processing for Regular Prices and OPP Promotions

DRF enables outbound implementations to be executed by using parallel tasks. This feature is supported for
both, the outbound implementation for regular prices and the outbound implementation for OPP promotions.
You can transfer the different tasks to different servers by defining and choosing server groups. Before
replicating the data, you can define the maximum number of work processes that can run in parallel. These
parameters combined with the outbound parameters mentioned above provide a flexible configuration.

6.1.2.9.3.4 Configure the Location-Specific Outbound

Processing of OPP Promotions

The location-specific outbound processing of OPP promotions enables you to distribute a location-specific
view of OPP promotions. With this outbound option OPP promotions are sent from the central price and
promotion repository to its assigned locations. You can use this option if you, for example, want to send OPP
promotions to POS systems in your physical stores. This section describes how to configure the Application
Link Enabling (ALE) layer and Data Replication Framework (DRF) for the sending of IDocs.

Application Link Enabling

In Customizing for SAP NetWeaver, under Application Server IDoc Interface / Application Link Enabling
(ALE) , see the system documentation to check the settings for distributing data between application
systems based on Application Link Enabling and IDoc interface technology. With omnichannel promotion
pricing, this functionality is used to distribute OPP promotions and regular prices from SAP Customer Activity
Repository to an external system, for example an SAP Commerce system. You need to perform the following
steps:

Transaction SM59: Defining an RFC Destination

For each receiving system that initially receives the created IDocs, you have to create an RFC destination. If you
use a middleware, this RFC destination refers to the host in which the middleware is running, If you use a 1:1
connection, all receiving systems require a separate RFC destination. The attributes of the RFC destination are
determined by the receiving system. In the following we assume that we want to setup a location-specific
outbound processing to a local promotion pricing service in a SAP Commerce system that is directly
connected to the SAP Customer Activity Repository.

1. In Technical Settings, enter the following values for Target System Settings:

Field Name Value

Target Host <name of the target host>

Path Prefix /sapppspricing/idocinbound

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
152 PUBLIC Set Up the Applications
 Field Name Value

Port <service number for https or http

connection>

 Note
With OPP, an https connection is recommended.

2. In Logon and Security, select Basic Authentication for Logon with User, and enter the following values:

Field Name Value

User <user name that you have created in SAP

Commerce Backoffice>

Password <password that you have created in SAP

Commerce Backoffice>

In Security Options select SSLActive to send your data via https connection and enter an appropriate
certificate.

 Note

We strongly recommend to use Secure protocols (SSL, SCN) whenever possible.

For more information, see Transport Layer Security and Web Services Security in the SAP NetWeaver
Security Guide.

Transaction WE21: Defining a Port

1. Create this ALE port in the XML HTTP folder and enter the following values:

Field Name Value

Port <name of port>

Description <description of port>

RFC destination

2. Text/XML.

Transaction WE20: Defining a Partner Profile

A partner profile contains parameters that define the electronic interchange of data between systems using the
IDoc interface. There is only one partner profile required for the receiving system and it needs to contain all the
parameters that your scenario requires for sending OPP promotions and regular prices to that receiving
system.<name of the RFC destination created in the previous step>

Basic Partner Profile Information

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 153
To set up the basic partner profile information, do the following:

1. In Partner Profiles<, create a logical system partner. Enter the following values:

Field Name Value

Partner No. External ID of the receiving DDF location

Partner Type LO for OPP promotions replicated via location-specific outbound processing

 Note

For this partner type, only the first 10 characters of the DDF location ID are taken into account, the
location type and logical system are ignored. If you want to use a different logic, use transaction WE44
to define a different partner type or to change the validation logic.

Select a content type supported with the receiving system. If you configure a localIf you need a
different implementation of BAdI /ROP/PROMO_STORE_OUTBOUND, see Customizing for SAP Customer
Activity Repository and choose Omnichannel Promotion Pricing (OPP) Business Add-Ins (BAdIs)
Outbound Processing of OPP Promotions BAdI: Location-Specific Outbound Processing .

2. In the Post processing: permitted agent tab, enter the following values:

Field Name Value

Ty. US (for User)

Agent <users to be notified>, which should be an agent who can process IDocs
with errors.

Lang. <notification language>

Outbound Parameters

Field Name Value

Message Type /ROP/PROMOTION for OPP promotions

Outbound Options tab

Receiver port <receiver port> as defined in section Defining a Port

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
154 PUBLIC Set Up the Applications
 Field Name Value

Output Mode ● Pass IDoc Immediately

○ Select this option to transfer IDocs directly after creation for a better integra­
tion to the DRF transfer log.
○ Select this option to make sure that IDocs are sent in the same order in
which they have been created.
● Collect IDocs
○ Select this option to collect IDocs and transfer them sequentially with trans­
action WE14.

IDoc Type Depending on the receiving system /ROP/PROMOTION01 or /ROP/PROMOTION02 for

OPP promotions

Cancel Processing After Syntax Ensure that this field is selected to avoid sending erroneous IDocs.
Error

Data Replication Framework

In Customizing for Cross-Application Components under Processes and Tools for Enterprise Applications
Master Data Governance, Central Governance General Settings Data Replication Overall Information ,
see the system documentation to check how data is replicated to one or more target systems. With OPP, the
Data Replication Framework functionality is used to send regular prices and OPP promotions from an SAP
Customer Activity Repository system to external systems. You need to perform the following steps:

Transaction DRFIMG: Defining Custom Settings for Data Replication

In Customizing, you have to perform the following configuration steps under Data Replication Define
Custom Settings for Data Replication :

1. In Customizing activity Define Technical Settings for Business Systems, define a business system and a
logical system for the receiving systems. The following business object types are available to replicate OPP
promotions and regular prices, and can be assigned to the business system:

Business Object Type Description Communication Channel

ROP_PRO_ST Location-specific outbound process­ Replication via IDoc

ing of OPP promotions

2. In Customizing activity Define Replication Models, specify the content of the replication model (regular
prices or OPP promotions), the outbound implementation that is to be used, and the business system to
which this object is to be sent. You can specify a different destination system for each outbound

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 155
 implementation that contains business object, filter object, and business logic. You can also add an
expiration time for the log. The following predefined outbound implementations exist:

Outbound Imple­ Supported Replication

mentation Description Model Filter Object

ROP_PRO_ST Outbound implementation Initialization, Change, and ROP_PRO_ST

for OPP promotions sent Manual
via location-specific out­
bound processing

Outbound Parameters
The following outbound parameters must be assigned to each replication model:

Outbound Parameter for

OPP Promotions Description Typical Value*

PACK_SIZE_BULK This parameter sets the maximum number of OPP promotions 100-1,000
that are processed per IDoc. It must be smaller than the
TASK_SIZE_PROCMSG parameter and is relevant for both, the se­
quential and the parallel execution of DRF outbound.

 Note
If this parameter is not set, the default is 1. If you increase
this value, performance at runtime is improved since fewer
IDocs need to be processed.

TASK_SIZE_PROCMSG This parameter is only relevant with parallel processing . It sets 100-5,000
the maximum number of OPP promotions that are processed
per parallel package. It must be greater or equal to the
PACK_SIZE_BULK parameter.

 Note
This parameter value does not define the number of OPP
promotions per package. If this parameter is set to 0, inde­
pendently of the value that you enter in transaction
DRFOUT, parallel processing is not possible.

/ROP/Generic_ENH_MAP This parameter activates the automatic mapping of customer- x

specific fields that are stored in the CI-Inlcudes of promotional
entities to the corresponding extension segments in the OPP
promotion IDocs.

 Note
Internal tables, structures, and so on, are not supported.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
156 PUBLIC Set Up the Applications
 *This value gives you an idea of usable values for the replication of regular prices and OPP promotions, it is
not a recommendation.

3. Optional: In Customizing activity Define Business Object Settings, specify the application link enabling
(ALE) message type that is to be used for each business object. In this way, you can determine the
retention period for change pointers that are related to the business object. For the outbound processing of
regular prices, no change pointers are used and the retention period is not relevant. The following message
types are relevant for the outbound processing of regular prices and OPP promotions from the central
price and promotion repository:

Business Object Type Message Type

ROP_PRICE /ROP/BASE_PRICE

ROP_PROMO /ROP/PROMOTION

For more information, see Customizing for Cross Application Components under Processes and Tools for
Enterprise Applications Master Data Governance, Central Governance General Settings Data
Replication Overall Information .

Transaction DRFF: Defining Filter Criteria

In Define Filter Criteria, specify your data selection for each replication model and business object. The filter
criteria are valid for Initial replication and Change replication.

6.1.2.9.4 Configure the Central Deployment of the

Promotion Pricing Service

The promotion pricing service (PPS) is an SAP HANA XS advanced (XSA) application. Therefore the
configuration of, for example, database services and back-end connection information, is done before or during
the deploy time. The needed configuration settings are provided via command line interface, or in an extension
descriptor file. Authentication configuration and authorization configuration is done after deploy time.

Prerequisites

● You have installed SAP HANA XSA version 1.0.88 or higher.

● You have access to the XSA command-line tool version 1.0.82 or higher.
● You have an XSA user with the following role collections:
○ XS_CONTROLLER_ADMIN
○ XS_USER_ADMIN
○ XS_USER_PUBLIC
○ XS_AUTHORIZATION_ADMIN

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 157
  Note

In the following documentation this user will be refered to as XSA PPS admin user.

● You have an XSA user with the business role XS_USER_PUBLIC.

 Note

In the following documentation this user will be refered to as XSA PPS business user.

● You have a database user that can access the standard schema of your SAP Customer Activity Repository
system via the SQL port, in which the database tables of the PPS are located.
● You have created and configured the organization and the space in which you want to install the promotion
pricing service application.
● You have downloaded the SCV file XSACOPPPPS00_<patch level>-80004642.ZIP (for example patch
level 0 for the initial delivery) for the PPS from the SAP Support Portal at https://support.sap.com .

Used XSA Services

The PPS application uses the following XSA services:

Service Instance Service Plan Resource Type Description

ppeHANA User-defined n/a org.cloudfoundry.exist­ Service to acess the

ing-service database.

ppServiceUaa xsuaa space com.sap.xs.uaa-space Service for for authen­

tication and authoriza­
tion services.

Plan space allows the

installation of the PPS
app in different XSA
spaces.

ppServiceAuditLog auditlog free com.sap.xs.auditlog Audit log broker on the

XSA platform.

 Note

The services ppServiceUaa and ppServiceAuditLog are created and bound automatically during the
installation of the PPS application.

Procedure

1. Create the ppeHana Database Service [page 159]

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
158 PUBLIC Set Up the Applications
 2. Create the Extension Descriptor File [page 161]
3. Configure Authentication and Authorization Settings [page 163]
4. Advanced Configuration Settings (Optional) [page 165]

Related Information

● For more technical information about SAP HANA XS advanced, see the SAP HANA Developer Guide for SAP
HANA XS Advanced Model on SAP Help Portal at https://help.sap.com/viewer/product/
SAP_HANA_PLATFORM/ <Version> Development SAP HANA Developer Guide .
● For more information about the installation of SAP HANA XS advanced, see the SAP HANA Server
Installation and Update Guide on SAP Help Portal at https://help.sap.com/viewer/product/
SAP_HANA_PLATFORM/2.0.04/en-US <Version> Installation and Upgrade SAP HANA Server
Installation and Upgrade Guide Installing an SAP HANA System Installing XS Advanced Runtime .
● For more administration information about SAP HANA XS advanced, see the SAP HANA Administration
Guide for SAP HANA Platform on SAP Help Portal at https://help.sap.com/viewer/product/
SAP_HANA_PLATFORM/2.0.04/en-US <Version> Administration SAP HANA Administration Guide
for SAP HANA Platform Application Run-Time Services Maintaining the SAP HANA XS Advanced Model
Run Time .

6.1.2.9.4.1 Create the ppeHana Database Service

To make the PPS run, you have to create the database service ppeHana. How to create this service depends on
your SSL (Secure Socket Layer) configuration settings in your SAP HANA database.

SSL Not Activated in SAP HANA

If SSL is not activated in SAP HANA, proceed as follows:

1. Execute the following xs command to create the database service:

 Source Code

xs create-user-provided-service ppeHana -p "{\"user\":\"<DB_USER>\",

\"password\":\"<DB_USER_PASSWORD>\",\"url\":\"jdbc:sap://<HOSTNAME>:<PORT>
\",\"driver\":\"com.sap.db.jdbc.Driver\",\"port\":\"<PORT>\",\"host\":
\"<HOSTNAME>\"}"

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 159
2. Adjust the following entries in angle brackets (<...>) in the command line:

Entry Comment

<DB_USER> Replace this entry with a valid database user of your SAP
Customer Activity Repository system.

With this user, you must be able to access the standard

schema of your SAP Customer Activity Repository system
via the SQL port, in which the database tables of the PPS
are located.

<DB_USER_PASSWORD> Replace this entry with the password of your database

user (in clear text) in your SAP Customer Activity
Repository system.

 Note
If your password policy forces a password change af­
ter the first login, it must be changed before you cre­
ate ppeHana.

<HOSTNAME> Replace this entry with the database host name of your
SAP Customer Activity Repository system.

<PORT> Replace this entry with the database SQL port of your SAP
Customer Activity Repository system.

 Tip

When you have created the database service, clear the command history to prevent unauthorized
disclosure of the password.

SSL Activated in SAP HANA

If SSL is activated in SAP HANA proceed as follows:

1. Execute the following xs command to create the database service and add encrypt=true to the database
URL to use an encrypted database connection:

 Source Code

xs create-user-provided-service ppeHana -p "{\"user\":\"<DB_USER>\",

\"password\":\"<DB_USER_PASSWORD>\",\"url\":\"jdbc:sap://
<HOSTNAME>:<PORT>/?encrypt=true^^^&validateCertificate=<VALUE>\",\"driver
\":\"com.sap.db.jdbc.Driver\",\"port\":\"<PORT>\",\"host\":\"<HOSTNAME>\"}"

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
160 PUBLIC Set Up the Applications
 2. If you want to validate the server certificate, set <VALUE> of validateCertificate to true. In this case, you
either have to ensure that your Java VM trusts the server certificate, or you must set the parameter
certificate as shown in the following example of a ppeHana service instance:

 Sample Code

{
"name" : "ppeHana",
"credentials" : {
"password" : "<DB_USER_PASSWORD>",
"driver" : "com.sap.db.jdbc.Driver",
"port" : "<PORT>",
"host" : "<HOSTNAME>",
"user" : "<DB_USER>",
"url" : "jdbc:sap://<HOSTNAME>:<PORT>/?
encrypt=true&validateCertificate=true",
"certificate" : "-----BEGIN CERTIFICATE-----\nMIIFpzCww[…]----END
CERTIFICATE-----\n"
}
}

 Tip

When you have created the database service, clear the command history to prevent unauthorized
disclosure of the password.

6.1.2.9.4.2 Create the Extension Descriptor File

To store the PPS-specific configuration settings, you must create an extension descriptior file.

1. Create a text file with suffix .mtaext, for example config-op.mtaext.

2. To create the extension descriptor file, copy the following content to the new file that you have created in
step 1:

 Note

This content includes the minimum settings that are necessary to create the extension descriptior file.
Further configuration settings, for example settings for caching, can be added to this file as required.

 Source Code

_schema-version: "2.0.0"
ID: com.sap.retail.ppservice.XSAC_OPP_PPS
extends: com.sap.retail.ppservice.XSAC_OPP_PPS
modules:
- name: ppservice-approuter
parameters:
memory: 128M
- name: ppservice-webapp-central
parameters:
memory: 1024M
properties:
DISABLE_SUCCESSFUL_LOGIN_AUDIT_LOG: "<AUDIT_LOG_FLAG>"
JBP_CONFIG_RESOURCE_CONFIGURATION: "['tomcat/webapps/ROOT/WEB-INF/
classes/ppe-schema-orm.xml': {'sap.dataaccess-

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 161
 common.schema':'<DB_SCHEMA>'},'tomcat/webapps/ROOT/META-INF/context.xml':
{'ppeHana-service-name':'ppeHana'}]"
JBP_CONFIG_JAVA_OPTS: 'java_opts: -Dsap.dataaccess-
common.db.client="<DB_CLIENT>" -Dsap.dataaccess-common.logSys=<LOGSYS>'
provides:
- name: java

 Note

This configuration is written in YAML format. Make sure that you copy the format of the code block
correctly.

3. Adjust the following entries in angle brackets (<...>) in the file:

Entry Comment

<AUDIT_LOG_FLAG> If you set this flag to true, the system creates audit log
messages only for failed login attempts. If you set this flag
to false, every login is recorded. This is of limited use for
an A2A communication. To achieve optimal performance,
SAP recommends to set this flag to true.

<DB_SCHEMA> Replace this entry with the standard database schema of

your SAP Customer Activity Repository system.

<DB_CLIENT> Replace this entry with the client of your SAP Customer
Activity Repository system.

<LOGSYS> Replace this entry with the logical system ID of your mas­
ter data system that is connected to your SAP Customer
Activity Repository client.

If you want to support multiple master data systems in

your SAP Customer Activity Repository client, you need
one promotion pricing service for each system (in differ-
ent spaces).

 Tip

If you need higher values for default memory settings, especially for ppservice-webapp-central,
you can choose larger cache sizes.

4. Assuming that your extension descriptor file is called config-op.mtaext and that the command is called
from the directory in which your extension descriptor file is stored, execute the following command to
install the application:

 Source Code

xs install <pathToScvFile>/XSACOPPPPS<software_component_version>.ZIP -e
config-op.mtaext

5. Save the extension descriptor file for later update or patch activities.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
162 PUBLIC Set Up the Applications
  Note

If you want to reinstall the same software component version, add the following parameter to the install
command -o ALLOW_SC_SAME_VERSION.

For more information about possible additional parameters, see the documentation of this install
command.

6.1.2.9.4.3 Configure Authentication and Authorization

Settings

To use the central promotion pricing service, you must have the necessary roles created and assigned.

Creating and Assigning a PPS Role Collection

Execute the following steps with your XSA PPS admin user.

1. Create a role collection for the PPS with the following xs command:

 Source Code

xs create-role-collection <NAME> [<DESCRIPTION>]

e.g., xs create-role-collection PPE_ROLE_COLLECTION "PPE ROLE COLLECTION"

2. Navigate to the organisation and space in which the PPS has been installed.

 Tip

You can change organisations and spaces with the xs command xs target -o <ORG_NAME> -s
<SPACE_NAME>.

3. Check if the role template ppservice-webapp-central is listed in the space.

 Note

If the installation has been successful, this role template must be listed in this space. You can verify this
by listing all role templates with xs command xs role-templates.

4. Create a role with the PPS role template:

 Source Code

xs create-role <APP> <ROLE_TEMPLATE> <ROLE_NAME> <DESCRIPTION>

e.g., xs create-role ppservice-webapp-central PPE_ROLE_TEMPLATE
PPE_ROLE_XYZ "PPE role for xyz"

5. Add the new role to the new role collection:

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 163
  Source Code

xs update-role-collection <ROLE_COLLECTION> --add-role <ROLE>

e.g., xs update-role-collection PPE_ROLE_COLLECTION --add-role PPE_ROLE_XYZ

6. Assign the new role collection to the XSA PPS business user:

 Source Code

xs assign-role-collection <ROLE_COLLECTION> <USER>

e.g., xs assign-role-collection PPE_ROLE_COLLECTION PPSUSER

 Tip

You can call xs help -a to get an overview of other xs commands regarding role management.

7. Verify that the PPS user that you have created in the prior step is working. For this, you have to enter the
following request details in your REST Client (like Postman for Chrome) to send a calculation request:

Request Details Value

HTTP Request Method POST

Authorization Type = Basic Authentication

User name = <name of the XSA PPS business

user>

Password = <password of the XSA PPS

business user>

 Note
If your password policy prompts users to change their
password when they log on to the system for the first
time, this needs to be done before a request is sent
via Rest Client.

Headers Accept = application/xml

Content-Type = application/xml

URL 1. Call the command xs apps and check for the URL
of the ppservice-approuter app.
2. Append /restapi/ to the URL and enter this infor­
mation in your REST Client.

Body <PriceCalculate xmlns="http://

www.sap.com/IXRetail/namespace/"/>

 Note

If you send this request, you get HTTP response code 400 (Bad Request) because you send an empty
request body.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
164 PUBLIC Set Up the Applications
 If you receive HTTP response code 401 (Unauthorized) or 403 (Forbidden), there is something wrong with
your service user, or application. Double-check all steps that you have performed in this chapter.

6.1.2.9.4.4 Advanced Configuration Settings (Optional)

The following settings are not mandatory in a default setup but help you to adapt the PPS to your specific
needs.

Configuration of Caches

By default, all database accesses to OPP promotion and regular price entities are cached. You can use the
following two types of caches:

● Object cache based on JPA

In this case, OPP promotions and their child entities (price derivation rules, texts, and so on) are stored in
the L2 object cache of the JPA provider.
● Query result cache based on Spring Framework
In this case, regular prices and the results of search queries for IDs of price derivation rule eligibilities are
stored in a cache. This cache is used via Spring cache abstraction. The cache provider determines the
settings for the query result cache (regular prices, eligibility IDs). Google Guava is the default cache
provider and allows the configuration of the cache via a cache specification string per cache region.

Query Result Caches for OPP Promotions and Regular Prices

The following example shows the setting of the query caches for OPP promotions and regular prices:

 Source Code

# Use Spring caching for promotions and regular prices - true is the default
setting
sap.dataaccess-common.cachenamedqueries=true
# Spring cache for promotions
sap.dataaccess-
common.promocachespec=maximumSize=10000,expireAfterAccess=10m,expireAfterWrite
=20m
# Spring cache for regular prices
sap.dataaccess-
common.basepricecachespec=maximumSize=10000,expireAfterAccess=10m,expireAfterW
rite=20m

To apply these settings, they have to be part of the extension descriptor in the JBP_CONFIG_JAVA_OPTS
property.

...
JBP_CONFIG_JAVA_OPTS: 'java_opts: -Dsap.dataaccess-
common.db.client="<DB_CLIENT>" -Dsap.dataaccess-common.logSys=<LOGSYS>' -
Dsap.dataaccess-common.cachenamedqueries=true -Dsap.dataaccess-
common.promocachespec=maximumSize=10000,expireAfterAccess=10m,expireAfterWrite=20
m -Dsap.dataaccess-
common.basepricecachespec=maximumSize=10000,expireAfterAccess=10m,expireAfterWrit
e=20m

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 165
 ...

Related Information

● For more information about optional properties that can be set via the extension descriptor, see the
module descriptions and the corresponding property files in the Development and Extension Guide for
Omnichannel Promotion Pricing on SAP Help Portal at https://help.sap.com/viewer/p/CARAB <Version>
Development Development and Extension Guide .
● For more information about caching options, see the Development and Extension Guide for Omnichannel
Promotion Pricing on SAP Help Portal at https://help.sap.com/viewer/p/CARAB <Version>
Development under Promotion Pricing Service PPS Module dataaccess-common .

6.1.3 Troubleshooting

Diagnose and resolve issues that may arise when you install, upgrade, and set up your scenario. If you need to
report a customer incident, see the information at the end of this section.

 Tip

For quick access to support information, log in to the SAP ONE Support Launchpad at https://
launchpad.support.sap.com/#/productsearch . Search for SAP CARAB (back-end product version) or
SAP FIORI FOR SAP CARAB (front-end product version). Find SAP Knowledge Base Articles,
Documentation, Guided Answers, Questions & Blogs, and Download information — all on one page.

Troubleshoot Installation, Upgrade, and Implementation Issues

Installation, Upgrade, and Implementation Issues

Area Symptom Cause Possible Solutions

Installation / Upgrade You want to download a revi­ You need the exact download See section Download and
sion of software component path on the SAP Support Install the Application Func­
SAP RTL AFL FOR SAP Portal at http:// tion Library (SAP RTL AFL
HANA. support.sap.com . FOR SAP HANA) [page 51].

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
166 PUBLIC Set Up the Applications
 Area Symptom Cause Possible Solutions

Installation / Upgrade You get an error indicating You must install compatible ● Section Download and
that software component releases (“revisions”) of the Install the Application
SAP RTL AFL FOR SAP following: Function Library (SAP
HANA is not compatible. RTL AFL FOR SAP
● SAP RTL AFL FOR
HANA) [page 51].
SAP HANA
● SAP Note 2818378
● SAP HANA DATABASE
(Which releases of SAP
● SAP HANA AFL
HANA Platform are sup­
ported for which releases
of SAP Customer Activ­
ity Repository applica­
tions bundle (SAP
CARAB)?)

Installation / Upgrade You want to know what AFLs For example, you want to SAP Note 2188129
(application function libra­ check if an AFL was installed
ries) are installed and active or upgraded correctly.
in your SAP HANA database.

Installation / Upgrade You want to verify if your revi­ For example, you might be SAP Note 2375176
sion of SAP HANA Platform experiencing compatibility is­
is compatible with your ver­ sues following an upgrade.
sion of SAP HANA studio.

Installation / Upgrade You have installed compati­ Something went wrong dur­ Revisit SAP Note 2377894
ble revisions of the following ing the installation. and make sure that you have
components but are still ex­ carefully followed all the
periencing issues: SAP RTL steps for your scenario.
AFL FOR SAP HANA, SAP
HANA AFL, SAP HANA
DATABASE

Installation / Upgrade You want to install or upgrade You need information on pos­ ● SAP Note 2078425
an application function li­ sible causes and solutions. ● SAP Note 2082466
brary (such as SAP RTL AFL
● SAP HANA Server Instal­
FOR SAP HANA) and are ex­ lation and Update Guide
periencing issues with the for your SAP HANA Plat­
SAP HANA Lifecycle Man­ form version under
agement tool (hdblcm, https://help.sap.com/
hdblcmgui). viewer/p/
SAP_HANA_PLATFORM

<Version>
Installation and

Upgrade

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 167
Area Symptom Cause Possible Solutions

Installation / Upgrade You get an import error when A program error must be SAP Note 2377525
installing the RTLAPPS soft­ fixed.
ware component of the SAP
CARAB back-end product
version.

Installation / Upgrade You get the error CAR RETAIL You are using the SAP HANA SAP Note 2022080
APPLSAP DBTech JDBC: AFL software component and
[258]: insufficient privilege: have performed an upgrade
Not authorized. of your SAP HANA Platform.
Previously assigned privi­
leges might have been lost
during the upgrade.

Installation / Upgrade In an upgrade, you get the An issue with CDS views SAP Note 2340418
following error when running must be fixed.
program RUTDDLSCREATE:

3 ETW678Xstart export of
R3TRDDLS<CDS view
name> ...

3WETW000 DDLS <CDS

view name> is not activated.

2EETW190 "DDLS" <CDS

view name> has no active
version.

4 ETW679 end export of

R3TRDDLS<CDS view
name>.

Installation / Upgrade You have implemented an You need to start the recalcu­ SAP Note 2227577
SAP Note with a correction lation manually.
for the SAPUI5 application or
for the calculation of the ap­
plication index. The SAPUI5
application index is not recal­
culated automatically.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
168 PUBLIC Set Up the Applications
 Area Symptom Cause Possible Solutions

Installation / Upgrade You want to install or upgrade As of SAP HANA Platform 2.0 ● Workaround: SAP Note
to a release of SAP Customer SPS04, a message that was 2789289 (Activation
Activity Repository considered a “warning” in of Calculation View Fails
applications bundle using the older releases is now consid­ With Error "column store
Software Update Manager ered an “error”. This error error: [34011] Inconsis­
(transaction SUM). During the prevents the SUM process tent calculation model")
SAP HANA deployment from completing. ● Alternative: Convert the
phase, you get errors such as SAP HANA error mes­
the following: sage back into a warn­

● Datatype string(1333) of ing, then rerun SUM:

JOIN 1. Execute the follow­

$A""TTRIBUTE_VALUE ing SQL statement:
$IMAGE_ID does no""t ALTER SYSTEM
match to datatype ALTER
raw(16) of"" attribute CONFIGURATION
IMAGE_ID in node CLTT ('indexserver
.ini',
'SYSTEM' )
SET
('calcengine'
,
'enable_depre
cated_compone
nt_flags') =
'8192' WITH
RECONFIGURE;
2. Restart transaction
SUM and repeat the
installation or up­
grade step.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 169
Area Symptom Cause Possible Solutions

SAP HANA content You have run the /CAR/ You want to know which ob­ ● Execute transaction
ACTIVATE_HTA activation re­ jects have not been activated SLG1 to display the re­
port but the selected SAP correctly and what errors port log:
HANA content is not acti­ have occurred. Towards the bottom of
vated. the log you will generally
find a section that lists
the objects with activa­
tion errors. Keep in
mind, though, that those
objects might not have
any issues themselves
but that the root cause
can also be in depend­
ent objects.
● In transaction
SCTS_HTA_DEPLOY,
try to reproduce the er­
rors by manually rede­
ploying the objects.

SAP HANA content You have run the /CAR/ The SAP HANA user needs SAP Note 2586850
ACTIVATE_HTA activation re­ additional authorizations
port but get the error (privileges).
Insufficient privilege: Not
authorized.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
170 PUBLIC Set Up the Applications
 Area Symptom Cause Possible Solutions

SAP HANA content You have run the /CAR/ You might have an authoriza­ ● Check if SAP HANA da­
ACTIVATE_HTA activation re­ tion issue. tabase user _SYS_REPO
port but the selected SAP has been assigned privi­
HANA content is not acti­ lege SELECT with option
vated. Grantable to others. If
not, you can grant the
missing privilege using
the following example
SQL statement:
GRANT SELECT ON
SCHEMA <your
schema name> TO
_SYS_REPO WITH
GRANT OPTION;
● Check that other re­
quired authorizations
have been set up cor­
rectly. For more informa­
tion, see section Verify
Back-End Users and
Roles [page 75].

SAP HANA content You have run the /CAR/ You might have a circular de­ SAP Note 2404872
ACTIVATE_HTA activation re­ pendency issue. In particular,
port but the selected SAP you get an error that a
HANA content is not acti­ SQLScript procedure (such
vated. as
SP_SR_GET_PROD_HR_XR_B
Y_DATE) cannot be acti­
vated.

SAP HANA content You have run the /CAR/ You might have a deployment ● SAP Note 2109690
ACTIVATE_HTA activation re­ error in SAP HANA Transport (Error in SAP HANA re­
port but the selected SAP for ABAP (HTA). pository deployment im­
HANA content is not acti­ port step)
vated. ● SAP Note 2321486
(Troubleshooting for SAP
HANA Transport for
ABAP (HTA) deploy­
ment)

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 171
Area Symptom Cause Possible Solutions

SAP HANA content You want to activate SAP Several causes are possible. Check that you have done
HANA content for scenarios Open the error log file and the following tasks as descri­
of SAP Customer Activity search for udf.cor. For ex­ bed in this guide:
Repository applications ample, the following errors ● Have you installed com­
bundle using the /CAR/ can occur: patible revisions of the
ACTIVATE_HTA report in
● Could not create catalog SAP HANA database
transaction SE38. However, and the AFL compo­
object
you are getting errors. nents (SAP HANA AFL,
● Invalid name of function
or procedure SAP RTL AFL FOR

● No procedure with name SAP HANA)? See the

UDFCORE_AREA_MODE Common Prerequisites

L_POS_XX_PRO in section Install the Pre­
requisites [page 17]. See
also section Download
and Install the Applica­
tion Function Library
(SAP RTL AFL FOR SAP
HANA) [page 51].
● Have you done the
schema mapping as de­
scribed in this guide?
See Verify Correct
Schema Mapping [page
43].

SAP HANA content You want to activate SAP Several causes are possible. ● Workaround and list of
HANA content for scenarios Open the error log file and affected SAP HANA da­
of SAP Customer Activity search for udf.cor. For ex­ tabase revisions: SAP
Repository applications ample, the following errors Note 2525644 (Input
bundle using the /CAR/ can occur: Variables are set to an
ACTIVATE_HTA report in Empty String When not
● There is neither a default
transaction SE38. However, Mapped in Top-Level
value nor a data input
you are getting errors. Calculation Scenario)
mapping for …"
● If possible for your sce­
● A2EESCTS_HOT 532
nario, consider upgrad­
ing to an SAP HANA da­
tabase revision not af­
fected by the issue.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
172 PUBLIC Set Up the Applications
 Area Symptom Cause Possible Solutions

SAP HANA content After running the /CAR/ You want to know whether SAP Note 2467113
ACTIVATE_HTA activation re­ the activation was successful
port, you get two conflicting and whether any additional
messages: action is required.

● The following scenario

was deployed
successfully...
● But returned error/
warning/information
message(s)...

SAP HANA content You want to generate pre- You might not have activated When you run the /CAR/
season sales projections in all the required SAP HANA ACTIVATE_HTA activation re­
SAP Assortment Planning content. port, make sure to select the
but get an error. required options. See Acti­
vate SAP HANA Content
[page 85].

SAP HANA content You want to check the de­ You might need this informa­ ● In SAP HANA studio: Se­
pendencies of a specific view. tion to solve a dependency or lect the view and choose
activation issue for SAP Auto Documentation
HANA views. from the context menu.
This generates a file with
detailed information on
the view. Consult the
Cross References sec­
tion.
● If you are using the SAP
HANA Live View Browser
app: Select the view and
choose Cross
References.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 173
Area Symptom Cause Possible Solutions

SAP HANA content You get an error indicating You have not installed soft­ See section Download and
that you are attempting to ware component SAP RTL Install the Application Func­
access inactive or invalid SAP AFL FOR SAP HANA. The tion Library (SAP RTL AFL
HANA content. component contains back- FOR SAP HANA) [page 51].
end functionality for the Uni­
fied Demand Forecast mod­
ule and the On-Shelf Availa­
bility module in SAP
Customer Activity
Repository. If you don't in­
tend to use those modules,
you don't need to configure
them. However, you must al­
ways install the software
component.

SAP HANA content You get the error Table A program error must be ● SAP Note 2218875
ABAP:/DMF_ORG_ASSIGN fixed. ● SAP Note 2224582
not found.

SAP HANA content You get the error Object A program error must be SAP Note 2224582
DDF_ORG_ASSIGN fixed.
(Calculation View), package
sap.is.ddf.udf.data_validation,
was processed with errors.

SAP HANA content You get the error SQLScript: A program error must be SAP Note 2125672
Could not derive table type fixed.
for variable
"UDF_FC_HORIZON".

SAP HANA content SAP HANA views in the A program error must be SAP Note 2203930
sap.is.ddf.fms package fixed.
do not activate properly.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
174 PUBLIC Set Up the Applications
 Area Symptom Cause Possible Solutions

SAP HANA content You need to manually deploy The automatic deployment ● Search for the following
SAP HANA objects and pack­ to the SAP HANA repository sections in the product
ages. of the target system has documentation of your
failed. SAP NetWeaver plat­
form at https://
help.sap.com/viewer/p/
SAP_NETWEAVER: SAP
HANA Transport for
ABAP and Manually De­
ploying SAP HANA Ob­
jects and Packages. Fol­
low the instructions.
● Execute transaction
SCTS_HTA_DEPLOY
for the manual deploy­
ment of SAP HANA con­
tent and consult the ac­
companying system
documentation.

SAP HANA content You get any of the following The root cause is the usage You can ignore the error mes­
errors: of CDS (Core Data Services) sages and continue with the
on top of external views. installation or upgrade proc­
● View "/AMR/..." does not
ess. For explanations, see
exist in data base
SAP Note 2330184 .
● "DDL Source" "/
AMR/...." could not be
activated
● "DDL Source" "/DMF/
DIST_..." could not be
activated

SAP HANA content You get the error SQL Script The root cause is the usage You can ignore the error mes­
message: invalid table name: of CDS (Core Data Services) sages and continue with the
Could not find table/ on top of external views. installation or upgrade proc­
view /AMR/V. ess. For explanations, see
SAP Note 2441184 .

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 175
Area Symptom Cause Possible Solutions

SAP HANA content You get the error View with A data element that is new or SAP Note 2289913
par. <CDS view name>: data has been redefined is used in
element <data element> par. the new definition in a Core
& does not exist or not active. Data Services (CDS) view
with parameters for the defi-
nition of a parameter.

The system does not con­

sider the dependency be­
tween data elements and the
type definition of the param­
eters for views with parame­
ters.

SAP HANA content When doing ATC (ABAP Test The system does not con­ SAP Note 2374190
Cockpit) checks of database sider base information of the
objects or runtime objects, AMDP table function entity.
you get errors related to ref­
erence tables and reference
fields:

● Priority 1 error: View

<view_name> is not
consistent
● Priority 1 error:
<view_name-field> is not
consistent
● Inconsistencies in fields
related to reference ta­
bles and reference fields

SAP HANA Platform You cannot install the SAP You cannot install XSA as SAP Note 2388443
HANA XS advanced (XSA) long as SAP HANA dynamic
runtime. tiering is active on the same
host.
For example, you need XSA
to use the Omnichannel Pro­
motion Pricing (OPP) module
in SAP Customer Activity
Repository.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
176 PUBLIC Set Up the Applications
 Area Symptom Cause Possible Solutions

SAP HANA Platform You are encountering per­ Several causes are possible. ● SAP Note 2600030
formance issues in the SAP (Parameter Recommen­
HANA Platform. dations in SAP HANA En­
vironments)
● SAP Note 2100040
(FAQ: SAP HANA CPU)
● SAP HANA Trouble­
shooting and Perform­
ance Analysis Guide for
your SAP HANA Plat­
form version under
https://help.sap.com/
viewer/p/
SAP_HANA_PLATFORM

<Version>

Administration

SAP HANA Platform You are not sure if the instal­ Consult the list of compatible SAP Note 2375176
led SAP HANA revision is revisions and versions.
compatible with the installed
SAP HANA studio version.

Hierarchies You get errors when creating The system does not gener­ ● Follow the steps in Con­
or updating location hierar­ ate the flat structures for the figure Automatic Flat­
chies and/or product hierar­ hierarchies. You need to do tening of Hierarchies
chies. some configuration steps so [page 92].
that the hierarchies get flat- ● See the following sec­
tened automatically. tions of the SAP Cus­
tomer Activity Reposi­
tory Administration
Guide under https://
help.sap.com/viewer/p/

CARAB <Version>

Administration :
○ Configure Demand
Data Foundation
(DDF)
○ Configure Data Rep­
lication from SAP
ERP to DDF

Hierarchies You get errors when import­ A program error must be ● SAP Note 2244521
ing article hierarchies (prod­ fixed. ● SAP Note 2245134
uct hierarchies) from your
master data system.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 177
Area Symptom Cause Possible Solutions

Hierarchies You want to know which loca­ You can implement an easy SAP Note 2208619
tions are included in each enhancement for ta­
version of an offer. ble /DMF/OFR_LG_LOC.

Hierarchies An error occurs for a DDL A program error must be SAP Note 2377525
SQL view when you execute fixed.
the CREATE VIEW state­
ment.

DRF data replication frame­ You have deleted a vendor A program error must be SAP Note 1872136
work (transaction DRFOUT) from the /DMF/D_VENDOR fixed.
table but this deletion is not
replicated to the master data
system.

DRF data replication frame­ You get an error when using A program error must be ● SAP Note 1904782
work (transaction DRFOUT) the DRF with the PMPL SAP fixed. ● SAP Note 2167629
ERP outbound implementa­ ● See the application help
tion. for SAP Customer
Activity Repository at
https://help.sap.com/
viewer/p/CARAB

<Version>

Application Help SAP

Customer Activity

Repository Demand

Data Foundation
Integration Information

Master Data
Replication from SAP
ERP to Demand Data

Foundation

DRF data replication frame­ You get the error Product &1, A program error must be SAP Note 2163602
work (transaction DRFOUT) location &2: The Valid From fixed.
time for &3 must be
00:00:00 (message 364 in
message class /DMF/
MSG_HL).

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
178 PUBLIC Set Up the Applications
 Area Symptom Cause Possible Solutions

DRF data replication frame­ You have changed the listing A program error must be SAP Note 1932525
work (transaction DRFOUT) information in your source fixed.
master data system and re­
plicated the changes to your
SAP Customer Activity
Repository system. However,
the listing information there
is not updated correctly.

Performance You are experiencing per­ You need information on how See the SAP HANA Trouble­
formance issues in your SAP to troubleshoot and resolve shooting and Performance
HANA database. those issues and how to en­ Analysis Guide under https://
hance performance in gen­ help.sap.com/viewer/p/
eral. SAP_HANA_PLATFORM

<Version>

Administration .

Performance You get a runtime error or Different causes are possible. Use the ABAP dump analysis
exit message and need infor­ (transaction ST22) to search
mation about possible for short dumps and call up
causes and solutions. detailed error information.

Performance You are using the Update You can enhance the per­ SAP Note 2080423
Sales Projection function in formance by implementing
SAP Assortment Planning an SAP Note.
(workbooks Product Planning
and Size Planning). You are
experiencing performance is­
sues when using the function
with large data volumes.

OData During the execution of an The Core Data Services SAP Note 238998
OData service based on (CDS) view uses a table func­
SADL with CDS, an assertion tion that is not active in the
fails in class database. The trigger that is
CL_SADL_SQL_STATEMENT, supposed to activate it fails
method because of missing parame­
EXECUTE_PREPARED_STATE ters if only $count is quer­
MENT. The OData request ied.
uses the system query option
$count.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 179
Area Symptom Cause Possible Solutions

Support You have a customer incident You need information on how ● SAP Note 35010
and need to set up a service to set up the service connec­ (overview)
connection to SAP. tion. ● SAP Note 1634848
(service connection for
SAP HANA database)
● SAP Note 1592925
(service connection for
SAP HANA studio)

Source Master Data Systems You get the error The error is caused by the SAP Note 2249880
SYSTEM_ABAP_ACCESS_DE Blacklist Monitor in SAP S/
NIED. 4HANA.

SAP Fiori ● You want to start an SAP You must set up the adapta­ SAP Note 2283716
Fiori app for a key user tion transport organizer
and get the error (ATO) to be able to transport
Application is not key user extensions.
configured. Find details
in SAP Note 2283716.
● You want to activate ex­
tensibility for key users.

SAP Fiori You want to check the SA­ There are several methods SAP Note 2282103
PUI5 version installed in your how you can check the ver­
system. sion.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
180 PUBLIC Set Up the Applications
 Area Symptom Cause Possible Solutions

SAP Fiori You cannot open the Analyze Several reasons are possible. Use section Set Up the Ana­
Forecast app. See the checklist at the right lyze Forecast App [page 118]
and verify that the app is set for reference and check the
up correctly. following:

1. In transaction SE80,
navigate to package
UICAR001, subpackage
UISCAR01. Check that
the BSP Applications for
the app
(ANALYZFCST_V2) and
the reuse library
(UDFREUSE) are de­
ployed.
2. In Launchpad
Customizing (transac­
tion LPD_CUST), check
that the Internet Com­
munication Framework
(ICF) services for
ANALYZFCST_V2 and for
UDFREUSE are active.
3. Clear the cache on the
server side by running
the following reports in
transaction SE38:
○ /UI5/
APP_INDEX_CALCU
LATE: Select Single
SAPUI5 Repository
Only and run the re­
port once for
ANALYZFCST_V2
and once for
UDFREUSE.
○ /UI2/
INVALIDATE_GLOB
AL_CACHES: Run
this report in execu­
tion mode.
○ /UI2/
INVALIDATE_CLIE
NT_CACHES: Run

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 181
Area Symptom Cause Possible Solutions

this report for all

users.
4. Clear the browser cache.
5. Check if you can now ac­
cess the app.

Upgrade On-Shelf Availability The following error occurs Local temporary tables SAP Note 2576497
Dispatcher (transac­ when executing the On-Shelf (LOCAL_EXCL_PRODUCT,
tion /OSA/DISPATCH) Availability (OSA) Dispatcher: LOCAL_LISTED_PRODUCT,
''SQL Error Code 274 : in­ and LOCAL_PS_CONF) cre­
serted value too large for col­ ated and used by OSA for in­
umn' ternal dispatcher processing
are not dropped automati­
cally during runtime there­
fore new tables, such as any
containing CHAR40 fields,
cannot get created. This
causes an SQL error when a
CHAR40 material is supplied.
Subsequent structural
change to the definition of
these tables requires manual
intervention in cases where
the tables may already exist.

Troubleshoot Operation Issues

You also may encounter issues during the day-to-day running of your application. For troubleshooting
information, see the application-specific Administration Guides under https://help.sap.com/viewer/p/CARAB
<Version> Administration :

● SAP Customer Activity Repository Administration Guide: section Troubleshooting for SAP Customer Activity
Repository Modules
● SAP Allocation Management Administration Guide: section Troubleshooting
● SAP Assortment Planning Administration Guide: section Troubleshooting
● SAP Merchandise Planning Administration Guide: section Troubleshooting
● SAP Promotion Management Administration Guide: section Management of SAP Promotion Management

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
182 PUBLIC Set Up the Applications
Report a Customer Incident

● If you encounter an issue with your system, we recommend that you first search the SAP Knowledge Base
and SAP Notes for existing solutions. For more information, see http://support.sap.com/ My Support
Knowledge Base .
● To view or report an incident, see http://support.sap.com/ My Support Incidents .
● For more information on reporting incidents for SAP Customer Activity Repository, see the Support Desk
Management section of the SAP Customer Activity Repository Administration Guide.

6.2 SAP Merchandise Planning

Post-installation of SAP Merchandise Planning .

 Note

Some of the activities in this section may have already been performed in the corresponding section under
SAP Customer Activity Repository. Such activities do not need to be repeated during the setup and
installation of consuming applications.

6.2.1 Perform Core Steps for SAP Customer Activity

Repository

To set up this application, you must first perform the Core (Mandatory) steps for SAP Customer Activity
Repository. The core steps are mandatory for all the consuming applications.

Procedure

Perform all steps listed under Core (Mandatory for All Applications) [page 73].

6.2.2 Configure SAP Merchandise Planning

Use

SAP Merchandise Planning is a consuming application of SAP Customer Activity Repository, which contains
data that is imported from SAP ERP or SAP S/4HANA into the following:

● SAP HANA for SAP ERP using SAP LT Replication Server (SLT), which is saved in the SAP_ECC authoring
schema.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 183
 Or
SAP S/4HANA using SLT, which is saved in the SAP_S4H authoring schema.
● Demand Data Foundation (DDF)

Customizing Activities

There are key Customizing activities required to use the SAP Merchandise Planning application. These steps
are performed using transaction SPRO and navigating to the required Customizing activity.

Demand Data Foundation Customizing Node

This node is accessible under Cross-Application Components .

1. Perform the necessary configuration steps in DDF.

The mandatory activities are marked in the configuration document Configure Demand Data Foundation
(DDF).
2. Configure data replication from SAP ERP to DDF.
SAP Merchandise Planning uses master data (such as product, location, and product hierarchy) as well as
organizational data (such as sales organization and distribution channel) that is replicated from SAP ERP
to DDF using DRFOUT.
This step was performed during installation as described in section SAP Customer Activity Repository
Core (Mandatory for All Applications) . See http://help.sap.com/viewer/p/CARAB <Version>
Common Installation Guide for SAP Customer Activity Repository applications bundle Set Up the
Applications .
For more information on setting up this data replication, see the following document Configuring Data
Replication from SAP ERP to DDF.
3. Verify you have entered the Merchandise Planning and Planning Configuration relevant sections in
Customizing activity Cross-Application Components Demand Data Foundation Basic Settings
Define Default Values . For more information see the documentation attached to each activity or the field
level help (F1).

 Note

Geo Hierarchy ID is only for Merchandise Planning for Retail version 1.1 or prior.

Merchandise Planning Customizing Node

As of SAP Merchandise Planning 2.0 FP2, there is a Cross Application Components Merchandise
Planning node containing mandatory steps for your implementation. Review the table below for applicable
activities for your environment. Each Customizing activity has attached documentation to further explain the
activity.

Technical Name Customizing Path Description

/RAP/ You use this BAdI to overwrite the logic and calculate the
Cross-Application
sales-related KPIs in case the default implementation is not
MPOC_CALC_SALES_KP
Components Merchandise suitable for the intended planning scenario.
I

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
184 PUBLIC Set Up the Applications
 Technical Name Customizing Path Description

Planning Enhancements Using

Business Add-Ins BAdI:

Calculate Sales KPIs for Retail

and E-Comm Channel

/RAP/ You use this BAdI to overwrite the logic to calculate the sales
Cross-Application
order and shipment related KPIs like sales-type revenue,
MPOC_SALES_ORDER_K
Components Merchandise cost, and unit. The KPIs that are related to the rejected and
PIS
returned sales orders are calculated in case default
Planning Enhancements Using
implementation is not suitable for the intended planning
Business Add-Ins BAdI: scenario.
Calculation Sales Order and

Shipment Related KPIs

/RAP/ Cross-Application You use this BAdI to overwrite logic to calculate the
MPOC_PLANNABLE_L Beginning of Period inventory KPIs in case default
Components Merchandise
OCAT implementation is not suitable for the intended planning
Planning Enhancements Using scenario.
Business Add-Ins BAdI:
Calculate Inventory KPIs like BOP

Units / Cost

/RAP/ Cross-Application You use this BAdI to overwrite logic in case default
MPR_CALCULATE_ECC_ implementation is not suitable for the intended planning
Components Merchandise
KPI scenario.
Planning Enhancements Using

Business Add-Ins BAdI: ECC

Calculate Open Qty, Goods

Receipt and Returns KPI

/RAP/ Cross-Application You use this BAdI to overwrite logic in case default
MPR_CALCULATE_FMS_ implementation is not suitable for the intended planning
Components Merchandise
KPI scenario.
Planning Enhancements Using

Business Add-Ins BAdI: FMS

Calculate Open Qty, Goods

Receipt and Returns KPI

/RAP/ You use this BAdI to overwrite logic in case default

Cross-Application
implementation is not suitable for the intended planning
MPR_CALCULATE_S4H_
Components Merchandise scenario.
KPI
Planning Enhancements Using

Business Add-Ins BAdI: S4H

Calculate Open Qty, Goods

Receipt and Returns KPI

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 185
Technical Name Customizing Path Description

/RAP/ Cross-Application You use this BAdI to determine the purchase price for goods
MPR_COST_PRC_DETE receipts, open purchase order and returns to vendor KPIs.
Components Merchandise
RM The default implementation assumes moving average price
Planning Enhancements Using is always available in the unit of measure.
Business Add-Ins BAdI: Cost
Determination for Receipt, Open

Qty and Returns

/RAP/ Cross-Application You use this BAdI to determine the calculation for goods
MPOC_CALC_PO_RECE receipt, open purchase order quantity and returns to vendor
Components Merchandise
IPTS_KPI KPIs are based on segmentation and channel.
Planning Enhancements Using

Business Add-Ins BAdI:

Calculate Goods Receipt KPIs by

Segmentation & Channel

/RAP/ Cross-Application You use this BAdI to Calculate Inventory KPIs like Beginning
MPOC_CALC_INVENTO of Period Cost and Unit Values for Distribution Centre, Store
Components Merchandise
RY_KPI and Excess Inventory Stock based on segmentation and
Planning Enhancements Using channel.
Business Add-Ins BAdI:
Calculate Inventory KPIs Based

on Segmentation & Channel

/RAP/ Cross-Application You use this BAdI: to select the season year, season,
MPOC_PLANNING_YSC collection and theme relevant data for Merchandise
Components Merchandise
T Planning.
Planning Enhancements Using

Business Add-Ins BAdI: Select

Season Year, Season, Collection

and Theme

Implementation Tasks

Use of Workbook Versions

The version concept allows you to plan and view different working versions, and to create special versions for
released and finalized plans. Each workbook can display up to two different versions in parallel, with the
capability to copy or provide a working plan version from any other available version to begin the planning
process

The version and planning levels are decided during installation. These concepts will affect your planning
configuration set and integration with SAP Assortment Planning. The recommended standard is planning at
the 5th node level of the product hierarchy (1-7 levels available). The installation will prompt you to create levels

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
186 PUBLIC Set Up the Applications
5 and 7. The workbook versions are named by concatenating the level with the version. For example the
merchandise financial plan for level 5 versions are:

● ○ Working Version - M51

○ Simulated Version - M52
○ Released Version - M5R
○ Final Version - M5F
○ In Season Version - M5P

Planning Configuration Sets

A Planning Configuration Set (PCS) is a prerequisite to creating a merchandise plan. A planning configuration
defines entry and exit levels for merchandise and option plans based on a market hierarchy (representing an
organizational view on top of retail stores and wholesale customers) and a product hierarchy. The PCS must be
specifically defined in order for the data to render properly in the workbook.

 Note

You must have an area of responsibility assigned for the product hierarchy and market hierarchy you will be
using. From your SAP Easy Access menu, use transaction code NWBC and navigate to menu Services
Maintain Area of Responsibility .

For more information about Planning Configurations see https://help.sap.com/viewer/p/CARAB and navigate
to <your version> SAP Assortment Planning Assortment Planning Manage Planning Configuration
Sets .

Integration with SAP Assortment Planning.

SAP Assortment Planning is not aware of the finalized version maintained in SAP Merchandise Planning. This
means if you want to send your merchandise plans to an assortment plan, there are setup tasks. The standard
integration is implemented in an AMDP BAdI named /DMF/MPR_READ_KPI_DATA which resides in fallback
class /DMF/CL_MPR_READ_DATA_DEFAULT. The BAdI works as follows:

● While calling the API to fetch finalized version, the assortment plan interface selects product hierarchy
node(s) of the same level as the plan. For example, based on the product hierarchy node of level 3 (or 4, 5,
6, 7), the system will automatically look for version M3F (or M4F, M5F, etc.) in case the version is not being
passed as part of the API call.
● If standard integration is used, it is recommended that final released versions should be named as M<level
of product hierarchy node>F.
● A specific custom extension is possible by implementing AMDP BAdI /DMF/MPR_READ_KPI_DATA if your
planning version used for the merchanise plan does not follow the recommended naming convention.
○ The BAdI is available using transaction code SPRO and navigating to Customizing node SAP
Customizing Implementation Guide SAP Customer Activity Repository Demand Data Foundations
Data Maintenance Planning Configuration Enhancements Using Business Add-Ins BAdI: Read
Merchandise Planning KPI Data .

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 187
6.2.3 Verify the Connection Between the SAP Merchandise
Planning System and SAP Analysis for Microsoft
Office

The SAP Merchandise Planning application includes several SAP Analysis for Microsoft Office workbooks.
These workbooks, which are installed on your back-end system as part of the local BI Content, can only be
opened using SAP Analysis for Microsoft Office.

In this step, you verify that you can open the SAP Merchandise Planning workbooks from SAP Analysis for
Microsoft Office.

1. Open SAP Analysis for Microsoft Office from Start All Programs SAP Business Intelligence SAP
BusinessObjects Analysis Analysis for Microsoft Excel .
2. From the File menu, select Analysis Open Workbook (Open Workbook from SAP NetWeaver) .
3. Select your back-end system.
Tip: The list of systems corresponds to the systems available in your SAP Logon.
4. If single sign-on is not configured provide your user information.
5. Search for /RAP/MP* on the Search tab.
6. Open any of the workbooks from the list of SAP Merchandise Planning workbooks.
The opening of the workbook indicates that there are no issues with the connection between your back-
end system and SAP Analysis for Microsoft Office.

6.2.4 Activate SAP Merchandise Planning Omnichannel BI

Planning Framework Content

The planning framework used by SAP Merchandise Planning consists of the following elements:

● Business Intelligence Content (BI Content) Objects: A collection of local BI Content objects is used as
the basis for the SAP Analysis for Microsoft Office workbooks.
SAP Analysis for Microsoft Office workbooks are designed to consume data from BI Content objects. The
local BI Content objects that are provided with the SAP Merchandise Planning application use the
integrated planning engine in SAP Business Warehouse (SAP BW). These local BI Content objects are used
as an interface between the SAP HANA views and the SAP Analysis for Microsoft Office workbooks.

 Note

The local BI Content provided with the SAP Merchandise Planning application is entirely independent
of the SAP Business Warehouse BI Content and BI Content Extensions add-on.

● SAP Analysis for Microsoft Office Workbooks: Microsoft Excel-based spreadsheets that you use to plan
assortments for the different locations in your retail business.

This section of the guide provides information on the SAP HANA content activation, BI Content activation and
configuration, and data upload activities required to set up the SAP Merchandise Planning planning framework.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
188 PUBLIC Set Up the Applications
6.2.4.1 Activate SAP HANA Content for SAP Merchandise
Planning

Activate all SAP HANA Transport for ABAP (HTA) objects that are required for SAP Merchandise Planning
application.

Prerequisites

As a mandatory prerequisite for a successful activation of SAP HANA content for SAP Merchandise Planning,
you must have successfully completed all of the procedures listed in the previous sections of this guide as
pertains to SAP Customer Activity Repository Core (Mandatory for All Applications) . In particular, you
must have created all the necessary tables, as described in Create/Replicate Source Master Data System
Tables [page 81].

You must also have mapped all the necessary schemas, as described in Verify Correct Schema Mapping [page
43].

Context

In this procedure you perform the final activation of SAP HANA content (views and stored procedures) required
by the SAP Merchandise Planning application. This final activation results in a full activation of the SAP HANA
content for SAP Merchandise Planning. Several SAP HANA views depend on local BI Content objects. The SAP
HANA views have to be activated before activating the BI Content objects as described in Activate Application
BI Content [page 191] .

For more information, see https://help.sap.com/viewer/p/SAP_HANA_PLATFORM, choose the SAP HANA

Developer Guide and search for section Activating Objects.

Procedure

1. Log on to SAP HANA studio.

2. Open the Modeler and use the Navigator to access your back-end system.
3. Expand the Content folder located under your system name in the Navigator.
4. Expand the listed packages to verify the underlying folders listed below are active.

Based on the selected ECC Mode in the above report the following packages should exist:
○ SAP ERP:
○ sap.is.ddf.ecc
○ Fashion Management:
○ sap.is.ddf.ecc
○ sap.is.ddf.fms

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 189
 ○ S/4HANA:
○ sap.is.ddf.fms_s4h
5. The following packages should exist resulting from the standard installation:
○ sap.is.ddf.ddf
○ sap.is.retail.rap.ap
○ sap.is.retail.rap.common_bw
○ sap.is.retail.rap.mpr
○ sap.is.retail.rap.mpr_oc

If any of these packages are missing, you must activate those relative to the order above due to
dependencies. Use transaction SCTS_HTA_DEPLOY to activate each missing package.

6.2.4.2 Activate SAP Merchandise Planning Technical BI

Content

Procedure

1. On your back-end system, open the Data Warehousing Workbench (transaction RSA1).
2. In the Replicate Metadata dialog box, choose Only Activate.
3. If a message appears that you are only authorized to work in client. (Brain 009), then refer to SAP Note
316923 (do not import the support package, but use the description under section Workaround).
4. Select Do not show this question Again in the dialog that appears.
5. Choose Yes.
Make sure that the current job has finished before you proceed with the next step. Check the status of the
background job using transaction SM37or SLG1. If there are problems, you must first solve them.
You can use transaction RSTCO_ADMIN to restart the activation of the technical content and to verify the
status of the activation.

 Note

In the case that you get the short-dump "RAISE_EXCEPTION" when installing InfoObjects from the BI
content, see SAP Note 1637935 for a possible solution.

Also, see SAP Note 2090845 for important information on technical content activation.

Following activation, you can locate the technical content in the Data Warehousing Workbench as follows:
1. Selecting Modeling in the left-hand frame.
2. Expand InfoObjects.
3. In the right-hand frame, locate Technical Content.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
190 PUBLIC Set Up the Applications
6.2.4.3 Activate Application BI Content

Use

 Caution

Proper authorization is required to complete these steps.

These instructions are to activate content for the InfoArea Merchandise Planning Omni Channel (/RAP/MPOC).
This will activate the following object types:

● InfoObjects
● Advanced DataStore Objects (aDSO)
● Composite Providers
● Aggregation Levels
● Planning Sequences
● Queries
● Workbooks

After completing the activate sections, see the last section of this topic, Verify Installed Objects to insure all
objects have been installed and activated.

Roles/Authorization

1. The application user running the activation/deployment should have the following roles:
○ SAP_ISR_DDF_MASTER
○ SAP_ISR_AP_MASTER
○ /RAP/BW_AP_WORKBOOKS
○ /RAP/BW_MPR_WORKBOOKS
2. The database user should have the following privileges/roles:
○ Privilege ROLE ADMIN
○ Privilege STRUCTUREDPRIVILEGE ADMIN
○ Privilege EXECUTE on procedure TRUNCATE_PROCEDURE_OBJECTS
○ Privilege EXECUTE on procedure GET_PROCEDURE_OBJECTS
○ Role CONTENT_ADMIN
○ Role USER
○ Privilege EXECUTE on procedure TRUNCATE_PROCEDURE_OBJECTS
○ Privilege EXECUTE on procedure GET_PROCEDURE_OBJECTS
3. Ensure that each SAP BW/HANA application user have at least the following set of privileges to activate BI
contents:
○ Privilege SELECT on schema _SYS_BI
○ Privilege SELECT on schema SAP<SID>
○ Privilege EXECUTE on procedure REPOSITORY_REST

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 191
 ○ Privilege REPO.READ on package bw2hana/SAP<SID>_/RAP/<Infocube>_REPORTING
○ The corresponding privileges are created automatically when activating BI content

See Perform Core Steps for SAP Customer Activity Repository [page 183] to ensure all core mandatory steps
are performed.

Activate Advanced DataStore Objects

 Note

A window being referenced, may be hidden. Use the Data Warehousing Workbench menu in the main
window title bar to hide/unhide the following windows: Navigation, All Objects, and Collected Objects.

● Use transaction RSOR to launch the BW workbench BI Content.

● In the navigation window, locate and select Object Types. In the window All Objects According to Types,
expand node DataStore Objects (advanced) and double click Select Objects. In the popup window, select
the following objects and select button Transfer Selections.

DataStore Object (advanced)

aDSO Description aDSO

Market Hierarchy CR based on Planning Configuration Set /RAP/MHDS1

Market Hierarchy CR aDSO for LY and LLY /RAP/MHDS2

aDSO for actuals of LY and LLY KPIs /RAP/MPDS0

MP - Regional Month Sales Target for Omni Channel /RAP/MPDS1

MP - Local Month Sales Inventory Targets for Retail and E- /RAP/MPDS2

Co

MP - Local Month Sales and Inventroy Targets for Whol­ /RAP/MPDS3

sale

Product Hierarchy CR based on Planning Configuration /RAP/PHDS1

Set

Product Hierarchy CR aDSO for LY and LLY /RAP/PHDS2

Merchandise Plan YSCT Characteristic Relationship /RAP/SCTDS

● Select Yes to the system prompt Do you want to add the objects to the personal list.
● When prompted for Source System, do not choose any and select OK.
● For each aDSO, right click on the object and select option Install All Below.
● Install and Activate each aDSO.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
192 PUBLIC Set Up the Applications
Activate Analysis Office Excel Workbooks 2.0

In this section you will continue from the above step and activate the workbooks. :

● From the left navigation panel for BI Content locate and expand folder More Types. Expand Analysis Office
Excel Workbook and double click Select Objects. Use the filter in the popup window to define a filter on
column Object Name having values of /RAP/MP_*.
In the pop up window, select the following objects and select button Transfer Selections.

Workbooks
Object Name

/RAP/MP_ECOM_PHN5_WB_01

/RAP/MP_OTB_OTS_PHN5_WB_01

/RAP/MP_OTB_OTS_PHN5_WB_02

/RAP/MP_RTL_PHN5_WB_01

/RAP/MP_RT_PHN5_M_WB_01

/RAP/MP_RT_PHN7_WB_01

/RAP/MP_RT_SSN_PHN5

/RAP/MP_WHS_PHN5_M_WB_01

● Select Yes to the system prompt Do you want to add the objects to the personal list.
● For each workbook, right click and select option Install All Below.
● Install and Activate each workbook.

Activate Planning Sequence

In this section you will activate the Planning Sequence, Planning Function used for loading last year actual data,
From the left navigation panel for BI Content locate and select Object Types. In the All Objects According to Type
window, perform the following:

● Locate and expand Planning, Planning Sequence.

1. Planning Sequences that begin with the value /RAP/C15A belong to the Merchandise Planning 4.0
application and should be activated.
2. Double click Select Objects and use the filter in the popup window to define a filter on column Object
Name having values of /RAP/MPDS*. In the results, use the Transfer Selections button to transfer the
planning sequences listed in the table below to the Collected Objects, then Install.

Planning Sequence
Planning Sequence

/RAP/MHDS2_A3_PS01

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 193
Planning Sequence

/RAP/MHDS2_A3_PS02

/RAP/MPDS0_A0_PS01

/RAP/MPDS0_A0_PS02

/RAP/MPDS0_A0_PS03

/RAP/MPDS0_A2_PS01

/RAP/MPDS1_A1_PS01

/RAP/MPDS1_A1_PS02

Verify Installed Objects

Verify the installed objects exist using the associated tables below.

DataStore Object (advanced)

aDSO Description aDSO

Market Hierarchy CR based on Planning Configuration Set /RAP/MHDS1

Market Hierarchy CR aDSO for LY and LLY /RAP/MHDS2

aDSO for actuals of LY and LLY KPIs /RAP/MPDS0

MP - Regional Month Sales Target for Omni Channel /RAP/MPDS1

MP - Local Month Sales Inventory Targets for Retail and E-Co /RAP/MPDS2

MP - Local Month Sales and Inventroy Targets for Wholsale /RAP/MPDS3

Product Hierarchy CR based on Planning Configuration Set /RAP/PHDS1

Product Hierarchy CR aDSO for LY and LLY /RAP/PHDS2

Merchandise Plan YSCT Characteristic Relationship /RAP/SCTDS

InfoObject Catalog (RAP)

Catalog Description Catalog Name

RAP Character InfoObject Catalog /RAP/CHAR_CAT

RAP Key Figure InfoObject Catalog /RAP/KYF_CAT

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
194 PUBLIC Set Up the Applications
InfoObjects Characteristics

InfoObject Description InfoObject Name

Logical System ID /RAP/LOGSYS

Planning Configuration Node /RAP/PLCND

Planning Configuration Set /RAP/PLCSET

Market Hierarchy Node on Level 1 /RAP/PLNHN1

Market Hierarchy Node on Level 2 /RAP/PLNHN2

Market Hierarchy Node on Level 3 /RAP/PLNHN3

Market Hierarchy Node on Level 4 /RAP/PLNHN4

Market Hierarchy Node on Level 5 /RAP/PLNHN5

Market Hierarchy Node on Level 6 /RAP/PLNHN6

Market Hierarchy Node on Level 7 /RAP/PLNHN7

Market Hierarchy Node on Level 8 /RAP/PLNHN8

Market Hierarchy Node on Level 9 /RAP/PLNHN9

Market Hierarchy /RAP/PLNHR

Planning Process Level /RAP/PLPLVL

Markdown Sales Revenue /RAP/MRKDRV

Markdown Sales Units /RAP/MRKDSU

Product Hierarchy Node on Level 1 /RAP/PRDHN1

Product Hierarchy Node on Level 2 /RAP/PRDHN2

Product Hierarchy Node on Level 3 /RAP/PRDHN3

Product Hierarchy Node on Level 4 /RAP/PRDHN4

Product Hierarchy Node on Level 5 /RAP/PRDHN5

Product Hierarchy Node on Level 6 /RAP/PRDHN6

Product Hierarchy Node on Level 7 /RAP/PRDHN7

Product Hierarchy Node on Level 8 /RAP/PRDHN8

Product Hierarchy Node on Level 9 /RAP/PRDHN9

Product Hierarchy /RAP/PRDHR

Promotion Sales Revenue /RAP/PROMRV

Promotion Sales Units /RAP/PROMSU

Returns Revenue Loss /RAP/RETRRV

Regular Sales Revenue /RAP/RSLSRV

Regular Sales Units /RAP/RSLSUN

Collection /RAP/SCOLL

Sales Cost /RAP/SLSCV

Sales Revenue /RAP/SLSRV

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 195
InfoObject Description InfoObject Name

Sales Units /RAP/SLSUN

Season /RAP/SSEAS

Season Year /RAP/SSYR

Theme /RAP/STHEME

Version /RAP/VERSN

InfoObjects Key Figures

InfoObject Description InfoObject Name

BOP DC Excess Stock at Cost /RAP/BDEXCV

BOP DC Stock at Cost /RAP/BDCCV

BOP Store Stock at Cost /RAP/BSTCV

Channel Count /RAP/CHCNT

End of Period Stock DC Cost Value /RAP/EDCCV

EOP DC Excess Stock at Cost /RAP/EDEXCV

EOP Store Stock at Cost /RAP/ESTCV

Inventory Adjustment at Cost /RAP/IADCV

Markdown Budget /RAP/MRKBUD

Markdown Sales Revenue /RAP/MRKDRV

Markdown Sales Units /RAP/MRKDSU

Month Of Supply Store /RAP/MOSUP

Month Of Supply at DC /RAP/MOSUPD

On Order Cost DC /RAP/DCOCV

On Order Units DC /RAP/DCOUN

On Order Units Store /RAP/ONOUN

On Order Cost Store /RAP/ONOCV

Open Sales Order Cost /RAP/SOOCV

Open Sales Order Units /RAP/SOOUN

Open to Sale at Cost /RAP/OTSC

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
196 PUBLIC Set Up the Applications
 InfoObject Description InfoObject Name

OTB at Cost /RAP/OTBC

Promotion Budget /RAP/PROBUD

Promotion Sales Revenue /RAP/PROMRV

Promotion Sales Units /RAP/PROMSU

Receipt DC at Cost /RAP/RDCCV

Receipt Store at Cost /RAP/RDTCV

Receipt Units DC /RAP/RCPUND

Receipt Units Store /RAP/RCPUNS

Regular Sales Revenue /RAP/RSLSRV

Regular Sales Units /RAP/RSLSUN

Return Units DC /RAP/DCREUN

Return Units Store /RAP/RETRUN

Returns at Cost DC /RAP/DCRECV

Returns at Cost Store /RAP/RETRCV

Returns Revenue Loss /RAP/RETRRV

Sales at Cost /RAP/SLSCV

Sales Order Intake Revenue /RAP/SOIRV

Sales Order Rejection Cost /RAP./SORCV

Sales Order Rejection Units /RAP/SORUN

Sales Revenue /RAP/SLSRV

Sales Store Fulfilled at Cost /RAP/STSCV

Sales Units /RAP/SLSUN

Shipment Fulfilled at Cost /RAP/SHPCV

Write Off Adjustment at Cos /RAP/WOFFAD

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 197
Composite Providers

Composite Provider Description Composite Provider

Merchandise Financial Plan Omni Channel /RAP/CP15

Aggregation Levels

Aggregation Description Aggregation Name

MP Regional Targets Sales Mix - PHN 5 /RAP/C15A01

MP Regional Targets SSN Sales Mix - PHN 5 /RAP/C15A02

MP Regional Targets SSN Sales Mix - PHN 7 /RAP/C15A03

MP Local Targets - ECommerce - Sales Mix - PHN 5 /RAP/C15A11

MP Local Targets - ECommerce - Sales Mix - PHN 5 - PF RAP/C15A12

MP Local Targets - Retail - Sales Mix - PHN 5 /RAP/C15A21

MP Local Targets - Retail - Sales Mix - PHN 5 - PF /RAP/C15A22

MP Local Targets - WHS - Sales Mix - PHN 5 /RAP/C15A31

MP Local Targets - WHS - Sales Mix - PHN 5 - PF /RAP/C15A32

MP - OTB - Retail - ECom - WHS /RAP/C15A41

AL for Market Hier CR for LY and LLY /RAP/MHDSA2

Product Hierarchy CR based on Planning Configuration Set /RAP/PHDSA1

SCT CR based on Planning Configuration Set /RAP/SCTDA1

AL for Product Hier CR for LY and LLY /RAP/PHDSA2

Market Hierarchy Aggregation Level /RAP/MHDSA1

AL for Actuals of LY and LLY KPIs /RAP/MPDSA0

Planning Sequence

Workbook Function Planning Sequence

1.1 Regional Monthly Plan Planning sequence for Ribbon in AO /RAP/C15A01_PS00

1.1 Regional Monthly Plan Delete /RAP/C15A01_PS01

1.1 Regional Monthly Plan Release /RAP/C15A01_PS02

1.1 Regional Monthly Plan Copy /RAP/C15A01_PS03

1.1 Regional Monthly Plan Bottom Up /RAP/C15A01_PS04

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
198 PUBLIC Set Up the Applications
 Workbook Function Planning Sequence

1.2 Regional Seasonal Plan Planning sequence for Ribbon in AO /RAP/C15A02_PS00

1.2 Regional Seasonal Plan Delete /RAP/C15A02_PS01

1.2 Regional Seasonal Plan Release /RAP/C15A02_PS02

1.2 Regional Seasonal Plan Top Down /RAP/C15A02_PS03

1.2 Regional Seasonal Plan Copy /RAP/C15A02_PS04

1.2 Regional Seasonal Plan Bottom Up /RAP/C15A02_PS05

1.3 Regional Seasonal Plan Planning sequence for Ribbon in AO /RAP/C15A03_PS00

1.3 Regional Seasonal Plan Delete /RAP/C15A03_PS01

1.3 Regional Seasonal Plan Release /RAP/C15A03_PS02

1.3 Regional Seasonal Plan Top Down /RAP/C15A03_PS03

1.3 Regional Seasonal Plan Copy /RAP/C15A03_PS04

4.1 Ecommerce Monthly Plan Planning sequence for Ribbon in AO /RAP/C15A12_PS00

4.1 Ecommerce Monthly Plan Delete /RAP/C15A12_PS01

4.1 Ecommerce Monthly Plan Release /RAP/C15A12_PS02

4.1 Ecommerce Monthly Plan Copy /RAP/C15A12_PS03

4.1 Ecommerce Monthly Plan Top Down /RAP/C15A12_PS04

4.1 Ecommerce Monthly Plan Initialize BOP - M /RAP/C15A12_PS05

4.1 Ecommerce Monthly Plan Re-calculate BOP /RAP/C15A12_PS06

4.1 Ecommerce Monthly Plan Initialize BOP - T /RAP/C15A12_PS07

4.1 Ecommerce Monthly Plan Initialize BOP - P /RAP/C15A12_PS08

2.1 Retail Monthly Plan Planning sequence for Ribbon in AO /RAP/C15A22_PS00

2.1 Retail Monthly Plan Delete /RAP/C15A22_PS01

2.1 Retail Monthly Plan Release /RAP/C15A22_PS02

2.1 Retail Monthly Plan Copy /RAP/C15A22_PS03

2.1 Retail Monthly Plan Initialize BOP - M /RAP/C15A22_PS04

2.1 Retail Monthly Plan Top Down /RAP/C15A22_PS05

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 199
Workbook Function Planning Sequence

2.1 Retail Monthly Plan Initialize BOP - T /RAP/C15A22_PS06

2.1 Retail Monthly Plan Initialize BOP - P /RAP/C15A22_PS07

2.1 Retail Monthly Plan Re-calculate BOP /RAP/C15A08_PS08

3.1 Wholesale Monthly Plan Planning sequence for Ribbon in AO /RAP/C15A32_PS00

3.1 Wholesale Monthly Plan Delete /RAP/C15A32_PS01

3.1 Wholesale Monthly Plan Release /RAP/C15A32_PS02

3.1 Wholesale Monthly Plan Copy /RAP/C15A32_PS03

3.1 Wholesale Monthly Plan Top Down /RAP/C15A32_PS04

3.1 Wholesale Monthly Plan Initialize BOP - M /RAP/C15A32_PS05

3.1 Wholesale Monthly Plan Initialize BOP - T /RAP/C15A32_PS06

3.1 Wholesale Monthly Plan Initialize BOP - P /RAP/C15A32_PS07

3.1 Wholesale Monthly Plan Re-calculate BOP /RAP/C15A32_PS08

5.1 OTB & OTS Reconciliation Planning sequence for Ribbon in AO /RAP/C15A41_PS00

5.1 OTB & OTS Reconciliation MP - OTB - Reconciliation /RAP/C15A41_PS01

5.1 OTB & OTS Reconciliation MP - OTB - Reconciliation - Finalize /RAP/C15A41_PS02

5.2 OTB & OTS Reconciliation - Season Planning sequence for Ribbon in AO /RAP/C15A42_PS00

5.2 OTB & OTS Reconciliation - Season MP - OTB - Reconciliation /RAP/C15A42_PS01

5.2 OTB & OTS Reconciliation - Season MP - OTB - Reconciliation - Finalize /RAP/C15A42_PS02
Final

Queries

Query Name Technical Name

MP - Regional Targets - Prompt Query - PHN5 /RAP/CP15A01_Q01

MP - Regional Targets - Sales Mix - PHN5 /RAP/CP15A01_IRQ01

MP - Regional Targets - Season Prompt Query - PHN5 /RAP/CP15A02_Q01

MP - Regional Targets - Season Flow - PHN5 /RAP/CP15A02_IRQ00

MP - Regional Targets - Season Sales Mix - PHN5 /RAP/CP15A02_IRQ01

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
200 PUBLIC Set Up the Applications
 Query Name Technical Name

MP - Regional Targets - Season Flow Chart - PHN5 /RAP/CP15A02_Q00

MP - Regional Targets - Season Flow - PHN7 /RAP/C15A03_IRQ00

MP - Regional Targets - Season Sales Mix - PHN7 /RAP/CP15A03_IRQ01

MP - Regional Targets - Season Flow Chart - PHN7 /RAP/CP15A03_Q00

MP - Regional Targets - Prompt Query - PHN7 /RAP/CP15A03_Q01

MP - Local Targets - ECom - Sales Mix - PHN5 /RAP/CP15A11_IRQ01

MP - Local Targets - ECom - Inventory Mix - PHN5 /RAP/CP15A11_IRQ02

MP - Local Targets - ECom - Prompt Query - PHN5 /RAP/CP15A11_Q01

MP - Local Targets - Rtl - Sales Mix - PHN5 /RAP/CP15A21_IRQ01

MP - Local Targets - Rtl - Inventory Mix - PHN5 /RAP/CP15A21_IRQ02

MP - Local Targets - Rtl - Prompt Query - PHN5 /RAP/CP15A21_Q01

MP - Local Targets- WHS - Sales Mix - PHN5 /RAP/CP15A31_IRQ01

MP - Local Targets - WHS - Inventory Mix - PHN5 /RAP/CP15A31_IRQ02

MP - Local Targets - WHS - Prompt Query - PHN5 /RAP/CP15A31_Q01

MP - OTB Reconciliation Report - Prompt Query /RAP/CP15_Q001

MP - OTB Reconciliation Report /RAP/CP15_Q01

MP - OTB Reconciliation Season Prompt Query /RAP/CP15_Q002

MP - OTB Reconciliation Report - Season /RAP/CP15_Q02

Workbooks

Workbook Description Workbook Technical Name

1.1 Regional Monthly Plan /RAP/MP_RT_PHN5_M_WB_01

1.2 Regional Seasonal Plan /RAP/MP_RT_SSN_PHN5

1.3 Regional Seasonal Plan /RAP/MP_RT_PHN7_WB_01

2.1 Retail Monthly Plan /RAP/MP_RTL_PHN5_WB_01

3.1 Wholesale Monthly Plan /RAP/MP_WHL_PHN5_M_WB_01

4.1 Ecommerce Monthly Plan /RAP/MP_ECOM_PHN5_WB_01

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 201
Workbook Description Workbook Technical Name

5.1 OTB & OTS Reconciliation /RAP/MP_OTB_OTS_PHN5_WB_01

5.2 OTB & OTS Seasonal Reconciliation /RAP/MP_OTB_OTS_PHN5_WB_02

Change aDSO Behavior

You must change the loading behavior for each aDSO. Select the InfoProvider node under Modeling. Locate the
central InfoProvider column and expand the Merchandise Planning Omni Channel change the loading
behavior for each aDSO. To change the loading the behavior, locate each object in the DataStore (advanced)
table above and then right click to select Planning-Specific Properties Change Real-Time Load Behavior.
Select radio button Real-Time Target Can Be Planned; Data Loading Not Allowed.

6.2.4.4 Configure SAP Merchandise Planning Local BI

Content

6.2.4.4.1 Enable the Planning Application Kit (PAK)

Use

To be able to use the SAP Analysis for Microsoft Office workbooks provided as part of the SAP Assortment
Planning planning framework content, you must enable the Planning Application Kit.

Procedure

1. Read SAP Note 1637199 .

2. In your back-end system, launch table/view maintenance (transaction SM30).
3. Enter RSPLS_HDB_ACT in the Table/View field and choose Maintain.
4. Choose New Entries.
5. In the HANA Integration Active column select Deep HANA Integration Active and in the Function
Active column, enable the checkbox.

6.2.4.4.2 Maintain RSADMIN Parameter for Input Cells

In this procedure, you maintain the RSADMIN parameter for Input Cells in the SAP BW application to suppress
zero values for actual data versions.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
202 PUBLIC Set Up the Applications
 1. Log on to your back-end system.
2. Open the ABAP Editor (transaction SE38).
3. Run program SAP_RSADMIN_MAINTAIN
4. In RSAD Table Maintenance, insert ZERO_SUPPRESSION_ON_INPUTCELLS in OBJECT and Execute.

 Posting Instructions

Refer to 1126478

for further information.

6.2.4.4.3 Generate Missing Data Reports

Use

There are two reports required to populate supporting tables for SAP Merchandise Planning for Omnichannel
2.0 and above.

Procedure

The first report will generate entries for /RAP/RS_VARCUSTS table.

● Use transaction code. SE38 and enter /RAP/SEED_BW_CUSTOMIZING_DATA in the Program field. Use the
Execute button to run the report.

The second report is only for SAP Merchandise Planning for Retail 1.0 or (1.1) and is used to set the session
client on the HANA system.

● Use transaction code. SE38 and enter /RAP/MPR_REPORTING_CLIENT in the Program field. Use the
Execute button to run the report.

6.2.4.4.4 Maintain Fiscal Year Variants

Use

In this section you maintain the required fiscal year variant values for the Retail Month (RM) and the Retail
Week (RW). These instructions are for SAP Merchandise Planning 1.0 FP2 or later. In addition, the years used in
the examples are to depict the relationship between the years. You will need to create the range of years
applicable for your implementation.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 203
  Caution

SAP Merchandise Planning uses activated time objects 0FISCPER (fiscal year period) and 0FISCVARNT
(fiscal year variant), provided as part of the technical BI Content If you are supporting both Retail Week
and Month Variants, begin with the RW procedure and then RM thereafter.

 Note

SAP Merchandise Planning for Retail 1.0 Workbooks supports time hierarchy YR/MON. For more
information please see Maintain Time Hierarchy [page 213].

Procedure

Fiscal Variant Retail Month

You must maintain 0FISCVARNT 'RM' using the standard 12 month calendar entries. If you are using
alternative fiscal periods in your business, you can provide your own entries instead of the ones suggested in
this guide.

1. Log on to your back-end system.

2. Launch the fiscal year variant maintenance (transaction GVAR). Choose New Entries.
3. In the Fiscal Year Variants view, choose New Entries.
4. On the New Entries: Overview of Added Entries screen make the following sets of entries:

Field Name User Entry

FV RM

Description Planning month

Calendar yr Do not select

Year- Select
dependent

Number of 12
period
postings

No.of
special
periods

5. Choose Enter.
6. Choose Back.
You can see the newly created entry.
7. Mark the entry RM and select Periods from the Dialog Structure and double click to open the Calendar year
dialog.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
204 PUBLIC Set Up the Applications
 8. Enter the year, for example 2014, in the Calendar yr field and choose Continue.
9. Choose New Entries. For the year selected to enter the information that will define each period.
10. Enter the last valid calendar date of the period being added in the Month and Day fields.
11. Enter the relevant Period number.
12. In the Year Shift field, enter +1 if the fiscal year is later than the calendar year enter. Enter -1 if the fiscal year
is before the calendar year.
13. Press Enter to accept the first row.
14. Continue adding each period to complete the fiscal year. Choose Save after you have finished the entries
for a year.
15. Continue adding the fiscal year variants for each year required by your scenario by repeating steps 2-13.
16. For more information about setting up the calendar for additional years, see SAP Note 2112634 . Note
that this SAP Note is applicable for both SAP Merchandise Planning and SAP Assortment Planning.
17. Choose Save after you have finished the maintenance for the last year.

2015 Monthly Calendar (sample)

Month Day Period Year Shift

1 31 12 -1

2 28 1 0

3 28 2 0

5 2 3 0

5 30 4 0

6 27 5 0

8 1 6 0

8 29 7 0

9 26 8 0

10 31 9 0

11 28 10 0

12 26 11 0

12 31 12 0

6.2.4.4.4.1 Retail Weekly

In this procedure you maintain the required fiscal year variant ( 0FISCVARNT 'RW').

The steps provided in this procedure allow you to maintain 0FISCVARNT 'RW' using the standard 4-5-4
calendar entries. If you are using alternative fiscal periods in your retail business, for example, each week

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 205
starting on a Sunday instead of Saturday, you can provide your own entries instead of the ones suggested in
this guide.

Procedure

1. Log on to your back-end system.

2. Launch fiscal year variant maintenance (transaction GVAR).
3. Choose New Entries.
4. On the New Entries: Overview of Added Entries screen make the following sets of entries:

Create New Fiscal Year Variant

5. Choose Enter.
An information message is displayed about creating more than 16 periods, choose Continue.
6. Choose Back.
You can see the newly created entry.
7. Mark the entry RW and select Shortened Fiscal Years from the Dialog Structure.

Shortened Fiscal Years in Dialog Structure

8. In the Fiscal year dialog, enter the year (for example, 2015 ) in the Fiscal year field and choose Continue.
9. On the Change View "Shortened Fiscal Years": Overview screen, choose New Entries.
10. In the Shortened Fiscal Years table, enter 52 in the No. of posting periods field.
11. Choose Back twice.
12. On the Change View "Fiscal Year variants": Overview screen, mark the entry RW and select Periods from the
Dialog Structure.
13. In the Calendar yr dialog, enter the year (for example, 2015 ) in the Calendar yr field and choose Continue.
Data for the previous year must be maintained.
14. On the Change View "Periods": Overview screen, choose New Entries.
15. In the Periods table, enter the data (month, day, period, year shift) for each period according to your fiscal
calendar. For an example, see the following table. For more examples, see SAP Note 2112634 . If you
want to copy data from this note, locate the required year and enter the data by copy-and-paste.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
206 PUBLIC Set Up the Applications
 2015 Weekly Calendar

Month Day Period Year Shift

1 3 48 -1

1 10 49 -1

1 17 50 -1

1 24 51 -1

1 31 52 -1

2 7 1 0

2 14 2 0

... .. ... ...

16. Repeat steps 7-15 to maintain the weekly fiscal year variant for all of the required years, entering each year
as shortened fiscal year. The corresponding tables are available in SAP Note 2112634 .
17. Choose Save.
18. Launch transaction RSRHIERARCHYVIRT and ensure that the dates specified in the From and To fields
under Time Interval cover the years maintained for the fiscal year variant in the previous steps.

6.2.4.4.4.2 Retail Monthly

In this section, you maintain the required fiscal year variant values for the fiscal month, 'RM'.

Procedure

Fiscal Variant Retail Month

You must maintain 0FISCVARNT 'RM' using the standard 12 month calendar entries. If you are using
alternative fiscal periods in your business, you can provide your own entries instead of the ones suggested in
this guide.

1. Log on to your back-end system.

2. Launch the fiscal year variant maintenance (transaction GVAR). Choose New Entries.
3. In the Fiscal Year Variants view, choose New Entries.
4. On the New Entries: Overview of Added Entries screen make the following sets of entries:

Field Name User Entry

FV RM

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 207
 Field Name User Entry

Description Planning month

Calendar yr Do not select

Year- Select
dependent

Number of 12
period
postings

No.of
special
periods

5. Choose Enter.
6. Choose Back.
You can see the newly created entry.
7. Mark the entry RM and select Periods from the Dialog Structure and double click to open the Calendar year
dialog.
8. Enter the year, for example 2014, in the Calendar yr field and choose Continue.
9. Choose New Entries. For the year selected to enter the information that will define each period.
10. Enter the last valid calendar date of the period being added in the Month and Day fields.
11. Enter the relevant Period number.
12. In the Year Shift field, enter +1 if the fiscal year is later than the calendar year enter. Enter -1 if the fiscal year
is before the calendar year.
13. Press Enter to accept the first row.
14. Continue adding each period to complete the fiscal year. Choose Save after you have finished the entries
for a year.
15. Continue adding the fiscal year variants for each year required by your scenario by repeating steps 2-13.
16. For more information about setting up the calendar for additional years, see SAP Note 2112634 . Note
that this SAP Note is applicable for both SAP Merchandise Planning and SAP Assortment Planning.
17. Choose Save after you have finished the maintenance for the last year.

2015 Monthly Calendar (sample)

Month Day Period Year Shift

1 31 12 -1

2 28 1 0

3 28 2 0

5 2 3 0

5 30 4 0

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
208 PUBLIC Set Up the Applications
 Month Day Period Year Shift

6 27 5 0

8 1 6 0

8 29 7 0

9 26 8 0

10 31 9 0

11 28 10 0

12 26 11 0

12 31 12 0

6.2.4.4.5 Generate Time Relations Data for Planning based

on the Fiscal Calendar

Usa

Execution of the RSR_TIME_RELATION_HDB report is required to populate supporting tables for the time
relations data for planning based on the fiscal calendar.

Prerequisite

This report requires that fiscal calendars are currently maintained for the fiscal variants that are expected to be
used for planning.

Procedure

The report will generate entries for the RSR_REL_TIME_FIS table and the RSR_TIME_REL_FIS table.

Use transaction code SE38 and enter RSR_TIME_RELATION_HDB in the program field. Use the Execute button
to run the report.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 209
6.2.4.4.6 Maintain Versions

In this step, you maintain the master data for the InfoObject /RAP/VERSN to support versions in workbooks.

1. Launch HANA Studio, and open perspective BW Modeler. Open your BW Project and expand BW
Repository. Navigate to /RAP/MPOC Aggregation Level . Expand any object built on /RAP/C15A*
and navigate to a query. Open the query and navigate to the InfoProvider tab.
2. Expand InfoProvider Fields General . Open field /RAP/VERSN. In the Properties tab select the Master
Data link.
3. You are on the Change Master Data of InfoObject /RAP/VERSN maintenance screen.
4. Select the section below matching the scenario of workbooks you will be using to enter the correct
information.
Be sure to save your entries and close the window.

Merchandise Planning 2.0 and Above

The default workbooks are planned at product hierarchy node levels 5 and 7. Entries for those are listed in the
table below. For more information about versions see https://help.sap.com/viewer/p/CARAB <Version>
Administration SAP Merchandise Planning Administration Guide Configuration Information Configure
SAP Merchandise Planning Implementation Tasks .

Merchandise Planning Versions 2.0

Version Text

M51 Working Version

M52 Simulation Version

M5F Finalized Version

M5R Reporting Version

M71 Working Version

M72 Simulation Version

M7F Finalized Version

M7R Reporting Version

0 Actuals

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
210 PUBLIC Set Up the Applications
6.2.4.4.7 Activate Internet Communication Framework
(ICF) Services

For security reasons, all Internet Communication Framework (ICF) services relevant to your SAP Merchandise
Planning application are made available in an inactive state.

In this procedure, you activate the ICF service.

1. Log on to your back-end system.

2. Open the HTTP Service Hierarchy Maintenance screen (transaction SICF).
3. Enter the following data:

Field name User action and values

Hierarchy Type SERVICE

4. Choose Execute.
5. On the Maintain Service screen, expand the hierarchy of Default_host.
6. Expand SAP.
7. Select the BW entry.
8. From the context menu choose Activate service.
9. In the confirmation dialog box, choose Yes to activate all sub-nodes below the BW node in the hierarchy.
10. Choose Back.

6.2.4.4.8 Connect File System in SAP BW (Optional)

In this procedure, you perform the settings that are necessary for the connectivity for an external system - PC
files on the Workstation (for example Excel files) or files on the application server in SAP BW.

1. Log on to your back-end system.

2. Open the Data Warehouse Workbench: Modeling screen (transaction RSA1).
3. Choose Modeling.
4. Choose Source Systems.
5. In the right-hand frame, mark the entry File.
6. Right-click the folder of File.
7. Choose Create.
8. Enter the following data:

Field name User action and values

Logical system name FILE

Source system name FILE

9. Choose Continue.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 211
10. Right-click the FILE Source System.
11. Follow the context menu path Activate.

6.2.4.4.9 SAP Merchandise Planning for Retail 1.0

Workbooks

These steps are for users who have upgraded to or installed SAP Fiori 3.0 SPS03 for SAP Customer Activity
Repository applications bundle 2.0 and are choosing to continue using the SAP Merchandise Planning for Retail
1.0 workbooks.

6.2.4.4.9.1 Retail Version 1.0 Workbooks

You may choose to use the original retail workbooks contained in this configuration.

The following topics are not used in SAP Merchandise Planning 2.0 FP2. If you are configuring for the 1.0
workbooks you must complete these next topics.

Create Geographical Location Hierarchies [page 213]

Maintain Article and Geographical Hierarchy [page 219]

Reporting Currency for Geo Hierarchy Level 2 [page 219]

6.2.4.4.9.1.1 Maintain BEX Variables

In this step, you maintain the variables /RAP/HIEID_MSM_01and /RAP/UNIT_MSM_01. To do this launch the
Query Designer and follow the steps below.

1. Log in to the system desired and select the Open query icon. In the prompt, search the InfoAreas for
Merchandise, Financial Planning for Retail and select.
2. Open query Channel Mix - query/PF ( /RAP/CP11A02_IRQ01).
3. In the Filter panel, Characteristic Restrictions and select Hierarchy ID and expand. Choose the variable
Hierarchy ID beneath to focus the value in the Properties panel.
4. Select the Default Values tab and enter the same hierarchy id used in the Customizing activity.
5. Return to the Filter panel, Characteristic Restrictions and select Unit of Measure and expand. Choose the
variable Unit of Measure beneath to focus the value in the Properties panel.
6. Select the Default Values tab and enter the value 'PC' to represent the default unit of measure value for
pieces.
7. Save the Query and exit.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
212 PUBLIC Set Up the Applications
6.2.4.4.9.1.2 Create Geographical Location Hierarchies

 Note

This step is relevant to SAP Merchandise Planning for Retail versions prior to SAP Merchandise Planning 2.0
FP2.

SAP Merchandise Planning for Retail supports up to 2 levels of geographical location hierarchies. For
example, you create the first level for the world regions, the second level for countries, and then the location
hierarchy. The location hierarchy node assigned to a geographical location hierarchy must be a distribution
chain hierarchy (DC), which is a type 04 or a promotion location hiearchy which is a type 05.

Do the following steps to create a geographical location hierarchy:

1. Log in to the application server using SAP GUI and execute transaction code NWBC.
2. Select the Services menu.
3. In the left navigation menu select Location Services Location Hierarchy .
In the POWL menu on the right, select the Create button, then Market Hierarchy in the dropdown.
4. Enter the location hierarchy name, description and the master data system for your new geographical
location hierarchy.
5. Select the Editor tab.

 Note

○ The Location and Import tabs are disabled.

Enter or search for the distribution chain location hierarchy or promotion location hierarchy that you want
to add to your geographical location hierarchy.
6. Add the desired DC location hierarchy or promotion location hierarchy to your geographical location
hierarchy. You may have either or both types of hierarchies added to the same geographical location
hierarchy node.
7. Save your entries.

In the example below you have two level 2 hierarchies. The level 3 hierarchies are the actual distribution chain
location hierarchies and/or promotion location hierarchies that were selected (created in a previous activity).

● GLOBAL (GEOLEVEL1)
○ NORTH_AMERICA (GEOLEVEL2)
○ DC Hierarchy for Sales Org/Dist. Channel XYZ (GEOLEVEL3)
This will assign all locations for the sales org / distribution channel XYZ to North America's node.
○ Promotion location hierarchy PL123 (GEOLEVEL3)
This will assign all locations for the promotion location hierarchy PL123 to North America's node.
○ SOUTH_AMERICA (GEOLEVEL2)
○ DC Hierarchy for Sales Org/Dist. Channel ABC (GEOLEVEL3)
This will assign all locations for the sales org / distribution channel ABC to South America's node.

6.2.4.4.9.1.3 Maintain Time Hierarchy

The time hierarchy is used to summarize the fiscal periods for planning. In this step, you create 2 time
hierarchies: YR/MON and YR/SEASON/MON/WK. Use transaction RSH1 to create the hierarchies for the

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 213
InfoObject 0FISCPER. The instructions are an example of the required steps that will be repeated for each year
and time period

InfoObject Time hierarchy example

0FISCPER ● Create the 0RP_FISCHIER02 hierarchy name with the entry YR/SEASON in the
Short Description field.
● Create the Year hierarchy node with Year in the Short Description.
● Choose the Year hierarchy node, and create the Spring hierarchy node with the
Spring in the Short Description field under the Year hierarchy node. Click continue
● Choose the Spring hierarchy node, use the Characteristic Nodes Button to insert the
Fiscal Year/Period value for each period for that season.
● Continue the process for each year, season and period. Save and activate the hierarchy
when completed.

● Create the 0RP_FISCHIER01 hierarchy name with the entry YR/SEASON/MON/WK

in the Short Description field.
● Create the Year hierarchy node with Year value in the Short Description field.
● Choose the Year hierarchy node, and create the Spring hierarchy node with
Spring in the Short Description field under the Year hierarchy node.
● Choose the Spring hierarchy node, and create the February hierarchy node with
February in the Short Description field under the Spring hierarchy node.
● Choose the February hierarchy node, use the Characteristic Nodes Button to insert
the Fiscal Year/Period value for each period for that month.
● Continue the process for each year, season and period as desired. Save and activate
the hierarchy when completed.

Merchandise Planning for Retail 1x

Merchandise Planning for Retail

Version Text

MO1 MO Working Version

MO2 MO Simulation Version

MOR MO Reporting Version

MOP MO In Season Version

MD1 MD Working Version

MD2 MD Simulation Version

MDR MD Reporting Version

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
214 PUBLIC Set Up the Applications
 Version Text

MDP MD In Season Version

MP1 MP Working Version

MP2 MP Simulation Version

MPR MP Reporting Version

MPP MP In Season Version

MM1 MM Working Version

MM2 MM Simulation Version

MMR MM Reporting Version

MMP MM In Season Version

MMF MM Final Version

FO1 FO Working Version

FO2 FO Simulation Version

FOR FO Reporting Version

FOP FO In Season Version

FD1 FD Working Version

FD2 FD Simulation Version

FDR FD Reporting Version

FDP FD In Season Version

FM1 FM Working Version

FM2 FM Simulation Versio

FMR FM Reporting Version

FMP FM In Season Version

FL1 FL Working Version

FL2 FL Simulation Versio

FLR FL Reporting Version

FLP FL In Season Version

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 215
Version Text

SAP Store Area Plan

6.2.4.4.9.1.4 Maintain Fiscal Year Variants

Use

In this section you maintain the required fiscal year variant values for week and month; 0FISCVARNT 'RW' and
'RM'.

 Caution

SAP Merchandise Planning for Retail uses activated time objects 0FISCPER (fiscal year period) and
0FISCVARNT (fiscal year variant), provided as part of the technical BI Content.

If you are also using the SAP Assortment Planning application, you use the same fiscal year variant that
was created for this application.

Procedure

Fiscal Variant RW

The steps provided in this procedure allow you to maintain 0FISCVARNT 'RW' using the standard 4-5-4
calendar entries. If you are using alternative fiscal periods in your retail business, for example, each week
starting on a Sunday instead of Saturday, you can provide your own entries instead of the ones suggested in
this guide.

1. Log on to your back-end system.

2. Launch fiscal year variant maintenance (transaction GVAR).
3. Choose New Entries.
4. On the New Entries: Overview of Added Entries screen make the following sets of entries:

Field Name User Entry

FV RW

Description Planning week

Year- Select
dependent

Calendar yr Do not select

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
216 PUBLIC Set Up the Applications
 Field Name User Entry

Number of 53
period
postings

No.of
special
periods

5. Choose Enter.
An information message is displayed about creating more than 16 periods, choose Continue.
6. Choose Back.
You can see the newly created entry.
7. Mark the entry RW and select Periods from the Dialog Structure.
8. Enter 2012 in the Calendar yr field and choose Continue.
Data for the previous year must be maintained.
9. Choose New Entries.
10. Open SAP Note 2112634 , locate the entries for year 2012, and enter the data by copy-and-paste. Note
that this SAP Note is applicable for both SAP Merchandise Planning for Retail and SAP Assortment
Planning for Retail.
11. Choose Enter to finish your input.
While making the fiscal year entries, an information message might be displayed stating that there are
Gaps in financial year variant periods RW. This is an information message only, and the entered fiscal year
data is saved.
12. Maintain the weekly fiscal year variant in the same way for the year 2017. The entries for year 2017 are also
available in SAP Note 2112634 .
13. Select Shortened Fiscal Years from the Dialog Structure.
14. Enter 2013 in the Fiscal year field and choose Continue.
15. Choose New Entries.
16. Enter 52 in the No. of posting periods field.
17. Choose Back twice.
18. Maintain the weekly fiscal year variant in the same way for the shortened fiscal years, that is, years 2013,
2014, 2015, 2016, and 2017. The corresponding tables are available in SAP Note 2112634 .
19. Choose Save after you have finished the maintenance for year 2018.

Fiscal Variant RM

The next steps allow you to maintain 0FISCVARNT 'RM' using the standard 12 month calendar entries. If you
are using alternative fiscal periods in your retail business, you can provide your own entries instead of the ones
suggested in this guide. These month entries must align with the week values used in the prior step.

1. In the Fiscal Year Variants view, choose New Entries.

2. On the New Entries: Overview of Added Entries screen make the following sets of entries:

Field Name User Entry

FV RM

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 217
 Field Name User Entry

Description Planning month

Year- Select
dependent

Calendar yr Do not select

Number of 12
period
postings

No.of
special
periods

3. Choose Enter.
4. Choose Back.
You can see the newly created entry.
To get the information to enter in the next step, open SAP Note 2112634 . Note that this SAP Note is
applicable for both SAP Merchandise Planning and SAP Assortment Planning. If you have used these dates
for your weekly calendar, then align the month end dates to match. An example is contained in the table
below using the 2015 calendar entries from the SAP Note.
5. Mark the entry RM and select Periods from the Dialog Structure and double click to open the Calendar year
dialog.
6. Enter 2012 in the Calendar yr field and choose Continue.
7. Choose New Entries. For the year selected to enter the information that will define each period.
8. Enter the last valid calendar date of the period being added in the Month and Day fields.
9. Enter the relevant Period number.
10. In the Year Shift field, enter +1 if the fiscal year is later than the calendar year enter. Enter -1 if the fiscal year
is before the calendar year.
11. Press Enter to accept the first row.
12. Continue adding each period to complete the fiscal year.
Maintain the monthly fiscal year variant in the same way for the remaining years.
13. Choose Save after you have finished the maintenance for year 2018.

Choose Save after you have finished the maintenance for the last year.

2015 Monthly Calendar (sample)

Month Day Period Year Shift

1 31 12 -1

2 28 1 0

3 28 2 0

5 2 3 0

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
218 PUBLIC Set Up the Applications
 Month Day Period Year Shift

5 30 4 0

6 27 5 0

8 1 6 0

8 29 7 0

9 26 8 0

10 31 9 0

11 28 10 0

12 26 11 0

12 31 12 0

6.2.4.4.9.1.5 Maintain Article and Geographical Hierarchy

Use

This information is relevant to versions prior to SAP Merchandise Planning 2.0 FP2. There are two types of
hierarchies used in SAP Merchandise Planning for Retail, the geographical and the article hierarchy.

Procedure

There is a Customizing activity to define the required hierarchies. Use transaction code SPRO and in the Dialog
Structure navigate to Cross-Application Components Demand Data Foundation Basic Settings and
choose Define Default Values.

● In the Hierarchy ID field use the prompt to select the applicable article hierarchy id.
● In the Geo Hierarchy ID field, use the prompt to select the applicable geo hierarchy ID.

6.2.4.4.9.1.5.1 Reporting Currency for Geo Hierarchy Level 2

This information is relevant to versions prior to SAP Merchandise Planning 2.0 FP2. The geographical hierarchy
level 2 requires a reporting currency. Do the following steps to create a geographical location hierarchy
currency:

1. In your back-end system, launch table/view maintenance transaction code SM30.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 219
2. In the Maintain Table Views: Initial Screen enter /RAP/GEOLVL_CUST in the Table/view field and select the
Maintain button
3. Choose New Entries .
4. Use the F4 help to select the Geographical Level 02 desired.
5. Use the F4 help to select the Reporting Currency associated with the Geographical Level 02 selected.
6. Repeat for each Geographical Level 02 required.
7. Save your entries.

6.2.4.4.9.1.5.1.1 Maintain Process Chain Related

Maintain BW process chain variants relevant for SAP Merchandise Planning for Retail.

Context

In this optional procedure, you activate the following infoobjects and maintain the BW process chain variants .

Planning: Characteristic Relationships

InfoObject Description InfoObject Name

Characteristic Rels. for Financial Merchandise Planning Plan /RAP/MPRC01

Characteristic Rels. for Channel Planning Plan /RAP/MPRC02

Planning: Data Slices

InfoObject Description InfoObject Name

Data Slices for Financial Merchandise Planning, Plan /RAP/MPRC01

Data Slices for Channel Planning, Plan /RAP/MPRC02

Process Chain Doc Process Chain

InfoObject Name

/RAP/MPPC01_01

Process Chain Starter

InfoObject Name

/RAP/MPPC01_01

Procedure

In this process you will create variants and activate the BW process chains.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
220 PUBLIC Set Up the Applications
 1. Planning Sequence Data Slice Activation
1. Go to transaction RSPLAN
2. Select the Planning Sequence button.
3. In the planning sequence field, enter /RAP/C11A02_PS08 and choose Edit button.
4. Select the Variables button.
5. Select the Geographical Level 1 Input help and select a value.
6. Select the Save As Button.
7. In the Variables prompt, choose F9 to turn Cross User-variant on.
8. Enter a variant name. For description enter Data Slice Activation and select the Cross-User
Variant check box.
9. Select the Continue button.
10. Select the Continue button in the variables screen.
11. Go to transaction RSA1.
12. In the navigation panel, select the Modeling button, then Process Chain.
13. In the process chain panel, right click on Merchandise Planning - Actualization and choose Edit.
14. In the right tree, right click on Execute Planning Sequence Data Slice Activation (/RAP/
MPPC01_10) and choose Maintain Variant.
15. Load the variant created in step h (if not already loaded).
16. Select the Transfer button and save.
2. Planning Sequence Deactivation of Data Slice
1. Go to transaction RSPLAN
2. Select the Planning Sequence button.
3. In the planning sequence field, enter /RAP/C11A02_PS09 and choose Edit button.
4. Select the Variables button.
5. Select the Geographical Level 1 Input help and select a value.
6. Select the Save As Button.
7. In the Variables prompt, choose F9 to turn Cross User-variant on.
8. Enter a variant name. For description enter Data Slice Deactivation and select the Cross-User
Variant check box.
9. Select the Continue button.
10. Select the Continue button in the variables screen.
11. Go to transaction RSA1.
12. In the navigation panel, select the Modeling button, then Process Chain.
13. In the process chain panel, right click on Merchandise Planning - Actualization and choose Edit.
14. In the right tree, right click on Execute Planning Sequence Data Slice Deactivation (/RAP/
MPPC01_11) and choose Maintain Variant.
15. Load the variant created in step h (if not already loaded).
16. Select the Transfer button and save.
3. Planning Sequence Channel Mix - Actualization
1. Go to transaction RSPLAN
2. Select the Planning Sequence button.
3. In the planning sequence field, enter /RAP/C11A02_PS07 and choose Edit button.
4. Select the Variables button.
5. Select the Geographical Level 1 Input help and select a value.
6. Select the Save As Button.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 221
 7. In the Variables prompt, choose F9 to turn Cross User-variant on.
8. Enter a variant name. For description enter Channel Mix - Actualization and select the Cross-
User Variant check box.
9. Select the Continue button.
10. Select the Continue button in the variables screen.
11. Go to transaction RSA1.
12. In the navigation panel, select the Modeling button, then Process Chain.
13. In the process chain panel, right click on Merchandise Planning - Actualization and choose edit.
14. In the right tree, right click on Execute Planning Sequence Channel Mix - Actualization (/RAP/
MPPC01_02) and choose Maintain Variant.
15. Load the variant created in step h (if not already loaded).
16. Select the Transfer button and save.
4. Planning Sequence Financial Merchandise Plan - Division - Actualization
1. Go to transaction RSPLAN
2. Select the Planning Sequence button.
3. In the planning sequence field, enter /RAP/C11A07_PS11 and choose Edit button.
4. Select the Variables button.
5. Select the Geographical Level 1 Input help and select a value.
6. Select the Save As Button.
7. In the Variables prompt, choose F9 to turn Cross User-variant on.
8. Enter a variant name. For description enter MP - Division - Actualization and select the
Cross-User Variant check box.
9. Select the Continue button.
10. Select the Continue button in the variables screen.
11. Go to transaction RSA1.
12. In the navigation panel, select the Modeling button, then Process Chain.
13. In the process chain panel, right click on Merchandise Planning - Actualization and choose edit.
14. In the right tree, right click on Execute Planning Sequence Financial Merchandise Plan - Division -
Actualization(/RAP/MPPC01_03) and choose Maintain Variant.
15. Load the variant created in step h (if not already loaded).
16. Select the Transfer button and save.
5. Planning Sequence Financial Merchandise Plan - Department - Actualization
1. Go to transaction RSPLAN
2. Select the Planning Sequence button.
3. In the planning sequence field, enter /RAP/C11A03_PS10 and choose Edit button.
4. Select the Variables button.
5. Select the Geographical Level 1 Input help and select a value.
6. Select the Save As Button.
7. In the Variables prompt, choose F9 to turn Cross User-variant on.
8. Enter a variant name. For description enter MP - Department - Actualization and select the
Cross-User Variant check box.
9. Select the Continue button.
10. Select the Continue button in the variables screen.
11. Go to transaction RSA1.
12. In the navigation panel, select the Modeling button, then Process Chain.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
222 PUBLIC Set Up the Applications
 13. In the process chain panel, right click on Merchandise Planning - Actualization and choose edit.
14. In the right tree, right click on Execute Planning Sequence Financial Merchandise Plan - Department
- Actualization(/RAP/MPPC01_04) and choose Maintain Variant.
15. Load the variant created in step h (if not already loaded).
16. Select the Transfer button and save.
6. Planning Sequence Financial Merchandise Plan - Class - Actualization
1. Go to transaction RSPLAN
2. Select the Planning Sequence button.
3. In the planning sequence field, enter /RAP/C11A08_PS10 and choose Edit button.
4. Select the Variables button.
5. Select the Geographical Level 1 Input help and select a value.
6. Select the Save As Button.
7. In the Variables prompt, choose F9 to turn Cross User-variant on.
8. Enter a variant name. For description enter MP - Class - Actualization and select the Cross-
User Variant check box.
9. Select the Continue button.
10. Select the Continue button in the variables screen.
11. Go to transaction RSA1.
12. In the navigation panel, select the Modeling button, then Process Chain.
13. In the process chain panel, right click on Merchandise Planning - Actualization and choose edit.
14. In the right tree, right click on Execute Planning Sequence Financial Merchandise Plan - Class -
Actualization(/RAP/MPPC01_05) and choose Maintain Variant.
15. Load the variant created in step h (if not already loaded).
16. Select the Transfer button and save.
7. Planning Sequence Financial Merchandise Plan - Subclass - Actualization
1. Go to transaction RSPLAN
2. Select the Planning Sequence button.
3. In the planning sequence field, enter /RAP/C11A09_PS13 and choose Edit button.
4. Select the Variables button.
5. Select the Geographical Level 1 Input help and select a value.
6. Select the Save As Button.
7. In the Variables prompt, choose F9 to turn Cross User-variant on.
8. Enter a variant name. For description enter MP - Subclass - Actualization and select the
Cross-User Variant check box.
9. Select the Continue button.
10. Select the Continue button in the variables screen.
11. Go to transaction RSA1.
12. In the navigation panel, select the Modeling button, then Process Chain.
13. In the process chain panel, right click on Merchandise Planning - Actualization and choose edit.
14. In the right tree, right click on Execute Planning Sequence Financial Merchandise Plan - Subclass -
Actualization(/RAP/MPPC01_06) and choose Maintain Variant.
15. Load the variant created in step h (if not already loaded).
16. Select the Transfer button and save.
8. Planning Sequence Channel Plan - Store Comp - Actualization
1. Go to transaction RSPLAN

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 223
 2. Select the Planning Sequence button.
3. In the planning sequence field, enter /RAP/C11A19_PS04 and choose Edit button.
4. Select the Variables button.
5. Select the Geographical Level 1 Input help and select a value.
6. Select the Save As Button.
7. In the Variables prompt, choose F9 to turn Cross User-variant on.
8. Enter a variant name. For description enter CP - Store Comp - Actualization and select the
Cross-User Variant check box.
9. Select the Continue button.
10. Select the Continue button in the variables screen.
11. Go to transaction RSA1.
12. In the navigation panel, select the Modeling button, then Process Chain.
13. In the process chain panel, right click on Merchandise Planning - Actualization and choose edit.
14. In the right tree, right click on Execute Planning Sequence Channel Plan - Store Comp -
Actualization(/RAP/MPPC01_07) and choose Maintain Variant.
15. Load the variant created in step h (if not already loaded).
16. Select the Transfer button and save.
9. Planning Sequence Channel Plan - Multi Store - Actualization
1. Go to transaction RSPLAN
2. Select the Planning Sequence button.
3. In the planning sequence field, enter /RAP/C11A18_PS05 and choose Edit button.
4. Select the Variables button.
5. Select the Geographical Level 1 Input help and select a value.
6. Select the Save As Button.
7. In the Variables prompt, choose F9 to turn Cross User-variant on.
8. Enter a variant name. For description enter CP - Multi Store - Actualization and select the
Cross-User Variant check box.
9. Select the Continue button.
10. Select the Continue button in the variables screen.
11. Go to transaction RSA1.
12. In the navigation panel, select the Modeling button, then Process Chain.
13. In the process chain panel, right click on Merchandise Planning - Actualization and choose edit.
14. In the right tree, right click on Execute Planning Sequence Channel Plan - Multi Store -
Actualization(/RAP/MPPC01_08) and choose Maintain Variant.
15. Load the variant created in step h (if not already loaded).
16. Select the Transfer button and save.
10. Planning Sequence Channel Plan - Single Store - Actualization
1. Go to transaction RSPLAN
2. Select the Planning Sequence button.
3. In the planning sequence field, enter /RAP/C11A16_PS08 and choose Edit button.
4. Select the Variables button.
5. Select the Geographical Level 1 Input help and select a value.
6. Select the Save As Button.
7. In the Variables prompt, choose F9 to turn Cross User-variant on.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
224 PUBLIC Set Up the Applications
 8. Enter a variant name. For description enter CP - Single Store - Actualization and select the
Cross-User Variant check box.
9. Select the Continue button.
10. Select the Continue button in the variables screen.
11. Go to transaction RSA1.
12. In the navigation panel, select the Modeling button, then Process Chain.
13. In the process chain panel, right click on Merchandise Planning - Actualization and choose edit.
14. In the right tree, right click on Execute Planning Sequence Channel Plan - Single Store -
Actualization(/RAP/MPPC01_09) and choose Maintain Variant.
15. Load the variant created in step h (if not already loaded).
16. Select the Transfer button and save.

6.2.5 Configure Data Replication Steps

6.2.5.1 Initial Load of Data to DDF Using DRFOUT

Use

SAP Merchandise Planning uses master data, such as product, location, and product hierarchy, that is
replicated from SAP ERP to the DDF module in SAP Customer Activity Repository using the DRFOUT data
replication framework.

 Note

Not all of the master data is replicated into DDF using DRFOUT. Some data must be replicated separately
using SLT replication.

Additionally, DRFOut integration and DDF do not support leading zeros in the product IDs.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 225
SAP Merchandise Planning requires that the following master data is replicated from a connected SAP ERP
system using DRFOUT:

Sequence Master Data Technical Details For more information, see:

1 Product Hierarchy ● SAP ERP Description: Material Group

http://help.sap.com/car <your
Hierarchy
release> Application Help <>
● DRFOUT Outbound Implementation:
PMCH Demand Data Foundation Integration

● DDF Inbound Interface: /DMF/ Information Inbound Interfaces For

MDIF_PROD_HIER_INBOUND Remote Function Call (RFC)

Communication Product Hierarchy

Master Data

2 Product ● SAP ERP Description: Material

http://help.sap.com/car <your
● DRFOUT Outbound Implementation:
release> Application Help Demand
PMAT
Data Foundation Integration Information
● DDF Inbound Interface: /DMF/
MDIF_PRODUCT_INBOUND Inbound Interfaces For Remote Function

Call (RFC) Communication Product

Master Data

3 Location ● SAP ERP Description: Plant

http://help.sap.com/car <your
● DRFOUT Outbound Implementation:
release> Application Help Demand
PPLT
Data Foundation Integration Information
● DDF Inbound Interface: /DMF/
MDIF_LOCATION_INBOUND Inbound Interfaces For Remote Function

Call (RFC) Communication Product

Location Master Data

4 Product Location ● SAP ERP Description: Material/Plant

http://help.sap.com/car <your
● DRFOUT Outbound Implementation:
release> Application Help Demand
PMPL
Data Foundation Integration Information
● DDF Inbound Interface: /DMF/
MDIF_PROD_LOC_INBOUND Inbound Interfaces For Remote Function

Call (RFC) Communication Product

Location Master Data

5 Product Location ● SAP ERP Description: Sales Price

http://help.sap.com/car <your
● DRFOUT Outbound Implementation:
release> Application Help Demand
PSPR
Data Foundation Integration Information
● DDF Inbound Interface: /DMF/
MDIF_PROD_LOC_INBOUND Inbound Interfaces For Remote Function

Call (RFC) Communication Product

Location Master Data

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
226 PUBLIC Set Up the Applications
 Sequence Master Data Technical Details For more information, see:

6 Inventory ● SAP ERP Description: Inventory

http://help.sap.com/car <your
● DRFOUT Outbound Implementation:
release> Application Help Demand
PINV
Data Foundation Integration Information
● DDF Inbound Interface: /DMF/
OPIF_INVENTORY_INBOUND Inbound Interfaces For Remote Function

Call (RFC) Communication Inventory

Master Data

7 Product Location ● SAP ERP Description: Moving Aver­

http://help.sap.com/car <your
age Price
release> Application Help Demand
● DRFOUT Outbound Implementation:
PMAP Data Foundation Integration Information

● DDF Inbound Interface: /DMF/ Inbound Interfaces For Remote Function

MDIF_PROD_LOC_INBOUND Call (RFC) Communication Product

Location Master Data

9 Location ● SAP ERP Description: Vendor

http://help.sap.com/car <your
● DRFOUT Outbound Implementation:
release> Application Help Demand
PVEN
Data Foundation Integration Information
● DDF Inbound Interface: /DMF/
MDIF_LOCATION_INBOUND Inbound Interfaces For Remote Function

Call (RFC) Communication Location

Master Data

10 Product Hierarchy ● SAP ERP Description: Article Hierar­

http://help.sap.com/car <your
chy
release> Application Help Demand
● DRFOUT Outbound Implementation:
PAHY Data Foundation Integration Information

● DDF Inbound Interface: /DMF/ Inbound Interfaces For Remote Function

MDIF_PROD_HIER_INBOUND Call (RFC) Communication Product

Hierarchy Master Data

Prerequisites

Before replicating data from SAP ERP to DDF using DRFOUT, the following prerequisites must be fulfilled:

● The following business functions are activated in SAP ERP:

○ ISR_APPL_OUTBOUND_DMF
○ ISR_RETAIL_OUTBOUND_DMF

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 227
● You have noted the different terms for the following objects:

DDF / SAP Merchandise Planning

SAP ERP SAP Retail for Retail

Material Article Product

Plant Site Location

6.2.5.2 Initial Load of Sales Data from BW

Use

If you have accumulated large amounts of historical sales data using SAP POS Data Management or SAP
Customer Activity Repository, it is possible that you are storing these large data sets in a connected SAP BW
system. In such a case, you can perform the initial load of the sales time series (historical POS data) data into
DDF using the BI Interface for Time Series report.

 Note

These instructions extract historical sales data from an Infocube in BW. If you are using BW/4HANA,
additional project work will be required to re-implement the BAdI /DMF/BI_IF_READ_BI. For technical
details, see 2764634 .

Procedure

1. Log on to your back-end system.

2. Execute transaction SE38.
3. Specify /DMF/BI_IF_TS in the Program field and choose Execute.
4. Read the documentation associated with the report, carry out the described customizing, and run the
report accordingly.

More Information

http://help.sap.com/car Application Help Demand Data Foundation Integration Information Inbound

Interfaces For Remote Function Call (RFC) Communication Sales Time Series .

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
228 PUBLIC Set Up the Applications
6.2.5.3 Initial Load of Goods Movement KPIs

Load goods movement Key Performance Indicators (KPI) for returns, receipts, and open quantity.

Context

The goods movement data is stored in the SLT replicated tables EKPO, EKET, and EKBE in the Customer
Activity Repository. You perform the initial load of this data into Demand Data Foundation (DDF) using the
report /RAP/MPR_ECC_KPI_CALC. When run in initial mode, this report will load 2 years of data from the
current date. Further information is available in the documentation attached to the report.

Master Data SAP ERP Table

Purchasing Document Header EKKO

Purchasing Document Item EKPO

History per Purchasing Document EKBE

Scheduling Agreement Schedule Lines EKET

In addition there are some prequisite steps to follow.

● You have maintained fiscal year variants using SPRO. Navigate to SAP Customizing Implementation
Guide Cross-Application Components Demand Data Foundation Basic Settings Define Default
Values .

Procedure

1. Log on to your back-end system.

2. Verify your user has the role /RAP/BW_MPR_WORKBOOKS assigned.

3. You have maintained fiscal year variants using SPRO. Navigate to SAP Customizing Implementation
Guide Cross-Application Components Demand Data Foundation Basic Settings Define Default
Values .
4. Execute transaction SE38.
5. Specify /RAP/MPR_ECC_KPI_CALC in the Program field, select radio button Initial and select Execute.
6. Go to report and /RAP/MPR_BOP_KPI table for details, uses, and descriptions.

Next Steps

It is recommended you run this report weekly to update the aggregated KPIs with the ongoing ERP activity

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 229
.

6.2.5.4 Initial Load of Sales Orders and Shipments

Load replicated data for sales orders and shipments to Demand Data Foundation (DDF) table /DMF_TS_WS.

The sales order and shipment data is stored in the SLT replicated tables LIKP, LIPS, VBAK, VBAP, VBEP, VBPA,
VBKD, KONV, VBFA and MSEG. in the Customer Activity Repository. You perform the initial load of this data into
DDF using the /DMF/WHOLESALE_SO_SHP_TO_TS_WS report. Use transaction SE38 to execute or display
documentation for the report.

When you execute the report you select the following:

● The Master Data Logical System (mandatory).

● Force Initial Run. Check box, not required for the true initial execution. (Used to reinitialize data. This will
force delete all entries previously processed and re-populate TS_WS).
● Past Days for Initial Load. When the report is run the first time it will default to initial mode and will load any
sales orders and shipments created or modified with a date greater than or equal to the date resulting from
the calculation of current date minus the value in this field. This value is also required if you have checked
Force Initial Run.
● Past Days to Check Deletions specifies how far back in days to look for deleted sales orders or shipments.
This allows the customer to go back as far as needed for potentially deleted documents without processing
data that may have been archived already in ECC.

 Note

This report should be run on a recurring cycle based on your activity.

6.2.5.5 Delta Load of Data to DDF Using DRFOUT

We recommend that you schedule a weekly periodic task to replicate inventory data (outbound implementation
PINV) from the SAP ERP system to the system for SAP Merchandise Planning. This replication builds up the
inventory history data that is needed by SAP Merchandise Planning.

6.2.5.6 Delta Load of Sales Data in SAP Customer Activity

Repository

Use

Once the initial load of historical sales data is completed or, if you are working on a brand new system
implementation and do not have to perform an initial sales data load, you need to configure the periodic delta
load of sales data in SAP Customer Activity Repository.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
230 PUBLIC Set Up the Applications
Procedure

1. Ensure that you have properly configured the POS Sales Transfer and Audit functionality in SAP Customer
Activity Repository to receive transaction data from your connected POS systems.
For more information, see https://help.sap.com/viewer/p/CARAB <Version> Application Help
SAP Customer Activity Repository POS Data Transfer and Audit .
2. Ensure that you have configured the Supply - DMF-Based Applications outbound tasks to load sales data
from POS Sales Transfer and Audit to DDF.
For more information, see https://help.sap.com/viewer/p/CARAB <Version> Application Help
SAP Customer Activity Repository POS Data Transfer and Audit Task Processing Tasks for Sending
Data to Follow-On Applications .

 Recommendation

If you are not storing aggregated sales data in an SAP BW system, and have historical sales data that
you would like to load into DDF from POS Sales Transfer and Audit, you can configure the Supply - DMF-
Based Applications outbound tasks to perform this initial load.

3. Monitor the transfer of sales time series data as described in https://help.sap.com/viewer/p/CARAB

<Version> Application Help SAP Customer Activity Repository Demand Data Foundation
Integration Information Inbound Processing .

More Information

https://help.sap.com/viewer/p/CARAB <Version> Application Help SAP Customer Activity Repository

Demand Data Foundation Integration Information Inbound Interfaces For Remote Function Call (RFC)
Communication Sales Time Series .

6.2.5.7 Delta Load of Goods Movement KPIs

Once the initial load of historical goods movement KPIs data is completed you should continue to update your
data on a recurring basis. As data is replicated from SAP ERP activity, the values for goods movement KPIs can
only be added to the Demand Data Foundation when you execute the report /RAP/MPR_ECC_KPI_CALC . The
delta load sets the timeframe to start one month (30 days) prior to the current date and one year in the future
from the current date.

To execute the report, log on to your back-end system and execute transaction SE38. Specify /RAP/
MPR_ECC_KPI_CALC in the Program field and use the Execute button. Select radio button Delta and select
Execute. For further information see the documentation attached to the report by selecting Documentation,
Display on the ABAP Editor: Initial Screen.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 231
6.2.5.8 Delta Load of Sales Orders and Shipments

Load replicated data for ongoing sales orders and shipments to Demand Data Foundation (DDF) table /
DMF_TS_WS

The sales order and shipment data is stored in the SLT replicated tables LIKP, LIPS, VBAK, VBAP, VBEP, VBPA,
VBKD, KONV, VBFA and MSEG. in the Customer Activity Repository. You perform the delta load of this data into
DDF using the /DMF/WHOLESALE_SO_SHP_TO_TS_WS report. Use transaction SE38 to execute or display
documentation for the report.

When you execute the report you select the following:

● The Master Data Logical System (mandatory).

● Force Initial Run. Check box unchecked for delta mode.
● Past Days for Initial Load. When the report is run the first time it will default to initial mode and will load any
sales orders and shipments created or modified with a date greater than or equal to the date resulting from
the calculation of current date minus the value in this field. This value is also required if you have checked
Force Initial Run.
● Past Days to Check Deletions specifies how far back in days to look for deleted sales orders or shipments.
This allows the customer to go back as far as needed for potentially deleted documents without processing
data that may have been archived already in ECC.

 Note

This report should be run on a recurring cycle based on your activity.

6.2.5.9 Replicate SAP ERP Tables for SAP Merchandise

Planning

Use

Verify that all SAP ERP or SAP S/4HANA tables that are relevant for SAP Merchandise Planning KPIs have not
only been created but have also been filled with data.

 Note

You have already replicated all of the relevant tables in a prior step, Create/Replicate Source Master Data
System Tables [page 81].

In particular, SAP Merchandise Planning requires that the following master data table are replicated in order to
calculate KPIs:

Master Data SAP ERP Table

Purchasing Document Header EKKO

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
232 PUBLIC Set Up the Applications
 Master Data SAP ERP Table

Purchasing Document Item EKPO

History per Purchasing Document EKBE

Scheduling Agreement Schedule Lines EKET

6.2.6 Create Market Hierarchy

SAP Merchandise Planning supports market hierarchies, a logical structuring of selling locations (stores,
wholesale customers, digital customers) that align with your goals for planning.

The market hierarchy allows you to group locations by markets or across multiple sales organizations. In
addition, your Area of Responsibility (AOR) must be aligned with your market hierarchy before using the
planning applications. Do the following steps to create a market hierarchy:

1. Log in to the application server using SAP GUI and execute transaction code NWBC.
2. Select the Services menu.
3. In the left navigation menu select Location Services Location Hierarchy .
In the POWL menu on the right, select the Create button, then Market Hierarchy in the dropdown.
4. Enter the location hierarchy name, description and the master data system for your new hierarchy.
5. Select the Editor tab. Enter or search for the locations that you want to add to your market hierarchy.
6. Add the locations to your market hierarchy by selecting the row or rows and selecting the move arrow.

 Note

The same location ID cannot be used more than once in a market hierarchy. For example location ID
ABC can exist as multiple location types. It can exist as a distribution chain (DC) type, a store type, and
a customer type. You may not have the type of DC and store in the same hierarchy

7. Save your entries.

More Information

For more information regarding location and market hierarchies, see Maintain Location Hierarchies located at
https://help.sap.com/viewer/p/CARAB <version> Application Help SAP Customer Activity Repository
applications bundle Demand Data Foundation General Services Maintenance Services

For more information about AOR see Maintain Area of Responsibility located at https://help.sap.com/viewer/p/
CARAB <version> Application Help SAP Customer Activity Repository applications bundle Demand
Data Foundation General Services .

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 233
6.2.7 Specify Analysis Workbook Settings

6.2.7.1 Enable Macros

Use

In this procedure, you enable your SAP Analysis for Microsoft Office workbooks to use macros.

Procedure

1. Open the SAP Analysis for Microsoft Office from Start All Programs SAP Business Intelligence
Analysis for Microsoft Excel .
2. Choose File Options Customize Ribbon .
3. Under Customize the Ribbon, select Main Tabs.
4. Enable the entry Developer and confirm by choosing OK.
5. Now you will see the new Developer tab in your SAP Analysis for Microsoft Office.
6. Select the Developer Tab and choose Macro Security.
7. Choose Enable all macros.

6.2.7.2 General Workbook Settings

Use

You use SAP Analysis for Microsoft Office to launch the planning workbooks.

Procedure

If you are unable to see the Analysis , MP Selection, and MP Info options on the menu of Analysis for Microsoft
Excel, perform the following steps in the Options, Add-Ins of the Excel options:

1. Enter COM in the Manage field and choose Go.

2. In the COM Add-Ins box, select the Analysis and Planning options and choose Go. If you do not find them
in the list, Enter Disabled in the Manage field and choose Go.

Now you are able to view the Analysis , MP Selection and MP Info options.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
234 PUBLIC Set Up the Applications
6.3 SAP Assortment Planning

 Note

Some of the activities in this section may have already been performed in the corresponding section under
SAP Customer Activity Repository. Such activities do not need to be repeated during the setup and
installation of consuming applications.

The following diagram depicts the main steps of the post-installation process for SAP Assortment Planning and
contains links to the descriptions of these steps. There are two further steps in the back-end system following
Configure Assortment Planning [page 236]:

● Maintain Fiscal Year Variant for Retail Week [page 237]

● Generate Time Data - Fiscal Calendar [page 241]

● Perform Core Steps for SAP Customer Activity Repository [page 183]
● Configure Assortment Planning [page 236]
● Activate Planning Framework Content (SAP Assortment Planning) [page 242]

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 235
● Configure Data Replication [page 251]
● Run the Validation Report [page 251]
● Perform General SAP Gateway Configuration [page 95]
● Configure SAP Fiori Launchpad [page 102]
● Activate OData Services [page 97]
● Activate SAP Assortment Planning ICF Services [page 253]
● Define System Alias for Back-End Transactions [page 254]
● Assign Roles, Catalogs, and Groups in SAP Fiori Launchpad [page 256]
● Configure Index Calculation [page 253]

6.3.1 Perform Core Steps for SAP Customer Activity

Repository

To set up this application, you must first perform the Core (Mandatory) steps for SAP Customer Activity
Repository. The core steps are mandatory for all the consuming applications.

Procedure

Perform all steps listed under Core (Mandatory for All Applications) [page 73].

6.3.2 Configure Assortment Planning

Use

To use SAP Assortment Planning, you must define several application-specific settings in Customizing.

Procedure

1. Specify assortment list settings.

In the Assortment List Settings Customizing activity, found under Cross-Application Components
Assortment Planning Assortment Lists , you can specify general settings for assortment lists. For
example, you can define whether you can assign an assortment list product to more than one module.
2. Verify settings under Cross-Application Components Assortment Planning Imported Demand Data
Foundation Settings .
Although you might have specified most of these settings when configuring DDF, the activities under
Imported Demand Data Foundation Settings are particularly important for the SAP Assortment Planning
application.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
236 PUBLIC Set Up the Applications
 3. Define the required number ranges.
You must set all of the number ranges under SAP Customizing Implementation Guide Cross-
Application Components Assortment Planning Number Range .
4. Define the business week (using transaction SPRO) under Cross-Application Components Demand
Data Foundation Basic Settings Define Business Week .
5. Verify the default implementations of BAdIs under SAP Customizing Implementation Guide Cross-
Application Components Assortment Planning Enhancements Using Business Add-Ins , and if
necessary, provide custom implementations.

 Note

We recommend that you activate BAdI implementations that enable the use of the Omnichannel SAP
BW Structure. For more information, see Activate Planning Framework Content (SAP Assortment
Planning) [page 242].

6. To use forecasted values in the Sales & Inventory Analysis view within the My Assortment Lists app,
configure Unified Demand Forecast (UDF). For more information, see the SAP Customer Activity Repository
Administration Guide, section Configure Unified Demand Forecast (UDF).

Related Information

Configuration Information

6.3.3 Maintain Fiscal Year Variant for Retail Week

Use

In this procedure you maintain the required fiscal year variant ( 0FISCVARNT 'RW'). SAP Assortment Planning
uses time objects 0FISCPER (fiscal year period) and 0FISCVARNT (fiscal year variant), provided as part of the
technical BI Content, and activated in the Activate Technical Content [page 242] procedure.

 Caution

You must maintain fiscal year variants for a period far enough into the past and into the future to cover the
full range required for your planning activities. For example, two years into the past and five years into the
future.

The steps provided in this procedure allow you to maintain 0FISCVARNT 'RW' using the standard 4-5-4
calendar entries. If you are using alternative fiscal periods in your retail business, for example, each week
starting on a Sunday instead of Saturday, you can provide your own entries instead of the ones suggested in
this guide.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 237
Procedure

1. Log on to your back-end system.

2. Launch fiscal year variant maintenance (transaction GVAR).
3. Choose New Entries.
4. On the New Entries: Overview of Added Entries screen make the following sets of entries:

Create New Fiscal Year Variant

5. Choose Enter.
An information message is displayed about creating more than 16 periods, choose Continue.
6. Choose Back.
You can see the newly created entry.
7. Mark the entry RW and select Shortened Fiscal Years from the Dialog Structure.

Shortened Fiscal Years in Dialog Structure

8. In the Fiscal year dialog, enter the year (for example, 2015 ) in the Fiscal year field and choose Continue.
9. On the Change View "Shortened Fiscal Years": Overview screen, choose New Entries.
10. In the Shortened Fiscal Years table, enter 52 in the No. of posting periods field.
11. Choose Back twice.
12. On the Change View "Fiscal Year variants": Overview screen, mark the entry RW and select Periods from the
Dialog Structure.
13. In the Calendar yr dialog, enter the year (for example, 2015 ) in the Calendar yr field and choose Continue.
Data for the previous year must be maintained.
14. On the Change View "Periods": Overview screen, choose New Entries.
15. In the Periods table, enter the data (month, day, period, year shift) for each period according to your fiscal
calendar. For an example, see the following table. For more examples, see SAP Note 2112634 . If you
want to copy data from this note, locate the required year and enter the data by copy-and-paste.

2015 Weekly Calendar

Month Day Period Year Shift

1 3 48 -1

1 10 49 -1

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
238 PUBLIC Set Up the Applications
 Month Day Period Year Shift

1 17 50 -1

1 24 51 -1

1 31 52 -1

2 7 1 0

2 14 2 0

... .. ... ...

16. Repeat steps 7-15 to maintain the weekly fiscal year variant for all of the required years, entering each year
as shortened fiscal year. The corresponding tables are available in SAP Note 2112634 .
17. Choose Save.
18. Launch transaction RSRHIERARCHYVIRT and ensure that the dates specified in the From and To fields
under Time Interval cover the years maintained for the fiscal year variant in the previous steps.

6.3.4 Maintain Fiscal Year Variant for Month

Context

In this section, you maintain the required fiscal year variant values for the fiscal month, 'RM'. This is especially
required for using the Sales & Inventory Analysis view in the My Assortment Lists app.

 Caution

You must maintain fiscal year variants for a period far enough into the past and into the future to cover the
full range required for your planning activities. For example, two years into the past and five years into the
future.

If you are using alternative fiscal periods in your retail business, you can provide your own entries instead of the
ones suggested in this guide.

Procedure

1. Log on to your back-end system.

2. Launch fiscal year variant maintenance (transaction GVAR).
3. Choose New Entries.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 239
4. On the New Entries: Overview of Added Entries screen make the following sets of entries:

Field Name User Entry

FV RM

Description Planning month

Calendar year Do not select

Year-dependent Select

Number of posting periods 12

No. of special periods

5. Choose Enter.
6. Choose Back.

You can see the newly created entry.

To get the information to enter in the next step, open SAP Note 2112634 .
7. Mark the entry RM and select Periods from the Dialog Structure and double click to open the Calendar year
dialog.
8. Enter the year (for example, 2015) in the Calendar yr field and choose Continue.
9. On the Change View "Periods": Overview screen, choose New Entries.
10. In the Periods table, enter the data (month, day, period, year shift) for each period according to your fiscal
calendar. For an example, see the following table.

2015 Monthly Calendar (sample)

Month Day Period Year Shift

1 31 12 -1

2 28 1 0

3 28 2 0

5 2 3 0

5 30 4 0

6 27 5 0

8 1 6 0

8 29 7 0

9 26 8 0

10 31 9 0

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
240 PUBLIC Set Up the Applications
 Month Day Period Year Shift

11 28 10 0

12 26 11 0

12 31 12 0

11. Enter the last valid calendar date of the period being added in the Month and Day fields.
12. Enter the relevant Period number.
13. In the Year Shift field, enter +1 if the fiscal year is later than the calendar year enter. Enter -1 if the fiscal year
is before the calendar year.
14. Press Enter to accept the first row.
15. Continue adding each period to complete the fiscal year. Choose Save after you have finished the entries
for a year.
16. Continue adding the fiscal year variants for each year required by your scenario by repeating steps 3 to 15.
17. Choose Save after you have finished the maintenance for the last year.

6.3.5 Generate Time Data - Fiscal Calendar

In this procedure, you generate time data (Fiscal calendar) required for SAP Assortment Planning.

Use

Execute this procedure to generate time data (Fiscal calendar). This is especially required for using the Sales &
Inventory Analysis view in the My Assortment Lists app.

Procedure

1. Log on to SAP HANA studio.

2. In the Modeler perspective, on the Quick Launch tab, select your SAP Customer Activity Repository
applications bundle system and choose Generate Time Data.
3. Select Fiscal as the Calendar Type.
4. Enter the same range of years as defined in the previous procedure, Maintain Fiscal Year Variant for Retail
Week [page 237].
5. In the Variant Schema field, enter the name of the database schema that contains the tables holding the
fiscal year variant data.
For SAP Assortment Planning, these are tables T009 and T009B, which you filled with data in the previous
procedure, Maintain Fiscal Year Variant for Retail Week [page 237].
6. Select the RW fiscal year variant, defined in the previous procedure, Maintain Fiscal Year Variant for Retail
Week [page 237].

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 241
7. Choose Generate.

For more information, see:

● https://help.sap.com/viewer/p/SAP_HANA_LIVE Installation and Upgrade Administrator's Guide

Configuration Steps Generate Time Data
● https://help.sap.com/viewer/p/SAP_HANA_PLATFORM Development SAP HANA Modeling Guide (for
SAP HANA studio) Creating Information Views and Previewing its Output Generate Time Data

6.3.6 Activate Planning Framework Content (SAP

Assortment Planning)

In a new installation, only the Omnichannel SAP BW structure is supported in SAP Assortment Planning. The
Retail SAP BW Structure is supported in an existing installation with maintenance, however no new
functionality will be developed for this structure.

Prerequisite

To use the Omnichannel SAP BW structure, the following prerequisites must be met:

● Enable the usage of planning configurations under Cross-Application Components Assortment

Planning Imported Demand Data Foundation Settings Basic Settings Define Default Values . The
Omnichannel SAP BW structure only works when planning configurations are used.
● If you are integrating with SAP Merchandise Planning, enable the implementation of BAdI: Read
Merchandise Planning KPI Data under Cross-Application Components Demand Data Foundation Data
Maintenance Planning Configuration Enhancements Using Business Add-Ins .

The Omnichannel SAP BW structure consists of local BI Content only. To create workbooks on top of the
Omnichannel SAP BW structure, contact SAP Digital Business Services for a custom implementation project.

The following subsections describe the activation steps.

6.3.6.1 Activate Technical BI Content

Use

The first time you enter the Data Warehousing Workbench, the system runs a background job to activate
technical content. Technical content consists of technical information that is generated by the system, for
example, data required for the general operation of BI Content, or time data.

Procedure

1. On your back-end system, open the Data Warehousing Workbench (transaction RSA1).

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
242 PUBLIC Set Up the Applications
 2. If prompted, in the Replicate Metadata dialog box, choose Only Activate.
3. If a message appears that you are only authorized to work in client ... (Brain 009), then refer to SAP Note
316923 (do not import the support package, but use the description under section Workaround).
4. Select Do not show this question Again in the dialog that appears.
5. Choose Yes.
Make sure that the current job has finished before you proceed with the next step. Check the status of the
background job using transaction SM37or SLG1. If there are problems, you must first solve them.

 Note

If you get the short dump "RAISE_EXCEPTION" when installing InfoObjects from the BI content, see
SAP Note 1637935 for a possible solution.

Also, see SAP Notes 2090845 and 2056106 for important information on technical content
activation.

Following activation, you can locate the technical content in the Data Warehousing Workbench as follows:
1. Selecting Modeling in the left-hand frame.
2. Expand InfoObjects.
3. In the right-hand frame, locate Technical Content.
6. You can use transaction RSTCO_ADMIN to restart the activation of the technical content and to verify the
status of the activation.

6.3.6.2 Enable Optimized In-Memory Planning Capabilities

of SAP BW Integrated Planning

Use

To be able to use the SAP Analysis for Microsoft Office workbooks built on top of the SAP Assortment Planning
planning framework content, you must enable the optimized in-memory planning capabilities of the integrated
planning engine in SAP Business Warehouse (SAP BW Integrated Planning). This includes the enabling of the
Planning Application Kit (PAK).

Procedure

1. Read SAP Note 1919631 .

2. In your back-end system, launch table/view maintenance (transaction SM30).
3. Enter RSPLS_HDB_ACT in the Table/View field and choose Maintain.
4. Choose New Entries.
5. In the HANA Integratn. Active column select Deep HANA Integration Active and in the Functn. Active
column, enable the checkbox.
6. In the HANA Integratn. Active column select BPC Embedded Model Active and in the Functn. Active
column, enable the checkbox.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 243
6.3.6.3 Activate Application BI Content (Omnichannel SAP
BW Structure)

Context

In this procedure, you perform a sequential, step-by-step activation of the local BI Content objects delivered in
the Omnichannel SAP BW structure of the SAP Assortment Planning application. SAP Assortment Planning
uses this application BI Content to consume data stored in the back-end system

 Note

To ensure correct activation of the BI Content objects, carry out the activation sequentially, as specified in
the following procedures. Resolve any activation warnings, except for the ones listed under Result [page
251], which can be ignored.

Also, do not disable the default BI setting to collect and activate all dependencies. The instructions below
activate a minimum subset of objects, and it assumed that all their dependencies are collected and
activated.

The consumed data from the back-end system can be created by the SAP Assortment Planning application, or
be replicated from a source master data system. In both cases, beware of limitations with regard to the
characters allowed by SAP BW. For more information, see:

● SAP Assortment Planning Administration Guide under Initial Load of Data to DDF Using DRFOUT
● 173241
● Customizing activity Maintain permitted extra characters under SAP NetWeaver Business Warehouse
General Settings .

Procedure

1. On your back-end SAP Assortment Planning system, open the Data Warehousing Workbench (transaction
RSA1).
2. Verify transport connections.
1. Select Transport Connection in the left-hand frame.
2. Select Object Types.
3. Expand Source System.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
244 PUBLIC Set Up the Applications
 Selecting Source Systems
4. Use Select Objects to ensure that the back-end system is selected as the source system.
5. Choose Transfer Selections.
6. At the top of the right-hand frame, above the list of Collected objects, choose Grouping and select Only
Necessary Objects.
7. At the top of the right-hand frame, choose Collection Mode and select Collect Automatically.

Grouping and Collection Settings

3. Determine if you need to enable to Match (X) or copy option for the BI Content, which you will activate in
the subsequent steps.

Match(X) or copy Selection

Installation Type Selection

New Installation Do not enable the Match (X) or copy option for any of the BI Content objects.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 245
 Installation Type Selection

Upgrade Standard /RAP/* BI Content ob­ Standard /RAP/* BI Content objects have been
jects have not been modified in modified in your local environment1
(Previously installed/
your local environment1
activated any of
the /RAP/* BI Content) Do not enable the Match (X) or copy Enable the Match (X) or copy option.
option for any of the BI Content ob­
During the activation of each BI Content object type,
jects.
you will be asked to carry out an additional Transfer
selections step. In this step, select to install the
Active Version (that is, your modified version) or the
Content Version (that is, the SAP delivered, and pos­
sibly updated version of the object). The project im­
plementation team should advise you on which op­
tion is required for each object.

 Caution
When you choose to install the Content Version,
the SAP delivered objects included in the current
release will be installed regardless of any modifi-
cations made to the currently existing BI Con­
tent objects.

1 As a system administrator, you may need to contact the SAP Assortment Planning project implementation team to
learn if standard, SAP-delivered, BI Content objects have been modified in your local environment.

4. Activate InfoObject catalogs.

If at any point during the installation of BI Content objects you are presented with a dialog asking you to
add objects to a personal list, we recommend that you select No.

 Remember

You can ignore activation warnings listed under Result [page 251].

1. Select BI Content in the left-hand frame.

2. Select Object Types and expand InfoObject Catalog.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
246 PUBLIC Set Up the Applications
 3. Use Select Objects to select the /RAP/CHAR_CAT and the /RAP/KYF_CAT catalogs.
4. Choose Transfer Selections.
5. In the right-hand frame, in the list of Collected objects, verify that both InfoObject catalogs are listed.
6. Right-click on each of the InfoObject catalogs, and choose Install all Bellow.
7. Choose Install.
If an information dialog box appears, choose Continue. Choose Local Object or enter a package if you
need to transport the objects.
5. Activate Variables.

 Remember

You can ignore activation warnings listed under Result [page 251].

1. Select BI Content in the left-hand frame.

2. Select Object Types and expand Query Elements followed by Variable.
3. Use Select Objects to select the following variables:
○ /RAP/PLCND_ESM_02
○ /RAP/PLCSET_ESM_02
○ /RAP/PCYCLE_EMM_01
○ /RAP/PLNHR_MSO_01
○ /RAP/PLNHN1_MSO_01 to /RAP/PLNHN9_MSO_01 (inclusive)
○ /RAP/PRDHN1_MMO_01 to /RAP/PRDHN9_MMO_01 (inclusive)

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 247
 4. Choose Transfer Selections.
5. In the right-hand frame, in the list of Collected objects, verify that all of the selected variables are listed
and that the option in the Install column is enabled .
6. Choose Install.
If an information dialog box appears, choose Continue. Choose Local Object or enter a package if you
need to transport the objects.
6. Maintain version master data.

1. In the left-hand frame, select Modeling InfoObjects .

2. In the right-hand frame under Assortment Planning for Retail RAP Character InfoObject Catalog ,
search in the object list for the InfoObject /RAP/VERSN.
3. Right-click the InfoObject /RAP/VERSN, choose Maintain Master Data from the context menu, and
maintain the following entries on the Time Independent tab:

Version Short description

# An empty version value that you must maintain

ALV Assortment List Vsn

APF Vsn of final plan

 Note

Save your changes and activate them.

7. Activate Advanced DataStore Objects.

If during the installation, you are presented with a message stating that your source system is not active,
navigate to the Modeling tab, locate your source system under Source Systems, and activate it by right-
clicking and selecting Activate. If prompted, choose Only Activate .

 Remember

You can ignore activation warnings listed under Result [page 251].

1. Select BI Content in the left-hand frame.

2. Select Object Types and expand DataStore Object (advanced).
3. Use Select Objects to select all DataStore Objects starting with /RAP/DS*.
4. Choose Transfer Selections.
5. In the list of Collected objects, verify that the option in the Install column is enabled for each of the
objects.
6. Choose Display List .
7. Right-click the tree node DataStore Object (advanced) and choose Install all Below.
8. Choose Install. If an information dialog box appears, choose Continue. Choose Local Object or enter a
package if you need to transport the objects.
8. Activate CompositeProviders.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
248 PUBLIC Set Up the Applications
  Remember

You can ignore activation warnings listed under Result [page 251].

1. Select BI Content in the left-hand frame.

2. Select Object Types and expand CompositeProvider.
3. Use Select Objects to select all CompositeProviders from /RAP/CP40 to /RAP/CP46 (inclusive).
4. Choose Transfer Selections.
5. In the list of Collected objects, verify that the option in the Install column is enabled for each of the
objects.
6. Choose Display List .
7. Right-click the tree node DataStore Object (advanced) and choose Install all Below.
8. Choose Install. If an information dialog box appears, choose Continue. Choose Local Object or enter a
package if you need to transport the objects.
9. Activate Aggregation Levels.

 Remember

You can ignore activation warnings listed under Result [page 251].

1. Select BI Content in the left-hand frame.

2. Select Object Types and expand Planning Aggregation Level .
3. Use Select Objects to select the following Aggregation Level:

Aggregation Levels

Aggregation Levels

/RAP/C44A01

/RAP/C44A02

/RAP/C44A03

/RAP/C44A04

/RAP/C46A02

4. Choose Transfer Selections.

5. In the list of Collected objects, verify that the option in the Install column is enabled for each of the
objects.
6. Choose Install. If an information dialog box appears, choose Continue. Choose Local Object or enter a
package if you need to transport the objects.

10. Activate Planning Sequence Objects.

 Remember

You can ignore activation warnings listed under Result [page 251].

1. Select BI Content in the left-hand frame.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 249
 2. Select Object Types and expand Planning Planning Sequence .
3. Use Select Objects to select the following Planning Sequences:

Planning Sequences

Planning Sequences

/RAP/D50A01_PS01

/RAP/D57A01_PS01

/RAP/C40A01_PS01

/RAP/C40A05_PS01

/RAP/C46A01_PS01

/RAP/C46A03_PS01

/RAP/C46A04_PS01

/RAP/C46A04_PS02

4. Choose Transfer Selections.

5. In the list of Collected objects, verify that the option in the Install column is enabled for each of the
objects.
6. Choose Install. If an information dialog box appears, choose Continue. Choose Local Object or enter a
package if you need to transport the objects.

11. Activate Planning Function Type Objects.

 Remember

You can ignore activation warnings listed under Result [page 251].

1. Select BI Content in the left-hand frame.

2. Select Object Types and expand Planning Function Type for Planning .
3. Use Select Objects to select the following Planning Function:

Planning Functions

Planning Functions

/RAP/OP_BUFFER_DATA

4. Choose Transfer Selections.

5. In the list of Collected objects, verify that the option in the Install column is enabled for each of the
objects.
6. Choose Install. If an information dialog box appears, choose Continue. Choose Local Object or enter a
package if you need to transport the objects.

12. Choose Exit to leave the transaction.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
250 PUBLIC Set Up the Applications
Results

If activation warnings similar to the ones displayed below appear, you can ignore them.

● CMP problem occurred in characteristic <CHAR> for InfoProvider <INFO_PROV>

● Rounding inaccuracies occur with data type FLOAT for AMOUNT and QUANTITY
● Characteristic <CHAR>: Lower case makes selection of char. values difficult
● Data type of char. <CHAR> (<TYPE1>) is not equal to data type of attribute <ATTR> (<TYPE2>)
● Length of characteristic <TEXT CHAR> (<LENGTH1>) and assigned attribute <ATTR> (<LENGTH2>) not
same
● The short text of DataSource <SOURCE> is not maintained in language <LANG>
● Skip key figure <KYF>: aggregation type NO2 not supported
● Attribute <ATTR>: Conversion routine <CONV> ignored
● Attribute <ATTR>: Compounding ignored
● Datatype FLTP for datafield <FIELD> of the DSO is not allowed
● Conversion problems possible for source field <FIELD1> / target field <FIELD2>

6.3.7 Configure Data Replication

SAP Assortment Planning uses master data, sales history data, inventory data, and merchandise planning data
originating from connected systems, such as SAP Retail (SAP ERP) or SAP BW.

For more information, see SAP Assortment Planning Administration Guide under Configure Data Replication.

6.3.8 Run the Validation Report

1. Run transaction /DMF/VAL_CAR_INSTALL.

Alternatively, run transaction SE38 and execute the /DMF/VALIDATE_CAR_INSTALLATION report.
2. Select the Assortment Planning scenario and select Execute.
In the dialog that appears, select whether to validate the Retail SAP BW structure, the Omnichannel SAP
BW structure, or both. The SAP BW structure to validate depends on the structure that you have selected
to activate during the previous step Activate Planning Framework Content (SAP Assortment Planning)
[page 242] .

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 251
 Running this report allows you to verify the success of the installation, providing a log of potential issues.
For example, you may be presented with the following results:

Validation Report Results

View the long text associated with each message to see the link to the documentation describing the
procedure you have to troubleshoot.

Related Information

Activate Planning Framework Content (SAP Assortment Planning) [page 242]

6.3.9 Configure Front-End

6.3.9.1 Configure SAP Gateway

For information about the configuration and activation of SAP Gateway as well as the activation of all the
common OData services for SAP Fiori, see Configure SAP Gateway [page 95].

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
252 PUBLIC Set Up the Applications
6.3.9.2 Configure Index Calculation

We recommend that you schedule the Calculation of SAPUI5 Application Index for SAPUI5 Repositories report
(/UI5/APP_INDEX_CALCULATE) to run as a background job on your front-end server.

This is one of the mandatory tasks under SAP Customer Activity Repository Core (Mandatory for All
Applications) that you have most likely performed already. If not, see Calculate SAPUI5 Application Index for
SAP Fiori Apps [page 103].

6.3.9.3 Activate SAP Assortment Planning ICF Services

Use

For security reasons, all Internet Communication Framework (ICF) services relevant to your SAP Assortment
Planning application are made available in an inactive state.

You have activated the central ICF services as described in Perform General SAP Gateway Configuration [page
95] and Configure SAP Fiori Launchpad [page 102]. This procedure provides the instructions to activate ICF
services required for the SAP Assortment Planning SAP Fiori apps.

Procedure

1. Log on to your front-end server.

2. Open service maintenance (transaction SICF).
3. In the Define Services screen, select the Location Clustering service by specifying the following:
○ Hierarchy Type: SERVICE
○ Virtual Host: DEFAULT_HOST
○ Service Path: /sap/bc/ui5_ui5/sap/locclsts_v2/
4. Choose Execute.
5. To activate the service, choose Service/host Activate.
6. Repeat steps 3 to 5 to ensure that all of the following services are activated:
○ /sap/bc/ui5_ui5/sap/attribmgmt_v2/
○ /sap/bc/ui5_ui5/sap/assortlist/
○ /sap/bc/ui5_ui5/sap/ddfreuse_v2/
○ /sap/bc/ui5_ui5/sap/locclsts_v2/
○ /sap/bc/ui5_ui5/sap/modulemgmt_v2/
○ /sap/bc/ui5_ui5/sap/optionplan_v2/
○ /sap/bc/ui5_ui5/sap/phpmatch_v2/
○ /sap/bc/ui5_ui5/sap/plnconfig/
○ /sap/bc/ui5_ui5/sap/optionplanning

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 253
6.3.9.4 Define System Alias for Back-End Transactions

Use

A number of SAP Fiori apps, installed on your front-end system, launch transactions directly on the back-end
system. For example, the Manage Products tile actually launches the Demand Data Foundation (DDF)
POWL_EASY WebDynpro application.

To enable this behavior, you need to create a dedicated RFC connection between the front-end system and the
back-end system.

Procedure

1. Log on to your front-end system, that is, the system where you have installed the user interface (UI)
components of your application.
2. Launch Configuration of RFC Connections (transaction SM59).
3. Create an RFC connection with the following settings:
○ RFC Destination: SAP_ISR_CARAB
Connection Type: H (HTTP connection)
Ensure to maintain all of the settings required to connect to your back-end system, in particular, the Target
Host entry on the Technical Settings tab.
4. Save your changes.
5. Create another RFC connection with the following settings:
○ RFC Destination: SAP_ERP_ISR_CARAB
Connection Type: H (HTTP connection)
Ensure to maintain all of the settings required to connect your front-end system to the source master data
system, in particular, the Target Host entry on the Technical Settings tab.
6. Save your changes.
7. Open Launchpad Customizing (transaction LPD_CUST).
8. Select the SAP Assortment Planning role ( UIRAP001), and choose Display.
The two catalogs, Assortment Planner and Planning Administrator, are displayed.
9. In each of the catalogs, selecting one app at a time, make the following settings:

Catalog App System Alias Description

Assortment View Log SAP_ISR_CARAB This setting allows the My Assortment Lists app to
Planner launch transaction SLG1 on the back-end system.

 Note
This application is only used to configure a link to
the back-end system, you do not need to add this
app to your SAP Fiori launchpad.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
254 PUBLIC Set Up the Applications
 Catalog App System Alias Description

View ExtAssort SAP_ERP_ISR_CAR This setting allows the My Assortment Lists app to
Listing Conditions AB launch transaction WSL10 on the connected SAP Retail
or SAP S/4HANA system.

 Note
This application is only used to configure a link to
the SAP Retail or SAP S/4HANA system, you do not
need to add this app to your SAP Fiori launchpad.

View External SAP_ERP_ISR_CAR This setting allows the My Assortment Lists app to
Assortments AB launch:

Transaction WRF_WS0A3 on the connected SAP Retail

system

Transaction WS0A3 on the connected SAP S4HANA sys­

tem.

 Note
This application is only used to configure a link to
the SAP Retail or SAP S/4HANA system, you do not
need to add this app to your SAP Fiori launchpad.

Planning Manage Category SAP_ISR_CARAB This setting allows the Manage Category Responsibilities
Administrator responsibilities app to launch the corresponding DDF WebDynpro appli­
cation.

Manage Market SAP_ISR_CARAB This setting allows the Manage Market Responsibilities
responsibilities app to launch the corresponding DDF WebDynpro appli­
cation.

Manage Products SAP_ISR_CARAB This setting allows the Manage Products app to launch
the corresponding DDF WebDynpro application.

Manage Locations SAP_ISR_CARAB This setting allows the Manage Locations app to launch
the corresponding DDF WebDynpro application.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 255
6.3.9.5 Assign Roles, Catalogs, and Groups in SAP Fiori
Launchpad

Use

To be able to access SAP Fiori apps that constitute the SAP Assortment Planning user interface from the SAP
Fiori launchpad, your front-end system user must have the necessary roles assigned. Based on the role(s)
assigned to your user, you can access certain business catalogs and business catalog groups.

Your SAP Assortment Planning application is delivered with two predefined roles, catalogs, and groups. These
include technical content as well as business content:

Front-End Server Business Content Front-End Technical Content

Technical
Business Role Business Catalog Business Catalog Group Technical Role Catalog

SAP_RAP_BCR_AP_PL SAP_RAP_BC_AP_PLA SAP_RAP_BCG_AP_PLANNER SAP_RAP_TCR_T SAP_RAP_TC

ANNER NNER _T

SAP_RAP_BCR_PLANN SAP_RAP_BC_PLANNI SAP_RAP_BCG_PLANNING_ADM

ING_ADMIN NG_ADMIN IN

To test the installation of SAP Assortment Planning from the SAP Fiori launchpad, you need to assign the roles
above to your user on the front-end system.

Procedure

1. Log on to your front-end system.

2. Launch User Maintenance (transaction SU01).
3. Enter your user name in the User field and choose Change.
4. On the Roles tab, assign the roles SAP_RAP_BCR_AP_PLANNER and SAP_RAP_BCR_PLANNING_ADMIN to
your user.

 Caution

If you already have an SAP Fiori launchpad open, you must clear your browser cache to apply any
modifications made to your user roles. Otherwise, your changes will not be reflected in the SAP Fiori
user interface.

More Information

Security Information section of the SAP Assortment Planning Administrator's Guide.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
256 PUBLIC Set Up the Applications
6.3.10 Additional Information for Retail SAP BW Structure

6.3.10.1 Specify Analysis Workbooks Settings

The Retail SAP BW Structure of SAP Assortment Planning is delivered with some SAP Analysis for Microsoft
Office workbooks. These are template workbooks that you can adapt to use in your retail business. However,
you should not use the Retail SAP BW Structure in a new installation but the Omnichannel SAP BW Structure.

For an example of how to create customized versions of the workbooks, see Workbook Design Example [page
260].

6.3.10.1.1 Enable Macros

Use

In this procedure, you enable your SAP Analysis for Microsoft Office workbooks to use macros.

Procedure

1. Open SAP Analysis for Microsoft Office from Start All Programs SAP Business Intelligence SAP
BusinessObjects Analysis Analysis for Microsoft Excel .
2. Choose File Options Customize Ribbon .
3. Under Customize the Ribbon, select Main Tabs.
4. Enable the entry Developer and confirm by choosing OK.
5. Now you will see the new Developer tab in your SAP Analysis for Microsoft Office.
6. Select the Developer Tab and choose Macro Security.
7. Choose Enable all macros.

6.3.10.1.2 Set Language for Ribbons and Buttons in

Workbooks

Use

In this procedure, you can set the desired language of the following user interface objects that are specific to
the workbooks of SAP Assortment Planning:

● Ribbons Planning Functions, Refinement Functions, and Extended Features

● Tooltips for planning functions

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 257
● Message texts
● Buttons.

The content of the workbooks consists of multiple parts:

● The language of the standard menus and standard ribbons depends on the language set for Microsoft
Excel.
● The language of the contents in the cells (mainly KPIs) depends on the user-selected system language of
the back-end system.
● The language of the user interface objects that are specific to the workbooks of SAP Assortment Planning,
is not set by the selected system language of the back-end system, but you can change it for each
workbook according to the following procedure. The default language is English.

Procedure

1. Unhide the worksheet SAP_TEXT_CUSTOMIZING using standard functionality of Microsoft Excel.

2. On the worksheet SAP_TEXT_CUSTOMIZING, copy the column of the desired language to column B -
Custom Text.
3. Hide the worksheet SAP_TEXT_CUSTOMIZING.
4. Save your changes in the worksheet on the SAP NetWeaver Server by choosing File Analysis Save
Workbook to SAP NetWeaver .

 Note

To allow for correct interpretation of the texts by screen readers, make sure that the language for all parts
of the workbooks is set to the same desired one. Set the language as described in this section.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
258 PUBLIC Set Up the Applications
6.3.10.1.3 Set ResultSetSizeLimit Registry Setting

Use

By default, SAP Analysis for Microsoft Office workbooks are set to display 500,000 cells. This setting might not
be sufficient for the productive use of SAP Assortment Planning. For example, if you have more than 300
products in your assortment plan, you might encounter the following error message:

Size Limit Error

To resolve this issue, you need to increase the default setting of the ResultSetSizeLimit registry setting.

Procedure

Read and implement SAP Note 1662968 .

 Note

As the administrator overseeing the installation of SAP Assortment Planning, you need to carry out the
steps listed in this procedure on the workstation of each SAP Assortment Planning user.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 259
6.3.10.2 Workbook Design Example

Use

In this procedure, you walk through an example of creating an SAP Analysis for Microsoft Office workbook. You
can use steps of this procedure to create customized versions of the SAP-delivered assortment planning
workbooks.

Prerequisites

The necessary BI queries must exist in the back-end system.

Procedure

1. Open SAP Analysis for Microsoft Office from Start All Programs SAP Business Intelligence SAP
BusinessObjects Analysis Analysis for Microsoft Excel .
2. Select the cell in the worksheet where the crosstab with the data from the selected data source should be
inserted.
3. From the menu, choose Analysis Insert Select Data Source .
4. Choose Skip on the popup window Logon to SAP BusinessObjects BI Platform.
5. In the Select Data Source dialog box, select the source system, then choose Next.
6. In the Logon to system <Your System Name> dialog box, enter your logon data, then choose OK.
7. In the Select Data Source dialog box, choose tab Search.
8. In the Search tab, you can search for the description or technical name of a data source, that is, the name
of the BI query that will provide the data for your workbook.
For example, search for /RAP/M01A01_IRQ02 or /RAP/M01A01_IRQ01. In general, you can search for /
RAP* to find any SAP Assortment Planning query.
9. Select the required data source, and then choose OK.
10. On the Prompts screen, make the relevant entries base on the selected query in the Specify Value for
Prompts area.
11. Choose OK, and then you will see the table is inserted in the sheet. You can now analyze the data and
change the displayed data set according to your needs. You can also add other components to your
analysis, for example charts.
12. Choose menu Analysis Display to open the design panel.
13. Choose the Components tab in the bottom right corner, and right-click Book1 and choose Use Planning
Sequence.
14. In the Search For field of the Open Planning Sequence dialog box enter your planning sequence and choose
Search.
15. Select the required planning sequence, and then choose OK. The planning sequence will be displayed
under Book1 Planning Objects in the design panel.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
260 PUBLIC Set Up the Applications
 16. Select the cell in the worksheet where a button should be inserted.
17. From the menu, choose Developer Insert Button (Form Control) , and insert the button using drag
and drop.
18. In the Assign Macro dialog box, choose New.
19. In the VB edit, maintain the relevant code in the Sub ButtonX_Click area.
20.Choose Close.
21. Right-click the button, and choose Edit Text. Replace the button name with a meaningful name.
22. Position your cursor where the condition will be defined, and make the relevant entries.
23. Select the sheet and position the cursor where the variable list will be inserted, for example cell H1 in
sheet1.
24. Choose menu Analysis Info Field Variables , and the variables will be inserted into the relevant
sheet.
25. Maintain the relevant entries in the sheet.
26. Choose your Planning Sequence in the design panel.
27. In the section of Variables of Planning Sequence, make the relevant entries.
28. Choose Save Button.
29. Provide a file name and save the workbook as type Excel Macro-Enabled Workbook (*.xlsm).
30.Choose Save.

Result

The customized workbook is created.

6.4 SAP Promotion Management

Using SAP Promotion Management functions

For full use of the SAP Promotion Management application, you must have a license for use of SAP Promotion
Management.

 Note

Limited functionality is available to users without an SAP Promotion Management license.

To use the FIORI-based user interface, implement the /DMF/IMPL_FIORI_PMR_SW BAdI from Customizing
Cross-Application Components Demand Data Foundation Data Maintenance Offer Implementation: Fiori
Offers Switch .

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 261
6.4.1 Perform Core Steps for SAP Customer Activity
Repository

To set up this application, you must first perform the Core (Mandatory) steps for SAP Customer Activity
Repository. The core steps are mandatory for all the consuming applications.

Procedure

Perform all steps listed under Core (Mandatory for All Applications) [page 73].

6.4.2 Activate Internet Communication Framework (ICF)

Services

For security reasons, all Internet Communication Framework (ICF) services relevant to your SAP Promotion
Management application are made available in an inactive state. In this procedure, you activate an ICF service
required for the SAP Manage Promotional Offers Fiori app.

1. Log on to your front-end system.

2. Open service maintenance (transaction SICF).
3. In the Maintain Service screen, select the service by specifying the following:
○ Hierarchy Type: SERVICE
○ Virtual Host: DEFAULT_HOST
○ Service Path: /sap/bc/bsp/sap/
4. Choose Execute
5. To activate the service, choose Service/host Activate
6. Repeat steps 3 to 5 to ensure that all of the following services are activated:
○ pmroffers
○ pmrcontent
○ prodgrps
○ locsubgrp
○ eventprv

6.5 SAP Allocation Management

Post-installation setup for SAP Allocation Management

1. Perform Core Steps for SAP Customer Activity Repository [page 183]
2. Activate SAP Allocation Management SAP HANA Content [page 263]
3. Check Procedure Associated with Function GENIOS_SOLVE Is Active [page 267]

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
262 PUBLIC Set Up the Applications
 4. Preselect Product Data [page 268]
5. Configure SAP Allocation Management [page 268]
6. Configure Data Replication [page 269]
7. Configure Front End [page 272]

6.5.1 Perform Core Steps for SAP Customer Activity

Repository

To set up this application, you must first perform the Core (Mandatory) steps for SAP Customer Activity
Repository. The core steps are mandatory for all the consuming applications.

Procedure

Perform all steps listed under Core (Mandatory for All Applications) [page 73].

6.5.2 Activate SAP Allocation Management SAP HANA

Content

Once all previous steps are successfully completed, you can activate SAP Allocation Management SAP HANA
content.

Prerequisites

Before you can start to activate the SAP Allocation Management SAP HANA content, perform these activities:

● Ensure that you have at least one of the SAP_ECC or SAP_S4H schemas in the SAP HANA database. Based
on your source system for all SAP ERP data, you have either a SAP_ECC schema or a SAP_S4H schema
(either physical schemas with these names, or at least authoring schemas). If you have both these
systems, you must have two schemas.
● Ensure that all tables listed for SLT replication are available in the relevant schemas. The spreadsheet with
tables that are relevant for replication and for SAP HANA content activation is available on SAP Help Portal
at https://help.sap.com/viewer/p/CARAB. Select the desired version at the top right and download the SLT
Tables for SAP Customer Activity Repository applications bundle archive from under Installation and
Upgrade and extract the spreadsheet.
Ensure that you have successfully set up the SLT tables in the schemas.
● Ensure that you have implemented the following SAP Notes: 2850296 (Support for S/4H 1909 source
system in report /DMF/CREATE_SLT_TABLES and 2850366 (HANA Content helper report (Dummy
tables)).

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 263
SAP HANA Content Activation Steps

1. Deploy SAP Allocation Management delivered procedures, functions, and views.

SAP Allocation Management delivers several native HANA objects as a part of the application. These
objects are delivered via HANA transport for ABAP (HTA) and must be explicitly deployed into the SAP
HANA database. Without this deployment, you do not see these objects in the SAP HANA database. Once
deployed, you can find the content via the path sap.is.retail.rap.amr.db.
2. Activate SAP Customer Activity Repository and Demand Data Foundation (DDF) SAP HANA content.

 Note

If the SAP Customer Activity Repository and DDF SAP HANA content is already active, you can skip this
step.

SAP Allocation Management depends on active SAP HANA content for SAP Customer Activity Repository
and DDF. Therefore, it is recommended that you first activate the SAP Customer Activity Repository and
DDF SAP HANA content.
Run the program Activate SAP HANA Content for SAP CARAB (/CAR/ACTIVATE_HTA) and select the ECC
Mode relevant to your installation. Under Business Scenario Activation, select the Customer Activity
Repository and Demand Data Foundation options.
Execute the activation report. As a result, you have successfully activated and deployed the SAP HANA
content for SAP Customer Activity Repository and DDF.

 Caution

Do not select Allocation Management within this activation run for a simultaneous activation of SAP
Allocation Management SAP HANA content as simultaneous activation leads to activation problems.

3. Run the dummy schema and dummy table creation reports.

The reports check for a missing physical schema and create this physical schema and the corresponding
dummy tables in the schema if necessary. The successful completion of this step is a prerequisite for a
successful SAP HANA content activation for SAP Allocation Management.

 Note

The running of the report requires a database user in the ABAP system with the authorization to create
the dummy schema. Check the application log for the report if there were errors.

In your back-end system, start transaction SE38 and execute the following two reports, in the sequence
they are listed:
○ /DMF/CREATE_SLT_TABLES (Create SLT Tables)
1. Select your source system. For S/4HANA, enter the release.
2. Enter the physical source and dummy schema names. For the Physical Source Schema, enter the
physical schema name into which your SLT tables are replicating. For the Physical Dummy Schema,
enter the name for the schema to be created. If the physical source schema already exists in the SAP
HANA database, then only the dummy tables in this schema are created when you execute the report.
3. Select the simulation mode for a test run. After the simulation run, you can check for errors in the
application log.
○ /AMR/CREATE_DYNAMIC_SLT_TABLES (Create SLT Tables Dynamically)
1. Select your source system. For S/4HANA, enter the release.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
264 PUBLIC Set Up the Applications
 2. Enter the physical source and dummy schema names. For the Physical Source Schema, enter the
physical schema name into which your SLT tables are replicating. For the Physical Dummy Schema,
enter the name for the schema to be created. If the physical source schema already exists in the SAP
HANA database, then only the dummy tables in this schema are created when you execute the report.
3. Select the simulation mode for a test run. After the simulation run, you can check for errors in the
application log.
4. Set Prework Done for SAP Allocation Management packages.
A precondition for SAP HANA Transport for ABAP (HTA) activation is that the PREWORK_DONE indicator is
set for all packages with activation mode P – prework needed. You can check this setting in the table
CTS_HOT_PACKAGE in field HOT_ACTIVATION_MODE.
You can set the PREWORK_DONE indicator for all packages relevant for SAP Allocation Management
manually or by implementing an SAP Note. To make the setting manually, follow the additional steps listed
in this step. Alternatively, implement SAP Note 2861929 (Setting the PREWORK_DONE flag in table
CTS_HOT_PREWORK for AMR HANA Content packages) instead of setting the indicator manually.
The manual steps are as follows:
1. Run the program Activate SAP HANA Content for SAP CARAB (/CAR/ACTIVATE_HTA) with the
following settings:
○ Select the relevant setting under ECC Mode.
○ Under Business Scenario Activation, select the Allocation Management option.
○ Under Processing Control, select Perform Prerequisite Check.
2. Call transaction SE16 (Data Browser) and display the content of table CTS_HOT_PACKAGE.
Search for package names sap.is.retail.rap.amr* in the field HANA_PACKAGE_ID. Please note,
that the package names are case-sensitive.
You should find 163 entries that match the search criterion. Copy the package names from the result
list of your search.
3. Display the selection screen of table CTS_HOT_PREWORK. Enter the HANA_PACKAGE_ID for all
packages from the result list of your search in table CTS_HOT_PACKAGE.
4. Set the PREWORK_DONE indicator to X for all packages in the CTS_HOT_PREWORK table. The indicator
shows that the SAP HANA content in all packages relevant for SAP Allocation Management is ready for
deployment.
5. Grant Authorization
The two SLT table creation reports use the database user maintained in the ABAP system to create the
dummy schemas. The _SYS_REPO user needs the exact same authorizations on the newly created dummy
schema that this user already has on the physical source schema. In addition, to display the schema in the
navigator, a SELECT authorization on the schema (with GRANT option) must be provided to the database
user for the content activation.

 Note

This step must be performed by the SAP HANA database administrator who has the authorization for
these activities.

6. Check and maintain schema mapping.

Check the names you use for your physical schema. If you are using the default names below, no further
action is required:
○ SAP_S4H, for your S/4HANA schema
○ SAP_ECC, for your ECC or FMS schema
If you have chosen names for your physical schema, which are different from the names above, you must
do the following:

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 265
 Maintain a schema mapping in your SAP HANA database, where your customer-specific names are used
as authoring schemas for the physical schema.
7. Activate relevant inactive SAP HANA content for DDF.
Based on your scenario, there can be inactive packages in DDF, even though you have activated the content
earlier via the report /CAR/ACTIVATE_HTA (Activate SAP HANA Content for SAP CARAB).
For the following packages in DDF, perform these actions:
○ In the table CTS_HOT_PREWORK, set the PREWORK_DONE indicator to X for these packages.
○ Call up transaction SCTS_HTA_DEPLOY (SAP HANA Transport for ABAP - Deployment) to check and to
deploy (if not already deployed) these packages, in strictly the sequence they are listed. Do not select
the option to Include subpackages:
○ sap.is.ddf.ecc
○ sap.is.ddf.fms
○ sap.is.ddf.fms_s4h
○ sap.is.ddf.cross.ecc
○ sap.is.ddf.cross.fms
○ sap.is.ddf.cross.fms_s4h
○ sap.is.ddf.cross

 Note

The package names are case-sensitive.

If your SAP ERP Retail release has tables that do not contain any FMS fields, some views might not be
activated successfully in the fms and fms_s4h packages. You can continue with further activation
steps nevertheless.

8. Once you have successfully deployed all content as described in the previous steps, call up transaction SAP
HANA Transport for ABAP - Deployment (SCTS_HTA_DEPLOY). To deploy the SAP Allocation Management
packages, enter package name sap.is.retail.rap.amr* and choose Execute.

 Note

With this step, the SAP Allocation Management SAP HANA content is finally deployed. It is the last and
most critical activation step.

Checking for Missing Views

If content activation errors occur, check for missing views in the database. For more information, see
Troubleshooting: Missing Views in Database [page 267].

Related Information

Create/Replicate Source Master Data System Tables [page 81]

Activate SAP HANA Content [page 85]

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
266 PUBLIC Set Up the Applications
6.5.2.1 Troubleshooting: Missing Views in Database

After the SAP HANA content activation, you can check for missing views in transaction DB02.

Check if SAP Allocation Management views are highlighted as objects missing in the database. There could be
some missing objects, despite having received success messages from the previous step of activating SAP
Allocation Management SAP HANA content.

1. Call up transaction Diagnostics: Missing Tables and Indexes (DB02)

2. Select Diagnostics Tables/Views and enter the technical name.
3. Check if any SAP Allocation Management views are displayed as missing in the database.
4. If there are views missing in the database, raise a support ticket.

6.5.3 Check Procedure Associated with Function

GENIOS_SOLVE Is Active

For SAP Allocation Management, confirm that the procedure associated with function GENIOS_SOLVE is active
in the _SYS_AFL catalog.

Prerequisites

You have configured the AFL usage and confirmed that the OFL algorithm was installed successfully as
described in section Check the OFL Installation [page 48].

Context

Procedure

1. Go to SAP HANA Systems view in the SAP HANA Development Perspective.

2. In your system, filter for catalog _SYS_AFL.
3. In the _SYS_AFL catalog, filter on procedures to search for OFL_AREA_GENIOS_DOLVE_PROC
4. Confirm that this procedure OFL_AREA_GENIOS_SOLVE_PROC is available.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 267
6.5.4 Preselect Product Data

To make product data available in SAP Allocation Management applications, this data must be preselected.

To do this, you must run the report /AMR/PRECALCULATE_PRODUCT (Precalculation of Products) as part of
system set-up. The report requires no additional data selection and can be executed either directly or as a
scheduled job in the background, depending on the volume of product master data in the system.

 Note

You must run this report only once. Any other changes in the data are handled by the general preselection
report (/AMR/PRECALCULATION - Execute Preselection).

6.5.5 Configure SAP Allocation Management

To use SAP Allocation Management, you must define several application-specific settings in Customizing.

General Settings

Define the settings under SAP Implementation Guide Cross-Application Components Allocation
Management .

SAP Allocation Management provides optional integration scenarios with:

● UDF (Unified Demand Forecast)

● SAP Assortment Planning

Both scenarios require additional installation steps, which are described in sections SAP Assortment Planning
[page 235] and Complete UDF Setup [page 112] of this guide.

Allocation information from allocation plans can be transferred to follow-on systems to create the
corresponding allocation tables. You set up the transfer of allocation plans with the implementation of SAP
Notes in the follow-on systems. For more information, see Implement SAP Notes for the Installation [page 26].

Activation of Notifications

As part of the promotional push business scenario, you can enable the creation of push notifications for users.
These notifications inform responsible users about important changes that affect existing allocation plans, for
example, the deletion of an offer or product or a change in the offer validity period.

To activate these notifications in your SAP Customer Activity Repository system, proceed as follows:

1. Under SAP Implementation Guide SAP NetWeaver Notification Channel Notification Channel
Provider Enablement Administration Notification Provider Settings , access the Register Notification
Providers Customizing activity.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
268 PUBLIC Set Up the Applications
 2. In this activity, make sure that the following information is available:
○ Provider ID: /AMR/NOTIF_PROMO_PUSH
○ Provider class: /AMR/CL_NOTIF_PROVIDER
3. Then activate this provider in the Manage Notification Providers activity in the Notification Provider Settings
group that you accessed in Step 1.

6.5.6 Configure Data Replication

SAP Allocation Management uses master data such as product, store, and product hierarchy that is imported
to the Demand Data Foundation (DDF) and Unified Demand Forecast (UDF) modules using the data replication
framework (DRF, transaction DRFOUT).

 Note

Not all of the master data is replicated using the data replication framework. Some data must be replicated
separately using SAP Landscape Transformation Replication Server (SLT).

For detailed information about the SLT replication procedure, see Create/Replicate Source Master Data
System Tables [page 81].

6.5.6.1 Initial Load of Data to DDF Using DRFOUT

SAP Allocation Management uses master data, such as product, location, and product hierarchy, that is
replicated from SAP Retail or SAP S/4HANA to DDF using DRFOUT.

Procedure

SAP Allocation Management specifically requires that the following data is replicated sequentially from a
connected SAP ERP system using DRFOUT:

Sequence Master Data Technical Details For more information, see:

1 Product Hierarchy ● SAP ERP Description: Material Group

http://help.sap.com/car <your
Hierarchy
release> Application Help Demand
● DRFOUT Outbound Implementation:
PMCH Data Foundation Integration Information

● DDF Inbound Interface: /DMF/ Inbound Interfaces For Remote Function

MDIF_PROD_HIER_INBOUND Call (RFC) Communication Product

Hierarchy Master Data

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 269
Sequence Master Data Technical Details For more information, see:

2 Product ● SAP ERP Description: Material

http://help.sap.com/car <your
● DRFOUT Outbound Implementation:
release> Application Help Demand
PMAT
Data Foundation Integration Information
● DDF Inbound Interface: /DMF/
MDIF_PRODUCT_INBOUND Inbound Interfaces For Remote Function

Call (RFC) Communication Product

Master Data

3 Location ● SAP ERP Description: Plant

http://help.sap.com/car <your
● DRFOUT Outbound Implementation:
release> Application Help Demand
PPLT
Data Foundation Integration Information
● DDF Inbound Interface: /DMF/
MDIF_LOCATION_INBOUND Inbound Interfaces For Remote Function

Call (RFC) Communication Product

Location Master Data

4 Product Location ● SAP ERP Description: Material/Plant

http://help.sap.com/car <your
● DRFOUT Outbound Implementation:
release> Application Help Demand
PMPL
Data Foundation Integration Information
● DDF Inbound Interface: /DMF/
MDIF_PROD_LOC_INBOUND Inbound Interfaces For Remote Function

Call (RFC) Communication Product

Location Master Data

5 Product Location ● SAP ERP Description: Sales Price

http://help.sap.com/car Application
● DRFOUT Outbound Implementation:
Help Demand Data Foundation
PSPR
Integration Information Inbound
● DDF Inbound Interface: /DMF/
Interfaces For Remote Function Call (RFC)
MDIF_PROD_LOC_INBOUND
Communication Product Location

Master Data

6 Inventory ● SAP ERP Description: Inventory

http://help.sap.com/car <your
● DRFOUT Outbound Implementation:
release> Application Help Demand
PINV
Data Foundation Integration Information
● DDF Inbound Interface: /DMF/
OPIF_INVENTORY_INBOUND Inbound Interfaces For Remote Function

Call (RFC) Communication Inventory

Master Data

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
270 PUBLIC Set Up the Applications
 Sequence Master Data Technical Details For more information, see:

7 Transportation ● SAP ERP Description: Source of Sup­

http://help.sap.com/car <your
Lane ply
release> Application Help Demand
● DRFOUT Outbound Implementation:
PSOS Data Foundation Integration Information

● DDF Inbound Interface: /DMF/ Inbound Interfaces For Remote Function

MDIF_LANE_INBOUND Call (RFC) Communication

Transportation Lane Master Data

 Note
Before transferring the planned deliv­
ery time to DDF, implement a BAdI to
update the planned delivery time val­
ues as described in SAP Note 2357255
).

8 Location ● SAP ERP Description: Vendor

http://help.sap.com/car <your
● DRFOUT Outbound Implementation:
release> Application Help Demand
PVEN
Data Foundation Integration Information
● DDF Inbound Interface: /DMF/
MDIF_LOCATION_INBOUND Inbound Interfaces For Remote Function

Call (RFC) Communication Location

Master Data

9 Product Hierarchy ● SAP ERP Description: Article Hierar­

http://help.sap.com/car Application
chy
Help Demand Data Foundation
● DRFOUT Outbound Implementation:
PAHY Integration Information Inbound
Interfaces For Remote Function Call (RFC)
● DDF Inbound Interface: /DMF/
MDIF_PROD_HIER_INBOUND Communication Product Hierarchy

Master Data

10 Offer ● SAP ERP Description: Offer

http://help.sap.com/car Application
● DRFOUT Outbound Implementation:
Help Demand Data Foundation
POFF
Integration Information Inbound
● DDF Inbound Interface: /DMF/
Interfaces For Remote Function Call (RFC)
OPIF_OFFER_INBOUND
Communication Offer Master Data

You can import the data into staging tables, and then transfer this data to production tables using report /DMF/
PROCESS_STAGING_TABLES. Alternatively, you can skip the staging tables and import the data directly into
the production tables. For more information, see:

● http://help.sap.com/car <your release> Application Help Demand Data Foundation Integration

Information Inbound Processing
● http://help.sap.com/car <your release> Application Help Demand Data Foundation General
Services Monitor Imports Process Inbound Staging Tables

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 271
More Information

For more information on monitoring the replication, see:

● http://help.sap.com/car <your release> Application Help Demand Data Foundation General

Services Monitor Imports
● The Periodic Tasks section of the Administration Guide for SAP Allocation Management.

Related Information

Periodic Tasks

6.5.6.2 Delta Load of Data to DDF Using DRFOUT

When performing a delta load of data from the source master data system using the DRFOUT framework, you
must ensure that the product location data required to enhance the sales records with historical sales cost is
loaded prior to the sales data.

Furthermore, we recommend that you schedule a daily periodic task to replicate data from the source system
to the SAP Allocation Management system.

6.5.7 Configure Front End

Check if you have performed the SAP Gateway configuration and that you have activated the OData Services
for distribution curve and SAP Allocation Management.

Activate SAP Allocation Management ICF Services [page 273]

Perform these steps to activate Internet Communication Framework (ICF) services for SAP Allocation
Management.

Assign Roles, Catalogs, and Groups in SAP Fiori Launchpad [page 273]
To be able to access SAP Fiori apps that constitute the SAP Allocation Management user interface from
the SAP Fiori launchpad, your front-end system user must have the necessary roles assigned. Based on
the roles assigned to your user, you can access certain business catalogs and business catalog groups.

Related Information

Configure SAP Gateway [page 95]

Activate OData Services [page 97]

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
272 PUBLIC Set Up the Applications
6.5.7.1 Activate SAP Allocation Management ICF Services

Perform these steps to activate Internet Communication Framework (ICF) services for SAP Allocation
Management.

For security reasons, all Internet Communication Framework (ICF) services relevant to your SAP Allocation
Management application are made available in an inactive state.

You have activated the central ICF services while configuring the SAP Gateway. This procedure provides the
instructions to activate ICF services required for the SAP Allocation Management SAP Fiori apps.

Procedure

1. Log on to your front-end server.

2. Open service maintenance (transaction SICF).
3. In the Maintain Service screen, select the Location Clustering service by specifying the following:
○ Hierarchy Type: SERVICE
○ Virtual Host: DEFAULT_HOST
○ Service Path: /sap/bc/ui5_ui5/sap/amr_alloplan/
4. Choose Execute.
5. To activate the service, choose Service/host Activate.
6. Repeat steps 3–5 to ensure that all of the following services are activated:
○ /sap/bc/ui5_ui5/sap/amr_alloplan
○ /sap/bc/ui5_ui5/sap/amr_allo_params
○ /sap/bc/ui5_ui5/sap/amr_dist_config
○ /sap/bc/ui5_ui5/sap/amr_lib_reuse
○ /sap/bc/ui5_ui5/sap/amr_marketunit
○ /sap/bc/ui5_ui5/sap/amr_workload
○ /sap/bc/ui5_ui5/sap/amr_kpiconfig
○ /sap/bc/ui5_ui5/sap/amr_result
○ /sap/bc/ui5_ui5/sap/amr_capacity

6.5.7.2 Assign Roles, Catalogs, and Groups in SAP Fiori

Launchpad

To be able to access SAP Fiori apps that constitute the SAP Allocation Management user interface from the
SAP Fiori launchpad, your front-end system user must have the necessary roles assigned. Based on the roles
assigned to your user, you can access certain business catalogs and business catalog groups.

Your SAP Allocation Management application is delivered with a predefined role, catalog, and group. These
include technical content as well as business content:

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 273
Front-End Server Business Content Front-End Technical Content

Technical
Business Role Business Catalog Business Catalog Group Technical Role Catalog

SAP_AMR_BCR_ SAP_AMR_BC_ALLOCA SAP_AMR_BCG_ALLOCATOR _T SAP_AMR_TCR_ T SAP_AMR_

ALLOCATOR_T TOR_T TC _T

To test the installation of SAP Allocation Management from the SAP Fiori launchpad, you need to assign the
roles to your user on the front-end system.

Procedure

1. Log on to your front-end system.

2. Launch User Maintenance (transaction SU01).
3. Enter your user name in the User field and choose Change.
4. On the Roles tab, assign the roles SAP_AMR_BCR_ALLOCATOR_T and SAP_AMR_TCR_ T to your user.

 Caution

If you already have an SAP Fiori launchpad open, you must clear your browser cache to apply any
modifications made to your user roles. Otherwise, your changes are not reflected in the SAP Fiori user
interface.

More Information

Security Information section of the Administration Guide for SAP Allocation Management.

6.6 Configure Access to Documentation Provided on SAP

Help Portal (Optional for All Applications)

In transaction SR13, you can configure your back-end system to point to documentation for your application
that is provided on SAP Help Portal for SAP Customer Activity Repository applications bundle.

Context

You can configure your back-end system to access documentation that is provided on SAP Help Portal for SAP
Customer Activity Repository applications bundle at https://help.sap.com/viewer/p/CARAB. For example, if

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
274 PUBLIC Set Up the Applications
your application is SAP Customer Activity Repository, you can configure access to the application help for SAP
Customer Activity Repository.

Prerequisites

● The documentation you want to access must be available on SAP Help Portal.
● The users who access the documentation must have access to the Internet.
● You can configure an ABAP system to connect to only one combination of product and version. These are
the values that you will specify under Path in the procedure below.

 Note

The product CARAB is valid for all the applications delivered with SAP Customer Activity Repository
applications bundle.

The version depends on the release. For example, version CARAB/4.0.2 is valid for all the application
versions delivered with SAP Customer Activity Repository applications bundle 4.0 FPS02.

If you cannot fulfill one or more of these prerequisites, you must install the documentation in your local system
landscape using the download packages or DVDs/CDs provided.

 Note

For more information about installing the documentation in your local system landscape, see the SAP
Library Installation and Update Guide for SAP NetWeaver-Based Systems.

Procedure

1. Open transaction SR13.

2. Select the tab PlainHtmlHttp.
3. Choose New Entries.

 Caution

You have to create entries for both documentation and XML documentation areas for each platform
you are using and each language in which you want to provide documentation.

You must use the exact combination of uppercase and lowercase characters specified in the product
and version.

4. To create entries for the documentation area, enter the following values:

Name Value to be entered

Variant Enter a name for the variant.

Platform Select the platform relevant for your implementation from

the list of available platforms, for example, WN32.

Area Select Documentation from the list; this will display as

IWBHELP in the table.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Set Up the Applications PUBLIC 275
 Name Value to be entered

Server Names https://help.sap.com/http.svc/ahp2

Path (<Product/Version>) CARAB/4.0.2

Language Select the language you need from the list.

5. To create entries for the XML documentation area, enter the following values:

Name Value to be entered

Variant Enter a name for the variant (any name).

Platform Select the platform relevant for your implementation from

the list of available platforms, for example, WN32.

Area Select XML Documentation from the list; this will display
as XML_DOCU in the table.

Server Names https://help.sap.com/http.svc/ahp2

Path (<Product/Version>) CARAB/4.0.2

Language Select the language you need from the list.

6. Repeat steps 4 and 5 for each relevant platform and language.

7. Select one entry as the default language for each platform and area.
8. Save your entries.

Results

You have configured your back-end system to point to documentation that is provided on SAP Help Portal.

Related Information

SAP Note 2149786 Customizing help settings in transaction SR13

SAP Note 2652009 Connecting the help to the SAP Help Portal
SAP Note 2572047 SAP provides user assistance (documentation) as HTML, PDF, or directly via SAP Help
Portal

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
276 PUBLIC Set Up the Applications
Important Disclaimers and Legal Information

Hyperlinks
Some links are classified by an icon and/or a mouseover text. These links provide additional information.
About the icons:

● Links with the icon : You are entering a Web site that is not hosted by SAP. By using such links, you agree (unless expressly stated otherwise in your
agreements with SAP) to this:

● The content of the linked-to site is not SAP documentation. You may not infer any product claims against SAP based on this information.
● SAP does not agree or disagree with the content on the linked-to site, nor does SAP warrant the availability and correctness. SAP shall not be liable for any
damages caused by the use of such content unless damages have been caused by SAP's gross negligence or willful misconduct.

● Links with the icon : You are leaving the documentation for that particular SAP product or service and are entering a SAP-hosted Web site. By using such
links, you agree that (unless expressly stated otherwise in your agreements with SAP) you may not infer any product claims against SAP based on this
information.

Beta and Other Experimental Features

Experimental features are not part of the officially delivered scope that SAP guarantees for future releases. This means that experimental features may be changed by
SAP at any time for any reason without notice. Experimental features are not for productive use. You may not demonstrate, test, examine, evaluate or otherwise use
the experimental features in a live operating environment or with data that has not been sufficiently backed up.
The purpose of experimental features is to get feedback early on, allowing customers and partners to influence the future product accordingly. By providing your
feedback (e.g. in the SAP Community), you accept that intellectual property rights of the contributions or derivative works shall remain the exclusive property of SAP.

Example Code
Any software coding and/or code snippets are examples. They are not for productive use. The example code is only intended to better explain and visualize the syntax
and phrasing rules. SAP does not warrant the correctness and completeness of the example code. SAP shall not be liable for errors or damages caused by the use of
example code unless damages have been caused by SAP's gross negligence or willful misconduct.

Gender-Related Language
We try not to use gender-specific word forms and formulations. As appropriate for context and readability, SAP may use masculine word forms to refer to all genders.

Common Installation Guide for SAP Customer Activity Repository applications bundle 4.0
FPS02
Important Disclaimers and Legal Information PUBLIC 277
www.sap.com/contactsap

© 2019 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. The information contained herein may be changed
without prior notice.

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 or its affiliated companies shall not be liable for errors or
omissions with respect to the materials. The only warranties for SAP 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.

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. All
other product and service names mentioned are the trademarks of their
respective companies.

Please see https://www.sap.com/about/legal/trademark.html for

additional trademark information and notices.

THE BEST RUN