BPC101NW - S4HANA - en - Optimizado PDF
BPC101NW - S4HANA - en - Optimizado PDF
BPC101NW - S4HANA - en - Optimizado PDF
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
2 PUBLIC Content
Page Axis (Embedded only). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
Planning Sessions and Locking Cells in Input Forms (Embedded only). . . . . . . . . . . . . . . . . . . . 101
1.11 Dashboards (Standard only). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
Create a Dashboard and Add Tiles (Standard only). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
Delete a Report or Input Form Tile in a Dashboard (Standard only). . . . . . . . . . . . . . . . . . . . . . 103
Modify or Delete a Dashboard (Standard only). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
1.12 Creating and Modifying Workspaces (Standard only). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
1.13 Uploading and Modifying Crystal Dashboard Templates (Standard only). . . . . . . . . . . . . . . . . . . . .105
1.14 Administration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
Environment Management. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
Dimension Management. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114
Model Management. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150
Consolidation (Standard only). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166
Consolidation (Embedded only). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .189
Rules. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209
Business Process Flow Management. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 320
Work Status Setup. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .344
Journal Administration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 353
Context Defaults (Standard only). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 363
Drill-Through Setup (Standard only). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 364
Document Types and Subtypes (Standard only). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 366
Auditing. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 366
Time-Dependent Hierarchies (Standard only). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .369
Parallel Execution (Standard only). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 372
Supported BAdIs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 373
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
Content PUBLIC 3
1 SAP Business Planning and Consolidation
for SAP S/4HANA
Product Information
Release SP00
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
4 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
Feature Enhancements and Documentation Changes ● In the section titled Integration below, added informa
tion about data integration enhancements with SAP An
alytics Cloud.
● In Components of Reports [page 89], added informa
tion about excluding members from selected member
list.
● Modified all information about transaction code RSA1
(RSD1), as all configurations in RSA1, including manag
ing InfoObjects and InfoCubes, have been transferred to
BW modeling tools.
● In Process Settings [page 323], added information
about supporting the navigation attribute in the embed
ded configuration.
● In Creating Process Instances [page 339], removed the
standard only classification for archiving process in
stances as this is now supported in both standard and
embedded configurations.
● In Create or Modify a Consolidation Model (Embedded
only) [page 206], added information about choosing
fixed superior compounding dimensions.
● In Business Rules Management (Embedded only) [page
289], added information that you can choose text no
des and external node members only for source mem
bers of account, category, audit and flow type dimen
sions.
● In Create or Modify a Consolidation Model (Embedded
only) [page 206], added information about choosing
fixed superior compounding dimensions.
● In Consolidation Monitor (Embedded only) [page 48],
added information about supporting US Elmination type
business rules, changing work statuses, and executing
controls in consolidation monitor.
● In Set Task Sequence (Embedded only) [page 206],
added information about a new way of setting up tasks
and their sequences to be executed later in Consolida
tion Monitor.
● Added the new section US Eliminations Rule (Embed
ded only) [page 298] about enabling US Eliminations
and matrix consolidation in the embedded configura
tion.
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.
This release of SAP Business Planning and Consolidation uses SAPUI5 user interface technology, which is
based on standard HTML5. The user interface provides all the benefits of HTML5 and it supports languages
such as Hebrew and Arabic that are written and read from right to left.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 5
Two product variations called embedded and standard are supported based on the way your installation is
configured. Prior to support package 3 of release 10.1, these configurations were called unified and classic
respectively.
● Business Planning and Consolidation in the embedded configuration is integrated with SAP Business
Warehouse Planning Applications Kit. By using the BW Planning Applications Kit you can perform SAP
HANA-optimized planning. You can use the embedded configuration of SAP Business Planning and
Consolidation only with SAP HANA-based systems. For details about BW Planning Application Kit and BW
planning processor, refer to the Planning Processor topic within the SAP NetWeaver Analytic Manager
application help available at http://help.sap.com.
● In a standard configuration, you can use all the functionalities that are available in release 10.0 of SAP
Business Planning and Consolidation, version for SAP NetWeaver.
For details about the changes in the embedded and standard configurations, refer to “What’s New (Release
Notes)” available on the SAP Help Portal.
Note
When information in this application help applies to only one of the configuration types, the title of the topic
contains an indicator of either Embedded only or Standard only. Topics that contain no indicator in their
titles apply to both embedded and standard configurations of Business Planning and Consolidation. Also,
information within a single topic that differs between the configuration types will be clearly explained within
the relevant content.
Business Planning and Consolidation for SAP S/4HANA, is specifically designed for Real-Time Consolidation
while retaining all previous BPC functionality.
Real-Time Consolidation (RTC) is a consolidation solution that is based on the deep integration between SAP
S/4HANA and the embedded configuration of SAP Business Planning and Consolidation. It has privileged
direct access to universal journal entries, while leveraging the consolidation capabilities from the embedded
configuration of SAP BPC. For detailed information about Real-Time Consolidation, see the Real-Time
Consolidation (version 1709) in SAP S/4HANA help available on the SAP Help Portal.
Integration
The HTML5-based web client offers an integrated view for both business users and administrative users.
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.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
6 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
SAP Analytics Cloud
SAP 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.
Recommendation
We 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.
Web Client
When you first open the Web Client, you are presented with the home page. The home page is always available,
and it contains all components that you are authorized to access, including:
● Library [page 14] - Provides information about how to access the objects that are saved in the Library
view. You use the Library view to store and organize Planning and Consolidation objects (reports and input
forms).
● My Activities [page 12] - Provides information about using Business Process Flows (processes). For
information about setting up process templates, see the Administration section of the help.
● Administration [page 107] - enables administrators to perform setup and maintenance tasks for Planning
and Consolidation environments and models.
● System Reports [page 76] - Provides information about reporting on system information and activity.
● Run Consolidation (Standard only) [page 17] - Provides information about generating and managing
consolidated data to give you an accurate view of the financial situation of your organization in a standard
configuration.
● Run Consolidation (Embedded only) [page 47] - Provides information about generating and managing
consolidated data to give you an accurate view of the financial situation of your organization in an
embedded configuration.
● Documents (Standard only) [page 15] - 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
For more information about the home page, see Home Page and Navigation [page 10].
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 7
To start the Planning and Consolidation Web Client, do the following:
Note
Logging 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.
Use
The following features are available within SAP Business Planning and Consolidation:
● You can change the user preferences to customize the display of your UI (see Preferences [page 8]).
● You can change the way data displays in table format (see Grid [page 9]).
1.1.1 Preferences
Use
You can change the user preferences to customize the display of your UI. You can make changes to the
language, date format and others.
Features
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
8 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
My Preferences
Feature Description
Theme The theme that you want to use for the application UI.
Time The time zone that you want to use in the application.
Name Format The format in which the logged in user's name appears.
Activities
To view and edit user preferences, in the upper left part of the screen, click your user name and choose
Preferences.
Note
Your changes will take effect upon your next logon. If you want to apply the changes immediately, you must
restart the application.
1.1.2 Grid
Definition
A table that displays data and allows you to alter the display of that data.
Use
You can display data in table format and change the display as follows:
● You can reorder the columns in a table using drag and drop.
● Where available, you can filter the data displayed in a table. To do that click the column header and then
click the button.
By entering a specific value, you can narrow the data displayed to only include that value.
● Display or hide certain columns using the (Column Selector), 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 selecting the column header.
The data is sorted in ascending or descending order.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 9
1.2 Home Page and Navigation
Use
When you log in to the Web client of Business Planning and Consolidation, the first screen that you see is the
home page. From this page you can choose the functionality that you want to access.
● Library - Provides information about how to access the objects that are saved in the Library view. You use
the Library view to store and organize planning and consolidation objects (reports and input forms). If you
are using Planning and Consolidation in the standard configuration, you can also work with workspaces.
For more information, see Creating Reports [page 87] and Creating and Modifying Workspaces (Standard
only) [page 104].
● My Activities - Provides information about using business process flows (processes). For information about
setting up process templates, see Business Process Flow Management [page 320].
● Administration - Enables administrators to perform setup and maintenance tasks for Business Planning
and Consolidation. See Administration [page 107].
● System Reports - Provides information about reporting on system information and activity. See System
Reports [page 76].
● 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 (Standard only) [page
17].
● Standard only: Documents - 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 (Standard only) [page 15].
Navigation
When you open several pages, you can use the following ways to navigate between them:
● Use the arrows that appear at the left and right side of the page.
Click the active environment from the lower right corner of the screen and select the desired one from a list.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
10 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
Set Preferences
Click on your name that is displayed in the upper left corner of the screen and choose Preferences to set
individual preferences. For more information, see Preferences [page 8].
Use
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:
● Activities
Activities 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 12].
● Process Monitor
Process 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 13].
● E-mail notifications
The 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. 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
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 11
○ 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.
For information on how system administrators configure e-mail notifications, see Setup of E-mail Notifications
[page 340].
1.3.1 My Activities
Use
This function displays the activities requiring action by you as the currently logged-on user. The action might
include performing activities assigned to you or reviewing any 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 that you can use to execute your tasks.
Before any action is taken, activities can have the following statuses:
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:
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.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
12 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
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. In the upper portion of the panel, you
can choose to display finalized or active processes, or display processes by ID, description, or both.
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 select the activities 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 332].If you are a process instance owner, you can
reopen activities of the processes you own without any limitations. To reopen an activity, hover your mouse
over the corresponding process and choose Reopen to select any activities that you want to reopen.
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. For details about how to define the integration of work status with business process
flows, refer to Integrating with Work Status [page 338].
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.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 13
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.
1.5 Library
Use
This function enables you to create and display Business Planning and Consolidation objects, such as
workspaces, reports and input forms. In Business Planning and Consolidation in a standard configuration, you
can also display dashboards that were created in SAP Crystal Dashboards, books created in the EPM add-in,
and dashboards made up of reports and input forms.
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.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
14 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
In Business Planning and Consolidation in an embedded configuration, users with the task profile Edit
Content of Public Folder can add and manage the content.
In Business Planning and Consolidation in a standard configuration, 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 team lead has edit access of the team folder.
You can create new folders under the Teams, Public, and Private folders.
Activities
To filter by object type, select the object type from the Show menu. To show all objects, select All.
To add a new object, choose one of the object types that appear in the New bar.
For information about analyzing data using the EPM add-in, which is an add-in to Microsoft Office Excel,
Microsoft Office Word, and Microsoft Office PowerPoint, see the EPM Add-in for Microsoft Office User Guide
available on the SAP Help Portal ( http://help.sap.com/epm ).
Related Information
Uploading and Modifying Crystal Dashboard Templates (Standard only) [page 105]
Creating Reports [page 87]
Context (Standard only) [page 98]
Dashboards (Standard only) [page 101]
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.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 15
Features
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, .POT
M, .DOCX, .DOCM, .DOTX, .DOTM, .CDM, .TDM, .PNG, .GIF, .JPG, .CSS, .MRC.
Note
Administrators 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.
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
○ 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.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
16 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
1.7 Run Consolidation (Standard only)
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
● 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
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 (Standard only) [page 166].
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 (Standard only) [page 40].
The scope context area displays the selected dimension members: Time, Category and Group.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 17
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.
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.
Example
A 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:
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.
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).
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
18 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
Prerequisites
An administrator has given you the View Consolidation Monitor and Run Consolidation Tasks access rights.
Features
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 19
Activities
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.
● Category
Choose the type of reported data to which the amount to be translated is linked.
● Time
Select the data entry period in which the amount to be translated was entered.
● Group/Entity
Select the scope for which you want to run the translation. The translation is executed on the currencies
defined in the Group dimension.
● Reporting Currency
If 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
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 Mode
You 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.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
20 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
Activities
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
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.
● Category
Choose the type of reported data that you want to consolidate.
● Time
Select the data entry period in which the amounts were entered.
● Group
Select the scope for which you want to run the consolidation.
● Execution Mode
Choose whether to perform a full consolidation or to update a previous consolidation by performing an
incremental consolidation.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 21
Activities
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 (Standard only) [page 17].
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
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
22 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
1.7.2 Controls Monitor (Standard only)
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 (Standard only) [page 40].
● 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 controls
In 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
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.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 23
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.
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:
Example
For 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 309]; for more information
on control status, see Control Set Status (Standard only) [page 26].
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.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
24 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
Activities
● To run controls for the selected entity or entities, see Execute a Control Set (Standard only) [page 25].
● 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
Prerequisites
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 314].
Procedure
1. In Consolidation Controls Monitor , select the entity or group of entities required and click Run
Controls.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 25
The results are displayed in the Controls Monitor page.
Note
For 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.
Example
If 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
A control set has only one output - the control set status.
● Not applicable
No control set has been defined for the selected Category and Time dimension members.
● To be executed
Applies 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.
○ 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.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
26 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
Note
When 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.
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
The control status of a parent member or group depends on the control status of the child entities.
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
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 27
Entity Control Entity Control Entity Control Entity Control
Control Type Control Name Control Level Level 1 Level 2 Level 3 Level 4
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:
First assume that after executing each entity by the related Time and Category, the control status turns out
as below:
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:
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.
Related Information
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
28 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
1.7.3 Journals (Standard only)
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 .
Create a journal entry Click New in the toolbar of the Journals For more information, see Journal En
page. tries (Standard only) [page 32].
Modify a journal entry Select a journal entry from the list in the You can modify saved and unposted
Journals page and click Open in the journal entries. For more information,
toolbar. In the Journal Entries tab, make see Journal Postings (Standard only)
your changes to one or more journal en [page 35].
try rows, then click Save.
Copy one or more journal entries Select one or more journal entries in You can copy selected entries to an
the Journals page. To select non-contig other member of one of the header di
uous journal entries, hold down the mensions.
CTRL key as you make your selections.
Select Copy To from the toolbar, specify
whether to keep the same Time, Cate
gory, and Datasource dimension mem
bers and confirm.
Preview line item detail of a journal en Select a journal entry from the list on You can review detail lines of a journal
try the Journals page and select the entry for the entries to which you have
Preview option in the toolbar. The de View rights. For more information, see
tails on the journal entries appear below Journal Queries (Standard only) [page
the list of journal entries. 37].
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 29
Task Navigation What You Should Know
Open one or more journal entries Select a journal entry from the list on You open journal entries to view or edit
the Journals page and click Open in the them. For more information, see Jour
toolbar. You view the details of the jour nal Entries (Standard only) [page 32].
nal 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.
Post one or more journal entries Select one or more journal entries from When you post an entry, the system ap
the list on the Journals page and click plies the values in the journal entry to
Post in the toolbar. All the selected en the database, so that model data is ap
tries are posted. To select non-contigu pended. You can configure a journal en
ous journals, hold down the CTRL key try to be posted with multiple header di
as you make your selections. mensions or multiple values. For more
information, see Journal Postings
(Standard only) [page 35].
Unpost one or more journal entries Select one or more journal entries from The system reverses the original entry
the list on the Journals page and click to the model. For more information, see
Unpost in the toolbar. All the selected Journal Postings (Standard only) [page
journal entries are unposted. To select 35].
non-contiguous journal entries, hold
down the CTRL key as you make your
selections.
Ungroup journal entries Select one of the journal entries in a For more information, see Journal
journal group and click Ungroup in the Groups (Standard only) [page 36].
toolbar. All the journal entries in the
group are ungrouped.
Search for journal entries In the Filter by menu located in the tool If a large number of journal entries are
bar of the Journals page, choose written to a model, use the Advanced
Advanced Query. In the Advanced Query Query to define queries so you can
dialog box, define your query and click search for specific entries. The
OK. 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
(Standard only) [page 37].
Lock and unlock journal entries Select a journal entry from the list in the When you lock a journal entry, you can
Journals page and click Lock in the tool not make changes to the line item de
bar. To unlock the journal entry, select it tails.
and click Unlock in the toolbar.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
30 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
Task Navigation What You Should Know
Reopen journal entries Select one or more journal entries from To reopen one or more single journal
the list on the Journals page and click entries to new single journal entries in a
Reopen in the toolbar. subsequent time period, see Reopen
Journal Entries (Standard only) [page
38].
Require balanced journal entries Select the Enforce Balanced Journals A balanced journal entry is one in which
option in the journal model parameters. the debits equal the credits in the jour
nal entry. If this option is set, you can
not post the journal entry until it is bal
anced. For more information, see Jour
nal Model Parameters [page 356].
Print a journal report Select one or more journal entries from You can generate reports based on jour
the list on the Journals page and click nal entries. For more information, see
Report in the toolbar. To select non-con Print Journal Reports (Standard only)
tiguous journals, hold down the CTRL [page 39].
key as you make your selections. In the
Journal Report tab that opens, click Note
Print. To 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 When you delete an entry that has been
the list on the Journals page and click unposted, its status changes to
Delete in the toolbar. To select non-con Deleted. When you delete saved entries,
tiguous journals, hold down the CTRL they are deleted from the system. An
key as you make your selections. entry that has been posted cannot be
deleted until it is unposted. For more in
formation, see Reopen Journal Entries
(Standard only) [page 38].
Define journal reopen rules In Planning and Consolidation Adminis Design a template of translation infor
tration, select Features Journal mation for the dimensions you want to
reopen. For more information, see Re
Templates . Open a journal template
open Journal Entries (Standard only)
and click the Reopen Rules tab.
[page 38].
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 31
1.7.3.1 Journal Entries (Standard only)
You create and maintain journal entries using the journal entry template built by your administrator.
Features
Postings
You can post journal entries after they have been saved. For more information, see Journal Postings (Standard
only) [page 35].
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 (Standard only) [page 39].
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.
You can enter standard journal entries, which have one member defined for each header dimension and one
credit or debit value.
Activities
To create a journal entry, select Consolidation Journals , then click New in the toolbar. For more
information, see Journals (Standard only) [page 29].
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
32 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
1.7.3.2 Journal Entry Form (Standard only)
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:
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 click
ing the entry cell to display the Member Selector dialog box.
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.
Journal Entries tab Display in columns so that each row under the dimension
name is unique. Each unique combination of members rep
resents one detail line. You can enter the members associ
ated with the data values you want to change, and the debit
or credit amount. When you create multiple entries with mul
tiple values from a single header item, a set of debit and
credit columns displays for each additional member speci
fied.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 33
Form fields Description
Multi Posting tab The journal entry is posted to the database under each di
mension member defined for Multiple Headers and Multiple
Values. This tab is grayed out until one of the aforemen
tioned options is selected.
Note
This option sets up a new journal; it does not create
postings.
Related Information
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
34 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
1.7.3.3 Journal Postings (Standard only)
You post journal entries to enter the details of a transaction into the database.
Prerequisites
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.
You can repost journal entries that you accidentally delete. Only journal entries that have previously been
posted can be reposted.
You can unpost one or more journal entries to make changes to them.
You can configure a journal entry to be posted to the cube 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.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 35
● 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 mode
1. 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:
Note
The Multi Posting tab is greyed out, until you select one of the above options.
○ 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
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 (Standard only) [page 33].
Features
● Group ID
All 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.)
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
36 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
● Group Status
All 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
Related Information
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:
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 37
Activities
Note
The query settings are saved until you deselect Advanced Query in the Filter by menu.
Related Information
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 355].
The system is set to allow for reopening of journals using the Allow Journals to be Reopened journal parameter.
See Journal Model Parameters [page 356].
Features
You can reopen one or more journal entries to new journal entries.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
38 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
Activities
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.
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 (Standard only) [page 37].
Activities
Note
To 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.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 39
1.7.4 Ownership Manager (Standard only)
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 periodspecific 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.
● 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
Related Information
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
40 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
Ownership-based Hierarchy Requirements (Standard only) [page 44]
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 Consolidation
Ownership 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 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 maintain children for each group level by choosing a group and clicking the Add button to add
entities to or remove entities from the group.
● You can 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.
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.
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.
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
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 41
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.
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.
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:
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:
UK Equity 20 % 20 %
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
42 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
CHINA Proportionate 50 % 50 %
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:
Note
Methods are defined for each Group, at the level of the first immediate parent for each entity.
Note
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:
UK Divested 0% 0%
JAPAN Divested 0% 0%
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 43
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:
Related Information
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 (Standard only) [page 166].
Features
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
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
44 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
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.
Required dimension-types: Account (A), Category (C), Time (T), Entity (E), Group (G) and Reporting Currency
(R).
Note
You can also include the Intercompany (I) dimension in the ownership model in order to use the ownership
calculation feature.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 45
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:
Note
All required members, including POWN, POWNG, PCON,
Method, and PGROUP, are listed in the O_Account di
mension delivered with EnvironmentShell.
Caution
Renaming the Account dimension member in the owner
ship model could cause errors when executing the own
ership 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.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
46 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
Dimension Type Description
Intercompany (I) Must be the same Intercompany dimension used in the main
model.
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
● 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
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 47
Related Information
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 consolidations, since it communicates to the
consolidation engine on which entities to execute business rules. For more information about setting up your
consolidation environment with dimension properties, model settings, and journal definitions, see
Consolidation (Embedded only) [page 189].
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 (Embedded only) [page 72].
The scope context area displays the selected dimension members: Time (T-type), Category (C-type) and
Group (G-type).
Prerequisites
An administrator has assigned relevant authorization objects to you to manage Consolidation Monitor and
execute business rules. To perform control type tasks, you also need to be assigned relevant authorization
objects. For detailed information about how to assign the authorization objects, see the topic “Authorization for
Performing Consolidation Tasks” in the Security Guide.
Before running relevant business rule tasks, corresponding dimensions and attributes must be maintained by
your administrator. For detailed information, see Business Rules Management (Embedded only) [page 289].
Since Consolidation Monitor is the central place to trigger tasks defined by certain business rules on different
consolidation models, before you perform any tasks in Consolidation Monitor, your administrator is expected
to have defined business rule types for the consolidation model in Rules Business Rules and chosen the
tasks to be run on the model in Rules Task Sequences . For detailed information, refer to Business Rules
Management (Embedded only) [page 289] and Set Task Sequence (Embedded only) [page 206].
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
48 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
Features
Activities
Note
If you want to run currency translation on Entity 1, you first select the intersection cell of the Currency
Translation task type and Entity 1 and then click Execute on the tool bar.
Related Information
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 49
1.8.1.1 Run a Currency Translation (Embedded only)
You can convert amounts from their source currency to a target currency.
Available currencies are those specified in the Group dimension or group members. Currency translation can
be executed at any group/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 and convert amounts from their
source currency to a target currency. When you select a group or sub-group, the currency translation is run on
the currencies defined for the selected group.
You perform currency translations in the Consolidation Central module of SAP Business Planning and
Consolidation.
Prerequisites
You can perform currency translation on an entity if you have Write access to this entity.
Features
If you execute currency translation on an entity, a currency conversion dialogue boc appears with the following
dimension types and corresponding default members:
● C – Category
Default member: category member on the context bar.
● T – Time periods
Default member: time period on the context bar.
● E – Entity
Default member: the selected entity
● R – Currency
Default member: the first member in the currency dimension of the CONSOLIDATION InfoProvider.
● Currency Rate Entities
Default member: Global. If Global is not defined, then the first member of Entity in the RATE InfoProvider
displays.
You should be able to select multiple entities, currencies and time periods.
After defining all the members for these dimension types, click OK and execute a currency translation by
following the steps in Consolidation Monitor (Embedded only) [page 48].
If you execute currency translation on a group, then a currency conversion dialogue appears with the following
dimension types and corresponding default members:
● C – Category
Default member: category member on the context bar.
● T – Time periods
Default member: time period on the context bar.
● G – Group
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
50 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
Default member: the selected group
● Currency Rate Entities
Default member: Global. If Global is not defined, then the first member of Entity in the RATE InfoProvider
displays.
After defining all the members for these dimension types, click OK and execute a currency translation by
following the steps in Consolidation Monitor (Embedded only) [page 48].
Related Information
You run consolidations in the Consolidation Central module of SAP Business Planning and Consolidation.
Prerequisites
An administrator has assigned relevant authorization objects to you to manage a consolidation and execute
business rules in Consolidation Monitor. For detailed information about how to assign the authorization
objects, refer to the topic “Authorization for Performing Consolidation Tasks” in the Security Guide.
You can run a consolidation at a group level if you have Write access to the group.
Activities
If you execute carry forward on an entity, then a carry forward dialogue box appears with the following
dimension types and corresponding default members:
● C – Category
Default member: category member on the context bar
● T – Time periods
Default member: time period on the context bar
● E – Entity
Default member: the selected entity
● R – Currency
Default member: group currency on the context bar
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 51
You should be able to select multiple currencies. In this case, carry forward the selected entity with the selected
currency and local currency.
If you execute carry forward on a group, then a carry forward dialogue box appears with the following
dimension types and corresponding default members:
● C – Category
Default member: category member on the context bar
● T – Time periods
Default member: time period on the context bar
● G – Group
Default member: the selected group
You can change to other groups. In this case, carry forward entities belong to the new group with the group
currency and local currency.
After defining all the members for these dimension types, click OK and execute currency translation by
following the steps in Consolidation Monitor (Embedded only) [page 48].
If you execute account-based calculation on an entity, then an Account-Based Calculation dialogue box
appears with the following dimension types and corresponding default members:
● C – Category
Default member: category member on the context bar
● T – Time periods
Default member: time period on the context bar
● E – Entity
Default member: the selected entity
● R – Currency
Default member: group currency on the context bar
You should be able to select multiple entities and currencies. In this case, carry forward the selected entity with
the selected currency and local currency.
If you execute account-based calculation on a group, then an Account-Based Calculation dialogue box appears
with the following dimension types and corresponding default members:
● C – Category
Default member: category member on the context bar
● T – Time periods
Default member: time period on the context bar
● G – Group
Default member: the selected group
You can change to other groups. In this case, account calculation is performed on entities belonging to the
selected group and the selected group currency.
After defining all the members for these dimension types, click OK and execute currency translation by
following the steps in Consolidation Monitor (Embedded only) [page 48].
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
52 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
If you execute intercompany booking on an entity, then an Intercompany Booking dialogue box appears with
the following dimension types and corresponding default members:
● C – Category
Default member: category member on the context bar
● T – Time periods
Default member: time period on the context bar
● E – Entity
Default member: the selected entity
● R – Currency
Default member: group currency on the context bar
You should be able to select multiple entity members and currencies. In this case, intercompany booking is
performed on the selected dimension and selected currency.
If you execute intercompany booking on a group, then an Intercompany Booking dialogue box appears with the
following dimension types and corresponding default members:
● C – Category
Default member: category member on the context bar
● T – Time periods
Default member: time period on the context bar
● G – Group
Default member: the selected group
You can change to other groups. In this case, intercompany booking is performed on entities belonging to the
selected group and the selected group currency.
After defining all the members for these dimension types, click OK and execute currency translation by
following the steps in Consolidation Monitor (Embedded only) [page 48].
If you execute elimination and adjustment on an entity, then an Elimination and Adjustment dialogue box
appears with the following dimension types and corresponding default members:
● C – Category
Default member: category member on the context bar
● T – Time periods
Default member: time period on the context bar
● G – Group
Default member: the direct group of the selected entity
If you execute elimination and adjustment on a group, then an Elimination and Adjustment dialogue box
appears with the following dimension types and corresponding default members:
● C – Category
Default member: category member on the context bar
● T – Time periods
Default member: time period on the context bar
● G – Group
Default member: the selected group
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 53
You should be able to select multiple time periods and multiple group members.
After defining all the members for these dimension types, click OK and execute currency translation by
following the steps in Consolidation Monitor (Embedded only) [page 48].
Click on the intersection cell of the task type and the entity or group for which you want to change the work
status or run controls, and choose Execute. You can then change the work status to the desired work status or
run a control for an entity or for a group along with all entity members under that group.
For rules about changing work statuses and executing controls, refer to Work Status Setup [page 344] and
Create a Control [page 309].
Related Information
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.
Related Information
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
54 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
1.8.2 Controls Monitor (Embedded only)
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 (Embedded only) [page 72].
● 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 controls
In a Consolidation model, only the entities belonging to the Group selected in the scope context area 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 assigned relevant authorization objects to you to view and execute controls in Control
Monitor. For detailed information about how to assign the authorization objects, refer to the topic
“Authorization for Performing Consolidation Tasks” in the Security Guide.
Controls are enabled for the model in Planning and Consolidation Administration. If you choose Derive from
Work Status, you also need to make sure work status settings have been configured.
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.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 55
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.
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:
Example
For 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 309]; for more information
on control status, see Control Set Status (Embedded only) [page 58].
You can refresh the list of controls by clicking Refresh. For example, if 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.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
56 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
Activities
● To run controls for the selected entity or entities, see Execute a Control Set (Embedded only) [page 57].
● 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.
3. In the Controls Results page, if a control has one or more breakdown dimensions, expand the control by
clicking its arrow to display the data and status of each of the breakdown dimension members for that
control.
● 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
Prerequisites
An administrator has assigned relevant authorization objects to you to execute controls in Control Monitor. For
detailed information about how to assign the authorization objects, refer to the topic “Authorization for
Performing Consolidation Tasks” in the Security Guide.
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 314].
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 57
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.
Note
For 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.
Example
If 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
A control set has only one output - the control set status.
● Not applicable
No control set has been defined for the selected Category and Time dimension members.
● To be executed
Applies 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 and journal entries 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.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
58 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
○ 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
Note
When a control set status is reset to To Be Executed, calculated control data is not reset.
Every time calculations are executed, controls that 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.
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 the loaded
data (local currency), and for translated data or consolidated data on base entities:
● 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
The control status of a parent member or group depends on the control status of the child entities.
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.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 59
Example
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:
First assume that after executing each entity by the related Time and Category, the control status turns out
as below:
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:
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.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
60 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
Related Information
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.
● An administrator has assigned relevant authorization objects to you to manage journals. For detailed
information about how to assign the authorization objects, refer to the topic “Authorization for Performing
Consolidation Tasks” in the Security Guide.
Features
The following table describes the available journal tasks and explains how to perform each one. You perform
these tasks in Consolidation Central Journals .
Create a journal entry Click New in the toolbar of the Journals For more information, see Journal En
page. tries (Embedded only) [page 64].
Modify a journal entry Select a journal entry from the list in the You can modify saved and unposted
Journals page and click Open in the journal entries. For more information,
toolbar. In the Journal Entries tab, make see Journal Postings (Embedded only)
your changes to one or more journal en [page 67].
try rows, then click Save.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 61
Task Navigation What You Should Know
Copy one or more journal entries Select one or more journal entries in You can copy selected entries to an
the Journals page. To select non-contig other member of one of the header di
uous journal entries, hold down the mensions.
CTRL key as you make your selections.
Select Copy To from the toolbar, specify
whether to keep the same Time, Cate
gory, and Datasource dimension mem
bers and confirm.
Preview line item detail of a journal en Select a journal entry from the list on You can review detail lines of a journal
try the Journals page and select the entry for the entries to which you have
Preview option in the toolbar. The de View rights. For more information, see
tails on the journal entries appear below Journal Queries (Embedded only)
the list of journal entries. [page 69].
Open one or more journal entries Select a journal entry from the list on You open journal entries to view or edit
the Journals page and click Open in the them. For more information, see Jour
toolbar. You view the details of the jour nal Entries (Embedded only) [page
nal entries in the Journal Entries tab. 64].
You can open additional journal entries
and toggle between them using the
tabs that appear with each open journal
entry.
Post one or more journal entries Select one or more journal entries from When you post an entry, the system ap
the list on the Journals page and click plies the values in the journal entry to
Post in the toolbar. All the selected en the database, so that model data is ap
tries are posted. To select non-contigu pended. You can configure a journal en
ous journals, hold down the CTRL key try to be posted with multiple header di
as you make your selections. mensions or multiple values. For more
information, see Journal Postings (Em
bedded only) [page 67].
Unpost one or more journal entries Select one or more journal entries from The system reverses the original entry
the list on the Journals page and click to the model. For more information, see
Unpost in the toolbar. All the selected Journal Postings (Embedded only)
journal entries are unposted. To select [page 67].
non-contiguous journal entries, hold
down the CTRL key as you make your
selections.
Ungroup journal entries Select one of the journal entries in a For more information, see Journal
journal group and click Ungroup in the Groups (Embedded only) [page 68].
toolbar. All the journal entries in the
group are ungrouped.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
62 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
Task Navigation What You Should Know
Search for journal entries In the Filter by menu located in the tool If a large number of journal entries are
bar of the Journals page, choose written to a model, use the Advanced
Advanced Query. In the Advanced Query Query to define queries so you can
dialog box, define your query and click search for specific entries. The
OK. Advanced Query searches 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 (Em
bedded only) [page 69].
Lock and unlock journal entries Select a journal entry from the list in the When you lock a journal entry, you can
Journals page and click Lock in the tool not make changes to the line item de
bar. To unlock the journal entry, select it tails.
and click Unlock in the toolbar.
Reopen journal entries Select one or more journal entries from To reopen one or more single journal
the list on the Journals page and click entries to new single journal entries in a
Reopen in the toolbar. subsequent time period, see Reopen
Journal Entries (Embedded only) [page
70].
Require balanced journal entries Select the Enforce Balanced Journals A balanced journal entry is one in which
option in the journal model parameters. the debits equal the credits in the jour
nal entry. If this option is set, you can
not post the journal entry until it is bal
anced. For more information, see Jour
nal Model Parameters [page 356].
Print a journal report Select one or more journal entries from You can generate reports based on jour
the list on the Journals page and click nal entries. As long as you can view the
Report in the toolbar. To select non-con journal report, you can print the journal.
tiguous journals, hold down the CTRL For more information, see Print Journal
key as you make your selections. In the Reports (Embedded only) [page 71].
Journal Report tab that opens, click
Print.
Delete one or more entries Select one or more journal entries from When you delete an entry that has been
the list on the Journals page and click unposted, its status changes to
Delete in the toolbar. To select non-con Deleted. When you delete saved entries,
tiguous journals, hold down the CTRL they are deleted from the system. An
key as you make your selections. entry that has been posted cannot be
deleted until it is unposted. For more in
formation, see Journal Entries (Embed
ded only) [page 64].
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 63
Task Navigation What You Should Know
Define journal reopen rules In Planning and Consolidation Adminis Design a template of translation infor
tration, select Features Journal mation for the dimensions you want to
reopen. For more information, see Jour
Templates . Open a journal template
nal Reopen Rules [page 355].
and click the Reopen Rules tab.
You create and maintain journal entries using the journal entry template built by your administrator.
Features
Postings
You can post journal entries after they have been saved. For more information, see Journal Postings
(Embedded only) [page 67].
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 (Embedded only) [page 71].
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.
You can enter standard journal entries, which have one member defined for each header dimension and one
credit or debit value.
Activities
To create a journal entry, select Consolidation Journals , then click New in the toolbar. For more
information, see Journals (Embedded only) [page 61].
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
64 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
1.8.3.2 Journal Entry Form (Embedded only)
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:
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 click
ing the entry cell to display the Member Selector dialog box.
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.
Journal Entries tab Display in columns so that each row under the dimension
name is unique. Each unique combination of members rep
resents one detail line. You can enter the members associ
ated with the data values you want to change, and the debit
or credit amount. When you create multiple entries with mul
tiple values from a single header item, a set of debit and
credit columns displays for each additional member speci
fied.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 65
Form fields Description
Multi Posting tab The journal entry is posted to the database under each di
mension member defined for Multiple Headers and Multiple
Values. This tab is grayed out until one of the aforemen
tioned options is selected.
Note
This option sets up a new journal; it does not create
postings.
Related Information
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
66 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
1.8.3.3 Journal Postings (Embedded only)
You post journal entries to enter the details of a transaction into the database.
Prerequisites
An administrator has assigned relevant authorization objects to you to post journals. For detailed information
about how to assign the authorization objects, refer to the topic “Authorization for Performing Consolidation
Tasks” in the Security Guide.
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.
You can repost journal entries that you accidentally delete. Only journal entries that have previously been
posted can be reposted.
You can unpost one or more journal entries to make changes to them.
You can configure a journal entry to be posted to the cube 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.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 67
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 mode
1. 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:
Note
The Multi Posting tab is greyed out until you select one of the above options.
○ 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
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 (Embedded only) [page 65].
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
68 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
Features
● Group ID
All 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 Status
All 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
Related Information
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:
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 69
● Review the line item detail on posted or saved entries
● Post the saved entries or unpost the posted entries
● Delete the unposted entries
Activities
Note
The query settings are saved until you deselect Advanced Query in the Filter by menu.
Related Information
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 355].
The system is set to allow for reopening of journals using the Allow Journals to be Reopened journal parameter.
See Journal Model Parameters [page 356].
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
70 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
Features
You can reopen one or more journal entries to new journal entries.
Activities
In the next period, all the journals in the selected member range will be reopened to the target member range.
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 (Embedded only) [page 69].
Activities
Note
To select non-contiguous journals, hold down the CTRL key as you make your selections.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 71
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.
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 periodspecific 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.
● 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
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
72 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
Related Information
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 Consolidation
Ownership 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 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 maintain children for each group level by choosing a group and clicking the Add button to add
entities to or remove entities from the group. Currently you cannot choose external entity members to add
to 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.
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.
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.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 73
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.
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.
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:
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:
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
74 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
UK Equity 20% 20%
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:
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:
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:
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 75
USA Full 100% 100%
Related Information
Use
This function allows you to prepare reports that contain system information and a history of administration and
business user activities.
Features
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
76 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
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:
More Information
Use
You can generate reports on Business Process Flows (BPFs). Reports can be viewed online and printed.
Features
● Instance
● Activity
● Operation (standard only)
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.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 77
1.9.2 Reporting on Data Changes
Use
Business Planning and Consolidation in a standard configuration 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.
Business Planning and Consolidation in an embedded configuration records audit information on who changed
transactional data in the InfoProvider.
Features
The report shows who changed the data, what time they made the change, how they made the change (for
example, through the EPM add-in for Microsoft Office), and the details of the record that was changed.
You can choose from the following criteria to fine tune your report:
Option Description
InfoProvider (embedded only) Select an InfoProvider that has data change audit enabled.
Dimension Members Select the dimension and dimension members the audit in
formation 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).
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
78 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
Option Description
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.
In the report, the columns correspond to the parameters in the above table. In Business Planning and
Consolidation in a standard configuration there is an additional Value column. The Value field shows you what
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 79
the value was changed to, as a result of the change. That is, it shows you the new value (not the original nor the
delta value posted to the database).
More Information
Use
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. In
Business Planning and Consolidation in a standard configuration, you can also control input methods (for
example, to prevent the Data Manager being used to update data).
In Business Planning and Consolidation in a standard configuration, you can filter the report to the specific
region of the cube for which you want the work state.
In Business Planning and Consolidation in an embedded configuration, you can filter the report to the specific
region of the model 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.
Option Description
Dimension Members Select dimensions and dimension members that the work
status is stored against.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
80 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
Option Description
Date and Time You can choose start and end dates for the report. In Busi
ness Planning and Consolidation in a standard configuration,
you can also display the full history of the selected work sta
tus information (Anytime).
Additional Criteria User ID - Enter the User ID for which you need the work sta
tus 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
Use
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
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 81
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
○ 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 com
ments 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.
More Information
Use
The administration activity audit records information on tasks performed in the system, for example, who is
creating, changing, deleting models, dimensions, and security.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
82 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
This report applies to the environment or model level.
Features
Option Description
Date and Time You can choose start and end dates for the report or display the full history of the se
lected activities ( Anytime).
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 83
Option Description
● Task Name
You 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
Note
The 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
●
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
84 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
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:
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.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 85
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.
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.
More Information
Use
The purpose of the security audit reports is to show a summary of the users, teams, and profiles that exist for a
particular environment. It does 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
● Users
This report allows you to see in a grid, the users assigned to the environment, and the teams and profiles to
which they are assigned.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
86 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
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 Profiles
This 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 Profiles
This 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.
Note
In 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 SAP Business Planning and Consolidation Security Guide available on the SAP Help Portal.
You can use this function to create reports and input forms.
In Business Planning and Consolidation in an embedded configuration reports and input forms are based on
BW queries that are created with the BEx Query Designer. You can also use default queries that are available for
all InfoProviders. These queries have special names, starting with "!". There are also special default queries
that exist on aggregation levels. These queries start with "!!I" and can be used as the basis for input forms.
Procedure
To create a new report or input form, go to Library and choose New: Report or New: Input Form
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 87
1. In the Define Data Grid dialog, choose the dimensions that you want to include by dragging them to the
required area - Rows or Columns.
2. To select the members that you want to include in the report, click the name of the required dimension.
The member selector appears.
3. Select the checkbox for each member that you want to include in the report or click to include all
children, descendants, and base members of a parent member into the selection. Then choose OK.
4. Choose Save to save the report.
Additional Functions
You can export a web report or an input form to a comma-separated values (CSV) file. After that you can open
the file with MS Excel, do data analysis, format the report, print it with Excel, or copy the changed data back
from Excel to a web input form.
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 this option is selected, all rows are shown.
● Suppress Empty Rows - When this option is selected, the empty rows are not shown. The rows that have
values in them are shown, even if they are zero values.
● Suppress Empty and Zero Rows - When this option is selected, all empty and zero rows are hidden.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
88 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
More Information
Use
When creating a report, there are several components you can add to it. Some are required, such as
dimensions and members, and some are optional, such as charts.
Features
The following table lists the components that you can add to a report and how you can manipulate these
components:
Component Actions
Drag the dimension to the Row Axis area or the Column Axis area. In Business Planning and Consolida
tion in an embedded configuration, you can also drag them to the Page Axis area.
You can nest dimensions by placing additional dimensions on the column or row.
You can remove dimensions from a column or row by clicking the x next to that dimension.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 89
Component Actions
Select a dimension in the Column Axis, Row Axis or Page Axis (embedded only) area and click Select
Members to select the members to use for that dimension. The member selector is displayed. Here you
define the set of members to display for the selected dimension.
Standard Only
● Single Member - You can select a single member of the current context or a fixed member.
● Fixed List - You can select a fixed list of members.
● Select Children - You can select the children of the current context or a fixed member.
● Select Children and me - You can select both the children and the parent member.
● Select Descendants - You can select all descendants of the current context or a fixed member. In the
window that appears, select the levels to include using the Number of Levels Down and Do not
include intermediate levels options.
● Select Descendants and me - You can select both the descendants and the parent member. In the
window that appears, select the levels to include using the Number of Levels Down and Do not
include intermediate levels options.
● Select Base Members - You can select the base members of the current context or a fixed member.
● Select Base Members and me - You can select 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 single member from the
selected member list.
● Exclude descendants and me - If you exclude a parent member, you exclude that parent member
and all descendants of it.
If you do not specify any members, the current context is always used.
Embedded Only
If you do not specify any members, all members defined in the query for the dimension will be used.
Work Status You can set the work status on data that you enter and save.
(standard only)
See Work Status [page 94].
Comments You can add comments to any selected cell. You can also enter a comment for a specific context, in
(standard only) 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.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
90 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
Activities
You can cut, copy, or paste data both from and to Excel. You can also export a complete report to Excel.
You can format reports to determine their appearance. The formatting options include the following:
You can save data. For more information, see Additional Functions for Input Forms [page 101].
1.10.2 Charts
Use
You can create a chart from a report or input form. You can also add a chart to a report or input form so it
displays on the same page. When you change the report in any way, the associated chart is updated.
Features
● You can display the chart together with the report or only the chart alone.
You can select the following options for displaying charts and reports:
○ Show Report Only
○ Show Chart Only
○ Show Report and Chart
You can remove a chart from a report by choosing the display option Show Report Only.
● You can specify how the chart is displayed. In the Chart Options pane on the right side, you can select
options as follows:
○ 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 group and series axis labels.
● In addition, you can apply filter for the dimensions that are not in the group and series axis.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 91
More Information
The member selector provides a dialog box in which you can select or exclude members that belong to the
same 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 in the report or input form.
Function Navigation
Selecting one or more dimension members Select the checkbox next to the specific dimension mem
bers.
Displaying dimension members in a hierarchy or list format In a Standard configuration, in a dimension member list,
choose Display and select either Hierarchy or List.
Choosing a key date or version for time-dependent and ver For a dimension with a time-dependent or version-depend
sion-dependent hierarchy (embedded only) ent hierarchy, if no key date or version is predefined during
query design, you can specify a key date and version within
the member selector to display corresponding members.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
92 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
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.
1.10.4 Disaggregation
In Business Planning and Consolidation in a standard configuration, you can use this functionality to
disaggregate target values to the 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.
Example
You enter a sales target for the EMEA region and then use the disaggregation function to disaggregate that
value to the base levels.
● Self-reference distribution - data will be disaggregated according to the ratio of the existing base level
values.
● Base level equally distribution - data will be disaggregated to all base levels evenly.
● Reference-based - data will be 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 refer to.
In Business Planning and Consolidation in an embedded configuration, you can use this functionality to
distribute a value to the granularity of the aggregation level.
To use disaggregation you must set it in the BEx queries that you use for your reports and input forms. For
more information, see the SAP BW documentation available at http://help.sap.com/nw74.
After enabling disaggregation in the BEx queries, you can still change the type of disaggregation in reporting by
following these steps:
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 93
1.10.5 Work Status
Use
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 form.
Prerequisites
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 will 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, in a Business Planning and Consolidation embedded configuration
the current state will show the text description of the work state. In a standard configuration, the current
state will show 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.
Activities
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
94 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
More Information
Use
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
Adding Comments
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.
Note
Administrators 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.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 95
Item Description
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 Se
lector [page 92]. 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 ad
ministrator 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
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.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
96 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
Note
An administrator can delete or remove comments with conditions through the ClearComment package in
Data Manager. For more information, see SAP BusinessObjects EPM solutions, add-in for Microsoft Office
help.
Activities
To work with comments in a report, open the report and select Comments. Choose one of the options as
described above.
More Information
Comments provide a vehicle for submitting, storing, and retrieving text commentary associated with report
data cells.
By leveraging the feature of short texts in a BW query, you can submit, store, and retrieve text commentary in.
For detailed information, refer to the BW manual on the SAP Help Portal available at http://help.sap.com/
nwbw. Go to SAP Business Warehouse 7.4, powered by SAP HANA, open the SAP BW Documentation in the
application help section, then navigate to Data Modeling When Using a SAP HANA Modelling with the BW
Modeling Tools in Eclipse Tasks Defining Queries More Information Editing Short Texts in Queries .
Generally speaking, you can follow the steps below to enable short comments:
After proper adjustments have been made for modeling and querying, you can add, edit, and delete short
comments in the queries.
Comments are editable in input forms, but read-only in web reports. The maximum comment length of each
cell is 250 characters.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 97
You can also define disaggregation rules inside a query for comments. Two disaggregation options are
available:
Use
You can use this function to filter the content displayed in a workspace or report. It allows you to focus on a
specific subset of the data.
Since a workspace can contain one or many views, the data selected on each level has a scope. The value
selected on a lower level object overrides the value of the same data type selected on a higher level.
When the workspace is saved, the context data associated with the workspace is also saved.
Integration
Prerequisites
Features
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
98 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
When you add the same dimension at view level, but select a different dimension member, the dimension
member on the view (lower level) overrides the dimension member on the workspace (higher level). All
other views inside the workspace continue to take the workspace-level dimension member.
In a view, the inherited dimensions always appear first in the context bar. Any new dimensions you add at
view level appear after these.
● 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 100].
Example
Example 1
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.
Example 2
1. You add a dimension, Region at workspace level and select member, Europe. All views within that
workspace display data for Region: Europe.
2. If you add the Region dimension to a view inside the workspace and select member, Asia, the view displays
data for Region: Asia.
All other views in the workspace continue to display data for Region: Europe.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 99
1.10.8.1 Managing Context (Standard only)
Procedure
To manage the context in a report or workspace, you can perform the following tasks:
Select a different dimension member Select the dimension member hyper (None)
link.
Add all dimensions to the context bar In the Add Dimension dropdown list, (None)
choose Add All Dimensions.
Display dimension names next to di In the Manage Context dropdown To display only the dimension member
mension members in the context bar menu, choose Display Dimension descriptions, choose Hide All.
Names Display All . You can also select the default display
by choosing Use Default Settings.
When designing a report or an input form, you can select dimensions for the page axis. Later you can select
specific members of these dimensions and display their aggregated values in the report/input form.
By default all members of the dimensions in the page axis are displayed. To select specific members, follow the
steps below:
1. Choose a dimension from the page axis that appears at the top of the report. The page axis member
selector appears.
2. Select the checkboxes of the members whose data you want to include in the report.
3. Choose OK.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
100 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
1.10.10 Planning Sessions and Locking Cells in Input Forms
(Embedded only)
Planning Session
A planning session buffers the data before sending it to the database. You can make changes to the data in the
input form and all these changes are buffered in the planning session. When you finish the editing, you can
submit the data to the database.
Also, when you change the work status the change is stored in the planning session and it is sent to the
database together with the planning data when you submit it.
Locking Cells
This function allows you to lock cells in the input form so their values cannot be changed. You might want to
lock cells in order to protect them when modifying other cells - by changing operands in formulas and changing
other data values - to see the effect of your modifications on the data in the report.
If you want to make these cells editable again, you can unlock them.
The locks persist during various operations. For example, if you remove a dimension that has a locked cell the
lock remains, although the cell is not visible any more. If you decide to add the dimension again, the lock is still
in place.
To lock or unlock a cell, select it and either choose Lock Cells or Unlock Cells in the ribbon or right-click and
choose Lock Cells or Unlock Cells.
A dashboard is a grouping of, or a display of, reports and input forms that allows you to have a comprehensive
overview of critical information.
In a dashboard, you can include content from the Library or create new reports or input forms. Reports and
input forms that you create are part of the dashboard and are not available outside the dashboard until you
save them as separate entities to the Library.
Prerequisites
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 101
Users can always open and view any dashboard.
To create or edit a dashboard, users need to be assigned the Edit Dashboard task profile. Meanwhile, if they
have the Edit Content of Public Folder task profile assigned to them, they can delete dashboards in
the Library.
To perform more tasks in a dashboard such as creating and saving reports, other task profiles need to be
assigned to the users:
● Edit Report
Allows users to open, create, and edit web reports.
● Use Input Forms and Save Data
Allow users to create, edit, and modify input forms and control data submissions from web reports.
Features
In total, up to six reports or input forms can be added to the dashboard. The added content is defined as tiles of
the dashboard. You can move, resize, and maximize the tiles freely. By choosing the Edit button of each tile, you
can hide either the menu bar or the scope context bar of the tile. All the report and input form tiles added to the
dashboard share the same functions with common reports and input forms, such as comments, drill-through,
changing work status, and displaying by report or chart.
Every dashboard 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 input form tiles sharing the same model in this dashboard. However, if you choose a different member
for a dimension in the context bar of a certain report tile or input form tile, this change overwrites the default
value inherited from the global context.
Related Information
Prerequisites
To create or edit a dashboard, users need to be assigned the Edit Dashboard task profile.
To perform more tasks in a dashboard such as creating and saving reports, other task profiles also need to be
assigned to the users:
● Edit Report
Allows users to open, create, and edit web reports.
● Use Input Forms and Save Data
Allow users to create, edit, and modify input forms and control data submissions from web reports.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
102 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
Procedure
Related Information
Context
Deleting a report or input form tile in a dashboard does not delete the corresponding report or input form you
have saved to the Library
Procedure
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 103
Related Information
Prerequisites
To edit a dashboard, users need to be assigned the Edit Dashboard task profile.
If users have the Edit Content of Public Folder task profile assigned to them, they can delete
dashboards in the Library.
Procedure
1. Go to the Library page and click the name of the dashboard to make modifications.
2. Select a dashboard and choose the Delete button to delete it.
Related Information
Use
A workspace is a grouping of specific content. It behaves like a folder, which contains Business Planning and
Consolidation items, such as reports, input forms, Crystal Dashboards, and so on.
In a workspace, you can include content from the Library or create new reports or input forms. Content that
you include is available both in the workspace and in the Library. Reports or input forms that you create are
part of the workspace and are not available outside the workspace.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
104 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
Procedure
Creating a Workspace
1. To create a new workspace, in the home page go to Library and from the New: toolbar choose Workspace.
2. To add a global context to the workspace, click the plus sign to specify the dimensions and members. See
Context [page 98].
3. To start adding content to the workspace, click Add Content.
You can choose from the list of items (for example, reports or Crystal Dashboards) available in the Library
view. Select an item, then click OK.
4. To add a new report, click Add New Report and then create the report. For more details, see Creating
Reports.
5. To save the workspace, click Save.
You can save the workspace to any one of the folders in the Library. Give it a name and description, then
click OK.
This opens the workspace as a new tab at the workspace navigation level.
Additional Actions
To perform tasks on an item within a workspace, click the context menu icon next to the item and select from
the following options:
● Set as default - To set this item to be displayed when the workspace is opened.
● Delete - To delete the item.
● Rename - To rename the item.
Use
You can upload a template allowing you to visualize report data and analyze data with dimension mapping.
Prerequisites
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 105
Note
Use caution when uploading an SWF file and be aware of the potential risks to your BPC system from
uploading malicious code in such a file. SAP is not responsible for damage caused by the upload of SWF
files containing suspicious code.
Procedure
Uploading a Template
Note
If you are using SAP Business Planning and Consolidation, you can upload templates in the Library by
choosing BI Dashboard in the New: toolbar.
2. In the Upload dialog box, browse for the relevant SWF file. If available, browse for the XLF file of the
template.
The preview of the template is shown in the dialog box that appears, along with the template details and
connections.
3. Provide a name for the template.
4. In the dropdown menu, select the appropriate template type.
The possible options in the Type dropdown menu include Template (for generic templates) and Chart (for
specifically created chart templates following a set of naming conventions).
5. Select a Variable Format option. This field is only relevant if the template has a FlashVars connection.
If the XLF file has been uploaded, the Variable Format field is grayed out; XML is automatically selected.
6. Edit the connection details.
○ The variables were specified when the template was created. You can map these variables, which
represent the dimensions of the template, to a particular grid's dimensions for analysis.
○ By default, the data type of all the variables is String. You can change this to Number if required.
○ Optional: Provide a description for each of the variables.
Note
If the XLF file has been uploaded, any available Flash variables, which were specified when creating the
template, are automatically included in the list. If the XLF file is not uploaded, you can add the Flash
variables manually by choosing Add Variable.
Modifying a Template
1. In the Template Administration panel, hover the mouse pointer over the template that you want to modify.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
106 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
Note
If you are using SAP Business Planning and Consolidation, you can modify templates in the Library by
choosing BI Dashboard and selecting the relevant template.
2. Choose a display option: Open in New Tab, Add to New View, or Add to Active View.
3. Rename: Change the name of the template.
4. Edit Details: This allows you to edit the template properties, for example. name and connection details.
5. Download XLF: This option is only available if the template has an associated XLF file. This allows you to
download the XLF file to your local system, and edit it.
You can subsequently upload the updated SWF and XLF files.
6. Delete: You can delete the template from the repository.
Additional Options
1.14 Administration
Use
Features
Set up 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
● Management of data calculations for member formulas, logic scripts, business rules, and controls (all in
standard only)
● Management of controls
● Set up of business process flows
● Set up of work statuses
● Set up of journals (standard only)
● Set up of context defaults (standard only)
● Configuration of drill-through (standard only)
● Management of document types and subtypes (standard only)
● Set up of auditing
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 107
Related Information
Use
In Business Planning and Consolidation in a standard configuration, an environment consists of one or more
models. An environment stores all the data from each model. 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
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
108 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
The environment status determines when and how users can log on and interact with the data. See
Environment Status [page 114].
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.
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.
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 more details, see the SAP Business Planning
and Consolidation 10.1 IMG Guide.
Deleting Environments
You can delete environments after choosing Manage All Environments and selecting an environment.
Caution
In Business Planning and Consolidation in a standard configuration you 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.
Caution
In Business Planning and Consolidation in an embedded configuration when you delete an environment,
you will delete all objects under this environment:
● Models
● BPF templates and instances
● Work status settings and data
● Web reports and input forms
● EPM add-in reports and input forms
However, all BW modeling and settings done in the BW back-end transactions will still be available.
● An environment is equivalent to an InfoArea within NetWeaver 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 at http://help.sap.com/
bopacnw101.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 109
More Information
Use
In Business Planning and Consolidation in a standard configuration you create new environments by
copying the EnvironmentShell sample environment or an existing environment.
In Business Planning and Consolidation in an embedded configuration you create new environments from
scratch in the Manage All Environments dialog.
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, documents, journals, and
Library view data. You have the option to not copy database records, documents, 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
1. Choose the name of the current environment in the lower right part of the screen.
2. In the dialog that appears, choose Manage All Environments.
In Business Planning and Consolidation in a standard configuration 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.
In Business Planning and Consolidation in an embedded configuration to add a new environment, choose
the Create button. When you create the environment, you assign a name and description to it. The type of the
environment is preselected to Embedded. You cannot change it.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
110 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
More Information
Use
You can use the EnvironmentShell sample environment to create your own environments.
Because it is a shell, it 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.
Caution
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.
○ 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
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 111
● 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 Models
Dimension De
Type ID Dimension ID scription 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
I INTERCO Intercompany X X X
Partner
Di
men
sions Models
G SCOPE Scope X X
S FLOW Flow X
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
112 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
Di
men
sions Models
U PRODUCT Product X
Di
men
sions Models
Di
men
sions Models
More Information
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 113
1.14.1.3 Environment Status (Standard only)
Use
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. When an environment is
offline, users may be restricted from performing data retrieval and export tasks.
Features
When users attempt to log on to an environment that is offline, the system displays a warning and may open
the environment to work offline on parked or locked documents. Users can also query the model information,
but the data may not be completely up-to-date.
Activities
You can manually set the status of an environment by choosing Manage All Environments 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
A dimension is a collection of related data members, which represents one aspect of a business; for example,
accounts, products, or entities. When you manage dimensions, you perform various tasks such as maintaining
the members of the dimensions, create their structure, and process the dimensions.
To view more information on managing dimensions, choose the configuration type of your Business Planning
and Consolidation installation:
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
114 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
1.14.2.1 Dimension Management (Standard only)
Use
A dimension is a collection of related data members, which represents one aspect of a business; for example,
accounts, products, or currency. You manage dimensions to add and perform other operations on dimensions
within your environments, such as defining members and assigning properties. The dimensions can be added
to one or more models in the environment.
Features
Adding Dimensions You can add new dimensions to an environment to make them available for use in its models.
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.
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.
Processing Dimensions When you create a dimension or make changes to an existing dimension, you need to process
the dimension.
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.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 115
More Information
Use
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.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
116 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
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:
Type The dimension type allows you to organize data within models based on the type of
information included.
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 In
tegrity property (see Dimension Processing [page 120]). Validation does not com
plete if they do not pass validation.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 117
Dimension Type ID - De Reference Type ID - De
scription scription Property ID Reference Property ID
Activities
You can create a new dimension in the Administration screen by choosing Dimensions New Dimension
under the Dimensions and Models section, and then entering the required data.
Use
You use dimension types to organize data within models based on the type of information involved. 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:
A Account Usually contains chart of accounts and other planning assumption measures. The di
mension is normally represented by a hierarchy of accounts.
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 Fore
cast. 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 busi
ness 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 geo
graphic entity, and so on. This represents the organization unit, whether defined for
legal purpose or from a business angle. This could be cost center, profit center, legal
company or region. The dimension is normally represented by hierarchy of entities.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
118 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
Type ID Type Description More Information
G Group Reports consolidated results in multiple group currencies within a single entity struc
ture. Group provides multiple currencies for a group member.
Note
Assign 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 can
not 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; how
ever, 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 150].
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, De
letions, 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 Userdefined This represents any Userdefined dimension that may be required for the planning
process. Referred to in the system as U1, U2, U3, and so on.
More Information
Use
Security of dimensions is at the model level. You secure a dimension within a model. Dimension security
controls access to dimensions and their members.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 119
Features
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 Member Access Profile Setup in the Security Guide for SAP Business Planning and
Consolidation.
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.
Use
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 SAP BusinessObjects EPM
solutions, add-in for Microsoft Office help.
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.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
120 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
1.14.2.1.5 Dimension Member Management (Standard only)
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.
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. For dimensions that were migrated from Business Planning and Consolidation version 7.5, the
previous limit of 20 characters remains for member names.
Note
If 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 SAP BusinessObjects EPM solutions, add-in for Microsoft Office help.
Caution
Use
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.
Note
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.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 121
Activities
More Information
Use
You use the UJA_MAINTAIN_MEASURE_FORMULA program to create and maintain custom measure formulas.
Note
Changes 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.
● 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.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
122 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
● 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 (cube). 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.
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.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 123
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
Use
By 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.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
124 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
Features
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 fol
lowing:
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 125
Task More Information
Adding properties to dimensions in Consolida When you add a property to a dimension in a consolidation, owner
tion,Ownership, and Rates models ship, or rates model, you have the option to add the set of prede
fined 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 consoli
dation, ownership, or rates models, if there is already a property
with the same ID as one of the required properties, the system han
dles this as follows:
Modifying dimension properties You can modify a property which is not a system-generated prop
erty. 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 dimen
sion 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 dimen
sion.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
126 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
Task More Information
Removing dimension properties You can remove properties from a dimension by selecting a dimen
sion 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 When a user is filling a journal template, all base-level members
to users 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 jour
nal entries. Do this for each dimension you want to limit, then proc
ess 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 set
tings.
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 EPM add-in.
HIR Stores the hierarchy IDs associated with the member, for example H1;H2.
Special Properties
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 127
The following are reserved IDs that you cannot enter as a property ID when adding a new userdefined
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, cus
tom rollups, and calculated cells. The system evaluates the member with the highest solve or
der first, and calculates it last. Zero is the highest priority.
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 mem
ber formulas. For information about implementing formulas, see Member Formulas [page
209].
More Information
Use
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
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
128 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
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
● 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.
Use
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.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 129
Features
● 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.
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 124].
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
Use
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.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
130 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
Features
ACCTYPE Account type. Can be INC for Income, EXP for Expense, AST for Asset, LEQ for Liabilities and
Equity.
SCALING Scaling options are Y or N. Used by EvDRE, 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.
The following property is required only if the account dimension is used in an ownership model.
More Information
Use
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.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 131
Features
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 SAP
BusinessObjects EPM solutions, add-in for Microsoft Office help.
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 simula
tion 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 simu
lation 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 sim
ulation 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
RATE_PERIOD Period number of source exchange rate data to use when running currency transla
tion 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 transla
tion on a simulation category. This is relative (for example, -1 for prior year).
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
132 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
More Information
Use
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.
Features
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.
The following property is required only if the currency dimension is used in a rate model.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 133
More Information
Use
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.
Features
CTRL_CURRENCY_NOT_LC Specifies the Reporting Currency dimension member against which a data con
trol is performed. A control is an individual check for data accuracy and consis
tency. Controls are enabled or disabled at the model level.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
134 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
Property Name Description
CONTROL_LEVEL Specifies the controls that are relevant to an entity when a control set (a group of
controls) is executed.
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.
More Information
Use
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.
Note
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
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 135
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.
● 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 prop
erty 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 -
Blank - If you do not want to store the ID entered in the Entity property.
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
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
136 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
1.14.2.1.8.8 Intercompany Dimension Properties (Standard
only)
Use
The Intercompany dimension defines the base members associated with the level at which Intercompany
balances are tracked for Intercompany eliminations.
Features
More Information
Use
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.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 137
Features
BASE_PERIOD A system-generated property, used by the query engine for calculations and by the Consoli
dation process.
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.
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 correctly.
The following property is required only if the time dimension is used in a consolidation model:
TIMEID Numeric ID to used for identifying the time member, for ex
ample, 20120100 for 2012.JAN.
For detailed information about maintaining these properties, refer to the note 2114433 .
More Information
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
138 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
1.14.2.1.8.10 User-Defined Dimension Properties (Standard
only)
Use
A userdefined dimension is any dimension that is not one of the standard system dimensions.
Features
SCALING Scaling options are Y or N. Used by EvDRE, 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
Use
The audit dimension is userdefined and tracks the source of input data.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 139
Features
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).
COPYOPENING Flag used to filter data sources when running carry forward
(CopyOpening).
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
140 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
More Information
Use
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.
Features
● 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
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 141
Property Name Description
More Information
Use
A dimension is a collection of related data members that represent one aspect of a business, for example,
accounts, products, or entities.
Features
Displaying Dimension You can modify an existing dimension. When you modify a dimension, you can change the
Structures name, description, dimension type, reference dimension, and dimension properties as well as
enable member formulas for the dimension.
Maintaining Dimension You can maintain a dimension member, add a new member, delete an existing member, or
Members change property values for an existing member.
Processing Dimensions When you create a dimension or make changes to an existing dimension, you need to process
the dimension.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
142 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
Task More Information
Maintaining Hierarchies You can add a new hierarchy, maintain an existing hierarchy structure, or delete an existing
hierarchy.
Maintaining Dimension Se You can manage dimension member security at the dimension level using Business Ware
curity house and a Business Planning and Consolidation data access profile.
Creating Local Dimensions You can create local dimensions based on existing central dimensions, as well as remove un
necessary properties and add new properties during the creation process. Local dimensions
can also be deleted when they are no longer useful.
See Creating Local Dimensions (Embedded only) [page 148] and Deleting Local Dimensions
(Embedded only) [page 150].
Activities
To manage dimensions, go to the Administration screen and under Modeling choose Dimensions. Once you
select a dimension, you can perform one of the available tasks.
Security
For information about the authorizations needed to maintain master data for dimensions, see the Security
Guide, which is available on the SAP Help Portal at http://help.sap.com/bopacnw101.
Related Information
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 143
1.14.2.2.1 Dimension Structure (Embedded only)
Use
You can view the structure of a dimension used in an InfoProvider that has been assigned to a model within an
environment. You can see the dimension description and the dimension properties that have been assigned.
Activities
You can display the structure of a dimension on the Administration screen by choosing Dimensions, selecting a
dimension, then choosing View Structure.
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 and Category dimensions.
A dimension contains a set of predefined properties based on its type. You can add new properties by using BW
modeling tools.
You can add, delete, and modify members in dimensions within an environment in the Administration screen.
Under the Modeling section, choose Dimensions , select a dimension, and then choose Edit Members.
You can maintain the time-dependent property and text when time dependency is activated in the BW backend,
as follows:
● A time-dependent property and text are identified with a clock icon in their column header.
● When there is at least one time-dependent property or text, a key date field appears in the menu of the
maintenance screen. The current calendar date is used as the default date when member maintenance
initially loads. You can choose a different key date to toggle a different property value or text across time.
● By default, a changed value for a time-dependent property and text updates to the current time range (in
which the key date lies) when saving.
● By selecting the checkbox in the column From <key date>, a changed value for a time-dependent property
and text is applied to a new time range starting from the selected key date
Compounding Dimensions
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
144 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
You can maintain the member of a compounding dimension after it has been activated in the BW backend.
When you add a new member for a compounding dimension, you can select an existing member for superior
dimensions from the value's help.
You can maintain the member of a dimension property when the property itself has master data. To maintain a
member for the dimension, view the dimension structure and click directly in the property ID.
Caution
● You can add a new member that does not exist in a global dimension and maintain its properties.
● You can overwrite property values for members inherited from a global dimension.
● You cannot delete members inherited from a global dimension.
● Time-dependent property and text compounding are not supported.
Use
Whenever you add a new dimension member, modify an existing dimension member, or delete a dimension
member, you must process the dimension.
Activities
You can process dimensions in the Administration screen. In the Modeling section, choose Dimensions ,
select one or more dimensions, then choose Process.
You can also process dimensions when you maintain a dimension member by choosing Save and Process.
You manage dimension hierarchies by adding new hierarchies, deleting existing hierarchies, and maintaining
the hierarchy structure for a particular dimension.
You manage dimension hierarchies based on your business needs. For example, if your company opens a new
office, the hierarchy of your Entity dimension should be updated to include this new office.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 145
Features
A dimension can be defined to have a hierarchy or not. To enable a hierarchy for your dimension, use BW
modeling tools. A hierarchy you maintain in the Business Planning and Consolidation HTML5 web client can
also be verified and maintained in BW modeling tools.
You can add a new hierarchy to a dimension within an environment in the Administration screen. In the
Modeling section, select Dimensions, choose a dimension, select Edit Hierarchy, then select Add.
By selecting a hierarchy name in the hierarchy list, you can maintain the hierarchy structure.
You can add new nodes to a hierarchy by selecting a parent node and selecting Add, then choosing dimension
members from either the current dimension or external dimensions.
You can add text nodes or internal nodes, and you can sort and filter by member ID or property by selecting
each column header of the grid.
Note
The External Dimension option is by default not displayed in this page if you did not choose an external
dimension for the current hierarchy. To define external dimensions, enter Business Warehouse (BW)
transaction RSA1, choose InfoObjects in Modeling, and enter the Hierarchy page of the current dimension.
Then you can add external dimensions in the External Characteristics of Hierarchy view.
Time and version dependent hierarchies are supported in the Business Planning and Consolidation Web client.
To define a time and version dependent hierarchy, use Business Warehouse (BW) transaction RSA1 and go to
the Hierarchy tab of the related InfoObject to make the corresponding settings. After that, you can define
hierarchies of different versions based on a different date range, as well as hierarchies in a different time range
based on different versions in the hierarchy view of the dimension. The detailed settings are as follows:
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
146 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
The time range of each hierarchy node displays for the node ID/Description when you move your mouse
over the node. All newly added nodes have the default time range 1000.01.01-1999.12.31. To edit the
time range, choose the pen icon.
● Version-dependent Hierarchy
All existing versions display at the top of the right pane. You can select different versions to toggle.
To create a new version, select Create hierarchy version from the version drop-down.
You can use local hierarchies by either creating them from scratch or by making a local copy of a hierarchy that
has had its master data loaded into the system. To make a local copy after selecting a dimension and viewing
its global hierarchies, choose a hierarchy and select Copy. Since local hierarchy does not support time or
version dependent hierarchies, you need to enter a key date for time-dependent hierarchies or specify a time
range if the entire hierarchy is time-dependent, which is the date on which or the date range during which you
want to take a snapshot of the hierarchy to add locally. If the global hierarchy from which you copy a local
hierarchy is version-dependent as well, you also need to select a version.. Then you can assign a new ID and
description if desired and make other changes in the local hierarchy by adding, deleting, or moving items in it, if
necessary. Note that you can have only internal nodes and text nodes in local hierarchies. External nodes are
automatically converted to text nodes when the hierarchy is copied from global to local. After that, you can
save and process your changes.
To enable the reverse sign for nodes, use Business Warehouse (BW) transaction RSD1. Reversed
displays for each node ID/Description when you move your mouse over the node. To change the sign, choose
the pen icon.
Processing Required
You must process all changes made to a hierarchy before the hierarchy can be used in reporting and planning.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 147
1.14.2.2.5 Dimension Security (Embedded only)
Security for dimension members is at the dimension level. Once you make a dimension in the Business
Warehouse backend as authorization-relevant, the dimension is secured in all models where it is used.
Features
You can use BW analysis authorization and a Business Planning and Consolidation data access profile to define
access to a dimension member and transaction data.
For more information, see the Security Guide, which is available on the SAP Help Portal at http://help.sap.com/
bopacnw101.
By leveraging Business Warehouse workspace concepts and extending Business Planning and Consolidation
local providers, you can generate local dimensions, which are named local InfoObjects in BW. The central
InfoObject mentioned here is the corresponding global InfoObject in Business Warehouse.
Prerequisites
A central BW InfoObject, known as the central dimension, can be used as a reference to create a local
InfoObject - a dimension - when all of the following prerequisites have been met:
Note
The Creation of Master Data Allowed option is by default not checked when a new workspace is
created. To change this behavior, go to transaction RSBPCADMIN and set the value of parameter
WSP_SIDX to “X”.
● The central InfoObject is assigned to the central providers list in the current workspace (environment). To
make sure of this, go to Transaction RSWSP, input the current environment ID as the Workspace ID and click
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
148 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
Display. Then, click the Central Providers tab and check if the target central InfoObject is listed there. If not,
click the Build InfoProvider Selection button, select the target central InfoObject, drag it to the central
providers list on the right, and activate the modification.
Context
A local dimension inherits all the metadata and master data from its central InfoObject. All changes to master
data made in central InfoObjects are automatically reflected in the local dimension if they are not overwritten
by subsequent changes to local dimension.
After generating a local dimension from the original central InfoObject, you can rename the member ID or
change the attribute value. You can also add to the local dimension new attribute values, such as new members
that do not exist in the central InfoObject. The new attribute value is visible only in the local dimension and
overwrites the property value inherited from the global BW InfoObject.
Note
A central InfoObject can have only one local inherited version of the InfoObject within one Business
Planning and Consolidation environment.
Procedure
Related Information
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 149
1.14.2.2.6.1 Deleting Local Dimensions (Embedded only)
Context
Note that you cannot delete a local dimension that is being used inside a local provider.
Procedure
1. Go to the dimension list view, then select the local dimension you want to delete.
2. Click Delete on the toolbar.
Use
A model is a representation of the relationships, calculations, and data of an organization or business segment.
In a standard configuration of Business Planning and Consolidation, 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 (Standard only) [page 154] and Drivers and Rates Models (Standard only) [page 155].
In an embedded configuration of Business Planning and consolidation, models can be categorized as planning
models or consolidation models. Planning models are used for generic planning related activities.
Consolidation models are designed for performing legal consolidation tasks. Consolidation type models must
have specific components defined to fufill legal consolidation requirements. For detailed information, see Set
up a Consolidation Model (Embedded only) [page 190].
Features
To create a model, go to Administration and under the Modeling section, choose Models. On the screen that
appears, choose New.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
150 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
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.
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.
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 (Standard only) [page 269].
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
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 (Standard only) [page 364].
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.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 151
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.
Example
This example depicts INC or EXP accounts. There is no change in behavior for AST or LEQ accounts.
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.
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 new model in an embedded configuration of Business Planning and Consolidation, you set
references to InfoProviders that exist in SAP Business Warehouse (BW). You can choose an arbitrary number of
InfoProviders to include in the model. When creating a new model you can use the following types of
InfoProviders:
● Real-time InfoCubes
● Input enabled DataStore Objects
● Virtual Providers with write interface
● Local providers
For more information about local providers, see Working with Local Providers (Embedded only) [page 159].
Recommendation
We recommend that you familiarize yourself with the documentation of SAP BW as all InfoProviders that
you can use for creating models in Business Planning and Consolidation are delivered by BW.
Note
You cannot create new InfoProviders through the web interface of Business Planning and Consolidation. If
you want to create InfoProviders that you could later use in your models, you must create them in the ABAP
back-end of BW. For more information, see the documentation of SAP Business Warehouse, available at
http://help.sap.com/netweaver .
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
152 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
Adding or Removing InfoProviders (embedded only)
To add a new InfoProvider to a model, or to remove an InfoProvider that is already included in the model, follow
the steps below:
You can review the structure of each individual InfoProvider that is included in a model. To do this, follow the
steps below:
Note
The Business Planning and Consolidation web user interface displays only simple aggregation levels.
These aggregation levels are set on real-time enabled InfoCubes. The complex aggregation levels
(aggregation levels that are created on MultiProviders) are not displayed.
● Related MultiProviders - shows the MultiProviders that exist for the selected InfoProvider.
You can add business rules to a model in the Business Rules area of the Administration screen. You activate the
rule types you need for the model and add the new business rules of each type to the model. For more
information, see Business Rules Management (Embedded only) [page 289].
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 344].
Deleting Models
Caution
In a standard configuration of Business Planning and Consolidation, you 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.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 153
Related Information
Use
Features
The following table describes the different types of reporting models and lists the required dimensions for
each:
● Currency conversion
● Account transformation
● Intercompany bookings
● US eliminations
● Carry-forward rules
● Validations
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
154 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
Type of Reporting Model Description Required Dimensions
● Currency conversion
● Account transformation
● Intercompany bookings
● US eliminations
● Carry-forward rules
● Validations
● Automatic adjustments
Use
Use this function to become familiar with the types of non-reporting models available in Business Planning and
Consolidation.
Features
Drivers and rates models support reporting models by holding data such as currency exchange rates and
ownership percentages. You can report on drivers and rates model data. You cannot define business rules to
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 155
these model types. The following table describes the different types of drivers and rates models and lists the
required dimensions for each:
Group (G)
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.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
156 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
Related Information
Activate Large Key Figure Support in the SAP Reference IMG (Standard only) [page 157]
Modify Existing Models for Large Key Figure Usage (Standard only) [page 158]
Create New Models that Use Large Key Figures (Standard only) [page 158]
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.
Prerequisites
To use this feature, you must have the following software installed:
● Planning and Consolidation 10.0 for the NetWeaver platform SP10 or later
● EPM solutions, add-in for Microsoft Office 10.0 SP14 or later
Procedure
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 157
1.14.3.3.2 Modify Existing Models for Large Key Figure Usage
(Standard only)
To use large key figures in the system, you must modify existing models:
Procedure
To use large key figures in the system, follow these steps when creating new models:
Procedure
Use this function to keep the technical name of a cube unchanged after model modification, optimization, or
transport.
To keep the technical name of a cube unchanged after model modification, optimization, or transport, you can
use the parameter ENABLE_FIXED_CUBENAME with X as its value.
Modifying a model
When the parameter ENABLE_FIXED_CUBENAME is NOT set to X in the source and target system, the current
system behavior remains unchanged.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
158 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
● If the model has no transaction data, the technical name remains unchanged after modifying the model
structure.
● If the model has transaction data, an error message appears to indicate that modifying the model in cube
name stabilization mode is not possible. You must to back up and clear the transaction data in the cube
and modify it again.
Optimizing a model
When the parameter ENABLE_FIXED_CUBENAME is NOT set to X in the source and target system, the current
system behavior remains unchanged.
● A full optimization is automatically switched to light optimize mode and the technical name of the model
does not change after the optimization.
● If you run a light optimize, there is no change to the current system behavior.
Transporting a model
When the parameter ENABLE_FIXED_CUBENAME is NOT set to X in the source and target system, the current
system behavior remains unchanged.
When the parameter ENABLE_FIXED_CUBENAME is set to X in both the source and target system, the resulting
behavior depends on several factors as shown in this table:
Source system A A A A
Target system A (with transaction A (without transaction B (with transaction B (without transaction
data) data) data) data)
Behavior and result The import is rejected. The target model is In the target system: In the target system:
An error appears in the overwritten by the
1. Create a cube 1. Create a cube
log to indicate the fail source model.
named A. named A.
ure and to guide you
2. Copy the transac 2. Delete the cube
on how to proceed.
tion data from B named B.
to A.
3. Delete the cube
named B.
When the parameter ENABLE_FIXED_CUBENAME has different values in the source and in the target system,
the model import is not performed and an error message appears in the transport log.
Local providers work in a similar way to the central InfoProviders. You can use local providers for different
purposes, for example, as a basic information holder for an ad-hoc planning application.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 159
Creating New Local Providers
Note
The CSV file must contain transaction data (for planning) and must have columns that represent
dimensions and key figures.
Choose Next.
5. In Map InfoObjects you can map your dimensions to SAP BW InfoObjects, or you can manually enter the
data type of a column. Select at least one key figure. In this step you can also enable data auditing for the
new provider.
Note
When you map a dimension to an existing SAP BW InfoObject, its master data and hierarchy can be
used directly by the local provider. The dimensions that are not mapped to SAP BW InfoObjects receive
their master data from the uploaded CSV file.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
160 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
Choose Next.
6. In the Create Model step you can create a new model that uses the local provider. If you do not need to
create a model at this time, you can skip this step.
Note
Note
The CSV file must contain transaction data (for planning) and must have columns that represent
dimensions and key figures.
Choose Next.
4. In Map InfoObjects you can map your dimensions to SAP BW InfoObjects, or you can manually enter the
data type of a column. Select at least one key figure. In this step you can also enable data auditing for the
new provider.
Note
When you map a dimension to an existing SAP BW InfoObject, its master data and hierarchy can be
used directly by the local provider. The dimensions that are not mapped to SAP BW InfoObjects,
receive their master data from the uploaded CSV file.
Choose Next.
5. Review your changes and choose Done.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 161
The following information is displayed:
○ The local provider's name and description
○ The aggregation level that was generated automatically
○ The query that was generated automatically
○ Data auditing settings
○ The dimensions of the provider
Data Auditing
When creating or updating a local provider you can choose the data auditing settings as follows:
● When you choose Enable Data Audit, the system automatically creates the necessary auditing dimension.
● When you choose Activate Data Audit, the system begins to log information when data is changed, or new
data is entered.
Work Status
If a local provider has dimensions that are mapped to SAP BW InfoObjects, you can use work status for the
models that are built on that local provider.
Besides the default aggregation level that is generated automatically, you can also create new aggregation
levels with transaction RSPLAN.
You can also create new queries on aggregation levels with the BEx Query Designer. Queries can be consumed
through the Business Planning and Consolidation Web client or the EPM add-in.
Note
The default aggregation level is created on all dimensions of the local provider. The default query is based
on the default aggregation level and does not have any filters or variables.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
162 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
1.14.3.6 Working with Local Queries
A query is a Business Warehouse (BW) concept that refers to a multi-dimensional query used to analyze data.
A query is built on top of InfoProviders. By selecting and combining individual query components called
dimensions and measures or reusable query elements called restricted and calculated measures in a query,
you define how you want to evaluate the data from the selected InfoProvider. Input-enabled queries can also be
used for manual planning.
However, queries alone may not meet your needs, as they support only global BW InfoProviders. Therefore,
Business Planning and Consolidation contains functionality for generating local queries. A local query not only
supports global BW InfoProviders whose exposed data can be used as InfoProviders for the query, but also
supports the upload of local providers. In this way, you can merge your own local data with data from other
sources such as a global, centralized IT department.
Note
Company B is a subsidiary of Company A in Germany. Company A wants to review the final plan data from
different countries. Assume that Company B’s financial personnel keep a private version of their finance
plan locally and hand in a slightly adjusted ‘official version’ to Company A. Also, to compare and adjust data
more conveniently, they would like to see these different versions in one query. This can be done by
leveraging local queries. Local queries allow the locally planned data and global data to be managed in the
same place at the same time, thus enabling local department to design planning and analysis reports with
much more flexibility while not having to learn the underlying BW modeling concept.
Similar to workspace queries in BW, a local query in Business Planning and Consolidation is visible only inside
the current environment or workspace, and not exposed to the entire BW system. Therefore, only users with
access to your environment can view and edit local queries. You can go to the Business Planning and
Consolidation web client and choose the Local Query feature to create and design local queries. On the query
design page, the following components of a local query are displayed:
● Global Filter
The selections in the filter apply to the query in its entirety, restricting dimension members of the query.
When defining the filter, you can click the button and select dimension members from one or more
dimensions. All the InfoProvider data is aggregated according to the filter selections of the query.
● Dimensions
In the query definition, you assign the dimensions in the InfoProvider to the rows, columns, and free
characteristics in the query. With this selection, you specify the data areas of the InfoProvider through
which you want to navigate. The alignment of row and column content determines the initial view for the
query.
● Query Properties
Properties display information about the InfoProvider and show when and by whom the local query was
last changed.
● Measures
You can create a new measure or a planning-enabled measure. When creating a new measure, existing
transaction data can be further modified by manually entering or by uploading an xlsx, xlsm, or csv file or a
local provider.
Later you can drag and drop the newly created measures and planning-enabled measures as well as
existing measures in the query either to a row or a column. Then you define which numerical data is
displayed by restriction or formula:
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 163
○ Restrictions: restrict the measure value based on a combination of dimensions if necessary.
○ Formulas: calculations based on the measures or other structure members contained in the
InfoProvider. When editing a formula, you can get all the operands and operators available for the
formula under the Formula Editor box.
Related Information
Prerequisites
To create and design local queries, make sure that the following Internet connection services are activated in
the Business Warehouse back-end system using transaction SICF:
● /sap/bc/ui5_ui5/sap/rsl_wqd
● /sap/bw/modelling
Ensure you have a role with the authorization object S_RS_WSPAC with the activity value 68 assigned to you.
For example, the role SAP_BW_WORKSPACE_DESIGNER contains this S_RS_WSPAC authorization object.
Therefore, any user assigned this role would be able to design local queries.
Allow the creation of local queries in the Planning and Consolidation web client. Go to the model on which you
want to create a local query and set the option Allow Local Query to On. Then select Local Query Basis for the
relevant InfoProviders you want to use for designing local queries.
Procedure
The new query design page displays the existing layout of the central query.
4. Right-click on Measures in the left-side panel to add new measures or new planning-enabled measures.
Planning-enabled measures allows data input.
5. Drag and drop the newly created measure from the Measures list to the row or column where the central
query’s measures lie. You can also directly add new measures by right-clicking Measures in the rows or
columns and choosing Add Member.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
164 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
6. Double-click the measure or right-click the measure to restrict the measure’s value and apply calculation
formulas if necessary.
7. Drag and drop other dimensions to the columns, rows, or free zones.
8. Save the query and carry out further tasks such as planning by directly choosing the report or input form
or by using SAP BusinessObjects Analysis, edition for Microsoft Office.
Prerequisites
To create and design local queries, make sure that the following Internet connection services are activated in
the Business Warehouse back-end system using transaction SICF:
● /sap/bc/ui5_ui5/sap/rsl_wqd
● /sap/bw/modelling
Ensure you have a role with the authorization object S_RS_WSPAC with the activity value 68 assigned to you.
For example, the role SAP_BW_WORKSPACE_DESIGNER contains this S_RS_WSPAC authorization object.
Therefore, any user assigned this role would be able to design local queries.
Allow the creation of local queries in the Planning and Consolidation web client. Go to the model on which you
want to create a local query and set the option Allow Local Query to On. Then select Local Query Basis for the
relevant InfoProviders you want to use for designing local queries.
Procedure
If you create the local query based on a CompositeProvider, you can also restrict the measure to a certain
InfoProvider to define where the key figure will be written back.
8. Save the query and carry out further tasks such as planning by directly choosing the report or input form
or by using SAP BusinessObjects Analysis, edition for Microsoft Office.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 165
1.14.4 Consolidation (Standard only)
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.
● 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 Business
EPM solutions, add-in 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:
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.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
166 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
To set up your consolidation environment, you do the following:
● Create the consolidation (legal) environment and set the necessary parameters; see Create an
Environment (Standard only) [page 167].
● Set up master data (dimensions); see Master Data (Dimensions) Setup (Standard only) [page 179].
● Create the model; see Create or Modify the Model (Standard only) [page 180].
● Enable business rules; see Business Rule Setting (Standard only) [page 184].
● Update rate data and ownership data; see Execute Consolidation Task (Standard only) [page 185] and
Loading Data (Standard only) [page 187].
● Set the work status; see Work Status Setup [page 344].
● Set the journal template and validation criteria; see Journal Definition and Validation Setting (Standard
only) [page 188].
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.
Features
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.
Note
Whereas 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.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 167
The MAIN legal consolidation model requires the following dimensions:
Dimension Description
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 ver
sions, such as BudgetV1, and BudgetV2.
Entity Contains the business units that are used to drive the business proc
ess.
Depending on your model design, the Entity type can be for example
an operating unit, a cost center, or a geographic entity.
The RATE model containing exchange rates requires the following dimensions:
Dimension Description
ACCOUNT 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 ver
sions, 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, typi
cally named GLOBAL.
Time Contains the time periods for which you store data.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
168 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
Note
Time and Category dimensions must be shared by all the models involved in consolidation.
The OWNERSHIP model storing the ownership details requires the following dimensions:
Dimension Description
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 ver
sions, such as BudgetV1 and BudgetV2.
Entity Contains the business units that are used to drive the business proc
ess. Depending on your model design, the Entity type can be for ex
ample an operating unit, a cost center, or a geographic entity.
Account (Consolida A X
tion)
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
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 169
Name Type MAIN OWNERSHIP RATE
InputCurrency R X
Audit D X
Currency R X
Activities
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.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
170 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
The following table details the account dimension properties:
Note
Several DIMLIST properties can be
used for one dimension.
● blank
All accounts are translated with a
factor of 1.
● NOTRANS
Accounts are not translated.
Note
This property is used only with the
US Eliminations business rule.
Category Dimensions
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 171
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 cube, where all the simulated cases can be stored.
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 cube, 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:
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
172 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
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 ● Blank
The category for the opening bal
ances is the same.
● Not blank
The ID of the category from which
to read the opening balances.
OPENING_YEAR 4 ● Blank
Read the opening balances from
the year before the current year.
● Not blank
Contains the year from which to
read the opening balances. It can
be an absolute or a relative amount
OPENING_PERIOD 10 ● Blank
Read the opening balances from
the last period of the year.
● Not blank
Contains the period from which to
read the opening balances. It can
be an absolute or a relative amount
Audit Dimension
● 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.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 173
The following table details the data source dimension properties:
IS_CONVERTED 1 ● Y
The data source is converted.
● N
The data source is not converted.
● G
Converts 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 trans
lated into the currency member
corresponding to the specified
group.
IS_CONSOL 1 ● Blank
Used for top adjustments of con
solidated amounts
● Y
Standard setting to consolidate
data
DATASRC_TYPE 1 ● I - input
● M - manual journal entry
● A - automatic adjustment
● L - level
This is used in consolidation by
level to move prior level elimina
tions into a data source with prop
erty DATASRC_LEVEL of Y in the
GROUP dimension.
OPENING_DATASRC 20 ● Blank
The data source is the same as the
source member
● Non-blank
Contains the ID of the desired des
tination data source for the copy
Entity Dimension
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
174 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
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.
Optional.
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:
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 175
Dimension Property Name Length Description of Appropriate Property Value
● Y
By 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 ● Y
If you want to store in the ID entered in the En
tity property.
● Blank
If you do not want to store in the ID entered in
the Entity property.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
176 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
Dimension Property Name Length Description of Appropriate Property Value
FIRST_CONS_DATE 10 ● Blank
Management model.
● YYYYMMM
Indicates the month and year of the consolida
tion.
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.
● 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
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 177
If you choose to use a flow type dimension, the following properties are required:
Flow dimensions should contain dimension members that require the following FLOW_TYPE property values:
● OPENING
● CLOSING
● VARSCP
Activities
1. In the home page, go to Administration and under the Dimensions and Models 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
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
178 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
1.14.4.4 Master Data (Dimensions) Setup (Standard only)
Features
The consolidation engine leverages the following models to retrieve the information necessary to perform its
calculations:
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 model, associated with a given model, is defined as an option upon the creation of a new MAIN
model in Planning and Consolidation Administration.
The OWNERSHIP model, associated with a given model, is defined as an option upon creation of a new
Consolidation model in Planning and Consolidation Administration.
If this value does not exist, the consolidation procedure searches for a model named OWNERSHIP.
Each one of the above models must contain some required dimensions, while some other dimensions are
optional. For more information, see Dimension Setup in Dimension Library (Standard only) [page 167].
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.
All models must contain the following four required dimensions: ENTITY, CATEGORY, TIME, and ACCOUNT.
They can be renamed as desired.
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.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 179
The GROUP dimension used must be the same in the OWNERSHIP model and the MAIN model. Here are some
of the common member requirements between these dimensions for the Legal consolidation environment
setup described below:
In most cases, it is recommended that you use the same dimensions across models as it is easier to maintain.
Note
The RATE model is delivered with EnvironmentShell. Most dimension properties required for the
consolidation setup are delivered with the dimensions. However, it is recommended that you verify this
before proceeding further.
When working with a model, the model type tells the system which properties to associate with the model.
Features
In SAP Business Planning and Consolidation, a model is either Reporting or Non-reporting. Non-reporting
models support reporting models by holding data such as prices or rate information.
Following are the three types of reporting model in SAP Business Planning and Consolidation:
● Financial
A financial reporting model performs management consolidation functions, such as currency conversions,
and intercompany eliminations.
This model must reference a rate-type model.
● Consolidation
A consolidation reporting model performs legal consolidations. This is similar to a financial model, but with
legal consolidation rules instead of management.
This model must reference an ownership-type model and a rate-type model.
● Generic
A generic reporting model has no special requirements (other than to include a minimum of the four
required dimensions).
The non-reporting types of models can be associated with only the financial and consolidation type models.
Following are the two types of non-reporting model:
● Rate
This model stores exchange rates that support currency conversions for reporting models. The model
must include a currency-type dimension to store the exchange rates by currency.
● Ownership
An ownership model stores information such as the consolidation methods, ownership percentages, and
group roll-up information used for legal consolidation.
Within the same environment, multiple reporting models may exist, each one pointing to its own RATE and
OWNERSHIP models. Multiple reporting models can also share the same RATE or OWNERSHIP models, if
appropriate.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
180 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
The RATE or OWNERSHIP model associated with a given reporting model is defined when a new consolidation
type model is created.
Note
You 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. All models require at least the four main
dimension types: Entity, Account, Time, and Category.
In SAP Business Planning and Consolidation, a consolidation scenario requires at least the following models:
● Legal or MAIN
This is the main model containing all financial data. All consolidation postings such as eliminations, and
minority interest calculations are posted in this model.
● OWNERSHIP
The OWNERSHIP model manages the organization structure and ownership percentages.
● RATE
This contains all currency exchange rates for the different rate types such as average, and sport rate.
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. The reporting
model must contain a currency (type R) dimension.
RATE Model
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 consolidation models. EnvironmentShell comes with a
RATE model, so you can leverage this by just modifying the Category dimension from Category to C_Category.
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. The currency conversion
process makes use of a RATE model, where the appropriate exchange rates are searched for each relevant
currency. This cube can be named as desired.
Note
The master data (dimension) can be shared by any model within an environment.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 181
OWNERSHIP Model
Any consolidation type model must refer to a RATE and an 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 OWNERSHIP model defines ownership details such as the consolidation scope, method, percentage of
shares owned by the holding company or groups.
For the OWNERSHIP model, the only dimension that is specific to the OWNERSHIP cube is the Ownership
Account that the consolidation engine uses to get the information listed above. To pass the information, several
required members need to be defined. The required members are as follows:
Any consolidation type model must refer to a RATE and OWNERSHIP model.
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 conversion
Conversion of local currency data to the desired reporting currencies.
● Calculations
To calculate and store amounts which are required for purposes of account-based calculations.
● Intercompany bookings
Matching intercompany transactions
● US Eliminations
Specifically designed to address the posting of intercompany eliminations in simpler scenarios where a full
legal consolidation model is not required
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
182 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
● Carry Forward
Initialization of beginning balances when a new fiscal cycle starts
● Validation
Validation of input data
● Eliminations and Adjustments
Generation 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
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 cube
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 cube, as far as the currency translation is concerned. For
consolidation purposes, however, there are some other requirements. These are described below:
Additional (user defined) dimensions can be added to the MAIN cube (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.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 183
1.14.4.6 Business Rule Setting (Standard only)
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.
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
Intercompany elimination
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.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
184 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
1.14.4.7 Execute Consolidation Task (Standard only)
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.
The Financial packages that can be used for the consolidation process, apart from the Standard and
Administrative packages, are in the following table:
Planning and Consolidation Default For Executes default formulas stored in /CPMB/DEFAULT_FORMULAS
mulas Logical your default.xls file.
Planning and Consolidation FX Restate Allows you to perform currency transla /CPMB/FX_RESTATMENT
ment tion. The package runs the FXTrans
logic.
Planning and Consolidation Legal Con Runs the LegalConsolidation logic. /CPMB/LEGAL_CONSOLIDATION
solidation
Planning and Consolidation Run Cal Runs the CalcAccount logic. /CPMB/RUNCALCACCOUNT
cAccount
Planning and Consolidation Clear the Clears journal tables and creates an /CPMB/CLEAR_JOURNALS
Journal Tables output file.
Planning and Consolidation Export the Exports journal tables to an output file /CPMB/EXPORT_JOURNAL
Journal Tables
Planning and Consolidation Restore Allows you to load journal tables from a /CPMB/RESTORE_JOURNALS
Journal Tables file
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 185
Procedure
For more information, see the SAP BusinessObjects EPM solutions, add-in for Microsoft Office help.
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.
Each type has advantages and disadvantages. Logic is modelspecific and all script logic statements are
case-insensitive.
1. In the home page, 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.
Note
The Logic File name must be identical to the string defined with the data package.
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:
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 cur
rencies
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
186 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
Account-based Calculations Calculate and store amounts, which are required for pur
poses of account-based calculations
US Eliminations US eliminations
Eliminations and adjustments Generate all the consolidation entries for the desired
groups of entities (such as eliminations, adjustments, re
classifications, and minority calculations)
Procedure
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 (Standard only)
[page 271].
2. Input ownership data and calculate ultimate ownership.
SAP Business Planning and Consolidation 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.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 187
1.14.4.9 Journal Definition and Validation Setting (Standard
only)
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 cube.
Features
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 cube intersections from being saved. You cannot get data into a
cube without going through the Write-Back module. Therefore, validations are implemented in write-back, to
ensure that invalid records cannot get into the cube 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 cube.
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.
Caution
If 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
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
188 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
1.14.4.9.1 Example of Journal Validation (Standard only)
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.
Validations, on the other hand, are designed to prevent incorrect records from being saved to the cube. 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
Finance departments of a corporation use legal consolidation to consolidate numbers from subsidiaries and
produce consolidated financial statements of this group of legal entities at the end of a financial period.
This section focuses on the consolidation model set up and relevant settings required for the various tasks that
are required to successfully perform legal consolidation using SAP Business Planning and Consolidation.
This section also discusses the configuration of business rules, including how to set up currency translations,
intercompany eliminations, copy opening tasks, and other business rules in Planning and Consolidation
Administration. Business rules provide the mathematical foundation for SAP Business Planning and
Consolidation models, allowing users to manage both management and legal consolidation reporting.
Features
You perform the following activities in Business Planning and Consolidation during the financial consolidation
process:
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 189
○ Reclassifications
○ Minority calculations and other calculations
● Make the final validation.
● Generate a consolidation 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.
● Create the embedded type environment and set the necessary parameters. See Create an Embedded
Environment (Embedded only) [page 190].
● Create required InfoObjects and InfoProviders and maintain required InfoObject attributes on the Business
Warehouse backend. See Create InfoObjects and InfoProviders (Embedded only) [page 191] and Maintain
InfoObject Attributes (Embedded only) [page 195].
● Create the consolidation model. See Create or Modify a Consolidation Model (Embedded only) [page 206].
● Enable business rules. See Business Rules Management (Embedded only) [page 289].
● Make sure the EXCHANGE RATE InfoProvider and OWNERSHIP InfoProvider are maintained in Business
Warehouse. See Create or Modify a Consolidation Model (Embedded only) [page 206].
● Define tasks order in task sequences. See Set Task Sequence (Embedded only) [page 206].
● Set the work status, which is optional.
● Set the journal template and validation criteria. See Journal Administration [page 353].
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, such as account, with your consolidation
environment.
Since SAP Business Planning and Consolidation in the embedded configuration directly consume Business
Warehouse data, you must prepare InfoObjects (dimensions) and related attributes (properties) in BW to be
used by the consolidation engine of SAP Business Planning and Consolidation.
1. Create the required InfoObjects. See Create InfoObjects and InfoProviders (Embedded only) [page 191].
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
190 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
2. Maintain the InfoObjects with required attributes. See Maintain InfoObject Attributes (Embedded only)
[page 195].
3. Create required InfoCubes (InfoProviders) and input relevant InfoObjects. See Create InfoObjects and
InfoProviders (Embedded only) [page 191].
4. Create aggregation levels based on the InfoProviders. (see Aggregation Level )
After that you can create a Consolidation model and define it in the SAP Business Planning and Consolidation
web client, including adding InfoProviders with aggregation levels predefined in BW to the Consolidation model,
mapping InfoObjects to corresponding Business Planning and Consolidation dimension types and mapping
attributes of the InfoObjects to related Business Planning and Consolidation dimension properties. For detailed
settings, refer to Create or Modify a Consolidation Model (Embedded only) [page 206].
Upon successfully creating the Consolidation model, you can select one or more of the following consolidation
business rules that need to be implemented:
● Currency Conversion
Conversion of local currency data to the desired reporting currencies
● Account-based Calculations
To calculate and store amounts that are required for purposes of account-based calculations
● Carry Forward
Initialization of beginning balances when a new fiscal cycle starts
● Intercompany Booking
Matching intercompany transactions
● Eliminations and Adjustments
Generation of all 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
minority interest, reclassifications, and any other postings depending on the nature of the consolidation
methodologies required.
Follow these guidelines to create InfoObjects and InfoProviders that can be used by the Consolidation engine of
Business Planning and Consolidation.
In SAP Business Planning and Consolidation in the embedded configuration, a consolidation model requires
the following types of InfoProviders to be mapped from Business Warehouse:
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 191
This stores all currency exchange rates for the different rate types, such as average and spot rate. Currency
conversion applies to consolidation models to which a corresponding RATE InfoProvider has been
referenced, where the appropriate exchange rates are searched for each relevant currency.
● SOURCE InfoProvider (Optional)
This can be used as source data if a user has a non-planning InfoProvider that contains the source data for
consolidation. If you refer to this InfoProvider, then you must make sure it contains the same dimensions
(InfoObjects) as defined in the Consolidation InfoProvider.
Note
For the two mandatory InfoProviders, you must make sure they contain inputable InfoProviders, such as
cube or CompositeProviders that contain cubes.
You also need to create the InfoObjects required by the Consolidation engine of Business Planning and
Consolidation that match various Business Planning and Consolidation dimension types and input them into
different types of InfoProviders. You can choose the names of these InfoObjects, but we suggest that you name
them according to the dimensions you are going to match in the Business Planning and Consolidation web
client. These dimension include:
Dimension Description
Account (CONSOLIDATION) Members of this dimension are, for example, Revenue or Sal
aries.
Account (RATE) Members of this dimension are used to detail the different
types of rate, for example, Average or End-of-period.
Account (OWNERSHIP) Members of this dimension are, for example, METHOD (con
solidation method), POWN (ownership percentage), and
PCON (control percentage).
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 (CONSOLIDATION) Contains the business units that are used to drive the busi
ness process. Depending on your model design, the Entity
type can be, for example, an operating unit, a cost center, or
a geographic entity.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
192 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
Dimension Description
Currency (CONSOLIDATION) The currency type dimension is required if the customer re
ports on local currency and translated values.
Currency (RATE) This dimension is used to store each applicable local cur
rency.
Time and Category dimensions must be shared by all the InfoProviders involved in consolidation. Other
dimensions, such as Account (CONSOLIDATION), Account (RATE) and Account (Ownership), share the same
Business Planning and Consolidation dimension types but are specific to each InfoProvider, so they have to be
maintained with different members. However, in most cases, we recommend that you use the same
dimensions across InfoProviders as it is easier to maintain, as follows:
● The ENTITY dimension of the CONSOLIDATION InfoProvider can be the same as that used in the
OWNERSHIP InfoProvider or it must contain the appropriate matching members if different.
● The GROUP dimension used must be the same in the OWNERSHIP InfoProvider and the CONSOLIDATION
InfoProvider.
● The CURRENCY dimension of the CONSOLIDATION InfoProvider can be the same as that used in the RATE
InfoProvider, or it can be different if it is maintained with appropriate matching members.
Note
The TIME dimension must use the 0FISCPER InfoObject in Business Warehouse inside all InfoProviders
referenced by the Consolidation model.
The relationships between these Business Planning and Consolidation dimensions and different types of
InfoProviders are shown in the following table:
Relationships of InfoProviders
Business Planning
and Consolidation Di
mension Dimension Type CONSOLIDATION OWNERSHIP RATE
Account (Consolida A √
tion)
Account (Ownership) A √
Account (Rate) A √
Audit D √
Flow S √
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 193
Business Planning
and Consolidation Di
mension Dimension Type CONSOLIDATION OWNERSHIP RATE
Category C √ √ √
Entity (Consolidation) E √ √
Entity (Rate) E √
Intercompany I √ √
Time T √ √ √
Group G √ √
Currency (CONSOLI R √
DATION)
InputCurrency R √
The Source InfoProvider shares the Business Planning and Consolidation dimension type with the
CONSOLIDATION InfoProvider. As shown in the table, the RATE InfoProvider containing exchange rates must
specifically have Account (Rate), Category, Entity (Rate), Time, and InputCurrency dimensions. The
OWNERSHIP InfoProvider storing the ownership details must specifically have Account (Ownership), Category,
Entity (Consolidation), Intercompany, Time, and Group dimensions.
Activities
1. Go to BW modeling tools.
2. Refer to the required Business Planning and Consolidation dimensions and create corresponding
InfoObjects for each.
3. Maintain the required attributes of the InfoObjects. See Maintain InfoObject Attributes (Embedded only)
[page 195].
4. Create four InfoCubes (InfoProviders) in the type of CONSOLIDATION, OWNERSHIP, RATE, and SOURCE.
5. Input corresponding InfoObjects to each InfoCube (InfoProvider).
6. Create aggregation levels based on the InfoCubes (InfoProviders).
Note
When adding the InfoProviders to the Consolidation model you want to create, you must select an
aggregation level based on the InfoProvider to make sure only the desired dimensions required for legal
consolidation are selected.
After these InfoProviders and InfoObjects are correctly maintained, you can further add and map them when
creating or modifying a consolidation model in SAP Business Planning and Consolidation. For detailed settings,
refer to Create or Modify a Consolidation Model (Embedded only) [page 206].
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
194 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
1.14.5.2.2 Maintain InfoObject Attributes (Embedded only)
Several dimension properties are required by the consolidation engine of SAP Business Planning and
Consolidation.
When you map the required InfoProviders into a consolidation model, all the underlying dimensions will
automatically be referred into the dimension library. To ensure the correct operation of consolidation and
related processes, such as currency translation, simulation, and eliminations and adjustments, several
dimension properties are required by the consolidation engine of SAP Business Planning and Consolidation,
and you need to ensure that these properties are maintained in Business Warehouse so that they could be
further mapped while creating the consolidation model in SAP Business Planning and Consolidation. You
should also ensure that these properties are maintained with the appropriate values of the consolidation
process for your business requirements.
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 InfoProvider
can have only one account-type dimension.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 195
Property Name Length Description of Property Values
Note
In an OWNERSHIP InfoProvider, all required O_Account dimension members, including POWN, PCON,
PCTRL, METHOD, and PGROUP, need to be maintained by an administrator.
Category Dimensions
The properties required in this dimension as described in the table below 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 cube, where all the simulated cases can be stored.
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 cube, simulated translations are stored in additional
members of the Category dimension. These categories have non-blank values for one or more of the properties
in the table below.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
196 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
Category Dimension Properties
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 ● Blank
The category for the opening bal
ances is the same.
● Not blank
The ID of the category from which
to read the opening balances.
OPENING_YEAR 4 ● Blank
Read the opening balances from
the year before the current year.
● Not blank
Contains the year from which to
read the opening balances. It can
be an absolute or a relative
amount.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 197
Property Name Length Description of Property Values
OPENING_PERIOD 10 ● Blank
Read the opening balances from
the last period of the year.
● Not blank
Contains the period from which to
read the opening balances. It can
be an absolute or a relative
amount.
Audit Dimension
IS_CONVERTED 1 ● Y
The data source is converted.
● N
The data source is not converted.
● G
Converts 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 trans
lated into the currency member
corresponding to the specified
group.
IS_CONSOL 1 ● Blank
¡aæI¤[{xÒ²|KÙµQ&L`»¯àð÷Œ>í
"N'%®ˇ)addyðaÀAº“u*
?ö“ÌÛ?}`¡łBPÛš
solidated amounts .
● Y
Standard setting to consolidate
data.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
198 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
Property Name Length Description of Property Values
DATASRC_TYPE 1 ● I - input
● M - manual journal entry
● A - automatic adjustment
● L - level
This is used in consolidation by
level to move prior level elimina
tions into a data source with prop
erty DATASRC_LEVEL of Y in the
GROUP dimension.
OPENING_DATASRC 20 ● Blank
The data source is the same as the
source member.
● Non-blank
Contains the ID of the desired des
tination 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.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 199
Property Name Length Description of Property Values
Optional
Intercompany Dimension
The Intercompany dimension (I) defines the intercompany codes for entities in consolidation and ownership
InfoProviders.
Currency
The currency type dimension is required to report on local currency and translated values. The required
property for currency dimension is the following:
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
200 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
Currency Dimension Type
R CURRENCY_TYPE 1 ● CURRENCY_TYPE
○ L - local currency
○ R - reporting cur
rency REPORTING
(length 1)
○ T - transaction cur
rency
● Reporting: Y or blank
Group
The required properties for a separate group dimension are the following:
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 201
Description of Property Val
Dimension Type Property Name Length ues
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
202 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
Description of Property Val
Dimension Type Property Name Length ues
Note
The ENTITY attribute
should use the same In
foObject of ENTITY di
mension in the model.
The value entered in the
ENTITY attribute should
be a valid entity ID.
● Y
By default the results of
the translation into a
Group currency are writ
ten in both the Group
member and in the Cur
rency member of the
currency dimension.
● N (or blank)
If only the Group mem
ber is to be stored, set
this property to N.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 203
Description of Property Val
Dimension Type Property Name Length ues
G STORE_ENTITY 1 ● Y
If you want to store in
the ID entered in the En
tity property.
● Blank
If you do not want to
store in the ID entered in
the Entity property.
● G - Group member
● N - Non-group member
G FIRST_CONS_DATE 10 ● Blank
Management model
● YYYYMMM
Indicates the month and
year of the consolida
tion.
Flow Dimension
The flow type dimension is optional, but its use is highly recommended. This dimension allows you to track
changes within 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.
● 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.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
204 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
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 dimensions should contain dimension members that require the following FLOW_TYPE property values:
● OPENING
● CLOSING
● VARSCP
Optional - All dimensions could be mapped with the ENABLEJRN property and the DIMLIST property. For
detailed information about ENABLEJRN, see Limits to Dimension Members for Journal Entries [page 358].
Activities
● To make sure every dimension (InfoObject) possesses the required dimension attributes for a
consolidation scenario, you need to maintain the dimension structure beforehand in Business Warehouse
using BW modeling tools.
● To make sure the dimension master data is correct, you can maintain the master data either in Business
Warehouse using BW modeling tools, or you can maintain the dimension master data directly in the SAP
Business Planning and Consolidation web client. Refer to Dimension Management (Embedded only) [page
142] for details on how to maintain dimension master data.
After dimension (InfoObject) attributes and its master data are correctly maintained, you can further map
those attributes when creating or modifying a consolidation model in SAP Business Planning and
Consolidation. For detailed settings, refer to Create or Modify a Consolidation Model (Embedded only) [page
206].
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 205
1.14.5.2.3 Create or Modify a Consolidation Model
(Embedded only)
In the embedded configuration of SAP Business Planning and Consolidation, a model is either a planning
model or a consolidation model. After completing relevant Business Warehouse back-end settings, you can
create and define a consolidation model in the Business Planning and Consolidation web client.
Within the same environment, multiple consolidation models may exist, each one pointing to its own
consolidation, rate, and ownership InfoProviders. Multiple consolidation models can share the same
consolidation or rate or ownership InfoProviders, if appropriate.
To create a consolidation model, you must map BW InfoProviders to a CONSOLIDATION InfoProvider and an
OWNERSHIP InfoProvider. You have the option to map BW InfoProviders to an EXCHANGE RATE InfoProvider
and a SOURCE InfoProvider. Then, you need to map InfoProvider dimensions to dimension types required by
the SAP Business Planning and Consolidation consolidation engine, as well as map InfoObject attributes to
dimension properties required by the consolidation engine.
When you define a task sequence, you determine which consolidation tasks you would like to trigger from
Consolidation Monitor, as well as set the sequence of tasks to be displayed in Consolidation Monitor.
For each business rule type below is a corresponding consolidation task type:
● Currency translation
● Account-based calculation
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
206 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
● Intercompany booking
● Carry forward
● Elimination and adjustment
● US elimination
If you have enabled work status and controls for models, two additional rule types are available:
● Work status
● Controls
To add a task to a model, you need to define general settings and specific settings for the task. In General
Settings, you specify the periods to which the task applies. By selecting Every Period with 000 Period or Every
Period without 000 Period, you define the frequency as every period. 000 means a financial period 000 that
starts before all other existing periods is included. By entering one or more values manually in the Periods field,
you specify on which periods the task is executed. You can also specify the category dimension members in
General Settings. Later, when users execute tasks in Consolidation Monitor, only the tasks whose periods and
category members match the context time and category dimension members display.
In Task Specific Settings, you use Other Dimension Filter to restrict members for dimensions other than the
ones in General Settings. To do this, follow this format:
Note
The superior dimension of C1000 and C2000 is China. If you want to choose C1000 and C2000 of the
entity dimension ZPAKENT from the V1 version of hierarchy H1 and you select P1 from the userdefined
dimension PRODUCT, you enter the formula below in the Other Dimension Filter field:
ZPAKENT=H1!V1#ZPAKENT!China/C1000,H1!V1#ZPAKENT!China/C2000; PRODUCT=P1
Through the taskspecific settings you can customize tasks of the same task type and use different task names
to identify these tasks. For example, you can define two account-based calculation tasks and give them
different task names. Then you can go to Consolidation Monitor and select either of the account-based
calculations to trigger the corresponding task.
Note
There are some special settings for dimension members defined in the Other Dimension Filter field of the
US Elimination type task:
● If you do not specify members for the group dimension (G type), then the US Elimination will both
execute on G_NONE and the member you selected and its subgroup members in Consolidation
Monitor.
If you define the group member as G_NONE, US Elimination will be executed on G_NONE no matter
what group type dimension member you select in Consolidation Monitor.
If you do not specify members for the currency dimension (R type) in the Other Dimension Filter, the
US Elimination will execute on group currency and LC in Consolidation Monitor.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 207
Activities
SAP Business Planning and Consolidation leverages Business Warehouse planning functions to execute
consolidation tasks.
Before implementing a scenario for consolidation, you first need to install all necessary InfoObjects:
1. Go to RSA1, open the BI Content tab, then install the InfoObjects (IOBJ) /CPMB/RULE and /CPMB/RENT.
2. Within RSA1 on the BI Content tab, install the planning function types (PLST) /CPMB/LAUNCH_LOGIC, /
CPMB/WRITE_BACK and /CPMB/READ_CTRL_DATA.
After you enable these InfoObjects and planning function types, you can trigger consolidation tasks either
through the planning function in the Business Warehouse backend or in Consolidation Monitor in the Business
Planning and Consolidation web client.
Consolidation tasks, such as currency translation as well as matching and elimination of inter-unit balances,
are predefined functions in Business Planning and Consolidation to calculate and post amounts required to
support common accounting activities.
For each predefined function, there are one or more business rule tables that provide the flexibility for you to
customize the functions to meet your specific business needs without having to understand scripting or
programming. For more information about the business rules delivered with SAP Business Planning and
Consolidation, see Business Rules Management (Embedded only) [page 289].
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
208 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
1.14.5.5 Load Data (Embedded only)
1.14.6 Rules
Use
You can perform calculations on your data using the following methods:
● Business rules, in both the embedded and standard configurations of Business Planning and Consolidation
Business rules are parameter-driven functions within models for calculating and posting monetary
amounts in support of common accounting activities.
● Logic, in the standard configuration of Business Planning and Consolidation
With logic, you define formulas that perform calculations on dimension members and data.
Use
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 124].
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 209
Features
● 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 userdefined functions, from a library file.
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.
Use
The basis for a dimension and advanced rule formulas is the multi-dimensional expression language called
MDX.
Features
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.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
210 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
The following are exceptions to MDX syntax:
Note that the following structure is the normal syntax for calculated members required by MDX queries:
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 211].
For examples of movement calculations and allocating expenses based on entity type, see Advanced Rule
Formula Examples [page 213].
Use
The following are examples of simple MDX formulas that can be used in the Formula column for an account:
Features
[DIMENSION].[ACCOUNT1] + [DIMENSION].[ACCOUNT2]
Example
PreTax Income:
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 211
Task Syntax and Example
[DIMENSION].[ACCOUNT1]:[DIMENSION].[ACCOUNT2]
Example
Total Personnel Exp:
SUM([ACCOUNT].[SALARIES]:[ACCOUNT].[COMMISSION])
[DIMENSION].[ACCOUNT1] / [DIMENSION].[ACCOUNT2]
Example
Gross Margin Pct:
[DIMENSION].[ACCOUNT1]*[DIMENSION].[ACCOUNT2]
Example
Taxes:
[DIMENSION].[ACCOUNT1],[MEASURES].[YTD]
Example
Current Year Net Income:
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.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
212 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
1.14.6.1.1.2 Advanced Rule Formula Examples (Standard only)
Use
Advanced rule formulas include movement calculations and expense allocation based on entity type.
Features
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
With the formula, you are checking whether the current TIME member is
parent or not by checking the property CALC = NO. 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.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 213
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.
Example
In this formula, you are taking the "RD" values of FUNCTION prop
erty.
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.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
214 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
1.14.6.1.1.3 Nested Formulas (Standard only)
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 in a standard
configuration. 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 HANABPCSP05 installed on
your system.
Use
You can create a nested formula in which the different parts of that formula are calculated by other formulas.
Example
A=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.
Use
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.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 215
Business Planning and Consolidation provides a library of MDX formulas, and the EnvironmentShell sample
environment contains a number of logic functions.
Note
Logic 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:
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.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
216 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
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.
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:
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 section Business Planning and
Consolidation, version for the SAP NetWeaver Platform in the Enterprise Performance Management (EPM) How-
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 217
to Guides section of the SAP SDN at: http://wiki.sdn.sap.com/wiki/display/BPX/Enterprise+Performance
+Management+%28EPM%29+How-to+Guides .
Use
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.
Features
The following table describes some of the more common MDX functions:
ClosingPeriod Returns the last sibling among the descendants of [<Level>[, <Member>] ]
a member at a level
Cousin Returns the member with the same relative posi <Member1>, <Member2>
tion under a member as the member specified
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
218 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
MDX Function Description Parameters
NextMember Returns the next member in the level that contains (none)
a specified member
OpeningPeriod Returns the first sibling among the descendants of [<Level>[, <Member>] ]
a member at a level
ParallelPeriod Returns a member from a prior period in the same [<Level>[, <Numeric Expression>[,
relative position as a specified member <Member>] ] ]
PrevMember Returns the previous member in the level that con (none)
tains a specified member
Aggregate Returns a calculated value using the appropriate <Set>[, <Numeric Expression>]
aggregate function, based on the context of the
function
Avg Returns the average value of a numeric expression <Set>[, <Numeric Expression>]
evaluated over a set
Correlation Returns the correlation of two series evaluated <Set>, <Numeric Expression>[, <Nu
over a set meric Expression>]
Count Returns the number of tuples in a set, empty cells <Set>[, EXCLUDEEMPTY | INCLU
included unless the optional EXCLUDEEMPTY flag is DEEMPTY]
used
IIf Returns one of two values determined by a logical <Logical Expression>, <Numeric Ex
test pression>, <Numeric Expression>
LinRegIntercept Calculates the linear regression of a set and re <Set>, <Numeric Expression>[, <Nu
turns the value of b in the regression line y = ax + b meric Expression>]
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 219
MDX Function Description Parameters
LinRegPoint Calculates the linear regression of a set and re <Numeric Expression>, <Set>, <Nu
turns the value of y in the regression line y = ax + b meric Expression>[, <Numeric Ex
pression>]
LinRegR2 Calculates the linear regression of a set and re <Set>, <Numeric Expression>[, <Nu
turns R2 (the coefficient of determination) meric Expression>]
LinRegSlope Calculates the linear regression of a set and re <Set>, <Numeric Expression>[, <Nu
turns the value of a in the regression line y = ax + b meric Expression>]
LinRegVariance Calculates the linear regression of a set and re <Set>, <Numeric Expression>[, <Nu
turns the variance associated with the regression meric Expression>]
line y = ax + b
Max Returns the maximum value of a numeric expres <Set>[, <Numeric Expression>]
sion evaluated over a set
Median Returns the median value of a numeric expression <Set>[, <Numeric Expression>]
evaluated over a set
Min Returns the minimum value of a numeric expres <Set>[, <Numeric Expression>]
sion evaluated over a set
Sum Returns the sum of a numeric expression evalu <Set>[, <Numeric Expression>]
ated over a set
Use
You use this instruction to call any custom ABAP programming you have written.
Activities
*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.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
220 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
*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
Note
Before 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.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 221
l_ast_acct(16) TYPE c,
l_year(3) TYPE n,
l_percentage(3) TYPE p,
time_dim(16) TYPE c,
CLEAR ls_param.
IF sy-subrc NE 0.
l_log = 'You have not specified the parameter ''YEAR'' which is required.'.
EXIT.
ENDIF.
l_year = ls_param-hashvalue.
CLEAR ls_param.
IF sy-subrc NE 0.
l_log = 'You have not specified the parameter ''PERCENTAGE'' which is required.'.
EXIT.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
222 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
ENDIF.
l_percentage = ls_param-hashvalue.
EXPORTING
i_dim_type = uj00_cs_dim_type-time
i_appl_id
= i_appl_id
RECEIVING
ro_dim_data = lo_dim.
TRY.
IMPORTING
es_dim_info = ls_dim.
ENDTRY.
<ls_result_rec> = <ls_rec>.
DO l_year TIMES.
ENDDO.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 223
ENDLOOP.
Note
ct_data = <lt_final>.
ENDMETHOD.
*START_BADI DECD
QUERY = ON
WRITE = ON
YEAR = 1
PERCENTAGE = 10 *END_BADI
Note
If you want to stop the execution, raise the cx_uj_custom_logic exception within a BADI implementation.
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.
More Information
For instructions about creating an SAP Business Add-In, see the ABAP model help in the SAP NetWeaver
Library.
Use
This reference contains descriptions of all the logic keywords you can use in the standard configuration of this
product.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
224 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
More Information
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 249].
{formula}
*ENDADD
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 225
Example
*ENDADD
*COMMIT
[#CE00661000] = [CE0661000]/[CE0652000]
[P_ACCT].[#CE0661000] =[P_ACCT].[CE0004010]/[P_ACCT].[CE0652000]+[P_ACCT].
[CE0004020]/[P_ACCT].[CE0652000]+[P_ACCT].[CE0004030]/[P_ACCT].[CE0652000]
Note
The 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
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.
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_ACCT].[CE0652000]
*END
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.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
226 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
1.14.6.2.2.3 *DESTINATION_APP (Standard only)
The DESTINATION_APP keyword allows you to write the results of calculations to a different model.
Syntax
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:
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:
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 cube using the following syntax:
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:
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 227
● 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:
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.
Examples
Example 1
Environment: EnvironmentShell_V
Model: PLANNING
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.
*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 cube
*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
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
228 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
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:
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.
*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:
{text}
{text}
*NEXT
Example
In a logic file, you may need to repeat some calculation for a set of entities. This works automatically when
you write:
*RUNALLOCATION
*FACTOR=1/3
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 229
*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.
Note
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.
A userdefined function is the name of a placeholder that a user can insert in 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:
*FUNCTION {functionname}({Param1}[,{Param2}…])
{Function text}
{Function text}
*ENDFUNCTION
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.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
230 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
The values of the passed parameters are replaced in the function text without any validation, even if they are
embedded in longer words, like in the following example:
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 divide-by-zero
error. The Script Logic engine automatically replaces the divide by zero error with zero.
You can also use *FUNCTION to substitute members or dimensions to make scripts more readable.
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:
+-/*^%><=()[]{},.;':&\|#~"
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.
Example
*INCLUDE FUNCTION_DEFINITIONS.LGF
[ACCOUNT].[#PER_PRICE] =
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 231
Price([ACCOUNT].[PERSONAL_COST],[ACCOUNT].[LAB_HOUR])
Price(%COST%,%HOUR%)
%COST%/%HOUR%
*ENDFUNCTION
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.
The *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
*WHEN CATEGORY
*ENDWHEN
Example
*WHEN TIME.YEAR
*IS "2007"
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
232 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
*ENDWHEN
The above script copies the 2007 plan data to Forecast. You can also read property values and assign them
to dimensions.
Example
*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
● 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, PARENTH 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.
You can write multiple REC statements within one WHEN/ IS/ ENDWHEN statement.
Syntax
*WHEN {dim}
* IS {condition_value}
*ENDWHEN
Example
*XDIM_MEMBERSET P_ACCT=CE0004010
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 233
*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 cube.
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.
Note
You have the ability to use implicit Account members in direct MDX statements within script logic.
Syntax
*WHEN {dim}
* IS {condition_value}
*ENDWHEN
Example
Application: Planning
*WHEN P_ACCT
*IS "CE0004010"
*REC(EXPRESSION=%VALUE%/[P_ACCT].[CE0004020], P_ACCT="CE0661000")
*ENDWHEN
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
234 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
Example
Application: Planning
*WHEN P_ACCT
*IS "CE0004010"
*REC(EXPRESSION=%VALUE%/([P_ACCT].[CE0652000],[P_ACTIVITY].[LABPRD]),
P_ACCT="CE0661000")
*ENDWHEN
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.
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 MEASURES="MeasureName"
*ENDLOOKUP
Example
In 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.
Model: Planning
*XDIM_MEMBERSET P_ACCT=CE0004010
*XDIM_MEMBERSET CATEGORY=ACTUAL
*LOOKUP RATE
*DIM TIME="2006.AUG"
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 235
*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
Example
In 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.
*XDIM_MEMBERSET TIME=2006.AUG
*XDIM_MEMBERSET P_ACCT=CE0004010
*XDIM_MEMBERSET CATEGORY=ACTUAL
*LOOKUP RATE
*DIM CATEGORY="ACTUAL"
*DIM R_ACCT="AVG"
*DIM R_ENTITY="GLOBAL"
*DIM TIME="2006.AUG"
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
236 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
*DIM MEASURES="PERIODIC"
*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
You can also pass property values to scope members to look up data.
Example
In this example, the corresponding Entity's currency is read from master data and this is used to look up
the rate value.
*XDIM_MEMBERSET P_ACCT=CE0004010
*XDIM_MEMBERSET CATEGORY=ACTUAL
*XDIM_MEMBERSET ENTITY=C9000
*DIM CATEGORY="ACTUAL"
*DIM R_ACCT="AVG"
*DIM R_ENTITY="GLOBAL"
*DIM RATE:INPUTCURRENCY=ENTITY.CURRENCY
*DIM MEASURES="PERIODIC"
*ENDLOOKUP
*WHEN P_ACCT
*IS "CE0004010"
*REC(EXPRESSION=%VALUE%/LOOKUP(RATE), RPTCURRENCY=ENTITY.CURRENCY)
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 237
*ENDWHEN
Restriction
● Reading multiple measures within a single LOOKUP by assigning different lookup IDs is not supported.
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.
Allocation helps distribute data from a source region to a target region using the specified driver.
Syntax
*RUNALLOCATION
*FACTOR=<driver>
*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.
[property]="property value" A filter to select dimension members based *DIM Product_Group = [Fruit]
on a specified property and a given value for = "apples"
that property.
same as WHERE Use the same members defined in the *DIM Account WHERE = Rent
WHERE parameter for the specified dimen
*DIM Account WHAT = Rent
sion
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
238 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
Options Descriptions Example
<> member The <> operand references all members not *DIM Region USING <> Corp
equal to a defined member.
Restriction of WHAT
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.
same as WHERE Use the same members defined in the *DIM Account WHERE = Rent
WHERE parameter for the specified dimen
*DIM Account USING =
sion. The same dimension must be for both
PercentAcct
WHERE and USING.
Note
WHERE only supports a single member
reference.
<> member The <> operand references all members not *DIM Region USING <> Corp
equal to a defined member.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 239
Options Descriptions Example
[property]="property value" A filter to select dimension members based *DIM Product_Group = [Fruit]
on a specified property and a given value for = "apples"
that property.
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.
.8 Only a fixed amount is to be applied to the Tuple value of the WHAT is 10 for product A
source value for allocation.
10*.8 = 8
USING The value of the USING region defined is Tuple value of the WHAT is 10 for product A,
used as the basis of the allocation. This pro tuple value of the USING is .8
vides the ability to change values without
10*.8 = 8
having to edit the definition of the alloca
tion.
-1 * USING/100 Calculation takes the defined region as Tuple value of the USING region is 70 for
USING, and reverses the value (negative), product A.
Or
then divides the value by 100.
-70/100 = -.7
1 * USING/100
(-70%) (1-70)/100 = -.69 (-69%)
Note
This is used with driver accounts not re
porting values.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
240 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
Options Descriptions Example
USING/TOTAL Calculation takes the region defined as Tuple value of USING region is 70 for prod
USING, and divides the total value for the re uct A. The total of the TOTAL region (tuples)
gion defined as TOTAL. is 700, assuming that the using region is for
all regions not just US.
70/700 = .1 (10%)
Basic Mathematical expression Calculation takes the region defined as Tuple value of the USING region is 70 for
with USING & TOTAL USING, and does the necessary mathemati product A.
cal operations with the total value for the re
(For example, 1 + USING, US 1+70 = 71
gion defined as TOTAL.
ING -1 , and 1 - USING)
70 -1 = 69
1-70 = -69
Restriction of FACTOR
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).
same as WHAT Use the same members defined in the WHAT *DIM Account WHAT = Rent
parameter for the specified dimension
*DIM Account WHERE = Rent
blank or [All] The ability to assume all base members for *DIM Entity =
given dimensions either via a blank parame
*DIM IntCo = [ALL]
ter or [ALL] key word
[property]="property value" A filter to select dimension members based *DIM Product_Group = [Fruit]
on a specified property and a given value for = "apples"
that property.
Common Restriction
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 241
● *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.
Before Allocation
*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
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
242 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
RENT JAPAN Japan 16,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.
Before Allocation
Below is the history data shown for the 2008.JAN period. Asia is the parent node.
Asia ACTUAL
Driver data:
*XDIM_MEMBERSET TIME=2008.JAN,2009.JAN
*XDIM_MEMBERSET P_ACCT=RENT
*XDIM_MEMBERSET CATEGORY=ACTUAL,PLAN
*XDIM_MEMBERSET ENTITY=ASA,BAS(RASA)
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 243
*COMMIT
After Allocation
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.
Before Allocation
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
244 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
Source data - History data for External Sales:
Planning Asia
China 500,000
Japan 600,000
India 200,000
Asia 2,100,000
China
Japan
India
Rest of Asia
Asia
Factor: USING/TOTAL
APP or (Dim) or
VALUE WHAT WHERE USING TOTAL
*RUNALLOCATION
*FACTOR =USING/TOTAL
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 245
*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
Japan 142,857
India 47,619
Asia 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
Planning Asia
China 500,000
Japan 600,000
India 200,000
Asia 2,100,000
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
246 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
Data to be allocated ( ADVERTISING):
China
Japan
India
Rest of Asia
Asia
Factor: USING/TOTAL
APP or (Dim) or
VALUE WHAT WHERE USING TOTAL
*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
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 247
Plan - Periodic 2009.JAN
Japan 142,857
India 47,619
Asia 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
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
Italy 10,000
France 10,000
Global Operations
Factor:
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
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
248 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
*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
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.
Example
With 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.
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.
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
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 249
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.
To write formulas containing several nested IIF( ) statements, use the following syntax:
*SELECTCASE {expression}
*CASE {value1}[,{value2},…]
{formulas}
[*CASE {value1}[,{value2},…]
{formulas}
[*CASEELSE]
{formulas}
*ENDSELECT
where
{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)
*SELECTCASE [ACCOUNT].[E]
*CASE 1,2
#A=X+Y
#C=W+Z
*CASE 3,4
#A=X-Y
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
250 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
#B=W*Z
*CASEELSE
#A=X*Y
*ENDSELECT
Note
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.
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.
Example
*SUB MYSUB(Param1,Param2,Param3,Param4)
[%ACCOUNT_DIM%].[#Param1]=[%ACCOUNT_DIM%].[Param2]+[%ACCOUNT_DIM%].[Param3]
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 251
[%ACCOUNT_DIM%].[#Param4]=[%ACCOUNT_DIM%].[#Param1]*[%ACCOUNT_DIM%].
[Factor_Param4]
*ENDSUB
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.
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.
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.
A 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}
*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"
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
252 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
*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
Note
There 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.
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
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.
*XDIM_MEMBERSET defines the scope of the data in which subsequent business logic will be applied.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 253
Syntax
* XDIM_MEMBERSET {Dimension}<>{MemberSet}
Example
*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.
*XDIM_MEMBERSET P_ACCT = CE0004000, where all children values are summarized to one parent
record.
Use *XDIM_ADDMEMBERSET to add more members to the scope of the member set defined by bas().
Using the <ALL> keyword, you can force a dimension to read all base members without member formulas.
Example
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.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
254 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
1.14.6.2.2.15 *XDIM_ADDMEMBERSET (Standard only)
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.
Example
*COMMIT
In the above example, CE0004210 is scoped along with all children of CE0004000.
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.
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:
Example
*XDIM_MAXMEMBERS P_ACCT = 5
*RUNALLOCATION
*FACTOR=1/12
*ENDALLOCATION
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 255
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.
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.
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 .
Example
*XDIM_PACKAGEBY ENTITY
In the example above, two packages are created and partitioned by the dimension ENTITY.
Example
*XDIM_PACKAGEBY ACCOUNT = 4
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.
XDIM_FILTER brings all members when the specified condition is met. This keyword returns only base
members.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
256 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
Example
*XDIM_MEMBERSET RptCurrency = LC
*WHEN P_ACCT
*IS CE0004220
*ENDWHEN
*COMMIT
The code in this example writes only FEB records for CE0004220.
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.
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].[#CE0661000] =
In this example, CE0661000 depends on the first calculation, and this calculation in turn depends on the
calculation of CE0004030.
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.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 257
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
*COMMIT
[P_ACCT].[#CE0661000] =
In this case CE0004030 in the second formula does not have the pound sign (#), because it is a stored
amount read from the model.
Note
Any 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.
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.
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
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
258 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
Another type of implied keywords is available for each nonuserdefined 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%
Example
If, in a model, the category dimension is called SCENARIO, the keyword %CATEGORY_DIM% returns the
word SCENARIO.
● ACCOUNT
● CATEGORY
● TIME
● ENTITY
● INTCO
● CURRENCY
● DATASRC
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 TIME=2006.SEP
*XDIM_MEMBERSET P_ACTIVITY=NONE
*XDIM_MEMBERSET P_DATASRC=UPLOAD
*XDIM_MEMBERSET RPTCURRENCY = LC
The percentage to be increased for the above two accounts is provided by the user.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 259
Note
Additional 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%")
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%)
Note
Read the restriction around Validation when DM prompts are used in your script in OSS note 1334695.
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.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
260 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
1.14.6.2.2.21 TMVL Parameter (Standard only)
Use
This optional parameter returns a time value after taking into consideration an offset value from a given time
period.
Prerequisites
Activities
The format for this parameter is TMVL(offset, base_period). Utilize this parameter following these guidelines:
Note
Nested TMVL parameters such as TMVL(-1, TMVL(-3, 2009.JAN)) ) are not supported.
When 0 is used as offset, no offset will be done for the provided time member.
Example
In 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:
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 261
Category Entity P_ACCT P_Activity P_DataSrc RptCurrency Time SignData
*XDIM_MEMBERSET P_ACTIVITY=NONE
*XDIM_MEMBERSET P_DATASRC=UPLOAD
*XDIM_MEMBERSET RPTCURRENCY = LC
*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:
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.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
262 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
1.14.6.3 US Eliminations as Script Logic (Standard only)
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:
Example
*RUN_PROGRAM US_ELIM
CATEGORY = %C_CATEGORY_SET%
GROUP = %GROUPS_SET%
TID_RA = %TIME_SET%
OTHER = [ENTITY=%ENTITY_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
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
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 263
1.14.6.4 Carry-Forward as Script Logic (Standard only)
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:
Example
*RUN_PROGRAM COPYOPENING
CATEGORY = %C_CATEGORY_SET%
CURRENCY = %GROUPS_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
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
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
264 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
1.14.6.5 Intercompany Booking as Script Logic (Standard
only)
You use this to run Intercompany booking as well as difference posting.
Activities
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:
Example
*RUN_PROGRAM ICBOOKING
CATEGORY = %CATEGORY_SET%
GROUP = %CATEGORY_SET%
TID_RA = %TIME_SET%
OTHER = [ENTITY=%ENTITY_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
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 265
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
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:
You must also set up the following list of attributes for relevant dimensions in addition to the required
attributes:
Dimension Attribute
ACCOUNT RATETYPE
IS_CONVERTED (Y, G, or N)
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
266 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
Dimension Attribute
TIMEID YEAR
PERIOD
TIMEID
MONTHNUM
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 cube, 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 cube, the attribute needs to exist in the
flowtype dimension to enable currency conversion.
Example
*RUN_PROGRAM CURR_CONVERSION
CATEGORY = %C_Category_SET%
GROUP = %GROUPS_SET%
TID_RA = %TIME_SET%
OTHER = [ENTITY=%ENTITY_SET%]
RATEENTITY = Global
*ENDRUN_PROGRAM
Note
Global 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.
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.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 267
Related Information
Activities
Example
*RUN_PROGRAM CALC_ACCOUNT
CATEGORY = %CATEGORY_SET%
CURRENCY = %CURRENCY_SET%
TID_RA = %TIME_SET%
CALC=A
*ENDRUN_PROGRAM
Note
If there is no other scope against which you need to run the program, delete the OTHER line in the script.
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.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
268 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
Related Information
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
When you create or modify a model, you can add business rules to it. You can add the following types of
business rules:
● 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
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.
You can edit the list of available rules for a selected type of business rule within a model. You can then edit a
specific rule in the list. You can use standard Microsoft Excel functionality to perform the following actions:
You can look up members within the cells of a rule by clicking the Lookup icon that appears when you place the
cursor within that cell.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 269
Validating Business Rules
You can verify the detail records of a business rule after modifying it by clicking Validate in the <Rule Name>
page. A message appears displaying a successful status or any errors encountered.
Activities
Related Information
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
270 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
1.14.6.8.1 Account-based Calculation Rule (Standard only)
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:
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.
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
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.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 271
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.
● 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, whose values are valid accounts in
the rate model.
● 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
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
272 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
○ 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 and converts all accounts with a blank rate type with a factor 1.
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:
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 273
Whatever mode the currency translation runs in, the following conditions must be satisfied:
○ L (local currency)
○ R (reporting currency)
○ G (group, for compati
bility on migrated mod
els only)
○ G (Group)
○ N (Non-Group, used for
data input)
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
274 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
Model Dimension Property Description
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 275
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:
● I (input)
● M (manual adjustment)
● L ( audit level, for consolidation
only)
● A (eliminations and adjustments)
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.
To run currency translation in group mode, beside the same requirement as reporting currency mode, the
following additional conditions are mandatory:
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
276 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
○ 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_CONVERSION
CATEGORY = %C_CATEGORY_SET%
GROUP= %GROUPS_SET%
TID_RA = %TIME_SET%
RATEENTITY = GLOBAL
......
*ENDRUN_PROGRAM
Pay 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 of the corresponding base member during the same
year.
● Example for DAY members:
2016.Q1 Q1 90 2016.TOTAL
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 277
ID Period TIMEID MONTHNUM PARENTH1
● In addition, the following is an example of a time dimension for Jan 12th 2016:
Related Information
The Intercompany booking function supports the overall Intercompany reconciliation process.
Prerequisites
● Five additional data sources must be defined for Data Source Dimension in IC_ORIGIN attribute. These
data source members are used for IC Data Calculation, which is the pre-step for intercompany bookings:
○ I – Source data source to be used in IC Data
○ D1 – My Debit Accounts
○ D2 – Their Debit Accounts
○ C1 – Their Credit
○ C2 – My Credit
● The appropriate business rule table must be set up.
● The Account dimension must define a dedicated hierarchy to include all accounts for Intercompany
booking.
This configuration allows intercompany details to be entered for any account and supports an automatic
elimination-by-level for all desired accounts.
Note
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
278 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
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 in generating
the entries to match the Intercompany balances and declarations.
The consolidation engine supports a mechanism to perform the matching of the intercompany declarations
among the entities of a group. This mechanism is split into two independent procedures as follows:
● ICDATA: This procedure copies 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 against everything
else that has been declared against it, without the need to assign to each owner read permision 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 either one with the greater booking value.
By configuring the “Maximum Booking” amount, you can set up the maximum threshold for automatic
booking. Any differences larger 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
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.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 279
● Category_for_ope, Opening_year, Opening_period in the Category dimension
Carry-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 dimension
Currently 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
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
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
280 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
● 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.
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.
US eliminations are normally 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:
● 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).
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 281
● 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 (Standard only) [page 263]
and Execute Consolidation Task (Standard only) [page 185].
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
● Enter any ownership changes into the ownership cube, 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.
Note
Ownership 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 cube.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
282 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
You must have the following items in your environment before performing the eliminations and adjustments:
● Ownership Model
Stores 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 dimension
Provides the ability to store consolidated results by the group to which they relate
● Currency dimension
Provides the ability to store consolidated results in the currencies specified for each group
Note
You can use a common dimension for both currency and group ONLY in models migrated from version
7.5. In SAP BusinessObjects Planning and Consolidation 10.0 and 10.1, you must use two separate
dimensions - one for group and one for currency.
● Method-based multipliers
Define the formulas to use in calculating the amounts to post
● Eliminations and Adjustments rules
Define 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.)
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 283
● 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 (Standard only) [page 288].
● 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.
● Other Dimension Filter: A string in this field indicates filters or special restrictions on other dimensions. For
example, if you have a userdefined 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
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
284 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
1.14.6.8.6.1 Method-based Multipliers and Consolidation
Methods (Standard only)
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
● Method-based multipliers
● Consolidation methods
Global Definitions
You can add a new Global Definition in Planning and Consolidation Administration by:
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.
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 can
not be assigned to any entity
Example
Leaving, Equity, Proportional, Global, Holding.
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.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 285
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.
Example
RULE01
Example
Equity, 100% Minority part, Dividends, Stock Holder Equities, Inter
company elimination
● 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 ap
plies.
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 multi
plier applies.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
286 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
Field Name Description
ALL Formula An expression that represents the percentage (or formula) to apply to
the Destination All account property from the Eliminations and Adjust
ments business rule.
Example
[POWN], [PCTRL], [POWN]
Example
[PPOWN], [PPVOTE]
Example
[I_POWN]
● The syntax of the prior value can be combined with the syntax of
the INTCO value.
Example
[I_PPOWN]
Note
The calculation of POWN by both direct share method and group
share method is supported.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 287
Field Name Description
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 Adjust
ments 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.
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:
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.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
288 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
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.
Procedure
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
When you create or modify a model, you can add business rules to it. You can add the following types of
business rules:
● Account-based calculation
● Currency translation
● Intercompany booking
● Carry-forward processing to initialize beginning balances when a new fiscal cycle starts
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 289
● Eliminations and adjustments when generating consolidation entries for a group of entities, such as
eliminations, adjustments, reclassifications, and minority calculations
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.
You can edit the list of available rules for a selected type of business rule within a model. You can then edit a
specific rule in the list. You can use standard Microsoft Excel functionality to perform the following actions:
You can look up members within the cells of a rule by clicking the Lookup icon that appears when you place the
cursor within that cell.
You can verify the detail records of a business rule after modifying it by clicking Validate in the <Rule Name>
page. A message appears displaying a successful status or any errors encountered.
Note
Currently you can choose text nodes and external nodes for source members of dimension type account
(A), category (C), audit (D), flow (S), but not for destination members of dimension type account (A),
category (C), audit (D), flow (S), unless the source and destination dimensions share exactly the same
hierarchy.
Activities
In SAP Business Planning and Consolidation, all business rules need to be run through Consolidation Monitor.
To do this, you need to first define a task sequence after setting up all the business rules and then trigger these
tasks from Consolidation Monitor.
Related Information
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
290 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
1.14.6.9.1 Account-based Calculation Rule (Embedded only)
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. You may apply this rule for cash flow reporting.
Features
The following dimensions can be specified in order to define source and target members in the calculation:
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.
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 from the Consolidation Monitor in the Consolidation Central area.
Prerequisites
Currency translation applies to consolidation models to which a corresponding EXCHANGE RATE InfoProvider
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.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 291
The following list provides a summary of the environment requirements to support currency translation:
● The consolidation model must be assigned an EXCHANGE RATE InfoProvider where exchange rates are
stored.
● The CONSOLIDATION InfoProvider itself must include a currency type dimension and a Group dimension.
● The Currency (R type) dimension must map to 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.
● For Consolidation 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 valid Reporting currencies defined in the currency dimension of
the EXCHANGE RATE InfoProvider.
● The Account (A type) dimension must include the property RATETYPE, whose values are valid accounts in
the EXCHANGE RATE InfoProvider.
● The Time (T type) dimension must use 0FISCPER.
● The Audit dimension must include the following properties for currency translation:
○ DATASRC_TYP, whose values include the following:
○ I – Input
○ M – Manual Adjustment
○ A – Eliminations and Adjustments
○ L – Audit level (use only for Elimination and Adjustment)
○ 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
You also need to include the following properties if they are mentioned in other business rules:
○ COPEOPENING, whose values include the following:
○ N (or blank) – These members are ignored in the copy opening.
○ Y – These members will perform copy opening if it is also specified in the business rule.
○ IS_CONSL, whose values include the following:
○ N (or blank) – These members are ignored in the Elimination and Adjustment.
○ Y – These members will perform Elimination and Adjustment if it is also specified in the business
rule.
○ OPENING_DATASRC, the property enables you to post data on a specific data source when running the
Carry- Forward rules.
● 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 EXCHANGE RATE InfoProvider must include the
property MD, whose values are M for multiply rates or D for divide rates.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
292 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
The default translation reads all values in local currency where currency = LC, applies the correct exchange rate
according to the applicable EXCHANGE RATE InfoProvider, 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.
Note
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.
Note
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 and the ability to distinguish between Multiply currencies
and Divide currencies.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 293
● Some dimensions, such as Account, Entity, and Currency, must contain appropriate properties as noted in
the following table:
○ L (local currency)
○ R (reporting currency)
○ G (group, for compati
bility on migrated mod
els only)
○ G (Group)
○ N (Non-Group, used for
data input)
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
294 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
The following properties in the Audit and Flow dimensions are mandatory:
● I (input)
● M (manual adjustment)
● L ( audit level, for consolidation
only)
● A (eliminations and adjustments)
● 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 Group 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 Group,
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.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 295
1.14.6.9.3 Intercompany Booking Rule (Embedded only)
The Intercompany booking function supports the overall Intercompany reconciliation process.
Prerequisites
● Five additional data sources must be defined for Data Source Dimension in IC_ORIGIN attribute. These
data source members will be used for IC Data Calculation, which is the pre-step for intercompany
bookings:
○ I – Source data source to be used in IC Data
○ D1 – My Debit Accounts
○ D2 – Their Debit Accounts
○ C1 – Their Credit
○ C2 – My Credit
● The appropriate business rule table must be set up.
● 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 it also supports an
automatic elimination-by-level for all desired accounts.
Note
Features
The consolidation engine supports a mechanism to perform the matching of the inter-company 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 inter-
company account. Essentially 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 its
declaration against what the rest of the world has declared against him, without the need to assign to each
owner read permits into other entities.
● Intercompany Booking: this procedure can be used to automatically generate the bookings that will 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 either 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 will be kept for manual adjustment later.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
296 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
Intercompany bookings are executed from the Consolidation Monitor in the Consolidation Central area.
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 are executed from the Consolidation Monitor in the Consolidation Central area.
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 dimension
Carry-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 dimension
Currently 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.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 297
1.14.6.9.5 US Eliminations Rule (Embedded only)
US eliminations functionality addresses the posting of intercompany US eliminations in scenarios where a full
legal consolidation is not required.
Prerequisites
The following are required to perform intercompany eliminations within the Consolidation InfoProvider of a
model:
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 is not required. When utilizing a consolidation model that is shared by the US Eliminations rule
and the Eliminations and Adjustments rule - which is generally called matrix consolidation - a different set of
Entity and Interco dimensions needs to be maintained for the US Eliminations rule. Therefore, two new
types of dimensions are available for US Eliminations: Entity for matrix (P type) and Intercompany for matrix (Q
type).
Except in the case of matrix consolidation, US eliminations normally use consolidation models different from
the models used by legal consolidation.
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.
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:
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
298 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
Dimension Property Length in Characters Content
● Scans all base level non-elimination entities, specifically entities having the property ELIM <> Y.
● When the model has a currency dimension, the default elimination logic restricts its action to all reporting
currencies only, which are 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, specifically accounts having the property
ELIMACC<>blank, into the desired plug account, which is 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 by 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 the immediate descendants of the common parent for a valid elimination
entity, which is 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 of the entity dimension.
This can be modified so that the system performs the elimination in all hierarchies that exist 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.
Related Information
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 299
1.14.6.9.6 Eliminations and Adjustments Rule for Legal
Consolidation (Embedded only)
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 from the Consolidation Monitor in the Consolidation Central area.
Prerequisites
● 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.
Note
Ownership 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 cube.
You must have the following items in your consolidation model before performing the eliminations and
adjustments:
● OWNERSHIP InfoProvider
Stores 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 dimension
Provides the ability to store consolidated results by the group to which they relate
● Currency dimension
Provides the ability to store consolidated results in the currencies specified for each group
● Methods and Method-based Multipliers and Consolidation
Define the formulas to use in calculating the amounts to post
● Eliminations and Adjustments rules
Define 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.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
300 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
Eliminations and adjustments rules are applicable only to a legal consolidation model to which you attach a
corresponding ownership InfoProvider.
When eliminations and adjustments rules are executed for a given group, the system performs the following:
● Reads from the ownership InfoProvider 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
○ 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 (Embedded only) [page 305].
● 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.
● Other Dimension Filter: A string in this field indicates filters or special restrictions on other dimensions. For
example, if you have a userdefined 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.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 301
1.14.6.9.6.1 Method-based Multipliers and Consolidation
Methods (Embedded only)
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
● Methods
● Method-based multipliers
Global Definitions
You can add a new Global Definition in Planning and Consolidation Administration by:
Once defined, the rule can be used in any consolidation model in the environment.
The Consolidation Method list describes the accounting methods available for consolidating each entity.
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 can
not be assigned to any entity
Example
Leaving, Equity, Proportional, Global, Holding.
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.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
302 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
The following fields can be defined:
Example
RULE01
Example
Equity, 100% Minority part, Dividends, Stock Holder Equities, Inter
company elimination
● 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 ap
plies.
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 multi
plier applies.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 303
Field Name Description
ALL Formula An expression that represents the percentage (or formula) to apply to
the Destination All account property from the Eliminations and Adjust
ments business rule.
Example
[POWN], [PCTRL], [POWN]
Example
[PPOWN], [PPVOTE]
Example
[I_POWN]
● The syntax of the prior value can be combined with the syntax of
the INTCO value.
Example
[I_PPOWN]
Note
The calculation of POWN by both direct share method and group
share method is supported.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
304 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
Field Name Description
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 Adjust
ments 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.
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:
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.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 305
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.
Procedure
1.14.6.10 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.
The main steps to follow when setting up your controls are as follows:
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
306 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
Control steps
Business Planning and Con 1. Associate a level to each entity in the entity
solidation Administration dimension
7. Monitor controls
Note
An 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 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, which is given as follows.
● In a standard configuration of Business Planning and Consolidation, you can go to Security Task
Profile to create and assign corresponding tasks to teams or users.
● In an embedded configuration of the product, you can follow the steps in the topic “Authorization for
Performing Consolidation Tasks” in the Security Guide of this release to assign relevant authorization
objects to target users.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 307
Features
Enable controls
Controls can be enabled or disabled at the model level in Planning and Consolidation Administration. In an
embedded configuration of Business Planning and Consolidation, controls can be enabled only in a
consolidation type model.
● In a standard model, make sure the Entity dimension contains two properties: Control Level and
CTRL_CURRENCY_NOT_LC (Bypass LC in Ctrls).
● In an embedded model, make sure two properties of the Entity dimension, namely Control Level and
CTRL_CURRENCY_NOT_LC (Bypass LC in Ctrls) are mapped to corresponding InfoObjects in
Business Warehouse. For detailed information, refer to the topic “Map Dimension Properties” in the
Business Warehouse application help.
Note
To 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 309].
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 319].
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.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
308 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
Activities
● To enable controls
1. 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 319].
Prerequisites
For an embedded model, an administrator has given you the Edit Controls Manager right.
In a standard model, 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.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 309
To create controls in SAP Business Planning and Consolidation, do the following:
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.
● ID
● Description
● Rule Type
● (Control) Type
● Execution Level
● Equation Type
● Control Level
● Breakdown Dimensions
● Absolute Value
● Calculate on YTD (Embedded only)
● Tolerance Threshold
● Expressions
● Documents (Standard only)
ID
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
● 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
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
310 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
Select one or more types of data to which this control pertains:
● Loaded data
● Translated data
● 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.
● 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 (Standard only) [page 25]. 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 (Standard only) [page 26].
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.
Example
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.
Note
Any 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.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 311
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.
Example
Result 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.
As data stored in an embedded configuration of the system is supposed to be periodic data, this option
indicates the type of data on which the control runs. When the option is checked, the control runs on year-to-
date data when YTD aggregation is performed during the execution of the control. When unchecked, controls
are run on periodic data.
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
Amount x: 1,000,000
Amount y: 1,000,000.5
Difference: 0.5
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
312 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
x<y < Tolerance Error or warning Tolerance entered: 1
Amount x: 1,000,000
Amount y: 1,000,000.5
Difference: 0.5
Amount x: 1,000,000
Amount y: 1,000,000.5
Difference: 0.5
Expressions
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 313
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 (defined in the upper panel) is compared to
zero.
Documents (Standard only)
In a standard configuration of the system, Microsoft Excel input schedules and reports, as well as input forms
and web reports 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.
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.
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.
● ID
A control set must be identified with a unique code. This field is mandatory.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
314 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
● Description
A control set should clearly describe the type of verifications to be performed.
Related Information
Prerequisites
To edit controls in Planning and Consolidation Administration, you must have the Edit Controls Manager
right. In a standard configuration of the product, you can go to Security Task Profile to create and assign
corresponding tasks to teams or users. In an embedded configuration, you can follow the steps in
“Authorization for Performing Consolidation Tasks” in the Security Guide to assign relevant authorization
objects to target users.
Context
Procedure
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 315
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
Prerequisites
Context
Procedure
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
316 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
6. Save the control set.
Related Information
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
The copied control set contains the same controls as the original control set. You can then modify the
control set as needed.
Related Information
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 317
Display or Modify a Control Set [page 316]
Delete a Control Set [page 318]
Assign a Control Set [page 319]
Additional Actions Involving Control Sets [page 319]
Prerequisites
Context
Procedure
Related Information
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
318 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
1.14.6.10.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 .
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
You can display category/time pair assignments for control sets, display additional periods or categories, and
sort and move columns.
There are two ways to display the category/time pair assignments for control sets:
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 319
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 Time
You 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.
Note
The 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.
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.
Note
You 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
Use
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
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
320 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
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. It allows the
user to see only the tasks relevant for that user, given his or her role and data access privileges.
Prerequisite
In Business Planning and Consolidation in a standard configuration, you must have the Manage BPFs task
profile assigned to you in order to manage business process flows.
In Business Planning and Consolidation in an embedded configuration, you must have the BPF authorization
object RSBPC_BBPF assigned to you in order to manage business process flows. For detailed information about
how to assign the authorization object, refer to the topic “Authorization Objects” in the Security Guide available
on the SAP Help Portal.
Features
Create new process templates You can create a new process template on which to base
processes, copy existing process templates, and modify ex
isting templates. For more information, see Creating New
Process Templates [page 322].
Validate process templates When you create a new process template, the system auto
matically 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.
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.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 321
Function More Information
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.
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 tem
plate, select a template in this window and click View in the
left-right corner.
Archive process templates (standard only) 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.
Integrate external workflows with BPFs You can integrate external workflows with BPC BPF proc
esses to accommodate complicated planning processes. For
more information, see External Process Integration [page
342].
Use
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. In
Business Planning and Consolidation in a standard configuration, you must also enter the controlling
model. See Process Settings [page 323].
4. On the Activities tab add activities to represent the flow of the business process. See Activities [page 325].
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 335].
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
322 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
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.
Note
Validation 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.
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 339].
Use
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.
Features
The following table describes the information you need to complete the setup process in the Process Settings
tab:
Item Description
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 323
Item Description
Model (standard only) The model governs both identity dimensions, including the
time dimension for process instances and the available di
mensions 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.
Note
In Business Planning and Consolidation in a standard
configuration the 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 (embedded When this checkbox is selected, you can reopen the current
activity if you are the performer or reviewer of the activity.
only)
Otherwise, 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, refer to Criteria for
Reopening Activities [page 332].
Check only the current step when reopening (standard only) By default you must be the performer or reviewer of both the
current activity and the next open activity to reopen the cur
rent activity.
You can use navigation attributes in an embedded configuration of Business Planning and Consolidation, which
allows you to select certain attributes as identifying dimensions or driving dimensions in a process template.
When you define an attribute as a navigation attribute in an InfoObject, the navigation attribute displays in the
corresponding InfoProvider. Then, when you enable the checkbox in the On/Off column of the navigation
attribute, you can use the attribute in the Business Planning and Consolidation web client. For detailed
information about using navigation attributes, refers to the chapter “Attribute” available in SAP NetWeaver 7.5
help page on help portal.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
324 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
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 325].
1.14.7.1.2 Activities
Use
You can create activities that form part of a process. For guidelines on defining activities, see Criteria for
Defining Activities [page 328].
Features
The following table summarizes the information that you need to supply for each activity:
Item Description
General
Opening Criteria Select the appropriate radio button to open by All activity
contexts or Matched activity contexts.
Driving Dimension
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 325
Item Description
Note
In a standard configuration of Business Planning and
Consolidation, this dimension must have a defined Re
viewer property.
Map Driver to (embedded only) Create a mapping between the driving dimension and an in
ternal dimension. For more information, see Internal and Ex
ternal Driving Dimensions (Embedded only) [page 335].
Activity Performer
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
326 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
Item Description
Performer Select the property that defines the performer for each
member.
Note
In an embedded configuration of Business Planning and
Consolidation, a property of a dimension is an attribute
of a characteristic in BW. You can maintain BW charac
teristics in BW modeling tools. For more information,
see the BW documentation that is available at http://
help.sap.com/nw75.
Activity Reviewer
Require Reviewer If required, select this checkbox and select a property that
defines the reviewer for each member.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 327
Item Description
Reviewer You select the reviewer in the same way as selecting a per
former, but you can select a different property to determine
the reviewer users.
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 Dead
lines for Activities [page 334].
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 335].
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 334].
Use
You define activities for a BPF template in the Administration screen. For more information, see Activities [page
325].
● Activities have defined criteria to control the activity context, opening of activities, review criteria, and
reopening of activities if required.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
328 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
● In Business Planning and Consolidation in a standard configuration 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.
● 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 performers 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.
Use
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.
Note
In Business Planning and Consolidation in a standard configuration the 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 (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, it defaults to
Single Member, which just includes the selected node.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 329
Note
Dependent members are all entries one level below the parent node.
Base members are all entries at the lowest level below the parent node.
Note
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 H1
2. Children of member M2 in H2
3. 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. In Business Planning and Consolidation in a standard configuration, select the property of the
dimension, which contains valid user IDs for the owner. For more information, see Owner Property
(Standard only) [page 128].
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.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
330 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
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.
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.
Example
You must complete all tasks for all activity contexts in activity 1 before activity 2 opens:
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.
Example
The 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:
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 331
Activity Driving Dimension Activity Context Status
Use
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.
Features
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 instance owner you can reopen an activity, regardless of performer 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.
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:
● In Business Planning and Consolidation in an embedded configuration, select the option Check only the
current step when reopening in the Process Settings page when creating or modifying a process template.
● In Business Planning and Consolidation in a standard configuration, 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.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
332 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
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.
Choosing All Activity Contexts as the reopening criterion for an activity introduces the following constraints:
Example
When you reopen activity 1, all activity contexts for activity 2 change to status Delayed:
Driving Dimen
Activity sion Activity Context Performer Reviewer Status
1 Entity US A B Reopen
2 Entity US A B Delayed
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.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 333
● 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.
Example
When 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:
Driving Dimen
Activity sion Activity Context Performer Reviewer Status
1 Entity US A B Complete
2 Entity US A B Complete
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.
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.
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.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
334 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
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.
Note
You 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 13].
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.
Business Planning and Consolidation reuses the InfoObjects that are delivered with SAP Business Warehouse.
Some of these InfoObjects may not have the performer and reviewer properties defined, therefore they
cannot be used directly for driving dimensions. We recommend that you use the following workaround:
1. Create a new InfoObject that has the same structure as the InfoObject delivered by SAP.
2. Maintain the performer and reviewer properties in the newly created InfoObject.
3. When choosing the driving dimension, choose the External Dimensions radio button to display the
dimensions of your manually created InfoObject.
4. Choose the required driving dimension.
5. The Map Driver to dropdown list displays the InfoObjects delivered by SAP. Select the dimension to which
you want to map the driving dimension of the activity.
After you perform these steps, you can select the required performers and reviewers for the activity.
Use
You can assign actions to activities. You can also assign review actions to activities, which require the approval
of a reviewer.
Prerequisites
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 335
Procedure
1. Choose the Create button in the Workspaces field of the Activities tab.
2. Add hyperlinks to target actions and configure them according to the desired outcome.
Note that in the embedded configuration of Business Planning and Consolidation, you can add hyperlinks
only to perform actions of existing elements, such as opening reports or input forms. Therefore, you must
make sure these elements already exist before you start defining actions.
The embedded configuration of Business Planning and Consolidation supports the following types of
hyperlinks:
○ 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.
○ Microsoft Excel - define a hyperlink to an EPM Add-in report or input form. If there are variables set in
the report/input form, you can assign values to them.
○ Library and Document - define a hyperlink to a report or input form. If there are variables set in the
report/input form, you can assign values to them.
○ Analysis Office:
○ Define a hyperlink to a BW query. If the query has variables set in it, you can assign values to these
variables.
○ Define a hyperlink to an AO workbook. If the workbook contains a query that has variables set in it,
you can assign values to these variables. If the workbook contains queries with the same variables,
you can assign values to these variables for each query. You can also assign values to these
variables once for all by selecting Merge Variables.
○ 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 338].
○ External Resources - you can open a URL or an external web-based application.
For more information about external web-based applications, see Configuring Links to External Web
Applications [page 337] (embedded only).
3. Choose Stop Editing and then Save to save your changes.
Repeat for all the actions to be associated with each activity in the process template.
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
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
336 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
1.14.7.1.3.1 Configuring Links to External Web Applications
(Embedded only)
You can use this procedure to configure a link to an external web-based application from a BPF instance (for
example, a Web Dynpro report).
Note: In version 10.1 SP05, the term "semantic object” was changed to “role”.
You must first configure the web-based application that you want to use as a role in User Interface Add-On for
SAP NetWeaver.
For more information, see the documentation of User Interface Add-On for SAP NetWeaver, available on the
SAP Help Portal.
Maintaining Links
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 337
3. Select the required role and choose Edit.
4. Choose Add and enter the new link for the role.
You can view the links that are already defined for the role by choosing Display Existing Links.
5. Choose Maintain Parameters to create new parameters or to change the existing ones.
6. If you want to remove a link and all its parameters, select that link and choose Delete.
When configuring workspaces for the performer and the reviewer in BPF, you can add hyperlinks to the web-
applications that you configured with the procedures above.
1. When configuring a workspace, from the Target Action list, select External Resources.
2. From the second-level dropdown list that appears, select Open External Web-based Application.
3. From the Target Object list that appears, select the required role.
4. Enter values for the parameters of the target object.
The activity performer will be able to click the hyperlink to open the target action in the web-based application
with the corresponding parameters to perform any assigned tasks.
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
In addition, 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
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
338 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
1.14.7.2 Creating Process Instances
Use
An authorized user can create a process in the Administration screen. You can create up to 24 processes for
each process template.
Generating a process creates all required activities and activity contexts. Once generated, the process is no
longer associated with the template. Any changes to the template definition do not impact previously
generated processes.
Prerequisites
Procedure
In the Process Instances screen, choose New. This opens the New Process Instance wizard that has the
following steps:
Note
Any 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.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 339
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
Change Assignments The Change Assignments wizard allows you to change the
process owner and an activity performer or reviewer.
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.
When a business process flow activity contains only one action, the email notification contains a link to bring
the user directly to the activity, which supports direct navigation to external URL-based applications including
transactions, Fiori, and ABAP Web Dynpro applications.
To turn on and turn off e-mail notifications, administrators can perform the following steps:
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
340 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
○ If you are configuring Business Planning and Consolidation in a standard configuration, execute the
UJB_MAINTAIN_EMAIL_TMPL program.
○ If you are configuring Business Planning and Consolidation in an embedded configuration, execute the
RSBPCB_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.
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 for the standard configuration or Customizing Email Template for the embedded configuration 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.
Administrators can change the Smart Form body by using the Smart Form Editor.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 341
Variable Description
Note
You 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
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
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.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
342 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
Note
Creating 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.
Steps for integrating workflows that are outside of Business Planning and Consolidation with the system's
business process flow functionality.
Procedure
A performer can reopen an activity in a BPF. When the reopened activity is submitted, a new external
workflow is initiated.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 343
1.14.8 Work Status Setup
Use
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.
In Business Planning and Consolidation, 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. In a standard
configuration, the owner dimension has an OWNER property to define the work status owner who can change
work statuses. In an embedded configuration, you can predefine an attribute of the owner InfoObject as the
owner property on the Business Warehouse backend to maintain work status owners. An InfoObject can be
used as an owner dimension only when some criteria are met. Refer to the section Owner Dimension and
Hierarchy (embedded only) below for detailed information.
● 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 (standard only) - 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
You can either specify an attribute of the owner dimension as Owner (the value should be a user ID) or as Team
(the value should be a team's ID); you can also specify both.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
344 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
The user(s) derived from the owner attribute, or the team member(s) derived from the team attributes, or from
both attributes, are considered owners of the current member ID of the owner dimension.
● 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
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
● Owner - The owner of the specific member ID
● Manager - The owner of the parent to the specific member ID
Owner/Manager Determination
Controlled By Rule
● 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.
● 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
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 345
○ 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.
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 reports or input forms
● Comments (COM) - Controls data input from posting comments (unstructured data)
● Documents (DOCS) - Controls posting documents with model context to the Document view (unstructured
data)
● You can set work status for a node member which is an external dimension (SAP BW characteristic)
member. The owner is derived by the same property that is defined in the owner dimension. If the owner
cannot be derived, the work status cannot be set.
● You can set work status for a member whose parent node is an external dimension member. The manager
of the current owner is derived as follows:
1. The owner of the parent node (external dimension) is derived from the same property as defined in the
owner dimension and it becomes the manager of the current member.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
346 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
2. If an owner of the parent node cannot be derived (the parent node does not have the same property, or
the property does not have a valid value), the system checks one level up the hierarchy, until an owner
is found.
3. If the system cannot derive an owner of the parent node, the owner of the current member also
becomes a manager.
Note
Work status cannot be set on a text node. Text nodes are skipped when searching for an owner.
Work statuses in Business Planning and Consolidation in a standard configuration are defined for the entire
environment, not per model.
Work statuses in Business Planning and Consolidation in an embedded configuration are defined for a specific
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). In Business Planning and Consolidation in a standard
configuration, you can change the method of update for this state, but not the order or the Controlled by value.
In Business Planning and Consolidation in an embedded configuration you cannot change the Controlled by
value. You can change the text description.
In Business Planning and Consolidation in a standard configuration, 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 in Business Planning and Consolidation in a
standard configuration, the system deletes all locks for all models in the environment; in an embedded
configuration, the system deletes all locks for the model to which the work status belongs. 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.
Note that in this section the term member denotes the members of the owner dimension.
● 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. NetWeaver does not support top-down.
● 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.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 347
● 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.
● 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.
● When applying rules, if the model encounters any error, it rejects the entire user request. In this case, no
records are updated.
Work status supports between 1 and 14 locking dimensions, including the owner dimension. The default
number is 5.
To change the number of locking dimensions, run transaction RSBPC_ADMIN, and change the value of the
BPC_WS_DIM_COUNT property.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
348 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
If an administrative user select the Set Work State by InfoProvider option, other users can then choose to
change the work status by individual InfoProvider when they do reporting or planning jobs. In this case, when
the work status of that InfoProvider is changed, the other InfoProviders will not be affected.
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.
In Business Planning and Consolidation in a standard configuration, go to the Administration screen and under
the Features section, choose Work Status New .
In Business Planning and Consolidation in an embedded configuration, go to the Administration screen and
under the Work Status section, choose Work Status Configuration. After that select the model, whose work
status you want to configure.
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.
In Business Planning and Consolidation in an embedded configuration, select the Set Work State by
InfoProvider checkbox, so that only a given provider is affected by the work status change.
In Business Planning and Consolidation in a standard configuration, 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
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 349
1.14.8.1 Work Status Example (Standard only)
Use
CATEGORY Yes
ENTITY Owner
P_ACCT No
P_ACTIVITY No
P_DATASRC Yes
RPTCURRENCY No
TIME Yes
Entities structure
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
350 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
ID CURRENCY DESCRIPTION OWNER PARENTH1
L1 EU Top TESTUSER_ALL
Examples
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.
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.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 351
3. You cannot update the data after the lock is set, as this status locks out manual data entry.
Controlled By Rule
Note
The owner of a parent is not its own manager. The only exception to this is the top member of the hierarchy.
Bottom Up Rule
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.
● Assume all children of LD1 are set to Approve for 2017.Q1 (JAN, FEB, MAR).
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
352 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
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.
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:
When using the embedded configuration of Business Planning and Consolidation, users must be granted
corresponding authorization objects on the Business Warehouse side to perform these tasks. For detailed
information, refer to the topic “Authorization for Performing Consolidation Tasks (Embedded only)” in the
Security Guide.
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
● 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.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 353
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.
○ 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.
Note
If 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 (cube 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 Rules
Define translation information for the dimensions used in the reopen tasks. For more information, see
Journal Reopen Rules [page 355].
Activities
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
354 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
Related Information
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:
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 drop
down list above the table.
<Source dimension members> One or more columns that were selected during the tem
plate creation.
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 tem
plate creation.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 355
Activities
Related Information
Features
Activities
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
356 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
1.14.9.2 Journal Security (Standard only)
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.
Activities
Note
If 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
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 357
Delete All Journal Entries from Model [page 358]
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.
Caution
Although 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
Activities
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.
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.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
358 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
Example
You might want only some account members used for journal entries, regardless of whether the users have
access to other members.
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 EPM solutions, add-in 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 EPM add-in 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 EPM add-in 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.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 359
1.14.9.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
When implementing a new BAdI, a filter must be set with the following parameters:
● Appset_id: Model ID
● Application_id: Environment
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
Method CALCULATE_AMOUNTS:
Caution
When 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.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
360 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
Exception Description
Data Types
UJJ_T_BADI_CA_JOURNAL
UJJ_S_BADI_CA_JOURNAL
USERP UJ_USER_ID The ID of the user who has posted the journal
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 361
Field Type Description
UJJ_T_BADI_CA_AMOUNT
UJJ_S_BADI_CA_AMOUNT
UJJ_T_KEYMEM
Table of UJJ_S_KEYMEM.
UJJ_S_KEYMEM
UJJ_T_BADI_CA_JOURNAL_AMOUNTS
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
362 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
UJJ_S_BADI_CA_JOURNAL_AMOUNTS
Use
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
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 363
1.14.11 Drill-Through Setup (Standard only)
Use
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 Business Planning and
Consolidation Security Guide for more information.
Features
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.
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 userdefined value, you can hard code a value or use %CurrentUser% or
%CurrentDate%. If you specify a userdefined value in the mapping, when the user performs a drill-through in
a report, the parameter value is based on the userspecified value.
Note
The 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").
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
364 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
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:
Note
The 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
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 userdefined values.
Example
You can specify http://www.google.com/search? as the URL and q, which is a known Google
parameter.
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
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
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 365
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
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.
Use
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.
1.14.13 Auditing
Use
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
366 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
Features
You can perform data auditing to track changes to transactional data at the InfoProvider level.
More Information
Use
In Business Planning and Consolidation in a standard configuration this function tracks changes to
transactional data at the model level, such as when and by whom records were changed within a model.
In Business Planning and Consolidation in an embedded configuration this function tracks changes to
transactional data at the InfoProvider level, such as when and by whom records were changed within an
InfoProvider.
For each model within an environment, you select a category and one or more of the following tasks to audit:
● EPM Add-in
● Data Manager Import
● Data Manager Clear
● Script Logic Execution
● Web Report Input
● Journal Input
● Business Rules Execution
● Ownership
● FIM Import
When selecting the tasks to audit for a category within a model, you can indicate whether you want to retain the
logs of the data audits indefinitely or for a specific number of days. Business Planning and Consolidation does
not delete the logs; rather, it archives them after the number of days you indicate.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 367
Activities
Note
Before you can set data auditing in Business Planning and Consolidation in an embedded configuration,
the InfoProvider(s) must be set to auditable. You can set them as auditable in the BW back-end.
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 78]).
In Business Planning and Consolidation in a standard configuration you can also set up Data Manager
packages to archive data audit information. See the EPM add-in help.
In Business Planning and Consolidation in an embedded configuration you can create a BW Query with audit
characteristics, and create multi-dimensional audit report with the EPM Add-in or with web reporting.
Use
This function tracks administrative and user tasks at the environment level.
Features
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:
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
368 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
● 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 enable activity auditing for the current environment, go to Administration and under the Audit section,
choose the types of activity auditing to enable.
Once the system records an activity, you can run a report that shows activity based on specified criteria (see
Reporting on Administration Activity [page 82]).
You can set up Data Manager packages to archive activity audit information. See the EPM add-in help.
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 EPM solutions, add-in 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
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 369
As long as there is at least one dimension from a model that has time-dependent hierarchy enabled, you can
select a key date reporting and input forms.
● EPM add-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"/>
The configuration file can be found in Microsoft Windows 7 at C:\Program Files (x86)\SAP
BusinessObjects\EPM Add-In\ if the EPM add-in is installed for all users, or at C:\Users\<username>
\AppData\Local\Programs\SAP BusinessObjects\EPM Add-In\ if EPM the add-in is installed for a
single user.
● 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.
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 form.
● For the script logic test transaction UJKT, the key date can be specified in the field PARAM with the format
KEYDATE = yyyymmdd.
Consolidation
Transport
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
370 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
● 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.
All versions of a time-dependent hierarchy can be backed up and restored together with master data.
Prerequisites
To use time-dependent hierarchy functionality, you must have the following software installed:
● Planning and Consolidation for the NetWeaver platform 10.0 SP09 or later
● EPM solutions, add-in for Microsoft Office 10.0 SP13 Patch 1 or later
Procedure
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 371
1.14.15 Parallel Execution (Standard only)
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.
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
PARALLEL_SERVER_GROUP The name of the server group where the dialog sessions
will run.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
372 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
3. Note
You 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:
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.
Important: All of the BAdIs listed in this topic, except for BADI_RSBPCB_SETUSER, apply only to the standard
configuration of Business Planning and Consolidation. BADI_RSBPCB_SETUSER applies to both the embedded
and standard configurations of the application.
● BADI_RSBPCB_SETUSER - Provides the performer and reviewer of a BPF activity. This BAdI applies to both
Business Process Flows and Work Status, and can be used in both the embedded and standard
configurations of the application.
● 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.
● Using the same Business Add-In BADI_UJ_BPF_SUBMIT_LOGIC, if you add a filter IS_COMPLETE and set
it to 'X', you can implement custom logic for the Complete button as well. For details, refer to 2628363 .
Script Logic
● BADI_UJ_CUSTOM_LOGIC - With this BAdI you can implement custom calculation logic. It is triggered from
script logic.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 373
● 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.
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.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
374 PUBLIC SAP Business Planning and Consolidation for SAP S/4HANA
● 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 to Work Status. This BAdI applies to both Business Process Flows and Work Status, and can be
used in both the embedded and standard configurations of the application.
● 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.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
SAP Business Planning and Consolidation for SAP S/4HANA PUBLIC 375
Important Disclaimers and Legal Information
Hyperlinks
Some links are classified by an icon and/or a mouseover text. These links provide additional information.
About the icons:
● Links with the icon : You are entering a Web site that is not hosted by SAP. By using such links, you agree (unless expressly stated otherwise in your
agreements with SAP) to this:
● The content of the linked-to site is not SAP documentation. You may not infer any product claims against SAP based on this information.
● SAP does not agree or disagree with the content on the linked-to site, nor does SAP warrant the availability and correctness. SAP shall not be liable for any
damages caused by the use of such content unless damages have been caused by SAP's gross negligence or willful misconduct.
● Links with the icon : You are leaving the documentation for that particular SAP product or service and are entering a SAP-hosted Web site. By using such
links, you agree that (unless expressly stated otherwise in your agreements with SAP) you may not infer any product claims against SAP based on this
information.
Example Code
Any software coding and/or code snippets are examples. They are not for productive use. The example code is only intended to better explain and visualize the syntax
and phrasing rules. SAP does not warrant the correctness and completeness of the example code. SAP shall not be liable for errors or damages caused by the use of
example code unless damages have been caused by SAP's gross negligence or willful misconduct.
Gender-Related Language
We try not to use genderspecific word forms and formulations. As appropriate for context and readability, SAP may use masculine word forms to refer to all genders.
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
376 PUBLIC Important Disclaimers and Legal Information
Application Help for SAP Business Planning and Consolidation for SAP S/4HANA
Important Disclaimers and Legal Information PUBLIC 377
www.sap.com/contactsap
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.