UPB_CI_PUSHBACK_PR SAP Function module - Corporate IM: Pushback of Values to WBS Elements

UPB_CI_PUSHBACK_PR is a standard SAP function module that performs Corporate IM: Pushback of Values to WBS Elements functionality. This is available within standard R/3 SAP systems depending on version and release level.

Below are the pattern details for this FM showing its interface including any import, export and tables parameters. There is also a list of Exceptions and for your convenience any standard documentation available. All this information and more can also be viewed if you enter the function module name UPB_CI_PUSHBACK_PR into the relevant SAP transaction such as SE37 or SE80.

Contribute (Add Comments)
Within the comments section below there is also an opportunity for you to add useful hints, tips and information specific to this SAP function. This will then be available for you and other users to easily find by simply searching on the object name UPB_CI_PUSHBACK_PR or its description.

Pattern for FM UPB_CI_PUSHBACK_PR - UPB CI PUSHBACK PR

Associated Function Group: UPB_CI_01
Released Date: 11.02.2002

CALL FUNCTION 'UPB_CI_PUSHBACK_PR' "Corporate IM: Pushback of Values to WBS Elements
  EXPORTING
    i_area =                    " upc_y_area    Planning Area
    i_plevel =                  " upc_y_plevel  Planning Level
    i_method =                  " upc_y_method  Planning Function
    i_param =                   " upc_y_param   Parameter Group
    i_package =                 " upc_y_package  Planning Package
    it_exitp =                  " upf_yt_exitp  Planning Functions: Exit Function Parameters
    ito_chasel =                " upc_yto_chasel  Characteristic Selection
    ito_cha =                   " upc_yto_cha   Characteristics
    ito_kyf =                   " upc_yto_kyf   Key Figures
  IMPORTING
    et_mesg =                   " upc_yt_mesg   Messages
    .  "  UPB_CI_PUSHBACK_PR

SAP Documentation for FM UPB_CI_PUSHBACK_PR

FUNCTIONALITY

The function module UPB_CI_PUSHBACK_PR is used to define a planning function of the type exit in SEM-BPS.
This planning function is used to transfer strategic plan values from an SEM planning area into the R/3 project systems. Various transaction R/3 Systems are possible as targets.
Any WBS element values can be transferred into a plan version per run. The values can either be posted in this version as overall values and plan values or as budget. Budget changes can be transferred in R/3 as original budget or as returns and supplements.
A central currency translation and selections to individual fiscal years are supported.
INCLUDE 'SAPSEMPUSHBACKCURR' OBJECT DOKU ID TX

Value Transfer Logic
Aggregation regarding Time

The total value in R/3 is considered as the total of all annual values
in SEM. The year 0000 contains - as is usual in BW Content - the value

not distributed to years. In R/3 this is the difference from the total value and the total of the annual values.
Aggregation regarding the Hierarchy

It is assumed that in SEM-BPS the distributable values are saved to an
WBS element as a value and the distributed value results from the total

of the values saved in SEM-BPS to the hierarchically lower-level WBS elements.
For every transferred WBS element, the difference is formed from the value conducted in SEM-BPS and the value in R/3 for the respective year. Here the total from "distributed" and "distibutable" is used in R/3 as the comparison value, if for an WBS element no lower-level WBS elements are transferred from SEM. Otherwise the distributable value in R/3 is used as the comparison value.
The annual value and the total value of the WBS element is changed by the difference calculated. This change is rolled up to the distributed value of the higher-level WBS elements.
Zero Values

Since no records are updated with the value zero in SEM-BPS, it is not
possible for technical reasons to decide whether an WBS element is not

in the selection area for the pushback or whether its value should be set to zero. However, the system always assumes that the WBS elements are also in the selection area. If there are no values for these WBS elements in SEM, then their distributable values in R/3 are set to zero.
Because of the technical reasons named, it is not possible to set the lowest planned WBS elements per pushback from SEM-BPS to zero. In this case in SEM-BPS planning, use the smallest possible value as a replacement for the value zero or set the value using the R/3 transaction.

Release Prerequisites
System Involved,, Release
Receiving R/3 System,,as of release 4.5B and
,,as of plug-in for BW PI2001.1;
,,as of plug-in for BW PI2002.1 posting in R/3 is possible as budget
BW System,, as of release 2.1C

Settings in R/3
The RFC user must have the necessary authorizations for the transactions CJ30, CJ35, CJ36, CJ37, CJ38 (budget) and CJ40 (plan).
SAP recommends locking the planning versions used from SEM for the pushback in R/3 organizationally for manual planning.

Settings in SEM and SEM-BPS
INCLUDE 'SAPSEMPUSHBACKRFC' OBJECT DOKU ID TX

Determining the Exchange Rate Type for the Currency Translation
The exchange rate type for currency translation in the SEM System is transferred as a parameter of the planning function.
If this parameter is not set, the exchange rate defined by the customer enhancement AIBW002 is used. The enhancement AIBW002 is activated using the transaction CMOD. If the planning area is linked to an InfoCube in another BW System using an RFC connection, then the enhancement must be realized in the system of the InfoCube.

Demands on the Planning Level
The planning level for the pushback must contain the following InfoObjects:
0WBS_AS_ELE,,(The name can be changed per parameter.)
0FISCYEAR
0FISCVARNT
0CURRENCY
0VTYPE
0AMOUNT,,(The name can be changed per parameter.)
0VERSION,,(Only when posting as plan in R/3).
Optionally other InfoObjects can be evaluated by the extractor as time characteristics for currency translation:
0APPR_YEAR,, for values in year 0000
0FISCPER,, for values planned to periods.
Note:
All of these InfoObjects can only be used in the form delivered by SAP. Changing the type, length or compounding is not allowed.
In addition to that, the planning level can also contain other InfoObjects.

Definition of the Planning Function of the Type Exit
The planning function for pushback is defined as type "Exit function":
Function Module,,Usage
UPB_CI_PUSHBACK_INIT,,Initialization of planning function
UPB_CI_PUSHBACK_PR,,Transferring the values to the R/3 System
Parameter Name,,Data Element
LINOMAPR,,UPB_CI_FLG_WBS_ELEMT_LIST
PLANAREA,,UPC_Y_AREA
R3SYSTEM,,LOGSYSTEM
TESTMODE,,ADMI_TEST
RATETYPE,,KURST_CURR
BUDGET ,,UPB_CI_FLG_BUDGET_PLAN
BUDSUPRE,,UPB_CI_FLG_SUPPL_RET
WBSIOBJN,,UPB_CI_IOBJNM_WBS_ELEMT
KYFIOBJN,,UPB_CI_IOBJNM_AMOUNT
Fields to Be Changed
All fields must be transferred as "fields to be changed".

Selections in the Planning Package
Mandatory Selections
The planning package with which the pushback function is executed must deliver (together with the selections in the planning level) a unique selection for the values of the following InfoObjects:
0CURRENCY
0VTYPE
0VERSION,,(Only when posting as plan in R/3).
Optionally a selection can be made according to 0FISCYEAR in order to only transfer the values of individual years.
For Other Selections Note:
The completely distributable plan value of an WBS element for a year must always be contained in the planning package. If, for example, it was restricted to a period then in R/3 the complete annual value would be set to the value of the period.
For every transferred WBS element there should also be hierarchically higher-level WBS elements in the planning package. Otherwise - as already described - the distributable values of these WBS elements are set to zero in R/3.

Settings in the Parameter Group
Further settings are made in the parameter group for the pushback function.
Mandatory Settings,,
Planning area,,Single planning area with the values planned in SEM-BPS
Optional Settings,,
Only display in acc. with WBS,,Output of WBS elements without R/3 source system
Target system ID,,Restriction of pushback to an R/3 System
Test run,,Indicator: Test processing - No locking and writing in R/3
Exchange rate type,,Exchange rate type for currency translation
Post budget ,,Indicator: Post budget (default: Plan)
Returns and supplements,,Indicator: Post budget changes as returns and supplements (default: Original budget)
IObj. WBS element,,Name of InfoObject for WBS elements (default: 0WBS_AS_ELE)
IObj. key figure,,Name of InfoObject for the key figure (default: 0AMOUNT)

Documentation extract taken from SAP system, Copyright (c) SAP AG

UPB_CI_PUSHBACK_MATCH_IP

UPB_CMI_AVG_DRIVERS_CALC