Create a Control

This topic contains information about creating a control.

Prerequisites

You need to make sure that a value has been specified for the MONTHNUM property in the Time dimension.

Procedure

You create controls in the Controls page of Business Planning and Consolidation Administration.

To create controls in SAP Business Planning and Consolidation, do the following:

  1. Select Start of the navigation pathPlanning and Consolidation Administration  Next navigation step Rules Next navigation step ControlsEnd of the navigation path.

  2. Select the model for which you want to create a control.

  3. Click Open to display the list of existing controls for that model, then click New.

When dimensions are added or removed from the system, control definitions containing a deleted dimension are updated accordingly and are marked as being invalid for change tracking reasons. Impacted control definitions must be verified. If a dimension is removed from a model, all control results are deleted.

If a driving dimension is added to the Work Status definition, control results are deleted as well as existing locks. This new dimension is also removed from the control expression, since driving dimensions cannot be used in control expressions. If a dimension is removed from the Work Status, all control data is cleared and control expressions must be verified accordingly.

The control properties that you can define include:

  • ID

  • Description

  • Rule Type

  • (Control) Type

  • Execution Level

  • Equation Type

  • Control Level

  • Breakdown Dimensions

  • Absolute Value

  • Tolerance Threshold

  • Expressions

  • Documents

ID

A control must be identified with a unique code.

Description

A control description should clearly and concisely describe which verification is being performed and for which reason, and what the accounting, financial, or economic logic is. For example, "Assets = Liabilities".

Rule Type

  • Standard: Choosing this option will use the standard configuration validation rule.

  • Customized: Choosing this option means this rule will use the validation logic implemented in BADI_UJCTRL_RUN_CONTROL.

(Control) Type

You assign one of the following two control types:

  • Blocking: Prevents the user from going to the next work status level until the blocking status is cleared.

  • Warning: Warns the user of noncritical data quality issues. Does not prevent the user from going to the next work status level.

Execution Level

Select one or more types of data to which this control pertains:

  • Loaded data

  • Translated data

  • 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 Information published on SAP site.

Equation Type

You choose the operand for the expression: =, >, <, >=, <=, <>. The operand determines how the two amounts in the expression will be compared.

Control Level

This field is linked to the Control Level property in the entity dimension. A control level is defined for each control, organizing the controls by rank so the relevant data can be verified.

Four control levels are available:

  • Basic: Level 1

  • Standard: Level 2

  • Advanced: Level 3

  • Comprehensive: Level 4

Controls are executed according to the control level associated with the selected entity. See Execute a Control Set. 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.

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

CTRL1 is defined as TOTAL_ASSET = TOTAL_LIABILITIES, breakdown dimension: DATASOURCE with member TOTAL_INPUT specified in the control expression. TOTAL_INPUT is the aggregation of INPUT, INPUT_ADJ1 and INPUT_ADJ2.

When the control is executed, it compares TOTAL_ASSET versus TOTAL_LIABILITIES for both members INPUT, INPUT_ADJ1 and INPUT_ADJ2. As a result, if two members generate an error, the following information is generated:

  • One row appears displaying the aggregated information for the control, without data in any of the columns except for the status, which displays as Failed.

  • Two rows appear for the given control to display the detailed calculations with data for both lines.

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.

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.

Tolerance Threshold

The tolerance threshold is an amount that is compared to the difference between the two amounts (the "control result"). If the control result is less than or equal to the amount defined in the tolerance threshold, then the difference is considered to be insignificant and the control status is considered to be OK.

Example

Expression of control for amounts x and y

Comparison difference/tolerance

Control result

Example

x = y

< Tolerance

Valid

Tolerance entered: 1

Amount x: 1,000,000

Amount y: 1,000,000.5

Difference: 0.5

The difference is less than the tolerance. The two amounts are therefore considered equal.

The control, run to check if the two amounts are equal, is therefore valid.

> Tolerance

Error or warning

   

x < y

< Tolerance

Error or warning

Tolerance entered: 1

Amount x: 1,000,000

Amount y: 1,000,000.5

Difference: 0.5

The difference is less than the tolerance. The two amounts are therefore considered equal.

The control, run to check if x is less than y, is therefore in error.

> Tolerance and x < y

Valid

   

> Tolerance and x > y

Error or warning

   

x > y

< Tolerance

Error or warning

 

> Tolerance and x > y

Valid

   

> Tolerance and x < y

Error or warning

   

x ≤ y

< Tolerance

Valid

Tolerance entered: 1

Amount x: 1,000,000

Amount y: 1,000,000.5

Difference: 0.5

The difference is less than the tolerance. The two amounts are therefore considered equal.

The control, run to check if x is less than or equal to y, is therefore valid.

> Tolerance and x < y

Valid

   

> Tolerance and x > y

Error or warning

   

x ≥ y

< Tolerance

Valid

 

> Tolerance and x > y

Valid

   

> Tolerance and x < y

Error or warning

   

Expressions

The expression is the formula used for identifying the two amounts to be compared. In the Expressions tab, the upper panel contains the formula for identifying the first amount to be compared. All the dimensions must be specified.

When breakdown dimensions are specified, an icon appears in the column header identifying that dimension as a breakdown dimension.

The lower panel contains the formula for identifying the second amount to be compared, which can be from another Category, Time, or Group.

In the Category field you can enter any member from the Category dimension. In the Year Offset field, you can enter an integer preceded by "+" or "-". In the Period field you can enter an integer which is associated to the MONTHNUM property of the Time dimension. For relative periods, "+" or "-" signs can be used; for example, for the previous month you enter "-1".

If the lower panel is left blank, the first member of the expression that was defined in the upper panel is compared to zero.

Documents

Microsoft Excel input schedules and reports, as well as worksheets from Business Planning and Consolidation, can be attached to controls. Later, if you have failed to run a control in Control Monitor and you then choose Open Controls Results, you can directly navigate to the attached document to aid you in problem-solving the issue.

Activate the Execution Level Field

Follow these steps to make the Execution Level field visible in the Web client:

  1. Go to transaction SPRO.

  2. Navigate to Start of the navigation pathPlanning and Consolidation Next navigation step Configuration Parameters Next navigation step Set Global ParametersEnd of the navigation path.

  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.