(Standard configuration) Consolidation, version for SAP BW ...

PUBLICSAP Business Planning and Consolidation, version for SAP BW/4HANADocument Version: 11.1 SPS00 – 2019-05-20

Application Help - SAP Business Planning and Consolidation, version for SAP BW/4HANA (Standard configuration)

© 2

021 S

AP S

E or

an

SAP affi

liate

com

pany

. All r

ight

s re

serv

ed.

THE BEST RUN

Content

1 Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

2 Getting Started. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82.1 Preferences. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82.2 Change Company Logo. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92.3 Grid. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .92.4 Favorites. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92.5 Home Page and Navigation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

3 Business Process Flows. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123.1 My Activities. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

4 Creating Worksheets. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .154.1 Create Reports in a Worksheet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .16

Components of Reports. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17Member Selector. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19Disaggregation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .19Work Status. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20Comments. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21Context. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

4.2 Create Charts in a Worksheet. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .25

5 Process Monitor. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

6 Library. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

7 Documents. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .29

8 Run Consolidation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .318.1 Consolidation Monitor. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

Run a Currency Translation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .34Run a Consolidation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35Working with Periodic Consolidations and Currency Translations. . . . . . . . . . . . . . . . . . . . . . . . 36

8.2 Controls Monitor. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .37Execute a Control Set. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .39Control Set Status. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

8.3 Journals. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43Journal Entries. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46Journal Entry Form. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

2 PUBLIC


Content

Journal Postings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49Journal Groups. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50Journal Queries. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51Reopen Journal Entries. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52Print Journal Reports. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53

8.4 Ownership Manager. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54Create Ownership-based Hierarchies. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .55Ownership-based Hierarchy Requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .59

9 System Reports. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 629.1 Reporting on Business Process Flows. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 639.2 Reporting on Data Changes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 639.3 Reporting on Work Status. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 659.4 Reporting on Comments. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 669.5 Reporting on Administration Activity. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .679.6 Reporting on Security Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71

10 Administration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7310.1 Environment Management. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .74

New Environments. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .75EnvironmentShell Sample Environment. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76Environment Status. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79

10.2 Dimension Management. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79New Dimensions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81Dimension Types. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82Dimension Security. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84Dimension Processing. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85Dimension Member Management. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85Assignment of Dimensions to Models. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86Custom Measure Formulas. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .86Dimension Properties. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88

10.3 Model Management. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .105Reporting Models. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .108Drivers and Rates Models. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109Large Key Figure Usage. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110

10.4 Consolidation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112Create an Environment. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113Dimension Setup in Dimension Library. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114Create or Modify Dimension Properties. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117Create or Modify the Model. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125Business Rule Setting. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127Execute Consolidation Task. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128

Application Help - SAP Business Planning and Consolidation, version for SAP BW/4HANA (Standard configuration)Content PUBLIC 3

Loading Data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131Journal Definition and Validation Setting. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131

10.5 Rules. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133Member Formulas. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134Script Logic. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140US Eliminations as Script Logic. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188Carry-Forward as Script Logic. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189Intercompany Booking as Script Logic. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190Currency Conversion as Script Logic. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191Account-based Calculations as Script Logic. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193Business Rules Management. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .194Controls. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215

10.6 Business Process Flow Management. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228Creating New Process Templates. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 230Creating Process Instances. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .243Setup of E-mail Notifications. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .244External Process Integration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246

10.7 Work Status Setup. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248Work Status Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252

10.8 Journal Administration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256Journal Template Creation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256Journal Security. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260Delete All Journal Entries from Model. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261Limits to Dimension Members for Journal Entries. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261Data Modification by Journal Entries Only. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262BAdI for Generating Calculated Amounts When Saving a Journal. . . . . . . . . . . . . . . . . . . . . . . 263

10.9 Context Defaults. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .26610.10 Drill-Through Setup. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26710.11 Document Types and Subtypes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26910.12 Auditing. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .269

Data Auditing. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270Activity Auditing. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271

10.13 Time-Dependent Hierarchies. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271Enabling Time-Dependent Hierarchy Functionality. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273

10.14 Parallel Execution. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274Enabling Parallel Execution. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274

10.15 Supported BAdIs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .27510.16 Security. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278

User Management. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278Integration into Single Sign-On. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279Setting Up Users. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 280

4 PUBLIC


Content

Setting Up Teams. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 281Task Profile Setup. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 282Data Access Profile Setup. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .289

Application Help - SAP Business Planning and Consolidation, version for SAP BW/4HANA (Standard configuration)Content PUBLIC 5

1 Overview

Application help for SAP Business Planning and Consolidation, version for SAP BW/4HANA, in a standard configuration.

Product Information

SAP Business Planning and Consolidation provides everything you need to meet your bottom-up and top-down financial and operational planning requirements through a single application and user interface.

SAP Business Planning and Consolidation 11.1, version for SAP BW/4HANA is a new product based on SAP BW/4HANA. The product supports the HANA database and uses SAPUI5 user interface technology. The SAP UI5 user interface is based on standard HTML5, which provides all the benefits of HTML5 and supports languages such as Hebrew and Arabic that are written and read from right to left. BW/4HANA is a new, next-generation data warehouse product that is optimized for the SAP HANA platform, delivering real-time, enterprise-wide analytics that minimizes the movement of data and connecting all the data in an organization into a single logical view.

Administrators can configure the installation of SAP Business Planning and Consolidation in one of two ways:

● In an embedded configuration, Business Planning and Consolidation is integrated with SAP HANA-optimized processing, through which you can perform SAP HANA-optimized planning. For details about SAP HANA-optimized processing and the BW planning processor, refer to .

● In a standard configuration, you can use all the functionality that is available in the standard configuration of SAP Business Planning and Consolidation, version for SAP NetWeaver.

NoteInformation within a single topic that differs between the configuration types is clearly explained within the relevant content.

Integration

HTML5-based web client

The HTML5-based web client offers an integrated view for both business users and administrative users.

SAP BusinessObjects Analysis, Edition for Microsoft Office

There is a separate installation for business users who are power users - the SAP BusinessObjects Analysis, Edition for Microsoft Office. For more information, see the SAP BusinessObjects Analysis, Edition for Microsoft Office help available on the SAP Help Portal.

6 PUBLIC


Overview

http://help.sap.com/viewer/p/SAP_BUSINESSOBJECTS_ANALYSIS_OFFICE

SAP Analytics CloudSAP Analytics Cloud is an all-in-one analytics platform for organizational planning, predictive analytics, and visualized business intelligence. Now the data integration between SAP Analytics Cloud and SAP BPC has been enhanced: models of periodic storage type can be consumed by SAP Analytics Cloud in write-back mode with significantly enhanced performance.

RecommendationWe recommend that you keep the SAP Analytics Cloud model based on BPC as small as possible by filtering in the mapping screen and synchronize frequently with your BPC data source. If you want to import BPC delta data into SAP Analytics Cloud all at once, we recommend that you keep the data volume to less than 1.5 GB and the number of records to less than 450,000.

Features

Security

The Security Guide provides thorough security-relevant information for this release of Business Planning and Consolidation. The guide is available on the SAP Help Portal.

Starting the Web Client

To start the Planning and Consolidation Web Client, do the following:

Open a browser and connect to the URL http://<PC_server:port>/sap/epm/bpc/web/, where <PC_server:port> is the server name or IP address and port number of the Business Planning and Consolidation application location.

To log on directly to a specific environment, enter http://<PC_server:port>/sap/epm/bpc/web/#<environment type>/<environment ID>, where <environment type> is classic for Business Planning and Consolidation environments in a standard configuration.

NoteLogging on directly to an environment works only when the authentication is done automatically. For example, the direct log on works when you have a logon ticket that was issued during a previous log on.

Application Help - SAP Business Planning and Consolidation, version for SAP BW/4HANA (Standard configuration)Overview PUBLIC 7

https://help.sap.com/viewer/p/SAP_BPC_VERSION_BW4HANA

2 Getting Started

The following features are available to help you get started using SAP Business Planning and Consolidation:

● You can change the user preferences to customize the display of your UI. See Preferences [page 8].● You can replace the SAP logo with your company logo, See Change Company Logo [page 9].● You can change the way data displays in table format on various pages within the application. See Grid

[page 9].● You can customize your own home page and navigation to different functions through the main navigation

panel. See Home Page and Navigation [page 10].

2.1 Preferences

You can change user preferences to customize the display of your user interface. You can make changes to the language, date format, and others settings.

You can change the following settings:

My Preferences

Feature Description

Theme The theme that you want to use for the application UI

Language The language in which you want the UI texts to appear

Time The time zone that you want to use in the application

Date Format The format in which the date appears

Number Format The format in which the numbers appear

Name Format The format in which the logged in user's name appears

You can also upload a photo to customize your profile.

Activities

To view and edit user preferences, in the upper right part of the screen, click your user name and choose Preferences.

● To change the settings, choose Save.● To restore the original settings, choose Restore Default.

NoteYour changes will take effect upon your next logon. If you want to apply the changes immediately, you must restart the application.

8 PUBLIC


Getting Started

2.2 Change Company Logo

You can replace the SAP logo in the upper left corner of Business Planng and Consolidation with your company logo.

To replace the SAP logo with your company logo, follow these steps:

1. Enter transaction code se38.2. Execute program RSBPC_CUSTOM_LOGO.3. In the company logo field, upload the picture of your company’s logo. The default SAP logo is 50*26. We

recommend you use a png file and limit the image size to 32*32.4. In the product name field, enter the name of your company.

To directly change your company logo back to the default SAP logo, follow these steps:

1. Enter transaction code se38 and execute program RSBPC_CUSTOM_LOGO2. Select the option Clear Values and choose Execute.

2.3 Grid

A grid is a table that displays data and allows you to alter the display of that data.

● Where available, you can filter the data displayed in a table. Click the column header tab and then in the drop down list enter a value in the Filter field.By entering a specific value, you can narrow the data displayed to include only the ones with that value.

● Display or hide certain columns using the (View Settings) button in the upper right corner of a table, where available.All columns are displayed by default. To hide a particular column, deselect the checkbox for that column.

● Sort the data in the table according to a particular column by clicking the column header tab.In the drop down list, the data can be sorted in ascending or descending order.

2.4 Favorites

You can add any important pages you want to bookmark to Favorites.

To reserve a page as favorites, click the button to the upper right corner of corresponding page and name it as you wish. Then the pages marked as favorites are displayed in the Favorites tile in the home page.

If you want to edit these favorite pages, click the Edit Favorites button in the Favorites tile, or go to the

navigation panel by clicking and choose Favorites to enter the Favorite editing page. On this page, you can change the sequence of the pages or remove any pages from the favorite list.

Application Help - SAP Business Planning and Consolidation, version for SAP BW/4HANA (Standard configuration)Getting Started PUBLIC 9

Related Information

Home Page and Navigation [page 10]

2.5 Home Page and Navigation

When you log in to the web client of Business Planning and Consolidation, you can use the main navigation panel on the left side to navigate to the functionality that you want to access.

The main navigation panel is composed of the following categories:

● Home - Displays your favorite pages and snapshots of charts, and reminds you of the activities approaching a deadline. For more information, see the Home Page section below.

● Library (Standard only) - A central place to create worksheets and store and organize planning and consolidation objects (worksheet, Excel worksheets saved from the EPM add-in, and so on) For more information, see Creating Worksheets [page 15].

● My Activities - Displays the activities requiring action by you as the currently logged-on user. For more information, see My Activities [page 13].

● Process Monitor - Displays a complete list of the process instances for you as the process owner of corresponding process templates to monitor. See Process Monitor [page 27].

● Consolidation - Provides information about generating and managing consolidated data to give you an accurate view of the financial situation of your organization. See Run Consolidation [page 31].

● Administration - Enables administrators to perform setup and maintenance tasks for Business Planning and Consolidation. See Administration [page 73].

● System Reports - Provides information about reporting on system information and activity. See System Reports [page 62].

● Documents (Standard only) - Provides information about using the Documents view to post, share, and retrieve files, and to manage the display of content. The Documents view contains documents that users have uploaded manually. See Documents [page 29].

Home Page

You can navigate to home page from the main navigation panel. The home page is composed of the following tiles:

Favorites - provides direct links to specific Business Planning and Consolidation web pages that you bookmarked as favorites.

Timeline - provides the activities requiring action by you as the currently logged-on user in deadline order

Charts (Standard only) - provides a snapshot of charts that you pinned to the home page

10 PUBLIC


Getting Started

Navigation

This release of Business Planning and Consolidation is a single page application. You can jump to a certain page in two ways:

● From the main navigation panel – To jump to a new page, click the icon from the upper left corner and choose a page.

● From the breadcrumb bar – The navigation path in the breadcrumb bar indicates the position of a page in the application. By clicking the Drill Down button, you can jump to other relevant pages at the same level.

To go back to the previous page, we recommend you use the button inside the application other than the back button on your web browser as we make some customized enhancement to the back button inside the application.

Changing the Environment

Click the button from the upper right corner of the screen and your current environment displays. Click on the environment name to change to another environment. For detailed information, refer to Environment Management [page 74].

Context Sensitive Help

You can view help for each feature directly from BPC web client instead of searching it on SAP Help Portal. To

open a context sensitive help, click the button from the upper right corner of each page and choose About This Feature.

Setting Preferences

To set individual preferences, click on your name in the upper right corner of the screen and choose Preferences. For more information, see Preferences [page 8].

Show Access Right (Standard only)

To view your own access right, click on your user name in the upper right corner of the screen and choose Show Access Right. You can also print and export details about your access rights.

Application Help - SAP Business Planning and Consolidation, version for SAP BW/4HANA (Standard configuration)Getting Started PUBLIC 11

3 Business Process Flows

Business process flows (BPFs) guide you through a sequence of tasks within a defined business process.

Depending on your role, the activities available to you can involve completing actions as an activity performer or reviewing actions submitted by other users as an activity reviewer.

Features

A process instance, or simply a process, is an iteration of a process template that is in active use. For example, an authorized administrative user creates a process template called “Monthly Reporting” to coordinate the monthly reporting activities of various personnel. Then that user or another authorized user can create a process for a specific period such as November 2009 based on the “Monthly Reporting” template.

As a business user, you can utilize the following features related to business processes:

● ActivitiesActivities list the processes that you as the currently logged on user can access to perform or review actions.For more information, see My Activities [page 13].

● Process MonitorProcess monitor displays a complete list of the processes that you as the process owner of corresponding process templates can access. If meanwhile you are the owner of the process instances, you can also finalize them once they have been completed.For more information, see Process Monitor [page 27].

● E-mail notificationsThe system automatically generates e-mail notifications to the people who are involved in a process or activity to keep them informed of its progress and of tasks that need to be performed. The e-mail notifications automatically sent to users contain a link to bring them directly to the activity or process monitor, or to navigate to external applications to perform further actions.E-mail notifications occur in the following situations:○ Process monitors are the users who can monitor all the instances created from a process template.

Process monitors receive an e-mail notification when a new process instance is:○ Created○ Suspended○ Resumed○ Reset○ Ready to be finalized

○ The owner of an activity receives an e-mail notification when the activity is:○ Opened to be performed○ Approved or rejected by a reviewer○ Reopened○ When a deadline is changed

○ The responsible reviewer of an activity receives an e-mail notification when an activity is ready for review or when a deadline is changed.

12 PUBLIC

Application Help - SAP Business Planning and Consolidation, version for SAP BW/4HANA (Standard configuration)Business Process Flows

For information on how system administrators configure e-mail notifications, see Setup of E-mail Notifications [page 244].

3.1 My Activities

My Activities displays the activities requiring action by you as the currently logged-on user. The actions might include performing activities assigned to you or reviewing activities submitted by others.

Features

By clicking an activity, you can open the associated activity workspace to perform or review your activity. The activity workspace contains hyperlinks to begin executing your tasks.

Before any action is taken, activities can have the following statuses:

● Open-To perform: The new activity is waiting for completion or to be submitted.● Pending: The activity is waiting for another activity to be completed. You cannot take any action on a

pending activity.

Activities that need to be reviewed after submission can have the following statuses:

● Submitted: Action has been taken and the activity is waiting for review.● Rejected: A reviewer has rejected the activity and the activity is open again to be performed.● Completed: The activity is approved and fully completed.

If no review action is required, a performer can directly change the status to Completed after taking all the required actions.

An activity can be reopened for performing actions once again after it has been completed. Activities that are reopened can have the following statuses:

● Reopened: The completed activity has been reopened.● Delayed: Completion of the activity has been delayed due to the previous activity being reopened. It is not

possible to take any action on a delayed activity.

The performer of an activity is the person responsible for completing the activity. A reviewer is the person who must verify the actions taken by a performer in a particular activity context. Performers and reviewers can be one or more users or a team. For multiple users to be involved in the completion of an activity simultaneously, two or more users can concurrently work at the same activity.

Activities

The left side of the My Activities view displays all the processes whose activities require your action. The activities you see are those for which you are a performer or a reviewer.

Application Help - SAP Business Planning and Consolidation, version for SAP BW/4HANA (Standard configuration)Business Process Flows PUBLIC 13

In the upper portion of the panel, you can choose to display finalized or active processes, or display processes by ID, description, or both. The search box in the upper right corner supports cross-column searching, which means anything in the page that matches your input will be displayed and highlighted.

Using (View Settings), you can choose the columns to display for all activities, as well as sort and group activities on your own, which enables you to manage activities in a more organized way.

Numbers such as in each process show the total number of open activities that require you as the current reviewer or performer to take actions in this process. Click See more to view the detailed activity numbers for each status.

Performing or Reviewing Activities

Choose a process and the Details window displays all the activities of that process requiring your action. Then, if you the assigned performer of an activity, you can click the activity names to open the activity workspace where you perform any required tasks. When you have completed the required actions, choose Complete in the activity workspace. The status in the My Activities view automatically updates; if any further reviews are required, the status will change to Submitted. Otherwise, the activity status will be directly changed to Completed.

You can enter and review comments when changing the status of a BPF activity.

If you are the assigned reviewer of an activity, you can approve or reject the activity. Approve changes the status of the activity to Completed. Reject changes the status of the activity to Rejected and the responsible user may resubmit the activity for approval.

Reopening Activities

You can reopen a completed activity or specific activities for which reopening criteria have been met. For more information, see Criteria for Reopening Activities [page 238]. If you are a process instance owner, you can reopen activities of the processes you own without any limitations. To reopen an activity, go to the process instance and click See more. Then choose the Reopen button to select activities.

Work Status Integration

Work status is a very commonly used feature within Business Planning and Consolidation for planning process control. The state of work status can be automatically changed with the changing of BPF activity status if the integration of work status with BPF has been set up by an administrator. For example, if the administrator defined for a certain data region that when the activity is completed the work state of this region will be automatically changed to Locked, then once you as the activity performer submits a region of planning data in an activity and changes the status of the activity to Complete, the pertinent data region by work status is automatically locked.

14 PUBLIC

Application Help - SAP Business Planning and Consolidation, version for SAP BW/4HANA (Standard configuration)Business Process Flows

4 Creating Worksheets

A worksheet is a grouping of, or a display of, reports and charts that provides a comprehensive overview of critical information.

Prerequisites

● To create or edit a worksheet, users need to be assigned the Edit Worksheet task profile. Meanwhile, if they have the Edit Content of Public Folder task profile assigned to them, they can delete worksheets in the Library.

● To allow users to create, edit, and modify input-ready reports and control data submissions from web reports, users need to be assigned the Use Input Forms and Save Data task profile.

NoteUsers can always open and view any worksheet.

Features

Added content, including reports and charts, is defined as tiles of the worksheet. You can move, resize, and maximize tiles. By choosing the Edit button of each tile, you can hide either the menu bar or the scope context bar of a tile. In the reports created in a worksheet, you can add comments, set drill-through, change work status, and display by report or chart.

Every worksheet contains a global context bar at the top of the page, from which you can change the model and dimension members. This global context bar defines the default value of the context bars of all the report tiles or chart tiles sharing the same model in a worksheet. However, if you choose a different member for a dimension in the context bar of a certain report tile or chart tile, this change overwrites the default value inherited from the global context.

Related Information

Create Reports in a Worksheet [page 16]Create Charts in a Worksheet [page 25]Library [page 28]

Application Help - SAP Business Planning and Consolidation, version for SAP BW/4HANA (Standard configuration)Creating Worksheets PUBLIC 15

4.1 Create Reports in a Worksheet

Use this function to create read-only reports and input-ready reports in a worksheet.

Procedure

1. Go to Library from the navigation panel.2. From the New toolbar, choose Worksheet.

3. In the newly created worksheet, click the (More Options) icon in the global context bar to specify the dimensions to display.

4. Click the + New Report icon to create a report. If you want to create a report to input data, choose Input-ready Report. If you just want to display data, choose Read-only Report.

5. In the Define Data Grid dialog, choose the dimensions that you want to include by dragging them to the required area - Rows or Columns.

6. To select the members to include in the report, click the name of the required dimension. The member selector appears.

7. Select the checkbox for each member to include in the report or click to include all children, descendants, and base members of a parent member in the selection, then choose OK.

8. Choose Save.9. After creating an input-ready report, you can input data into the report tile and save it in the worksheet.

NoteBy default, when saving the data, all the other report tiles in the worksheet are automatically checked and refreshed. If you do not want to refresh other report tiles, click the Refresh button of those tiles and uncheck Auto Refresh.

10. After adding reports, you can save the worksheet to any one of the folders in the Library. Give it a name and description, then choose OK.

Additional Functions

You can export a report to a comma-separated values (CSV) file. After that you can open the file with Microsoft Excel, perform data analysis, format the report, print it with Excel, or copy the changed data back from Excel to a input-ready report.

In a report, you can suppress empty rows and the rows whose values are zero so that the report is more usable and easier to read. To do this, choose Display from the menu bar. In the submenu that appears, select one of the following options:

● Keep All - When selected, all rows are shown.● Suppress Empty Rows - When selected, empty rows are not shown. Rows that have values in them are

shown, even if they have zero values.

16 PUBLIC


Creating Worksheets

● Suppress Empty and Zero Rows - When selected, all empty rows and rows with zero values are hidden.

Related Information

Home Page and Navigation [page 10]Components of Reports [page 17]Member Selector [page 19]Disaggregation [page 19]Work Status [page 20]Comments [page 21]Context [page 23]Create Charts in a Worksheet [page 25]

4.1.1 Components of Reports

You can add several types of components when creating a report.

The following table lists the components that you can add to a report and how you can manipulate these components:

Component Actions

Dimensions Choose to edit the report. The available dimensions appear.

Drag a dimension to the Row Axis area or the Column Axis area.

You can nest dimensions by placing additional dimensions in the column or row.

You can remove a dimension from a column or row by clicking the X beside that dimension.


Component Actions

Members You can select the members you want to use in the report.

Select a dimension in the Column Axis or Row Axis area and click Select Members to choose the members to use for that dimension. Use the member selector to define the set of members to display for the dimension.

You can select members by choosing the following options:

● Single Member - You can choose one member of the current context.● Fixed List - You can choose more than one member.● Select Children - You can choose the children of the current context.● Select Children and Me - You can choose both the children and the parent member.● Select Descendants - You can choose descendants of the current context. Select the levels to be in

cluded using the Number of Levels Down and Do not include intermediate levels options.● Select Descendants and Me - You can choose both the descendants and the parent member. Select

the levels to be included using the Number of Levels Down and Do not include intermediate levels options.

● Select Base Members - You can choose the base members of the current context.● Select Base Members and me - You can choose both the base members and the parent member.

You can exclude members from the selected member list in the following ways:

● Exclude a single member - If you exclude a base member, you exclude that member from the selected member list.

● Exclude descendants and me - If you exclude a parent member, you exclude that parent member and all of its descendants.

If you do not specify any members, the current context is used.

Charts You can export a chart from a report or input form. See Create Charts in a Worksheet [page 25].

Work Status You can set the work status on data that you enter and save. See Work Status [page 20].

Comments You can add comments to any selected cell. You can also enter a comment for a specific context, in which case the comment also appears in all other reports containing the same context.

You can view and report on comments including the commenting thread that shows the history of a comment. See Comments [page 21].

You can cut, copy, or paste data both from and to Microsoft Excel. You can also export a complete report to Excel.

You can determine the appearance of reports by setting the following formatting options:

● The scaling factor● The number of decimals to display after the separator● The placement of totals

18 PUBLIC


Creating Worksheets

Related Information

Member Selector [page 19]

4.1.2 Member Selector

The member selector is a dialog box in which you select or exclude members that belong to a dimension hierarchy. By selecting members in the member selector for a specific dimension, you can restrict the display of data, for example, in a report table.

To access the member selector, click on the name of a dimension shown in a report.

Function Navigation

To select one or more dimension members Select the checkbox next to the specific dimension members.

To select children or descendants of a dimension memberIn the menu for a dimension member in the member selector, choose Select Children or Select Descendants.

To exclude members from selected members listIn the menu for a dimension member, choose Exclude descendants and me, then both the member and all its descendants will be removed from the selected members list.

To search for membersChoose and enter the name or ID of the member. When searching by ID, make sure you choose either ID or ID and Description in the Display Column.

To display dimension members in a hierarchy or list format Choose Display and select either Hierarchy or List.

Example

You have the Calendar Year dimension added in a report. You can filter the dimension members that are displayed in the report table using the member selector. Selecting only 2009 and 2010 restricts the display of data in the report to information relevant for these dimension members.

4.1.3 Disaggregation

Disaggregation distributes target values to base levels.

When you want to use top-down planning you can enter a target value in a parent node and the system will perform disaggregation.


ExampleYou enter a sales target for the EMEA region and then use the disaggregation function to disaggregate that value to the base levels.

The following disaggregation rules are available:

● Self-reference distribution: Data is disaggregated according to the ratio of the existing base level values.● Base level equally distribution: Data is disaggregated to all base levels evenly.● Reference-based: Data is disaggregated according to the ratio of the base level values in a selected

equivalent member range. For example, if you use the Time dimension, you must specify which time period to reference.

4.1.4 Work Status

You can change a work status setting on a data region to which you have access. Then all users will adapt to the data entry permissions defined in the new work status. This is typically done after saving data to the database from an input-ready report.

Prerequisites

● Work status is enabled on the active model.● You have the authority to change the work status for the data region.● You can change a work status setting on a data region to which an administrator has defined at least one

work state.

Features

If you have the appropriate authority, you can change the work status from one authorized status to another. You can use the work status to control whether it is possible to enter or modify data in the data region.

When you change the work status setting of a region, the following events occur and rules apply:

● If that region has no work status record, the Change Work Status button does not display in the tool bar.● If work status = 0 (no locks) is set to a higher work status, it is possible to return to work status = 0 if all the

other rules have been passed.● If the region has a default work status, the current state shows the name of the work state.● You can progress only from a lower state to the next higher state, or from a higher state to the next lower

state. You cannot skip any work state while changing work status.

20 PUBLIC


Creating Worksheets

Activities

To change a work status in a report, follow these steps:

1. In a report, select Change Work Status.2. In the Change Work Status dialog box, select one or more members for the owner dimension and other

dimensions to define the exact data range for which you want to change work status.3. Select On All Descendants to apply the work status change to all the descendants of the selected

members, if needed.4. In the New Status field, select the desired setting from the drop-down list and choose OK.

More Information

Creating Worksheets [page 15]

Reporting on Work Status [page 65]

Work Status Setup [page 248]

4.1.5 Comments

Comments provide a vehicle for submitting, storing, and retrieving text commentary associated with report data cells. This allows you to annotate data so other users can view supporting information associated with a particular piece of data.

Features

You can use comments in the following ways:

● You can add comments to a report.● You can view (manage) all comments in a data region.● You can edit comments.● You can retrieve comments added to a report. Within the report, comments are displayed as tooltips.● You can see a history of the comments for a specific cell in a report.● You can delete a comment.

Adding Comments

You can add comments to a specific cell in a report.

You add a comment in run mode by selecting a cell, then choosing Comments and then Add comment. You enter the comment in the Add Comment dialog box. The default length for a comment is 255 characters.


NoteAdministrators can change the comment length using the environment parameter COMMENT_MAX_LENGTH. The default value is 255 and the maximum length is 1,332 characters.

When adding a comment, you can select More and then specify the following items:

Item Description

Priority Specifies the desired priority level or None. The report shows comments in order of their priority level.

Keywords Specifies keywords to organize and search for comments in the database. This field takes blanks and empty strings.

Modify Context Allows you to select specific members for the context using the Member Selector. See Member Selector [page 19]. You cannot modify the context of a comment using the View History dialog box of a report or an input form.

Viewing Comments

You can view individual comments in a report, as well as all of the comments associated with a report. You view a comment in a selected cell in a report by placing the cursor on a cell to which a comment has been added. The comment, originator and modification date are displayed.

You view all comments in a report by selecting Comments and then Manage comments. The Manage comments workspace is displayed showing details of all comments. The following details are displayed:

Item Description

Comment Displays the entire comment. If you are the originator of the comment or if you have administrator rights, you can modify the value directly in the cell. When you finish modifying the text, choose Update Comment.

Keyword Displays the keyword associated with the comment. If you are the originator of the comment or if you have administrator rights, you can modify the value directly in the field.

Date and Time Displays the date that the comment was saved to the database. If the comment is updated by the originator or an administrator, the updated date appears in this cell. The value in this cell is display only.

User Displays the comment originator's name. The value in this cell is display only.

Priority Displays the priority for the comment. If you are the originator of the comment or if you have administrator rights, you can modify the value directly in the cell by selecting another option from the drop-down list.

Dimension Members Displays the details of the cell of the report to which the comment was added.

Filtering Comments

22 PUBLIC


Creating Worksheets

You can specify filter criteria for displaying the comments in the Manage comments workspace. To set filter criteria, choose Edit Criteria and select the following options:

● Dimension Members - You can select the dimension members for which to display comments.● Modification Date - You can choose start and end dates for the comments, or display the full history of the

selected comments ( Anytime).● Additional Criteria - You can specify a Priority, User ID and Keyword for which to display comments.

Deleting Comments

You can delete a comment associated with a cell. You delete a comment by selecting the cell, then Comments, and then Delete comment. You must click OK to confirm.

NoteAn administrator can delete or remove comments with conditions through the ClearComment package in Data Manager. For more information, see the application help for SAP BusinessObjects Analysis, Edition for Microsoft Office on the SAP Help Portal.

Activities

To work with comments in a report, open the report and select Comments. Choose one of the options as described above.

Related Information

Reporting on Comments [page 66]

4.1.6 Context

You can use a context to filter the content displayed in a report. This allows you to focus on a specific subset of the data.

Prerequisites

● The application is context-enabled; it can receive and respond to context data.● The appropriate permissions have been assigned to be able to work with the dimensions and associated

dimension members.


https://help.sap.com/viewer/p/SAP_BUSINESSOBJECTS_ANALYSIS_OFFICE

Features

The following functions are available:

● Manage Context dropdown menu:It displays details about the current model and provides the option to change the model.Display Dimension Names: You can decide whether to show or hide dimension names to the left of member names in the context bar. You can also use the default settings.

● Add Dimension: To focus the display in a workspace or report on a specific set of data, you add dimensions and select members for those dimensions in the context bar.You can change the dimension member selection. This changes the focus of the content you are viewing.You can add all dimensions to the context bar.

● Locking: The locking of dimensions is automatic in process workspaces. If a dimension is locked, it cannot

be added to or removed from the context bar. It is visible, but grayed out and is displayed.

Activities

For more information about the activities that can be performed related to context, see Managing Context [page 25].

Example

1. You add context to a report with dimension: Calendar Month and member: April by choosing in the context bar and selecting this dimension member.This displays data in the report for the month of April.

2. If you change the dimension member, for example, by selecting March as the calendar month. This changes the context of the report to display data for March.

Related Information

Managing Context [page 25]

24 PUBLIC


Creating Worksheets

4.1.6.1 Managing Context

To manage the context in a report, you can perform the following tasks:

Function Navigation More Information

Change the modelIn the dropdown menu, choose Change Model....

(None)

Open the dimension member selectorIn the context bar, choose and select a dimension from the list.

Dimensions already added to context bar are grayed out

Select a different dimension member Select the dimension member hyperlink.

(None)

Return to the default dimension member

Choose .Whenever a dimension is added to the context bar, a default dimension member is displayed.

Remove a dimension from the context bar

Choose . (None)

Add all dimensions to the context bar In the Add Dimension dropdown list, choose Add All Dimensions.

(None)

Display dimension names next to dimension members in the context bar

In the Manage Context dropdown

menu, choose Display Dimension

Names Display All .

To display only the dimension member descriptions, choose Hide All.

You can also select the default display by choosing Use Default Settings.

Related Information

Context [page 23]

4.2 Create Charts in a Worksheet

You can create a chart from a report or input form, or from a range of data you select in a report or input form. When you change the report in any way, the associated chart is updated.

When creating a chart, you can specify how the chart is displayed.

● You can set the type of chart (Vertical Bar, Horizontal Bar, Stacked Vertical Bar, Stacked Horizontal Bar, Line, and Pie).


● You can select the dimensions and members to display on the group and series axis.● You can choose to display the labels for the group and series axis.● You can apply a filter for the dimensions that are not in the group and series axis.

Related Information

Creating Worksheets [page 15]Create Reports in a Worksheet [page 16]

26 PUBLIC


Creating Worksheets

5 Process Monitor

Use

Process monitor displays a complete list of the process instances that you as the process owner of corresponding process templates can access. In the process monitor, you can see a complete list of processes and display the full set of information available for individual process instances. The process instance owner can finalize a completed process instance.

Prerequisites

Process Monitor does not display by default. To view the process monitor, you must have been assigned access as a process owner during process template creation.

Features

When you open the process monitor, it displays the process name, process context, status (completion progress, number of activities completed, in progress, pending), start date, and owners for each process instance. You can filter the processes choosing Process and All. By choosing Process, you can display processes by process templates. By choosing All, you can choose to display either active processes, which are processes not yet finalized. or finalized processes.

When you click the name of a process from the list, a detailed view is displayed in which you can see the status of activities in the process instance. You can view them using Group By to group by activity, context, status, and action required. You can also filter using Show Activities.

The detailed view shows the performer deadline and reviewer deadline for the activities. In case a planning cycle needs to be adjusted due to special circumstances, a process template owner can change deadlines for uncompleted activities by choosing Change Deadlines. In the detailed view, the process instance owner can also choose to reopen completed activities by choosing Reopen without any limitations.

Only the process instance owner can finalize a completed process instance from the process monitor.

Application Help - SAP Business Planning and Consolidation, version for SAP BW/4HANA (Standard configuration)Process Monitor PUBLIC 27

6 Library

This function enables you to create and display Business Planning and Consolidation worksheets. You can also display Microsoft Excel sheets created in the EPM plug-in.

Features

Folders

The objects in the Library view are sorted by folders. You can select the following folders to see the objects saved to it:

● Favorites - You can add objects to this folder to group to together the objects that you use frequently.● Public - This folder contains content that can be accessed and modified by all users depending on the

permissions in place. It is possible to restrict access to this folder.Users with the task profile Update Company Folders can add and manage the content.

● Private - You can create your personal folder and save content in it, which you do not want to share with other users. The content of this folder cannot be accessed by other users.

● Teams - Each team has its own folder under Teams. The folder name is the team name. Users in the team can access the corresponding team folder. Only a team lead has edit access for the team folder.

You can create new folders under the Teams, Public, and Private folders.

Worksheets

A worksheet is a grouping of, or a display of, reports and charts that provides a comprehensive view of critical information. There are two kinds of reports: read-only reports and input-ready reports. You can create a new chart or export an existing report as a chart. For detailed information, refer to Creating Worksheets [page 15].

Library Book

After you completed a work book in the AO (or EPM Add-in), you can publish the book as a PDF file to the Library.

Activities

To access the Library view, in the home page choose Library.

The search box in the upper right corner supports cross-column searching, which means anything in the page that matches your input will be displayed and highlighted.

For information about analyzing data using the EPM plug-in, which is a plug-in to Microsoft Office Excel and PowerPoint, see the latest version of the application help for SAP BusinessObjects Analysis, edition for Microsoft Office available on the SAP Help Portal.

28 PUBLIC


Library


7 Documents

Use

The Documents view is a central repository for storing or sharing files and websites. You can use the features of the Documents view to post, share, and retrieve files or the contents of a website and to manage the display of content.

Features

Posting Files to the Documents View

You can post files or specify a URL to add to the Documents view by clicking Add Item. You then describe the file or website, set access, and determine whether you want to send a notification e-mail about the posting.

A file can be any file saved to a hard drive or network folder. By default, the system allows you to upload files of the following types, or file extensions: .XLS, XLT, .DOC, .DOT, .PPT, .POT, .XML, .MHT, .MHTML, .XLSX, .XLSM, .XLSB, .ZIP, .PDF, .PPTX, .PPTM, .POTX, .POTM, .DOCX, .DOCM, .DOTX, .DOTM, .CDM, .TDM, .PNG, .GIF, .JPG, .CSS, .MRC.

NoteAdministrators can change the environment parameter DEFAULT_EXTENSIONS to add other file types. For example, files with the extension .TXT are not supported by default. Administrators must add it to the parameter. For more details, see the SAP Business Planning and Consolidation 10.0 IMG Guide.

Administrators should evaluate carefully before enabling file types such as .HTM and .HTML for any user. We recommend that you avoid using these extensions.

Viewing and Managing Content

Posted files and websites display in a list, and are filtered by a user's context, a user's view rights to information, and any manual filters set. You can do the following with the files and websites in the Documents view:

● You can view one item by double-clicking the title of the item. If the item is a website, it opens in a new browser window. If the item is a document, the Save/Open dialog box appears.

● Documents that are associated with data are characterized as having a model context. For example, a Microsoft Word document might be associated with a particular report. If you want to view a report and anything that is associated with that report, select a particular context. The relevant reports and documents are displayed.

● You can sort the list by column or row. Click the appropriate heading.● You can categorize, sort, and filter documents in the Documents list by the following elements:

○ Document type and subtype○ Model context

Application Help - SAP Business Planning and Consolidation, version for SAP BW/4HANA (Standard configuration)Documents PUBLIC 29

○ Access rights○ Date

● You can filter the items in the Documents list to see a subset of the files by clicking Filter.● You can assign a document type and subtype to aid sorting and filtering. Administrators define document

types. Subtypes are defined by users when the document is posted.● You can permanently delete items that you posted to the Documents view by selecting one or more items

and clicking Delete.

Activities

To post or view documents in the Documents view, in the home page choose Documents.

30 PUBLIC


Documents

8 Run Consolidation

The Consolidation module in SAP Business Planning and Consolidation enables you to generate and manage consolidated data, giving you an accurate view of the status of the collected and consolidated data within your organization as well as a unified environment to perform consolidation tasks over the web.

Features

The following Consolidation features are available:

● Consolidation Monitor: generate and monitor consolidated data from data reported by Group and Entity members

● Controls Monitor: execute and monitor controls used to validate the reported data● Journals: create and manage journal entries containing adjustments used for correcting collected and

consolidated data● Ownership Manager: create and manage ownership-based hierarchies used for performing statutory

consolidations

Related Information

Consolidation Monitor [page 31]Controls Monitor [page 37]Journals [page 43]Ownership Manager [page 54]

8.1 Consolidation Monitor

The Consolidation Monitor is a global dashboard for monitoring the consolidation progress for a specific consolidation scope, which is made up of a category, period, group, or sub-group.

The Consolidation Monitor is a key component in executing incremental consolidations, since it communicates to the consolidation engine on which entities to execute a currency translation or consolidation. For more information about setting up your consolidation environment with dimension properties, model settings, and journal definitions, see Consolidation [page 112].

The Consolidation Monitor displays the Group/Entity hierarchy created in the Ownership Manager (only Consolidation type models). For information on configuring an ownership-based hierarchy, see Ownership Manager [page 54].

The scope context area displays the selected dimension members: Time, Category and Group.

Application Help - SAP Business Planning and Consolidation, version for SAP BW/4HANA (Standard configuration)Run Consolidation PUBLIC 31

You can perform a full consolidation, which processes all entities in the ownership-based hierarchy, or you can perform an incremental consolidation, which processes only updated entities. Incremental consolidations reduce the impact on system performance and decrease response time.

Incremental consolidations and currency translations

You perform incremental currency translation or consolidation, or both, in the following cases:

● When an update to an entity is more recent than the last currency translation performed for the group or sub-groups to which the entity belongs, then an incremental currency translation must be performed for the entity.

● When an update to an entity is more recent than the last consolidation performed for the group or sub-groups to which the entity belongs, then an incremental consolidation must be performed for the entity.

● When currency translation is performed for an entity, then an incremental consolidation must also be performed, regardless of when the last consolidation was run.

ExampleA currency translation and a consolidation are performed on the Groups G_WORLD and G_ASIA, at 9:00 a.m. and 9:01 a.m., respectively:

Category Time Groups Currency translation Consolidation

Actual 2009.DEC G_WORLD 2010/09/01 09:00 a.m.

2010/09/01 09:01 a.m.

Actual 2009.DEC G_ASIA 2010/09/01 09:00 a.m.

2010/09/01 09:01 a.m.

At 9:05 a.m., the data for the entity Shanghai is updated:

Category Time Entity Data Updated

Actual 2009.DEC Shanghai 2010/09/01 09:05 a.m.

Since the data update occurs after the last currency translation and consolidation on the Groups to which the entity Shanghai belongs, an incremental currency translation and consolidation must now be performed on the entity Shanghai.

Technical entity storing aggregated data

If the Groups dimension (G or R type) contains group members (currency_type= G) having a corresponding consolidation entity ( STORE_GROUP_CURR=Y and ENTITY=<Entity Dimension Member>) then, not only the base entity with new data is reconsolidated, but at the end of each step (currency translation and consolidation processes), the consolidation entity also re-aggregates all of the data of the entity members.

In the example above, when a currency translation and consolidation are performed for the entity Shanghai, the corresponding consolidation entities ( E_WORLD and E_ASIA) re-aggregate data from all owned entities for the corresponding groups (if G_ASIA has three entities: Shanghai, Seoul and Tokyo, all three entities are re-aggregated to E_ASIA. The same principle applies to G_WORLD).

32 PUBLIC


Run Consolidation

Prerequisites

An administrator has given you the View Consolidation Monitor and Run Consolidation Tasks access rights.

Features

In the Consolidation Monitor you can do the following:

● Display the control set statusDisplay the results of control execution. The control set status enables users to verify the accuracy of reported data. For more information, see Control Set Status [page 40].

● Display the work statusShow the level of completeness of submitted data.To display the work status in the Consolidation Monitor, the driving dimensions must be at a minimum Category, Period and Entity. If additional dimensions are added, then a member must be selected for each additional dimension to enable work statuses to be displayed. Every time a work status is changed, the appropriate control set status must be checked.

● Display the currency translation statusDisplay the outcome of the currency translation processing. The status can be "Done" or "To be executed" if data was modified since the last consolidation was executed.

● Run currency translationsAvailable currencies are those specified in the Group dimension or group members. Currency translation is available at the entity level. When you select a base entity and run the currency translation for this entity, you can select the reporting currency in which to run the translation. When you select a Group or Sub-Group, the currency translation is run on the currencies defined for the selected group. For more information, see Run a Currency Translation [page 34].

● Display the consolidation statusDisplay the outcome of the consolidation processing. The status can be "Done" or "To be executed" if data was modified since the last consolidation was executed.

● Run consolidationsGenerate consolidated data using data entered in packages manually or uploaded using Data Manager, and journal entries (Journals). For more information, see Run a Consolidation [page 35].

● Display the running processesRunning processes are displayed with percent completion. You can only display processes for Groups to which you have Read access.

● Reset the consolidation statusYou can reset the status of a consolidation to "To be executed", in which case you would then need to run a full consolidation. For example, you may want to reset the consolidation status to "To be executed" in the following cases:○ Changes in the Rate and Ownership InfoProviders do not trigger incremental processes (consolidation

and currency translation)○ Incremental processes for simulation categories do not verify updates to source categories○ Masterdata changes do not trigger incremental processes


Activities

● Set the work status for an entity

1. In Consolidation Consolidation Monitor , select an entity and click Work Status in the toolbar.2. In the Change Work Status dialog box, verify the selections in the Change Status For groupbox.3. Choose a new status in the New Work Status groupbox and click OK.

● Run a currency translation.● Run a consolidation and display running processes.

Related Information

Run a Currency Translation [page 34]Run a Consolidation [page 35]Working with Periodic Consolidations and Currency Translations [page 36]

8.1.1 Run a Currency Translation

You can convert amounts from their source currency to a target currency. You can perform currency translation at any group/entity level.

You perform currency translations in the Consolidation Central module of SAP Business Planning and Consolidation.

Prerequisites

An administrator has given you the Run Consolidation Tasks access right.

You can perform currency translation on an entity if you have Write access to this entity.

To run a currency translation, you must define the following items:

● CategoryChoose the type of reported data to which the amount to be translated is linked.

● TimeSelect the data entry period in which the amount to be translated was entered.

● Group/EntitySelect the scope for which you want to run the translation. The translation is executed on the currencies defined in the Group dimension.

● Reporting CurrencyIf you selected a base entity, this dimension is displayed, enabling you to select the currency in which you want to run the translation.

● Rate Entity

34 PUBLIC


Run Consolidation

If you selected a base entity, this dimension is displayed, enabling you to select the Rate Entity in which the exchange rates to be used are stored.

● Execution ModeYou can perform a full translation, or you can update a previous translation by performing an incremental translation.

Additionally, before running a currency translation in Consolidation Monitor, you can select an available post logic script. The system will automatically execute the selected logic script after the translation is done.

Activities

To run a currency translation

1. In Consolidation Consolidation Monitor , in the scope context area, select the Category, Time and Group dimension members for which you want to run the currency translation.

2. Select the row for the Group or Entity you require and click Translate Currency.3. In the Translate dialog box, verify the selected dimension members and choose whether to run a full or

incremental translation.4. Click OK.

Related Information

Currency Translation Rule [page 196]

8.1.2 Run a Consolidation

You run consolidations in the Consolidation Central module of SAP Business Planning and Consolidation.

Prerequisites

An administrator has given you the Run Consolidation Tasks access right.

You can run a consolidation at group level if you have Write access to the group.

To run a consolidation, you must define the following items:

● CategoryChoose the type of reported data that you want to consolidate.

● TimeSelect the data entry period in which the amounts were entered.

● GroupSelect the scope for which you want to run the consolidation.


● Execution ModeChoose whether to perform a full consolidation or to update a previous consolidation by performing an incremental consolidation.

Activities

To run a consolidation, do the following:

1. In Consolidation Consolidation Monitor , in the scope context area, select the Category, Time and Group dimension members for which you want to run the consolidation.

2. Select the row for the Group or Entity you require and click Consolidate.3. In the Run Consolidation dialog box, verify the selected dimension members and choose whether to run a

full or incremental consolidation.4. Click OK.

To monitor the progress of your consolidation, click Display Running Processes in the toolbar. The status of the consolidation is displayed in the Consolidation Monitor page.

To reset the status of the consolidation to To Be Executed, select the group or entity for which a consolidation has been run and click Reset in the toolbar. For an example on when to reset the consolidation status, see Consolidation Monitor [page 31].

8.1.3 Working with Periodic Consolidations and Currency Translations

When you modify data during an accounting period that occurs prior to the period for which a consolidation is requested, it may be necessary to reconsolidate future periods. In this case, you must verify that periodic currency translation and consolidation rules exist and confirm whether or not data from prior periods was modified.

This verification must be done manually, by reconsolidating every period consecutively in full consolidation mode. Alternately, you can manually reset the entity's data to "To be executed" in the Consolidation Monitor, for every consecutive period. In this case you would use incremental consolidation.

Related Information

Run a Consolidation [page 35]

36 PUBLIC


Run Consolidation

8.2 Controls Monitor

The Controls Monitor enables you to execute and monitor controls.

Use

Controls are run on a selected entity or group of entities. If you select a Group, you can run the controls for all the aggregated entities belonging to this Group. Controls are executed in the order in which they appear in the control set.

The Controls Monitor displays the Group/Entity structure based on the hierarchy created in the Ownership Manager (only Consolidation type models). For information on configuring an ownership-based hierarchy, see Ownership Manager [page 54].

The Controls Monitor is split into the following areas:

● At the top, the scope context area displays the dimensions selected as the Controls context.To modify the dimension members displayed in the scope context area, click the linked members to display the Member Selector dialog box.

● In the middle, a list of control sets organized by entity, displaying the control status and the number of blocking or warning controlsIn a Consolidation model, only the entities belonging to the Group selected in the scope context area are displayed. In a Finance model, if a node entity is selected in the scope context area, only the child entities of the node entity are displayed.

● At the bottom, a list displaying details on failed controls for the entity previously selected in the control set list.Each time you select a different entity in the control set list, the list of failed controls is refreshed.

Prerequisites

An administrator has given you the View Controls access right.

The Work status settings and the controls have been configured, and controls are enabled for the model, in Planning and Consolidation Administration.

A value has been specified for the MONTHNUM property in the Time dimension.

Features

Run controls

Run controls for the selected entity or group. Control results are displayed in the Controls Monitor page. You can run controls from the main Controls Monitor page, or from the controls results page for a selected entity.

Display details on failed controls


When you select an entity or the group on which you have run controls, a summary of failed controls is displayed in the Details on Failed Controls list in the Controls Monitor page.

Sort columns

You can sort the columns alphabetically in the list in the Controls Monitor page by clicking on the column header. A triangle appears, indicating the direction of the sort. Clicking the column header a second time changes the direction of the alphabetical sort.

Show descriptions

By default, only the entity code is displayed in the Controls list. You can display the entity descriptions by selecting the Show Description option.

Display controls results for one or more entities

You can display for an entity or for the group the control status of each control in the control set using the Controls Results option in the Controls Monitor page. In the Controls Results page, you can do the following:

● Expand a control with one or more breakdown dimensions.The status and data for each breakdown dimension member is displayed.

● Filter the list of controls displayed using the Show dropdown list.Available filters include: All, Passed, To be executed, Failed, Dismissed.

● Open a linked document to analyze the result in case of an error, and, for example, to perform manual adjustments in data entry schedules.

● Dismiss or reset blocking controlsIf you have the appropriate access right, from the Controls Results page, you can dismiss a blocking control when the control status is Failed, thereby changing its status to Dismissed. This gives you the ability to update the work status (allowing data to be validated in the workflow) even when a blocking control produces an error when executed.

ExampleFor instance, the definition of a blocking control specifies that the same amount for depreciation of buildings be entered in a specific Balance Sheet account/flow and in a specific P& L account. If the amount is not entered in the corresponding account in the balance sheet, because of your organization's accounting procedures, the blocking control returns a status of Failed after execution. You can then dismiss the blocking control so that the data can be validated in the workflow.

You can reset the status of the blocking control to Failed, if it is determined that the original control status should be kept. For more information on control types, see Create a Control [page 217]; for more information on control status, see Control Set Status [page 40].

Refresh the controls page

You can refresh the list of controls by clicking Refresh. For example, if a data entry was just performed, you can refresh the page to take into account the updated status.

You can perform a refresh of the main Controls Monitor page, as well as of the controls results page for a selected entity or group of entities.

When you enable control for a model, you can decide whether the context of the control monitor should be derived from the work status or set manually.

You can also set the context of the control monitor on the parent node level.

38 PUBLIC


Run Consolidation

Activities

● To run controls for the selected entity or entities, see Execute a Control Set [page 39].● To display detailed control results

1. In Consolidation Controls Monitor , select on which execution level you want to display control results. Options are loaded data, translated data, and consolidated data.

2. Select the entity or group for which you want to display detailed information and click Open Controls Results in the toolbar.○ If you select on the group level, the page displays results for all entities under this group.○ If you select on the entity level, the page displays the result for this entity under all groups.

● To dismiss or reset blocking controls

1. In Consolidation Controls , select the entity for which you want to display control results.2. Click Open Controls Results in the toolbar.3. In the Controls Results page, select the Blocking type control whose status is Failed, and click Dismiss

Block in the toolbar.The status of the blocking type control is now Dismissed.

4. To reset the control status to Failed, select the control and click Reset Block in the toolbar.

Related Information

Controls [page 215]Execute a Control Set [page 39]Control Set Status [page 40]

8.2.1 Execute a Control Set

Perform these steps to execute controls and monitor their progress.

Prerequisites

An administrator has given you the Execute Controls access right.

You have read access to the data region for which controls are to be executed.

A category/time pair has been assigned in Planning and Consolidation Administration to the control set you want to execute. See Working with Control Sets [page 222].


Procedure

1. In Consolidation Controls Monitor , select the entity or group of entities required and click Run Controls.The results are displayed in the Controls Monitor page.

NoteFor loaded data, when the property Bypass LC in ctrls in the Entity dimension is left blank for a given member, the Local Currency member (LC) of the Reporting Currency dimension is used to run controls.

To bypass this, you can set the property Bypass LC in ctrls to " Y"; which means the currency specified for the entity (for example, EUR) is used to run controls.

Controls are executed according to the control level associated to the selected entity.

ExampleIf the entity on which controls are executed is Basic (Control Level 1), then only Level 1 controls are executed within the relevant control set. If the entity on which controls are executed is Standard (Control Level 2), then Level 1 and 2 controls are executed. If no control level is associated to the selected entity, all controls are executed for the selected entity.

A specific Data Manager package can trigger the execution of a control set.

Related Information

Controls Monitor [page 37]Control Set Status [page 40]

8.2.2 Control Set Status

A control set has only one output - the control set status.

Possible control set status values are the following:

● Not applicableNo control set has been defined for the selected Category and Time dimension members.

● To be executedApplies in the following cases:○ A control set has been defined for the selected Category and Time dimension members and has not

yet been executed for the corresponding entity or Group of entities.○ When data is updated through data entry, data load, journal entries, script logic at the entity level, the

control set status corresponding to the Category, Time, Entity dimension members (and any other work status driving dimension) is reset to To Be Executed.

40 PUBLIC


Run Consolidation

○ If you add additional dimensions to a work status, the control set status is reset to To Be Executed for the corresponding dimension members.

○ If you modify the control set.○ If you change the structure of the entity dimension.

NoteWhen a control set status is reset toTo Be Executed, calculated control data is not reset.

Every time calculations are executed, controls which were dismissed remain dismissed if they fail, provided that the Reset dismissals option in Planning and Consolidation Administration is not enabled.

If the controls are Passed after execution, or if there is no data, the control status is updated by the new calculation.

● Passed: all controls (blocking and warning) have succeeded.● Passed with dismissals: at least one blocking control was dismissed.● Passed with warnings: at least one warning control has failed.● Failed: at least one blocking control has failed.

When a control set is executed, its status is a summary of the status of each of the controls available in the set (according to the level assigned to the control and the entity for which controls are executed).

A control set status is always attached to one of the following dimensions for controls performed in loaded data (local currency), translated data, or consolidated data:

● Category● Time● Entity● Local Currency or Entity Currency: depending on the value of the property CTRL_CURRENCY_NOT_LC

(Bypass LC in ctrls) in the Entity dimension

Control status results on node entities or groups

The control status of a parent member or group depends on the control status of the child entities.

If the control status:

● of all child entities is Passed, the parent status is Passed.● of one child entity is in error, then the parent status is Failed.● at child level contains no errors but some warnings, then the parent status is Passed with Warnings.● at child level contains a dismissed blocking control, then the parent status is Passed with Dismissals.● of at least one child entity is To Be Executed, then the parent status is either To Be Executed if no error is

found in any entity, or Failed if an error is found.

Control status results by entity control level for blocking and warning type controls

If a control fails when executed, it generates an error if it is a blocking type control and its level is inferior or equal to the control level defined for the entity. Otherwise, the control generates a warning.


Example

Control Type Control Name Control LevelEntity Control Level 1

Entity Control Level 2



Blocking Control A Level 1 Error Error Error Error

Control B Level 2 Error Error Error

Control C Level 3 Error Error

Control D Level 4 Error

Warning Control E Level 1 Warning Warning Warning Warning

Control F Level 2 Warning Warning Warning

Control G Level 3 Warning Warning

Control H Level 4 Warning

As shown in the table abpe, Entity 1 is assigned level 1. Entity 2 is assigned Level 2. Entity 3 is assigned level 3. Entity 4 is assigned Level 4. Therefore, in this case:

● Entity 1 will be checked against control A and E.● Entity 2 will be checked against control A, B, E and F.● Entity 3 will be check against control A, B, C, E, F and G.● Entity 4 will be check against all the controls listed in the table.

First assume that after executing each entity by the related Time and Category, the control status turns out as below:

● Entity 1 failed after executing Control A.● Entity 2 failed after executing Control B.● Entity 4 failed after executing Control H.● The others passed.

Then add controls A to H to control set S and assign this control set S to a time and category. The result will be:

● Group Level: Failed● Entity 1: Failed● Entity 2: Failed● Entity 3: Pass● Entity 4: Pass with Warnings

Analysis: The control set failed at the Group level because Entity 1, Entity 2, and Entity 4 all failed. The control set failed at Entity 1 because Control A is a blocking type and it shows an error. The control set failed at Entity 2 because Control B is a blocking type and it shows an error. The control set passed with a warning at Entity 4 because Control H is a warning type.

42 PUBLIC


Run Consolidation

Related Information

Controls Monitor [page 37]Execute a Control Set [page 39]

8.3 Journals

You use journals to record and make adjustments to data in the database.

This is typically done as part of the month-end or quarter-end process. For example, administrators load general ledger information into a model using Data Manager. Before the close, line managers can review the data and make adjustments as necessary using a journal entry form.

Prerequisites

● At least one journal template has been created for the model.● You have the appropriate rights to perform given tasks.

Features

The following table describes the available Journal tasks and explains how to perform each one. You perform these tasks in Consolidation Central Journals .

Task Navigation What You Should Know

Create a journal entry Click New in the toolbar of the Journals page.

For more information, see Journal Entries [page 46].

Modify a journal entry Select a journal entry from the list in the Journals page and click Open in the toolbar. In the Journal Entries tab, make your changes to one or more journal entry rows, then click Save.

You can modify saved and unposted journal entries. For more information, see Journal Postings [page 49].



Copy one or more journal entries Select one or more journal entries in the Journals page. To select non-contiguous journal entries, hold down the CTRL key as you make your selections.

Select Copy To from the toolbar, specify whether to keep the same Time, Category, and Datasource dimension members and confirm.

You can copy selected entries to another member of one of the header dimensions.

Preview line item detail of a journal entry

Select a journal entry from the list on the Journals page and select the Preview option in the toolbar. The details on the journal entries appear below the list of journal entries.

You can review detail lines of a journal entry for the entries to which you have View rights. For more information, see Journal Queries [page 51].

Open one or more journal entries Select a journal entry from the list on the Journals page and click Open in the toolbar. You view the details of the journal entries in the Journal Entries tab. You can open additional journal entries and toggle between them using the tabs that appear with each open journal entry.

You open journal entries to view or edit them. For more information, see Journal Entries [page 46].

Post one or more journal entries Select one or more journal entries from the list on the Journals page and click Post in the toolbar. All the selected entries are posted. To select non-contiguous journals, hold down the CTRL key as you make your selections.

When you post an entry, the system applies the values in the journal entry to the database, so that model data is appended. You can configure a journal entry to be posted with multiple header dimensions or multiple values. For more information, see Journal Postings [page 49].

Unpost one or more journal entries Select one or more journal entries from the list on the Journals page and click Unpost in the toolbar. All the selected journal entries are unposted. To select non-contiguous journal entries, hold down the CTRL key as you make your selections.

The system reverses the original entry to the model. For more information, see Journal Postings [page 49].

Ungroup journal entries Select one of the journal entries in a journal group and click Ungroup in the toolbar. All the journal entries in the group are ungrouped.

For more information, see Journal Groups [page 50].

44 PUBLIC


Run Consolidation


Search for journal entries In the Filter by menu located in the toolbar of the Journals page, choose Advanced Query. In the Advanced Query dialog box, define your query and click OK.

If a large number of journal entries are written to a model, use the Advanced Query to define queries so you can search for specific entries. The Advanced Querysearches through both header and detail dimensions. If you have multiple journal entries, they are grouped under the first entry. For more information, see Journal Queries [page 51].

Lock and unlock journal entries Select a journal entry from the list in the Journals page and click Lock in the toolbar. To unlock the journal entry, select it and click Unlock in the toolbar.

When you lock a journal entry, you cannot make changes to the line item details.

Reopen journal entries Select one or more journal entries from the list on the Journals page and click Reopen in the toolbar.

To reopen one or more single journal entries to new single journal entries in a subsequent time period, see Reopen Journal Entries [page 52].

Require balanced journal entries Select the Enforce Balanced Journals option in the journal model parameters.

A balanced journal entry is one in which the debits equal the credits in the journal entry. If this option is set, you cannot post the journal entry until it is balanced. For more information, see Journal Model Parameters [page 259].

Print a journal report Select one or more journal entries from the list on the Journals page and click Report in the toolbar. To select non-contiguous journals, hold down the CTRL key as you make your selections. In the Journal Report tab that opens, click Print.

You can generate reports based on journal entries. For more information, see Print Journal Reports [page 53].

NoteTo use this task, users must have one or more task profiles related to Journals, including CreateJournal, PostJournals, ReviewJournals and UnpostJournals.



Delete one or more entries Select one or more journal entries from the list on the Journals page and click Delete in the toolbar. To select non-contiguous journals, hold down the CTRL key as you make your selections.

When you delete an entry that has been unposted, its status changes to Deleted. When you delete saved entries, they are deleted from the system. An entry that has been posted cannot be deleted until it is unposted. For more information, see Reopen Journal Entries [page 52].

Define journal reopen rules In Planning and Consolidation Adminis

tration, select Features Journal

Templates . Open a journal template and click the Reopen Rules tab.

Design a template of translation information for the dimensions you want to reopen. For more information, see Reopen Journal Entries [page 52].

8.3.1 Journal Entries

You create and maintain journal entries using the journal entry template built by your administrator.

Features

The following features are related to journal entries:

Postings

You can post journal entries after they have been saved. For more information, see Journal Postings [page 49].

Reports

Once you save and post journal entries, you can track and report on all adjustments to data. For more information, see Print Journal Reports [page 53].

Journal IDs

The first time you save one or more entries, the system generates a Journal ID, which you can use to identify the entry. If you create journal entries as a group, the system also assigns a group ID.

Standard Journal Entries

You can enter standard journal entries, which have one member defined for each header dimension and one credit or debit value.

46 PUBLIC


Run Consolidation

Activities

To create a journal entry, select Consolidation Journals , then click New in the toolbar. For more information, see Journals [page 43].

Related Information

Journals [page 43]

8.3.2 Journal Entry Form

You use the journal entry form to create, modify, and post journal entries.

Features

Use the journal entry form as described in the following table to enter journal entries:

Form fields Description

Model information Read-only fields that display the environment name and the model for which you are entering the journal.

Header dimensions The fixed dimensions for all journals in the current model that are displayed in the scope context area of the journal entry form. You select members for each dimension by clicking the entry cell to display the Member Selector dialog box.

Additional Properties Text fields or lists containing clarifying information, such as date or type, that you save along with the journal entry form. The system does not require additional header items, but your business process may require them. If they are present in your journal entry form, you must complete them before you can post a journal entry.

Multiple Headers Choose this option if the same amounts need to be posted to more than one member in one of the dimensions in the data region. When you select the Multiple Headers option, the associated Dimensions member lookup then becomes available.


Form fields Description

Multiple Values Choose this option if different amounts need to be posted to more than one member in one of the dimensions in the data region. When you select the Multiple Values option, the associated Dimensions member lookup then becomes available.

Journal Entries tab Display in columns so that each row under the dimension name is unique. Each unique combination of members represents one detail line. You can enter the members associated with the data values you want to change, and the debit or credit amount. When you create multiple entries with multiple values from a single header item, a set of debit and credit columns displays for each additional member specified.

Multi Posting tab The journal entry is posted to the database under each dimension member defined for Multiple Headers and Multiple Values. This tab is grayed out until one of the aforementioned options is selected.

Status information The following information displays for auditing purposes:

● Status: The current status of the journal entry. Statuses include Saved, Posted, Unposted, and New.

● Original ID: If a journal entry is reopened, the old journal ID is the ID of the original entry.

● ID: Lists the journal ID (determined by model).● Group ID: Taken from the first Journal ID in the Group.

Journal options These options allow you to perform advanced functions on the journal entry:

● Balanced: This option allows you (or an administrator) to require that journals are balanced upon posting.

● Reopen in Next Period: This option allows you to reopen the journal entry to another account in a subsequent time period.

● Auto Reverse: This option allows you to reverse the credit or debit value in the journal entry in the next time period.

NoteThis option sets up a new journal; it does not create postings.

48 PUBLIC


Run Consolidation

Related Information

Journals [page 43]

8.3.3 Journal Postings

You post journal entries to enter the details of a transaction into the database.

Prerequisites

An administrator has given you Post rights.

One or more journal entries have been saved.

Features

When you post a journal entry, the system takes the following actions:

● Validates the journal entry for completeness and accuracy. For example, if you require balanced journal entries, debits must equal credits.

● Locks the journal entry so it cannot be edited.● Applies the values in the journal entry to the database, so application data is appended to the numbers in

the database. (Unlike in input schedules, the system appends data, it does not replace it.)● Updates the entry to record the user who posted the entry. This information is useful when you create

journal reports for the entries.

Reposting journal entries

You can repost journal entries that you accidentally delete. Only journal entries that have previously been posted can be reposted.

Unposting journal entries

You can unpost one or more journal entries to make changes to them.

Multi-Posting journal entries

You can configure a journal entry to be posted to the DataStore Object (advanced) under multiple dimension members that you define in the journal entry page. You can choose one or both of the following:

● Multiple headers: the same amounts need to be posted to more than one member in one of the dimensions in the data region. For example, the journal entry needs to be posted to both the actual and forecast categories.

● Multiple values: different amounts need to be posted to more than one member in one of the dimensions in the data region.


Activities

● To post one or more standard journal entries, in the Journals page, select a journal entry and click Post in the toolbar. All of the selected journal entries are posted.

● To find a specific entry to post, from the Journals page, select Advanced Query from the Filter by dropdown menu, and build a query to find the entries that you want to post. Select all entries that you want to post, and then click Post in the toolbar. To select non-contiguous journal entries, hold down the CTRL key as you make your selections.

● To unpost a journal entry, in the Journals page, select a journal entry and click Unpost in the toolbar. When you unpost a journal entry, the following events occur:○ The system keeps the same journal ID.○ The status of the journal entry changes to Unposted.

● To configure a journal entry for multi-posting mode1. In the Journals page open the journal entry. Select one or both of the following options, and select the

dimension member from the corresponding member lookup:○ Multiple Headers○ Multiple Values

2. Click the Multi Posting tab to add additional headers or values:

NoteThe Multi Posting tab is greyed out, until you select one of the options listed above.

○ To add additional headers, in the Multiple Headers list click Add, then select the dimension members you require from the Member Selector dialog box.

○ To add additional values, in the Multiple Values list click Add, then select the dimension members you require from the Member Selector dialog box.

Related Information

Journals [page 43]Journal Entries [page 46]

8.3.4 Journal Groups

When you enable multiple headers in a journal entry, you create a journal group.

You can add two or more journal entries to a journal group. See Journal Entry Form [page 47].

You group and ungroup journal entries in Consolidation Journals .

50 PUBLIC


Run Consolidation

Features

Journal groups have the following features:

● Group IDAll journal entries in the same group have the same journal group ID, which is taken from the first journal ID in the group. (Each journal entry still maintains a unique journal entry ID.)

● Group StatusAll journal entries in a group have the same status. When you perform an action that updates the status of a journal entry in a group, for example, posting the journal entry, all journal entries in the group are also posted and their status updated.

Activities

● To create a journal group1. In the Journals page, click New in the toolbar to create a journal entry.2. In the journal entry form, select Multiple Headers.

The Multi Posting tab becomes available, and you can add the required additional headers.● To ungroup journal entries

○ In the Journals page, select a journal entry in the journal group and click Ungroup in the toolbar.All journal entries in the group are now ungrouped.You can no longer perform multi-posting on these journal entries; the Multi Posting tab is grayed out in the journal entry form.

Related Information

Journals [page 43]Journal Postings [page 49]

8.3.5 Journal Queries

If a large number of journal entries are written to a model, you can define queries to search for specific entries. Both header and detail dimensions are searched.

Features

Once you display a query, you can perform the following tasks on journal entries:

● Open the saved or posted entries


● Open all, posted, unposted, deleted entries● Review the line item detail on posted or saved entries● Post the saved entries or unpost the posted entries● Delete the unposted entries

Activities

Define a journal query:

1. From the Journals page, select Filter by Advanced Query .2. Specify as many query parameters as necessary. You can add additional query parameters by adding new

rows.3. Once you have made your selections, click OK. The query results are displayed.

NoteThe query settings are saved until you deselect Advanced Query in the Filter by menu.

Related Information

Journals [page 43]

8.3.6 Reopen Journal Entries

You can reopen one or more journal entries from a previous year, then post them to another set of accounts for the following year.

Prerequisites

The administrator has customized the reopen rules table. The table defines the source and destination accounts for the reopening of journals. You define criteria to reopen from one dimension to another dimension. See Journal Reopen Rules [page 257].

The system is set to allow for reopening of journals using the Allow Journals to be Reopened journal parameter. See Journal Model Parameters [page 259].

The selected source journal entries are posted to the database.

The Reopen in Next Period option is selected in the journal entry.

52 PUBLIC


Run Consolidation

Features

You can reopen one or more journal entries to new journal entries.

Activities

To reopen a journal entry:

1. In the Journals page, select a journal and click Reopen in the toolbar.2. In the Reopen dialog box, in the Select journals to be reopened section, specify a Category and Time

member from which to select the journal entries you want to reopen.3. In the Select destination section, specify a Category and Time member in which you want to reopen the

journal entries.

Related Information

Journals [page 43]

8.3.7 Print Journal Reports

You can generate and print reports based on journal entries. These reports, which are web-based, represent an audit trail of all journal entries.

Features

The printed journal entry report contains all postings for the selected journal entries.

You can filter the journal report by creating a journal query based on multiple parameters, including but not limited to dimension member such as account, journal status, posted date, or group ID. You can then select the journal entry from the filtered list. For more information, see Journal Queries [page 51].

Reports are displayed in separate tabs.

Activities

To print a journal report of one or more journal entries

1. Select Consolidation Journals .


2. Select one or more journal entries in the Journals page and click Report in the toolbar.

NoteTo select non-contiguous journals, hold down the CTRL key as you make your selections.

The journal report, containing all the postings for the selected journal entry or entries, opens in a new tab.3. Click Print in the toolbar.

Related Information

Journals [page 43]

8.4 Ownership Manager

The Ownership Manager in the Consolidation Central module enables you to create and manage ownership-based hierarchies used for performing statutory consolidations.

An ownership-based hierarchy combines Groups and Entity members, where entities can be differently connected to or disconnected from groups according to Category and Time. Groups are nodes whereas entities are base members.

You define ownership-based hierarchies in the system to set up and report on entity hierarchies that cannot be managed by a fixed hierarchy.

While management reporting entity structures are fixed, and children roll up 100% to their associated parent, ownership-based hierarchies support the legal structure of statutory consolidations that cannot be managed by a fixed hierarchy.

Features

The static hierarchies exist above the ownership-based portion of a hierarchy, which is attached below a base-level member in the static hierarchy. The Groups dimension is used to identify consolidation sequences and for reporting.

● The ownership relationships required for legal reporting may exceed a one-to-one relationship in their reporting structure or they may change frequently.

● There are two scenarios where you should define ownership-based entity hierarchies:○ If a child member is owned by more than one parent○ If the child is partially owned by a parent (not 100%)

● In the Ownership Manager you define an ownership-based hierarchy entity structure. The Ownership Manager allows you to create period-specific hierarchies of corporate entities to use in statutory consolidation, or in cases where hierarchy changes for an application need to be tracked by Category and Time.

54 PUBLIC


Run Consolidation

● When you set up a Statutory model, the system tracks hierarchies for statutory reporting. Statutory models have an upper-level static hierarchy associated with a Group dimension.

● Ownership-based hierarchies are only available in consolidation type models.

Activities

● Display the Ownership ManagerSelect Consolidation Ownership Manager .

Related Information

Create Ownership-based Hierarchies [page 55]Ownership-based Hierarchy Requirements [page 59]

8.4.1 Create Ownership-based Hierarchies

You create ownership-based hierarchies using the Ownership Manager, which is an ownership-based hierarchy editor provided in Consolidation Central.

Procedure

To create ownership-based hierarchies in SAP Business Planning and Consolidation, select ConsolidationOwnership Manager Edit .

● The top of the window shows the Category, Time, and Groups setting for the active current view. Use the member lookup in these fields to change the Category and Time members for which you want to create an ownership-based hierarchy. Use the member lookup in the Groups field to specify the member that you want to use as the parent in the hierarchy. If this Group dimension member is defined as part of a fixed hierarchy for a statutory consolidation, this fixed hierarchy is imported intact into the Ownership Manager. In the tree structure to the left, expand the parent member to view any existing children.You can also maintain children for each group level by choosing a group and clicking Add to add entities to or remove entities from the group.

● To display all members that have detail but are not used in a hierarchy, select the Show empty option in the toolbar. This function helps assure that you do not forget to specify the method and percentage for newly inserted members.

● After you create the desired hierarchy, you can enter detail for each child member, as described in the following section, and run ownership calculations.

Enter Child Member Detail


When working with consolidation models, you can provide consolidation information, such as percent ownership, percent control, percent consolidation, and the consolidation method to the child members. You enter this detail in the right-hand part of the Ownership Manager window.

From the Ownership Manager Edit window, select the desired child member from the hierarchy on the left. In the right-hand part of the Ownership Manager window, double-click in the Current column corresponding to the parameter whose value you want to update. Select the Update ownership upwards option if you want the updates made to an entity member to apply to all groups (parents) above.

Remove a Child Member

Select a child member in the tree hierarchy and click Remove. If a deleted member had method, ownership or consolidation detail specified, this detail is deleted along with the member.

Copy Ownership Data

To copy ownership data to another period, display the hierarchy in the Ownership Manager Editor, highlight the group dimension and select Copy to from the toolbar. In the Copy Ownership to window, select the Category and Time combination to which you want to copy the hierarchy. If ownership data already exists in the destination period, the copied ownership data is merged into the existing data set.

Cut and Paste a Child Member

Select a child member in the tree hierarchy and click Unpin in the toolbar. Position the cursor at the point in the tree hierarchy where you want to paste the child member and click Pin in the toolbar.

Related Information

Ownership Manager [page 54]Example of an Ownership-Based Hierarchy with Divested Entities [page 56]

8.4.1.1 Example of an Ownership-Based Hierarchy with Divested Entities

In this example, an ownership-based hierarchy is divested of two entity members in 2015. The entity members remain part of the ownership-based hierarchy in the period 2015, but are excluded in the period 2016.

Activities

1. You create an ownership-based hierarchy with the Parent Group member GROUP_WORLDWIDE, and assign the entity members to parent entities as follows:

Parent entity members Child entity members

56 PUBLIC


Run Consolidation

AMERICA USA

CANADA

EUROPE UK

FRANCE

ASIA CHINA

JAPAN

2. You assign the following Consolidation Method, Percent Control, and the Percent Ownership to the entity members:

Entity member Consolidation Method Percent Control Percent Ownership

USA Full 100 % 100 %

CANADA Full 100 % 100 %

FRANCE Holding 100 % 100 %

UK Equity 20 % 20 %

CHINA Proportionate 50 % 50 %

JAPAN Full 100% 60%

3. For the period 2015.June, you assign the Consolidation Method, Percent Control, and Percent Ownership at the level of the Parent Group GROUP_WORLDWIDE (select the highest level parent in the left-hand hierarchy) as follows:


USA Full 100 % 100 %



UK Full 100 % 100 %

CHINA Full 100 % 100 %

JAPAN Full 100 % 100 %

Methods are defined for each group, at the level of the first immediate parent for each entity.The percentage values you assign to the first parent entity group are not inherited by the Parent Group by default. To do so, you must select the option Update Ownership Upwards in the toolbar while positioned on the parent entity group whose values you want the Parent Group to inherit.


4. The UK and Japan entity members are divested following the period 2015.June. The UK and Japan entity members still appear in the ownership-based hierarchy for the period 2015.Dec. as follows:


USA Full 100 % 100 %



UK Divested 0 % 0 %


JAPAN Divested 0 % 0 %

5. For the period 2016.Dec., the divested entity members no longer appear in the ownership-based hierarchy. The members and percentage values are as follows:


USA Full 100 % 100 %




Related Information

Ownership Manager [page 54]Create Ownership-based Hierarchies [page 55]

58 PUBLIC


Run Consolidation

8.4.2 Ownership-based Hierarchy Requirements

This topic describes the hierarchy requirements for Statutory, Main, and Ownership models.

Use

To set up a general model for use with ownership-based hierarchies, you need a main model that stores the entity information and contains links to a supporting Ownership-type model where the data is stored. For information about creating an Ownership model, see Consolidation [page 112].

Features

Requirements for the Statutory Model

In consolidation type models, you can combine an ownership-based hierarchy with a static, upper-level portion of the hierarchy representing Groups. You can use this portion of the hierarchy to generate statutory reporting or to identify a series of groups for consolidation.

The Groups hierarchy is controlled by the dimension property called PARENT_GROUP. This property has no default value; the presence of the property enables the Groups hierarchy. The property is populated with hierarchy information (similar to the PARENTHn field), but does not generate a true OLAP hierarchy of members in the Group dimension. This is because in statutory models Groups cannot be rolled up, since consolidation consists of both a complex aggregation as well as eliminations. A complex aggregation means that aggregation is also performed according to a Consolidation Method and a specific percent consolidation.

There is a split between the base-level members (the members of the Entity dimension) and the parent-level members (the members of the Group dimension). In some cases, parents in the Group dimension are actually base-level members to which entities are attached.

These members are used by the Business Rules engine which writes the contribution of each Entity to each Group (using the Entity/Group intersection). The consolidation of each upper-level Group begins with the base-level entities.

Groups may have a corresponding Entity (as defined in the Entity property), since this member is used to store the aggregated amount of consolidated amounts. They are also used when creating reports.

Requirements for the Main Model

Required dimension-types: Account (A), Category (C), Time (T), Entity (E), Group (G) and Reporting Currency (R).

NoteYou can also include the Intercompany (I) dimension in the ownership model in order to use the ownership calculation feature.

Requirements for the Ownership Model


The main model must link to a supporting Ownership-type model. It must contain the following dimension types, as no other dimension types are supported:

Dimension Type Description

Account (A) The Account-type dimension must contain an account (the default name is PGROUP) that has a nonzero value for the valid intersections of the Entity and Group dimensions. You must enter the name of this member in the Org_AccountOwn model parameter in the ownership model. This refers to SAP Business Planning and Consolidation, version for the Microsoft platform.

It may also contain other accounts that can be used to store additional information relating to an Entity/Group intersection for a given Category and Time. The set of accounts to display in the Ownership Manager is controlled by an ORG_ACCOUNTOWN model parameter.

NoteAll required members, including POWN, POWNG, PCON, Method, and PGROUP, are listed in the O_Account dimension delivered with EnvironmentShell.

CautionRenaming the Account dimension member in the ownership model could cause errors when executing the ownership calculations.

Category (C) Must be the same Category dimension used in the main model.

Time (T) Must be the same Time dimension used in the main model.

Entity (E) Must be the same Entity dimension used in the main model.

60 PUBLIC


Run Consolidation

Dimension Type Description

Groups (G) Referred to as Groups, defines the parent members used in the ownership-based hierarchy. This dimension must have a property named Entity. The property values define the link between the Group dimension member and its corresponding Entity dimension member. These members are the parents that are used in the ownership-based hierarchy. For example: Group member ID G_E1 has the Entity property value E1. It corresponds to Entity dimension member E1. The property named STORE_ENTITY ( Y for Yes; N or empty for No) works in conjunction with the ENTITY property. It behaves as the triggering flag for aggregating the consolidated amounts to the ENTITY defined in the ENTITY property.

The CURRENCY_TYPE property specifies whether the Group member is a consolidation scope (CURRENCY_TYPE=G) or the default member for that dimension ( CURRENCY_TYPE=N).

Intercompany (I) Must be the same Intercompany dimension used in the main model.

Related Information

Ownership Manager [page 54]


9 System Reports

You can prepare reports containing system and security information and a history of administration and business user activities.

● General - The following general reports are available:○ Business process flows. For information, see Reporting on Business Process Flows [page 63].○ Data changes. For information, see Reporting on Data Changes [page 63].○ Work status. For information, see Reporting on Work Status [page 65].○ Comments. For information, see Reporting on Comments [page 66].○ Administration activity. For information, see Reporting on Administration Activity [page 67].

● Security - The following security reports are available:○ Users○ Teams○ Task Profiles○ Data Access Profiles

For information, see Reporting on Security Information [page 71].

Activities

To create a new report, go to System Reports, and from the list of reports, choose the type of report that you want to create. Set the appropriate reporting options and display the report.

Once you have displayed the report, you can do the following:

● Edit the report selection criteriaClick Edit Criteria to change the selection criteria.

● Refresh the reportClick Refresh to regenerate the report if you think that the data, upon which the report is based, has changed.

● Print the reportClick Print. The system grays out this option if a printer is not available.

● Export the contents of the report to a fileClick Export to File and specify the file name and location.

Comments in reports

Comments are shown in the Comments column when you display a report. The cells in the column show the number of comments, and hovering your mouse over the entry in the cell shows a tooltip with metadata about the most recent comment; cells with no comments are simply blank. Click the link to see the comments ordered by date/time. Comments are not shown in the print form of reports because the comment length is unlimited and printing has a fixed character limit. When exporting reports, the most recent comment is exported.

62 PUBLIC


System Reports

More Information

Data Auditing [page 270]

Activity Auditing [page 271]

9.1 Reporting on Business Process Flows

You can generate reports on Business Process Flows (BPFs). Reports can be viewed online and printed.

Features

The following types of BPF reports are available:

● Instance● Activity● Operation

Activities

To view a business process flow audit report, select go to System Reports, and from the list of reports, choose the type of report that you want to create. Set the appropriate reporting options, and display the report.

9.2 Reporting on Data Changes

Business Planning and Consolidation records audit information on who changed transactional data in the model. Since a data audit can be captured only for a model, this report is applicable only at the model-level.

Features

The report shows who changed the data, what time they made the change, how they made the change (for example, through SAP EPM solutions, add-in for Microsoft Office), and the details of the record that was changed.

You can choose from the criteria listed below to fine tune your report. In the report, the columns correspond to these parameters.

Application Help - SAP Business Planning and Consolidation, version for SAP BW/4HANA (Standard configuration)System Reports PUBLIC 63

Option Description

Model Select a model, for example, PLANNING or RATE.

Dimension Members Select the dimension and dimension members the audit information is stored against.

Date and Time You can choose start and end dates for the report or display the full history of the selected data audit information (Anytime).

Additional Criteria Select from the following options:

● Data Modified by Task○ All○ The EPM add-in for Microsoft Office○ Data Manager Import○ Data Manager Clear○ Logic Script Execution○ Web Report Input○ Journals Input○ Business Rule Execution○ Ownership○ FIM Import

● User● IP Address● Group Rows by

○ Activity○ AddInfo1○ AddInfo2○ Machine Name○ IP Address○ Dimensions relevant to the model○ User

● Show Rows by○ ID (Member ID)○ Description (Member description)

● Machine Name● Current, which includes audit records of data changes

that have not yet been archived● Archived, which includes audit records of data changes

that have already been archived● Current and archived, which is the combination of both

options

Value The Value field shows you the value to which the original value was changed. That is, it shows you the new value, not the original nor the delta value posted to the database.

64 PUBLIC


System Reports

Activities

To view a data changes report, go to System Reports, and from the list of reports, choose Data Changes. Set the appropriate reporting options and display the report.

More Information


9.3 Reporting on Work Status

The report on work status allows you to display the work status codes for a set of given criteria.

Work status is a feature that allows you to lock regions of data from being overwritten. You define “work states”, for example, Locked, Submitted, or Approved, so users can control input to specific data regions. You can also control input methods (for example, to prevent the Data Manager being used to update data).

You can filter the report to the specific region of the DataStore Objects (advanced) for which you want the work state.

Features

The work status report shows Data State, which is the current work state for the data. It tells you the current stage of the data in the overall approval process.

It also shows the dimensions for which you define work status as being applicable. There can be 1 to 14 dimensions; the report adjusts dynamically based on the active application.

You specify the report parameters as specified in the following table:

Option Description


Dimension Members Select dimensions and dimension members that the work status is stored against.

The dimensions displayed depend on the selected model.

Date and Time You can choose start and end dates for the report. You can also display the full history of the selected work status information (Anytime).


Option Description

Additional Criteria User ID - Enter the User ID for which you need the work status report.

Activities

To view a work status report, go to System Reports, and from the list of reports, choose Work Status. Set the appropriate reporting options and display the report.

Related Information

Work Status [page 20]Work Status Setup [page 248]

9.4 Reporting on Comments

The comments report allows you to see the comments made for the current model from your context.

Features

You can choose how many and which comments are displayed by applying filters. The following table shows the filtering options that are available:

Option Description


Dimension Members Enter the individual dimensions the comment is stored against.

History You can choose to display the entire commenting string (that is, all comments that match your filter criteria) or only the most recent comments (that is, only one record is returned).

66 PUBLIC


System Reports

Option Description

Date & Time You can choose start and end dates for the report or display the full history of the selected comments (Anytime).

Priority Choose from:

● Priority○ All○ Critical○ High○ Medium○ Low○ No Priority

With the exception of All, these filter elements select a particular priority and all higher priorities. For example, High selects High and Critical comments.

● User - Enter a User ID if you want to report on the comments made by a particular user.

Activities

To view a comments report, go to System Reports, and from the list of reports, choose Comment. Set the appropriate reporting options and display the report.

In the Comments report, the columns correspond to the parameters in the above table.

Related Information

Comments [page 21]

9.5 Reporting on Administration Activity

The administration activity audit records information on tasks performed in the system, for example, who is creating, changing, deleting models, dimensions, and security.

This report applies to the environment or model level.


Features

You can set the following report options:

Option Description

Date and Time You can choose start and end dates for the report or display the full history of the selected activities ( Anytime).

68 PUBLIC


System Reports

Option Description

Task Selection The following options are available:

● Task NameYou can enter the following tasks:○ COPY ENVIRONMENT○ DELETE ENVIRONMENT○ CREATE MODEL○ COPY MODEL○ MODIFY MODEL○ DELETE MODEL○ CREATE DIMENSION○ COPY DIMENSION○ MODIFY DIMENSION○ DELETE DIMENSION○ PROCESS DIMENSION

NoteThe functional tasks are case-sensitive. When you enter the functional tasks, the system tries to anticipate your entry as you type in partial text.

● Task Area○ Environment - Report on activity at the environment level○ Model - Report on activity at the model level

● Task Group○ All - Report on activity for both user types (Admin and User)○ Admin - Reports the activity selected in the Task Type field (described below).

Admin activity shows both the previous and new values.○ User - Reports work status changes○ Process - Reports business process flow activity○ Business Rule - Reports business rule activity

● Task Type○ All - All activity types○ Add - Only add activity○ Change - Only activity that involves changes within the system○ Delete - Only delete activity

● Current, which includes audit records of activity that has not yet been archived● Archived, which includes audit records of activity that has already been archived● Current and archived, which is the combination of both options●


Option Description

Task Parameters These fields are optional and are used for additional information. You typically use them in reporting, but not for filtering.

● Modified Object● Parameter Value● Field Value● Pre-Task Value● Post-Task Value● User

Modified Object and Parameter Value are at the audit header record. Field Value, Post-Task Value, and Pre-Task Value are at the detail record.

Report Contents

The report header shows the date and time of the report, and the number of records returned. It also shows the options that you selected for Task Selection and Task Parameters, as described above.

In the report, the columns correspond to report criteria above, with additional items:

● Task Name - Name of the task● Date and Time - Date and time of the task● Model - The name of the model in which the task occurred● User - Name of the user who performed the task● Modified Object - The name of the modified object.● Machine ID - The IP address of the machine on which the task was performed● Machine Name - The name of the machine on which the task was performed● Parameter Value - Additional information● Task Group - Task group for which the task was performed● Task Type - Type of task performed● Field Value - Details of the task performed, for Create Member if a dimension member was created.● Pre-Task Value - Value in the field before the task was performed. For new dimension members, this is

blank. For deleted dimension members, this shows the ID of the deleted member. For modified dimension members, this shows the value of the modified property or hierarchy before the change, or blank if there was no value before processing.

● Post-Task Value - Value in the field after the task was performed. For new dimension members, this shows the ID of the created member. For deleted dimension members, this is blank. For modified dimension members, this shows the value of the modified property or hierarchy before the change, or blank if the value was removed.

Comments in Reports

Comments are shown in the Comments column when you display a report. The cells in the column show the number of comments, and hovering your mouse over the entry in the cell shows a tooltip with metadata about the most recent comment; cells with no comments are simply blank. Click the link to see the comments ordered by date/time. Comments are not shown in the print form of reports because the comment length is unlimited and printing has a fixed character limit. When exporting reports, the most recent comment is exported.

70 PUBLIC


System Reports

Report Filters

You can filter a report by entering a filter value in a column heading. You can combine filters by entering filter values for multiple columns.

Sorting a Column in a Report

You can sort the columns in a report in ascending or descending order by clicking a column heading.

Activities

To view an administration activity report, go to System Reports, and from the list of reports, choose Administration Activity. Set the appropriate reporting options and display the report.

In the report, the columns correspond to the parameters in the above table.

Related Information


9.6 Reporting on Security Information

The security audit reports show a summary of the users, teams, and profiles that exist for a particular environment.

The security audit reports do not show any security-related activity; for that purpose, you can use activity auditing and the administration audit report, with the appropriate filters.

Prerequisites

To view security reports of other users, you must have the Run Security Reports task privilege assigned to you. However, all users can access their own security report.

Features

The following security reports are available:

● UsersThis report allows you to see in a grid, the users assigned to the environment, and the teams and profiles to which they are assigned.


You can also drill down to view the detailed report for each user.● Teams

See a summary of the teams created for the environment, or drill into the details and see the users and profiles assigned to that team.

● Task ProfilesThis report shows you all the task profiles in the system, and for each profile, the individual tasks that have been assigned. The detailed report also shows user and team assignments.

● Data Access ProfilesThis report shows, by model, all the members assigned to the profile and whether they are for Read, Write, or Deny access. The detailed report also shows user and team assignments.

NoteIn each report, you can toggle between the list and the detail report using the Show List/Show Detail link.

Activities

To view a security report, go to System Reports, and from the list of reports, choose the type of security report you want to view.

More Information

See the Security Guide for SAP Business Planning and Consolidation, version for SAP BW/4HANA available on the SAP Help Portal.

72 PUBLIC


System Reports


10 Administration

In the Administration screen, administrators perform setup and maintenance tasks.

Setup and maintenance of Business Planning and Consolidation consist of the following tasks:

● Environment management● Dimension management● Model management● Legal consolidation● Security management, which is explained in the Security Guide available on the SAP Help Portal.● Management of data calculations for member formulas, logic scripts, business rules, and controls● Management of controls● Set up of business process flows● Set up of work statuses● Set up of journals● Set up of context defaults● Configuration of drill-through● Management of document types and subtypes● Set up of auditing

Related Information

Environment Management [page 74]Model Management [page 105]Consolidation [page 112]Rules [page 133]Controls [page 215]Business Process Flow Management [page 228]Work Status Setup [page 248]Journal Administration [page 256]Context Defaults [page 266]Drill-Through Setup [page 267]Document Types and Subtypes [page 269]Auditing [page 269]Dimension Management [page 79]

Application Help - SAP Business Planning and Consolidation, version for SAP BW/4HANA (Standard configuration)Administration PUBLIC 73


10.1 Environment Management

An environment consists of one or more models.

Each model contains the master data that controls the data in the environment. Models can share one or more dimensions with other models within the environment.

Features

Adding New Environments

Administrators create new environments by copying information from the EnvironmentShell sample environment that is delivered with Business Planning and Consolidation.

For more information, see New Environments [page 75].

Setting the Environment Status

The environment status determines when and how users can log on and interact with the data. See Environment Status [page 79].

Setting the Template Version

If you have made changes to any of the dynamic templates for reports or schedules, you can force an update of template files by changing the template version. Therefore, clients that log on to the environment receive the new templates. You can set template versions by choosing Manage All Environments, selecting an environment, then choosing Set Template Version. Increment template versions by 1.

Viewing User Activity

Business Planning and Consolidation logs user and administrator behavior. You can view activity logs by choosing Manage All Environments, selecting a environment, then choosing User Activity.

Using E-Mail Notifications

Administrators can use an e-mail notification service to send e-mails to users or teams defined in the system. The appropriate SMTP parameters must be set up correctly. For detailed information, refer to the SMTP Configuration Guide available on the SAP Help Portal.

Deleting Environments

You can delete environments after choosing Manage All Environments and selecting an environment.

CautionYou can delete an environment when it contains data. You cannot, however, delete a dimension member when there is data associated to that member in a model.

Additional Information

74 PUBLIC


Administration

https://help.sap.com/saphelp_nw70/helpdata/en/2b/d926324b8a11d1894c0000e8323c4f/content.htm?frameset=/en/af/73563c1e734f0fe10000000a114084/frameset.htm&current_toc=/en/2b/d927734b8a11d1894c0000e8323c4f/plain.htm&node_id=5&show_children=true#jump5

The following information is important when managing environments:

● An environment is equivalent to an InfoArea within BusinessWarehouse with nearly all unique objects within this InfoArea.

● No objects are shared across environments, except delivered properties such as scaling, formula, and so on. An InfoArea is like a folder, where in the case of an environment, it is much more delineated.

● You can transport environment changes between development and production systems. For more information, see the Administrator's Guide available on the SAP Help Portal.

More Information

EnvironmentShell Sample Environment [page 76]

10.1.1 New Environments

You create new environments by copying the EnvironmentShell sample environment or an existing environment.

Features

You can copy all the components from a source environment to the target, which includes, but is not limited to, business process flows, drill-throughs, audit, security, work status, transaction data, journals, and Library view data. You have the option to not copy database records, and Library view data. After the copying is complete, you can begin to modify the default models, add new ones, and assign users to them.

When you create a new environment, Business Planning and Consolidation does the following:

● Copies the environment WebFolders/data within File Service and user workspaces● Creates a copy of all NetWeaver BI objects● Copies all transactional and master data from the source environment to the new environment● Copies security and Business Planning and Consolidation metadata

If the system encounters an error when copying a environment, it rolls back to clear the objects created during the failed copy.

Activities

To access the Manage All Environments screen, follow these steps:

1. On the upper right corner of the screen, click the button.



2. Click the name of the current environment.3. In the dialog that appears, choose Manage All Environments.

You add an environment by copying an existing environment. When you create the copy, you assign a name and description to the new environment and indicate which records you want copied from the source.

More Information

EnvironmentShell Sample Environment [page 76]

10.1.2 EnvironmentShell Sample Environment

You can use the EnvironmentShell sample environment to create your own environments.

Use

EnvironmentShell needs to be populated with publications and reports to become a fully functional environment. The EnvironmentShell sample environment does not contain any data except Time dimension information, and has only a limited amount of master data in the form of dimension members. The dimension master data is limited to default members in most dimensions so the environment works when an administrative task is run.

When you install a new version of Business Planning and Consolidation, the EnvironmentShell sample environment and its components are overwritten.

CautionYou must not modify the EnvironmentShell environment.

Features

The EnvironmentShell environment contains the following components needed to build a functioning environment:

● Four sample models - Planning, Rate, Consolidation, and Ownership - that contain most of the functionality you need to start building your own environment.○ The Planning model is a multi-currency financial model. It is designed, by default, to accommodate

currency translation.○ The Rate model, which stores the currency rates, is assigned to the Planning model as a supporting

model. The combination of the two models allows for the calculation of currency conversions.○ The Consolidation model contains consolidation information, such as percent ownership, percent

control, percent consolidation, and the consolidation method to child members.

76 PUBLIC


Administration

○ The Ownership model is a supporting model for a consolidation reporting model. It stores information such as the consolidation methods, ownership percentages, and group roll up information used for legal consolidation.

If you need to build more complex environments, for example, for legal reporting, you can build an environment using the components included within EnvironmentShell.

● A set of dynamic report and input schedule templates● Data Manager packages● Blank documents in the Documents view and reports in the Library view● Required administration setup parameters● All required dimensions with the properties needed to create a basic planning and consolidation

environment

Dimensions in the EnvironmentShell sample environment

Unified dimensions for Business Planning and Consolidation models

Dimensions Models

Type ID Dimension IDDimension Description Planning Consolidation Rates Ownership

C CATEGORY Category X X X X

T TIME Time X X X X

E ENTITY Entity X X X

A ACCOUNT Account X X

D AUDITTRAIL Audit Trail X X

R RPTCURRENCY Reporting Currency

X X

I INTERCO Intercompany Partner

X X X

Dimensions specific to Consolidation

Dimensions Models

Type ID Dimension ID

Dimension Description Planning Consolidation Rates Ownership

G SCOPE Scope X X

S FLOW Flow X

Dimension specific to Planning


Dimensions Models



U PRODUCT Product X

Dimensions specific to the Rates model

Dimensions Models



A R_ACCOUNT Rate Account X

E R_ENTITY Rate Entity X

R INPUTCURRENCY Input Currency X

Dimension specific to the Ownership model

Dimensions Models

Type ID Description Planning Consolidation Rates Ownership

A O_ACCOUNT Ownership Account X

Related Information

Dimension Management [page 79]New Environments [page 75]Environment Status [page 79]

78 PUBLIC


Administration

10.1.3 Environment Status

An environment can have a status of either Online or Offline.

A newly created environment has a status of Offline until an administrator makes it available for use by giving it a status of Online.

Features

When users attempt to log on to an environment that is offline, the system displays a warning to remind the users of the environment's status. With proper authorizations, users can continue to log on without affecting the functionality or data that the users can access.

When you transport an environment, the status of the environment must be set to Offline. When you perform consolidation functions, make sure the status of the environment is Online.

For additional information about the status of environments, refer to SAP note 1699786 .

Activities

To manually set the status of an environment, follow these steps:

1. On the upper right corner of the screen, click the button.2. Choose Manage All Environments.3. Choose an environment and click Change Status.

You can enter a message to display to users who try to perform a restricted task while the environment is offline. We recommend including the current date and time and giving an estimated time of when the environment will become available, if appropriate.

More Information

Environment Management [page 74]

10.2 Dimension Management

You manage dimensions to add and perform other operations on dimensions within your environments, such as defining members and assigning properties.

A dimension is a collection of related data members, which represents one aspect of a business; for example, accounts, products, or currency. Dimensions can be added to one or more models in the environment.


http://help.sap.com/disclaimer?site=https://launchpad.support.sap.com/#/notes/1699786

Features

You can manage dimensions in the following ways:

Task More Information

Adding Dimensions You can add new dimensions to an environment to make them available for use in its models.

See New Dimensions [page 81].

Copying Dimensions You can copy existing dimensions to create new dimensions. When you copy a dimension, you specify the source dimension, a new name, and a description.

See New Dimensions. [page 81]

Modifying Dimensions You can modify an existing dimension. When you modify a dimension, you can change the name, description, dimension type, reference dimension, and dimension properties as well as enable member formulas for the dimension.

See New Dimensions. [page 81]

Processing Dimensions When you create a dimension or make changes to an existing dimension, you need to process the dimension.

See Dimension Processing [page 85].

Deleting Dimensions You can delete a dimension from an environment. However, you cannot delete a dimension when it is already assigned to a model.

You delete a dimension from an environment by selecting a dimension and choosing Delete.

Activities

To manage dimensions, go to Administration and under the Dimensions and Models choose Dimensions. Once you select a dimension, you can perform one of the available tasks.

More Information

Dimension Types [page 82]

Dimension Security [page 84]

Dimension Processing [page 85]

Dimension Member Management [page 85]

Assignment of Dimensions to Models [page 86]

Dimension Properties [page 88]

80 PUBLIC


Administration

10.2.1 New Dimensions

You add dimensions to an environment to make them available for use by its models.

To add a dimension to an environment, you can create a new dimension or make a copy an existing dimension.

Features

When adding a dimension using the New Dimension wizard, you supply the following information. This information is also useful when copying or modifying a dimension.

Field More Information

ID Dimension IDs are not case sensitive and display in the case you typed. They must be unique regardless of case.

You can use any ID you want for a dimension as long as you follow these guidelines:

● Do not use special characters such as accented characters or Cyrillic fonts in IDs.

● Enter a maximum of 16 characters and without single quotation marks ('), double quotation marks ("), back slashes (\), or ampersands (&).Dimension IDs cannot contain a dash (-), but can contain an underscore (_).

● Do not begin a dimension ID with a number as its first character.● Do not use the following names: App, AppAccess, AvlObject,

CategoryAccess, CollabDoc, CollabIcons, CollabRecipient, CollabSupport, CollabType, DBVERSION, Defaults, DesktopStyleDef, Dimension, DrillDef, DTIParam, Function, Formula, Group, InvestParam, MemberAccess, MessageLog, Packages, PageDef, Permission, PublishedBooks, Rate, ReportParam, SectionDef, Status, StatusCode, TaskAccess, User, UserGroup, UserPackages, UserPovDef, WebContents, SOURCE, SIGNEDDATA

Description Create dimension descriptions with a maximum of 255 characters.

Type The dimension type allows you to organize data within models based on the type of information included.

See Dimension Types [page 82].

Referential Integrity Referential Integrity validates the properties of the dimension with the dimension member IDs of a different dimension.

When you process the dimension, the system checks the values of the Referential Integrity property (see Dimension Processing [page 85]). Validation does not complete if they do not pass validation.

See the following table for the dimension validation rules.


Field More Information

Dimension properties You can assign new properties to a dimension.

See Dimension Properties [page 88].

Dimension Validation Rules

Dimension Type ID - Description

Reference Type ID - Description Property ID Reference Property ID

A - ACCOUNT A - ACCOUNT RATETYPE ID

C - CATEGORY T - TIME YEAR YEAR

E - ENTITY R - CURRENCY CURRENCY ID

I - INTERCOMPANY E - ENTITY ENTITY ID

Activities

You can create a new dimension in the Administration screen by choosing Dimensions New Dimensionunder the Dimensions and Models section, and then entering the required data.

10.2.2 Dimension Types

Dimension types organize data within models based on the type of information involved.

Use

An environment can have multiple dimensions of one type. Each model within the environment, however, can have only one of each of the required types. For example, the environment might contain the entity dimensions EntityB and EntityF, with the Budgeting model using EntityB and the Forecasting model using EntityF.

The following table describes the types of dimensions within Business Planning and Consolidation:

Type ID Type Description More Information

A Account Usually contains chart of accounts and other planning assumption measures. The dimension is normally represented by a hierarchy of accounts.

82 PUBLIC


Administration

Type ID Type Description More Information

C Category This represents the versions or scenarios based on which data would be tracked. It contains the types of data you are going to track, such as Actual, Budget, and Forecast. You can set up categories to store versions, such as BudgetV1, BudgetV2, and so on.

D Audit This represents the various data source that could be used to manage the main data and adjustments if any. This can be used very effectively in calculations and in business rules of a reporting consolidation model to segregate input data

E Entity Represents the business units that are used to drive the business process. Depending on your model design, the Entity type can be an operating unit, a cost center, a geographic entity, and so on. This represents the organization unit, whether defined for legal purpose or from a business perspective. This could be cost center, profit center, legal company or region. The dimension is normally represented by hierarchy of entities.

G Group Reports consolidated results in multiple group currencies within a single entity structure. Group provides multiple currencies for a group member.

NoteAssign both an R and a G identifier to a consolidation model but assign only the G identifier to the ownership model referred from the consolidation model. You cannot assign both an R and a G identifier to the same ownership model.

I Intercompany Contains the intercompany codes for the entities. This represents the intercompany codes for the purposes of legal consolidation intercompany matching and elimination.

R Currency Contains the currency rates for all currencies in which your company does business. For validation purposes, all environments must contain a Currency dimension; however, each model within an environment is not required to have a Currency dimension. The Currency dimension in a Reporting model must contain the REPORTING property; the Currency dimension in a Rate non-reporting model does not need to contain the REPORTING property. For information about reporting and non-reporting models, see Model Management [page 105].

S Subtables This is used to break down the account activity or flow. For example, some accounts, such as Fixed Assets, have a Subtables dimension containing Opening, Additions, Deletions, Transfers and Ending Balances. The Subtables type dimension is important for writing business rules that require currency translation amounts to be calculated by account.

T Time Contains the time periods for which you store data. This represents the time periods based on which data are stored. The time periods could be represented in various forms such as weekly, monthly, quarterly or custom.

U User-defined This represents any User-defined dimension that may be required for the planning process. Referred to in the system as U1, U2, U3, and so on.


More Information

Model Management [page 105]

10.2.3 Dimension Security

Dimension security controls access to dimensions and their members.

Use

Security of dimensions is at the model level. You secure a dimension within a model.

Features

You can utilize the following features to secure dimensions:

Secured and Unsecured Dimensions

You can have a mixture of secured and unsecured dimensions in a model. Securing dimensions allows you to control which users or teams have read, write or deny access to dimensions and their members. You need to define a dimension as secured if you want to control member access by specific dimensions. All users can access unsecured dimension members.

Data access profiles are used to grant model access. At least one dimension in a model should be secured to ensure control over model and data access. When defining member access for secured dimensions, be sure to define access for all secured dimensions of the model. Failure to do so results in the inability to access that model for any users or teams assigned to the member access profile. For more information about setting up member access profiles, see the topic Member Access Profile Setup in the Security Guide for SAP Business Planning and Consolidation, version for SAP BW/4HANA available on the SAP Help Portal.

Security for Member-level Dimensions

In addition to defining dimensions as secure for individual models, you can assign write access to members within the dimension using member access profiles. Since by default, users do not have access to any members of a secured dimension, member access profiles must be set up for the users you want to give read-only or write access.

84 PUBLIC


Administration


10.2.4 Dimension Processing

When you create a dimension or make changes to an existing dimension, you must process the dimension.

Features

● When you process a new dimension, its properties are saved in the database.● When you process an existing dimension, any changes you made to it are saved in the database.● You can schedule the processing of dimensions with a Data Manager package.

For information on scheduling the processing of dimension members, see the application help for SAP BusinessObjects Analysis, edition for Microsoft Office available on the SAP Help Portal.

Activities

You can process dimensions in the Administration screen. In the Dimensions and Models section, choose Dimensions , select one or more dimensions, then choose Process.

10.2.5 Dimension Member Management

You manage dimension members by adding and modifying members within a particular dimension.

You add members to dimensions based on your business needs. For example, if your company opens a new office, the financial information of that office must be part of the Entity, Category, and Currency dimensions.

A dimension contains a set of predefined properties based on its type. You can add new properties by choosing Edit Structure, if desired.

You can assign dimension formulas that calculate and store information based on member values.

Adding members to dimensions

You can add members to dimensions within an environment in the Administration screen. Under the Dimensions and Models section, choose Dimensions , select a dimension, and then choose Edit Members.

The maximum length for a member name is 32 characters. However, this limit only applies to newly created dimensions.

NoteIf you make changes to any rules in the dimension, such as adding a new formula, you must validate and save those rules, and process the dimension.

You can also add members to dimensions in bulk using packages and process chains within Data Manager. For more information, see the application help for SAP BusinessObjects Analysis, edition for Microsoft Office available on the SAP Help Portal.




CautionYou cannot rename dimension member IDs.

10.2.6 Assignment of Dimensions to Models

You assign dimensions to models to make the data in those dimensions available in your model.

Each model must have at least one dimension of the required types: Account (A), Category (C), Entity (E), and Time (T). Additional dimensions may be required depending on the type of model.

Use caution when adding dimensions from a model that already contains data. Assign dimensions only to new models that do not contain data. If you do add a dimension to a model with data, the system finds the first base member alphabetically, and loads it into the Fact tables, therefore writing all of the data from the model to that member.

Activities

To assign a dimension to a model, you modify the model as follows:

● Select the model and choose Edit.● Choose Add / Remove.● Select one or more available dimensions, then choose Add, then OK.

To remove a dimension from a model, you modify the model as follows:

● Select the model and choose Edit.● Choose Add / Remove.● Select one or more selected dimensions, then choose Remove, then OK.

More Information

Model Management [page 105]

10.2.7 Custom Measure Formulas

You use the UJA_MAINTAIN_MEASURE_FORMULA program to create and maintain custom measure formulas.

Restrictions on Maintaining Measures

● Measures delivered with Business Planning and Consolidation cannot be deleted.

86 PUBLIC


Administration

● The measures PERIODIC on a Periodic InfoProvider and YTD on a YTD InfoProvider that are delivered with Business Planning and Consolidation cannot be changed. Other delivered measures can be changed at your own risk.

NoteChanges made to measures delivered with Business Planning and Consolidation are overwritten when you make any changes to that model from the Administration screen. We recommend that you create custom measures instead of changing the delivered measures.

● Formula names cannot be duplicated.● Formula names must be entered in uppercase letters.● Parent nodes of a hierarchy cannot be used in measure formulas.

Hints for Maintaining the Formulas

● Use the same formula name as you defined in the Formula Name field when you give the measure name in [MEASURES].[<measure name>].

● If your formula has to refer to another measure, enter the other formula statement and new formula together in the formula statement section. For example, refer to the formula statement of Periodic and QTD measure on model with a YTD storage type.

● If you want to use a property of dimension within Measure Formula, you must include the SAP Business Warehouse Technical name. You can find this name using transaction MDXTEST, for example. In this transaction, choose InfoProvider as the catalog and then choose your model (InfoProvider). The system displays the list of dimensions. Expand the dimension and then its properties to view the property list.[%TIME%].CURRENTMEMBER.PROPERTIES("2/CPMB/GJPDBWP ") is a syntax for using the TIMEID property of the TIME dimension.

Creating a Custom Measure Formula

1. Go to Transaction SE38 in the ABAP layer and enter UJA_MAINTAIN_MEASURE_FORMULA as the program name.

2. Click the Debugging button.3. In the Maintain Measure Formula screen, enter the model set ID, model ID, and user ID. You must have write

access to the core model to save a formula.4. Click the Enter button on the System Function Bar.5. In the Maintain Measure Formula screen, do any of the following:

○ To create a measure:1. Click the new item button.2. Enter a measure formula name, description, and formula.

○ To display a measure formula, double-click it.○ To display an existing measure, place the cursor on the measure you want to display and click the

Display button.○ To change an existing measure, place the cursor on the measure you want to change and click the

Change button.○ To delete a measure, place the cursor on the measure you want to delete and click the Delete button.

Sample - YTD on YTD Model

MEMBER [MEASURES].[YTD] AS 'IIF(([%P_ACCT%].CURRENTMEMBER.PROPERTIES("2/CPMB/ACCTYPE")="INC" OR [%P_ACCT%].CURRENTMEMBER.PROPERTIES("2/CPMB/ACCTYPE")="LEQ"),-


([MEASURES].[/CPMB/SDATA], CLOSINGPERIOD([%TIME%].[LEVEL02])), ([MEASURES].[/CPMB/SDATA], CLOSINGPERIOD([%TIME%].[LEVEL02])))' SOLVE_ORDER=3

Sample - PERIODIC on YTD Model

MEMBER [MEASURES].[YTD] AS 'IIF(([%P_ACCT%].CURRENTMEMBER.PROPERTIES("2/CPMB/ACCTYPE")="INC" OR [%P_ACCT%].CURRENTMEMBER.PROPERTIES("2/CPMB/ACCTYPE")="LEQ"),-([MEASURES].[/CPMB/SDATA], CLOSINGPERIOD([%TIME%].[LEVEL02])), ([MEASURES].[/CPMB/SDATA], CLOSINGPERIOD([%TIME%].[LEVEL02])))' SOLVE_ORDER=3## AS 'IIF(([%P_ACCT%].CURRENTMEMBER.PROPERTIES("2/CPMB/ACCTYPE")="INC" OR [%P_ACCT%].CURRENTMEMBER.PROPERTIES("2/CPMB/ACCTYPE")="EXP") AND NOT ([%TIME%].CURRENTMEMBER.PROPERTIES("2/CPMB/PERIOD")="TOTAL" OR [%TIME%].CURRENTMEMBER.PROPERTIES("2/CPMB/PERIOD")="Q1" OR [%TIME%].CURRENTMEMBER.PROPERTIES("2/CPMB/PERIOD")="JAN" ), [MEASURES].[YTD]-([MEASURES].[YTD],[%TIME%].LAG(1)), [MEASURES].[YTD])' SOLVE_ORDER=3

Sample - QTD on YTD Model

MEMBER [MEASURES].[YTD] AS 'IIF(([%P_ACCT%].CURRENTMEMBER.PROPERTIES("2/CPMB/ACCTYPE")="INC" OR [%P_ACCT%].CURRENTMEMBER.PROPERTIES("2/CPMB/ACCTYPE")="LEQ"),-([MEASURES].[/CPMB/SDATA], CLOSINGPERIOD([%TIME%].[LEVEL02])), ([MEASURES].[/CPMB/SDATA], CLOSINGPERIOD([%TIME%].[LEVEL02])))' SOLVE_ORDER=3

AS 'IIF(([%P_ACCT%].CURRENTMEMBER.PROPERTIES("2/CPMB/ACCTYPE")="INC" OR [%P_ACCT%].CURRENTMEMBER.PROPERTIES("2/CPMB/ACCTYPE")="EXP") AND NOT ([%TIME%].CURRENTMEMBER.PROPERTIES("2/CPMB/PERIOD")="TOTAL" OR [%TIME%].CURRENTMEMBER.PROPERTIES("2/CPMB/PERIOD")="Q1" OR [%TIME%].CURRENTMEMBER.PROPERTIES("2/CPMB/PERIOD")="JAN" ), [MEASURES].[YTD]-([MEASURES].[YTD],[%TIME%].LAG(1)), [MEASURES].[YTD])' SOLVE_ORDER=3

MEMBER [MEASURES].[QTD] AS 'IIF(([%P_ACCT%].CURRENTMEMBER.PROPERTIES("2/CPMB/ACCTYPE")="INC" OR [%P_ACCT%].CURRENTMEMBER.PROPERTIES("2/CPMB/ACCTYPE")="EXP"),IIF([%TIME%].CURRENTMEMBER.PROPERTIES("2/CPMB/TILEVEL")="QUARTER",[MEASURES].[PERIODIC],IIF([%TIME%].CURRENTMEMBER.PROPERTIES("2/CPMB/TILEVEL")="MONTH" OR [%TIME%].CURRENTMEMBER.PROPERTIES("2/CPMB/TILEVEL")="WEEK" OR [%TIME%].CURRENTMEMBER.PROPERTIES("2/CPMB/TILEVEL")="DAY",SUM(PERIODSTODATE([%TIME%].CURRENTMEMBER.PARENT.LEVEL, [%TIME%].CURRENTMEMBER),[MEASURES].[PERIODIC]),NULL)),[MEASURES].[YTD])' SOLVE_ORDER = 3

10.2.8 Dimension PropertiesBy assigning properties to dimensions, you can implement powerful features in your reporting, member lookup, formulas, and Data Manager selections.

You can filter on properties in many places in the system. For example, if you want to be able to easily select entities by geographic region, you simply add a REGION property, and enter a region value for each entity. Then you can filter and sort by region, apply account logic by region, or define a report format based on region.

The system requires various properties depending on the dimension. You can also assign additional properties for your business needs.

Many of the properties are generic, such as ID and DESCRIPTION, while others can be unique to a dimension, such as SCALING. The properties define the behavior of members within the dimension.

88 PUBLIC


Administration

You can use the following features when working with dimensions:


Adding properties to dimensions You can add properties to a dimension by selecting a dimension within the dimension library and clicking Add in the toolbar above the property list.

When you add a property to a dimension, you must specify the following:

● ID - An ID for the property. The ID is not case sensitive but is displayed in the case it is typed. The ID must be unique (regardless of case) within a dimension. The maximum length of an ID is 20 characters. The permitted characters are: A-Z,a-z,0-9,_,-,. An ID cannot contain the following invalid characters: single quotation mark ('), double quotation mark ("), backslash (\), ampersand (&), dash (-) The ID cannot start with a number as a first character. The ID cannot be the same ID as that of a system-generated property. The ID cannot contain the string of characters “PARENTH”. The ID cannot be the same ID as one of the special properties described below.

● Name - A name for the property. The maximum length for a property name is 40 characters.

● Number of Characters - The maximum length for values of the property. This must be an integer greater than zero.



Adding properties to dimensions in Consolidation,Ownership, and Rates models

When you add a property to a dimension in a consolidation, ownership, or rates model, you have the option to add the set of predefined properties for the following dimension types:

● Account● Category● Audit● Entity● Time● Currency

When you add properties to any of these dimension types, you can select to add a new property or add the set of required properties for consolidation type models. For the Account dimension, you can also add the set of required properties for ownership type models.

When you add the set of predefined properties required for consolidation, ownership, or rates models, if there is already a property with the same ID as one of the required properties, the system handles this as follows:

● The corresponding property is not added to the dimension.● If the number of characters of the existing property is greater

than expected, the system does not change it.● If the number of characters is smaller, it is updated with the

default value specified for this property in the set of predefined properties

A message is displayed at the end of the process to inform you if the system did not add some of the properties because they already exist, and if the system changed the number of characters.

Modifying dimension properties You can modify a property which is not a system-generated property. You edit and change a property directly in the property list. You cannot change a property ID after you have saved it. However, you can change a property name and the number of characters, but you cannot reduce the length previously specified.

Adding property values After you add a property to a dimension, you can assign property values to members in the dimension. You can add property values to properties by selecting the desired dimension from the dimension library, selecting Edit Members, then adding the desired values directly in the member grid under the appropriate property. After you are done, you must save the changes and process the dimension.

90 PUBLIC


Administration


Removing dimension properties You can remove properties from a dimension by selecting a dimension within the dimension library and clicking Remove in the toolbar above the property list. This removes the property from the list. You cannot delete a system-generated property.

Limiting the number of dimension members available to users

When a user is filling a journal template, all base-level members that this user has access to are available. You can use the “Enable journal” function to limit the number of dimension members that are available to the users during journal entry. You can limit journal dimension member lists by adding the property EnableJRN to each dimension for which you want to limit the journal access. After that, in its dimension sheet, enter Y in the EnableJRN column of the base-level members for which you want to allow users to post journal entries. Do this for each dimension you want to limit, then process the dimensions.

System-generated Properties

The following properties are generated for all dimension types, but are not displayed in the list of properties for a dimension.

Property Description

DESCRIPTION Display name of the dimension. This appears in the language specified in the Preferences settings.

CALC Indicates whether the member is calculated by means of a formula or is at a parent level. The property values can be viewed in the Member Selector in the Analysis Office add-in.

HIR Stores the hierarchy IDs associated with the member, for example H1;H2.

Special Properties


The following are reserved IDs that you cannot enter as a property ID when adding a new user-defined dimension property:

Property Description

SOLVE_ORDER The SOLVE_ORDER property defines the order in which the system solves calculated members when they intersect with other calculated members. SOLVE_ORDER determines the order in which the system evaluates and calculates dimensions, members, calculated members, custom rollups, and calculated cells. The system evaluates the member with the highest solve order first, and calculates it last. Zero is the highest priority.

Guidelines for implementing SOLVE_ORDER:

● Specify up to 3 measures and 5 members within a SOLVE_ORDER property.

● Specify dimensions by dimension name, making sure that capitalization is correct.

Example[ACCOUNT].[Account1] / [ACCOUNT].[Account2]

[PRODUCT].[Product1] + [PRODUCT].[Product2]

The only exception to this rule is that you do not need to specify an Account dimension by name.

FORMULA The optional property FORMULA allows you to define calculations to perform for dimensions. This powerful feature of the system gives you the ability to customize data management to meet your business requirements.

Select the Enable Member Formulas option for the dimension to which you want to apply member formulas. For information about implementing formulas, see Member Formulas [page 134].

More Information

Dimension Processing [page 85]

Owner Property [page 93]

Account Dimension Properties [page 95]

Category Dimension Properties [page 96]

Currency Dimension Properties [page 97]

Entity Dimension Properties [page 98]

Group Dimension Properties [page 99]

Intercompany Dimension Properties [page 101]

Time Dimension Properties [page 101]

User-Defined Dimension Properties [page 102]

Audit Dimension Properties [page 103]

92 PUBLIC


Administration

Subtable Dimension Properties [page 104]

10.2.8.1 Owner Property

The owner designating dimension property is created in any dimension used as a driving dimension for a business process flow.

You add the property to the dimension with any name. We recommend using a naming convention that denotes the relationship to business process flow owners. A dimension can have one or more owner designating properties as long as each is unique.

For example, if your business process dictates that an entity is the differing factor when it comes to entering data, the Entity-type dimension is the dimension that drives the owner of the activity context. If your business process dictates that a department name is the differing factor, the Department dimension would have a unique owner designating property that drives the owner of the activity context. The “Owner” property used for work status is a reserved property. The business process flow owner properties must be named with a unique name.

Prerequisites

The dimension you select to drive must have at least an owner type dimension property. When more than one exists, you choose the appropriate property to use in the business process flow.

Features

The owner designating property takes user and team names in brackets as values. You can enter multiple names and teams separated by commas. You must also include the domain or server name in the path.

Activities

You do the following to set up an Owner property:

● Set up the owner property by accessing the Dimension Library, choosing Maintain Dimension Property, and adding an owner.

● Assign the owner property to a dimension by accessing Maintain Dimension Members. Define the owner property on a dimension such as Entity, then define the property values. You can enter multiple names and teams separated by commas. You must also include the domain or server name in the path.


10.2.8.2 Reviewer Property

The Reviewer property is a special property used to identify the person or team that must review an activity performed by another user in a business process flow.

This person or team member can approve or reject the action taken by the user. A reviewer can also reopen the previous step of a business process flow.

The Reviewer property must be defined prior to creating a BPF template, as the administrator is required to enter it during the setup of a business process flow template.

When defining the property, the following rules apply:

● The reviewer designating property can be set up on any dimension and can be any name, such as BPF1_Reviewer. A dimension can have one or more uniquely named properties.

● You typically select a reviewer designating property when setting a drive dimension and owner property.

When defining the property values, the following rules apply:

● The value can be a user ID or a team, or a combination of both.● If defining multiple property values, you must separate each entry by a comma.● A team name must be enclosed in brackets, as in [TEAM].● The reviewer property is case sensitive.● The limit is 255 characters.● A reviewer can reopen the previous step of a business process flow. The step must be defined to allow

reopen.

Activities

To define a reviewer property, open the dimension that you want to designate as the driver dimension of the business process flow, then add a Reviewer property and its property values. For more information, see Dimension Properties [page 88].

When creating a business process flow, choose Enable Reviewers, then set a Reviewer property when defining the step region criteria for a new step.

More Information

Creating Processes [page 243]

94 PUBLIC


Administration

10.2.8.3 Account Dimension Properties

The account dimension defines the chart of accounts for your model and how those accounts are calculated and aggregated.

Any dimension that is assigned the type A is considered an account dimension. Each model can have only one account-type dimension.

An account dimension has the following system-generated properties:

Property Name Description

ACCTYPE Account type. Can be INC for Income, EXP for Expense, AST for Asset, LEQ for Liabilities and Equity.

The account type cannot be blank.

RATETYPE Used by the currency conversion business rules. Value is optional.

SCALING Scaling options are Y or N. Used by EPMScaleData and Library view. Value is optional, but if a value is not defined, scaling is unavailable for the associated member ID.

The following property is required only if the account dimension is used in a consolidation model.


TYPELIM Specifies that Automatic Adjustments details are created based on a generic value, rather than mentioning the member itself. Allows you to apply the same processing to several accounts having the same property value.

The following property is required only if the account dimension is used in an ownership model.


IS_INPUT Flag for ownership accounts to be used in Method-based multipliers.

More Information



10.2.8.4 Category Dimension Properties

The category dimension defines the groupings in which you store information in your model.

Typical categories are Budget, Actual, and Forecast. Any dimension that is assigned the type C is a category dimension. Each model can have only one category-type dimension.

A category dimension has the following required properties:


YEAR Used to assign a YEAR to the category, to be used with the EPMRetrieveData and EPMMemberOffset functions in reporting. For more information, see the application help for SAP BusinessObjects Analysis, edition for Microsoft Office available on the SAP Help Portal.

The following properties are required only if the category dimension is used in a consolidation model.


CATEGORY_FOR_OPE Category of source data to use when performing carry forward (CopyOpening).

FX_DIFFERENCE_ONLY Specifies whether the translation result is calculated normally (blank or N) or if only the translation difference with the source category is computed ( Y).

FX_SOURCE_CATEGORY Category of source data to be used when running currency translation on a simulation category.

OPENING_PERIOD Period number of source data to use when performing carry forward (CopyOpening). This can be absolute (for example, 12 for December) or relative (for example, -1 for prior period).

OPENING_YEAR Year offset of source data to use when running carry forward (CopyOpening). This is relative (for example, -1 for prior period).

OWN_CATEGORY Category of source ownership data to be used when running consolidation on a simulation category

OWN_YEAR Period number of source ownership data to be used when running consolidation on a simulation category. This can be absolute (for example, 12 for December) or relative (for example, -1 for prior period).

OWN_PERIOD Year offset of source ownership data to be used when running consolidation on a simulation category. This is relative (for example, -1 for prior year).

RATE_CATEGORY Category of source exchange rate data to use when running currency translation on a simulation category

96 PUBLIC


Administration



RATE_PERIOD Period number of source exchange rate data to use when running currency translation on a simulation category. This can be absolute (for example, 12 for December) or relative (for example, -1 for prior period).

RATE_YEAR Year offset of source exchange rate data to be used when running currency translation on a simulation category. This is relative (for example, -1 for prior year).

STARTMNTH Starting month.

More Information


10.2.8.5 Currency Dimension Properties

The Currency dimension is required if your company reports on local currency and translated values. These dimensions store the reporting and input currencies for your organization.

Any dimension that is assigned the type R is a currency-type dimension.

The following table describes the required properties of a currency dimension. If you are utilizing the legal consolidation functionality of Business Planning and Consolidation, the currency-type dimension requires additional properties.


ENTITY A 32-character field that can either be left blank or contain a valid member name of the entity dimension associated to the current model. The ENTITY property is validated against the entity dimension, and blank fields are allowed.

REPORTING Specify your reporting currencies. If Y, this member is used for reporting purposes.

The following property is required only if the currency dimension is used in a consolidation model.


CURRENCY_TYPE Identifies the local currency member (L) versus reporting currency members (R) or transaction currency member (T).

The following property is required only if the currency dimension is used in a rate model.



MD Defines whether the currency exchange rate for that currency is used to multiply or divide with the local amount.

More Information


10.2.8.6 Entity Dimension Properties

The entity dimension defines the organizational structure of the business units for your model and how the units aggregate.

Any dimension that is assigned the type E is an entity dimension. Each model can have only one entity-type dimension.

An entity dimension has the following required properties:


CURRENCY The currency used by the entity.

CTRL_CURRENCY_NOT_LC Specifies the Reporting Currency dimension member against which a data control is performed. A control is an individual check for data accuracy and consistency. Controls are enabled or disabled at the model level.

The following are valid values:

● Y - The generic LC (local currency) member is used.● N - The entity currency property is used, for example, EUR. This can be used

when loading pre-translated data from a source system where currency translation has already been performed.

If no value is set, the default value is Y.

For more information, see Controls [page 215].

98 PUBLIC


Administration


CONTROL_LEVEL Specifies the controls that are relevant to an entity when a control set (a group of controls) is executed.

The following are valid values:

● Level 1 - Basic controls● Level 2 - Standard controls● Level 3 - Advanced controls● Level 4 - Comprehensive controls

If 4 is selected, all controls having a level from 1 to 4 are executed. If blank or 0, no control is applicable.

For more information, see Controls [page 215].

The following properties are required only if the entity dimension is used in a consolidation model.


ELIM Defines whether the entity is used to store the intercompany elimination for a given node in the hierarchy. Valid values are Y or N.

FX_TYPE Defines the subset of Currency Conversion rules to apply to the entity, where FX_TYPE matches the Entity FX Type property of the rules.

INTCO Defines the corresponding intercompany member for an entity.

More Information


10.2.8.7 Group Dimension Properties

The group-type dimension represents the relationship of entities for a given consolidation result.

This group is consolidated in a single currency, so there is no need to have another dimension. You can continue to use the currency-type dimension for this purpose or you can split it into a group-type dimension (type G) and use a pure currency-type dimension (type R) to allow reporting in multiple group currencies.

A group dimension must be assigned to an ownership and a consolidation model. You should assign both a currency and a group dimension to a consolidation model but you should assign only the group dimension to the ownership model referred from the consolidation model. You cannot assign both a currency and a group dimension to the same ownership model.



CONSO_TYPE Specifies which set of rules to apply to a group. Refers to group type filter in Adjustments and Eliminations.

CURRENCY_TYPE Used for the currency conversion.

● N - Non-group● G - Group

DATASRC_LEVEL Stores the consolidation differences resulting from different % or methods along the group hierarchy

ENTITY Blank or a valid entity ID. This is used to define the link between the Group and the Entity or to indicate the Entity where the aggregation should be stored.

If this property is filled with a valid entity ID, and the property STORE_ENTITY is set to Y, the results of the currency conversion for the current Group are also copied into this Entity. (Length = 20)

GROUP_CURRENCY This can be any valid reporting currency, and is used for currency conversion.

This property can only be used on Currency members with the property CURRENCY_TYPE of G and, in this case, it must contain a valid ID from the Currency dimension with the property CURRENCY_TYPE value of R. (Length = 20)

PARENT_GROUP Must be a valid ID from the Groups dimension. If you want to do the consolidation by level, you must indicate here the higher level from the group. If you want to use this property to define the hierarchy, enter the same code as the ID for your top group. If this property is blank, the dynamic hierarchy from the ownership application is used. (Length = 20)

STAGE_ONLY -

STORE_ENTITY Specifies whether to store the ID entered in the Entity property.

Y - If you want to store the ID entered in the Entity property.

Blank - If you do not want to store the ID entered in the Entity property.

STORE_GROUP_CURR Used for currency conversion.

Y - By default the results of the conversion into a Group currency are written in both the Group member and in the Currency member of the currency dimension.

N (or blank) - If only the Group member is to be stored, set this property to N. (Length = 1)

More Information


100 PUBLIC


Administration

10.2.8.8 Intercompany Dimension Properties

The Intercompany dimension defines the base members associated with the level at which Intercompany balances are tracked for Intercompany eliminations.

An Intercompany dimension has the following required properties:


ENTITY A 32-character field that can be left blank or contain a valid member name of the entity dimension associated to the current model. The ENTITY property is validated against the entity dimension, and blank fields are allowed.

SCALING Scaling options are Y or N. Used by Library view. The property is optional, but if a value is not defined, scaling is unavailable for the associated member ID.

More Information


10.2.8.9 Time Dimension Properties

The time dimension defines the units of time for your model and how those units aggregate.

Any dimension that is assigned the type T is a time dimension. Each model can have only one time dimension.

A time dimension has the following required properties:


BASE_PERIOD A system-generated property, used by the query engine for calculations and by the Consolidation process. It can be maintained as fiscal periods.

LEVEL Time can be a year, quarter, month, week, or day. The LEVEL property is important in defin-ing your time periods. You must have the correct level for each member. You must follow the chronological format throughout the time dimension. The correct format is the following:

● YEAR● QUARTER● MONTH● WEEK● DAY



PERIOD The PERIOD property allows you to filter, sort, and report based on the period. It can be maintained as calendar periods.

YEAR The YEAR property allows you to filter, sort, and report based on the year. You should place the YEAR properties in chronological order in the file, in order for the EPMMemberOffset function to give offsets between fiscal and calendar year correctly.

The following property is required only if the time dimension is used in a consolidation model:


MONTHNUM Provides a sorting order to leaf members of the time dimension within a year. For each base member, the number should be unique.

TIMEID Numeric ID to used for identifying the time member, for example, 20120100 for 2012.JAN.

For detailed information about maintaining these properties, refer to the note 2114433 .

More Information


10.2.8.10 User-Defined Dimension Properties

A user-defined dimension is any dimension that is not one of the standard system dimensions.

A user-defined dimension has the following required properties:


SCALING Scaling options are Y or N. Used by EPMScaleData and Library view. The property is optional, but if a value is not defined, scaling is unavailable for the associated member ID.

More Information


102 PUBLIC


Administration


10.2.8.11 Audit Dimension Properties

The audit dimension is user-defined and tracks the source of input data.

An audit dimension has the following required properties:


SCALING Scaling options are Y or N. Used by EPMScaleData and Library view. This property is optional, but if a value is not defined, scaling is unavailable for the associated member ID.

The following properties are required only if the audit dimension is used in a consolidation model.


DATASRC_TYPE Specifies whether a data source is used for Input ( I), Manual Adjustments ( M) or Automatic Adjustments Eliminations ( A).

IS_CONSOL Specifies whether data is consolidated or not. Typically this is set to yes ( Y), but set it no ( N) for data sources used in group-specific adjustments (for example, post consolidation adjustments entered against a specific group).

IS_CONVERTED Specifies whether data is translated or not. Typically this is set to yes ( Y), but set it to no ( N) for data sources used in currency-specific adjustments (for example, adjustments in EUR, USD, and so on).

DATASRC_STAGE Defines to which Audit member consolidation adjustments from lower groups are inherited in higher groups (Parent groups).

DIMLIST Property used to create a grouping of data sources which can later be used as filters in Automatic Adjustments and Eliminations business rules.

COPYOPENING Flag used to filter data sources when running carry forward (CopyOpening).

OPENING_DATASRC Specifies a different destination data source, to which the corresponding amounts are carried forward. For example, this can be used where certain entries are posted to a data source that specifically identifies these adjustments as audit adjustments in the current year, but in future years it might be required to simply include in another standard data source (that is, Input).


More Information


10.2.8.12 Subtable Dimension Properties

Subtable dimensions break down account activity or flow. For example, some accounts, like Fixed Assets, have a subtable dimension containing Opening, Additions, Deletions, Transfers, and Ending Balances.

The subtable type dimension is important for writing business rules that require currency translation amounts to be calculated by account. Since the subtable information can be used for multiple accounts, it requires its own dimension.

A subtable dimension has the following required properties:


FLOW_TYPE Defines the type of flow of the dimension, as follows:

● OPENING - Opening● TRANSLOPE - Change difference on opening● ALLOCINC - Allocation● MERGER - Merger● INCOME - Net income from the period● CHANGE - Variation● TRANSFER - Transfer● TRANSFLOW - Translation change on flow● VARSCP - Variation in scope (generic)● VARSCPMETH - Variation in scope method● VARSCPPERC - Variation in scope percentage● VARSCPNEW - Variation in scope new company● VARSCPLEAV - Variation in scope sold company● CLOSING - Closing● NONE - No flow● Blank - All other flows

SCALING Scaling options are Y or N. Used by EPMScaleData and Library view. The value is optional, but if a value is not defined, scaling is unavailable for the associated member ID.

More Information


104 PUBLIC


Administration

10.3 Model Management

A model is a representation of the relationships, calculations, and data of an organization or business segment.

Models can be categorized as 'reporting' models and 'drivers and rates' models. Reporting models are used for user input and analysis. Drivers and rates models store reference data such as currency rates and ownership data. For information about each, see Reporting Models [page 108] and Drivers and Rates Models [page 109].

Features

You can use the following features when managing models:

Creating New Models

To create a model, go to Administration and under the Modeling section, choose Models. On the screen that appears, choose New.

When you create a model in the Planning and Consolidation Administration screen, you provide a name and description, select the type of model and its options and settings, indicate whether you want to start from a blank model or an existing model, and select the dimensions to include in the model.

The setting Non Interco Member in Ownership is used to indicate a non-intercompany member within the ownership model.

The setting Parent/child property used for hierarchy of Groups is used with dynamic hierarchy statutory applications when defining fixed hierarchies. The value must match the value in the ParentProperty property value of entities in the statutory application's supporting ownership application.

During the model creation process, items such as model publications, private publications, Documents view, reports, team tasks, and Data Manager packages may be copied from a source model. You can use the Use as Source of Data for External Applications checkbox to make data within the model available for evaluation through Process Control.

Once a model has been created, you can view features of Business Planning and Consolidation that are being used for the model, including whether work status, data auditing, and journal template are on or off. You can also enable comments and use the model as a source of data for external applications.

Copying Models

You can copy an existing model as a quick way of creating a new model. The system copies the dimensions, data, and templates from the source model to the new model. You can modify the model later. When you copy a model in the Planning and Consolidation Administration screen, you select a source model, then provide a name and a description of the new model.

Adding Business Rules to Models

You can add business rules to a model in the Business Rules domain of the Administration screen. You activate the rule types you need for the model, if not already activated, and then add the new business rules of each type to the model. For more information, see Business Rules Management [page 194].

Setting up Consolidation Models


In order for a legal consolidation model to function properly, it must contain the four required ENTITY, CATEGORY, TIME, and ACCOUNT dimensions (but can be named as desired). The remaining dimensions have the following rules:

● The CURRENCY/ GROUP dimension is required for the consolidation and/or currency business rules● The INTCO dimension used for matching intercompany activity● The DATASRC dimension is required for elimination and/or consolidation business rules● The SUBTABLE (flow) dimension is optional, and based on your requirements

For detailed information, refer to Create or Modify the Model [page 125].

Setting up Drill-through

You can set up drill-throughs to view the source data that make up the content of a selected cell in an Excel report. For more information, see Drill-Through Setup [page 267].

Optimizing Model

When you create new environments and models, only a small amount of data exists. Since the amount of data you maintain grows over time, we recommend you periodically run the optimize function to improve performance. See the “Business Planning and Consolidation Administrator’s Guide” available on the SAP Help Portal for instructions.

YTD Storage Models

Since most general ledger and other source systems store balances on a periodic basis, default data storage for models is based on periodic time intervals. With this method, all calculations are on periodic balances. The balances are then accumulated for year-to-date reporting. In some business cases, calculations should occur on a year-to-date basis, like in a model with foreign currency translation. If a year-to-date basis is required, you can set your reporting models when you create them to store data on a year-to-date basis, so they accept data entry in the YTD format. When data is entered into YTD, its periodic values, used for reporting purposes, are derived by calculating the difference between the current period and the last period, as in the following example.

ExampleThis example depicts INC or EXP accounts. There is no change in behavior for AST or LEQ accounts.

January February March

Periodic 100 200 0

YTD 100 300 300

Both periodic and year-to-date storage methods support daily, weekly, monthly, quarterly and year-to-date reporting requirements.

You create a YTD storage model by specifying YTD - Year To Date for the data entry mode when defining the type of model you are creating.

Setting up Work Status Settings for Models

Managing work status involves specifying who can make changes to your data and who can change the work state on a data set. You create work states to reflect the status of data as it moves through your business processes. See Work Status Setup [page 248].

106 PUBLIC


Administration



Deleting Models

Administrators can delete models when necessary.

CautionYou can delete a model when it contains data. You cannot, however, delete a dimension member when there is data associated with that member in the model.

Related Information

Dimension Types [page 82]


10.3.1 Reporting Models

Reporting models hold financial data.

Features

The following table describes the different types of reporting models and lists the required dimensions for each:

Type of Reporting Model Description Required Dimensions

Financial Financial models perform management and legal consolidation functions. They support data translations from local currencies to one or more reporting currencies, intercompany elimination calculations, and other calculations.

When you create a financial model, you must choose an associated rate model (see Drivers and Rates Models [page 109]).

You can also choose to set up the following business rules:

● Currency conversion● Account transformation● Intercompany bookings● US eliminations● Carry-forward rules● Validations

Account (A)

Category (C)

Entity (E)

Time (T)

Currency (R)

108 PUBLIC


Administration

Type of Reporting Model Description Required Dimensions

Consolidation Consolidation models perform more complicated legal consolidation functions than Financial models. Consolidation can incorporate complex organizational structures involving full ownership, partial ownership, minority ownership and consolidation methods.

Consolidation models must reference an ownership model and a rate model (see Create or Modify the Model [page 125]).

You can also choose to set up the following business rules:

● Currency conversion● Account transformation● Intercompany bookings● US eliminations● Carry-forward rules● Validations● Automatic adjustments

Account (A)

Category (C)

Entity (E)

Time (T)

Audit (D)

Group (G)

Intercompany (I)

Subtables (S)

Currency (R)

Standard Standard reporting models have no special requirements other than the four required dimensions. Generic models have no default business intelligence. Therefore, to apply logic, create it using logic scripts.

Account (A)

Category (C)

Entity (E)

Time (T)

10.3.2 Drivers and Rates Models

Non-reporting models support reporting models by holding data such as prices or rate information.

Features

Drivers and rates models support reporting models by holding data concerning currency exchange rates and ownership percentages. You can report on drivers and rates model data. You cannot define business rules to


these model types. The following table describes the different types of drivers and rates models and lists the required dimensions for each:

Type of Drivers and Rates Model Description Required Dimensions

Rate A rate model is a supporting model for financial and consolidation reporting models. It is used to store exchange rates that support currency conversion in financial models.

The time dimension must be identical to the dimension used by the models using the rate model to store their foreign currency exchange rates and must have the same category member IDs.

This model must include a currency dimension detailing the exchange rates by each input currency. The currency dimension in a rate model does not need to have the REPORTING property.

Account (A)

Category (C)

Entity (E)

Time (T)

Currency (R)

Ownership The ownership model is a supporting model for a consolidation reporting model. It stores information such as the consolidation methods, ownership percentages, and group roll up information used for legal consolidation.

Account (A)

Category (C)

Entity (E)

Time (T)

Intercompany (I)

Group (G)

Generic A generic model has no special requirements other than the four required dimensions. Generic models have no default business intelligence. Therefore, to apply logic, create it using script logic.

Account (A)

Category (C)

Entity (E)

Time (T)

For detailed information about the setup of these dimensions, refer to Dimension Setup in Dimension Library [page 114].

10.3.3 Large Key Figure Usage

By default Business Planning and Consolidation supports numbers with up to 13 digits before a decimal point and 7 digits after a decimal point. You can use larger numbers by enabling functionality that allows large key figures, which are numbers with up to 24 digits before the decimal point and 7 digits after it. To use large key figures you must first activate the functionality in the SAP Reference IMG, and then enable it in the model.

110 PUBLIC


Administration

Related Information

Activate Large Key Figure Support in the SAP Reference IMG [page 111]Modify Existing Models for Large Key Figure Usage [page 111]Create New Models that Use Large Key Figures [page 112]

10.3.3.1 Activate Large Key Figure Support in the SAP Reference IMG

Perform this task to activate the use of large key figures within the system. You must also modify existing models in order to use this functionality and follow specific steps when creating new models.

Procedure

1. Run transaction SPRO.

2. Choose SAP Reference IMG.

3. Choose Planning and Consolidation Configuration Parameters Set Global Parameters .4. Enter a new flag with name ENABLE_LARGE_KEY_FIGURE and set its value to X.

5. Save your changes.

10.3.3.2 Modify Existing Models for Large Key Figure Usage

To use large key figures in the system, you must modify existing models:

Procedure

1. In the Administration client, choose Models.2. Select the model that you want to modify and choose Edit.3. In the modification screen choose Change Type. The update wizard starts.4. In the Key Figure Length option, select Large.5. Finish the wizard and save your changes.


10.3.3.3 Create New Models that Use Large Key Figures

To use large key figures in the system, follow these steps when creating new models:

Procedure

1. In the Administration client, choose Models.2. Start the model creation wizard.3. In the Key Figure Length option, select Large.4. Finish the wizard to create the new model.

10.4 Consolidation

This section focuses on the dimension properties and relevant settings required for the various tasks that are required to successfully perform legal consolidation using SAP Business Planning and Consolidation.

The following tasks are described:

● How to set up currency translations, intercompany eliminations, copy opening tasks, and other business rules using the business rules tables and script logic in Planning and Consolidation Administration

● How to set up the Data Manager package required to run the legal consolidation tasks in SAP BusinessObjects Analysis, Edition for Microsoft Office

Business rules provide the mathematical foundation for SAP Business Planning and Consolidation models, allowing users to manage both management and legal consolidation reporting. This section also discusses the configuration of business rules.

The finance department of a corporation uses legal consolidation to consolidate numbers from its subsidiaries and produce consolidated financial statements of this group of legal entities at the end of a financial period.

Features

You can perform the following activities in Business Planning and Consolidation during the financial consolidation process:

● Initialize opening balances at the start of a new reporting cycle● Enter amounts for each entity● Validate data● Match intercompany transactions (for example, AR/AP reconciliation)● Convert local currency data to the desired group reporting currencies● Generate all the consolidation entries for the desired groups of entities such as:

○ Ultimate ownership calculation

112 PUBLIC


Administration

○ Elimination entries for intercompany revenue, investments, and profit in inventory○ Adjusting entries○ Reclassifications○ Minority calculations and other calculations

● Make the final validation● Generate the report

Activities

To enable users to generate consolidated financial statements, you should configure the legal model, and set up the legal and statutory consolidation business rules, in order to perform the activities required in the generation of consolidated statements of a group of legal entities.

To set up your consolidation environment, you do the following:

● Create the consolidation (legal) environment and set the necessary parameters; see Create an Environment [page 113].

● Set up master data (dimensions); see .● Create the model; see Create or Modify the Model [page 125].● Enable business rules; see Business Rule Setting [page 127].● Update rate data and ownership data; see Execute Consolidation Task [page 128] and Loading Data [page

131].● Set the work status; see Work Status Setup [page 248].● Set the journal template and validation criteria; see Journal Definition and Validation Setting [page 131].

10.4.1 Create an Environment

Use this to set up an environment for legal consolidation.

Use

If you already have an existing environment (for example, for planning or reporting), you can use this environment to host your legal consolidation. Using the environment for planning or reporting as a basis to build consolidations allows you to share the relevant dimensions (for example, account) with your consolidation environment.

Related Information

Dimension Setup in Dimension Library [page 114]Create or Modify Dimension Properties [page 117]


10.4.2 Dimension Setup in Dimension Library

Set up dimensions for legal consolidation.

For the consolidation model, the dimensions listed in the tables below are mandatory requirements. Therefore, it is recommended that you verify that all the dimensions are available in the dimension library of your consolidation environment created from EnvironmentShell.

NoteWhereas the dimension names can be chosen as desired, it is mandatory that the dimension types match with the ones described below for the corresponding models.

Consolidation (MAIN) Model

Any consolidation type model must refer to a RATE and OWNERSHIP model.

The Consolidation (MAIN) model requires the following dimensions:

Dimension Description

ACCOUNT Members of this dimension are, for example, Revenue or Salaries.

CATEGORY Contains the types of data you are going to track, such as Actual, Budget, and Forecast. You can also set up categories to store versions, such as BudgetV1, and BudgetV2.

Audit Used in the business rules of a reporting consolidation model to segregate input data.

Subtable (Flow) Breaks down account activity or flow into subunits.

Entity Contains the business units that are used to drive the business process.

Depending on your model design, the Entity type can be for example an operating unit, a cost center, or a geographic entity.

Intco Contains the intercompany codes for the entities.

Time Contains the periods for which you store data.

Currency The currency type dimension is required if the customer reports on local currency and translated values.

Groups The group represents the relationship of entities and consolidation scopes for a given consolidation result.

Rate Model

The RATE model is delivered with EnvironmentShell. Most dimension properties required for the consolidation setup are delivered with the dimensions in the model. However, it is recommended that you verify this before proceeding further. Also you need to make sure the reporting models using the Rate model to store their foreign currency exchange rates share the same Time dimension with the Rate model.

114 PUBLIC


Administration

The RATE model containing exchange rates requires the following dimensions:


ACCOUNT This dimension is specific to RATE model. Members of this dimension are used to detail the different types of rate (for example, Average or End-of-period).

CATEGORY Contains the types of data you are going to track, such as Actual, Budget, and Forecast. You can also set up categories to store versions, such as BudgetV1, and BudgetV2.

Entity This is used to store multiple tables of rates, if desired; otherwise, the R_Entity dimension may just be limited to one dummy member, typically named GLOBAL. For example, if there is an entity C1000 for which a special exchange rate needs to be applied, it is defined here and the special rates are applied.

Entity is specific to and used only by a RATE model.

Time Contains the time periods for which you store data.

Currency This dimension is used to store each applicable local currency.

NoteTime and Category dimensions must be shared by all the models involved in consolidation.

Ownership Model

EnvironmentShell is delivered only with PLANNING and RATE models. Therefore, the OWNERSHIP model needs to be created before you can create the consolidation model. Refer to the model creation wizard to understand the steps of the creation process.

The business rule process uses an ownership type model when calculating the ultimate ownership or during the minority interest calculation. This model must be associated with a consolidation type model. The OWNERSHIP model contains the values of each consolidation parameter. In particular, such definitions may include:

● The list of companies being consolidated in each group● The consolidation method for each company● The consolidation percentage for each company● Their ownership percentage (how much each company is owned by the group)● The control percentage (how much each company is controlled by the group)


The OWNERSHIP model storing the ownership details requires the following dimensions:


ACCOUNT This dimension is specific to OWNERSHIP model. Members of this dimension should include METHOD (consolidation method),POWN (ownership percentage), PCON (control percentage) and PCTRL (percentage of control).

CATEGORY Contains the types of data you are going to track, such as Actual, Budget, and Forecast. You can also set up categories to store versions, such as BudgetV1 and BudgetV2.

Entity Contains the business units that are used to drive the business process. Depending on your model design, the Entity type can be for example an operating unit, a cost center, or a geographic entity.

Intco Contains the intercompany codes for the entities.

Time Contains the periods for which you store data.

Groups The group represents the relationship of entities and consolidation scopes for a given consolidation result.

The following table indicates the dimensions required in various models:

Name Type MAIN OWNERSHIP RATE

Account (Consolidation)

A X

Account (Ownership) A X

Account (Rate) A X

Flow S X

Category C X X X

Entity E X X

Entity (Rate) E X

Intercompany I X X

Time T X X X

Group G X X

InputCurrency R X

Audit D X

116 PUBLIC


Administration

Name Type MAIN OWNERSHIP RATE

Currency R X

Activities

● Create a new dimension1. In the navigation panel, go to Administration and under the Modeling section, choose Dimensions.2. Click New.3. Choose a unique ID, provide a description, and select the dimension type.

10.4.3 Create or Modify Dimension Properties

When you create a new dimension, all the required properties are created automatically based on the dimension type. However, to ensure the correct operation of consolidation and related processes (such as currency translation, simulation, and eliminations and adjustments), additional dimension properties are needed to ensure the filtering, flagging, and calculation of the target data. You should ensure that these properties are maintained with the expected values for the consolidation process according to the business requirements.

Features

Account Dimensions

The Account dimension defines the chart of accounts for the model, and how these accounts are calculated and aggregated. Any dimension that is assigned the type A is considered an Account dimension. Each model can have only one account-type dimension.

The following table details the account dimension properties:

Property Name Length Description of Property Values

ACCTYPE 3 This property can have the following values:

● INC for income

● EXP for expense

● AST for asset

● LEQ for liabilities and equity



DIMLIST 20 Used to group the accounts for use in business rules. For example, using the DIMLIST property value can help reduce the size of the FXTRANS table.

NoteSeveral DIMLIST properties can be used for one dimension.

RATETYPE 10 This property determines the business rules to be applied when translating any given account from local currency to reporting or group currency.

● When left empty, no currency translation rules are matched and therefore, no translation will be performed.

● When the value is defined as the name of a currency translation rule, that translation rule will be applied in the translation.

ELIMACC 20 Used in the elimination process and represents the difference account to which the accounts to be eliminated are posted.

NoteThis property is used only with the US Eliminations business rule.

Category Dimensions

All models require a category type dimension. The properties required in this dimension as described in the following table are for three business rules: currency translation, eliminations and adjustments and copy opening balances.

For simulation purposes, or to analyze the variances from one set of data to another, you should mix-and-match different rates and values of different data categories from different periods. For example, a user might want to compare ACTUAL with BUDGET values when both are translated at the ACTUAL rates, or this year's ACTUALS with last year's ACTUALS, both being translated using last year's rates.

This can be done by either creating an additional simulation CATEGORY (such as Actual_at_Budget_rate or similar) or adding an extra dimension to the MAIN InfoProvider, where all the simulated cases can be stored.

118 PUBLIC


Administration

There is no need to copy the input values to all models for all the desired simulations. A few definitions stored in some specialized properties of the CATEGORY (or the FX simulation) dimension inform the translation procedure where to read the input values and where to write the translated results.

To minimize the impact of the different simulations on the size of the database, it is also possible to tell the system to store only the difference between the default results and the simulated scenarios.

When using the simulation categories in the MAIN InfoProvider, simulated translations are stored in additional members of the Category dimension. These categories have non-blank values for one or more of the following properties:

Any dimension that is assigned the type C is considered to be a Category dimension.


FX_SOURCE_CATEGORY 20 The category for the source (LC) data. If blank, it is the current category.

RATE_CATEGORY 20 The category from which the rates are read.

RATE_YEAR 4 The year from which the rates are read.

The value can be absolute (such as 2008, or 2009) or a relative value (-1, -2, +1, +2). If blank it is the same as the source.

RATE_PERIOD 10 The period from which the rates are read.

The value can be absolute (such as DEC, or FEB) or a relative value (-1, -2, +1, +2). If blank it is the same as the source.

FX_DIFFERENCE_ONLY 1 If Y, only the difference between the default values and the simulated values is stored.

The business rules for copying opening balances can be controlled by assigning special properties to the category dimensions. If used, these properties affect the execution and are defined in the following table:


CATEGORY_FOR_OPEN 20 ● BlankThe category for the opening balances is the same.

● Not blankThe ID of the category from which to read the opening balances.



OPENING_YEAR 4 ● BlankRead the opening balances from the year before the current year.

● Not blankContains the year from which to read the opening balances. It can be an absolute or a relative amount

OPENING_PERIOD 10 ● BlankRead the opening balances from the last period of the year.

● Not blankContains the period from which to read the opening balances. It can be an absolute or a relative amount

Audit Dimension

You should consider the following rules:

● Mandatory for the elimination business rules. The DATASCR dimension is required for elimination and consolidation business rules. For example, automatic elimination only works if you have a base level value of data source type A.

● Optional for the currency business rules. It is not used in the business rules for currency translation.● Mandatory for the consolidation business rules. It is required as the results destination. For example, you

can define, by source data source, a specific destination data source where the resulting postings should be posted.

Any dimension that is assigned the type D is considered to be an Audit dimension.

The following table details the data source dimension properties:


IS_CONVERTED 1 ● YThe data source is converted.

● NThe data source is not converted.

● GConverts the data source from the reporting currency to the group currency. That is, the members are copied from the reporting currency of the GROUP that is being translated into the currency member corresponding to the specified group.

120 PUBLIC


Administration


IS_CONSOL 1 ● BlankUsed for top adjustments of consolidated amounts

● YStandard setting to consolidate data

DATASRC_TYPE 1 ● I - input

● M - manual journal entry

● A - automatic adjustment

● L - levelThis is used in consolidation by level to move prior level eliminations into a data source with property DATASRC_LEVEL of Y in the GROUP dimension.

COPYOPENING 1 ● Y (or blank)The member is copied

● NThe member is not copied

OPENING_DATASRC 20 ● BlankThe data source is the same as the source member

● Non-blankContains the ID of the desired destination data source for the copy

Entity Dimension

The Entity dimension defines the organizational structure of the business units for your model and how the units aggregate. Any dimension that is assigned the type E is an Entity dimension. Each model can have only one entity-type dimension.

The following table details the entity dimension properties:

Property Name LengthDescription of appropriate property value

CURRENCY 20 Local currency used by the entity.

This currency must be defined in the InputCurrency dimension.


Property Name LengthDescription of appropriate property value

FX_TYPE 20 Assigns a set of translation rules to an entity. Different entities can use differ-ent sets of rules.

Optional.

OWNER 60 Used for work status.

Optional.

Intercompany Dimension

The Intercompany dimension ( I) defines the intercompany codes for entities in consolidation and ownership models.

Currency

The currency type dimension is required if the customer reports on local currency and translated values. You can use the currency type dimension for both currency and groups, or you can split it into a Group dimension (type G) and a pure Currency dimension (type R) to allow reporting in multiple group currencies.

The required properties for a separate group dimension are the following:

Dimension Property Name Length Description of Appropriate Property Value

G GROUP_CURRENCY 20 Can be any valid reporting currency. Used for currency translation.

This property can only be used on CURRENCY members with the property CURRENCY_TYPE of G and, in this case, it must contain a valid ID from the CURRENCY dimension with the property CURRENCY_TYPE of R.

G PARENT_GROUP 20 Must be a valid ID from the Groups dimension.

If you want to do the consolidation by level, you must indicate here the higher level from the group.

If you want to use this property to define the hierarchy, enter the same code as the ID for your top group. If this property is blank, the ownership-based hierarchy from the OWNERSHIP model is used.

122 PUBLIC


Administration

Dimension Property Name Length Description of Appropriate Property Value

G ENTITY 20 Blank or a valid Entity ID.

This is used to define the link between the Group and the Entity or to indicate the Entity where the aggregation should be stored.

If this property is filled with valid ID, and the property STEntityORE_ENTITY is set to Y, the results of the currency translation for the current Group are also copied into this Entity.

G STORE_GROUP_CURR 1 Used for currency translation.

● YBy default the results of the translation into a Group currency are written in both the Group member and in the Currency member of the currency dimension.

● N (or blank)If only the Group member is to be stored, set this property to N.

G STORE_ENTITY 1 ● YIf you want to store in the ID entered in the Entity property.

● BlankIf you do not want to store in the ID entered in the Entity property.

G STAGE_ONLY 1 This property controls the way the converted values are saved when performing a multilevel conversion of groups.

This property can only take the values Y, E, or N (blank).

G and R CURRENCY_TYPE 1 ● L - local currency

● R - reporting currency

● T - transaction currency

● G - group

Used for the currency translation.

FIRST_CONS_DATE 10 ● BlankManagement model.

● YYYYMMIndicates the month and year of the consolidation.

Flow Dimension


The flow type dimension is optional but its use is highly recommended. This dimension allows you to track changes within the account activities, such as opening balance, additions, subtraction, and currency translation adjustments. If you do not require this level of detail, leave the business rule tables blank for the sub-table field. Flow is similar to the movement type in SAP ERP.

If Flow is included in the model, it can be used in the following ways:

● The currency translation procedure can detail the changes in the balance sheet generated by fluctuations in the exchange rates

● The consolidation procedure can detail the eliminations applied to the movements of the balance sheet accounts

Any dimension that is assigned the type S is considered a Flow dimension.

If you choose to use a flow type dimension, the following properties are required:


FLOW_TYPE 12 ● OPENING - opening● TRANSLOPE - change diff on open

ing● ALLOCINC - allocation● MERGER - merger● INCOME - net income from the pe

riod● CHANGE - variation.● TRANSFER - transfer● TRANSFLOW - translation change

on flow● VARSCP - variation in scope (ge

neric)● VARSCPMETH - variation in scope

method● VARSCPPERC - variation in scope

percentage● VARSCPNEW - variation in scope;

new company● VARSCPLEAV - variation in scope

sold company● CLOSING - closing● NONE - no flow● Blank - all other flows

DIMLIST 20 Used to group the flows for several business rules

Flow dimensions should contain dimension members that require the following FLOW_TYPE property values:

● OPENING● CLOSING

124 PUBLIC


Administration

● VARSCP

Activities

● To manage dimension members and their property values:

1. In the navigation panel, go to Administration and under the Modeling section, choose Dimensions.2. Select the row containing the dimension member required:

○ To manage dimension members, click Edit Members○ To manage the property values, click Edit Structure

10.4.4 Create or Modify the Model

Create the model for performing consolidation tasks.

Features

The consolidation engine leverages the following models to retrieve the information necessary to perform its calculations:

● Legal or MAINThis is the main model containing all financial data. All consolidation postings such as eliminations, currency conversions and minority interest calculations are posted in this model.

● OWNERSHIPThe consolidation process uses an OWNERSHIP model, to store the definitions of each consolidation parameter. In particular, such definitions may include:○ The list of companies being consolidated in each group○ The consolidation method used in each case○ The consolidation percentage for each case○ The ownership percentage (how much of each is owned by the group)○ The control percentage (how much of each is controlled by the group)

● RATEThis contains all currency exchange rates for the different rate types such as average, and sport rate. The currency conversion process uses a RATE model to look up the appropriate exchange rates for each relevant currency.Currency translation can run on any type of reporting model. Currency conversion applies to both financial and legal consolidation models to which a corresponding RATE model has been referenced, under the condition that the reporting model contain currency (type R) dimension. The currency dimension in a rate model does not need to have the REPORTING property.

The MAIN, RATE, and OWNERSHIP models can be named as desired. Within the same environment, multiple MAIN models may exist, each one pointing to its own RATE and OWNERSHIP models. Multiple MAIN models can also share the same RATE or OWNERSHIP models, if appropriate.


The RATE or OWNERSHIP model associated with a given reporting model is defined when a new consolidation type model is created.

NoteYou can report on non-reporting model data, but you cannot assign work status codes to the data. In addition, you cannot define business rules to these model types.

Each one of the above models must contain some required dimensions, while some other dimensions are optional. The required and optional dimensions are based on the standards used in the business rules. Other dimensions can coexist in a reporting model but do not impact the business rule function. For more information, see Dimension Setup in Dimension Library [page 114].

The four required dimensions are ENTITY, CATEGORY, TIME, and ACCOUNT. They can be renamed as desired. Here are some of the common requirements for these dimensions:

● The CATEGORY and TIME dimensions can be the same across the MAIN, RATE, and OWNERSHIP models. Alternatively, they must contain the appropriate matching members.

● The ENTITY dimension of the MAIN model can be the same as that used in the OWNERSHIP model or it must contain the appropriate matching members if different.

● The GROUP dimension used must be the same in the OWNERSHIP model and the MAIN model.

Generally in most cases, it is recommended that you use the same dimensions across models as it is easier to maintain.

Activities

Associate the desired RATE and OWNERSHIP models with the consolidation model and select all the consolidation business rules that need to be implemented. You can select from the following list of business rules:

● Currency conversionConversion of local currency data to the desired reporting currencies.

● CalculationsTo calculate and store amounts which are required for purposes of account-based calculations.

● Intercompany bookingsMatching intercompany transactions

● US EliminationsSpecifically designed to address the posting of intercompany eliminations in simpler scenarios where a full legal consolidation model is not required

● Carry ForwardInitialization of beginning balances when a new fiscal cycle starts

● ValidationValidation of input data

● Eliminations and AdjustmentsGeneration of all the consolidation entries for the desired groups of entities (for example: eliminations, adjustments, reclassifications and minority calculations.)

Consolidation business rules allow the automated processing of data to render a consolidated set of financial statements. This is commonly thought of as eliminations of investments in subsidiaries, adjustments of

126 PUBLIC


Administration

minority interest, reclassifications and any other postings depending on the nature of the consolidation methodologies required.

Select only the desired dimensions required for legal consolidation and deselect any others.

Set dimensions to be included in the consolidation model and also set the secured dimension to control the security through SAP Business Planning and Consolidation member access profiles.

Normally the Entity and Category dimensions are set as secured dimensions for member access control.

The Group dimension stores group currency, reporting currency and consolidation groups. The MAIN InfoProvider must contain a CURRENCY dimension to store the translated amounts. The consolidation entries, as generated by the consolidation process, are also stored by Group dimension.

Any additional dimension is optional in the MAIN InfoProvider, as far as the currency translation is concerned. For consolidation purposes, however, there are some other requirements. These are described below:

● The model may have an Intercompany dimension.● The model may have a FLOW dimension. This dimension is optional, but, if it exists, it can be used by the

following procedures:○ The currency translation procedure details the changes in the balance sheet generated by fluctuations

in the exchange rates.○ The consolidation procedure details the eliminations applied to the movements of the balance sheet

accounts.● An Audit dimension may exist in the MAIN InfoProvider, but it is not required by the currency translation. If

it exists, however, the currency translation can recognize which members of the dimension should be translated, and which ones should just be copied as is to the destination currency. However, this dimension is required for the consolidation procedure to work.

Additional (user defined) dimensions can be added to the MAIN InfoProvider (such as product, market, or division), as desired. The consolidation engine can recognize their existence and take them into account in the process, and apply custom behavior to their members.

10.4.5 Business Rule Setting

SAP Business Planning and Consolidation delivers predefined functions to calculate and post amounts required to support common accounting activities, such as currency translation as well as matching and elimination of inter-unit balances.

Features

For each predefined data package and script logic, there are one or more business rule tables, in which a business user can configure rules. The consolidation engine uses these rules to perform all the appropriate calculations on a user-selectable region of data, and write the calculated results into the database

Business rules provide the flexibility for a business user to customize the delivered logical functions, to meet specific business needs, without having to understand either scripting or programming.

To run these programs, use the Data Manager packages.


The following table lists the consolidation process tasks and the corresponding business rules:

Consolidation Task Process Chain Name Script Logic Files Name Business Rule Name

Balance carry forward /CPMB/OPENING_BA LANCES

COPY_OPENING.LGF Carry-forward rules

Currency translation /CPMB/FX_RESTATM ENT FXTRANS.LGF Currency translation rules

Intercompany reconciliation /CPMB/ICDATA ICDATA.LGF No rules needed

Intercompany balance booking

/CPMB/ICBOOKING ICBOOKING.LGF Intercompany booking

Legal consolidation

(elimination and adjustment)

/CPMB/LEGAL_CONS OLIDATION

CONSOLIDATION.LGF Eliminations and adjustments and details

Account calculation

(cash flow function)

/CPMB/RUNCALCAC COUNT

CALCACCOUNT.LGF Account-based calculation

US widely used

Intercompany elimination

/CPMB/IC_ELIMINATI ON ICELIM.LGF US elimination

Equity Pick Up /CPMB/EQUITY_PICKUP EQUITYPICKUP.LGF Equity Pick Up

For each process, the predefined Data Manager packages with their associated logic scripts and rule tables are executed, performing the consolidation task according to the business rule customization. Any specific business requirement needs to be configured in the corresponding business rule.

10.4.6 Execute Consolidation Task

Data Manager packages allow you to manage data within SAP Business Planning and Consolidation models and dimensions.

Context

Data Manager packages are implemented as process chains and allow common data manipulation activities. The packages that come with SAP Business Planning and Consolidation are designed to be dynamic so you do not need to modify the packages for them to work with your models and dimensions.

128 PUBLIC


Administration

The Financial packages that can be used for the consolidation process, apart from the Standard and Administrative packages, are in the following table:

Process Chain Template Description Technical Name

Planning and Consolidation Default Formulas Logical

Executes default formulas stored in your default.xls file.

/CPMB/DEFAULT_FORMULAS

Planning and Consolidation FX Restatement

Allows you to perform currency translation. The package runs the FXTrans logic.

/CPMB/FX_RESTATMENT

Planning and Consolidation IC Elimination

Allows you to perform intercompany eliminations. The package runs the ICElim logic.

/CPMB/IC_ELIMINATION

Planning and Consolidation: ICBooking Runs the ICBooking logic. /CPMB/ICBOOKING

Planning and Consolidation ICData Runs the ICData logic. /CPMB/ICDATA

Planning and Consolidation Legal Consolidation

Runs the LegalConsolidation logic. /CPMB/LEGAL_CONSOLIDATION

Planning and Consolidation Opening Balances

Runs the OpeningBalances logic. /CPMB/OPENING_BALANCES

Planning and Consolidation Run CalcAccount

Runs the CalcAccount logic. /CPMB/RUNCALCACCOUNT

Planning and Consolidation Clear the Journal Tables

Clears journal tables and creates an output file.

/CPMB/CLEAR_JOURNALS

Planning and Consolidation Export the Journal Tables

Exports journal tables to an output file /CPMB/EXPORT_JOURNAL

Planning and Consolidation Restore Journal Tables

Allows you to load journal tables from a file

/CPMB/RESTORE_JOURNALS

Procedure

1. Add the Data Manager packages for a consolidation model:

For more information, see the application help for SAP BusinessObjects Analysis, edition for Microsoft Office available on the SAP Help Portal.

2. Create Script Logic files (LGF).

Script Logic allows users to define formulas that perform calculations on SAP Business Planning and Consolidation members and data.



You can create the following different types of logic:

○ Dimension Member Formulas;○ Script logic.

Each type has advantages and disadvantages. Logic is model-specific and all script logic statements are case-insensitive.

1. In the navigation panel, go to Administration and under the Rules section choose Logic Scripts.2. Select Scripts for CONSOLIDATION and click Open.3. Click New.4. Create an LGF file by using the script logic supported by SAP Business Planning and Consolidation.

NoteThe Logic File name must be identical to the string defined with the data package.

3. Maintain the business rule table.

SAP Business Planning and Consolidation delivers predefined functions designed to calculate and post amounts required to support common accounting activities such as:

○ Currency translation○ Matching and elimination of inter-unit balances.

To allow a customer the flexibility to customize these functions to meet specific requirements table-based logic is used.

For each predefined function, there are one or more Business Rule tables, in which the business user can configure rules such as:

○ What balances should be read in order to calculate an amount to be posted.○ What are the posting rules for the calculated amount (meaning, to what account and data source is the

calculated amount posted).

Table-based logic (Business Rules) provides the flexibility for a customer to customize delivered functions (logic), to meet specific business needs, without having to understand either scripting or programming.

The following Business Rule (table-based logic) functions are delivered with SAP Business Planning and Consolidation:

Currency Translation Convert local currency data into the desired reporting currencies

Account-based Calculations Calculate and store amounts, which are required for purposes of account-based calculations

Intercompany Bookings Match intercompany transactions

US Eliminations US eliminations

Specifically designed to address the posting of intercompany eliminations in simpler scenarios where a full legal consolidation model is not required.

130 PUBLIC


Administration

Carry-Forward Initialize the opening balances when a new fiscal cycle starts

Eliminations and adjustments Generate all the consolidation entries for the desired groups of entities (such as eliminations, adjustments, reclassifications, and minority calculations)

The procedure to maintain the business rules is as follows:

1. In the navigation panel, go to Administration and under the Rules section choose Business Rules.2. Select the CONSOLIDATION Model and click Add/Remove Rule Types in the toolbar.3. In the Add/Remove Rule Types dialog box, select the rule types you require and click OK.4. Click the business rule type under the CONSOLIDATION model in the table grid.

Alternately, select the row of the business rule and click Open in the toolbar.5. In the Business Rule Editor, click New to create a new rule, or select an existing rule and click Edit in the

toolbar to modify the content of an existing rule according to business requirements.

10.4.7 Loading Data

Procedure

1. Load the exchange rate to the RATE model.

The RATE model stores the exchange rates for currency translation. There are several ways to upload the data to the RATE model, such as using the Data Manager import package, or using dynamic templates to send data from the input schedule. For more information, see Currency Translation Rule [page 196].

2. Input ownership data and calculate ultimate ownership.

SAP Business Planning and Consolidation, version for SAP BW/4HANA, provides an ownership-based hierarchy editor in Consolidation Central so you can update the OWNERSHIP model directly.

3. Load the financial data.

After loading the financial data, use an SAP Business Planning and Consolidation report to validate that the numbers loaded reconcile with the numbers in the source system.

10.4.8 Journal Definition and Validation Setting

Journals allow users to make adjustments to data in the database, typically as part of the month-end or quarter-end process. During the review and analysis step, journals allow users to capture an audit trail of changes and adjustments made to the database. The purpose of validation is to prevent incorrect records being saved to the DataStore Object (advanced).


Features

Journal Template Definition

The primary requirement for journals is to track changes to data after the initial source data is input into the model. For example, the general ledger information is loaded into the model through the Data Manager. The model users can adjust this data and also track and report on the changes by, for example, amount, date, and user. Once a journal template is created, neither the dimension nor the data in the model can be deleted from the model.

For information about setting up journals and defining a journal template, see the related links below.

Validation Setting

Validations are designed to prevent incorrect DataStore Object (advanced) intersections from being saved. You cannot get data into a DataStore Object (advanced) without going through the Write-Back module. Therefore, validations are implemented in write-back, to ensure that invalid records cannot get into the DataStore Object (advanced) from any source, including journals, Data Manager packages, and manual data input. For example, a specified intercompany account with an empty Trading Partner dimension is blocked from being written into the DataStore Object (advanced).

To customize validation, in the SAP ABAP system enter the transaction code UJ_VALIDATION to configure the validation framework and customize the validation rules according to your business requirements. For more information, see Breakdown Validation.

CautionIf you have already created a journal template, creating a new template that changes the structure of the journal entries deletes the old template and all journal entries associated with that template. This removes your audit trail, even though changes made to the model data through posted journal entries are maintained. If you recreate the journal template, but do not change the structure of the template keeping all header and detail dimensions the same, you have the option to keep the existing journal entries.

Related Information

Journal Administration [page 256]Journal Template Creation [page 256]Example of Journal Validation [page 132]

10.4.8.1 Example of Journal Validation

After loading general ledger data into a model using Data Manager, the processor should be able to review the data and use journal entries to make adjustments if there is any correction or reclassification needed.

When journal entries are saved and posted, all adjustments to data can be tracked and reported on. For example, it is possible to run reports on the changes by amount, date, user, and several other properties to review and analyze.

132 PUBLIC


Administration

Validations, on the other hand, are designed to prevent incorrect records from being saved to the DataStore Object (advanced). The user controls what is deemed an incorrect record. An example of an incorrect record is one where you have specified an intercompany account, but you have left the Trading Partner dimension empty.

Related Information

Journal Definition and Validation Setting [page 131]

10.5 Rules

Perform data calculations using business rules and logic.

Business rules are parameter-driven functions within models for calculating and posting monetary amounts in support of common accounting activities. With logic, you define formulas that perform calculations on dimension members and data.

More Information

Member Formulas [page 134]Script Logic [page 140]

US Eliminations as Script Logic [page 188]Carry-Forward as Script Logic [page 189]Intercompany Booking as Script Logic [page 190]Currency Conversion as Script Logic [page 191]Account-based Calculations as Script Logic [page 193]Business Rules Management [page 194]Controls [page 215]


10.5.1 Member Formulas

Member formulas allow you to create and execute formulas and calculations on dimension members.

Prerequisites

The Enable Member Formulas option is selected for the dimension to which you are applying the member formula. See Dimension Properties [page 88].

Features

Use the following guidelines when implementing formulas:

● The system calculates formulas at retrieval time. Formulas can slow retrieval performance if used incorrectly.

● Implement member formulas only for members that need calculating after aggregations, such as ratios. Do not use formulas on members that need to aggregate.

● Use formulas only for ratios that need to be calculated at both the base and parent level. If the resulting value is aggregated to the parent, use logic scripts to write the results to the database.

You cannot reference MDX functions, also known as user-defined functions, from a library file.

For information about restrictions pertaining to member formulas, see 1356081 .

Activities

You can view the member formulas added to a dimension in the administration panel, by choosing Member Formulas, under the Rules section, and then choosing the name of a dimension.

You can add a formula to a dimension, as well as edit and delete a formula assigned to a dimension.

134 PUBLIC


Administration


10.5.1.1 MDX Formula Syntax

The basis for a dimension and advanced rule formulas is the multi-dimensional expression language called MDX.

Features

You can use the following features of MDX formula syntax:

Syntax basics

● You can write the dimension ID using both uppercase and lowercase letters case, and the member ID should be the identical case of the member.

● You must enclose all member IDs in [square brackets].● You must fully-qualify all member IDs, preceded by the names of their related dimension enclosed in

square brackets, unless the dimension is ACCOUNT, in which case you may omit the dimension name.

MDX syntax exceptions

The following are exceptions to MDX syntax:

● Replace the keyword AS with an equal (=) sign.● Do not use single quotes around expressions.

Note that the following structure is the normal syntax for calculated members required by MDX queries:

{member} = {expression}[, solve_order = n]

The only exceptions are the equal sign (=) in place of the “AS” keyword and the lack of single quotes around the expression.

More Information

For examples of simple MDX formulas that can be used in the Formula column for an account, see Simple Rule Formula Examples [page 136].

For examples of movement calculations and allocating expenses based on entity type, see Advanced Rule Formula Examples [page 137].


10.5.1.1.1 Simple Rule Formula Examples

The following are examples of simple MDX formulas that can be used in the Formula column for an account.

Task Syntax and Example

Adding two accounts Syntax:

[DIMENSION].[ACCOUNT1] + [DIMENSION].[ACCOUNT2]

ExamplePreTax Income:

[ACCOUNT].[OPERATING INCOME] + [ACCOUNT].[OTHEREXP].

Adding a range of accounts Syntax:

[DIMENSION].[ACCOUNT1]:[DIMENSION].[ACCOUNT2]

ExampleTotal Personnel Exp:

SUM([ACCOUNT].[SALARIES]:[ACCOUNT].[COMMISSION])

Calculating a percentage Syntax:

[DIMENSION].[ACCOUNT1] / [DIMENSION].[ACCOUNT2]

or (to prevent division by zero):

IIF([DIMENSION].[ACCOUNT1] = 0, NULL, [DIMENSION].[ACCOUNT2]/[DIMENSION].[ACCOUNT1])

ExampleGross Margin Pct:

IIF([ACCOUNT].[REVENUE] = 0, NULL, [ACCOUNT].[GROSS MARGIN]/[ACCOUNT].[REVENUE])

Multiplying by a factor Syntax:

[DIMENSION].[ACCOUNT1]*[DIMENSION].[ACCOUNT2]

ExampleTaxes:

[ACCOUNT].[PRETAX INCOME] * -0.35

136 PUBLIC


Administration

Task Syntax and Example

Calculating a YTD value Syntax:

[DIMENSION].[ACCOUNT1],[MEASURES].[YTD]

ExampleCurrent Year Net Income:

([ACCOUNT].[NET INCOME], [MEASURES].[YTD])

Any software coding and/or code lines / strings ("Code") included in this documentation are only examples and are not intended to be used in a productive system environment. The Code is only intended to better explain and visualize the syntax and phrasing rules of certain coding. SAP does not warrant the correctness and completeness of the Code given herein, and SAP shall not be liable for errors or damages caused by the usage of the Code, except if such damages were caused by SAP intentionally or by its gross negligence.

10.5.1.1.2 Advanced Rule Formula Examples

Advanced rule formulas include movement calculations and expense allocation based on entity type.

Features

You can use the following features of advanced rule formulas:

Movement calculations

Movement calculations define the copying or movement of data from one time period to another. In the formula examples below, [ AccRec] is the accounts receivable account, and [ AccPay] is the accounts payable account.


Example

Account Description Formula

Mvmt Acc Rec Movement in Accounts Receivable

IIF([TIME].CURRENTMEMBER.PROPERTIES("CALC")="N", [ACCOUNT].[ACCREC] - ([ACCOUNT].[ACCREC], [TIME].PREVMEMBER), SUM(DESCENDANTS([TIME].CURRENTMEMBER, 20, LEAVES)))

With the formula, you are checking whether the current TIME member is parent or not by checking the property CALC = N. If it is not a parent, then we take the current TIME member's Account Receivables (ACCREC) and subtract the previous month's Account Receivables. If the current TIME member is parent, then you simply sum up all of the children.

Mvmt Inventory

Movement in Inventory

IIF([TIME].CURRENTMEMBER.PROPERTIES("CALC")="N", [ACCOUNT].[INVENTORY] - ([ACCOUNT].[INVENTORY], [TIME].PREVMEMBER), SUM(DESCENDANTS([TIME].CURRENTMEMBER, 20, LEAVES)))

The formula checks inventory.

Mvmt Acc Pay Movement in Accounts Payable

IIF([TIME].CURRENTMEMBER.PROPERTIES("CALC")="N", [ACCOUNT].[ACCPAY] - ([ACCOUNT].[ACCPAY], [TIME].PREVMEMBER), SUM(DESCENDANTS([TIME].CURRENTMEMBER, 20, LEAVES)))

Mvmt Work Cap Movement in Working Capital

SUM([ACCOUNT].[MVMT ACC REC]:[ACCOUNT].[MVMT ACC PAY])

Nested formula is only supported by SAP HANA MDX.

Allocating expenses based on entity type

The following examples assume there is an Entity property named Function. If an entity has the function SM, the Total Department Expense is allocated to the S&M Exp account. If an entity has the function RD, the Total Department Expense is allocated to the R&D Exp account. If an entity has the function CORP, the Total Department Expense is allocated to the G&A Exp account.

138 PUBLIC


Administration

Example

Account Description Formula

S&M Exp Sales & Marketing Expense IIF([ENTITY].CURRENTMEMBER.PROPERTIES("CALC")="N", IIF([ENTITY].CURRENTMEMBER.PROPERTIES ("FUNCTION")="SM",[ACCOUNT].[TOTAL DEPT EXP], NULL), SUM(DESCENDANTS([ENTITY].CURRENTMEMBER, 20, LEAVES)))

You first check if the current ENTITY member is parent or not. Then, you read the property FUNCTION of the current ENTITY member to see whether it is "SM" or not. If it is "SM", then, you are taking the Total Department Expense as a Sales & Marketing expense. Otherwise, it will be assigned with zero. If current ENTITY is parent, a sum of all children appears.

R&D Exp R&D Expense IIF([ENTITY].CURRENTMEMBER.PROPERTIES("CALC")="N", IIF([ENTITY].CURRENTMEMBER.PROPERTIES ("FUNCTION")="RD",[ACCOUNT].[TOTAL DEPT EXP], NULL), SUM(DESCENDANTS([ENTITY].CURRENTMEMBER, 20, LEAVES)))

In this formula, you are taking the "RD" values of FUNCTION property.

G&A Exp G&A Expense IIF([ENTITY].CURRENTMEMBER.PROPERTIES("CALC")="N", IIF([ENTITY].CURRENTMEMBER.PROPERTIES ("FUNCTION")="CORP", [ACCOUNT].[TOTAL DEPT EXP], NULL), SUM(DESCENDANTS([ENTITY].CURRENTMEMBER, 20, LEAVES)))



10.5.1.1.3 Nested Formulas

In a nested formula, a given part of that formula is calculated by another formula.

The functionality described in this topic applies only to systems based on SAP HANA, which enhances capabilities and improves performance of SAP Business Planning and Consolidation. If you are not using an SAP HANA-based system, disregard the information in this topic.

Prerequisites

You must have the SAP HANA Component for Business Planning and Consolidation HANABPC SP05 installed on your system.

Use

You can create a nested formula in which the different parts of that formula are calculated by other formulas.

ExampleA = B + C

B = D - 6

C = F * E

In the example above, the formula A is calculated by B and C. In turn B and C are also calculated by formulas.

Nested formulas are only supported by the HANA MDX engine. The HANA MDX engine significantly improves the performance when executing complex calculations on large amounts of data.

10.5.2 Script Logic

Script logic is a feature that allows you to create files called logic scripts containing instructions for performing calculations on planning and consolidation data

Features

You can perform logic calculations on base level members only. In addition, logic is specific to each model.

Business Planning and Consolidation provides a library of MDX formulas, and the EnvironmentShell sample environment contains a number of logic functions.

140 PUBLIC


Administration

NoteLogic keywords are not case-sensitive. However, all environment, model, dimension, and member names in K2 are case-sensitive.

You have the following two files for each piece of script logic you create:

● An .LGF file, which is an ASCII file you create and edit when setting up logic calculations. You access the .LGF file through the logic editor.

● An .LGX file, which is the compiled logic file created by the system when you validate and save your logic. This is an executable version of the .LGF file that is not stored in Business Planning and Consolidation.

Default logic is a special logic statement that is executed on every writeback to a model. All logic in Default.LGF is run after data sends. Data is first committed to the model and then, Default.LGF is run on model data. Having all of your logic in the Default.LGF logic file might become unmanageable. Therefore you can create other logic files, such as FXTrans.LGF for foreign currency translation and ICElim.LGF for intercompany eliminations. Your default logic can contain an INCLUDE statement to execute specific logic in real-time, such as currency translation if desired, rather than having to run a separate batch process.

You access logic files from the Script Logic subdirectory within the hierarchy of a model.

Logic Library

Business Planning and Consolidation has a library of standard logic functions available for your use. The file has the extension .LGF, which can be called at validation by using the INCLUDE function in your logic file. The logic module scans the library file for the appropriate formulas to use based on the information in the .LGF file.

The following are examples of logic delivered with Business Planning and Consolidation:

● Allocation.lgf: runs an allocation● Calcaccount.lgf: used to prepare Cash Flow; runs an Account Calculation business rule● Consolidation.lgf: used to run a Legal Consolidation business rule● Copy_Opening.lgf: used to run a Balance Carry Forward business rule● FX_Trans.lgf: used to run currency conversion● ICBooking.lgf: used for running Intercompany reconciliation and difference posting● ICData.lgf: used to run Intercompany reconciliation● ICElim.lgf: used to run Intercompany reconciliation● MDXlib.lgf: library of MDX financial functions● System_Constants.lgf: stores constant values for use within script logic. See the System Constants File

section that follows for more information.● System_Library.lgf: includes basic examples of a set of keywords● Validation.lgf: used for running a Validation rule

System Constants File

The system constants file is the logic file that maps your dimension names for a model to the standard Business Planning and Consolidation logic. By updating the dimension constants file with your dimensions, you avoid having to change or rewrite any of the standard functions that are included with Business Planning and Consolidation.

The system constants file is located in the \\root\Webfolders\ <Environment>\systemlibrary\logiclibrary folder. You can edit this file using download and upload functions from transaction UJFS in the ABAP interface.


Running Script Logic

Script logic can be automatically invoked each time the system sends data to the database. Instructions in the default logic file are executed immediately after data is sent and you can see the results immediately. Script logic can be run from Data Manager for batch processing of formulas. Using Data Manager to execute Logic module formulas is useful for calculations that do not need to be executed immediately. For example, you may decide to wait until all data has been entered in the local currency before generating the translated amounts in reporting currencies.

Activities

From the Planning and Consolidation Administration screen, you can view all logic scripts for a model by choosing Logic Scripts under the Rules section. After that select a model and choose Open. All logic scripts that have been set up for that model display.

You can create a new logic script for the selected model by choosing New, then assigning a name to the logic script. You can type directly into the logic editor. You can also insert Business Planning and Consolidation keywords, MDX keywords, dimension names, and member names from the dropdown lists, replacing variables in the keywords as appropriate. To add a keyword from the dropdown lists to a line in a script, you can double-click on a keyword, you can select a keyword and then select Insert Keyword, and you can drag and drop a keyword from the dropdown list into a line in the logic editor.

You can comment out and uncomment blocks of script logic, as well as individual lines, in the logic editor.

When you create new logic script and edit an existing script, you can validate its syntax. Any problems with the logic display in the lower portion of the logic editor with line numbers to make locating and resolving the problems easier.

You can copy an existing logic script by selecting a file, then providing a name for the new script, and modifying it as you need.

You can use the following color coding in the logic editor to assist in writing and troubleshooting logic scripts:

● Keywords display in blue● Constant values display in green● Comments display in grey● Incorrect syntax, such as parenthesis errors, misspelled keywords and dimension names, and

unrecognized words, displays in red

You can easily resolve errors in script logic using the error lines in the lower portion of the logic editor window. Errors in a script appear by line number.

More Information

For more detailed documentation of script logic and examples, see the Enterprise Performance Management (EPM) How-to Guides section of the SAP SDN at: http://wiki.sdn.sap.com/wiki/display/BPX/Enterprise+Performance+Management+%28EPM%29+How-to+Guides .

142 PUBLIC


Administration

http://help.sap.com/disclaimer?site=http%3A%2F%2Fwiki.sdn.sap.com%2Fwiki%2Fdisplay%2FBPX%2FEnterprise%2BPerformance%2BManagement%2B%2528EPM%2529%2BHow-to%2BGuides

http://help.sap.com/disclaimer?site=http%3A%2F%2Fwiki.sdn.sap.com%2Fwiki%2Fdisplay%2FBPX%2FEnterprise%2BPerformance%2BManagement%2B%2528EPM%2529%2BHow-to%2BGuides

Related Information

Library of MDX Functions [page 143]Logic Keyword Reference [page 149]

10.5.2.1 Library of MDX Functions

Business Planning and Consolidation provides several multidimensional expressions ( MDX) functions you can use in your dimension rule formulas. You can also use some of these MDX functions in advanced rule formulas.

A majority of the MDX functions define industry-standard financial ratios. You can use ratios to evaluate the performance of your business and identify potential problems. Ratios expose factors such as the earning power, solvency, efficiency, and debt load of your business.

The following table describes some of the more common MDX functions:

MDX Function Description Parameters

Ancestor Returns the ancestor of a member at a specified level

<Member>, <Level>

ClosingPeriod Returns the last sibling among the descendants of a member at a level

[<Level>[, <Member>] ]

Cousin Returns the member with the same relative position under a member as the member specified

<Member1>, <Member2>

Current Member Returns the current member along a dimension during an iteration

(none)

Default Member Returns the default member of a dimension (none)

FirstChild Returns the first child of a member (none)

FirstSibling Returns the first child of the parent of a member (none)

IsEmpty Determines if an expression evaluates to the empty cell value

<Expression>

Item Returns a member from a tuple <Numeric Expression>

Lag Returns a member prior to the specified member along the member's dimension

<Numeric Expression>

LastChild Returns the last child of a member (none)

LastSibling Returns the last child of the parent of a member (none)



Lead Returns a member further along the specified member's dimension

<Numeric Expression>

Members Returns the member whose name is specified by a string expression

(none)

NextMember Returns the next member in the level that contains a specified member

(none)

OpeningPeriod Returns the first sibling among the descendants of a member at a level

[<Level>[, <Member>] ]

ParallelPeriod Returns a member from a prior period in the same relative position as a specified member

[<Level>[, <Numeric Expression>[, <Member>] ] ]

Parent Returns the parent of a member (none)

PrevMember Returns the previous member in the level that contains a specified member

(none)

Aggregate Returns a calculated value using the appropriate aggregate function, based on the context of the function

<Set>[, <Numeric Expression>]

Avg Returns the average value of a numeric expression evaluated over a set


CoalesceEmpty Coalesces an empty cell value to a number <Numeric Expression>[, <Numeric Expression>...]

Correlation Returns the correlation of two series evaluated over a set

<Set>, <Numeric Expression>[, <Numeric Expression>]

Count Returns the number of tuples in a set, empty cells included unless the optional EXCLUDEEMPTY flag is used

<Set>[, EXCLUDEEMPTY | INCLUDEEMPTY]

IIf Returns one of two values determined by a logical test

<Logical Expression>, <Numeric Expression>, <Numeric Expression>

LinRegIntercept Calculates the linear regression of a set and returns the value of b in the regression line y = ax + b


LinRegPoint Calculates the linear regression of a set and returns the value of y in the regression line y = ax + b

<Numeric Expression>, <Set>, <Numeric Expression>[, <Numeric Expression>]

LinRegR2 Calculates the linear regression of a set and returns R2 (the coefficient of determination)


144 PUBLIC


Administration


LinRegSlope Calculates the linear regression of a set and returns the value of a in the regression line y = ax + b


LinRegVariance Calculates the linear regression of a set and returns the variance associated with the regression line y = ax + b


Max Returns the maximum value of a numeric expression evaluated over a set


Median Returns the median value of a numeric expression evaluated over a set


Min Returns the minimum value of a numeric expression evaluated over a set


Sum Returns the sum of a numeric expression evaluated over a set


For additional NW BI MDX keywords, run function module BAPI_MDPROVIDER_GET_FUNCTIONS via transaction SE37.

10.5.2.1.1 Custom Logic and BADI

You use this instruction to call any custom ABAP programming you have written.

Activities

Run the following instruction to call custom ABAP programs:

*CALL_CUSTOM_LOGIC <filter_value_of_the_BADI>

where filter_value_of_the_BADI is the name of the filter you provided during the BADI implementation of UJ_CUSTOM_LOGIC BADI.

Custom logic example

*CALL_CUSTOM_LOGIC COMPLEX_ALLOCATION

BADI examples

*START_BADI / *END_BADI call any custom ABAP programming written using UJ_CUSTOM_LOGIC BADI (Transaction SE19) and allow you to export parameters to ABAP codes in the BADI.

Syntax

*START_BADI <filter_value_of_your_BADI_implementation>


<key1> = <value1>

<key2> = <value2>

*END_BADI

where filter_value_of_your_BADI_implementation is the name of the filter you provided during the BADI implementation of UJ_CUSTOM_LOGIC BADI.

Syntax example

The following example shows how to call an implemented BADI, with CALC_ACCT as the filter value, for adding two accounts to a destination account:

*START_BADI ROUND

DECIMAL = 2

*END_BADI

The DECIMAL parameter is visible in the IT_PARAM internal table inside the EXECUTE method. In the EXECUTE method, you can write custom code to change the incoming transactional data of CT_DATA.

Optional Parameters

You can use the following optional parameters within a *START_BADI / *END_BADI instruction:

● Query - Performs the default query. Valid values are On, the default, and Off. Set Query to Off if you want to perform your own query.

● Write - Automatically writes back the data. Valid values are On, the default, and Off.

Example

Implementing code (in EXECUTE method of the implemented class) for declining depreciation

NoteBefore you can use a BADI in script logic, implement UJ_CUSTOM_LOGIC BADI from transaction SE19. See the ABAP online help at http://help.sap.com/saphelp_nw70/helpdata/en/32/a83942424dac04e10000000a1550b0/content.htm . for information on how to implement a BADI.

METHOD if_uj_custom_logic~execute.

DATA: ls_param TYPE ujk_s_script_logic_hashentry,

l_log TYPE string,

l_ast_acct(16) TYPE c,

l_year(3) TYPE n,

l_percentage(3) TYPE p,

lo_model TYPE REF TO if_uj_model,

lo_dim TYPE REF TO if_uja_dim_data,

ls_dim TYPE uja_s_dim,

146 PUBLIC


Administration

http://help.sap.com/disclaimer?site=http%3A%2F%2Fhelp.sap.com%2Fsaphelp_nw70%2Fhelpdata%2Fen%2F32%2Fa83942424dac04e10000000a1550b0%2Fcontent.htm

http://help.sap.com/disclaimer?site=http%3A%2F%2Fhelp.sap.com%2Fsaphelp_nw70%2Fhelpdata%2Fen%2F32%2Fa83942424dac04e10000000a1550b0%2Fcontent.htm

time_dim(16) TYPE c,

lr_rec TYPE REF TO data,

lr_result_rec TYPE REF TO data,

l_intermediate_value TYPE uj_sdata,

lt_final TYPE REF TO data.

FIELD-SYMBOLS: <ls_rec> TYPE ANY,

<ls_result_rec> TYPE ANY,

<ls_time> TYPE ANY,

<ls_signed.data> TYPE ANY,

<lt_final> TYPE STANDARD TABLE

* Make sure all the parameters are passed.

CLEAR ls_param.

READ TABLE it_param WITH KEY hashkey = 'YEAR' INTO ls_param.

IF sy-subrc NE 0.

l_log = 'You have not specified the parameter ''YEAR'' which is required.'.

cl_ujk_logger=>log( i_object = l_log ).

RAISE EXCEPTION TYPE cx_uj_custom_logic.

EXIT.

ENDIF.

l_year = ls_param-hashvalue.

CLEAR ls_param.

READ TABLE it_param WITH KEY hashkey = 'PERCENTAGE' INTO ls_param.

IF sy-subrc NE 0.

l_log = 'You have not specified the parameter ''PERCENTAGE'' which is required.'.

cl_ujk_logger=>log( i_object = l_log ).

RAISE EXCEPTION TYPE cx_uj_custom_logic.

EXIT.

ENDIF.

l_percentage = ls_param-hashvalue.

* Get name of the account dim

cl_uj_model=>get_model( EXPORTING i_appset_id = i_appset_id

RECEIVING ro_model = lo_model ).

CALL METHOD lo_model->get_dim_data_by_type


EXPORTING

i_dim_type = uj00_cs_dim_type-time

i_appl_id

= i_appl_id

RECEIVING

ro_dim_data = lo_dim.

TRY.

CALL METHOD lo_dim->get_info

IMPORTING

es_dim_info = ls_dim.

ENDTRY.

time_dim = ls_dim-dimension. TRANSLATE time_dim TO UPPER CASE.

CREATE DATA lt_final LIKE ct_data.

ASSIGN lt_final->* TO <lt_final>. CREATE DATA lr_result_rec LIKE LINE OF ct_data. ASSIGN lr_result_rec->* TO <ls_result_rec>. CREATE DATA lr_rec LIKE LINE OF ct_data. ASSIGN lr_rec->* TO <ls_rec>.

* Loop through incoming data and create a result set

LOOP AT ct_data ASSIGNING <ls_rec>.

<ls_result_rec> = <ls_rec>.

ASSIGN COMPONENT time_dim OF STRUCTURE <ls_result_rec> TO <ls_time>.

<ls_time>+0(4) = is <ls_time>+0(4) + l_year.

ASSIGN COMPONENT 'SIGNEDDATA' OF STRUCTURE <ls_result_rec> TO <ls_signeddata>.

DO l_year TIMES.

l_intermediate_value = l_intermediate_value + ( <ls_signeddata> - l_intermediate_value ) * l_percentage / 100.

ENDDO.

<ls_signeddata> = <ls_signeddata> - l_intermediate_value.

APPEND <ls_result_rec> TO <lt_final>.

ENDLOOP.

* Send the result data back.

NoteBusiness Planning and Consolidation always overwrites existing values.

ct_data = <lt_final>.

148 PUBLIC


Administration

ENDMETHOD.

Script logic file content to call the BADI:

*START_BADI DECD

QUERY = ON

WRITE = ON

YEAR = 1

PERCENTAGE = 10 *END_BADI

NoteET_MESSAGE in the BADI logs the messages to the Data Manager.

If you want to stop the execution, raise the cx_uj_custom_logic exception within a BADI implementation.


More Information

For instructions about creating an SAP Business Add-In, see the ABAP model help in the SAP NetWeaver Library.

10.5.2.2 Logic Keyword Reference

This reference contains descriptions of all the logic keywords you can use in this product.

More Information

*ADD / *ENDADD [page 150]*BEGIN / *END [page 151]*DESTINATION_APP [page 151]*FOR / *NEXT [page 154]*FUNCTION / *ENDFUNCTION [page 155]*INCLUDE [page 156]*REC [page 157]LOOKUP [page 160]


*RUNALLOCATION [page 163]*SELECT [page 174]*SELECTCASE / *ENDSELECT [page 174]*SUB( ) / *ENDSUB [page 176]*WHEN / *ENDWHEN [page 177]*XDIM_MEMBERSET [page 178]*XDIM_ADDMEMBERSET [page 180]*XDIM_MAXMEMBERS [page 180]*XDIM_PACKAGEBY [page 181]*XDIM_FILTER [page 182]*COMMIT [page 182]Special Keywords [page 183]TMVL Parameter [page 186]

10.5.2.2.1 *ADD / *ENDADD

This structure allows you to automatically cumulate a set of members to a calculated member as specified in a comma delimited range.

The range can be dynamically derived using a *SELECT( ) instruction. See *SELECT [page 174].

The syntax is:

*ADD {variable} = {set}

{formula}

*ENDADD

Example*ADD %ACC%=[CE0004010],[CE0004020],[CE0004030] [#CE0661000] = %ACC%/[CE0652000]

*ENDADD

*COMMIT

[#CE00661000] = [CE0661000]/[CE0652000]

The ADD statement expands into:

[P_ACCT].[#CE0661000] =[P_ACCT].[CE0004010]/[P_ACCT].[CE0652000]+[P_ACCT].[CE0004020]/[P_ACCT].[CE0652000]+[P_ACCT].[CE0004030]/[P_ACCT].[CE0652000]

NoteThe expression to the right of the equals sign ( = ) currently does not support more complex expressions.

Only one formula can be written inside the ADD/ ENDADD structure.

Any software coding and/or code lines / strings ("Code") included in this documentation are only examples and are not intended to be used in a productive system environment. The Code is only intended to better explain and

150 PUBLIC


Administration

visualize the syntax and phrasing rules of certain coding. SAP does not warrant the correctness and completeness of the Code given herein, and SAP shall not be liable for errors or damages caused by the usage of the Code, except if such damages were caused by SAP intentionally or by its gross negligence.

10.5.2.2.2 *BEGIN / *END

The BEGIN/ END structure can be used to split long formulas across multiple lines to improve readability.

The validation process trims and joins all lines between the BEGIN and END statements.

Example*BEGIN

[P_ACCT].[#CE0661000] =

[P_ACC].[CE0004010] + [P_ACCT].[CE0004020] + [P_ACCT].[CE0004030] )

[P_ACCT].[CE0652000]

*END


10.5.2.2.3 *DESTINATION_APP

The DESTINATION_APP keyword allows you to write the results of calculations to a different model.

Syntax

*DESTINATION_APP = {app name}

Often, the destination model shares only some of the dimensions of the original model. In this case, the missing dimensions can be dropped from the original records with the instruction:

*SKIP_DIM= {dimension name}[,{dimension name},…]

When the original model has dimensions that are not found in the destination model, the SKIP_DIM keyword is mandatory. Validation cannot pass without the SKIP_DIM keyword.

Multiple dimension names can be supplied to the instruction separated either by commas or by multiple SKIP_DIM instructions entered on separate lines.

If the destination model has dimensions that do not exist in the original model, these can be added to the passed records, using the instruction:

*ADD_DIM {dimension name}={value}[,{dimension name}={value} [, {dimension name} = {dimension name(source): Property name}, #]


Multiple dimension names and values can be supplied to the instruction separated either by commas or by multiple ADD_DIM instructions entered on separate lines. Dimension properties (dimension from the source model) are also supported.

Example:

To explain DESTINATION_APP with SKIP_DIM, ADD_DIM, and RENAME_DIM, another model DETAIL_PLAN is created by copying the PLANNING model from the delivered EnvironmentShell. It is necessary to do the following steps:

● Create new dimensions PRODUCT and MARKET and add these to the DETAIL_PLAN model● Replace P_ACCT with P_ACCTDETAIL● Remove the P_ACTIVITY dimension from the DETAIL_PLAN InfoProvider using the following syntax:

*XDIM_MEMBERSET TIME = 2006.AUG *XDIM_MEMBERSET CATEGORY=ACTUAL *DESTINATION_APP=DETAIL_PLAN *SKIP_DIM = P_ACTIVITY *ADD_DIM P_DATASRC=INPUT, MARKET = PRODUCT:MARKET *RENAME_DIM P_ACCT=P_ACCTDETAIL *WHEN CATEGORY *IS "ACTUAL" *REC(EXPRESSION=%VALUE%) *ENDWHEN

Explanation: DETAIL_PLAN is the target model, which has all dimensions of PLANNING except for P_ACCT. This dimension is replaced with P_ACCTDETAIL. Also, DETAIL_PLAN has two additional dimensions, namely P_DATASRC and MARKET. The above script logic moves the data into DETAIL_PLAN with:

● P_DATASRC defined by the keyword INPUT● MARKET by using the value of the property 'MARKET' of the dimension PRODUCT, which must exist in the

source model● The corresponding values of P_ACCT are copied to P_ACCTDETAIL

The keyword RENAME_DIM can be used, to change name of one or more dimensions. The syntax is:

*RENAME_DIM {dimension name}={value}[,{dimension name}={value},…]

This instruction can be used when data is to be written into a model where a dimension is named with a different ID.

Multiple dimension names and values can be supplied to the instruction separated either by commas or by multiple RENAME_DIM instructions entered on separate lines.

Any combination of the three keywords, above, is supported.

Examples

Example 1

Environment: EnvironmentShell_V

Model: PLANNING

In this example, EnvironmentShell_V is a copy of EnvironmentShell and COPY_PLANNING is a copy of the PLANNING model. You can execute the script, shown in this example, in a PLANNING model to copy ACTUAL data to the COPY_PLAN model.

152 PUBLIC


Administration

If the *DESTINATION_APP command appears once in the middle of the script, all remaining data writing of the script logic file occurs in the referenced destination model. Any data writes before the *DESTINATION_APP are written in the model where the script is currently being run.

*XDIM_MEMBERSET TIME = 2006.AUG *XDIM_MEMBERSET CATEGORY=ACTUAL *DESTINATION_APP=COPY_PLANNING *WHEN CATEGORY *IS "ACTUAL" *REC(EXPRESSION=%VALUE%) *ENDWHEN

Example 2

To explain DESTINATION_APP with SKIP_DIM, ADD_DIM, and RENAME_DIM, another model DETAIL_PLAN is created by copying the PLANNING model from the delivered EnvironmentShell. It is necessary to:

● Create new dimensions PRODUCT and MARKET and add these to the DETAIL_PLAN model● Replace P_ACCT with P_ACCTDETAIL● Remove the P_ACTIVITY dimension from the DETAIL_PLAN InfoProvider

*XDIM_MEMBERSET TIME = 2006.AUG *XDIM_MEMBERSET CATEGORY=ACTUAL *DESTINATION_APP=DETAIL_PLAN *SKIP_DIM = P_ACTIVITY *ADD_DIM P_DATASRC=INPUT, PRODUCT = NO_PRODUCT, MARKET = NO_MARKET *RENAME_DIM P_ACCT=P_ACCTDETAIL *WHEN CATEGORY *IS "ACTUAL" *REC(EXPRESSION=%VALUE%) *ENDWHEN

Explanation

DETAIL_PLAN is the target model, which has all dimensions of PLANNING except for P_ACCT. This dimension is replaced with P_ACCTDETAIL. Also, DETAIL_PLAN has two additional dimensions, namely PRODUCT, and MARKET.

The above script logic moves the data into DETAIL_PLAN with:

● Blank data in the PRODUCT and MARKET dimensions● P_DATASRC defined by the keyword INPUT● corresponding values of P_ACCT copied to P_ACCTDETAIL



10.5.2.2.4 *FOR / *NEXT

*FOR / *NEXT is used to repeat certain scripts written between a FOR and an immediate NEXT for a set of members. Sets of members can be provided either directly in the FOR statement or through variables.

The Logic Module supports any number of FOR… NEXT loops in the body of the logic files. The syntax is the following:

*FOR {variable1} = {set1} [ AND {variable2={set2}]

{text}

{text}

…

*NEXT

ExampleIn a logic file, you may need to repeat some calculation for a set of entities. This works automatically when you write:

*XDIM_MEMBERSET TIME = 2006.JAN

*XDIM_MEMBERSET CATEGORY = Q1FCST_LOAD

*FOR %Q1% = 2006.JAN, 2006.FEB, 2006.MAR

*RUNALLOCATION

*FACTOR=1/3

*DIM TIME WHAT = 2009.JAN; WHERE = %Q1%;

*DIM CATEGORY WHAT=Q1FCST_LOAD; WHERE=FQ1;

*ENDALLOCATION

*NEXT

Assuming the forecast data for Q1 is loaded in 2006.JAN, the above script allocates this data into each period in Q1 equally.

NoteOnly one variable is allowed per *FOR statement.


154 PUBLIC


Administration

10.5.2.2.5 *FUNCTION / *ENDFUNCTIONA user-defined function is the name of a placeholder that you can insert into formulas in place of a corresponding MDX statement or part of one. This can greatly improve the readability of a logic statement.

The definitions of the logic functions can be inserted anywhere in a logic file or in an included file. Their syntax is the following:

For single line functions

*FUNCTION {functionname}({Param1}[,{Param2}…]) = {Function Text}

For multi-line functions

*FUNCTION {functionname}({Param1}[,{Param2}…])

{Function text}

{Function text}

*ENDFUNCTION

An unlimited number of functions can be defined within a script logic file.

An unlimited number of parameters can be passed to a function to dynamically modify the corresponding MDX string.

Functions currently cannot be nested, meaning a function cannot contain another function.

The position of the functions in the logic file is irrelevant, unless the same function is redefined, in which case the new definition of the function applies only from the point of the redefinition.

The values of the passed parameters are replaced in the function text without any validation, even if they are embedded in longer words.

Use caution when defining the names of the parameters to avoid the risk of conflicts with MDX reserved words and with the text surrounding them in logic. The best practice is to always surround the name of the parameters with a delimiter, as in the following example:

Example*FUNCTION Price(%COST%,%HOUR%)

%COST%/%HOUR%

*ENDFUNCTION[#CE0661000] = Price([CE0004000],[CE0652000])

The example calculates the price. You do not have to check the denominator for zero to avoid a divide-by-zero error. The Script Logic engine automatically replaces the divide-by-zero error with a zero.

You can also use *FUNCTION to substitute members or dimensions to make scripts more readable.

*FUNCTION PERSONAL_COST = CE0004000

*FUNCTION LAB_HOUR = CE0652000

*FUNCTION PER_PRICE = CE0661000

*FUNCTION ACCOUNT = P_ACCT

Price(%COST%,%HOUR%)


%COST%/%HOUR%

*ENDFUNCTION

[ACCOUNT].[#PER_PRICE] = Price([ACCOUNT].[PERSONAL_COST],[ACCOUNT].[LAB_HOUR])

The following characters, plus the blank character, are invalid in logic functions names:

+ - / * ^ % > < = ( ) [ ] { } , . ; ' : & \ | # ~ "


10.5.2.2.6 *INCLUDE

Multiple files can be combined into one logic file by the use of the instruction INCLUDE.

During the LGX generation of the script logic execution step, the statements in the INCLUDE file are combined with the main file.

Example*INCLUDE FUNCTION_DEFINITIONS.LGF

[ACCOUNT].[#PER_PRICE] =

Price([ACCOUNT].[PERSONAL_COST],[ACCOUNT].[LAB_HOUR])

A FUNCTION_DEFINITIONS.LGF file can include all definitions:

*FUNCTION PERSONAL_COST = CE0004000

*FUNCTION LAB_HOUR = CE0652000

*FUNCTION PER_PRICE = CE0661000

*FUNCTION ACCOUNT = P_ACCT

Price(%COST%,%HOUR%)

%COST%/%HOUR%

*ENDFUNCTION


156 PUBLIC


Administration

10.5.2.2.7 *RECThe *REC( ) instruction tells the program what to do once the specified criteria has been met.

Each REC instruction generates one new record to post to the database. Each source record can generate as many records as desired, even pointing to the same destination cell.

The parameters of the REC( ) function specify what to modify of the original record. Any dimension member can be modified using the following syntax:

{DimensionName}={member}

Example*XDIM_MEMBERSET P_ACCT = CE0004010

*WHEN CATEGORY

*IS ACTUAL *REC(FACTOR = 1.1, CATEGORY="FORECAST")

*ENDWHEN

You can use property values in WHEN statement.

Example*XDIM_MEMBERSET CATEGORY = PLAN

*WHEN TIME.YEAR

*IS "2007"

*REC(FACTOR = 1.1, CATEGORY="FORECAST")

*ENDWHEN

The above script copies the 2007 plan data to Forecast. You can also read property values and assign them to dimensions.

Example*XDIM_MEMBERSET P_ACCT = CE0004010,CE0652000

*WHEN P_ACCT

*IS "CE0004010"

*REC(EXPRESSION=([P_ACCT].[CE0004010],[P_ACTIVITY].[NONE])/([P_ACCT].[CE0652000],[P_ACTIVITY].[LABPRD]), RPTCURRENCY=[ENTITY].CURRENCY, P_ACCT=CE0661000)

*ENDWHEN

Restrictions For Using the REC Instruction

● You cannot use other MDX keywords (such as PARENT and DESCENDANTS) in FACTOR or EXPRESSION instructions. The only permitted operations are addition (+), subtraction (-), multiplication (*), and division (/), combinations of these operators, and parenthesis for tuple and priorities of the operations.

● You cannot use the GET() function to refer to another source value. The MDX tuple format acts as a GET function.


● You cannot use NOADD or FLD functions within REC.● Dynamic properties such as HLEVEL, PARENTHn are not supported in the REC statement.● REC always needs to be accompanied by WHEN / IS / ENDWHEN. Stand-alone REC statements do not

have any effect.● You cannot use SIGNEDDATA or any measure name in a WHEN statement to write a condition on a

measure value.● WHEN / IS / REC / ENDWHEN cannot be used in SELECTCASE / ENDSELECT.

Using Multiple REC Statements

You can write multiple REC statements within one WHEN/ IS/ ENDWHEN statement.

Syntax

*WHEN {dim}

* IS {condition_value}

*REC({FACTOR or EXPRESSION instruction},dim=…)



…

*ENDWHEN

Example*XDIM_MEMBERSET TIME = 2006.AUG,2006.SEP

*XDIM_MEMBERSET P_ACCT=CE0004010

*XDIM_MEMBERSET CATEGORY=ACTUAL

*WHEN P_ACCT

*IS "CE0004010"

*REC(EXPRESSION=%VALUE%/1.5098, RPTCURRENCY="EUR")

*REC(EXPRESSION=%VALUE%/1.0666, RPTCURRENCY="CAD")

*REC(EXPRESSION=%VALUE%/1.9183, RPTCURRENCY="GBP")

*ENDWHEN

The script shown above creates EUR, CAD, and GBP posts in the InfoProvider.

Referring To Another Source Value Within A FACTOR/EXPRESSION Instruction

You can assign a source value from the scoped data for a FACTOR or EXPRESSION instruction to calculate a new value inside a *REC( ) statement. To refer to another source value, you must use fully qualified MDX formatting, including an Account dimension.

NoteYou have the ability to use implicit Account members in direct MDX statements within script logic.

158 PUBLIC


Administration

Syntax

*WHEN {dim}

* IS {condition_value}




…

*ENDWHEN

ExampleEnvironment: EnvironmentShell_V (Copy of EnvironmentShell)

Application: Planning

*XDIM_MEMBERSET P_ACCT = CE0004010,CE0004020

*WHEN P_ACCT

*IS "CE0004010"

*REC(EXPRESSION=%VALUE%/[P_ACCT].[CE0004020], P_ACCT="CE0661000")

*ENDWHEN

You can use tuples as well.

ExampleEnvironment: EnvironmentShell_V (Copy of EnvironmentShell)

Application: Planning

*XDIM_MEMBERSET P_ACCT = CE0004010,CE0652000

*WHEN P_ACCT

*IS "CE0004010"

*REC(EXPRESSION=%VALUE%/([P_ACCT].[CE0652000],[P_ACTIVITY].[LABPRD]), P_ACCT="CE0661000")

*ENDWHEN



10.5.2.2.8 LOOKUP

A function that refers to another source value

To calculate a new value inside a *REC( ) statement, you can use the LOOKUP function to assign a source value that is outside the scoped data for a FACTOR or an EXPRESSION instruction.

Syntax

*LOOKUP {Model}

*DIM [{LookupID}:]{DimensionName}="Value" | {CallingDimensionName}[.{Property}]

*DIM MEASURES="MeasureName"

*ENDLOOKUP

ExampleIn the following example, you are reading RATE information and using it in the calculation. You can also use FOR/NEXT to look up multiple values.

Environment: EnvironmentShell_V (Copy of the EnvironmentShell sample environment)

Model: Planning

*XDIM_MEMBERSET TIME = 2006.AUG



*LOOKUP RATE

*DIM TIME="2006.AUG"

*DIM CATEGORY="ACTUAL"

*DIM R_ACCT="AVG"

*DIM R_ENTITY="GLOBAL"

*DIM RATEEUR:INPUTCURRENCY="EUR"

*DIM MEASURES="PERIODIC"

*ENDLOOKUP

*WHEN P_ACCT

*IS "CE0004010"

*REC(EXPRESSION=%VALUE%/LOOKUP(RATEEUR), RPTCURRENCY="EUR")

*ENDWHEN

ExampleIn the following example, you are first reading all reporting currencies in the *SELECT statement and assigning the values to variable %CUR%. Using FOR/NEXT, you read their rates from RATE model. Then, you use them in the calculation.

160 PUBLIC


Administration

Values in the models before the execution of the script:

PLANNING model data:

TIME P_ACCT ENTITY P_ACTIVITY CATEGORY Currency P_DATASRC SignData

2006.AUG CE0004010 C9000 NONE ACTUAL LC UPLOAD 157,915.81

Rate model data:

Category InputCurrency R_ACCT R_ENTITY TIME SignData

ACTUAL EUR AVG GLOBAL 2006.AUG 1.5022

ACTUAL USD AVG GLOBAL 2006.SEP 1.0000

*XDIM_MEMBERSET TIME=2006.AUG



*SELECT(%CUR%, "[ID]", RPTCURRENCY, "[REPORTING]=Y")

*LOOKUP RATE


*DIM R_ACCT="AVG"


*DIM TIME="2006.AUG"


*FOR %LOOP_CUR%=%CUR%

*DIM C_%LOOP_CUR%:INPUTCURRENCY="%LOOP_CUR%"

*NEXT

*ENDLOOKUP

*WHEN P_ACCT

*IS "CE0004010"

*FOR %LOOP_CUR%=%CUR%

*REC(EXPRESSION=%VALUE%/LOOKUP(C_%LOOP_CUR%), RPTCURRENCY=%LOOP_CUR%)

*NEXT

*ENDWHEN


Values in the model after the execution of the script:

2006.AUG CE0004010 C9000 NONE ACTUAL EUR UPLOAD 105,123.03

2006.SEP CE0004010 C9000 NONE ACTUAL USD UPLOAD 157,915.81

You can also pass property values to scope members to look up data.

ExampleIn this example, the corresponding Entity's currency is read from master data and this is used to look up the rate value.

*XDIM_MEMBERSET TIME = 2007.AUG



*XDIM_MEMBERSET ENTITY=C9000

*LOOKUP RATE *DIM TIME="2006.AUG"


*DIM R_ACCT="AVG"


*DIM RATE:INPUTCURRENCY=ENTITY.CURRENCY


*ENDLOOKUP

*WHEN P_ACCT

*IS "CE0004010"

*REC(EXPRESSION=%VALUE%/LOOKUP(RATE), RPTCURRENCY=ENTITY.CURRENCY)

*ENDWHEN

Restriction

● Reading multiple measures within a single LOOKUP by assigning different lookup IDs is not supported.


162 PUBLIC


Administration

10.5.2.2.9 *RUNALLOCATION

Allocation helps distribute data from a source region to a target region using the specified driver.

Syntax

*RUNALLOCATION

*FACTOR=<driver>

*DIM P_ACCT WHAT=<soure>; WHERE=<target>; USING=<distribution key>; [TOTAL=<distribution key>]

*DIM <other dimensions>

*ENDALLOCATION

WHAT (Source)

The source value represents the range of data values to be allocated by the allocation function. This value is qualified by one or several tuples in the model.

Possible WHAT options are:

Options Descriptions Example

Member A specified dimension base member. *DIM Region WHAT = US

[property]="property value" A filter to select dimension members based on a specified property and a given value for that property.

*DIM Product_Group = [Fruit] = "apples"

BAS All leaf level members of a specific dimension parent member

*DIM Product_Group = BAS(TotalProduct)

same as WHERE Use the same members defined in the WHERE parameter for the specified dimension

*DIM Account WHERE = Rent

*DIM Account WHAT = Rent

<> member The <> operand references all members not equal to a defined member.

In the <>member mode, the member should be base member in the dimension.

If the <> is used, all other base members in that dimension should be included in the region.

*DIM Region USING <> Corp

Restriction of WHAT

● You cannot use blank or [ALL] in WHAT condition.● You cannot use non-base members with <>.

USING and TOTAL (Distribution key)


The basis of the allocation is the definition of a portion or complete source value to be allocated. The method of defining the basis is the use of a factor. A factor can be the value or values that can be multiplied or divided to derive a value (added or subtracted potential future support).

A factor can also derive values based on a defined region of data referred as using, or the basis region.

Possible USING and TOTAL options are:


Member A specified dimension base member. *DIM Region USING = US



same as WHERE Use the same members defined in the WHERE parameter for the specified dimension. The same dimension must be for both WHERE and USING.

NoteWHERE only supports a single member reference.


*DIM Account USING = PercentAcct

<> member The <> operand references all members not equal to a defined member.

In the <>member mode, the member should be base member in the dimension.

If the <> is used, all other base members in that dimension should be included in the region.

*DIM Region USING <> Corp



Restriction of USING

● You cannot use >0. For example, USING = Amount >0 is not supported.● USING and TOTAL must have the same definition.● You cannot use non-base members with <>.● You cannot use parent member directly in USING. BAS(parent) is still allowed as described above.

FACTOR (Driver)

FACTOR can be used to define any arithmetic expression, written in the {expression} parameter, and can contain operands, parentheses, constants, and one or both of the keywords USING and TOTAL, representing respectively the amount coming from the USING region, the amount of the driver, and the amount coming from the TOTAL region, the sum of the drivers.

164 PUBLIC


Administration

● If FACTOR is omitted, the FACTOR defaults to 1.● If the arithmetic expression is omitted, the default is multiplication.

Possible FACTOR options are:


.8 Only a fixed amount is to be applied to the source value for allocation.

Tuple value of the WHAT is 10 for product A

10*.8 = 8

USING The value of the USING region defined is used as the basis of the allocation. This provides the ability to change values without having to edit the definition of the allocation.

Tuple value of the WHAT is 10 for product A, tuple value of the USING is .8

10*.8 = 8

-1 * USING/100

Or

1 * USING/100

Calculation takes the defined region as USING, and reverses the value (negative), then divides the value by 100.

Tuple value of the USING region is 70 for product A.

-70/100 = -.7

(-70%) (1-70)/100 = -.69 (-69%)

NoteThis is used with driver accounts not reporting values.

USING/TOTAL Calculation takes the region defined as USING, and divides the total value for the region defined as TOTAL.

Tuple value of USING region is 70 for product A. The total of the TOTAL region (tuples) is 700, assuming that the using region is for all regions not just US.

70/700 = .1 (10%)

Basic Mathematical expression with USING & TOTAL

(For example, 1 + USING, USING -1 , and 1 - USING)

Calculation takes the region defined as USING, and does the necessary mathematical operations with the total value for the region defined as TOTAL.

Tuple value of the USING region is 70 for product A.

1+70 = 71

70 -1 = 69

1-70 = -69

Restriction of FACTOR

● You cannot use any script logic keywords in FACTOR expression.

WHERE (Target)

The target identifies the tuples to which the values should be allocated. It represents dimension member combinations to which the values should be distributed. The target identifies the dimension for which the value of the members is modified as compared to the source, and only explicitly mentioned and characterized dimension should be modified.


The keyword WHERE is used in combination with the keyword *DIM to identify the target dimension members (the values to be modified against the source).

Possible WHERE options are:


Member A specified dimension base member. *DIM Region WHERE = US



same as WHAT Use the same members defined in the WHAT parameter for the specified dimension

*DIM Account WHAT = Rent


blank or [All] The ability to assume all base members for given dimensions either via a blank parameter or [ALL] key word

*DIM Entity =

*DIM IntCo = [ALL]



Common Restriction

● *APP (ability to write in different model if needed), COUNT and LIST keywords inside RUNALLOCATION or any other options not mentioned above are not supported.

Examples

Example 1

The account RENT is entered in entity GLOBALOPS, inter-company NON_INTERCO. This amount must be allocated using a percentage of allocation that is entered by the user in account PERCENT in the appropriate entities and for the desired members of the CATEGORY, TIME, DATASRC, and RPTCURRENCY dimensions.

This allocation demonstrates the following features:

● It uses the {dimensiontype}DIM keyword to identify the dimensions by type● It uses the <<< and >>> keywords to reference the definitions used to the left or to the right

Before Allocation

Source Account ( RENT) data:

RENT CHINA China

RENT JAPAN Japan

RENT INDIA India

RENT ASAREST Rest of Asia

166 PUBLIC


Administration

RENT ASA Asia 50,000,000.00

Driver (Percent Account) data:

PERCENT CHINA China 10.00

PERCENT JAPAN Japan 32.00

PERCENT INDIA India 8.00

PERCENT ASAREST Rest of Asia 50.00

*XDIM_MEMBERSET TIME=2006.SEP *XDIM_MEMBERSET P_ACCT=RENT,PERCENT *XDIM_MEMBERSET ENTITY=ASA,INDIA,CHINA,JAPAN,ASAREST *RUNALLOCATION *FACTOR=USING/100 *DIM P_ACCT WHAT=RENT; WHERE=<<<; USING=PERCENT *DIM ENTITY WHAT=ASA; WHERE=INDIA,CHINA,JAPAN,ASAREST; USING=<<< *ENDALLOCATION

After Allocation

RENT CHINA China 5,000,000.00

RENT JAPAN Japan 16,000,000.00

RENT INDIA India 4,000,000.00

RENT ASAREST Rest of Asia 25,000,000.00

RENT ASA Asia 50,000,000.00

Example 2

The account RENT is entered in entity GLOBALOPS, inter-company NON_INTERCO. This amount must be allocated on the basis of the square meters of rented space used by all European entities.


● Allocation uses historical rent as the driver● It uses the BAS( ) keyword to build a list of members

Before Allocation

Below is the history data shown for the 2008.JAN period. Asia is the parent node.

Entity CATEGORY 2008.JAN

Asia all ACTUAL



Asia ACTUAL

China ACTUAL 1,500.00

Japan ACTUAL 7,000.00

India ACTUAL 500.00

Rest of Asia ACTUAL 5,000.00

Planning Asia ACTUAL

Source Account ( RENT) data:

● To allocate 50,000 to base countries● This input can be received in the Planning Asia entity

Driver data:

● The historical data is the Driver

*XDIM_MEMBERSET TIME=2008.JAN,2009.JAN *XDIM_MEMBERSET P_ACCT=RENT *XDIM_MEMBERSET CATEGORY=ACTUAL,PLAN *XDIM_MEMBERSET ENTITY=ASA,BAS(RASA) //Create total rent data to be allocated. *WHEN ENTITY *IS "ASA" *REC (EXPRESSION=50000,TIME=2009.JAN,CATEGORY=PLAN) *ENDWHEN *COMMIT //Allocate to base countries. *RUNALLOCATION *FACTOR=USING/TOTAL *DIM P_ACCT WHAT=RENT; WHERE=<<<; USING=<<<; TOTAL=<<< *DIM ENTITY WHAT=ASA; WHERE=BAS(RASA); USING=<<< TOTAL=<<< *DIM TIME WHAT=>>>; WHERE=2009.JAN; USING=2008.JAN; TOTAL=<<< *DIM CATEGORY WHAT=>>>; WHERE=PLAN; USING=ACTUAL; TOTAL=<<< *ENDALLOCATION //Clear the total rent account. *WHEN ENTITY *IS "ASA" *REC (EXPRESSION=0,TIME=2009.JAN,CATEGORY=PLAN) *ENDWHEN

After Allocation


Asia all PLAN 50,000.00

168 PUBLIC


Administration


Asia PLAN 50,000.00

China PLAN 7,500.00

Japan PLAN 35,000.00

India PLAN 2,500.00

Rest of Asia PLAN 5,000.00

Planning Asia PLAN

2009.JAN is posted with rents for individual countries based upon their historical share.

Example 3

The sum of all ADVERTISING expenses incurred by all European operations must be reallocated to each European operation based on their external SALES.


● It uses the DOT({type}) keyword to identify the dimensions by type● It demonstrates the ability to perform aggregations in the WHAT region ( SALESEUROPE and ALL_INTCO are

parent members)● It shows a many-to-one redirection of a dimension (it reads the sum of the Inter-company members and

writes it in the NON_INTERCO member of the INTCO dimension)● It shows a one-to-one redirection of a dimension (it reads the INPUT member and writes the results in the

ALLOCATED member of the DATASRC dimension)

Before Allocation

Source data - History data for External Sales:

Actual - Periodic 2008.JAN

Planning Asia

China 500,000

Japan 600,000

India 200,000

Rest of Asia 800,000

Asia 2,100,000

Asia all 2,100,000


Data to be allocated ( ADVERTISING):

Plan - Periodic 2009.JAN

Planning Asia 500,000

China

Japan

India

Rest of Asia

Asia

Asia all 500,000

Factor: USING/TOTAL

APP or (Dim) or VALUE WHAT WHERE USING TOTAL

DOT(A) ADVERTISING <<< EXTSALES <<<

DOT(E) SALESEUROPE BAS(SALESEUROPE) <<< <<<

DOT(I) ALL_INTERCO NON_INTERCO >>> BAS(ALL_INTERCO)

DATASRC INPUT ALLOCATED INPUT <<<

*RUNALLOCATION *FACTOR =USING/TOTAL *DIM P_ACCT WHAT=ADVERTISING; WHERE=<<<; USING=EXTSALES; TOTAL=<<< *DIM ENTITY WHAT=ASA; WHERE=BAS(RASA); USING=<<<; TOTAL=<<< *DIM INTERCO WHAT=WORLD_INTERCO; WHERE=I_NONE; USING=>>>; TOTAL=BAS(World_InterCo) *DIM P_DATASRC WHAT=MANUAL; WHERE=ALLOCATED; USING=MANUAL; TOTAL=<<< *DIM TIME WHAT=2009.JAN; WHERE=2009.JAN; USING=2008.JAN; TOTAL=<<< *ENDALLOCATION

After Allocation


Planning Asia

China 119,048

170 PUBLIC


Administration


Japan 142,857

India 47,619


Asia 500,000

Asia all 500,000

Example 4

This example implements the same scenario as example 3, but using a system variable for year. (%YEAR%). This returns current calendar year. Assume that the script is for year 2009.

Before Allocation

Source data - History data for External Sales:

Actual - Periodic 2008.JAN

Planning Asia

China 500,000

Japan 600,000

India 200,000


Asia 2,100,000

Asia all 2,100,000

Data to be allocated ( ADVERTISING):


Planning Asia 500,000

China

Japan

India

Rest of Asia

Asia



Asia all 500,000

Factor: USING/TOTAL

APP or (Dim) or VALUE WHAT WHERE USING TOTAL

DOT(A) ADVERTISING <<< EXTSALES <<<

DOT(E) SALESEUROPE BAS(SALESEUROPE) <<< <<<

DOT(I) ALL_INTERCO NON_INTERCO >>> BAS(ALL_INTERCO)

DATASRC INPUT ALLOCATED INPUT <<<

*RUNALLOCATION *FACTOR =USING/TOTAL *DIM P_ACCT WHAT=ADVERTISING; WHERE=<<<; USING=EXTSALES; TOTAL=<<< *DIM ENTITY WHAT=ASA; WHERE=BAS(RASA); USING=<<<; TOTAL=<<< *DIM INTERCO WHAT=WORLD_INTERCO; WHERE=I_NONE; USING=>>>; TOTAL=BAS(World_InterCo) *DIM P_DATASRC WHAT=MANUAL; WHERE=ALLOCATED; USING=MANUAL; TOTAL=<<< *DIM TIME WHAT=%YEAR%.JAN; WHERE=%YEAR%.JAN; USING=%YEAR%(-1).JAN; TOTAL=<<< *ENDALLOCATION

After Allocation


Planning Asia

China 119,048

Japan 142,857

India 47,619


Asia 500,000

Asia all 500,000

Example 5

All accounts in the profit and loss of category ACTUAL, for the three entities ITALY, FRANCE and UK, are copied into the corresponding accounts of the entity GLOBALOPS for category BUDGET. This allocation is basically an

172 PUBLIC


Administration

example of a simple copy action, which does not use FACTOR at all. In this example the engine performs a one-to-one copy ( ACTUAL into BUDGET) and a many-to-one copy ( ITALY, FRANCE and UK are added up and copied into GLOBALOPS).

Before Allocation

Actual - Periodic 2007.DEC

UK (Great Britain) 30,000

Italy 10,000

France 10,000

Budget - Periodic 2008.FEB

Global Operations

Factor:

APP or (Dim) or VALUE WHAT WHERE

ACCOUNT [GROUP] = "profit & loss" <<<

CATEGORY ACTUAL BUDGET

ENTITY SALESITALY; SALESFRANCE; SALESUK GLOBALOPS

DOT(R) LC <<<

A property not supported in ALLOCATION is replaced by a variable using a *SELECT statement. Ensure that the *SELECT statement selects only base members.

*XDIM_MEMBERSET ACCOUNT=ADVERTISING,EXTSALES *XDIM_MEMBERSET ENTITY=UK,ITALY,FRANCE,GLOBAL *XDIM_MEMBERSET P_DATASRC = INPUT *XDIM_MEMBERSET TIME = 2007.DEC,2008.JAN *XDIM_MEMBERSET CATEGORY = ACTUAL,BUDGET *XDIM_MEMBERSET INTCO= I_NONE *XDIM_MEMBERSET RPTCURRENCY = LC *SELECT(%ACCT%, "[ID]",ACCOUNT,"[CALC]='N'","[GROUP]='PL'") *RUNALLOCATION *FACTOR= *DIM ACCOUNT WHAT=[GROUP]="PL" AND [CALC]="N"; WHERE=<<< *DIM CATEGORY WHAT=ACTUAL; WHERE=BUDGET *DIM ENTITY WHAT=UK,ITALY,FRANCE; WHERE=GLOBAL *DIM DOT(R) WHAT=LC; WHERE=<<< *DIM TIME WHAT=2007.DEC; WHERE=2008.FEB *ENDALLOCATION

After Allocation


Budget - Periodic 2008.FEB

Global Operations 50,000


10.5.2.2.10 *SELECT

The special instruction *SELECT allows you to retrieve a list of elements from a dimension and save it in a user-defined variable for use somewhere else in the logic.

*SELECT ({variable}, {[What]}, {From dimension}, {Where})

ExampleWith the following instruction, the user can retrieve the ID of all members in the CURRENCY dimension where the property CURRENCY TYPE has the value R.

*SELECT(%CURRSET%, "[ID]", RPTCURRENCY, "[REPORTING]='Y'")*XDIM_MEMBERSET RPTCURRENCY = %CURRSET%

The *SELECT statement fills the variable %CURRSET% with the list of reporting currencies defined in the current model. The content of the resulting variable is then used in the XDIM_MEMBERSET statment.

The SELECT instruction is not specific to a given logic section, but it can be written once anywhere in the logic and used across multiple commit sections.

The SELECT statement is fairly limited, as it only supports the equal sign (=) , not equal to (<>) and cannot be used to combine multiple filter criteria with AND or OR keywords.


10.5.2.2.11 *SELECTCASE / *ENDSELECT

To write formulas containing several nested IIF( ) statements, use the following syntax:

*SELECTCASE {expression}

*CASE {value1}[,{value2},…]

174 PUBLIC


Administration

{formulas}

[*CASE {value1}[,{value2},…]

{formulas}

[*CASEELSE]

{formulas}

*ENDSELECT

where

{expression} is the condition to be evaluated

{value1},.. is the range of comma-delimited results that satisfy the condition for the current case

With such a structure, the readability of a logic statement can be significantly improved.

Example*BEGIN

#A = IIF([ACCOUNT].[E]=1 OR [ACCOUNT].[E]=2,X+Y,

IIF([ACCOUNT].[E]=3 OR [ACCOUNT].[E]=4,X-Y,X*Y))

*END

#C = IIF([ACCOUNT].[E]=1 OR [ACCOUNT].[E]=2,W+Z,null)

#B = IIF([ACCOUNT].[E]=3 OR [ACCOUNT].[E]=4,W*Z,null)

The following formulas could be written as follows:

*SELECTCASE [ACCOUNT].[E]

*CASE 1,2

#A=X+Y

#C=W+Z

*CASE 3,4

#A=X-Y

#B=W*Z

*CASEELSE

#A=X*Y

*ENDSELECT

NoteSELECTCASE structures currently CANNOT be nested.

Any software coding and/or code lines / strings ("Code") included in this documentation are only examples and are not intended to be used in a productive system environment. The Code is only intended to better explain and visualize the syntax and phrasing rules of certain coding. SAP does not warrant the correctness and


completeness of the Code given herein, and SAP shall not be liable for errors or damages caused by the usage of the Code, except if such damages were caused by SAP intentionally or by its gross negligence.

10.5.2.2.12 *SUB( ) / *ENDSUB

A SUB structure allows the user to define reusable logic sections anywhere in the body of the logic to make the logic easier to read and maintain.

A *SUB( ) structure is declared like a multi-line *FUNCTION( ) structure with the following syntax:

*SUB {SubName}({Param1,[,{Param2}…])

{body text}

{body text}

{body text}

[…]

*ENDSUB

When a SUB is then used somewhere else in the logic, its body lines are inserted in the logic with all the values passed to its parameters appropriately replaced.

A SUB behaves similarly to included files, to which any number of parameters can be passed. When the logic is validated, the subs are inserted in the body of the logic as if they were included with an *INCLUDE instruction. However, to use a SUB structure, no special keyword is required. A SUB is called by inserting a line with the name of the SUB, followed by the values assigned to its parameter enclosed in brackets. The other important difference from included files is that a SUB does not need to be written in a file of its own, but can be written in any part of the logic, more similarly to a FUNCTION.

ExampleHere the sub is defined:

*SUB MYSUB(Param1,Param2,Param3,Param4)

[%ACCOUNT_DIM%].[#Param1]=[%ACCOUNT_DIM%].[Param2]+[%ACCOUNT_DIM%].[Param3]

[%ACCOUNT_DIM%].[#Param4]=[%ACCOUNT_DIM%].[#Param1]*[%ACCOUNT_DIM%].[Factor_Param4]

*ENDSUB

Here the sub is used:

MySub(A1,B1,C1,D1)

MySub(A2,B2,C2,D2)

MySub(A3,B3,C3,D3)

Similarly to a FUNCTION, a SUB is not position sensitive, and can be defined anywhere in a logic, as well as, if so desired, stored in separate library files that must then be merged with the logic using an INCLUDE instruction.

176 PUBLIC


Administration

A SUB can be used in any commit section of the logic without the need to be redefined in each section. However, if a SUB is redefined in a logic file, its new definition applies to all lines following the redefinition.

A SUB without parameters is supported, but they must always be followed by brackets.


10.5.2.2.13 *WHEN / *ENDWHENA WHEN / ENDWHEN structure works in the same way as the SELECTCASE / ENDSELECT structure, with *REC( ) statements that generate new records.

The syntax is the following:

*WHEN {criteria}

*IS [=]{value1}[,{value2},…] | <>{value}

*REC(FACTOR={Real number}|EXPRESSION={Expression}[,{dim1}={member},{dim2}=…])

[ *REC(FACTOR={Real number}|EXPRESSION={Expression}[,{dim1}={member},{dim2}=…])]

[*ELSE]

*ENDWHEN

where

{criteria} is what to test. Typically, this is a property of the current member of a dimension. The syntax is DimensionName.Property | DimensionName, such as *WHEN ACCOUNT.RATETYPE. If Property is not specified, the ID property is assumed. For example, *WHEN ACCOUNT equals to *WHEN ACCOUNT.ID.

{ValidCondition} is one or more values that meet the criteria. You can enclose them in double quotes to treat them as strings. Omit the quotes if they represent numeric values. For example:

*IS "AVG","END"

*IS 10,20,30

If no operator is specified, the *IS clause assumes the presence of an equal sign (*IS = "AVG", "END").

The {value} must be literals only, not variables. Therefore, the following sample is not supported:

*IS dimension.property

NoteThere should be no space between the two characters of the unequal sign operator (<>). You can insert one or more blanks between the operators and the value.

If an unequal sign (<>) is used, you can pass only one value. Therefore, the syntax *IS <> 2,3,4 is invalid.

Other relational operators like AND, OR and NOT are not currently supported.


Nesting of WHEN / ENDWHEN

WHEN / ENDWHEN structures can be nested by as many levels as desired and in any sequence, as shown in the following sample:

*WHEN xxx

*IS "A"

*REC(…)

*REC(…)

*IS "B"

*REC(…)

*WHEN yyy

*IS "C","D","E"

*REC(…)

*ELSE

*REC(…)

*ENDWHEN

*ENDWHEN


Related Information

*REC [page 157]*SELECTCASE / *ENDSELECT [page 174]

10.5.2.2.14 *XDIM_MEMBERSET

*XDIM_MEMBERSET defines the scope of the data in which subsequent business logic will be applied.

Syntax

*XDIM_MEMBERSET {Dimension name} = {Members Set}

* XDIM_MEMBERSET {Dimension}<>{MemberSet}

Example*XDIM_MEMBERSET TIME = 2006.DEC

178 PUBLIC


Administration

*XDIM_MEMBERSET P_ACCT = bas(CE0004000)

[TIME].[#2009.DEC] = [TIME].[2006.DEC] * 1.1

*COMMIT

This example first reads all children of CE0004000 in the 2006.DEC period, increases them by 10%, and then copies them to the 2009.DEC period.

Other valid use cases:

*XDIM_MEMBERSET P_ACCT = CE0004010, CE0004020, CE0004030

*XDIM_MEMBERSET P_ACCT = CE0004000, where all children values are summarized to one parent record.

*XDIM_MEMBERSET P_ACCT = BAS(CE0004010, CE0004210) The scope is defined by the base members of both CE0004010 and CE0004210. The string inside the parentheses () can also be replaced by a variable defined in the Data Manager prompt.

*XDIM_MEMBERSET P_ACCT = DEP(CE0004010) All direct children of CE0004010.

*XDIM_MEMBERSET P_ACCT = ALL(CE0004010) All children of CE0004010.

*XDIM_MEMBERSET P_ACCT <> CE0004010

You cannot combine bas() with any other member set.

*XDIM_MEMBERSET P_ACCT = bas(CE0004000), CE0004210 This is not a valid use case.

Use *XDIM_ADDMEMBERSET to add more members to the scope of the member set defined by bas().

Forcing a dimension to read all members without member formulas

Using the <ALL> keyword, you can force a dimension to read all base members without member formulas.

Example

*XDIM_MEMBERSET P_ACCT = <ALL>

*XDIM_MEMBERSET TIME = 2006.DEC

[P_ACCT].[#CE0661000] = [P_ACCT].[CE0004000] / [P_ACCT].[CE0652000]



10.5.2.2.15 *XDIM_ADDMEMBERSET

With the keyword XDIM_ADDMEMBERSET, the logic can merge a specific set of members with the members passed in the region for which the logic should be executed.

This instruction is similar to the instruction *XDIM_MEMBERSET. The difference is that, while XDIM_MEMBERSET redefines the region passed by the user, XDIM_ADDMEMBERSET adds the defined set to the passed region.

*XDIM_ADDMEMBERSET {dimension} = {members set}

Example*XDIM_MEMBERSET P_ACCT = bas(CE0004000)

*XDIM_ADDMEMBERSET P_ACCT = CE0004210

[TIME].[#2009.DEC] = [TIME].[2006.DEC] * 1.1

*COMMIT

In the above example, CE0004210 is scoped along with all children of CE0004000.


10.5.2.2.16 *XDIM_MAXMEMBERS

When the number of records being processed is too large, performance can deteriorate significantly. Also, processing too much data in the memory will slow down the system for other uses and eventually run out of memory. For example, an TSV_TNEW_PAGE_ALLOC_FAILED ABAP dump can occur even with high Roll memory settings. In this case, you can break the action into multiple packets and execute them sequentially using the following syntax:

*XDIM_MAXMEMBERS {dimension} = {max number of members}

Example*XDIM_MEMBERSET TIME = 2009.JAN

*XDIM_MEMBERSET CATEGORY = FCST_LOAD

*XDIM_MAXMEMBERS P_ACCT = 5

*RUNALLOCATION

*FACTOR=1/12

*DIM TIME WHAT = 2009.JAN; WHERE = BAS(2009.TOTAL);

*DIM CATEGORY WHAT = FCST_LOAD; WHERE = FORECAST;

180 PUBLIC


Administration

*ENDALLOCATION

Assuming the whole year's forecast initially loaded 2009.JAN and FCST_LOAD, the above script allocates the data equally to each period in 2009. The script logic engine reads the data in packages split by P_ACCT members, with each package containing a maximum of five P_ACCT members, until it reaches the end in P_ACCT dimension members.


10.5.2.2.17 *XDIM_PACKAGEBY

Defines the dimension for which to partition packages during script logic execution. Packages start in parallel mode for better performance.

You can specify the server group using a parameter in IMG. Run transaction SPRO, then choose Business Planning and Consolidation Global setting PARALLEL_SERVER_GROUP .

*XDIM_PACKAGEBY {Dimension name} [ = {Package number} ]

Package number is an optional parameter having a default value of 2.

Example*XDIM_PACKAGEBY ENTITY

In the example above, two packages are created and partitioned by the dimension ENTITY.

Example*XDIM_PACKAGEBY ACCOUNT = 4

Four packages are created are partitioned by the dimension ACCOUNT.

Note● You can use the *XDIM_PACKAGEBY keyword only once in each script.● Parallel mode is triggered ONLY when the member number for the dimension that is defined with

*XDIM_PACKAGEBY is greater than 1.● The following keywords do not support PACKAGEBY: *RUN_PROGRAM, *RUNALLOCATION,

*CALL_CUSTOM_LOGIC, and *START_BADI.


10.5.2.2.18 *XDIM_FILTER

XDIM_FILTER brings all members when the specified condition is met. This keyword returns only base members.

Example*XDIM_MEMBERSET Category = PLAN

*XDIM_MEMBERSET Entity = C3000

*XDIM_MEMBERSET P_DataSrc = MANUAL

*XDIM_MEMBERSET RptCurrency = LC

*XDIM_MEMBERSET P_Activity = EMPL1

*XDIM_MEMBERSET P_ACCT = CE0004220

*XDIM_FILTER Time = [Time].properties("MONTHNUM") = "2"

*WHEN P_ACCT

*IS CE0004220

*REC (EXPRESSION = 888)

*ENDWHEN

*COMMIT

The code in this example writes only FEB records for CE0004220.


10.5.2.2.19 *COMMIT

A logic file can contain formulas that depend on the result of calculations performed by the model, and these calculations in turn depend on the results of other formulas in the same logic.

Example[P_ACCT].[#CE0004030] = ( [P_ACCT].[CE0004010] + [P_ACCT].[CE0004020] ) * 0.15

[P_ACCT].[#CE0661000] =

( [P_ACCT].[CE0004010] + [P_ACCT].[CE0004020] + [P_ACCT].[#CE0004030] ) / [P_ACCT].[CE0652000]

In this example, CE0661000 depends on the first calculation, and this calculation in turn depends on the calculation of CE0004030.

182 PUBLIC


Administration

The logic, if written in the above format, does not work correctly, because CE0004030 cannot be retrieved from the model until its result has been posted to the model. To get the right results, CE0004030 must be calculated AND stored in the model. THEN, the calculated result can be retrieved from the model and be used to calculate CE0661000.

To force a write back of the result of the calculation of CE0004030 into the model before the calculation of CE0661000, you can insert the instruction *COMMIT between the two calculations. The logic then works when written as follows:

Example[P_ACCT].[#CE0004030] = ( [P_ACCT].[CE0004010] + [P_ACCT].[CE0004020] ) * 0.15

*COMMIT

[P_ACCT].[#CE0661000] =

( [P_ACCT].[CE0004010] + [P_ACCT].[CE0004020] + [P_ACCT].[CE0004030] ) / [P_ACCT].[CE0652000]

In this case CE0004030 in the second formula does not have the pound sign (#), because it is a stored amount read from the model.

NoteAny number of commit instructions can be entered in a logic file. However, the number of commit instructions should be kept to the minimum, because they have a negative impact on the overall performance of the logic execution due to increased communication between the database and script logic engine. The ideal case is to have one commit at the end.


10.5.2.2.20 Special Keywords

The following are special keywords.

SET

An implied keyword is available for each dimension, which holds the set of members passed to the logic engine for a given dimension. This keyword can be used as a replacement string anywhere in the logic.

%{DimName}_SET%

{DimName} is the name of a valid dimension in the model. For example the keyword %INTCO_SET% contains the set of members passed to the logic for the dimension INTCO.

This keyword can be used anywhere in the logic and not just within some specific statement like XDIM_MEMBERSET.


This keyword is not modified by the XDIM_MEMBERSET instruction, as it always returns the original set passed to the logic.

This keyword does not return a default set if no set is passed. Its default is an empty set.

DIM

Another type of implied keywords is available for each non-user-defined dimension. This keyword holds the actual name of a dimension of a given type, and can be used as a replacement string to use anywhere in the logic.

%{DimType}_DIM%

{DimType} is the type of dimension.

ExampleIf, in a model, the category dimension is called SCENARIO, the keyword %CATEGORY_DIM% returns the word SCENARIO.

Valid types are:

● ACCOUNT● CATEGORY● TIME● ENTITY● INTCO● CURRENCY● DATASRC

Using Data Manager Prompts

In most of the script executions, you need to get user selection and use that value inside the logic script. For this purpose, you can use Data Manager prompts inside the logic.

Syntax

$DM_PROMPT$...

Example*XDIM_MEMBERSET P_ACCT= CE0004020, CE0004010

*XDIM_MEMBERSET CATEGORY = ACTUAL

*XDIM_MEMBERSET TIME=2006.SEP

*XDIM_MEMBERSET ENTITY= C9000

*XDIM_MEMBERSET P_ACTIVITY=NONE

*XDIM_MEMBERSET P_DATASRC=UPLOAD

*XDIM_MEMBERSET RPTCURRENCY = LC

// Increase Wage and Salary, and Personnel Expense by entered percentage

184 PUBLIC


Administration

[P_ACCT].[#CE0004020] = [P_ACCT].[CE0004020] * ( 1 + $WS_PERCT$ / 100) [P_ACCT].[#CE0004010] = [P_ACCT].[CE0004010] * ( 1 + $EXP_PERCT$ / 100)

The percentage to be increased for the above two accounts is provided by the user.

NoteAdditional configuration is required in the Data Manager to pass these parameters to script logic. In transaction RSPC in the ABAP layer, the corresponding process chain's BPC:Run Logic step, Process Variant, needs to be maintained with additional parameters like TAB, SUSER, and REPLACEPARAM.

Then, the dynamic script of Data Manager needs to be adjusted to accept the prompts.

PROMPT(SELECTINPUT,,,,"%ENTITY_DIM%,%CATEGORY_DIM%,%CURRENCY_DIM%,%TIME_DIM%")

PROMPT(TEXT,%WS_PERCT%,"Input W/S Percent in decimals",)

PROMPT(TEXT,%EXP_PERCT%,"Input Exp. Percent in decimals",)

INFO(%EQU%,=)

INFO(%TAB%,;)

TASK(ZBPC_PROT_EXP_RUN_LOGIC,TAB,%TAB%)

TASK(ZBPC_PROT_EXP_RUN_LOGIC,EQU,%EQU%)

TASK(ZBPC_PROT_EXP_RUN_LOGIC,SUSER,%USER%)

TASK(ZBPC_PROT_EXP_RUN_LOGIC,SAPPSET,%APPSET%)

TASK(ZBPC_PROT_EXP_RUN_LOGIC,SAPP,%APP%)

TASK(ZBPC_PROT_EXP_RUN_LOGIC,SELECTION,%SELECTION%)

TASK(ZBPC_PROT_EXP_RUN_LOGIC,LOGICFILENAME,TESTING0123.LGF)

TASK(ZBPC_PROT_EXP_RUN_LOGIC,REPLACEPARAM,WS_PERCT%EQU%%WS_PERCT%%TAB%EXP_PERCT%EQU%%EXP_PERCT%)

NoteRead the restriction around Validation when DM prompts are used in your script in OSS note 1334695.

Script Logic System Variables

%USER% - Returns the current Business Planning and Consolidation user

%APPSET% - Returns the current Business Planning and Consolidation environment

%APPLICATION% - Returns the current Business Planning and Consolidation model

%YEAR% - Returns the current calendar year

You can use %YEAR% to derive the member values. For example, %YEAR%.TOTAL, and %YEAR%.Q1. You can also use to offset years like %YEAR%(-2).TOTAL.

Any software coding and/or code lines / strings ("Code") included in this documentation are only examples and are not intended to be used in a productive system environment. The Code is only intended to better explain and visualize the syntax and phrasing rules of certain coding. SAP does not warrant the correctness and


completeness of the Code given herein, and SAP shall not be liable for errors or damages caused by the usage of the Code, except if such damages were caused by SAP intentionally or by its gross negligence.

10.5.2.2.21 TMVL Parameter

This optional parameter returns a time value after taking into consideration an offset value from a given time period.

Prerequisites

This function works only with base member values.

Activities

The format for this parameter is TMVL(offset, base_period). Utilize this parameter following these guidelines:

● Offset can be either negative or positive. Only integers are allowed.● The base period can be a hardcoded value such as 2009.MAY, a Time script variable such as %TIME_SET%,

or a Data Manager Prompt variable such as $CURPER$.

NoteNested TMVL parameters such as TMVL(-1, TMVL(-3, 2009.JAN)) ) are not supported.

You can use TMVL in:

● FACTOR/EXPRESSION within REC● FOR/NEXT loops● IS conditions inside WHEN/ENDWHEN.● variables, like %TIME_SET%

The first period of the TIME_SET is used as the base period for a negative offset and the last period of the TIME_SET is used as the base period for a positive offset.

● scope statementsMultiple separate (not nested) TMVLs can be used in one scope statement.

When 0 is used as offset, no offset will be done for the provided time member.

186 PUBLIC


Administration

ExampleIn this example, Actual data records are copied over to the same period in the following year with a 10 percent increase. The existing data is shown in the following table:

Category Entity P_ACCT P_Activity P_DataSrc RptCurrency Time SignData

ACTUAL C9000 CE0004010 NONE UPLOAD LC 2006.APR 100,891.26



The script used is the following:

*XDIM_MEMBERSET P_ACCT= CE0004010, CE0004020, CE0004210

*XDIM_MEMBERSET CATEGORY = ACTUAL

*XDIM_MEMBERSET ENTITY= C9000

*XDIM_MEMBERSET P_ACTIVITY=NONE

*XDIM_MEMBERSET P_DATASRC=UPLOAD

*XDIM_MEMBERSET RPTCURRENCY = LC

*XDIM_MEMBERSET TIME = 2006.APR

*WHEN CATEGORY

*IS ACTUAL

*REC(FACTOR=1.1, TIME=TMVL(12,2006.APR))

*ENDWHEN

The data that results from running the logic script is shown in the following table:

Category Entity P_ACCT P_Activity P_DataSrc RptCurrency Time SignData






10.5.3 US Eliminations as Script Logic

You use this to control where the results of eliminations are stored in an Entity dimension.

Activities

The intercompany eliminations process is handled by a program called US_ELIM. This program is launched using the following logic statement:

*RUN_PROGRAM US_ELIM( <parameters list>)

Example

*RUN_PROGRAM US_ELIM

CATEGORY = %C_CATEGORY_SET%

GROUP = %GROUPS_SET%

TID_RA = %TIME_SET%

OTHER = [ENTITY=%ENTITY_SET%]

*ENDRUN_PROGRAM


Related Information

US Eliminations Rule [page 205]

188 PUBLIC


Administration

10.5.4 Carry-Forward as Script Logic

You use this program to initialize a new reporting period with the closing balances of the last period from the previous year into the opening balances of the current period.

Activities

The copy-opening process is handled by a class called CL_UJP_COPYOPENING. This program is launched using the following logic statement:

*RUN_PROGRAM COPYOPENING( <parameters list>)

Example

*RUN_PROGRAM COPYOPENING

CATEGORY = %C_CATEGORY_SET%

CURRENCY = %GROUPS_SET%

TID_RA = %TIME_SET%

*ENDRUN_PROGRAM


Related Information

Carry-Forward Rule [page 204]


10.5.5 Intercompany Booking as Script Logic

You use this to run Intercompany booking as well as difference posting.

Activities

Intercompany reconciliations processes are handled by a program called ICBOOKING.

Running the following in an ICDATA.LGF logic file runs Intercompany reconciliation:

*RUN_PROGRAM ICBOOKING ( <parameters list>)

Example*RUN_PROGRAM ICBOOKING

CATEGORY = %CATEGORY_SET%

CURRENCY = %GROUPS_SET%

DATASRC = INPUT// value of datasrc dimension member that represents the input datasrc

TID_RA = %TIME_SET%

ENTITY = %ENTITY_SET%

ACCOUNT = %ACCOUNT_SET%

FLOW = %FLOW_SET%

TYPE = I

*ENDRUN_PROGRAM

Running the following in an ICBOOKING.LGF logic file runs Intercompany reconciliation and difference posting:

*RUN_PROGRAM ICBOOKING ( <parameters list>)

Example*RUN_PROGRAM ICBOOKING


GROUP = %CATEGORY_SET%

TID_RA = %TIME_SET%


*ENDRUN_PROGRAM

Any software coding and/or code lines / strings ("Code") included in this documentation are only examples and are not intended to be used in a productive system environment. The Code is only intended to better explain and

190 PUBLIC


Administration

visualize the syntax and phrasing rules of certain coding. SAP does not warrant the correctness and completeness of the Code given herein, and SAP shall not be liable for errors or damages caused by the usage of the Code, except if such damages were caused by SAP intentionally or by its gross negligence.

Related Information

Intercompany Booking Rule [page 202]Eliminations and Adjustments Rule for Legal Consolidation [page 207]

10.5.6 Currency Conversion as Script Logic

You use this to run a new logic file currency conversion. Currency conversion typically runs by default when default logic runs.

Activities

Currency conversion is handled by a program called CURR_CONVERSION. This program is launched using the following logic statement:

*RUN_PROGRAM CURR_CONVERSION( <parameters list>)

You must also set up the following list of attributes for relevant dimensions in addition to the required attributes:

Dimension Attribute

ACCOUNT RATETYPE

DATASRC DATASRC_TYPE (I, M, A, or L)

IS_CONVERTED (Y, G, or N)

ENTITY CURRENCY (local currency)

FLOW FLOW_TYPE (used to find the closing flow)

CURRENCY CURRENCY_TYPE (currency type - Reporting, Local, or group)


Dimension Attribute

TIMEID YEAR

PERIOD

TIMEID

MONTHNUM

INPUTCURRENCY (with Rate InfoProvider) MD (indicator of multiple or divide)

The Datasrc dimension is not mandatory for planning, and currency translation can be run without this dimension. If you choose to include a Datasrc dimension in a planning InfoProvider, the attributes must be set up as they are checked in the currency conversion program.

In addition, the Flow dimension is not mandatory for planning, and currency translation can be run without this dimension. If you choose to include a Flow dimension in a planning InfoProvider, the attribute needs to exist in the flow-type dimension to enable currency conversion.

Example

*RUN_PROGRAM CURR_CONVERSION

CATEGORY = %C_Category_SET%

GROUP = %GROUPS_SET%

TID_RA = %TIME_SET%


RATEENTITY = Global

*ENDRUN_PROGRAM

NoteGlobal should be the valid member ID that is set in the RATEENTITY dimension.

The example shown above contains the line OTHER = [ENTITY=%ENTITY_SET%]. The Other filter supports the dimensions ENTITY, DATASOURCE, and AUDIT. The OTHER filter does not support user-defined dimensions.


192 PUBLIC


Administration

Related Information

Currency Translation Rule [page 196]

10.5.7 Account-based Calculations as Script Logic

You use this to run an account-based calculation rule.

Activities

You run this program using the following logic statement:

*RUN_PROGRAM CALC_ACCOUNT( <parameters list>)

Example

*RUN_PROGRAM CALC_ACCOUNT


CURRENCY = %CURRENCY_SET%

TID_RA = %TIME_SET%

CALC=A

OTHER = [ENTITY=%ENTITY_SET%]// or OTHER=[ENTITY=C1000] or [ENTITY=%ENTITY_SET%;INTCO=%INTCO_SET%...]

*ENDRUN_PROGRAM

NoteIf there is no other scope against which you need to run the program, delete the OTHER line in the script.


Related Information

Account-based Calculation Rule [page 195]


10.5.8 Business Rules Management

Business rules are parameter-driven functions within SAP Business Planning and Consolidation models for calculating and posting monetary amounts in support of common accounting activities, such as intercompany booking, currency translation, and eliminations and adjustments.

To manage business rules in SAP Business Planning and Consolidation, select Planning and Consolidation Administration Rules Business Rules .

Features

Adding Business Rules to Models

In the Business Rule Management page, you can add business rules to models. The following types of business rules are supported:

● Account-based calculation● Currency translation● Intercompany booking to match intercompany transactions● Carry-forward processing to initialize beginning balances when a new fiscal cycle starts● US eliminations● Eliminations and adjustments when generating consolidation entries for a group of entities, such as

eliminations, adjustments, reclassifications, and minority calculations● Equity pick up

After adding a business rule type to a model, you must customize it to meet your needs by specifying parameter values. For example, in Eliminations and Adjustments, you can indicate which balances to read before calculating an amount, or under which account and audit member to post the calculated amount. In addition to customizing default business rules, delivered with the IFRS starter kit for instance, you can define new rules for various types of business processes and add them to a model.

Validating Business Rules

After creating or modifying a business rule, you can verify the detail records by clicking Validate in the <Rule Name> page. A message appears displaying a successful status or any errors encountered.

Activities

You can run a business rule as follows:

● Perform a data send.When you send data using SAP BusinessObjects Analysis, Edition for Microsoft Office, the system runs the default logic indicated in default.lgf. For example, the default logic can execute the currency translation business rules. While you can add any logic or business rule execution to the default script, it is not recommended, as performance may decrease when sending data.

● Run a Data Manager package that contains a reference to a logic file (*.LGF).Logic can be applied to a specified region of data that is stored in the database using any type of logic. You can create new logic files or modify existing ones. For example, an Import package runs against the default

194 PUBLIC


Administration

logic unless the Import package is modified to include other logic files. Each logic file contains one or more ABAP programs that run a specific set of logic commands. Business rules execution can be triggered in any logic file.

● Post a journal entry.Upon posting a journal, the system runs logic that is specific to journal processes. To overwrite the default journal logic, you can create a new script logic file called Journal.lgf. Business rules execution can be triggered in the journal logic file.In SAP Business Planning and Consolidation, currency translation and consolidation processes can also be executed from the Consolidation Monitor.

Related Information

Account-based Calculation Rule [page 195]Currency Translation Rule [page 196]Intercompany Booking Rule [page 202]Carry-Forward Rule [page 204]US Eliminations Rule [page 205]Eliminations and Adjustments Rule for Legal Consolidation [page 207]Equity Pick Up Rule [page 214]Consolidation Monitor [page 31]

10.5.8.1 Account-based Calculation Rule

Account-based calculations read and aggregate the values posted to specific combinations of accounts, flow types, and audit members in order to post the aggregated amount under an alternate destination account, flow and audit member combination.

Features

The following dimensions can be specified in order to define source and target members in the calculation:

● Category (C-type dimension)● Account (A-type dimension)● Flow (S-type dimension)● Datasource (D-type dimension)

The account-based calculations business rule can invert the sign when posting calculated amounts when appropriate, which alternates debit and credit amounts.

This rule can also use reference data in other periods and years to determine amounts to post.

This rule also supports year-to-date calculations in period-based models.

You can utilize account-based calculations in both financial and legal consolidation models.


Example

You can use this business rule to calculate and post values that you need for cash flow reporting.

Related Information

Account-based Calculations as Script Logic [page 193]

10.5.8.2 Currency Translation Rule

You use this to convert local currency values into one or more reporting or group currencies in accordance with major Generally Accepted Accounting Principles.

Currency translation rules are executed as a separate task using a Data Manager package. They can also be executed from the Consolidation Monitor in the Consolidation Central area.

Prerequisites

Currency translation applies to both financial and legal consolidation models to which a corresponding rate model has been referenced.

When performing currency translation, different exchange rates such as average and period end rates, as well as formulas, are applied. A currency translation rule contains the necessary rates and logic for a unique account rate type. The account rate type must exist in the Account dimension in order to be triggered. However, you can create and name the currency translation rule first, and then assign the RATE_TYPE in the account dimension to the accounts to which it relates. When currency translation runs, it translates each account in accordance with the rules defined for the account rate type which has been assigned to that particular account.

If you need to store data in the local currency of the entity and also convert it to one or more reporting or group currencies, a currency type dimension must exist. In addition, the system must access a rate model that stores the exchange rates used for the automatic translation. The following list provides a summary of the environment requirements to support currency translation:

● The environment must include a rate model where exchange rates are stored. You must assign this rate model to any model that utilizes it.

● The model itself must include a currency type dimension and possibly a Group dimension.● The Currency (R type) dimension must include the properties:

○ REPORTING, whose values are Y or blank○ CURRENCY_TYPE, whose values are R for Reporting Currencies, T for transaction currency, or L for

local currency. The value G for group currency is used only if the currency dimension is also used to manage groups. This value is only relevant for models migrated from a previous version of SAP Business Planning and Consolidation.

196 PUBLIC


Administration

● For Consolidation type models, the Group (G) dimension must include the following properties:○ GROUP_CURRENCY, whose values are valid currencies in the previously mentioned Currency dimension○ CURRENCY_TYPE, whose values are G for group currency or N for Non-Group related data, meaning

local data● The Entity (E type) dimension must include the property CURRENCY, whose values are valid

Input_Currencies. Input currencies are listed in the currency dimension of the Rate model.● The Account (A type) dimension must include the property RATETYPE, values of the RATETYPE property

should be names of corresponding currency translation rules.● The Time (T type) dimension must include the properties YEAR, PERIOD, TIMEID, and MONTHNUM.● The Audit dimension is not mandatory for currency translation, but if you include it, the dimension must

include the following properties:○ DATASRC_TYPE, whose values include the following:

○ I - Input○ M - Manual Adjustment○ A - Eliminations and Adjustments○ L - Audit level (use only for consolidation)

○ IS_CONVERTED, whose values include the following:○ N - these members are ignored in the conversion○ Y (or blank) - these members are converted from LC into the desired currency unless the members

are flagged as requiring manual adjustment; these members have their currency conversions entered manually

○ G - these members are copied from the reporting currency of the group that is being translated into the currency member corresponding to the given group

● The Flow (S type) dimension is not mandatory for currency translation, but if you include it, the dimension must include the property FLOW_TYPE.

● The InputCurrency dimension within the applicable rate model must include the property MD, whose values are M for multiply rates or D for divide rates.

● The appropriate FXTRANS logic must be available.

The default translation reads all values in local currency where currency = LC, applies the correct exchange rate according to the applicable rate model, and writes the results in the appropriate reporting currency (USD, EURO, and so on).

Rate selection

For the selection of the correct rate, the following rules apply:

● The source currency is derived from the property CURRENCY of the entity being translated.● The rate to be applied during translation, such as Endflow, Histrate, and so on, is derived from the

property RATETYPE of the account being translated.● The valid rates are those corresponding to an account of the rate model for which the value of the GROUP

property is FX rate.● The system does not convert any accounts with a rate type that is not a part of the currency translation

business rules.

The default currency translation supplied with the product for multi-currency models performs a cross-rate translation; it multiplies the amount in local currency by the ratio between the rate of the destination currency and the rate of the source currency. This allows the model to use only one table of rates for translating any source currency into any destination currency.


Other types of translations can be defined by using the currency translation business rules tables and the relevant properties in the Currency and InputCurrency dimensions to support:

● the ability to use different tables of rates by reporting (destination) currency● the ability to distinguish between Multiply currencies and Divide currencies

Conditions for Running Currency Translation

Currency translation can run in the following two modes:

● Reporting currency modeReporting currency mode converts transaction data recorded in a local currency to the specified reporting currency. For this mode, make sure the script is similar to the following:*RUN_PROGRAM CURR_CONVERSION CATEGORY = %C_CATEGORY_SET%CURRENCY = %RPTCURRENCY_SET%TID_RA = %TIME_SET%RATEENTITY = GLOBAL......*ENDRUN_PROGRAMPay attention to the keyword CURRENCY. If running currency translation for the reporting currency, the keyword on the left side should be CURRENCY. If running currency translation for a group, use the keyword GROUP.

● Group modeGroup mode converts subsidiaries' data to a group's currency. This is mainly used before consolidation.

Whatever mode the currency translation runs in, the following conditions must be satisfied:

● The model must contain only one Currency (type R) dimension.● The model must contain only one Group (G type) dimension if the model is a Consolidation model.

For consolidation models migrated from previous versions of SAP Business Planning and Consolidation, this dimension is not mandatory, in order to ensure compatibility with the current version.

● The reporting model must reference the RATE model.● Some dimensions, such as Account, Entity, and Currency, must contain appropriate properties as noted in

the following table:

Model Dimension Property Description

Main Account RATETYPE The value of the RATETYPE property must be the name of a currency translation rule, such as AVG, END, and ENDFLOW.

198 PUBLIC


Administration


Main Entity CURRENCY The CURRENCY property denotes the local currency for the current entity. For example, for entity US, the currency is USD; for FRANCE, the currency is EUR. The value of this property must be a valid member of the InputCurrency dimension.

Main Currency CURRENCY_TYPE The CURRENCY_TYPE property specifies the currency type, and it should take the following values:

○ L (local currency)○ R (reporting currency)○ G (group, for compati

bility on migrated models only)

Main Group CURRENCY_TYPE The CURRENCY_TYPE property specifies if the member is a group/sub-group or is used to enter local data:

○ G (Group)○ N (Non-Group, used for

data input)

Main Time YEAR The YEAR property contains the year information of the ID. For example, if the ID is 2016.AUG, YEAR is 2016.

Main Time PERIOD The PERIOD property denotes the period to which the current time belongs. For example, if the ID is 2016.AUG, PERIOD is AUG.

Main Time PERIOD The TIMEID property is a numerical value for the current time. For example, for 2016.AUG, the TIMEID is 20160800.



Main Time MONTHNUM The MONTHNUM is defined to identify the closing period of a year. It's a number that stands for the chronological sequence of the base member in a Time dimension hierarchy during the same year. For example, for 2016.AUG, the MONTHNUM is 8.

The base member can be either a month or a day, depending on your cofigura-tion.

When optional dimensions such as Audit and Flow (S type dimension) do not exist, currency translation still runs successfully. However, if they do exist, they impact the translation process. In this case, the following properties in these dimensions are mandatory:

Dimension Property Description

Audit DATASRC_TYPE The DATASRC_TYPE property signifies the audit member type. The following four values are available:

● I (input)● M (manual adjustment)● L ( audit level, for consolidation

only)● A (eliminations and adjustments)

Audit IS_CONVERTED When the IS_CONVERTED property is set to N or blank, members are ignored in the conversion. When set to Y, members are converted from the local currency to the desired currency.

Flow FLOW_TYPE The FLOW_TYPE property can take many values, but the most important is the value CLOSING. The rule of currency translation with FORCE_CLOSING = Y makes use of it.

To run currency translation in reporting currency mode, the mandatory condition mentioned previously should be satisfied. If optional dimensions such as Audit and Flow (S type dimension) exist, the condition of the optional dimension is also necessary.

200 PUBLIC


Administration

To run currency translation in group mode, beside the same requirement as reporting currency mode, the following additional conditions are mandatory:

● The Ownership model must be set up and referenced.● In migrated consolidation models only, Group information must be maintained in a separate Group

dimension (except for models migrated from previous versions, where Groups can be maintained in a Currency dimension).When using the Currency dimension, Currency and Group information resides in the same dimension. The following properties are needed in Currency dimension:○ The ENTITY property can be blank or a valid Entity ID. It is used to define the link between the group

and the entity and to indicate the entity where the aggregation should be stored. (Refer to the STORE_ENTITY property below.)

○ The GROUP_CURRENCY property can be used only on CURRENCY members with the property CURRENCY_TYPE= G. It must contain a valid ID from the Currency dimension with the property CURRENCY_TYPE = R.

○ The STAGE_ONLY property controls the way the converted values must be saved in case of a multilevel conversion of groups. This property can have the three values Y, E, or N (blank).

○ The STORE_ENTITY property can have the values Y or blank. It indicates whether the system copies the results of the currency translation for the current group into the entity specified in ENTITY property.

○ The STORE_GROUP_CURR property can have the values Y or blank. It indicates whether the system stores the currency translation result in the group currency. Otherwise, the system stores the result only in gGoup, not in currency.

○ The PARENT_GROUP property defines the group hierarchy. The value of this property should be a valid Group ID in the dimension.

When currency and group reside in one dimension, make sure the script file is similar to the following before running currency translation for the group:*RUN_PROGRAM CURR_CONVERSIONCATEGORY = %C_CATEGORY_SET%GROUP= %GROUPS_SET% TID_RA = %TIME_SET% RATEENTITY = GLOBAL......*ENDRUN_PROGRAMPay attention to the keyword GROUP. If running currency translation in group mode, the keyword GROUP should be used instead of CURRENCY.In SAP Business Planning and Consolidation, when building a consolidation, both a group dimension and a currency dimension are required. Therefore, consolidation group members and currency members are held separately.A new dedicated dimension, for example, Group, should be type G.

When maintaining time properties, note that consolidation-related programs are allowed to run against base members in the same year only. The four properties of 'TIMEID', 'YEAR', 'PERIOD' and 'MONTHNUM' of base members affect those programs.

● Properties of parent nodes have no effect on those programs, and the value for these 4 properties should not be empty.

● The value for 'TIMEID' should be unique for each base member.● The value for 'YEAR' should be a four digit number for each base member.


● The value for 'PERIOD' should be unique for each base member in the same 'YEAR'. SAP suggests that 'JAN', 'FEB', and so on are used for Month members and that 'week01' or 'W01' for are used for week members.

● The value for 'MONTHNUM' should be unique for each base member in the same 'YEAR'. It should be a number that stands for the chronological sequence during the same year.

● Example for DAY members:

ID Period TIMEID MONTHNUM PARENTH1

2016.TOTAL TOTAL 365

2016.Q1 Q1 90 2016.TOTAL

2016.JAN JAN 031 2016.Q1

2016.08.01 DAY1 20160801 213 2016.AUG

2016.08.20 DAY20 20160820 232 2016.AUG

● In addition, the following is an example of a time dimension for Jan 12th 2016:

ID TIMEID Year Period MONTHNUM Base Period

2016.1.12 20160112 2016 D12 012 012

Related Information

Currency Conversion as Script Logic [page 191]Consolidation Monitor [page 31]

10.5.8.3 Intercompany Booking Rule

The Intercompany Booking function supports the overall intercompany reconciliation process.

Prerequisites

The following are required to perform intercompany eliminations within a model:

● Five additional data sources must be defined for the Data Source dimension in the IC_ORIGIN attribute. These data source members are used for IC data calculation, which is a preliminary step for intercompany bookings:○ I – Source data source to be used in IC data

202 PUBLIC


Administration

○ D1 – (user-defined description)○ D2 – (user-defined description)○ C1 – (user-defined description)○ C2 – (user-defined description)

● You must configure the IC Booking business rule in order to set up the business rule table.● The Account dimension must define a dedicated hierarchy to include all accounts for intercompany

booking.

This configuration not only allows intercompany details to be entered for any account, but supports automatic elimination by level for all desired accounts.

NoteAlthough not mandatory, intercompany reconciliation is normally performed in a separate Intercompany matching application apart from the actual Consolidation application.

Features

Intercompany booking records the declarations and reported balances by other entities against a particular entity. This allows business users within each reporting entity to run a report that matches all of its declarations and reported balances against the balances of the rest of the entities, without having to assign to each owner read-access for other entities. Bookings that make the Intercompany declarations match can be automatically generated, and details can be posted to the consolidation model.

You use the Intercompany Booking business rule table to define the posting rules the system uses to generate the entries to match the intercompany balances and declarations.

The consolidation engine supports a mechanism to perform the matching of intercompany declarations among the entities of a group. This mechanism is split into two independent procedures as follows:

● ICDATA: This procedure can be used to copy the declarations of all entities versus a given entity by intercompany account. It concentrates into each single entity the declarations of all other entities versus each entity. This mechanism allows the owners of an entity to run a report matching all of its declarations to those declared against it, without the need to assign to each owner Read permission into other entities.

● Intercompany Booking: This procedure can be used to automatically generate the bookings that make the intercompany declarations match.

By defining Seller, Buyer, or Greater in the business rule booking type, the system can automatically book the difference by assuming the correct value is Seller, Buyer, or the one with the greater booking value.

By configuring the Maximum Booking amount, you can set up the maximum threshold for automatic booking. Any differences bigger than this maximum value are kept for manual adjustment later.

Intercompany bookings are executed from the Consolidation Monitor in the Consolidation Central area.

Related Information

Intercompany Booking as Script Logic [page 190]


10.5.8.4 Carry-Forward Rule

Carry-forward populates the opening balances for the current year with the closing balances of the last period of the prior year.

Features

Carry-forward rules enable you to generate the Opening Balance of any category based on the following properties:

● Flow_Type in the Flow dimension: the value of this property should be OPENING on the relevant Opening flow and CLOSING in the relevant Closing flow.

● Category_for_ope, Opening_year, Opening_period in the Category dimensionCarry-Forward rules can be used to initialize a new reporting period with the closing balances of the last period from the previous year into the opening balances of the current period. It can also copy closing balances from a designated year ( Opening_year property) and period ( Opening_period property) to the current period. The designated year and period can be an absolute or relative number. You can also specify a Category in which to store the closing data using the Category_for_ope property. For example, you may need to create opening data in a Budget category using data from a Forecast category.

● DataSrc_Type, Opening_Datasrc, Copyopening in the Audit dimensionCurrently this procedure is limited to copying the opening balances as found in the Audit dimension members flagged as I and M in the DATASRC_TYPE property. The procedure copies only the input balances and their related manual adjustments. The balances generated automatically by the consolidation procedure ( Audit members flagged as A) are taken into account during the consolidation process by the consolidation procedure itself.The Copyopening property enables you to identify the members on which the carry-forward rule should be executed.The Opening_Datasrc property enables you to post data on a specific datasource when running the Carry-Forward rules.

● Within a carry-forward rule, the field Account specifies the Destination account. The property Same_period enables you to copy the same period balances to the current period. The YTD property enables you to sum up the balances of YTD to the current period.

In a legal consolidation model, such flows are often identified as members of a dedicated dimension. In simpler models, however, it is also possible to store them as additional accounts in the Account dimension.

Related Information

Carry-Forward as Script Logic [page 189]

204 PUBLIC


Administration

10.5.8.5 US Eliminations Rule

US eliminations functionality addresses the posting of Intercompany US eliminations in scenarios where a full legal consolidation model is not required, such as within a standard financial model.

Prerequisites

The following are required to perform Intercompany eliminations within a model:

● The model must include a dimension of type I, Intercompany.● The Intercompany dimension must include the property ENTITY, whose values are entity names.● The account dimension must include the property ELIMACC, whose values are account names.● The entity dimension must include the property ELIM, whose values are Y or blank.● The appropriate business rule table must be set up.● A Data Manager package executing the Intercompany logic must be available. This configuration not only

allows Intercompany details to be entered for any account, but it also supports an automatic elimination-by-level for all desired accounts.

Features

When reporting the financial results of a group of entities, you may want to see the results for the group net all Intercompany activity within the group. Therefore, the system identifies Intercompany activities and balances and posts entries so these activities and balances are fully eliminated when looking at the overall results for the group.

US eliminations functionality addresses the posting of Intercompany eliminations in scenarios where a full legal consolidation model is not required, such as within a standard financial model. When utilizing a legal consolidation model, Intercompany eliminations are normally handled as part of an eliminations and adjustments function.

However, in some cases you might want to leverage the same legal consolidation model to carry out activities for both US eliminations as well as eliminiations and adjustments , which is generally called Matrix Consolidation. In this model, you can maintain different sets of Entity and Interco dimensions respectively for US eliminations and elimination and adjustments. Then, if you enable the IMG parameter ENABLE_MATRIX_US_ELIM and set its value to X for this model using Tcode SPRO, you can specify Entity and Interco (Trading Partner) dimensions when setting the US Eliminination rule later.

Intercompany elimination entries should be reflected only in groups in which both the entity and the partner entity are part of the group. To address this, US eliminations uses a concept known as posting at first common parent.

Excepect in the case of matrix consolidation, US eliminations are generally used in financial models as opposed to legal consolidation models.

The US eliminations business rules define the audit members to eliminate. For each of these audit members you then define the corresponding destination audit member under which the system should post the elimination postings.


The values entered in the following properties determine default elimination logic:

Dimension Property Length in Characters Content

Account ELIMACC 20 A valid account against which the actual Intercompany account to be eliminated should be offset

Entity ELIM 1 Y or blank

Intercompany ENTITY 20 The entity ID corresponding to this Intercompany member

Currency REPORTING 1 Y or blank

The default elimination logic does the following:

● Scans all base level non-elimination entities (entities having the property ELIM <> Y).● In case the model has a currency dimension, restricts its action to all reporting currencies only (currencies

having the property REPORTING=Y). Data in local currency cannot be eliminated because it is in different currencies.

● Eliminates all values of the accounts to be eliminated (accounts having property ELIMACC<>blank) into the desired plug account (the account specified by the ELIMACC property itself).

● The elimination is posted to the elimination entity immediately below the first common parent. The common parent is derived as follows:○ For a particular record the system identifies the two entities for which a common parent must be

found. The first entity is the current entity member and the second entity is the entity corresponding to the current Intercompany member. This entity is obtained reading the content of the property ENTITY of the current Intercompany member.

○ The system searches in a selected entity hierarchy for the first member that has both entities as descendants. This is the common parent.

○ Then the system searches in the immediate descendants of the common parent for a valid elimination entity (an entity having the property ELIM=Y). This is the entity where the results of the elimination are stored.

The default elimination logic does its searches in the first organizational structure (hierarchy) of the entity dimension. This can be modified to have the elimination performed in all hierarchies existing in the entity dimension. If no common parent is found, no elimination occurs. If no elimination entity is found below the first common parent, the next common parent is searched.

More Information

For the execution of the US Elimination rule, refer to:

US Eliminations as Script Logic [page 188]

Execute Consolidation Task [page 128]

206 PUBLIC


Administration

10.5.8.6 Eliminations and Adjustments Rule for Legal Consolidation

You use this type of business rule when performing a legal consolidation process to generate adjustments and postings that integrate results from subsidiary reporting entities into consolidated financial statements in accordance with Generally Accepted Accounting Principles.

Eliminations and adjustments are executed as a separate task using a Data Manager package. They can also be executed from the Consolidation Monitor in the Consolidation Central area.

Prerequisites

Before executing eliminations and adjustments, do the following:

● Enter any ownership changes into the ownership InfoProvider, such as the acquisition of a new company, the sale or transfer of shares, and divestitures.

● Update consolidation methods and accounting methods as necessary.● Update percent ownership and percent control within the group.

NoteOwnership calculations can be run to calculate the overall ownership within each group. Consolidation parameters assigned to each entity within each group then need to be validated within the ownership InfoProvider.

You must have the following items in your environment before performing the eliminations and adjustments:

● Ownership ModelStores the overall ownership and percentage control of each entity by group on a category and time dependent basis as well as the corresponding method of consolidation to apply

● Group dimensionProvides the ability to store consolidated results by the group to which they relate

● Currency dimensionProvides the ability to store consolidated results in the currencies specified for each group

NoteYou can use a common dimension for both currency and group ONLY in models migrated from version 7.5. In this version of SAP Business Planning and Consolidation, you must use two separate dimensions - one for group and one for currency.

● Method-based multipliersDefine the formulas to use in calculating the amounts to post

● Eliminations and Adjustments rulesDefine the balances upon which eliminations and adjustments are made and the items such as accounts and flow to which calculated amounts are posted


Features

The most important of the necessary adjustments for legal consolidation relate to the elimination of intercompany activity between the various reporting units, and reclassifications and supporting the model of the applicable rules for the accounting of long-term investments. Eliminations and adjustments rules support the calculation and generation of these postings.

Eliminations and adjustments rules are applicable only to a legal consolidation model to which you attach a corresponding ownership model.

When eliminations and adjustments rules are executed for a given group, the system performs the following:

● Reads from the ownership model which entities make up the group, the applicable consolidation method, and the ownership and consolidation percentages.

● Determines for each elimination and adjustment defined in the business rules the base amount upon which the elimination and adjustment is to be calculated based on the source data.

● Identifies for each elimination and adjustment the corresponding method-based multiplier from the business rules.

● Based on the identified method-based multiplier and the method of consolidation assigned to a given entity, determines the formulas to apply in calculating the amounts to post. Ownership and consolidation percentages can be applied in the calculations.

● Posts the calculated amounts based upon the posting rules defined in the Eliminations and Adjustments business rules tables.

The following information describes the fields of the General tab in the Business Rules interface of Eliminations and Adjustments:

● Source Audit ID: Restricts the type of transaction data to which the rule applies. This can be a member of the audit dimension, or a DIMLIST in the audit dimension. This field can also be blank to represent all audit members with an audit type of I or M. (You can use Adjustment Level to apply further restriction.)

● Destination Audit ID: Indicates the kind of data the rule generates. This should be one base member with an audit type of A.

● Group Type Filter: Restricts the rule to specific group or scope members.● Entity Property Filter: Similar to Group Type Filter, this restricts the rule to specific entity members.● Adjustment Type: Defines the rule type. Possible values are the following entries:

○ Blank: generic rule type○ N: for new entities in the group/scope; similar to a generic rule○ P: for proportional entities○ E: for equity entities○ D: for entities that leave the group/scope in the middle of the year○ L: for entities that leave the group/scope in the beginning of the year○ I: for integration consolidation, which deals with the inconsistencies that occur when some

consolidation rules are defined using periodic mode while the ownership hierarchy changes during the fiscal year. For more information, see Integration Rule for Consolidation [page 213].

● Adjustment Level: Indicates the execution sequence of all elimination rules. The system executes an elimination rule with an adjustment level of 0 first, then level 1, then 2, and so on. The result of an elimination rule with a lower adjustment level can be the input of an elimination rule with a higher adjustment level. The source audit ID for an elimination rule with an adjustment level larger than 0 has further restrictions.

208 PUBLIC


Administration

● Other Dimension Filter: A string in this field indicates filters or special restrictions on other dimensions. For example, if you have a user-defined dimension called Product and you want to run an elimination for only one of its members called Pro1, you would enter Product = Pro1.

● Force Destination Member: When filled, indicates the value to which the system should force the elimination result. For example, if you enter Product = ALL, then for the generated elimination result, the system populates the dimension Product to ALL, no matter what the original value was.

● Ownership Filter: Filters the ownership value. For example, to apply a rule to only those entities whose ownership percentage in a group or scope is larger than 70%, you enter POWN > 0.7.

Related Information

Consolidation Monitor [page 31]Method-based Multipliers and Consolidation Methods [page 209]

10.5.8.6.1 Method-based Multipliers and Consolidation Methods

You can set up global business rules at the environment level. Once the headers, methods, and rules are defined, they can be used in all related business rule tables within an environment.

Features

You populate the following two global definitions:

● Method-based multipliers● Consolidation methods

Global Definitions

You can add a new Global Definition in Planning and Consolidation Administration by:

● Selecting the type of Global Definition (Method or Method-based Multiplier)● Entering the required fields● Saving or validating the Method or Method-based Multiplier

Once defined, the rule can be used in any model in the environment.

Consolidation methods

The Consolidation Method list describes the accounting methods available for consolidating each entity.


Field Name Description

Method code ● The unique method code. The value must be an integer between 1 and 98

● 99 - a reserved value and means any method, consequently it cannot be assigned to any entity

Method name The name of this method.

ExampleLeaving, Equity, Proportional, Global, Holding.

Method type The Entity method type.

Available types: New, Holding, Global, Proportionate, Equity, Leaving (During the Year), Disposed at last year-end

Method-based multipliers

Method-based Multipliers control how the amounts or the destination accounts should be calculated.

You define a name (ID), a description, and a type as noted in the following table. The consolidation method defined in the Type field limits the use of the rule to the specified type of consolidation method.

The calculation of consolidated data is controlled by the multiplier being used, the consolidation method assigned to the current entity, and its Intercompany partner, if applicable.

The following fields can be defined:


ID The identifier of the rule.

ExampleRULE01

Description A description of the rule.

ExampleEquity, 100% Minority part, Dividends, Stock Holder Equities, Intercompany elimination

210 PUBLIC


Administration


Type The consolidation method using the method-based multiplier can be restricted to:

● Proportional● Equity● Leaving● Disposed● New● or blank

Entity Method A valid entity method, as defined in the Consolidation Methods list, or a list of entity methods separated by commas to which the multiplier applies.

IntCo Method A valid entity method, as defined in the Consolidation Methods list, a list of entity methods separated by commas, or 99 for all methods. For the Intercompany dimension, this is the entity value to which the multiplier applies.



ALL Formula An expression that represents the percentage (or formula) to apply to the Destination All account property from the Eliminations and Adjustments business rule.

The value can be an arithmetic expression combining any defined percentage in the account dimension of the ownership model. All percentages where the property IS_INPUT is equal to Y can be used. Note the following guidelines:

● The members must be enclosed in square brackets.

Example[POWN], [PCTRL], [POWN]

● Add the prefix P to the percentage to use the Prior value.

Example[PPOWN], [PPVOTE]

● Add the prefix I_ to the percentage to add the Intercompany value.

Example[I_POWN]

● The syntax of the prior value can be combined with the syntax of the INTCO value.

Example[I_PPOWN]

NoteThe calculation of POWN by both direct share method and group share method is supported.

We also support the calculation of PCTRL (calculation of ultimate control %) in the business rule tables.

There are two options for obtaining results: system calculations and manual updates. There is also an option to change from system to manual while calculating. This gives you the means to manage security by protecting system calculations that cannot be overwritten by manual updates.

To support this, we also provide the O_ACCT dimension in EnvironmentShell by adding a set of members that store only system cal

212 PUBLIC


Administration


culations. The members are POWN_SYS, PCTRL_SYS, and METHOD_SYS.

Group formula An expression that represents the percentage (or formula) to apply to the Destination Group account from the Eliminations and Adjustments business rule. The value can be an arithmetic expression combining any defined percentage as defined by the Account dimension of the Ownership model. All percentages where the property IS_INPUT is equal to Y can be used. The percentage must be enclosed in square brackets. See the All formula field above for further details.

Minority formula An expression that represents the percentage (or formula) to apply to the Destination Minority account from the Eliminations and Adjustments business rule. An arithmetic expression combining any defined percentage as defined by the Account dimension of the Ownership model. All percentages where the property IS_INPUT is equal to Y can be used. The percentage must be enclosed in square brackets. See the All formula field above for further details.

Remark Text for this rule.

10.5.8.6.2 Integration Rule for Consolidation

Integration consolidation deals with the inconsistencies that occur when some consolidation rules are defined using periodic mode while the ownership hierarchy changes during the fiscal year.

Context

When you save or validate the I type rule in in the business rules user interface of Eliminations and Adjustment, the validation checks the following fields:

● Destination Audit Member must be blank.● Entity Property Filter must be blank.● Other Dimensions Filter must be blank.● Force Destination Members must be blank.● In the rule details, Force interco member and Swap entity interco cannot be selected.● In the rule details, Source Flow and Destination Flow cannot both be empty.

In the rule details, method-based multipliers must be used. Also, the integration rule must be 99 as the intercompany method. However, rule validation does not check this.

How the integration rules work


When the integration mode is enabled for a model, the currency translation does not generate results on the group level.

You can find a new type of consolidation rule with rule type I. The definition of the consolidation rule with type I is similar to the generic consolidation rule. The main difference is that for the integration rule, you do not have to define the destination audit ID because the integration rule keeps the audit ID unchanged.

When using the integration rule, you can customize how the translated results in the reporting currency are posted to the consolidated results to a specific group. When integration mode is enabled, you do not have to define consolidation rules with types E, P, D, and L because these types of rules can be replaced by integration rules. After integration mode is enabled, the previously defined rules with types E, P, D, and L are hidden from the user interface and are used in the consolidation calculation. You cannot create new rules with types E, P, D, and L after integration mode has been enabled.

To enable the integration rule in consolidation, perform these steps:

Procedure

1. On the navigation panel, go to Administration Modeling Models .2. Choose the model for which you want to enable integration mode. Only a Consolidation-type model can

enable integration mode.3. Edit this model by checking the Consolidation-Use Integration Rules option.4. Save the change.

10.5.8.7 Equity Pick Up Rule

Equity pick up aims at reevaluating investments made in subsidiaries by making a comparison between the book value of an investment and the subsidiary’s total equity.

For detailed information about how to enable and define equity pick up rule in live business scenarios and how to run equity pick up rules, refer to Equity Pick Up User's Guide.

Related Information

Business Rule Setting [page 127]Business Rules Management [page 194]

214 PUBLIC


Administration

https://help.sap.com/http.svc/rc/645d4e8ac6ec498a89803a00b0a69029/10.0.23.0/en-US/PC_NW10_Equity_Pick_Up.pdf

10.5.9 Controls

Controls enable you to test the validity of data gathered in a reporting process.

Use

Controls can be applied to any type of data. For example, a control can be used to check whether assets equal liabilities for data entered in data entry schedules or for adjustments entered in journals.

Controls are run on the data available in the model in loaded data (local currency), translated data, or consolidated data, on base entities. If a dimension is deleted from the model, all control results relevant to that dimension are also deleted.

Controls are grouped into control sets.

The main steps to follow when setting up your controls are as follows:

Control steps

Location Step Additional Information

Business Planning and Consolidation Administration

1. Associate a level to each entity in the entity dimension

2. Enable controls for a selected model

3. Create controls Define control level, tolerance threshold, expression, and so on.

4. Create control set and add controls

5. Assign control set to Category/Time combination

Consolidation Central 6. Run controls Only controls in the control set with a level less than or equal to the level of the Entity are run.

7. Monitor controls

NoteAn entity for which no control level is defined is automatically assigned a control set status of Level 4, meaning all controls are run when a control set is executed.

You manage controls in Planning and Consolidation Administration Rules Controls .

You execute controls in Consolidation Central Controls Monitor . You can also execute tasks in a business process flow, provided that the relevant tasks are set up in the business process flow definition.


Prerequisites

To view the Controls page in Planning and Consolidation Administration, you must have the View Controls Manager right. You can go to Security Task Profile to create and assign corresponding tasks to teams or users.

Features

A control has two output values:

● The calculated amount for the controlControls are calculated at the Entity level in loaded data (local currency), translated data, or consolidated data.

● The control statusWhen a control set is executed, the status is a roll-up of the status of all the controls available in this set. If any problems are detected when the controls are run, warnings or errors are generated. A warning does not prevent the data from being validated in the workflow. A blocking error prevents the data from being validated, meaning the work status cannot be modified for the corresponding category, time and entity members. For more information, see Control Set Status [page 40].

Enable controls

Controls can be enabled or disabled at the model level in Planning and Consolidation Administration.

Before enabling controls, make sure the Entity dimension contains two properties: Control Level and CTRL_CURRENCY_NOT_LC (Bypass LC in Ctrls)

NoteTo enable controls, work status dimensions must be set with at least three main dimensions: Category, Time, and Entity. For more information, see Create a Control [page 217].

When enabling controls for a model, you can choose whether the context of the control monitor is derived from the work status or set manually. You can also set the context of the control monitor on the parent node by selecting the checkbox Parent Node Enabled while choosing dimensions. After that you will be able to run controls against all leaf nodes under the parent node.

Edit Assignments

A control set must be assigned to a Category/Time dimension pair to be executed. For more information, see Assign a Control Set [page 226].

You can have dynamic control on work status by using the Derive from Work Status option. This allow users to change a work state in Consolidation Monitor even though a failed result exists. All selected work statuses cannot be changed when there is a failed result; the control result must be checked and reviewed. However, any unchecked work status can be changed even though a failed result exists.

216 PUBLIC


Administration

Activities

● To enable controls1. In the Controls page, select the model whose control sets you want to enable.2. Select Enable controls.3. Define under which context you want to run controls by choosing Derive from Work Status or Select

Dimension.○ If you choose Derive from Work Status, the context bar of Control Monitor will be made up of the

driving dimension and other dimensions of the corresponding work status.By default settings, if you failed to run a control, you cannot change any work statuses until the control passes the check. To offer more flexibility, you can still change one or more work states in Consolidation Monitor even though a failed result exists by unchecking the corresponding work states.

○ If you choose Select Dimension, the context bar of Control Monitor will be made up of the selected dimensions.If you select the checkbox Parent Node Enable for a dimension, you will be able to run controls against the parent node and all its leaf node members in Control Monitor. If you do not select the checkbox Parent Node Enable for a dimension, you will not be able to select parent node members of the dimension to run Control Monitor.

4. Click Save to save the settings.

● To display the Controls page in Planning and Consolidation Administration, select Rules Controls .● To display a control definition:

1. In the Controls page, select the model containing the control(s) you want to view.2. In the Controls for <Model name> page, click an individual control to display its properties.

● To edit assignments for a control set, see Assign a Control Set [page 226].

10.5.9.1 Create a Control

This topic contains information about creating a control.

Prerequisites

You need to make sure that a value has been specified for the MONTHNUM property in the Time dimension.

Procedure

You create controls in the Controls page of Business Planning and Consolidation Administration.

To create controls in SAP Business Planning and Consolidation, do the following:

1. Select Planning and Consolidation Administration Rules Controls .


2. Select the model for which you want to create a control.3. Click Open to display the list of existing controls for that model, then click New.

When dimensions are added or removed from the system, control definitions containing a deleted dimension are updated accordingly and are marked as being invalid for change tracking reasons. Impacted control definitions must be verified. If a dimension is removed from a model, all control results are deleted.

If a driving dimension is added to the Work Status definition, control results are deleted as well as existing locks. This new dimension is also removed from the control expression, since driving dimensions cannot be used in control expressions. If a dimension is removed from the Work Status, all control data is cleared and control expressions must be verified accordingly.

The control properties that you can define include:

● ID● Description● Rule Type● (Control) Type● Execution Level● Equation Type● Control Level● Breakdown Dimensions● Absolute Value● Tolerance Threshold● Expressions● Documents

ID

A control must be identified with a unique code.

Description

A control description should clearly and concisely describe which verification is being performed and for which reason, and what the accounting, financial, or economic logic is. For example, "Assets = Liabilities".

Rule Type

● Standard: Choosing this option will use the standard configuration validation rule.● Customized: Choosing this option means this rule will use the validation logic implemented in

BADI_UJCTRL_RUN_CONTROL.

(Control) Type

You assign one of the following two control types:

● Blocking: Prevents the user from going to the next work status level until the blocking status is cleared.● Warning: Warns the user of noncritical data quality issues. Does not prevent the user from going to the next

work status level.

Execution Level

Select one or more types of data to which this control pertains:

● Loaded data● Translated data

218 PUBLIC


Administration

● Consolidated data

See the section Activate the Execution Level Field below for information on how to enable the use of this field in your system.

For detailed information about the data validation range of each execution level, refer to SAP note 2263755 .

Equation Type

You choose the operand for the expression: =, >, <, >=, <=, <>. The operand determines how the two amounts in the expression will be compared.

Control Level

This field is linked to the Control Level property in the entity dimension. A control level is defined for each control, organizing the controls by rank so the relevant data can be verified.

Four control levels are available:

● Basic: Level 1● Standard: Level 2● Advanced: Level 3● Comprehensive: Level 4

Controls are executed according to the control level associated with the selected entity. See Execute a Control Set [page 39]. If an entity has no control level defined, it is automatically assigned Level 4, meaning all controls are run when a control set is executed. For more information on entity control levels, see Control Set Status [page 40].

Breakdown Dimensions

Choose up to two dimensions for which the control should be executed on all members. Breakdown dimensions allow you to define controls to be run on any type of data, for example, input, manual adjustments, automatic adjustments.

ExampleCTRL1 is defined as TOTAL_ASSET = TOTAL_LIABILITIES, breakdown dimension: DATASOURCE with member TOTAL_INPUT specified in the control expression. TOTAL_INPUT is the aggregation of INPUT, INPUT_ADJ1 and INPUT_ADJ2.

When the control is executed, it compares TOTAL_ASSET versus TOTAL_LIABILITIES for both members INPUT, INPUT_ADJ1 and INPUT_ADJ2. As a result, if two members generate an error, the following information is generated:

● One row appears displaying the aggregated information for the control, without data in any of the columns except for the status, which displays as Failed.

● Two rows appear for the given control to display the detailed calculations with data for both lines.

NoteAny dimension can be used as a breakdown dimension, except for dimensions used as driving dimensions in the Work Status setting, currency dimensions, and group dimensions.

Absolute Value



Selecting Absolute Value indicates that the system should treat the value for the control as an absolute (non-negative) value regardless of whether it is positive or negative.

ExampleResult A is 100 and result B is -125. If you set the rule to check whether result A is larger than (>) result B and you do not select Absolute Value, then it passes. If you select Absolute Value for this rule however, the system compares 100 and 125, and the result fails.

Tolerance Threshold

The tolerance threshold is an amount that is compared to the difference between the two amounts (the "control result"). If the control result is less than or equal to the amount defined in the tolerance threshold, then the difference is considered to be insignificant and the control status is considered to be OK.

Example

Expression of control for amounts x and y

Comparison difference/tolerance

Control result Example

x = y < Tolerance Valid Tolerance entered: 1

Amount x: 1,000,000

Amount y: 1,000,000.5

Difference: 0.5

The difference is less than the tolerance. The two amounts are therefore considered equal.

The control, run to check if the two amounts are equal, is therefore valid.

> Tolerance Error or warning

x < y < Tolerance Error or warning Tolerance entered: 1

Amount x: 1,000,000

Amount y: 1,000,000.5

Difference: 0.5


The control, run to check if x is less than y, is therefore in error.

220 PUBLIC


Administration

> Tolerance and x < y Valid

> Tolerance and x > y Error or warning

x > y < Tolerance Error or warning

> Tolerance and x > y Valid

> Tolerance and x < y Error or warning

x ≤ y < Tolerance Valid Tolerance entered: 1

Amount x: 1,000,000

Amount y: 1,000,000.5

Difference: 0.5


The control, run to check if x is less than or equal to y, is therefore valid.

> Tolerance and x < y Valid

> Tolerance and x > y Error or warning

x ≥ y < Tolerance Valid

> Tolerance and x > y Valid

> Tolerance and x < y Error or warning

Expressions

The expression is the formula used for identifying the two amounts to be compared. In the Expressions tab, the upper panel contains the formula for identifying the first amount to be compared. All the dimensions must be specified.

When breakdown dimensions are specified, an icon appears in the column header identifying that dimension as a breakdown dimension.

The lower panel contains the formula for identifying the second amount to be compared, which can be from another Category, Time, or Group.

In the Category field you can enter any member from the Category dimension. In the Year Offset field, you can enter an integer preceded by "+" or "-". In the Period field you can enter an integer which is associated to the MONTHNUM property of the Time dimension. For relative periods, "+" or "-" signs can be used; for example, for the previous month you enter "-1".


If the lower panel is left blank, the first member of the expression that was defined in the upper panel is compared to zero.

Documents

Microsoft Excel input schedules and reports, as well as worksheets from Business Planning and Consolidation, can be attached to controls. Later, if you have failed to run a control in Control Monitor and you then choose Open Controls Results, you can directly navigate to the attached document to aid you in problem-solving the issue.

Activate the Execution Level Field

Follow these steps to make the Execution Level field visible in the Web client:

1. Go to transaction SPRO.

2. Navigate to Planning and Consolidation Configuration Parameters Set Global Parameters .3. In the Global Parameter window, add the ENABLE_CTRL_ON_DIFF_LEVELS parameter and set its value to

X.4. Clear the cache of the system.

10.5.9.2 Working with Control Sets

A control set is a grouping of controls. In order to create, modify, copy, or delete a control set, you must have the Edit Controls Manager right.

Control sets are associated to a particular model. You can define more than one control set for a model. The controls in a control set are organized in the order in which they are executed. A control set must be assigned to a Category and Time dimension pair in order to be executed.

Control Set Properties

The control set properties include:

● IDA control set must be identified with a unique code. This field is mandatory.

● DescriptionA control set should clearly describe the type of verifications to be performed.

Related Information

Create a Control Set [page 223]Display or Modify a Control Set [page 224]Copy a Control Set [page 225]Delete a Control Set [page 225]Assign a Control Set [page 226]

222 PUBLIC


Administration

Additional Actions Involving Control Sets [page 227]

10.5.9.2.1 Create a Control Set

Prerequisites

To edit controls in Planning and Consolidation Administration, you must have the Edit Controls Manager right. You can go to Security Task Profile to create and assign corresponding tasks to teams or users.

Context

A control can be assigned to more than one control set.

Procedure

1. Select Planning and Consolidation Administration Rules Controls .2. In the Controls page, select the model where you want to add the control set and click Edit Sets in the

toolbar. Alternately, click the number in the Sets column corresponding to the model where you want to add the control set.

3. In the Control Sets: <Model name> page, click New in the toolbar.4. Specify a name and a description for the control set.5. To add controls to the control set, click Add/Remove in the toolbar.6. In the Add/Remove Controls dialog box, use the arrows to move controls from the Available Controls list

into the Selected Controls list, then click OK.7. Save the control set.

Related Information

Working with Control Sets [page 222]Display or Modify a Control Set [page 224]Copy a Control Set [page 225]Delete a Control Set [page 225]Assign a Control Set [page 226]Additional Actions Involving Control Sets [page 227]


10.5.9.2.2 Display or Modify a Control Set

Prerequisites

You must have the Edit Controls Manager right.

Context

A control can be assigned to more than one control set.

Procedure

1. Select Planning and Consolidation Administration Rules Controls .2. In the Controls page, click the number in the Sets column corresponding to the model for which you want

to display all the control sets. Alternately, select the row containing the model and click Edit Sets in the toolbar. You can also directly click the Go To: control sets hyperlink in the Controls list page.

3. In the Control Sets: <Model name> page, select the control set that you want to display or modify.4. To add or remove controls from the control set, click Add/Remove.5. In the Add/Remove Controls dialog box, use the arrows to move controls between the Available Controls list

and the Selected Controls list, then click OK.6. Save the control set.

Related Information

Working with Control Sets [page 222]Create a Control Set [page 223]Copy a Control Set [page 225]Delete a Control Set [page 225]Assign a Control Set [page 226]Additional Actions Involving Control Sets [page 227]

224 PUBLIC


Administration

10.5.9.2.3 Copy a Control Set

Copying an existing control set allows you to quickly create a new control set, which you then modify as needed. You can also quickly initialize a control set containing multiple controls, without having to add the controls one by one.

Prerequisites


Procedure

1. Select Planning and Consolidation Administration Rules Controls .2. In the Controls page, select the model containing the control set you want to copy and click Edit Sets in the

toolbar.3. In the Control Sets: <Model name> page, select the control set and click Copy in the toolbar.4. In the Copy Control Set dialog box, enter a name and description and click OK.

The copied control set contains the same controls as the original control set. You can then modify the control set as needed.

Related Information

Working with Control Sets [page 222]Create a Control Set [page 223]Display or Modify a Control Set [page 224]Delete a Control Set [page 225]Assign a Control Set [page 226]Additional Actions Involving Control Sets [page 227]

10.5.9.2.4 Delete a Control Set

Prerequisites



Context

Deleting a control set does not delete the associated controls.

Procedure

1. Select Planning and Consolidation Administration Rules Controls .2. In the Controls page, select the model containing all of the control sets you want to delete and click Edit

Sets in the toolbar.3. In the Control Sets: <Model name> page, select all control sets you want to delete and click Delete in the

toolbar.

Related Information

Working with Control Sets [page 222]Create a Control Set [page 223]Display or Modify a Control Set [page 224]Copy a Control Set [page 225]Assign a Control Set [page 226]Additional Actions Involving Control Sets [page 227]

10.5.9.2.5 Assign a Control Set

To execute a control set, you must specify when you want your control set to be run and on what type of data, by assigning at least one Category/Time dimension pair to your control set.

Context

Creating a category/time pair consists of choosing at least one category and one period per control set.

Procedure

1. To assign category/time pairs to control sets, in Business Planning and Consolidation Administration select Rules Controls .

226 PUBLIC


Administration

2. In the Controls page, select the row of the model containing the control sets for which you want to define assignments. Alternately, click the number in the Assignments column corresponding to the required model.

Related Information

Working with Control Sets [page 222]Create a Control Set [page 223]Display or Modify a Control Set [page 224]Copy a Control Set [page 225]Delete a Control Set [page 225]Additional Actions Involving Control Sets [page 227]

10.5.9.2.6 Additional Actions Involving Control Sets

You can display category/time pair assignments for control sets, display additional periods or categories, and sort and move columns.

Display category/time pair assignments for control sets

There are two ways to display the category/time pair assignments for control sets:

● Show Categories by TimeYou select the option Categories by Time to display the active control sets assigned to each category and period intersection.In the Assignments grid, the categories are listed in rows and the periods are listed in columns. Assigned control sets appear in the grid in cells at the intersection of a category and a period.To modify an assignment, click Edit and double-click in a cell to display the list of available control sets. You can then assign a control set to the selected category/time pair.

● Show Control Sets by TimeYou select the option Control Sets by Time to display the category/time pairs organized by each available control set.In the Assignments grid, the active control sets are listed in rows and the periods are listed in columns. Expand a control set by clicking its arrow to display the selected categories; in doing so you display the category/time pairs for the expanded control set in the form of a checkbox in each grid cell. If the checkbox is selected, the control set is run for that category and period.

NoteThe Control Sets by Time view is for consultation only. You cannot modify the category/time pairs in this view.

To display additional control sets, click Control Sets and select additional control sets in the Member Selector dialog box.

Display additional periods or categories


You can display additional periods or categories in the Assignments grid. Click Category or Time in the toolbar and make your selections in the Member Selector dialog box. The additional dimension members are displayed in the grid.

NoteYou can define and implement your own validation logic by leveraging the BAdI UJCTRL_RUN_CONTROL. For detailed information, refer to SAP note 2264009 .

Related Information

Create a Control Set [page 223]Display or Modify a Control Set [page 224]Copy a Control Set [page 225]Delete a Control Set [page 225]Assign a Control Set [page 226]Additional Actions Involving Control Sets [page 227]

10.6 Business Process Flow Management

This function enables you to create and manage business process flow (BPF) templates - also called process templates - and manage the processes created from these templates.

A process template is the specification of a single enterprise-wide business process, containing tasks that can span across the various modules of Business Planning and Consolidation. It defines the business processes that are presented to users as a prepackaged set of application tasks. For an additional level of control over the workflow, you can integrate work status rules.

Once you have completed a process template, you can create a process based on the template, in the Administration screen. A process represents an iteration of the enterprise-wide business process, which allows the user to see only the tasks relevant for that user, given his or her role and data access privileges.

Prerequisite

You must have the Manage BPFs task profile assigned to you in order to manage business process flows.

228 PUBLIC


Administration


Features

The following functions are available to authorized users:

Function More Information

Create new process templates You can create a new process template on which to base processes, copy existing process templates, and modify existing templates. For more information, see Creating New Process Templates [page 230].

Validate process templates When you create a new process template, the system automatically validates the template for completeness before saving the template. The result of this validation is shown in the Status column. A template can be Valid or Invalid. If it is invalid, you can revalidate it by selecting the template , and clicking Validate.

Unlock process templates If the system automatically locks a template because you unexpectedly logged off while editing, you can unlock it by selecting the template and clicking Unlock.

Note that you cannot unlock templates that are locked by other users. To find out who has locked a template, select the template and click Versions.

Deploy a template If a template is not locked and has a status of Valid, you can deploy it so that it can be used for creating processes. Select the template, and click Deploy.

Copy a template and create new version If you want to create a new template based on an existing template, select the template you want to copy and choose Copy.

Once a template is deployed for creating processes, it can no longer be modified. To make changes to a deployed template, you can select the template and choose New Version.

View all templates and versions If you select a template and choose Versions, the Template Versions window opens. The list contains all versions of the selected template. To view an obsoleted version of a template, select a template in this window and click View.

Archive process templates You can archive process templates. When you archive a process template, all processes based on the template must be completed beforehand because they will also be archived.


Function More Information

Integrate external workflows with BPFs You can integrate external workflows with BPC BPF processes to accommodate complicated planning processes. For more information, see External Process Integration [page 246].

10.6.1 Creating New Process Templates

With the correct authorization, you can use this process to create a new process template. You can define up to 100 process templates for each environment.

Process

1. Go to Administration and under the Business Process Flows section, choose Process Templates.2. Choose New to start the creation of a new process flow.3. On the Process Settings tab, provide details such as name and description of the business process flow.

You must also enter the controlling model.See Process Settings [page 231].4. On the Activities tab add activities to represent the flow of the business process. See Activities [page 232].

You can create a new activity as well as duplicate an existing activity and then modify it. You can also change the order of activities.

5. You can add actions to define the specific tasks users perform within the activities. See Defining Actions [page 241].

6. When you save a new process template, the system automatically validates the template to ensure it is properly defined and completed before saving the template. The result of this validation is shown in the Status column. A template can be Valid or Invalid.Template validation is a prerequisite for creating a process.

NoteValidation occurs every time that you click Save. So, if you make an interim save to avoid losing your work, you will probably receive some validation errors or warnings. You can view these by choosing See Details next to the warning message. You must solve all validation errors before deploying a template.

7. Deploy the saved template.You can only create process instances based on a template that has been deployed. Once you deploy a template, you cannot make any more changes to it. However, you can create a new version of that template and edit it.

Result

Based on the process template you created, you can generate processes in the Administration screen and perform actions on the process instances. See Creating Process Instances [page 243].

230 PUBLIC


Administration

10.6.1.1 Process Settings

Before creating a process template, you provide basic information that identifies the process template. If you want to further modify a process template, you can use the same features as the setup process described in this topic.

The following table describes the information you need to complete the setup process in the Process Settings tab:

Item Description

Name The name of the process template.

Description A description for the process template.

Model The model governs both identity dimensions, including the time dimension for process instances and the available dimensions for activity context.

If, for example, you select the Planning model, whose Time dimension is in monthly increments, the process template works in monthly time increments, as well.

Identity Dimensions One or more dimensions common to all processes created from this template.

The identity dimension is used to distinguish a BPF instance. The members of any identity dimensions must be specified every time a new BPF instance is created.

NoteThe system automatically selects the Time dimension, since it is required for all processes.

Process Monitors These are the users that have rights to monitor and change processes created from the process template.

Check only the current step when reopening By default you must be the performer or reviewer of both the current activity and the next open activity to reopen the current activity.

For detailed information about how to change default settings so you can reopen the current activity as the performer or reviewer of the activity, refer to Criteria for Reopening Activities [page 238]

Activities

To create a process template from scratch, go to Administration and under the Business Process Flows section, choose Process Templates. Choose New to start the creation of a new template.


You can also use Copy or New Version to create a process template based on an existing template.

To define activities within the business process flow, choose the Activities tab. For more information, see Activities [page 232].

10.6.1.2 Activities

You can create activities that form part of a process.

For guidelines on defining activities, see Criteria for Defining Activities [page 234].

The following table summarizes the information that you need to supply for each activity:

Item Description

General

Name Provide a title for the activity.

Description Provide a description of what is to be done in the activity. This is the instruction that is displayed to a user performing a process based on this process template.

Opening Criteria Select the appropriate radio button to open by All activity contexts or Matched activity contexts.

For more information, see Criteria for Opening Activities [page 236].

Allow Reopen To allow authorized users to reopen an activity, select the checkbox.

For more information, see Criteria for Reopening Activities [page 238].

Driving Dimension

Driving Dimension Select the driving dimension.

This is the dimension that is common to all activity contexts that users might use for completing the tasks in the activity.

NoteThis dimension must have a defined Reviewer property.

For more information, see Defining Activity Context Criteria [page 235].

232 PUBLIC


Administration

Item Description

Members In the Members drop down list, clicking Select MembersCriteria Editor. You can directly select members

from one hierarchy or click to filter members by dimension property and add them to the Selected Members list as a batch.

For more information, see Defining Activity Context Criteria [page 235].

Activity Performer

Performer Select the property that defines the performer for each member.

To define an action that a performer must perform when reviewing the activity.

A Performer is the person, to whom the activity is provided to at run time, that is the person, who has to perform the work items in the activity and mark it as complete. This can be one or more users, or a team. Performers are determined by a property of the dimension used as driving dimension of the activity. You can select the “Owner” property or any other property for this. Owner property has a specific meaning in Business Planning and Consolidation; it is the dimension property that determines who can change the work status of each member to anything other than unlocked. So you could choose to have an activity that is performed by the same owner as work status.

For more information, see Defining Actions [page 241].

You can define a deadline for the activity’s performer in process templates. The deadline is calculated in days by default starting from the end of the last activity. You can also define whether to wait or to close the activity when the activity deadline occurs. The deadline you set in BPF templates can be adjusted in BPF instances later. For more information, see Setting Deadlines for Activities [page 240].

Activity Workspace By choosing Create you can create hyperlinks. You can also create worksheets.

Activity Reviewer

Require Reviewer If required, select this checkbox and select a property that defines the reviewer for each member.


Item Description

Reviewer You select the reviewer in the same way as selecting a performer, but you can select a different property to determine the reviewer users.

For more information, see Defining Actions [page 241].

Deadline You can define a deadline for the activity’s reviewer in BPF templates. The deadline is calculated in days by default starting from the end of the last activity. You can also define whether to wait or to close the activity deadline fell occurs. The deadline you set in BPF templates can be adjusted in BPF instances later. For more information, see Setting Deadlines for Activities [page 240].

Activities

To create a new activity, click New; to edit an existing activity, select the activity. To copy an existing activity, select the activity, and chose Duplicate. You are offered the opportunity to duplicate the activity definition and contents, or just the activity definition.

You can preview instances of this activity by clicking Preview Activity Instances.

Once you have defined an activity, you can create a working area where users can add, view, and manipulate data. Choose Create a performer workspace. This opens a workspace, that is driven by the process and whose driving dimensions are those defined for the activity. In this workspace, you can add any Business Planning and Consolidation function for data entry, creating reports, and so on. For more information, see Defining Actions [page 241].

You can define a workspace for each activity. You can choose whether the reviewer uses the same workspace or has a separate workspace for reviewing this activity. You can also set a deadline for the performer and the reviewer of the activity in a process template and make further adjustments to the activities when creating relevant process instances. For more information, see Setting Deadlines for Activities [page 240].

10.6.1.2.1 Criteria for Defining Activities

Activities have defined criteria to control the activity context, opening of activities, review criteria, and reopening of activities if required.

Each process must contain at least one activity.

The following are guidelines for defining activities:

● You must associate at least one action with an activity.● All activities can have more than one action associated with them. The primary action is the launch action;

the additional actions appear in the action pane when the primary action is launched.● Activities may require approval by a reviewer before the system considers the activity complete.

234 PUBLIC


Administration

● Performers and reviewers must perform activities in the order defined in Activities.● Each activity is assigned a driving dimension, which determines the generation (iteration) of the activity by

process context. The driving dimension assigned to the activity is also associated with the performer and reviewer property for each activity context. The performer and reviewers can be modified when you create a process instance later.

● The process owner can finalize the process only when all activities are completed.● Up to one thousand activities per process template or process can be defined.● Up to one million activity contexts per process can be defined. The activity contexts can be calculated as a

product of the number of activities and number of process contexts.

Related Information

Activities [page 232]

10.6.1.2.2 Defining Activity Context Criteria

To complete the creation of an activity in a process template, you must define the activity context criteria for that activity.

Procedure

You define activity context criteria in the Driving Dimension of the Activities tab by performing the following steps:

1. Select the driving dimension. Each activity has only one driving dimension, and this determines which members can be selected for that activity.

NoteThe driving dimensions are displayed according to the model that you selected in the Process Settings tab.

2. In the Member's drop down list, choose Select Members and set member criteria for the activity context using the Criteria Editor. There is a limit of six member definitions per step:○ Select specific valid member IDs from the list. This list is generated depending on the driving

dimension you have selected. You can make multiple dimension member selections.○ If you select a parent ID, which is a node that has subnodes, in the dialog box that appears, you can

generate dimension members based on the dependent (Children), or base (Base Members) nodes of the parent ID. If you do not select Children, Base Members, or All Members, the selection defaults to Single Member, which includes only the selected node.

NoteDependent members are all entries one level below the parent node.


Base members are all entries at the lowest level below the parent node.

In some cases you will have to manually enter the members that you want to use in the activity.

In the member Criteria Editor page, you can also click the button to filter members by selecting properties of the driver dimension and add them to the Selected Members list in a batch.The logical relationship of selections is:○ All selected members are on one hierarchy: OR○ Filtered by the same property: OR○ Filtered by different properties: AND○ Selected from different hierarchies and filtered by different properties: AND

Note“OR” refers to a union set of selection, while “AND” refers to an intersection selection.

Order of activities:1. If there is a hierarchy selection, follow the preorder traversal of the hierarchy, which means selecting

members from the tree and subtrees of the hierarchy from root to children and from left to right.2. If there is only a property selection, follow alphabetical order. The operators supported in property

selections are equal, not equal, between, and like.For example, the driver dimension of one step is D, which has hierarchy H1 and H2, and properties P1 and P2. The selections are the following:1. Base members of member M1 in H12. Children of member M2 in H23. P1 = 'Variance 1'4. P1 between 'Variance 2' and 'Variance 3'5. P2 = 'Variance 4'The members displayed in Selected Members will satisfy the logical relationship (1 OR 2) AND ((3 OR 4) AND 5).

3. Select the property of the dimension that contains valid user IDs for the owner. For more information, see Owner Property [page 93].

10.6.1.2.3 Criteria for Opening Activities

Use

By selecting the opening criterion when you define activities in the Process Template Designer interface, you can define a new criterion for the opening sequence of activities.

236 PUBLIC


Administration

Features

When choosing an opening criterion for an activity, consider the following guidelines:

● There is no opening criterion for the first activity of a process. The first activity is always open, regardless of how the opening criterion for the activity is defined in the process template.

● When you complete all activities in a context, the next activity automatically opens regardless of the opening criteria.

When you are defining an activity, you can choose the opening criteria to be All or Matched. The following sections describe how these criteria affect activities.

All Activity Contexts

Choosing All Activity Contexts as the opening criterion for an activity introduces the following constraints:

● All activity contexts must be completed before the next activity opens.● Use with matching driving dimensions, or different driving dimensions.● Use this option when you have matching driving dimensions, but different activity contexts between

activities.

ExampleYou must complete all tasks for all activity contexts in activity 1 before activity 2 opens:

Activity Driving Dimension Activity Context Status

1 Entity Italy Complete

1 Entity France Open

2 Entity Italy Pending

2 Entity France Pending

Matched Activity Contexts

Choosing Matched Activity Contexts as the opening criterion for an activity introduces the following constraints:

● When you complete an activity context, the next activity opens for that same activity context.● Use with matching driving dimensions only.● Do not use when you have matching driving dimensions, but different activity contexts between activities.

ExampleThe matched activity context opens in activity 2 when you complete the tasks for the corresponding activity context in the first activity. All tasks for the other activity contexts are pending:


1 Entity Italy Complete



1 Entity France Open

2 Entity Italy Open

2 Entity France Pending

10.6.1.2.4 Criteria for Reopening Activities

You can reopen a completed activity to perform actions in that activity once again. You enable the reopen function when you are defining activities in the Process Template Designer interface.

When choosing a reopening criterion for an activity, consider the following guidelines:

● The Allow Reopen checkbox must have been selected in the activity that you want to reopen when designing the process template.

● You reopen activities one by one starting from the most recently completed activity, which means that except for the last open activity, the reopen function is available only for the activity prior to the one that is now active; you cannot reopen an activity that is not consecutive.

● By default, you must be a performer or reviewer in both the current activity and the next open activity to be able to reopen the current activity. To change the default setting, you can following the steps described in Check Only Current Step when Reopening below.

● If you are the process owner you can reopen an activity, regardless of owner or reviewer assignment, from the process monitor.

● You cannot specify which activity context to reopen; it is an activity operation.● You cannot reopen an activity once it has been finalized.

Check Only Current Step when Reopening

By default, if you act only as a performer or a reviewer instead of the process owner of a process, you must be a performer or reviewer in both the current activity and the next active activity to be able to reopen the current activity. To enable a performer or a reviewer to directly reopen the current activity, perform the following steps:

● Trigger the reopen rule in BW IMG by perform the following steps:● 1. Log on to Business Warehouse and enter transaction SPRO to open the IMG page.

2. Click SAP Reference IMG.3. First expand the Planning and Consolidation tree, then expand the Confuration Parameters tree node.4. Click Set Global Parameters.5. Click Insert to add the parameter BPF_NOT_CHECK_PRE_STEP_AUTH.6. Set the value of this parameter to Y and save the parameter.7. Navigate back to the Configuration Parameters page and click Set Environment Parameters.8. Enter the ID of your environment.9. Add the same parameter BPF_NOT_CHECK_PRE_STEP_AUTH, set its value to Y, and save the

parameter.

The following sections describe how All and Matched criteria affect activities.

238 PUBLIC


Administration

All Activity Context

Choosing All Activity Contexts as the reopening criterion for an activity introduces the following constraints:

● You must be a participant in at least one activity context of thecurrent activity.(The process owner can ignore this).

● You must be a participant in at least one activity context of the next openactivity.(The process owner can ignore this).

● The opening criterion of the next open activity is All.● The open activity must be fully active, which means that all the activity contexts of the current activity

must be Open, Reopened, Rejected, or Submitted.

ExampleWhen you reopen activity 1, all activity contexts for activity 2 change to status Delayed:

ActivityDriving Dimension Activity Context Performer Reviewer Status

1 Entity US A B Reopen

1 Entity Canada C D Reopen

2 Entity US A B Delayed

2 Entity Canada C D Delayed

Matched Activity Context

Choosing Matched Activity Contexts as the reopening criterion for an activity introduces the following constraints:

● You must be a participant of the matched activity context in the current activity to reopen that activity context.(The process owner can ignore this).

● You must be a participant of the matched activity context in the next open activity to reopen that activity context in the current activity.(The process owner can ignore this).

● The opening criterion of the next open activity is Matched.● The open activity must be an active activity , which means at least one of the activity contexts of the

current activity must be Open, Reopened, Rejected, or Submitted.

ExampleWhen you reopen activity 1, activity context Canada reopens. Canada changes to status Pending in activity 2.


Activity context US does not reopen as it is already complete in activity 2 - the activity context must be active in the next open activity to reopen it in the current activity:

ActivityDriving Dimension Activity Context Performer Reviewer Status

1 Entity US A B Complete

1 Entity Canada C D Reopen

2 Entity US A B Complete

2 Entity Canada C D Delayed

10.6.1.2.5 Setting Deadlines for Activities

Timelines, including activity deadlines, are important within a planning process.

Deadlines can be set for activity performers and activity reviewers in Process Templates and Process Instances. After specifying a deadline for an activity, process owners can easily monitor its status in the process monitor.

Defining Deadlines in Process Templates

In a BPF template, a deadline is the number of days after which an activity will expire. For example, if you enter 2 days for the deadline, the activity will be due two days after its start date.

You can also define actions upon the expiration of the activity. When choosing to wait, the activity keeps its original status and does not close automatically. When choosing to close the activity, the activity automatically closes. If you further define a different deadline or choose not to enable a deadline for the activity when creating a process instance based on the current template, the deadline you defined in the process template is replaced by the newly defined deadline in the process instance.

Defining Deadlines in Process Instances

You can adjust deadlines you defined in process templates or define new deadlines when setting timelines during the creation of a process instance. Different deadlines can be set in accordance with different start dates:

● If you want to start the process instance immediately or on a certain date, you can check the Enable with Deadline option and choose the date of the deadline for the performer and reviewer of each activity.

● If you want to start the process manually later, you can check the Enable with Deadline option and enter after how many days each activity will be due.

After you successfully create the process instance, the deadlines you set display in My Activities for the performer and reviewer and in Process Monitor for the process owner.

NoteYou can still make changes to your planning activities and modify deadlines in Process Monitor after the process starts to run. For more information, refer to Process Monitor [page 27].

240 PUBLIC


Administration

Email notification of an upcoming due date for each activity can also be automatically sent. To set the email notification, use transaction SA38 and execute program RSBPC0_DAEMON_UI to start a job. Use transaction SM37 to view the job status of job name BPC_DAEMON_JOB.

10.6.1.3 Defining Activity Workspaces

You can assign action groups, as well as create new worksheets in and add existing content from Library folders to the activity’s workspace.

After you finish editing an activity workspace, you can assign review actions to activities, which require the approval of a reviewer.

Prerequisites

You have defined an activity when creating or editing a process template.

Procedure

New Content1. Choose the Create button in the Workspaces field of the Activities tab.2. Click the Add button and choose New Content.3. Choose from the Library folders the content you want to add to the activity workspace.

New Worksheet1. Choose the Create button in the Workspaces field of the Activities tab.2. Click the Add button and choose New Worksheet.3. Create read-only or input-ready reports. For more information, refers to Creating Worksheets [page 15].

Add an Action Group1. When creating a process template, choose the Create button in the Workspaces field of the Activities tab.2. Click the Add button and choose Add Action Group.

You can add hyperlinks only to perform actions of existing elements. Therefore, you must make sure these elements exist before you start defining actions.Business Planning and Consolidation supports the following types of actions:○ Consolidation – Define a hyperlink to perform various kinds of actions in Consolidation including

opening a journal list, creating a new journal, opening Consolidation Monitor, opening Ownership Manager, opening Controls Summary, and opening Controls Details.

○ EPM Plug-in - Define a hyperlink to an EPM Plug-in read-only report or input-ready report.○ Data Manager – Download and upload data, as well as view Data Manager packages and run packages

and package links.○ Library - Define a hyperlink to a specific worksheet or book. If there are variables set in the read-only or

input-ready reports, you can assign values to them.


○ Work Status and Comments - You can set a work status, as well as add or manage comments.Set a target work state for a context and define a target work state for a specific activity status. When there is a change of a certain activity status, the system can automatically change the work state to the defined target state. For more information about work status integration, seeIntegrating with Work Status [page 242].

○ Audit - You can view audit reports about comments, activities, data, users, teams, work status, task profiles, and data access profiles.

○ External Resources - You can open a URL or an external web-based application.For more information about external web-based applications, see .

3. Choose Stop Editing. You can then click the hyperlink to test the action of the activity.4. Repeat these steps for all of the actions to be associated with each activity in the process template.5. After all the actions have been defined, go back to the process template and save it.

You can specify that the reviewer uses the same workspace or that a reviewer has a specific workspace, which you can define in the same way.

Result

You have defined actions for your activity.

10.6.1.3.1 Integrating with Work Status

When defining a target action for Set work status, you can set this action to be executed automatically when there is a change of activity state.

Context

You can specify one of the following desired target work states for all possible Business Planning and Consolidation activity states:

● On Submit● On Approve● On Reject● On Complete● On Reopen

Procedure

1. Select the checkbox Automatically executed on a change of activity state.

242 PUBLIC


Administration

2. To specify one of the target work states for the possible activity states, select the checkbox Include All Descendants.

10.6.2 Creating Process Instances

A process instance is a process that has been created based on a process template.

Use

An authorized user can create a process instance in the Administration screen. You can create up to 24 process instances for each process template.

Generating a process creates all required activities and activity contexts. Once generated, the process instance is no longer associated with the template. Any changes to the template definition do not impact previously generated processes.

Prerequisites

A process template has been created, validated, and deployed.

Procedure

In the Process Instances screen, choose New. This opens the New Process Instance wizard that has the following steps:

1. Select the process template.2. Choose the process owner.3. Select the context.4. You can change the performer or reviewer for each activity.

Select an activity and click Change Performer or Change Reviewer as appropriate and choose a different user or team.

5. You can set a timeline by scheduling a start date for the process instance and enabling corresponding deadlines for each activity. For more detailed information, refer to Setting Deadlines for Activities [page 240].

NoteAny settings you made in the process instance overwrite those made in the process template. Therefore, if you choose not to enable deadlines for the activities during the creation of the process instance, the deadlines you previously set in the process templates will not take effect.


6. Review the process, select Start the process instance and click Finish.The title of the created process is derived from the process template name and the context of the process.

Result

You have created a process. Click Refresh in the Process Instances screen to add the new process to the list; it is displayed with a status of Active.

You must manage the process and activate it before a user can see it in the interface. You can perform the following functions for a process in the Process Instances window:

Function Description

Start/Resume Start is normally used to manually begin an activity. Resume is to restart a suspended process. After that the status changes to Running.

Suspend Suspend deactivates an active process or a process waiting for finalization. The status changes to Suspended. The process can be reactivated using Resume.

An inactive process does not appear available for users and can be seen only in the Administration window. Note that the deadline is not postponed even when a process is suspended.

Change Assignments The Change Assignments wizard allows you to change the process owner and an activity performer or reviewer.

Reset Resets a process back to activity 1. The system resets the status within the process so users must perform the steps again. The system does not, however, reset changes made to your metadata or transaction data.

Archive To delete process instances that are no longer needed. The processes to be archived must not be in the status Running.

Refresh To refresh the display after changes have occurred.

10.6.3 Setup of E-mail Notifications

Administrators can turn on and turn off e-mail notifications and customize an e-mail template for business process flow activities.

The e-mail addresses to which each business process flow e-mail notification automatically sends are the e-mail addresses of the process instance owner, activity performer, or activity reviewer maintained in Business Warehouse via transaction SU01. You must make sure that proper SMTP settings are configured via transaction SCOT to allow the system to automatically send out the emails. For detailed information, refer to the SMTP Configuration Guide available here on the Help Portal.

244 PUBLIC


Administration

https://help.sap.com/saphelp_nw70/helpdata/en/2b/d926324b8a11d1894c0000e8323c4f/content.htm?frameset=/en/af/73563c1e734f0fe10000000a114084/frameset.htm&current_toc=/en/2b/d927734b8a11d1894c0000e8323c4f/plain.htm&node_id=5&show_children=true#jump5

The email notifications automatically sent to users contain a link to bring them either to the activity or process monitor directly, or to external URL-based applications including transactions, Fiori, and ABAP Web Dynpro applications.

Activate Email Notifications

To turn on and turn off e-mail notifications, administrators can perform the following steps:

1. Run transaction SE38.2. Execute the UJB_MAINTAIN_EMAIL_TMPL program.3. Do one of the following tasks on the email template page:

○ To activate e-mail notifications, change the value of the Is Active column to Yes.○ To turn off e-mail notifications, change the value of the Is Active column to No.

Create a New Email Template

Besides the default e-mail templates, administrators can also customize an e-mail template by performing the following steps:

1. On the e-mail template page, click the Change button and choose New Entries (F5).2. Choose C in E-mail Template Type.3. Choose an e-mail template ID for the customized email template. Later, if both this customized email

template and the default email template sharing the same ID are activated, the customized email template takes priority.

4. Type an e-mail template title in which two variables can be included:○ %PROCESS_NAME%: Process instance name○ %STEP_REGION_NAME%: Activity name

5. Select a Smart Form body or directly enter an e-mail body.Smart Forms are predefined via transaction SMARTFORMS. For detailed information, refer to the section below called “Manage Smart Form Body”.An e-mail body is simply made up of a single line text. If both Smart Form and e-mail body are defined, the Smart Form body will be used.

6. Use the same URL Callback RSBPCB_SF_XSF_URL_CALL_BACK or UJB_SF_XSF_URL_CALL_BACK as in the default template to call the proper URL.

7. Choose a corresponding BPF Operation.8. Activate and save the template. The responsible person will receive e-mail notifications based on the

customized template.

Manage Smart Form Body

Administrators can change the Smart Form body by using the Smart Form Editor.

1. Open the Smart Form Editor using transaction SMARTFORMS.2. Create a new e-mail template by copying an existing template. Choose an existing e-mail template from the

Form list, and then copy it by clicking on the Copy icon in the toolbar.3. Enter a name for the new Smart Form Body. We recommended that you begin the name of the customized

e-mail template with Z or Y.You can create this new template only as a local object, or you may transport it by choosing a package.

4. Click the Display or Change button in the toolbar to enter SAP Form Builder, in which the newly created Smart Form Body opens in edit mode.

5. Open the e-mail template body by expanding Pages and Windows until you see the leaf node NOTIF_BODY. Double-click this and you can edit the notification text body.


6. In the notification, you can use the following variables:

Variable Description

&I_PROCESS_NAME& Process instance name

&I_INST_CTX_STR& Process instance context

&I_RGN_NAME& Activity name

&I_RGN_CTX_STR& Activity context

&GV_URL& URL to either Activities list or Process Monitor in user-friendly name

&URL& Full URL to either Activities list or Process Monitor

NoteYou can maintain parameter EMAIL_NOTIFICATION_URL_PREFIX to replace the http link with the relevant server name. For detailed information, refer to SAP Note 1717100 .

Related Information

Business Process Flows [page 12]

10.6.4 External Process Integration

Integrate external workflows with Business Planning and Consolidation business process flows.

Complicated planning processes may exist where data flows among different organizations and departments and requires multiple levels of approvals, counter-signatures, and so on. To help accommodate this, you can integrate business process flows with workflows that are outside of Business Planning and Consolidation.

Overall Process

1. The process owner and the business user define the planning process. Then, the process owner defines the BPF template as a main planning process within BPC and defines the activities that need approval.

2. The process owner maintains the approval workflow in an external workflow system, for example, the office automation system (OA). Meanwhile, all workflow processes are registered in the BPC BPF automatically (if there is an API to load the workflow process from the OA system) or manually. The user maintains all necessary parameters such as server and URL in the BPC BPF.

3. For each activity that needs an external approval workflow, the process owner assigns the corresponding approval workflow process. The process can be different for different driving dimensions and contexts.

4. The user assigns the external workflow to a deployed BPF template. If a new template version is created, the mapping of the old version is not inherited automatically. When the user selects the template, no

246 PUBLIC


Administration


mapping is shown. The user can check the process mapping of the previous template version and can copy the mappings to the new template version.

NoteCreating two mapping entries with the same context, activity, and driving dimension member is not permitted. You can create an entry for all driving dimension members, however. If another entry exists for specific driving dimension members with the same context and activity, the system uses this specific entry at runtime.

10.6.4.1 Integrating External Workflows with Business Process Flows

Steps for integrating workflows that are outside of Business Planning and Consolidation with the system's business process flow functionality.

Procedure

1. The planning instance owner initiates the planning process.2. The performer finds the activity in BPC My Activity. Optionally, an OA notification activity may be created,

which can be found in the OA. The performer can open a link in the OA notification to launch the BPC activity and complete the required task.

3. The performer submits an activity, which initiates the workflow instance and passes the following information to the workflow: instance information, such as name and owner; activity information, such as context, driving dimension, and comments; links for any attachments; reviewer workspace URL; and key figures.

4. The approver sees all information in the workflow necessary to support his completing the approval action. The approver can open the activity reviewer workspace by selecting the link provided, but cannot approve or reject the activity from the reviewer workspace.

5. In the external workflow, the approver approves or rejects the activity, and add comments if needed. The following then apply:a. If the current approver is the last approver in the workflow process, the BPF activity is approved or

rejected automatically.b. If the current approver is not the last approver in workflow process, the BPF activity status remains

unchanged.c. Workflow status can be updated to BPF instance comments.

6. Performers can see the workflow status and comments in My Activities.7. Process instance owners can see the latest status and comments of all instances for which they are

responsible in the Process Monitor.8. Process instance owners can sort, filter, and search for instances in the Process Monitor to quickly locate

specific instances.

A performer can reopen an activity in a BPF. When the reopened activity is submitted, a new external workflow is initiated.


10.7 Work Status Setup

This function allows you to lock a region or slice of data in a model. The work status setting overrides the member access privileges of a user to write to a given region.

Use

The region of data to be locked is defined by several dimensions per model that are composed of one Owner dimension and a number of Other dimensions. The owner dimension has an OWNER property to define the work status owner who can change work statuses.

When you set up work status, you define the following:

● Work states - Physical statuses of data that can be customized according to your business needs, such as unlocked, submitted, and approved.

● Level of security - The users or teams who can change data in the system, which is All, None (locked for all), Manager, or Owner. See Controlling Who Can Change Data below.The users or teams who can change the work status, which is Owner, Manager, or Owner and Manager. See Controlling Who Can Set Work Status below.

● Permitted data entry method - The manner in which users enter and update data. See Method of Data Entry below.

● Push - Equivalent to the check box On All Descendants when setting work statuses, the option allows you to set one work state to all descendants of a member. This does not includet the selected parent member.

After you set up work statuses, other users can use them to apply a state to a current view and lock its data for review, approval, and so on. For example, your month-end close business process requires that a specific set of data is locked down so that accurate month-end reports can be created. After a data submission, the owner sets the work status to Submitted, which has a security level of None. This locks the data intersection from subsequent submissions.

Features

Controlling Who Can Change Data

You define who can change the data in the system:

● All - All users with the appropriate member access rights can change data● None - No one can change the data● Manager - Only managers (members in the parent nodes of owners) can change data● Owner - Only owners can change data

Controlling Who Can Set Work Status

You define who can set the work status to a particular state for a region of data:

● Owner and Manager - The owner of the specific member ID and the owner of the parent to the specific member ID

248 PUBLIC


Administration

● Owner - The owner of the specific member ID● Manager - The owner of the parent to the specific member ID

Owner/Manager Determination

● A manager is the owner of a parent-level member.● Parent member owners act as an owner for that specific parent member ID● Parent member owners act as a manager for their direct children - the parent owner can change any

specific direct child work status; can be both parent and base members● When using On All Descendants - the owner of a parent node member can update all children of all levels

below● Base members owners act as owner only● Members (top of a hierarchy) that have no parent but only children act as their own manager in addition to

owner

Controlled By Rule

● An owner is defined by only one dimension hierarchy, the OWNER dimension● A work status can be set on a specific single member ID, where the manager does not use On All

Descendants● A work status can be set on a series of member IDs, where the manager uses On All Descendants

Setting the Work Status

● If the user is acting as an owner, they can select a work status controlled by Owner or Owner and Manager.● If the user is acting as an owner and the selected member has no parent, the user also acts as a manager

(top of the hierarchy) and they can select a work status controlled by Owner, Manager or Owner and Manager.

● If the user is the parent owner in the role of Manager, then they can use the On All Descendants option (to push the work status to children). This option is not valid for a base member, the Owner role.

Consecutive Work Status Rules

● You can set work status in a forward direction (progressive) or in a backward direction (regressive)● For a user acting as an Owner, the order matters

○ The user can only select the next (forward) work status that is controlled by either Owner or Owner and Manager

○ The user can select the previous (backward) work status that is controlled by either Owner or Owner and Manager

○ The user cannot select a work status that skips a work status controlled by Manager, either forward or backward

● For a user acting as a Manager, the order does not matter.○ The user can only select a work status that is controlled by either Manager or Owner and Manager,

either forward or backward○ The user can select a work status that skips a work status controlled by Owner, either forward or

backward● If you expand all records on the non-OWNER dimensions only, and find the current work status on each

record, the model checks each and every expanded record for the rules. If one record fails, the whole request is ignored

Bottom-Up Rule

● A parent work status cannot be higher than its children. Order matters.


○ The order of work statuses is determined top to bottom in the work status code screen. The first code is 0, the next code is 1, and so on.

○ A child can have a work status that is greater than or equal to its parent.● For a user acting as owner:

○ If a child is set to Submit, it parent cannot be set to Approve.○ If one or more children have a work status that is lower than the work status being set for a parent

(forward), then an error appears.○ If the parent's work status has a higher work status, an error appears if you attempt to regress a child's

work status (backward).● The rules above also apply when the user is acting as a Manager, where On All Descendants is selected or

the Manager sets a specific child work status.● For all expanded records (non-OWNER dimensions), the immediate parent is checked to verify that it has a

work status that is less than or equal to its children. If one child fails this rule, all fail.

Method of Data Entry

The areas of Planning and Consolidation for which you can control the level of security are as follows:

● Data Manager (DM) - Controls data input from running a Copy, Import, or Move package● Journal (JRN) - Controls data input from posting journal entries● Manual Entry (MAN) - Controls data input manually when creating worksheets● Comments (COM) - Controls data input from posting comments (unstructured data)● Documents (DOCS) - Controls posting documents with model context to the Document view (unstructured

data)

Defining Work Statuses

Work statuses are defined for the entire environment, not per model.

There is no limit to the number of work states you can create, but there is a practical limit.

There is a default work state that must be first. It has an internal code of 0 and is controlled by the Manager and Owner (Controlled by is set to Owner and Manager). You can change the method of update for this state, but not the order or the Controlled by value.

The default state allows you to have a customized behavior for the environment. For example:

● LOCKED for all methods is equivalent to preventing any data update until the work status is advanced to the next status (1).

● ALL for all methods is equivalent to having all data open for update. This is the default behavior.● SETUP applies to ALL of the models in the environment.● WRITEBACK always checks for locks; if there are no locks in the lock table, the system behaves based on

the setup of status (0).

You can change the order of work states. When you do that, the system deletes all locks for all models in the environment. Deleting states also deletes all locks. Adding states to the bottom of the list or changing a state definition does not impact existing locks, but may impact business users. We recommend that this be done only during the testing phase of a system implementation.

Work Status Rules

Note that in this section the term member denotes the members of the owner dimension.

250 PUBLIC


Administration

The following rules describe work status behavior:

● The default method for managing work status is bottom-up. That is, the status of a parent cannot be higher than the status of its children.

● The maximum status a parent can be set to is the lowest status of its immediate children.● If the status of a parent is set to Locked, you cannot unlock the children.● The minimum status a child can be set to is the status of its immediate parent. For example, if the parent

status is Submitted, the child status must be at least Submitted.● The owner of an entity can set the work status to any status designated as an Owner status, where Owner

status means that the status is controlled by the owner or the owner and the manager.● The manager of an entity can set the work status to any status designated as a Manager status where

Manager status means that the status is controlled by the manager or the owner and the manager.● A manager is the owner of a parent-level member. The owner of a parent level member is the manager of all

its descendants.● When setting a lock on the parent members of multiple dimensions, locks are set for all members under all

parents, specifically, the Cartesian product is stored as locked. For example, the following table shows the locks that are set when including all children for entity:p1, category:actual and time 2016.Q1.

Entity Category Time Work Status

Child1 Actual 2016.Jan Upload

Child2 Actual 2016.Jan Upload

Child1 Actual 2016.Feb Upload

Child2 Actual 2016.Feb Upload

Child1 Actual 2016.Mar Upload

Child2 Actual 2016.Mar Upload

● If you reorder work status codes in the Admin client, all locks are deleted. This also applies deleting a work status.

● A parent value for a non-OWNER dimension is not stored. When the user selects a parent for a non-OWNER dimension, it is expanded to all base members, and only stores the base members.

● A parent value for the OWNER dimension is stored. For example, the following table shows what is stored for entity:p1, category:actual and time 2016.Q1.

Entity Category Time Work Status

P1 Actual 2016.Jan Upload

P1 Actual 2016.Feb Upload

P1 Actual 2016.Mar Upload

● When applying rules, if the model encounters any error, it rejects the entire user request. In this case, no records are updated.

Sending E-mail Notifications to Owners and Managers


The system can send an e-mail notification to corresponding owners and managers to notify them when a work status changes.

The e-mail address to which the notification is sent is defined in Business Warehouse. To add or modify the default e-mail address for an owner or manager, an administrator can run transaction SU01, choose the name of the user, and then enter an e-mail address in the Address tab. You also need to make sure proper SMTP settings are configured via transaction SCOT for the e-mails to be automatically sent out. For detailed information, refer to the SMTP Configuration Guide.

Then you can compose an e-mail notification template and trigger the e-mail notification for work status changes in the Planning and Consolidation web client by choosing Notifications and checking Activate E-mail Notifications in the Work Status Settings page. You can either directly use the default message template or customize a new message.

Activities

You create work statuses to reflect statuses of different data entry levels with the progress of your business, such as unlocked, submitted, and approved. No predefined work statuses exist within Business Planning and Consolidation.

Go to the Administration screen and under the Features section, choose Work Status New .

You can modify the order in which work statuses display in the system by using the up and down arrows.

You can delete a work status that is not currently in use by selecting the work status and choosing Delete.

You can enable as well as view data lock settings by model on the lower half of the Work Status screen. To enable or modify them for a model, select the model and choose Edit. You can enable data locking and select the dimensions to lock the process context, or disable data locking.

Related Information

Work Status Example [page 252]

10.7.1 Work Status Example

Use

The following information is used for the examples shown below.

Work status codes

252 PUBLIC


Administration

● Default code is set to Both.● All methods are open, that is, set to All.

Work State DM JRN MAN COMM DOCS ControlledBy

Locks Not Set All All All All All Both

Started All All All All All Owner

Upload All Locked Locked Locked Locked Manager

Submit Locked Owner All All All Owner

Journal Locked Locked Locked All All Owner

Approve Locked Locked Locked Locked Locked Manager

Model work status dimensions

● Entity is used as the owner dimension.● Dimensions with Yes are non-owner dimensions.● Remaining dimensions are not considered when defining the scope or region of the lock.

Code Model Dimension Name Work State

CATEGORY Yes

ENTITY Owner

P_ACCT No

P_ACTIVITY No

P_DATASRC Yes

RPTCURRENCY No

TIME Yes

Entities structure

● Owner of Top entity L1 is the tester's internal user TESTUSER_ALL.● Remaining parents and children have test owners to help demonstrate the example.

ID CURRENCY DESCRIPTION OWNER PARENTH1

L1 EU Top TESTUSER_ALL

LD1 US Parent 10 TESTUSERC L1

L9000 US Parent 19 TESTUSERD LD1


L9100 US Child 191 TESTUSERE L9000



LD2 US Parent 20 TESTUSERF L1

L8000 US Parent 28 TESTUSERG LD2

L8100 US Child 281 TESTUSERF L8000

L7000 US Child 201 TESTUSERF LD2

Examples

To begin, a user enters data into the model.

● This example uses data for children of entity member L1.● There are no locks set, so data can be entered freely.

Lock is set by owner

1. Owner TestUserE can set their own entity L9100, and set a parent level non-owner dimension member 2017.Q1.

2. However, the owner cannot view the current status of the entity L9100 and 2017.Q1 since the state is expanded to the child members for non-owner dimensions (no storage of parent members for non-owner dimension).

3. The owner can view the individual state by the base member 2017.JAN.

An owner must set Controlledby work states in consecutive order. Upload can be set to Submit, but not to Journal, as the next work state after Upload is Submit.

This is also true in reverse: an owner cannot set a Controlledby owner work state that is not in order. You cannot set Journal to Started as this violates two rules:

● The state before Journal is Submit. Therefore, this is the only valid selection.● Upload is a Controlledby Manager work state, and is in between the Submit and Started work states. The

owner cannot skip a work state that is controlled by a manager.

Lock is set by manager 1

As the first status is an Controlledby Owner status, which is defined as open ( Locks Not Set), the next step is to have the manager progress to a locking status of Upload.

1. Sign on as TestUserD, the manager of L9100 (owner of L9000).2. Do not choose On All Descendants in the data region. As a manager, you can update the status for

individual members as long as the status is set to Controlledby Manager.3. You cannot update the data after the lock is set, as this status locks out manual data entry.

Lock is set by manager 2

1. Sign on as TestUserC, the manager of LD1 (owner of L9000).2. Attempt to set Controlledby Manager work state for a specific child of L9000 (for example, L9100).

254 PUBLIC


Administration

○ Only an immediate parent can set individual children. An error appears: User is not an owner/manager, work status cannot be updated.

○ If you choose On All Descendants in data region, you can set all children (multi-level setting).

Controlled By Rule

1. Parent L9000 is set to Locks Not Set.2. If the parent owner attempts to set the work state to Approve, this violates the Controlledby rule as

Approve is a Manager work state. An error appears: The Controlledby rule is violated.

NoteThe owner of a parent is not its own manager. The only exception to this is the top member of the hierarchy.

Bottom Up Rule

● Parent L9000 is set to Locks Not Set.● Child L9100 is set to Upload; other children are set to None.

1. The owner of parent L9000 attempts to set to the work state to Started, which is Controlledby Owner.2. This fails due to violation of the bottom up rule: a parent cannot have a status higher than its children. An

error appears: The Bottom-up rule is violated.

Pushing 1

● L9000, a parent owner (manager), can set the work state of all of its children using On All Descendants in the data region.

1. A manager can skip work states, but they must be Controlledby Manager.2. If a manager selects a work state that is Controlledby Owner, this violates the Controlledby rule.3. If the user setting the work state is neither the owner nor the manager of either the specific member or

children of the specified member, an error appears: User is not an owner/manager, work status cannot be updated.

Pushing 2

● L9000, a parent owner (manager) can set the work state of all its children using On All Descendants in the data region.○ The parent member work state is not set when On All Descendants is chosen.○ Only the parent of L9000 ( LD1) can set a Controlledby Manager work state.

Reversing

● Assume all children of LD1 are approved for 2017.Q1 (JAN, FEB, MAR).

1. The owner of a child member cannot set a work state lower than their parent. This violates the Bottom-up rule.

2. A parent can reverse the status to any of the Controlledby Manager work states.

All Regions Must Pass Rule

● Assume all children of LD1 are set to Approve for 2017.Q1 (JAN, FEB, MAR).

1. The parent sets all base members for Jan to Locks Not Set.2. The parent sets remaining months to Approve.3. The owner of one dimension attempts to set Q1 to Started. This fails because it violates the Bottom-up

rule for January.


10.8 Journal Administration

Administrators set up and manage the Journals component of SAP Business Planning and Consolidation.

Prerequisites

Before users can adjust data in the database using the Journals feature, an administrator must perform the following tasks:

● Define a journal template. See Journal Template Creation [page 256].● Set journal model parameters. See Journal Model Parameters [page 259].

10.8.1 Journal Template Creation

A journal template is an input form into which you enter journal entries. You can set up one or more journal templates for each model.

Features

A journal template consists of the following:

● Headers○ Header dimensions, which are fixed, constant dimensions for all journals in a model.

The header dimensions set in a journal template become page keys for journal entries based on that template. The template header must always include one dimension. Model dimensions that are not part of the header become detail dimensions for which users add line items when creating a journal entry.

○ Additional header items containing clarifying information that are saved with the journal entry. These items are free text entry fields (limited to 60 characters) or lists of entries from which users make a selection. Alternatively, an additional header can be defined as a Date.Adding additional header items is not required when creating a template, and if they exist in a template, users are not required to complete them. The maximum length of an additional header item is 20 characters.

○ Detail dimensions, which are the remaining dimensions that are required to change the model data via the journal entry. The Account and Flow dimensions are always included in the detail section of a template.Detail dimensions are in columns, so each row under the dimension name becomes a detail line. You fill in members for each of the dimensions and the debit or credit amount for that detail line. The maximum number of detail lines is determined when you create the journal entry.Two additional options are available for detail header dimensions:○ Balanced by Entity: If you select this option, for each entity in the journal entry, credits must be

equal to debits.

256 PUBLIC


Administration

○ Balanced by Currency: If you select this option, for each currency in the journal entry, credits must be equal to debits. There can be multiple reporting currencies in a journal entry.

NoteIf you have already created a journal template, creating a new template that changes the structure of the journal entries deletes the old template and all journal entries associated with that template. This removes your audit trail, even though changes made to the model data (InfoProvider data) through posted journal entries are maintained. If you recreate the journal template, all transaction data is deleted. However, if you add or remove one or more dimensions from a model, the corresponding journal template is automatically updated and the journal entries are maintained. If you recreate the journal template, but do not change the structure of the template keeping all header and detail dimensions the same, you have the option to keep the existing journal entries.

● Reopen RulesDefine translation information for the dimensions used in the reopen tasks. For more information, see Journal Reopen Rules [page 257].

Activities

To create a journal template for a model, perform these steps:

1. Go to Administration and under the Features section, choose Journals.2. Select the row containing the model for which you want to create the journal template, then click New in

the toolbar.3. Select header dimensions and modify the order of the header and detail dimensions if desired.4. Add additional header items if necessary.

To create extra header text fields in a template and to change the header text fields to selection boxes, define sub-items for one of the additional header items.

5. Define reopen rules.6. Save and close.

Related Information

Journal Model Parameters [page 259]

10.8.1.1 Journal Reopen Rules

Before you can reopen journal transactions, you must define translation information for the dimensions used in the reopen tasks.

The translation table defines the Source and Destination accounts. You typically do this for specific accounts, but you can create translations for other detail dimensions.


Features

When you open the translation table for the first time, the system opens a default table based on the journal template of the environment. The default value is *, which is interpreted as any dimension member. You can modify the table as needed.

The table is divided into two column groups: Source and Destination. The individual columns in each of these column groups are described below:

Column Heading Description

Account Type Displays the four required account types: AST, EXP, INC, and LEQ. The first time the system creates the translation table for a model, it uses these required account types. You can add additional account types by adding new rows, but these account types must remain in the table.

<Filtering Property> Select the filtering property from the Filtering Property dropdown list above the table.

<Source dimension members> One or more columns that were selected during the template creation.

Column Heading Description

Sign Enter plus ( +) to keep the value in the same credit or debit position. Enter minus ( -) to switch the value from the debit to credit, or credit to debit position.

<Target dimension members> One or more columns that were selected during the template creation.

Activities

To define journal reopen rules:

1. Go to Administration and under the Features section, choose Journals.2. Select the row containing the model whose journal template you want to open, then click Open in the

toolbar.3. Select the Reopen Rules tab. Insert a new row for each additional account type (AST, LEQ, INC, EXP) by

choosing the Add button. Remove rows by choosing the Remove button.4. For each account or dimension you want to convert, enter the source and destination member IDs under

the associated dimension.

258 PUBLIC


Administration

Related Information

Reopen Journal Entries [page 52]

10.8.1.2 Journal Model Parameters

You use model parameters to define conditions for journals.

Features

The following journal parameters are available:

● Enforce Balanced JournalsSelect this parameter to specify that journals must be balanced when they are posted.When selecting this parameter this affects all the journals that are generated from the given template. If you only want some of the journals to be balanced, you must set this separately for each journal entry.

● Allow Journals to be ReopenedSelect this parameter to allow users to reopen journals. If selected, the Reopen button appears in the toolbar in the Journals page of Consolidation Central.

Activities

To set up journal model parameters for a model, perform these steps:

1. Go to Administration and under the Features section, choose Journals.2. Select the model whose journal parameters you want to modify and click Journal Parameters in the toolbar.3. Make your selections in the Journal Parameters dialog box. By default, parameters are not selected.4. Click OK.


10.8.2 Journal Security

Journal security is a component of task security that uses model member access rights to enforce your journal creation and posting policy.

Features

Journal security involves defining users that can administer (AdminJournal), create (CreateJournal), post (PostJournal), or unpost (UnpostJournal) journal entries. With AdminJournal rights, a user can create templates as well as clear journal tables by deleting all journal entries.

You set up journal security in Planning and Consolidation Administration.

Activities

Set up journal task security by performing the following steps:

● Create journal task profile:1. Go to Administration and under the Security section, choose Task Profiles. To create a new task profile,

choose New in the toolbar.2. In the Assign Tasks step expand the Journals folder in the Available Tasks list, then select one or more

journal tasks.3. Once you have reviewed the task profile, click Finish to create it.

● Assign journal task profile to a user:1. Go to Administration and under the Security section, choose Users. Select a user and choose Edit in

the toolbar.2. In the Task Profiles tab, click Add/Remove in the Assigned to User list.3. In the dialog box, choose the required journal task profiles from the Available Profiles list and add them

to the Selected Profiles list.4. Click OK.

NoteIf users have create access, but not write access to a data region, they cannot create journal entries for that data region.

To assign one or more journal task profiles to multiple users, create a team and add the required users by selecting Security Team in Planning and Consolidation Administration. Once created, open the team for editing and in the Task Profiles tab, add the required journal task profile(s) to the team.

Related Information

Journal Template Creation [page 256]

260 PUBLIC


Administration

Delete All Journal Entries from Model [page 261]

10.8.3 Delete All Journal Entries from Model

You can delete all journal entries from a model database before moving from a development environment to a production environment.

You delete journal entries from a model in Business Planning and Consolidation Administration.

CautionAlthough changes that were posted to the database by journals remain, deleting the journal entries removes the journals themselves and their audit trail from the model.

Prerequisites

You have AdminJournal rights.

Activities

To delete all journal entries from a model, do the following:

1. Go to Administration and under the Features section, choose Journals. Then select the row of the model whose journals you want to delete.

2. Click Delete Journals.All journals for the model are deleted.

10.8.4 Limits to Dimension Members for Journal Entries

You can limit the dimension members available to users when they double-click member cells in a journal template during journal entry.

Features

You can limit journal dimension member lists by adding the property EnableJRN to the dimension for which you want to limit journal access. Then, in its dimension sheet, type a Y in the EnableJRN column of base-level members for which you want to allow users to post journal entries. Repeat this for each dimension you want to limit, then process the dimensions.


Example

You might want only some account members used for journal entries, regardless of whether the users have access to other members.

10.8.5 Data Modification by Journal Entries Only

You can set a work status to lock data so users are limited to modifying data only through journal entries, not input schedules.

This enforces a separation between SAP BusinessObjects Analysis, Edition for Microsoft Office input schedules that send data to the database and your review and analysis phase where all data modifications are made by journal entries.

Activities

To lock data so business users can modify it in journal entries only, do the following:

1. Set up a work status code to lock out SAP BusinessObjects Analysis, Edition for Microsoft Office changes to entities. During this process, assign owner and manager rights to set status to journal changes only.

2. Since owners or managers set work status, entities can be set for journal input only. You can test this by logging into SAP Business Planning and Consolidation with a manager ID, setting the status for an entity to Journal Only, then trying to send data to that entity via an input schedule and a journal entry.

Example

Set up a code named Journal Only, in which the entity owner can change a status from Unlocked to Submitted and set it back to Unlocked if desired. The manager can change it from Submitted to Journal Only, which locks the data from changes by SAP BusinessObjects Analysis, Edition for Microsoft Office input schedules or Data Manager data loads, but allow changes by journal entries. The manager can then set the status to Approved, which locks changes from any source, including journals.

262 PUBLIC


Administration

10.8.6 BAdI for Generating Calculated Amounts When Saving a Journal

When saving a journal, you can add or calculate extra amounts by implementing the Business Add-In (BAdI) UJJ_CALCULATED_AMOUNT.

Features

Enhancement Spot

The BAdI is defined in the following enhancement spot: UJJ_CALCULATED_AMOUNT.

When implementing a new BAdI, a filter must be set with the following parameters:

● Appset_id: Model ID● Application_id: Environment

Sample BadI Implementation

A sample implementation is located in the following implementation spot: CALCULATED_AMOUNT_SAMPLE_IMPL.

In the sample, when P & L entries are made, the resulting net profit (loss) impact is generated on the Balance Sheet retained earnings account. This impacts the closing balance flow, every time a balance sheet account is booked.

Interface to Implement

You implement the following interface: IF_UJJ_CALCULATED_AMOUNT.

Method CALCULATE_AMOUNTS:

Import Parameter Description

IT_JOURNALS Type UJJ_T_BADI_CA_JOURNAL

A table containing the list of journals to be saved.

Export Parameter Description

ET_CALCULATED_AMOUNTS Type UJJ_T_BADI_CA_JOURNAL_AMOUNTS

A table of calculated amounts containing the amounts to be added to the journal list. The output journal ID must match the input journal list.

CautionWhen returning a table of calculated amounts, these amounts must contain only the values for the detail dimensions. If you set a value for a header dimension, the BAdI returns an error.


Exception Description

CX_UJJ_EXCEPTION A journal exception that may be thrown.

Data Types

UJJ_T_BADI_CA_JOURNAL

Table for UJJ_S_BADI_CA_JOURNAL.

UJJ_S_BADI_CA_JOURNAL

The following fields are defined in the structure:

Field Type Description

APPSET_ID UJ_APPSET_ID Environment ID

APPL_ID UJ_APPL_ID Model ID

JRN_TMPL_ID UJJ_JRNTMPL_ID Journal Template ID

JRN_ID UJJ_JRN_ID Journal ID

DESCRIPTION UJ_DESC Description

USERC UJ_USER_ID The user who saves the journal

DATEMODIFIED TIMESTAMP The modification date

USERP UJ_USER_ID The ID of the user who has posted the journal

DATEPOSTED TIMESTAMP The posted date

STATUS UJ_DESC The status of the journal

IDJ_AUTO_REV UJ_ID The auto reversed ID

IDJ_OLD UJJ_JRN_ID The original ID of the journal

IDJ_GROUP UJJ_JRN_ID The ID of the group to which the journal belongs

AUTO_REVERSED UJ_FLG CHAR True if the journal is automatically reversed

MUST_BE_BALANCED UJ_FLG True if the journal must be balanced to be saved

MAY_BE_REOPEN UJ_FLG CHAR True if the journal may be reopened

EDITABLE UJ_DIM_MEMBER Multiple header dimension of a journal group

VARIABLET UJ_DIM_MEMBER Multiple value dimension ID

264 PUBLIC


Administration


AMOUNTS UJJ_T_BADI_CA_AMOUNT Table of amounts

EXTRA_FIELDS UJJ_T_KEYMEM Table of additional headers

IS_BALANCED UJ_FLG CHAR True if the journal is balanced

UJJ_T_BADI_CA_AMOUNT

Table for UJJ_S_BADI_CA_AMOUNT.

UJJ_S_BADI_CA_AMOUNT



REMARK UJ_STRING Remark

AMOUNT UJ_KEYFIGURE The value of the amounts

DEBITCREDIT UJJ_DEBITCREDIT Set the value to:

● C: if the amount is a credit

● D: if the amount is a debit

MEMBERS UJJ_T_KEYMEM This table contains the list of dimensions that defines the journal amount. Both detail and header dimensions are included in this table.

UJJ_T_KEYMEM

Table of UJJ_S_KEYMEM.

UJJ_S_KEYMEM



TABKEY TABKEY The dimension ID

MEMBER UJ_VALUE The member value

IS_HDR_FLD UJ_FLG CHAR Set the value to True if the dimension is a header dimension; otherwise it is a detail dimension.

UJJ_T_BADI_CA_JOURNAL_AMOUNTS

Table for UJJ_S_BADI_CA_JOURNAL_AMOUNTS.


UJJ_S_BADI_CA_JOURNAL_AMOUNTS



JOURNAL_ID UJJ_JRN_ID The journal ID

AMOUNTS UJJ_T_BADI_CA_AMOUNT The table of amounts

10.9 Context Defaults

Context is the model, dimensions, and associated members authorized to a user and applicable to what is displayed in a workspace, folder, or view. Administrators can set the default context that users automatically work in when accessing in the Web client.

Prerequisites

You have accessed the environment for which you want to set the context defaults.

Activities

To set context defaults, perform these steps:

1. In the Administration screen, choose Features Context Defaults .2. To set a specific model as the default, select the model, then choose Set as Default.3. To set the context defaults for a specific model, do the following:

1. Choose a model in the list, then choose Edit above the list of dimensions.2. For any dimension for which you want to set defaults, select reporting and data input members,

whether to display the dimension and its name, and how to display the member. You can display a member by its name, description, or both.

3. Save the context defaults for the model.

266 PUBLIC


Administration

10.10 Drill-Through Setup

You use this function to set up drill-through definitions. Drill-through definitions allow users to access source data from a report. Source data includes content that can be accessed from a URL.

Prerequisites

You must have proper security rights to define drill-through definitions. See the Security Guide available on the SAP Help Portal for more information.

Features

Setting up Drill-Through to a URL

You set up URL-based drill-through definitions within a model. After you set up at least one drill-through for a model, it is available to users of reports that reference that model.

You can map the URL parameters to dimensions or user-defined values.

When you map a parameter to a dimension, you also choose a dimension property, such as ID or DESCRIPTION. When the user performs a drill-through in a report, the parameter value is taken from the property value of the selected data cell. For example, if you select the ID property of a dimension, the member IDs are mapped. If you select another property of a dimension, that property value is mapped. Therefore, you can send either the dimension member or the value of a property.

When you map a parameter to a user-defined value, you can hard code a value or use %CurrentUser% or %CurrentDate%. If you specify a user-defined value in the mapping, when the user performs a drill-through in a report, the parameter value is based on the user-specified value.

NoteThe system supports the variables Current Date and Current User in the mapping. The format of Current Date is %CURRENTYYYYMMDD%, where YYYYMMDD is replaced by the current year, month, and day. You could then use %CURRENTYYYY% for sending out only the current year. The format for Current User is %CURRENTUSER%.

The system supports using environment parameters and model parameters in a URL. The format is %parameter%. When an environment parameter and model parameter have the same name, drill-through uses the model parameter prior to the environment parameter.

Executing a Drill-Through

You can use the EvMNU macro MNU_eTOOLS_DRILLTHROUGH_RUN to execute a drill-through using the syntax MNU_eTOOLS_DRILLTHROUGH_RUN("drillthrough id").

If you have defined a drill-through in the Administration view for a model, a menu item appears under the Drill-Through menu in the menu bar of the report. This menu item has the same name as the description that was



entered in the Administration view when the drill-through was defined. To access the drill-through information, select a cell in the report and then select the menu item from the Drill-Through menu. A web browser opens. The information that displays depends on the following items:

● The URL specified in the Administration view● The URL parameters specified in the Administration view● The data cell that you selected in the report

NoteThe URL and the URL parameters appear in the address bar of the browser. Also, even if the selected cell does not contain data, the drill-through is performed.

Activities

To define a drill-through for a URL:

1. In the Planning and Consolidation Administration screen, under the Features section, choose Drill-Through.2. Select New, then enter a drill-through ID and description.3. Enter the target URL, select the model from which the drill-through can be launched, and enter parameter

mapping information to indicate one or more dimensions and associated properties or user-defined values.

ExampleYou can specify http://www.google.com/search? as the URL and q, which is a known Google parameter.

4. Save the drill-through.

You can also edit and delete drill-throughs in the Planning and Consolidation Administration screen by selecting Drill-Through under the Features section.

Example

Example 1

This example describes a scenario of drilling through to a URL.

You want to search the member of Category in a Web site called MySite. You can define a drill-through, setting the URL as www.MySite.com. The parameter for MySite is q so in the Parameter column, you enter q. In the Dimension or User-defined Value column, select the Category dimension.

In the report, users can execute this drill-through to see the search results.

Example 2

This example describes another scenario of drilling through to a URL.

When SAP BusinessObjects Financial Information Management (FIM) is used to load data into Business Planning and Consolidation from external data sources (flat files, tables, 3rd party applications, or other EPM

268 PUBLIC


Administration

applications), this data is often transformed and aggregated. Business Planning and Consolidation stores only the final data, and you may want to drill-through into the details of the data that is stored in a FIM repository (staging area). A URL-based drill-through makes this possible.

When defining the drill-through, the URL is set to the <FIM Application>. URL parameters are dimensions in the Business Planning and Consolidation model that pass the context (for example, time, account, etc.), of the data being queried. All data associated with the context is returned and displayed in the FIM drill-through report.

10.11 Document Types and Subtypes

Document types and subtypes categorize Documents view postings. This is useful if you want to filter them to see only certain types.

Features

Document subtypes help you to further categorize documents when you post them in the Content Library. Administrators can define a list of subtypes from which users choose, and users can create their own as needed.

While document types always appear in an alphabetical list, document subtypes appear in the order in which they were created. You can change the order of the subtypes.

Activities

To add or remove document types and subtypes within a model, go to Administration and under the Features section, choose Document Types. Then select a document type or subtype, then choose Edit.

To rearrange the order of subtypes while in Edit mode, select a subtype, then choose Move Up or Move Down.

While in Edit mode, you can rename and remove document types and subtypes.

10.12 Auditing

Use this function to configure data auditing.

You can perform data auditing to track changes to transactional data at the InfoProvider level.


More Information



10.12.1 Data Auditing

This function tracks changes to transactional data at the model level, such as when and by whom records were changed within a model.

Features

Administrators control whether data auditing results are displayed or not.

For each model within an environment, you select a category and one or more of the following tasks to audit:

● EPM Plug-in● Data Manager Import● Data Manager Clear● Script Logic Execution● Worksheet● Journal Input● Business Rules Execution● Ownership● FIM Import

Activities

To display data auditing, go to Administration and under the Audit section, choose Data Changes. Select a model, and change its status to On.

Once a data change is recorded, you can run a report that shows that change based on specified criteria (see Reporting on Data Changes [page 63]).

You can also set up Data Manager packages to archive data audit information. See the SAP BusinessObjects Analysis, Edition for Microsoft Office application help available on the SAP Help Portal.

270 PUBLIC


Administration


10.12.2 Activity Auditing

This function tracks administrative and user tasks at the environment level.

Administrators control whether activity auditing is enabled or not. The system can track changes for the following activities, showing the previous and new values as well as the IP address and machine name associated to the user making a change:

● Administration activities, including:○ Security-related changes such as adding, changing, and deleting users, teams, task profiles, and

member access profiles○ Create, modify, delete, and copy operations for models and dimensions; dimension processing; create

and delete operations for dimension members; changes made to property or hierarchy values for a dimension member; delete and copy operations on environments and on drivers for driver based calculations

○ Changes to environment and model setup options, global configuration settings and KPI definitions for automated performance analysis, document types and subtypes, activity audit settings, and data audit settings

● User activities, such as setting data locks● Business Process Flow activities, such as adding, deleting, and modifying business process flows, and

saving business process flows to new names● User activities in business rules management

Activities

To display activity auditing for the current environment, go to Administration and under the Audit section, choose the types of activity auditing to display.

Once the system records an activity, you can run a report that shows activity based on specified criteria (see Reporting on Administration Activity [page 67]).

You can set up Data Manager packages to archive activity audit information. See the application help for SAP BusinessObjects Analysis, Edition for Microsoft Office on the SAP Help Portal.

10.13 Time-Dependent Hierarchies

When you use the time dependent hierarchy feature, you can modify a hierarchy and still keep its history. Thus, you can create, modify, and delete different versions of one hierarchy.

You can display the different versions of that hierarchy by selecting key dates in SAP BusinessObjects Analysis, Edition for Microsoft Office.

The following information pertains to hierarchy version maintenance within various areas of Business Planning and Consolidation.

Admin Console



Using the hierarchy view of the dimension master data maintenance screen, you can create, modify, and delete time-dependent hierarchy versions.

● Create a new hierarchy version by specifying a start date. A new version will be created starting with the date selected and end at the original end date of the hierarchy version to which the start date originally belongs. In addition, it is possible to select a reference hierarchy version to indicate how the new version of hierarchy should look at the beginning.

● By selecting an existing hierarchy version from the dropdown list, you can modify any existing hierarchy version. It is also possible to modify an existing hierarchy version in the list view.

● You can select any hierarchy version to delete by selecting a previous version or the next version with which to merge it.

Data Manager

When you use the process chain /CPMB/MANAGE_TDH_VERSION to create and execute a Data Manager package, you can either create a new time-dependent hierarchy version or delete an existing time-dependent hierarchy version.

When you load a master data hierarchy either from a flat file or from an InfoObject to a time-dependent hierarchy enabled dimension, you can select which hierarchy version to modify by selecting either a date or a version.. If you select a date, the system takes the version to which the selected date belongs. If you select a version, your selection is based on a time range.

Reporting

As long as there is at least one dimension from a model that has time-dependent hierarchy enabled, you can select a key date for reporting.

● EPM plug-in○ You can select Key Date in the context bar or report editor when the current model has at least one

dimension with a time-dependent hierarchy enabled.○ The selected key date affects all time-dependent hierarchy dimensions, meaning the version of the

hierarchy of the time-dependent hierarchy dimension depends on the selected key date.○ You can specify only one key date for a report. Multiple reports from the same worksheet or workbook

can have different key dates.○ The default key date is the current date.○ By default, three versions of the hierarchy for each time-dependent hierarchy dimension are cached on

the client machine. The number of cached versions can be changed by modifying in the client-side configuration file FPMXLClient.dll.config the line:<add key="LimitTDHCountInCache" value="3"/>

● Web Reporting○ You can select a key date from the dropdown menu by choosing Manage Context when the current

model has at least one dimension with time-dependent hierarchy functionality enabled.○ The selected key date affects all the time-dependent hierarchy dimensions, meaning the version of the

hierarchy of the time-dependent hierarchy dimension depends on the selected key date.○ The default key date is the crrent date.

Security

A data access profile is always defined with the hierarchy version of the current date. At run-time, data security is always resolved with the hierarchy version of the crrent date, no matter what key date is selected from the Reporting user interface.

Data Manager Packages

272 PUBLIC


Administration

A key date selection is available when executing a Data Manager package if the model has at least one time-dependent hierarchy enabled dimension.

Logic Scripts

● There is no keyword with logic script; it is not possible to specify a key date in a script file.● When a script is triggered by a Data Manager package, a key date is derived from the selection screen

when the package is executed.● For default logic, a key date is derived from the input-ready report.● For the script logic test transaction UJKT, the key date can be specified in the field PARAM with the format

KEYDATE = yyyymmdd.

Consolidation

Consolidation always uses the current date to resolve a hierarchy.

Transport

● A time-dependent hierarchy can be transported with dimension master data.● The global setting ENABLE_TIME_DEPENDENT_HIER cannot be transported. You must maintain this

manually in all systems.● The Time-dependent Hierarchy setting in a dimension structure can be transported together with

dimension transport. Note that the import process might fail if the global setting ENABLE_TIME_DEPENDENT_HIER is not set to X in the target system.

Backup and Restore

All versions of a time-dependent hierarchy can be backed up and restored together with master data.

Related Information

Enabling Time-Dependent Hierarchy Functionality [page 273]

10.13.1 Enabling Time-Dependent Hierarchy Functionality

Procedure

1. To activate the necessary global setting, perform the following steps:a. Go to the SAP NetWeaver backend using transaction SPRO.

b. Choose SAP Reference IMG Planning and Consolidation Configuration Parameters Set Global Parameters .

c. Insert a new flag with the field name ENABLE_TIME_DEPENDENT_HIER.d. Set its value to X, then save the entry.


2. To enable the time-dependent hierarchy functionality by dimension, perform the following steps. Note that all dimensions can enable time-dependent hierarchy functionality except dimensions with the dimension type TIME.a. Log onto the Planning and Consolidation web client.

b. Choose Administration Dimensions .c. Choose the dimension, then select Edit Structure.d. Choose Time-dependent Hierarchy, then save your selection.

10.14 Parallel Execution

Parallel execution can improve your system's performance by making better use of its processing capabilities.

You can use parallel execution for some of the functions that you run in Business Planning and Consolidation. Parallel execution can improve your system's performance significantly by making better use of its hardware and the resulting CPU time and memory. When you enable parallel execution, the framework splits the logic of the processed data when possible. The split parts are allocated to dialog sessions that the framework executes in parallel. This reduces the overall time necessary to complete a whole process. Parallel execution does not affect the business logic of your operations; it affects only the performance.

Parallel execution is available for the following functions:

● Loading data from an InfoProvider● Business rules for elimination and adjustment● Data Manager

Related Information

Enabling Parallel Execution [page 274]

10.14.1 Enabling Parallel Execution

To enhance Business Planning and Consolidation in terms of scalability and performance, you can enable parallel execution to leverage system resources such as CPU, memory, and so on.

Procedure

1. Go to the SAP NetWeaver backend using transaction SPRO.

2. Set the following parameters:

274 PUBLIC


Administration

Parameter Name Description

ENABLE_PARALLEL_EXECUTION Enables parallel execution mode.

PARALLEL_SERVER_GROUP The name of the server group where the dialog sessions will run.

MAX_SESSION_COUNT The maximum number of dialog sessions that parallel execution can use. Default: 12

BUFFER_ROW_SIZE The amount of data in a package. Default: 40000

BUFFER_MAX_ROW_SIZE The maximum amount of data in a package. Default: 90000

REFRESH_STATUS_INTERVAL The amount of time in seconds between session synchronization. Default: 10

BUFFER_MAX_PART_COUNT The amount of partitions at most one input buffer instance can handle. Default: 1000

BUFFER_WAIT_TIME_TO_EXIT The amount of time in seconds an input buffer should wait if there is no data. Default: 5

MONITOR_WAIT_TIME_TO_EXIT The amount of time in seconds the main session should wait before exiting if it cannot start an instance. Default: 10

3. NoteYou have the option of enabling parallel execution for Data Manager to obtain better performance when processing large amounts of data. The transaction data related process chains benefit from this framework to varying degrees. Among them, the process chain that loads data from the InfoProvider sees a significant benefit.

Optional - Apply the following line into the Data Manager dynamic script by performing the following steps:

a. Choose AO client Data Manager Organize Organize Package List .b. Select a package.

c. Choose Modify Package Modify Script Advanced .d. Apply the line PARALLEL_EXECUTION(ON).

10.15 Supported BAdIs

SAP Business Add-Ins (BAdIs) are used to adapt SAP software to specific requirements. They can be inserted into the system to accommodate user requirements that are not included in the standard delivery.

Business Process Flows

● BADI_RSBPCB_SETUSER - Provides the performer and reviewer of a BPF activity. This BAdI applies to both Business Process Flows and Work Status.


● BADI_UJ_BPF_REVIEW_VALIDATION - Overrides the system logic if the current user is able to approve or reject a BPF activity. This BAdI is triggered when the activity list is displayed and the user chooses Approve or Reject as a reviewer.

● BADI_UJ_BPF_REVIEW_LOGIC - With this BAdI you can implement custom logic. It is triggered when the user chooses Approve or Reject.

● BADI_UJ_BPF_SUBMIT_LOGIC - With this BAdI you can implement custom logic. It is triggered when the user chooses Submit.

Script Logic

● BADI_UJ_CUSTOM_LOGIC - With this BAdI you can implement custom calculation logic. It is triggered from script logic.

● BADI_UJCTRL_RUN_CONTROL (Enhancement spot UJCTRL_RUN_CONTROL) - Allows you to write your own control logic via ABAP.

SQE

BADI_UJ_SQE_POST_PROCESS

● Method POST_PROCESS - Triggered after data is read from the database. You can implement custom logic to manipulate the data before it is sent to the frontend.

● Method CUSTOMIZE_PROPERTIES - Triggered by master data properties in the BAdI implementation, before a web report is displayed. You can change the member description and input enablement of Planning and Consolidation web reporting.

Write Back

BADI_UJR_WRITE_BACK - Triggered when the write back module is started. The data sent from other modules is sent to the BAdI interface and you can manipulate that data within the BAdI implementation. The processed data goes through all standard validations and is posted to BW.

Data Manager

● BADI_UJD_RETRACT - Triggered from Data Manager. You can use this BAdI to export Planning and Consolidation data to an external source, for example, to write planning data back to ECC for budget control.

● BADI_UJD_ROUTINE - Triggered during transformation when loading data from an external data source. You can use this BAdI to run complex data transformations which are not possible with a transformation file.

276 PUBLIC


Administration

Validation

BADI_UJ_VALIDATION_RULE_LOGIC - Triggered by the write back module. You can use this BAdI to validate input data with ABAP code instead of defining validation rules.

Security

● BADI_UJE_DYNAMIC_DAP - Triggered after a static data access profile (DAP) setting is read from the database. You can use this BAdI to dynamically define data security for a user and reduce the number of static DAPs to be created.

● UJE_DIM_PROCESSED_BADI - Triggered after dimension master data is processed. Can be used to automatically update DAP settings based on a change in the master data.

Journals

BADI_UJJ_CALCULATED_AMOUNT - Triggered when you save or post a journal. Can be used to generate additional journal entries.

Work Status

● BADI_RSBPCB_SETUSER - You can implement customized logic that provides the owner and manager for work status. This BAdI applies to both Business Process Flows and Work Status.

● UJW_LOCKOUT_SCHEDULE_BADI - Triggered when the work status is checked by internal models. Can be used to provide work status lock information programmatically.

Parameter

BADI_UJ_PARAM_CHANGE - Triggered when a user changes a parameter in IMG. Mainly used by Planning and Consolidation internal logic to apply specific checks.


10.16 Security

User Administration and Authentication

● User Management [page 278]This lists the tools to use for user management and the types of users required.

● Integration into Single Sign-On [page 279]This describes how the application supports Single Sign-On mechanisms.

● Setting Up Users [page 280]This explains how to add new users in an environment, modify them, and delete them.

● Setting Up Teams [page 281]This explains how to set up and maintain teams of users.

Authorizations

The SAP BW/4 HANA authorization concept is based on assigning authorizations to users based on roles. For role maintenance, use the profile generator (transaction PFCG).

To define the models and data within those models to which users have access, you can use data access profiles in both the standard and embedded configurations of Planning and Consolidation. For detailed steps in a standard configuration, refer to Data Access Profile Setup [page 289]; For details in a embedded configuration, refer to .

To define what types of activities or tasks a user is authorized to perform in different functions, you can leverage the SAP NetWeaver authorization concept:

● In the Business Planning and Consolidation embedded configuration, you assign authorization objects to users based on roles.

● In the Business Planning and Consolidation standard configuration, you assign task profiles to users or a team of users in the web client.

For more information about how to maintain roles, see the SAP NetWeaver role administration information on the SAP Help Portal at http://help.sap.com.

10.16.1 User Management

User management for the application uses the mechanisms provided with the Application Server ABAP, for example, tools, user types, and password policies.

This table shows the tools to use for user management and user administration in the application.

User Management Tools

278 PUBLIC


Administration

http://help.sap.com

Tool Detailed Description Prerequisites

User and role maintenance with SAP NetWeaver AS ABAP (Transactions SU01, PFCG)

For more information about user and role administration of AS ABAP, see the SAP Help Portal at http://help.sap.com

.

-

User Types

Business Planning and Consolidation

The user types required for the application include the following:

● Individual users○ Dialog users are used for administration-related tasks.

● Technical users — not required

Standard Users

Business Planning and Consolidation

The application does not require the creation of additional dedicated users for any special purposes. Its use is possible via user accounts created for regular users by assigning the necessary application-related authorizations to them.

User Data Synchronization

The application does not deliver additional user data synchronization related features in addition to those available in the SAP NetWeaver platform. It also does not impose any special needs or restrictions, which would limit the usage of related NetWeaver tools.

RecommendationWe recommend that the application is used in an environment where the same users exist throughout all the connected systems in the landscape.

10.16.2 Integration into Single Sign-OnThe application is capable of operating in any single sign-on environment supported by SAP BW/4 HANA out of the box, meaning there are no limitations imposed by the application on the possible single sign-on configurations within an SAP landscape. Refer to the Authentication and Single Sign-On section in the Security Guide for SAP BW/4 HANA.

The supported mechanisms are as follows:

● Secure Network Communications (SNC)● SAP Logon Tickets● Client Certificates● SAML 2.0

NoteSAML support is only available on SAP NetWeaver ABAP or Java 7.02 or higher.


http://help.sap.com/disclaimer?site=http%3A%2F%2Fhelp.sap.com


● SPNego with Kerberos

For more information about the supported mechanisms, search using corresponding keywords on the SAP Help Portal at http://help.sap.com .

SSO Ticket Validity and Web Session Expiration

When a user connects to the Planning and Consolidation web client, SAP NetWeaver not only creates a web session but also generates an SSO (single sign-on) ticket (in the MYSAPSSO2 cookie). This ticket has a default validity of 8 hours.

After session timeout, the web session correctly expires but the SSO ticket remains valid. If the user sends a new request after the session has expired, the system authenticates the user through SSO and creates a new session. From the user perspective, it appears that the session has not expired.

In order to have correct session expiration, the administrator must limit the validity period of the SSO ticket (for example, to two minutes, which is the validity period of reentrance tickets). You set this using the kernel parameter login/ticket_expiration_time in the SAP NetWeaver default.pfl configuration file, for example, login/ticket_expiration_time=0:02.

For more information about how to set this parameter, see the SAP NetWeaver help at http://help.sap.com/saphelp_nw74/helpdata/en/22/41c43ac23cef2fe10000000a114084/content.htm .

10.16.3 Setting Up Users

You can add new users in an environment and assign them to teams, task profiles (standard only), and data access profiles.

If you are not using the default task or data access profiles and have not set them up yet, we recommend that you define them before adding users. You might also want to create teams, so that you can assign the newly added users to the appropriate teams.

Alternatively, when you define the teams and profiles, you can assign users to them at that time.

NoteSarbanes-Oxley compliance is a hardcoded behavior in Business Planning and Consolidation, as the system does not save users' passwords on client machines.

Adding Users

Before you can add a new user, you must have created that user in the ABAP back-end. For more information, see the SAP NetWeaver Security Guide.

To add users to Business Planning and Consolidation in a standard configuration, go to Administration and under the Security section, choose Users. In the Users view, select Add. In the Add User assistant, select the one or more users to add in the environment and assign one or more teams to the users.

280 PUBLIC


Administration


http://help.sap.com/disclaimer?site=http%3A%2F%2Fhelp.sap.com%2Fsaphelp_nw74%2Fhelpdata%2Fen%2F22%2F41c43ac23cef2fe10000000a114084%2Fcontent.htm

http://help.sap.com/disclaimer?site=http%3A%2F%2Fhelp.sap.com%2Fsaphelp_nw74%2Fhelpdata%2Fen%2F22%2F41c43ac23cef2fe10000000a114084%2Fcontent.htm

To add users to Business Planning and Consolidation in an embedded configuration, enter transaction code SU01 on the Business Warehouse back-end, type the name of the new user, and choose Create. Then go the Business Planning and Consolidation web client to define teams or data access profile.

Modifying Users

To modify a user definition, go to Administration and under the Security section, choose Users. In the Users view, highlight the user and select Edit. You can then add or remove teams, task profiles (in a standard configuration of the application) and data access profiles for the user.

Removing Users (Standard only)

To remove an existing user, go to Administration and under the Security section, choose Users. In the Users view, highlight the user and select Delete, then click OK.

Related Information

User Management [page 278]Integration into Single Sign-On [page 279]Setting Up Teams [page 281]

10.16.4 Setting Up Teams

You can set up and maintain teams of users. When you assign security to a team, the security works collectively on the team members. This allows you to set up task and data access security for several users at the same time.

Teams are not required to successfully set up security.

Adding Teams

To add teams, go to Administration and under the Security section, choose Teams. In the Teams view, select New. In the Add Team assistant, enter an ID and a description for the team and assign one or more users to it.

Modifying Teams

To modify teams, go to Administration and under the Security section, choose Teams. In the Teams view, highlight the team and select Edit. You can then add or remove users, task profiles and data access profiles for the team.

Removing Teams

To remove teams, go to Administration and under the Security section, choose Teams. In the Teams view, highlight the team and select Delete, then click OK.

Assigning Team Leaders

Assigning one or more team leaders is useful when you want to give them special access rights to the team's folder. You can assign team leaders while you are defining or modifying a team. You can choose one or more team members to be a team leader.


Related Information

User Management [page 278]Integration into Single Sign-On [page 279]Setting Up Users [page 280]

10.16.5 Task Profile Setup

A task profile defines the type of activities or tasks an administrator, a user, or a team of users can perform in the system.

Business Planning and Consolidation is installed with three administrative task profiles by default. You cannot modify these default profiles. You can, however, copy these profiles to create additional profiles for users and teams.

Administrator Task Profiles

The following default administrative task profiles permit a specific set of tasks:

● SystemAdmin● PrimaryAdmin● SecondaryAdmin

A System Administrator (SystemAdmin), by default, has the following task rights:

● Manage Environments● Manage Security● Use System When Offline

A Primary Administrator (PrimaryAdmin), by default, has the following task rights:

● Manage Models● Manage Business Rules● Manage Dimensions● Manage Data Locks and Work Status● Manage Environment Status● Manage Drill Throughs● Manage Templates● Manage Audit● Use Offline Distribution● Edit Comments● Edit Book and Distribution templates● Publish Books● Manage Security

A Secondary Administrator (SecondaryAdmin), by default, has the following task rights:

● Manage Dimensions● Edit content of Public Folder

282 PUBLIC


Administration

If you want a user to perform administration tasks, you must assign them one of the predefined administrator roles. Without one of these roles, the user cannot perform any administrator tasks.

The following tables provide the tasks, organized by functional area of the system, that administrators can assign to users and teams.

Administration Task Profile Descriptions

The following table describes the available tasks in the Administration interface:

Task Can be assigned to Description

Manage Business Rules Primary administrator Can define business rules.

Manage Data Locks and Work Status Primary administrator Can define and edit work status codes.

Manage Dimensions Primary and secondary administrators Create, modify, process, and delete dimensions and members.

Manage Document Types Any user or team Can categorize collaboration postings, which is useful when filtering collaboration postings to see certain types. Subtypes can be managed by administrators or created by users as they post.

Manage Drill Throughs Primary administrator Can create and modify drill-through setup.

Manage Environment Status Primary administrator Can view environment status.

Manage Environments System administrator Can create and modify environments, and set environment parameters.

Manage Models Primary administrator Can create, modify, and delete models in an environment, make changes to dimensions and add dimensions, and optimize models.

Analysis and Collection Task Profile Descriptions

The following table describes the available tasks in the Analysis and Collection interface:


Manage Templates Any user or team Can access templates from the public folder, and restrict workbook options. A team member or team leader with this task can access and save templates to their respective team folder.

Run Drill Throughs Any user or team Can execute drill-throughs.



Use Input-ready Reports and Save Data Any user or team Can access the input-ready reports and send data. Can use spread, weight, and trend options. Controls submitting data from the web reports.

Audit Task Profile Descriptions

The following table describes the available tasks in the Audit interface:


Manage Audit Any user or team Can manage activity and data auditing.

Business Process Flows Task Profile Descriptions

The following table describes the available tasks in the Business Process Flows interface:


Manage BPFs Any user or team Can create, modify, and delete business process flows.

Use BPFs Any user or team Can execute business process flow tasks.

Collaboration Task Profile Descriptions

The following table describes the available tasks in the Collaboration interface:


Use Offline Distribution Any user or team Can use the Offline Distributor.

Use Offline Collection Any user or team This user or team collects changes to offline input forms and sends data to a database.

Comments Task Profile Descriptions

The following table describes the available tasks in the Comments interface:


Administer Comments Any user or team Can add, modify, and remove comments for all users.

284 PUBLIC


Administration


Edit Comments Any user or team Can add, modify, and remove his or her own comments.

Consolidations Task Profile Descriptions

The following table describes the available tasks in the Consolidations interface:


Dismiss Blocking Controls Any user or team Can force failing controls to Dismissed status

Edit Ownership Manager Any user or team This user or team has write access to the Ownership Manager, but cannot run the ownership calculation routine.

Edit Controls definition Any user or team Can set up controls in Administration.

Reset Control Dismissal Any user or team Can reset a Dismissed control status to its previous status.

View Consolidation Monitor Any user or team Can access the Consolidation Monitor, but cannot perform any actions.

Run Consolidation Tasks Any user or team Can run currency translation and consolidations in the Consolidation Monitor.

Run Controls Any user or team Can access Controls Monitor and run control calculations.

Run Ownership Calculations Any user or team Can execute the ownership calculation.

View Controls Any user or team Can access Controls Monitor in read-only mode.

View Controls definition Any user or team Can read Control Manager definitions.

View Ownership Manager Any user or team Can access the landing page of the Ownership Manager.

Data Manager Task Profile Descriptions


The following table describes the available tasks in the Data Manager interface:


Run Admin Packages Any user or team Can run Admin packages within Data Manager.

Edit Packages Any user or team Can maintain packages within Data Manager.

Edit Transformation Files Any user or team Can maintain transformation files within Data Manager.

Edit Conversion Files Any user or team Can maintain conversion files within Data Manager.

Cancel Any User Packages Any user or team Can cancel user packages within Data Manager.

Edit Package Schedules for any user Any user or team Can change the package schedule for any user within Data Manager.

Run Packages Any user or team Can run packages within Data Manager.

Edit Package Links Any user or team Can maintain package links within Data Manager.

Upload Data Any user or team Can upload data within Data Manager.

Download Data Any user or team Can download data within Data Manager.

Folder Access Task Profile Descriptions

The following table describes the available tasks in the Folder Access interface:


Edit content of Public Folders Secondary Admin Can add and manage content in the public folder, including creating new folders. User also needs document type access rights, such as Edit Workspaces or Edit Reports.

Journal Task Profile Descriptions

The following table describes the available tasks in the Journal interface:


Edit Journals Any user or team Can create or modify journal entries.

286 PUBLIC


Administration


Lock/Unlock Journals Any user or team Can lock and unlock journal entries

Manage Journals Any user or team Can manage journals as follows:

● Create and maintain journal templates

● Clear journal tables● Create Journal

Post Journals Any user or team Can post journals.

View Journals Any user or team Can view journals.

Unpost Journals Any user or team Can unpost journal entries.

Reopen Journals Any user or team Can reopen journals.

Publish Task Profile Descriptions

The following table describes the available tasks in the Publish interface:


Edit Book and Distribution templates. Primary Admin Can create, edit, and save book and distribution templates.

Publish Books Primary Admin Can publish a book of reports.

System Reports Task Profile Descriptions

The following table describes the available tasks in the System Reports interface:


Run Audit Reports Any user or team Can run audit reports.

Run Comment Reports Any user or team Can run a comment report.

Run Security Reports Any user or team Can run security reports.

Run Work Status Reports Any user or team Can run a work status report.

System Security Task Profile Descriptions


The following table describes the available tasks in the System Security interface:


Use System When Offline System Admin Can log onto Planning and Consolidation when the status of an environment is Not Available.

Manage Security System and primary administrators Can manage users, task, and data access profiles.

CautionWe recommend that you restrict access of this task to a few privileged users.

Web Report Task Profile Descriptions

The following table describes the available tasks for web reports:


Edit Worksheet Any user or team Can create and update worksheets.

Edit Documents Any user or team User can use documents, can add, edit, and delete their own documents, and can access all documents shared with them.

Administer Documents Primary Administrator Can use documents, and can add, edit, and delete all documents.

Web Service Task Profile Descriptions

The following table describes the available tasks in the Web Service interface:


Access BPC from FIM and SSM Any user or team Can access Planning and Consolidation from the Financial Information Management and Strategy Management applications.

Work Status Task Profile Descriptions

288 PUBLIC


Administration

The following table describes the available tasks in the Work Status interface:


Use Work Status Any user or team Can change the work status on a data region.

Adding a Task Profile

To create a new task profile in the Administration workspace, choose Security Task Profiles New . Enter data as required.

Tips for Assigning Task Profiles

● The number of task profiles administrators can assign to a user is not limited. However, we recommend that you do not assign multiple task profiles to users because it may cause you confusion in determining their ultimate access rights.Task access security is cumulative, and tasks cannot be explicitly denied. As a result, assigning multiple task profiles can create a situation where users have access to tasks that you may not want them to have.

● Administrators can assign multiple task profiles to a team. However, we recommend that you do not assign multiple task profiles to a team because it may cause you confusion in determining the ultimate access rights of that team.

10.16.6 Data Access Profile Setup

You must define a data access profile for all secured dimensions of a model.

If no profile is defined for a secured dimension, the users assigned to the profile do not have access rights to that model. If you partially define access, for example, for one of two secured dimensions, users are still denied access to the model.

After creating a data access profile, you assign it to users as needed.

Features

General Rules for Data Access Security

Data access security is based on the following rules:

● By default, no one other than the system administrator has access to members. Member access must be explicitly granted.

● A user can be assigned data access individually and through team membership.● Data access privileges flow down the hierarchy, from parent to child.● When in conflict, the least restrictive data access profile is applied.● In case of a conflict between individual and team data access, the least restrictive setting is applied.

Creating Data Access Profiles


1. Go to the Administration page and under the Security section, choose Data Access Profile.2. On the screen that appears, choose New.3. Enter the ID and description of the new data access profile.4. Select the required model from the list.5. For each authorization relevant dimension, select the required members and set their access rights.6. Go to the Users or Teams tab to assign the new data access profile to users that are assigned to the current

environment or teams that have corresponding users assigned to it.

Defining Access to Members with Children

When defining access to a secured dimension that has one or more defined hierarchies, security is applied to the member and all of its children. For example, if you grant access to a member that has 10 children, users with access to the parent member also have access to the 10 children.

You can restrict a child member of a parent with ‘Read Only’ or ‘Write’ access by creating a separate data access profile and assigning the child ‘Denied’ access. Alternatively, you can use the same data access profile as the parent, but create a new line item for the child.

Resolving Data Access Profile Conflicts

Since you can define member access by individual users and by teams, there may be situations in which conflicts occur. The following sections describe some potential member access conflict scenarios and the rules the system applies to resolve those conflicts. These scenarios are based on the assumption that the Entity dimension is a secured dimension and has the following hierarchical structure:

Hierarchy Members

H1 WorldWide1 Sales SalesAsia SalesKorea

SalesJapan

ESalesAsia

SalesEurope SalesItaly

SalesFrance

ESalesEurope

H2 WorldWide2 Asia Korea SalesKorea

Japan SalesJapan

eAsia ESalesAsia

Europe Italy SalesItaly

France SalesFrance

eEurope ESalesEurope

Conflict Between Profiles

When there is a conflict between data access profiles, the least restrictive profile is always applied. This section describes three different scenarios where there are conflicts between profiles.

290 PUBLIC


Administration

ExampleScenario 1:

● User1 belongs to Team1 and Team2.● There are two data access profiles: ProfileA and ProfileB.● ProfileA is assigned to Team1 and ProfileB is assigned to Team2.

The data access profiles are described in the following table:

Data Access Profile Access Dimension Member

ProfileA Write Entity Sales

ProfileB Read Only Entity SalesAsia

In this case, the least restrictive profile between the two, ProfileA (Write), is applied. As a result, ProfileB is ignored by the system, and User1 is able to send data to both SalesKorea and SalesItaly.

ExampleScenario 2:

● User1 belongs to Team1 and Team2● There are two data access profiles: ProfileA and ProfileB.● ProfileA is assigned to Team1 and ProfileB is assigned to Team2.



ProfileA Read Only Entity Sales

ProfileB Write Entity SalesAsia

In this case, the least restrictive profile between the two, ProfileB (Write), is applied for the child members of SalesAsia. As a result, ProfileA is ignored by the system, and User1 is able to send data to SalesKorea, but not to SalesItaly.

ExampleScenario 3:

● User1 does not belong to any team.● There are two data access profiles: ProfileA and ProfileB.● Both the profiles are assigned to the user.




ProfileA Denied Entity SalesAsia

ProfileB Read Only Entity Sales

In this case, the least restrictive profile between the two, ProfileB (Read Only), is applied. As a result, ProfileA is ignored by the system, and User1 is able to retrieve data from both SalesKorea and SalesItaly.

Conflict Between Parent and Child Members

Authority always flows down the hierarchy from parent to child. Child members always have the access level of their parents, unless otherwise specified.

ExampleScenario 1:

● User1 belongs to Team1 and ProfileA is assigned to Team1.● Two levels of data access profiles are defined for ProfileA.

The data access profiles for ProfileA are described in the following table:


ProfileA Write Entity Sales

ProfileA Read Only Entity SalesAsia

In this case, the Write access of the Sales member flows down to its children. This flow is interrupted by assigning Read Only access to SalesAsia (a descendant of Sales), and SalesAsia’s access flows down to its descendants. As a result, User1 is able to send data to SalesItaly, but not to SalesKorea.

ExampleScenario 2:

● User1 belongs to Team1 and ProfileA is assigned to Team1.● ProfileA has two levels of data access profiles.

The data access profiles for ProfileA are described in the following table:


ProfileA Read Only Entity Sales

ProfileA Write Entity SalesAsia

In this case, the Read Only access of the Sales member flows down to its children. This flow is interrupted by assigning Write access to SalesAsia (a descendant of Sales), and SalesAsia’s access flows down to its descendants. As a result, User1 is able to send data to SalesKorea but not to SalesItaly.

Conflict When the Same Member Belongs to Different Hierarchies

292 PUBLIC


Administration

When a member belongs to different hierarchies, and there is a conflict in member access, the most restrictive access is applied.

ExampleScenario: ProfileA and ProfileB are assigned to User1. The data access profiles are described in the following table:


ProfileA Read Only Entity WorldWide1

ProfileB Write Entity WorldWide2

In this case, ProfileB determines User1’s access. As a result, User1 is able to send data to SalesKorea, even if ProfileA denies User1 Write access to SalesKorea (in WorldWide1 hierarchy).

Attribute Based Data Access Profiles

When you are creating a data access profile, you can assign different levels of access based on properties. The examples described below are based on the following hierarchy:

ID Region Country Currency

Entity0 Europe Germany Euro

— Entity1 Europe Germany Euro

— — Entity101 Europe UK GBP

— — Entity102 Europe France Euro

— — Entity103 Europe Germany Euro

— Entity2 North America USA USD

— — Entity201 North America USA USD

— — Entity202 North America Canada CAD

— — Entity203 North America Mexico MXN

Example — One Data Access Profile

The data access profile DAP1 is defined as follows:

Rule Number Members Access Comment Result

1 Entity1 Read Read access to Entity1 and all its descendants

Read access to Entity1, Entity101, Entity102, Entity103



2 Country = Germany and Currency = Euro

Write Write access to members whose Country is Germany and Currency is Euro

Write access to Entity0, Entity1 and Entity103

3 Entity103 Deny No access to Entity103 No access to Entity103

When there are conflicting rules in a data access profile, the priority is as follows (from highest to lowest):

1. Access defined exactly on the member (be it a base member or a parent member).2. Access defined by attributes (will not be inherited).

ExampleIf the defined attributes are Currency=Euro: Read and Country=France: Write, then Entity102 is writable.

3. Access inherited from parent.4. Access defined to “All members” (as if defined on a virtual parent on top of the hierarchy).

The result is shown in the table below:

ID Access Comment

Entity0 Write Defined by rule number 2.

Entity1 Read Read access defined by rule number 1; Write access defined by rule number 2. Rule number 1 is applied, because it applies directly to Entity1.

Entity101 Read Defined by rule number 1.


Entity103 Deny Read access defined by rule number 1; Write access defined by rule number 2; Deny access defined by rule number 3. Rule number 3 is applied, because it applies directly to Entity103.

Entity2 Deny If no rules exist, access is denied by default.



294 PUBLIC


Administration

ID Access Comment


Example — Two Data Access Profiles

Data access profile DAP2 is defined as follows:


1 All members Read Read access to all members

Read access to all members

2 Entity1 Deny No access to Entity1 and its descendants

No access to Entity1, Entity101, Entity102 and Entity103

3 Currency = USD Write Write access to members whose currency is USD

Write access to Entity2 and Entity201

The result of this data access profile is shown in the table below:

ID Access Comment

Entity0 Read Defined in rule number 1.

Entity1 Deny Read access defined by rule number 1; Deny access defined in rule number 2. Rule number 2 is applied, because it applies directly to Entity1 and its descendants.




ID Access Comment


Entity2 Write Read access defined by rule number 1; Write access defined in rule number 3. Rule number 3 is applied, because it applies directly to the properties of Entity 2.

Entity201 Write Read access defined by rule number 1; Write access defined in rule number 3. Rule number 3 is applied, because it applies directly to the properties of Entity 201.



If several data access profiles are assigned to a user or a team, the combination of the least restrictive rules of all profiles is applied. Therefore, if both DAP1 and DAP2 are assigned to a user, that user will have the following permissions:

ID Access granted by DAP1 Access granted by DAP2 Result

Entity0 Write Read Write access

Entity1 Read Deny Read access



Entity103 Deny Deny Access denied

Entity2 Deny Write Write access

Entity201 Deny Write Write access

Entity202 Deny Read Read access

Entity203 Deny Read Read access

296 PUBLIC


Administration

Important Disclaimers and Legal Information

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

Videos Hosted on External PlatformsSome videos may point to third-party video hosting platforms. SAP cannot guarantee the future availability of videos stored on these platforms. Furthermore, any advertisements or other content hosted on these platforms (for example, suggested videos or by navigating to other videos hosted on the same site), are not within the control or responsibility of SAP.

Beta and Other Experimental FeaturesExperimental 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 CodeAny 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 LanguageWe 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.

Application Help - SAP Business Planning and Consolidation, version for SAP BW/4HANA (Standard configuration)Important Disclaimers and Legal Information PUBLIC 297

www.sap.com/contactsap

© 2021 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

https://www.sap.com/about/legal/trademark.html

(Standard configuration) Consolidation, version for SAP BW ...

Documents

Transcript of (Standard configuration) Consolidation, version for SAP BW ...