SAP BPC 7.5 NetWeaver - BW 7.01 Integration.pdf

7/21/2019 SAP BPC 7.5 NetWeaver - BW 7.01 Integration.pdf

http://slidepdf.com/reader/full/sap-bpc-75-netweaver-bw-701-integrationpdf 1/82

SAP COMMUNITY NETWORK scn.sap.com

© 2012 SAP AG 1

SAP BPC 7.5 NetWeaver – BW 7.01 Integration

Applies to:

SAP Business Planning and Consolidation 7.5 and Business Warehouse 7.01.

Summary

The purpose of this document is to provide an overview of good practice for integration between a BPC 7.5system and a BW 7.01 environment. It is based on the experiences of a particular implementation and iswritten by experienced BW consultants for BW consultants with little knowledge of the BPC application. Ittherefore does not cover basic BW concepts or detail steps on how to create BW objects. It also does notcover any aspects of the BPC functional application.

This documentation was created as a team and based on project implementation.

Authors: Bill Lang, Lee Oxley, Henning Stolz

Company: SAP UK Ltd.

Created on: September 2012

Authors Bio

Henning Stolz, a certified and experienced Business Intelligence consultant within SAP(UKi) working in a SAP environment since 2006. The main focuses of his SAP consultingare on business intelligence and analytics (BW/BO), BPC data integration as well asSustainability Performance Management (SAP SuPM). His contribution to this documentand the project focused on the inbound data flow into the BPC application.

Bill Lang is a Solution Architect in Business Intelligence and Performance Management inSAP UKi and is certified in both areas. He has worked in Business Intelligence in variousguises since 1999. His role in the project was that of Technical Lead across theinfrastructure and the data modeling and data flow areas.

Lee Oxley, a certified and experienced Business Intelligence/ Warehouse consultant for SAP UKi, performing team leader, consultant, expert and quality review roles acrossmultiple industries. His contribution to this document and the project focused on theoutbound data flow from the BPC application and integrating into the existing BW system.





© 2012 SAP AG 2

Table of Contents

Introduction ......................................................................................................................................................... 4

Inbound Data Flow .............................................................................................................................................. 6

BPC Application .............................................................................................................................................. 7

BW Staging Info Provider ................................................................................................................................ 9

BPC Data Manager ....................................................................................................................................... 12

Transformation File .................................................................................................................................................... 13

Conversion File .......................................................................................................................................................... 16

BPC Data Manager Packages ................................................................................................................................... 19

BPC Data Manager Package Links ............................................................................................................................ 21

BPC Data Manager Logs ........................................................................................................................................... 22

Master Data ................................................................................................................................................... 23

Attributes and Texts ................................................................................................................................................... 27

Hierarchy.................................................................................................................................................................... 30

Outbound Data Flow ......................................................................................................................................... 31

Creation of objects for BPC Outbound Dataflow .......................................................................................... 33

Custom table .............................................................................................................................................................. 33

Custom ABAP program to delete table contents ........................................................................................................ 34

Retraction BADI ......................................................................................................................................................... 36

DSO Outbound Layer 1 ............................................................................................................................................. 40

DSO Outbound Layer 2 ............................................................................................................................................. 40

BPC Outbound Dataflow ............................................................................................................................... 41

BPC Data Manager (BPC Outbound) ........................................................................................................................ 41

Common Issues ................................................................................................................................................ 44

Administration Client Issues .......................................................................................................................... 44

Loading Data into a Dim from BW Fails – “unprocessed member data” .................................................................... 44 Cannot Delete Dimension Member ............................................................................................................................ 46

Other Processing Dimension Errors ........................................................................................................................... 46

Dimension Changes Are Not Implemented but no Error is Given .............................................................................. 47

Maintain Dimension Members in Admin Client Generates a BPC Dump ................................................................... 48

Maintain Dimension Members in Admin Client Generates File not Found Error ........................................................ 49

Cannot Modify BPF‟s in BPC Admin Client ................................................................................................................ 50

Creating BPF Step Generates “Resource with identifier „65024‟ not found” Error ...................................................... 51

Excel Client Issues – Logging on and Excel Environment............................................................................ 52

Planning and Consolidation Tab Missing in Excel ...................................................................................................... 52

Log on to BPC Excel generates “Object Variable or With Block variable not set” Error ............................................. 53

Log on to BPC Excel generates “Microsoft Excel is waiting for another application to complete an OLE action” andnever logs on ............................................................................................................................................................. 53

Log on to BPC Excel using Sign Sign-On requests username and password and fails ............................................. 54

Logging on results a “The remote name could not be resolved: „planningosoft‟ ........................................................ 55

All Menu Bars and Ribbons Disappear in Excel ......................................................................................................... 55

Refreshing Client Cached Dimensions, Templates and Application Information........................................................ 56

Excel Client Issues – Reporting and Data Manager ..................................................................................... 57

Complex non-BPC Spreadsheets are slow to Open and slow to Edit ........................................................................ 57





© 2012 SAP AG 3

All Input Schedules and Reports generate an EvDRE Error for a Particular User ..................................................... 58

All Input Schedules and Reports generate an EvDRE Error after Data Load ............................................................ 58

All Input Schedules and Reports generate an EvDRE Error for all Users/ Applications ............................................. 60

Using any eData Component Generates an Error ..................................................................................................... 60

Input Schedule Send Data Gives Overflow Error ....................................................................................................... 61

Users cannot see the Data Manager Package Logs – blank error messages............................................................ 61

Data Manager Packages are recorded as Cancelled Status ..................................................................................... 62 Data Manager Export Packages get cancelled .......................................................................................................... 62

Admin – Loading Master Data Generates a Hierarchy Does not Exist Error .............................................................. 63

BPC Web Interface ....................................................................................................................................... 66

No BPF Interface is displayed when Logging on to BPC Web ................................................................................... 66

Viewing BPF‟s in Web Interface Times Out ............................................................................................................... 67

Copyright........................................................................................................................................................... 82





© 2012 SAP AG 4

Introduction

The purpose of this document is to provide an overview of good practice for integration between a BPC 7.5system and a BW 7.0 environment. It is based on the experiences of a particular implementation and iswritten by experienced BW consultants for BW consultants with little knowledge of the BPC application. Ittherefore does not cover basic BW concepts or detail steps on how to create BW objects. It also does notcover any aspects of the BPC functional application.

A BPC system includes one or more Applications which are combined in an Application Set (AppSet),analogous to an InfoArea. An Application Set contains multiple Dimensions (Master Data objects) andapplications (cubes). The Dimensions can be used by any BPC Application and are shared within the Application Set. The BPC Application uses a separate namespace within a NetWeaver BW system (/CPMB/as opposed to standard content /BI0/). When an Application with Dimensions is created, an InfoCube andInfoObjects relating to this application, are created in this namespace. See below:

Figure 1. Data Flow into BPC from BW and back out again





© 2012 SAP AG 5

The mechanism for transferring data into and out of BPC is via BPC-specific process chains. These arecalled via a BPC client tool called BPC Data Manager. These process chains can be viewed in transactionRSPC and are standard BW process chains that use specific BPC process types and can execute BPCscripts (known as ScriptLogic). It is not recommended that you change the BPC installed process chainshowever they can be copied and amended.

These BPC process chains are executed via a BPC Data Manager Package. This package defines the typeof data import or export and all the necessary parameters for the transfer including data filter selections. Two

important elements of a Data Manager Package are a Transformation file and a Conversion file which are inMicrosoft Excel format. The transformation file defines the mapping between source and target objects andwhich objects should be converted and where to find the conversion rules. The Conversion file containsthese conversion rules in this implementation is typically used to add or remove prefixes to or from datawhen loading into or out of BPC.

To create objects in BPC, the Planning and Consolidation Administration Client is used. This tool enables thecreation of Applications (real-time InfoCubes in the BW system) with Dimensions (InfoObjects). It also givesaccess to the Dimension Library which is a shared master data library for all Applications within one AppSet.InfoObjects are not created in the SAP GUI.

Figure 2. BPC Administration Client

Loading transactional data into the BPC Applications is described in chapter 2.3 BPC Data Manager .

Chapter 2.4 Master Data goes into more detail of the BPC Administration Client and how to load data into a

BPC Dimension.

The data load from BPC back into the BW name space is described in Chapter 3. Outbound. Chapter 4Common Issues covers some known problems and gives possible solutions.





© 2012 SAP AG 6

Inbound Data Flow

The two scenarios of data integration inbound (BW into BPC) are

A Master Data load from an InfoObject in BW to a BPC Dimension;

A transactional data load from an InfoCube into a BPC Application;

As noted previously, the BPC objects are created by the BPC Administration Console and all objects withinBPC are created in an InfoArea within the BPC name space /CPMB/.

Following figure shows one example from this implementation. In this case the Application Set name isGROUP and the description is Group Planning and Forecasting. The Application Set contains severalapplications (cubes) and several dimensions (info objects):

Figure 3. Application Set with Dimensions and Applications

There is no standard BW data flow between a staging InfoProvider and the InfoCubes/ InfoObjects in theBPC namespace. BPC 7.5 for NetWeaver provides the BPC Data Manager Packages and process chains toload data (Master and transactional data) from the BI name space (/BIC/) to the BPC name space (/CPMB/).

The following section demonstrates how to load data into the BPC objects, how to prepare the staging layer,the Transformation and Conversion files and the BPC Data Manager Packages and Package Links. As anexample the GROUP Application Set and the Indirect Costs (IC) Application will be used.





© 2012 SAP AG 7

BPC Application

The dimensionality of the Indirect Costs (IC) Application is defined within the BPC Administration Client.During this step the InfoCube in the BW system is automatically created. In this example the Info Cube has atechnical name /CPMB/MRIZU2L (automatically defined) with a description matching that of the Applicationname. For each BPC Dimension assigned to the Application, the tool creates one characteristic within theBW InfoCube. Each InfoCube (Application) has one and only one key figure: ZSIGNDATA „Sign Data‟. Thatmeans the cube is always a line item cube with an account based data model.

Each characteristic is defined with the type of CHAR20; the key figure is set to DEC11, which is a number without unit and an aggregation method SUM. The following figure shows the InfoCube in BW - as anexample the Dimension Version is expanded and has a single characteristic (of same name):

Figure 4. The Indirect Costs BPC Application displayed in RSA1 in the SAP GUI





© 2012 SAP AG 8

Each InfoCube is set as a planning cube and as such doesn‟t allow a data load via a Data Transfer Package(DTP) – note that the process chains that load the data do this as part of the chain:

Figure 5. Change an Info Cube’s Real -Time type to enable the loading of data

Tip: This setting can be used in case of the need to clear the content or do a selective deletion.

During the time the setting is switched to ‘Can be Loaded with Data’ those deletions are possible

but the cube will only be accessible for reporting but not for writing. It’s important to change it

back after the necessary step is done.

After the load process it is generally recommended to run application/cube optimisation tasks to providesatisfactory performance for reporting and input schedule updates. There are two different possibilities, alight and a full optimisation.

A light optimisation is a maintenance process similar to the BW InfoCube performance maintenance tasks of index rebuild, statistics rebuilds, and compression. This process deletes the InfoCube indexes and movesrecords from the F to the E fact tables. It compresses/collapses the records with the same key and additionalzero suppression is possible. The InfoCube statistics gets updated.

The full optimisation rebuilds the application in its entirety. The process creates a new application and copiesthe data to the new application. It is a restructuring of the BPC application data model and it will change thetechnical InfoCube name.

More information about these optimisation processes can be found in SAP note 1551154 - Optimization inversion 7.5 and 1508929 - BPC: How often do we need to run optimization to avoid low performance issue inBPC?





© 2012 SAP AG 9

BW Staging Info Provider

In this particular implementation two BWs exist. The Business As Usual (BAU) BW is used for generalreporting purposes and is the source system for the BPC-only BW installation. The BAU system is also thetarget system for the final planned data which is created in BPC. This is not necessarily a recommendedapproach but for the project meant that the existing (BAU) BW system did not require upgrading to theminimum patch level required for the BPC 7.5 release. Despite the fact that additional data staging steps arenecessary, this situation offered flexibility in patching and transporting throughout the project duration with

little additional support overhead. The project team could work more independently from the standard BIlandscape lifecycle, minimising interruptions with the existing business process.

Because of this two-system scenario, two staging layers are required:

The first layer of staging is used to load the data (actuals) into the BPC BW system. During this load

no data transformation is performed and in general, all records are transferred without filtering

(1:1). Some aggregation takes place as not all objects in the source have a corresponding object in

the target.

Between staging layer 1 and 2 the data is transformed into the BPC required format so the layer 2 is

be aligned as much as possible to the BPC Application – simply, an InfoCube is created with the

same structure as the BPC Application cube. In the example below, the staging cube is also created

with one key figure (account based model) and the characteristics are Z objects – as they created

for BPC they are created as CHAR20 to ensure consistency:

Figure 6. Staging Info Cube in the /BIC/ namespace

There is no particular need to have an Info Cube as a staging object and if the data source is notmultidimensional and the key fields are known, a DSO is another possible solution.





© 2012 SAP AG 10

The more the staging data structure matches the target structure in BPC, the less data transformation needsto be done in the BPC Transformation and Conversion files. For instance the data model could be key figure-based (multiple key figures) and then transformed into an account-based model (single key figure) with a

formula in the BPC Transformation file (refer to section 0 BPC Data Manager), but to keep the transformation

file as simple as possible (to have one single point of maintenance and use the existing BW skillset), the vastmajority of the transformations are performed between staging layer 1 and 2 (exceptions were based onexpediency and ease of implementation).

The following diagram illustrates what a data flow looks like from the BI 0 objects to the staging Z objects andthen to the BPC objects:

Figure 7. Data flow from existing BW objects to BPC objects

A 0-object does not necessarily mean a business-content Info Object or a z-object a custom one, it justillustrates that data gets loaded from existing BW objects into those which are created for BPC staging andthen to those in BPC.

The BW transformations between staging layer 1 and 2 are not described in detail because these steps arecommon BW data modelling tasks and not part of this document.

0-Object

(different

characteristics,

multiple key

figures)

Z-Object

(CHAR 20,

single key

figure) BPC

Data Manager BPC Object

(CHAR 20,

single key

figure)





© 2012 SAP AG 11

For this implementation individual field mappings were used in the main. The Indirect Costs staging layer 2(below) is already an account-based data model with one key figure and several individual field mappings.For characteristics where no 1:1 field mapping (direct assignment) or fixed value (constant) is sufficient, an ABAP routine transforms the source data into the BPC required format. For instance the time dimension is acharacter 20 field in BPC and is expected in a format YYYY.MMM. The source for that is the BW standardfield „Fiscal year / period‟.

Figure 8. Staging Layer 2 Object

A common practice in BPC is to prefix master data ID‟s to ensure uniqueness across the Application Set,e.g. a profit centre number is prefixed with „PC_. To match the transactional data records with the master data in the BPC dimension, the same prefix needs to be added to each value in the characteristic. This couldbe done at this level of data staging however for simplicity this was implemented in the Conversion file (one

of the transformation exceptions – for more details refer to section 0 Conversion File).





© 2012 SAP AG 12

BPC Data Manager

The BPC Data Manager is a tool to run various BPC code packages. Amongst these are ones that enablethe loading of data into the BPC system, copy and move data within and across BPC Applications and exportdata from an Application. Data Manager Packages are based on BW process chains which are deliveredwith the BPC installation. They can be viewed in transaction RSPC but do not use standard BW processchain types and do not need to be altered.

The Data Manager is integrated within the BPC Excel interface. To start the Data Manager, choose thePlanning & Consolidation ribbon in Excel and choose eTools and then Data Manager :

Figure 9. Selecting Data Manager Interface in the BPC Excel Client

In the following section, the process of loading data from the staging InfoCube into a BPC Application isdescribed. First a Transformation and a Conversion file are needed then a Package combines those fileswith prompts (variables) and triggers a BW process chain. Finally multiple Packages for different tasks canbe combined in Package Links.

Further help can be found at http://help.sap.com/saphelp_bpc75_nw/helpdata/en/bpc_nw_index.htm.

http://help.sap.com/saphelp_bpc75_nw/helpdata/en/bpc_nw_index.htm








© 2012 SAP AG 13

Transformation File

A Transformation file is a Microsoft Excel file used to map fields in BW to fields in BPC. For transactionaldata it means Info Objects on the BW staging side (characteristics and key figures in the Info Provider) withDimensions in BPC:

Figure 10. Example Transformation File

The mapping file is structured in three sections, Options, Mapping and Conversion. In the first Optionssection, general settings are made; the Mapping section is to assign a dimension or property in BPC with asource column (in this case an attribute of the InfoObject); the Conversion section is to link another excelsheet to a specific field to apply a conversion routine.

An example transformation file is Appendix 1.

The following section describes how to create a Transformation file.





© 2012 SAP AG 14

How to create a Transformation File:

1. Logon to BPC Excel client.

2. Select the Application Set and Application where the Transformation file will be used. The files are

stored on the BPC server and are specific to a BPC Application.

3. In the Data Manager section on the Planning & Consolidation ribbon, select

More New Transformation File:





© 2012 SAP AG 15

4. A new Excel sheet with the structure of a Transformation File opens. If no changes under Options

are necessary and no conversions should be applied, the focus is the Mapping section. Here the

field mapping is listed and structured as a list of the technical field names in rows.

The BPC dimension is assigned to a BW Info Object and its attributes as in the following:

ACCOUNT=ZACCOUNTTIME=ZBPCTIME

SIGNEDDATA=ZAMOUNT

The Key Figure of the BW cube (ZAMOUNT) is assigned to SIGNEDDATA.

If the source is a csv file a BPC Dimension can be mapped to a column (by name) or if there is noheader row in the source file (Header under *OPTIONS must be disabled) then a placeholder like*()Col1, *()Col2, etc. needs to be mapped.

If a conversion is to be applied, a reference to the corresponding Conversion file is needed. In thiscase the BPC dimension or property needs to be mapped to a specific sheet in a separatedConversion file, e.g. DIMENSION1=conversionfile.xls!sheet1

Other functionality:

To change an existing transformation files go to Data Manager on the Planning & Consolidation ribbonand select More Manage Transformation File:

After each change a transformation file needs to be processed (saved on the server). Also a validation ispossible. To do that, use the Transformation Maintenance Options in the right-hand action pane:





© 2012 SAP AG 16

Conversion File

A Conversion File is a Microsoft Excel file used to apply conversion rules for a BPC Dimension and itsproperties.

Once an empty Conversion file is created an excel sheet with three column provides the structure. Column Ais the value from the source, column B is how it should be structured in BPC and column C is a possibletransformation formula which can be applied for each record.

For this implementation no formulas were used because all transformations are done in the BW staginglayer, however one conversion for each dimension was the addition of a prefix for the ID‟s. The figure belowshows how to prefix CC_ to each cost centre:

Figure 11. Example Conversion File

An example Conversion file is in Appendix 1.





© 2012 SAP AG 17

How to create a Conversion File:

1. Logon to BPC Excel client.

2. Select the Application Set and Application where the Transformation file will be used. The files are

stored on the BPC server and are specific to a BPC Application.

3. In the Data Manager section on the Planning & Consolidation ribbon, select

More New Conversion File:





© 2012 SAP AG 18

Other functionality:

Managing Conversion files

To change existing conversion files go to Data Manager on the Planning & Consolidation ribbon and

select More Manage Conversion File:

After each change a Transformation file needs to be processed (saved on the server). Also a validation canbe performed and again, to do that use the Transformation Maintenance Options in the action pane.





© 2012 SAP AG 19

BPC Data Manager Packages

Packages are used across the BPC system for a number of tasks. The Package folder Data Management lists some functionality to load data and in the figure below a package Run BW process chain ishighlighted. This package triggers a standard BW process chain.

Run Package

Figure 12. The Data Manager, Run Package dialog

Organize Package List:

These packages can be organized including adding, removing, copying and changing:

Figure 13. The Data Manager, Organise Package List dialog





© 2012 SAP AG 20

View Package Status: Package Status is a monitor to see the logs per application. The status of a running package is visible in thefirst screen:

Figure 14. Package Status Run Log

For each individual run details can be displayed:





© 2012 SAP AG 21

BPC Data Manager Package Links

BPC Data Manager Package Links link one or many Packages together in a specified order. Package Linksexecute in a specific order, set value for prompts and variables but they are a list of Packages executed inorder. If one Package fails, all subsequent Packages are not run:

Figure 15. Data Manager Package Link Detail





© 2012 SAP AG 22

BPC Data Manager Logs

Data Manager More View Package Status provides a log for the component Packages:

An overall Package status for the Application shows a history with user, status, start and end time:

Figure 16. Data Manager Package Link Log

Tip: Tick ‘Refresh status every x seconds’ enables an auto update of this list.

Figure 17. Data Manager Package Link Log Detail





© 2012 SAP AG 23

Master Data

As with transactional data, Master Data is staged in separated BW Info Objects and then loaded into BPCwith the BPC Data Manager. To map fields (InfoObject Attributes to BPC Dimension Properties) a

Transformation and a Conversion file is required (refer to section 0 BPC Data Manager).

When a BPC Dimension is set up in the Planning and Consolidation Administration Client an InfoObject inthe BW system gets created (in the BPC name space). The BPC Dimension Library is shared between all

Applications (within one Appset). Each Dimension is one InfoObject in the BW stystem and each Dimensionproperty represents an attribute of the InfoObject.

The figure below shows the Planning and Consolidation Administration Client and the expanded DimensionLibrary. The following section details an illustration of how to load Master Data into the ProfitCentreDimension, including attributes (properties in BPC terminology), hierarchies and texts.

Figure 18. Dimension Library in the BPC Administration Client





© 2012 SAP AG 24

The Dimension properties are maintainable. For each BPC property created, an attribute gets created in theBW system.

ProfitCentre Dimension properties:

Figure 19. Dimension Properties

ProfitCentre Info Object attributes:

Figure 20. Dimension Info Object Attributes





© 2012 SAP AG 25

A BPC Dimension can be populated from other BW InfoObjects via BPC Data Manager or entered manuallyin the Administration Client. This can be useful if the dimension‟s content is static or changes rarely (or canonly be performed manually for business reasons).

In the right hand side menu bar „Manage Dimension‟ a task to maintain the Dimension members can beselected. This opens an embedded Excel file with the contents of this Dimension:

Figure 21. Maintaining a Dimension in the BPC Administration Client

In this example (ProfitCentre) column A is the ID, column B the description and column C the parent ID in thehierarchy. From column D on, the properties are listed. Each cell is editable and the value can be changedand written back to the BW InfoObject.

When using the save option a file gets stored on the server and is used as a cache. The changes won‟t bevisible in the frontend until the Dimension is processed which commits the data to the InfoObject.

The Dimension member sheet can only be accessed by one user. For all others the access is locked duringthe time of editing.

Tip: Process dimension after even just opening the dimension member sheet to avoid load failure

‘Dimension contains unprocessed members’.





© 2012 SAP AG 26

To see the changes in the BPC client go to eTools Refresh Dimension Members:

In the BPC client the Dimension is then updated and the properties (right-click context menu) will show theMaster Data for the object:

Figure 22. Dimension Hierarchy and Properties in the BPC Excel Client





© 2012 SAP AG 27

Attributes and Texts

For master data and its attributes a transformation file needs to be created and used in a BPC Data Manager package to load into the BPC Dimension. The transformation file for master data follows the same principalas for transactional data and can be combined with conversion files if necessary.

In the BPC Data Manager the Package set up is as follows:

When a BW InfoObject is selected there are several selections to set.

In the first screen „Attribute‟ the selection can be restricted as well as a KeyDate defined for time dependentMaster Data:





© 2012 SAP AG 28

In the next screen the „Hierarchy‟ the hierarchy is set (if there is one):

The third screen the „Language‟ is for selecting the texts of the InfoObject. First the language is to beselected and then the short, the medium or the long text can be loaded into the description column of theBPC dimension.





© 2012 SAP AG 29

Finally the „Attribute list‟ shows all attributes of the info object. Select the attributes that need to be mappedto B PC objects in the Transformation file.

The package needs to know the path to the transformation file on the server and the name of the BPCDimension:





© 2012 SAP AG 30

Hierarchy

To load the relevant hierarchy an additional package is required:

When the BW InfoObject is chosen the hierarchy needs to be selected:





© 2012 SAP AG 31

To load a hierarchy a Transformation file also needs to be specified in the Package:

This Package is usually combined with other packages in a package link – for instance the previouslydetailed text load.

Outbound Data Flow

With BPC NetWeaver 7.5 there are three different ways to extract transaction data:

1. To a file, in the file service or application server.

2. Via a virtual provider on top of the planning cube.3. Via a BADI

Based on the customer set up it had already been determined that method 3 was the most appropriatebased on data volumes and for performance.

Details of method 1 can be found at this location for the application server:http://help.sap.com/saphelp_bpc75_nw/helpdata/en/92/7e7ee692b54cc28833fa8f222d461b/frameset.htm

Or this for the file service:http://help.sap.com/saphelp_bpc75_nw/helpdata/en/c3/44561ec5534ce6b3d2700a59ffe3e0/frameset.htm

Further details of method 3 and this BADI process and definition can be found at thishttp://help.sap.com/saphelp_bpc75_nw/helpdata/en/22/84fc60a0f64525935742a5071d5b82/frameset.htm

There are separate Data Manager packages available for the Master Data and transaction data retractions.Only the transaction data retraction is discussed as Master Data created for the BPC application was notrequired outside of BPC.

The example is based on the requirements of this project. The retraction data flow takes the required datafrom the BPC application, adds it to a staging table via a BADI (as the BADI couldn‟t directly update a DSOor cube), creates a data source on the table and loads via a Data Transfer Package (DTP) and processchain into an outbound layer 1 DSO with no business rule transformation. From there the data is loaded intoan outbound layer 2 DSO where the business rule transformations are applied. From the outbound layer 2,

http://help.sap.com/saphelp_bpc75_nw/helpdata/en/92/7e7ee692b54cc28833fa8f222d461b/frameset.htm

http://help.sap.com/saphelp_bpc75_nw/helpdata/en/c3/44561ec5534ce6b3d2700a59ffe3e0/frameset.htm


http://help.sap.com/saphelp_bpc75_nw/helpdata/en/22/84fc60a0f64525935742a5071d5b82/frameset.htm




http://help.sap.com/saphelp_bpc75_nw/helpdata/en/92/7e7ee692b54cc28833fa8f222d461b/frameset.htm





© 2012 SAP AG 32

data is loaded into a separate BW system – the Business As Usual (BAU) BW system discussed in theprevious section. This inter-BW load step is not discussed here.

Figure 23. Data Flow from BPC back into BW

When executing the Data Manager Package, based on the filter selections within the Package, the requireddata is taken from the relevant BPC application InfoCube and passed via internal table to the BADI code.The BADI code has to determine the structure of this table, and map the relevant columns to an output. Inthis example, the output is a custom database table created via transaction SE11 in BW. This staging table isgiven the same structure as the BPC application to allow for data reconciliation during the retraction processin case of issues. Standard BW process chains are used to move the data from the staging table to theoutbound layers 1 and 2.

As the planning process creates new versions of plans during the year, differing requirements determinewhat data is required to be stored and at what level. In this example, the staging table is just a temporaryrepository before moving the data to the outbound layer 1 DSO therefore the data in this table can and

should be deleted before every new retraction.

The outbound layer 1 DSO is required to have the latest version of each plan. As retractions are run daily,plans with the same version overwrite previous versions; any new plans are added therefore thetransformation into the DSO is set with overwrite. The DTP into this DSO could be full or delta as long as thePSA for the staging table data source is deleted with every load. Outbound layer 2 only has the required datafrom the latest plan and therefore the contents are deleted before every new load. This is because anequivalent DSO in another BW system will maintain the history, and the data is already held, albeit withoutbusiness transformation rules applied, in outbound layer 1.





© 2012 SAP AG 33

Creation of objects for BPC Outbound Dataflow

As outlined above, the required objects for the outbound dataflow from BPC are:

1. Custom table

2. Custom ABAP program to delete the contents of the custom table

3. Retraction BADI

4. DSO outbound layer 1

5. DSO outbound layer 2

Each of these objects will be covered below either outlining how to create it, or if it‟s a standard BW object just an overview of what the object is.

Custom table

A custom table is created via transaction SE11 and is a database table. The required structure is manuallydefined or based on existing data elements. The example below is manually defined which can be done viaselecting „Predefined Type‟ button. The data type and length can then be freely defined.

In the example below each field matches the definition in the planning info provider:

Figure 24. Outbound Data Flow Target Custom Table





© 2012 SAP AG 34

Custom ABAP program to delete table contents

The process flow requires that the contents of the custom table are deleted before the next load – a custom ABAP program was written to perform this function. As there are multiple data flows, the program was writtento allow program variants to determine which table contents are to be deleted without the need for oneprogram per custom table.

The program was created via transaction SE38. The code for the program can be found in Appendix 2.

Ensure the settings „type‟ are „executable program‟ and the „status‟ are „Customer Production Program‟:

After the program is created, variants for each custom table for each data flow can be created. To do this,

choose the „variants‟ radio button in SE38 with the program name and then choose the „change‟ icon:





© 2012 SAP AG 35

Enter a variant name and select the „create‟ icon. Enter the required values for application set ID andapplication ID:

Select the „attributes‟ icon and enter a description and any other required settings and save:





© 2012 SAP AG 36

Retraction BADI

The BADI for transaction (and Master) data retraction is called via a process chain. You must specify thefilter in the data package script to indicate to the system the BADI implementation calls. For transaction data,the BADI is called for each package during the transaction data load.

The online help for this BADI can be found athttp://help.sap.com/saphelp_bpc75_nw/helpdata/en/22/84fc60a0f64525935742a5071d5b82/frameset.htm .

The BADI is created in transaction SE19. Enter „UJD_RETRACT‟ as the enhancement spot and select the„create‟ icon:

Create the enhancement implementation and enter a description:








© 2012 SAP AG 37

Enter the BADI implementation „BADI_UJD_RETRACT‟ and implementation class „IF_UJD_RETRACT‟:

Save the enhancement implementation:





© 2012 SAP AG 38

Expand the arrow icon under the BADI implementation and select the filter value and then the „change filter value‟ icon:

Enter the filter value that will be used as the BADI name in the BPC data manager package.

After confirming the changed filter value, select the „implementing class‟:





© 2012 SAP AG 39

Change the „implementing class‟ to the custom version created for the BADI (refer to Appendix 3):

The technical details tab should now look as follows:





© 2012 SAP AG 40

DSO Outbound Layer 1

The definition of the outbound DSO layer 1 matches the definition of the planning provider with allcharacteristics as keys and the single key figure as a data field:

Figure 25. Outbound Layer 1 – Data Store Object (DSO)

DSO Outbound Layer 2

Required transformations to meet the reporting requirements are made between the DSO outbound layers 1and 2. The required definition of this second layer is therefore customer specific with an example definition of this second layer below:

Figure 26. Outbound Layer 2 – Data Store Object (DSO)





© 2012 SAP AG 41

BPC Outbound Dataflow

Once all the objects required for the outbound dataflow have been created, the mechanism for managing thedataflow can be created. This is performed by the BPC Data Manager and a package link.

BPC Data Manager (BPC Outbound)

A package link contains steps of individual data manager packages. Each package executes one of the

required retraction steps. These are:1. Delete data from the application staging table;

2. Export the BPC data via the BADI into the staging table;

3. Run the BW process chain to load the data from the staging table into the outbound staging layer 1

and layer 2;

The steps detailing how to create a data manager package link are covered in the previous inbound data

loading section. Thebelow highlights the created package link for outbound dataflow:

Figure 27. Outbound Data Flow Package Link

The BAdi writes data to staging table: ZBPC_INDC_RET - BPC Indirect Cost data (BPC Indirect Cost app.Outbound). This table is used as data source „ZDS_INDC_TD - Indirect Costs BPC Outbound‟ to load the

data into the BW namespace.

A 1:1 mapping (direct assignment) is used in the transformation to the DSO „ZDOIND1 - BPC Indirect CostsOutbound Layer 1‟. This staging layer contains the data as it came out of BPC but with BPC prefixesremoved via a conversion file used in the Data Manager Package.





© 2012 SAP AG 42

A second staging DSO, „ZDOIND2 - BPC Indirect Costs Outbound Layer 2‟ then takes this source data andapplies relevant business rules to determine the required data set to then be staged into BAU BW.

These 2 DSO are in the info area as per the screen shot below:

Figure 28. Outbound BW Data Flow

The deletion of the staging table is carried out by running a BW process chain, ZBPC_IC_DEL –

INDIRECTCOSTS Delete retraction data. This chain calls an ABAP program,

ZBPC_DELETE_RETRACT_DATA – Delete BPC Retraction Data, with a variant, ZINDIRECTCOSTS –

Delete INDIRECTCOSTS Retract D.





© 2012 SAP AG 43

The export of data from BPC to the staging table uses the BAdi called from BPC data manager. For BAdi

details, see the appendix. No transformation is applied however prefixes that were added to data items on

the BPC inbound flows are removed via a conversion file on the outbound flow. Data in the staging table is

therefore referred to as „unprefixed‟.

The loading of data from the staging table through the staging layers is executed via a BW process chain,

ZBPC_IC_TD_OUT - INDIRECTCOSTS Transactional Data Load (BPC > BPC BW).





© 2012 SAP AG 44

Export Indirect Costs BPC data to staging package settings

The Data Manager Package for Export Indirect Costs BPC data to staging has the following settings:

Figure 1. Indirect Costs Outbound Data Flow Package Settings

The steps detailing how to create transformation and conversion are covered in the inbound section above.

See Appendix 1 for examples of transformation and conversion files for the outbound dataflow.

Once the data manager packages and package link are created, the package link can be scheduled thusperforming the retraction of data from the planning provider into the DSO outbound layer 2.

Common Issues

Administration Client Issues

Loading Data into a Dim from BW Fails – “unprocessed member data”

Note – this is not strictly an Administration Client error as Data Manager is run from the Excel client tool.

The Data Manager Package to load data into BPC fails with an “unprocessed member data” error in theReject Records tab:

To clear this error the dimension must be processed in the Administration Client before the load can start:





© 2012 SAP AG 45

Note – table UJA_DIMENSION shows whether a dimension is in a processed (P) or unprocessed state (U).





© 2012 SAP AG 46

Cannot Delete Dimension Member

You cannot remove a dimension member when there is transaction data recorded for that member (includingzeros). This can be the case when you see the following error:

In this case you need to remove the data related to the dimension member from all relevant cubes. This can

be done with selective deletion of records in the relevant cube in RSA1.

This error can also happen when there are corruptions in the server-side cache. In this case delete the deltafiles (pending changes) in UJFS and try processing again:

Dimension Members may also be referenced as Driving Dimension Members in Business Process Flows(BPFs). In this case, to remove the dimension members they would need to be removed from the BPF first.

Other Processing Dimension Errors

If you are changing the dimension hierarchy or removing dimensions then you can get errors when membersare referenced in Active Business Process Flows (BPF‟s). Archiving the Instances of a BPF should resolvethis problem but if not, you can remove the offending entries from the NetWeaver back-end tables.





© 2012 SAP AG 47

Dimension Changes Are Not Implemented but no Error is Given

The developer makes a dimension member change, saves to server and processes (or just processes).They then close and re-open the dimension and the change has not been implemented. Another developer checks and confirms the change has not been implemented.

Close all versions of excel and refresh the dimension members. If this does not work then check thecontents of the UJFS cache by downloading the dimension xls file:

If this file is corrupt (or empty) then delete the xls file in UJFS and BPC will automatically recreate it whensomeone requests the file:





© 2012 SAP AG 48

Maintain Dimension Members in Admin Client Generates a BPC Dump

When clicking on Maintain Dimension Members in the BPC Administrative client the following error is seen:

This error can be caused because Excel is busy in another Window. This can happen if you are editing acell formula in Excel:

The best method is to close all versions of Excel and try again. If this does not work then restart the BPC Administration console





© 2012 SAP AG 49

Maintain Dimension Members in Admin Client Generates File not Found Error

When clicking on Maintain Dimension Members in the BPC Administrative client the following error is seen:

In fact none of the files from the BPC .NET server (Input Schedules, Dimension files etc.) are beingdownloaded.

First check that the user has read/write access to the cache directory ( C:\Program Files\SAPBusinessObjects\PC_NW\Cache).

If they do then the XceedZip.dll registration has become corrupted in some way. Re-register by running thefollowing command (e.g. Start > Run):

regsvr32 "C:\Program Files\SAP BusinessObjects\PC_NW\XceedZip.dll"

If this succeeds the following message is seen:





© 2012 SAP AG 50

Cannot Modify BPF‟s in BPC Admin Client

When trying to modify a BPF, the BPC Administration Client makes a change to the C:\Program Files\ SAPBusinessObjects\PC_NW\log-configuration.xml file. If this file is read the following error message isseen:

Read-write access to this file for authenticated users is a requirement of the installation instructions.





© 2012 SAP AG 51

Creating BPF Step Generates “Resource with identifier „65024‟ not found” Error

The administrator creates a BPF step and clicks on OK . The following error is seen:

When creating a BPF step the Driver Dimension must be set before completing the step.

Click on Define Step Region Criteria , fill in the driver dimensions and owner property (members are not

required at this point) and then the step can be completed:

Note - the members must be selected before activating the BPF.





© 2012 SAP AG 52

Excel Client Issues – Logging on and Excel Environment

Planning and Consolidation Tab Missing in Excel

Assuming that BPC is installed correctly, it is likely that the add-in has been disabled:

This can happen if Excel becomes unstable and/or crashes. The add-in needs to be re-enabled in Excel(this is documented in SAP Note 1630104):

Step Actions

1. Click on the round Office button in the top-left of Excel.

2. Click on Excel Options at the bottom of the list

3.

Click on Add-Ins on the left-hand side menu and Planning and Consolidation should appear as a COM Add-in in the list.

4.

If it is not in the list it may be disabled, so under Manage at the bottom, select Disabled

Items and click on Go .

5. In the resulting pop-up select the BPC Add-In and click the Enable button,





© 2012 SAP AG 53

Log on to BPC Excel generates “Object Variable or With Block variable not set” Error

When logging on you see the following error:

As with the previous error, the Planning and Consolidation tab is also missing. If the previous solution doesnot work then the BPC Office Client has likely become corrupt and should be uninstalled and re-installed.

Log on to BPC Excel generates “Microsoft Excel is waiting for another application to complete an OLEaction” and never logs on

When logging on you see the following error:

Editing dimension members in the Administration client also fails.

None of the files from the BPC .NET server: Input Schedules, Dimension files etc. are being downloaded.

The XceedZip.dll registration has become corrupted in some way. Re-register by running the followingcommand (e.g. Start > Run):

regsvr32 "C:\Program Files\SAP BusinessObjects\PC_NW\XceedZip.dll"

If this succeeds you will see the following message:





© 2012 SAP AG 54

Log on to BPC Excel using Sign Sign-On requests username and password and fails

When logging through the Excel Client Connection Wizard you get asked for your username and passwordand fails:

This will mean that the user‟s network domain account is now locked and they should call the helpdesk to getthis unlocked.

The problem is with cached domain directory credentials and can be cleared by clearing Internet Explorer cache and the BPC connection cache. In Internet Explorer click on Tools and Select internet Options:

On the General tab under Browsing history click on Delete . Then delete Form Data, Passwords and

Cookies in the browsing history. For completeness the user should now reboot.





© 2012 SAP AG 55

If the problem persists then the user should call the IT helpdesk to get their account unlocked (if it is locked)and then should change their Windows password. Wait for 10 minutes after changing the password beforetrying to log on to BPC again.

Logging on results a “The remote name could not be resolved: „planningosoft‟

When logging on a user sees the follow message (or slight variant):

Assuming the user has used the correct server name (PLANNING) the addition on osoft at the end of theserver name occurs when a user has logged off and on again (or changed Application Sets) in the sameExcel session. They will actually have been asked to clog on twice.

This error is benign and can be ignored. If Excel is closed before logging on again the error will not be seen.

All Menu Bars and Ribbons Disappear in Excel

When the laptop is under load and BPC Excel Client is minimised or behind other windows, the Menu bar and Ribbon can disappear when bringing it back into focus. To restore them, un-dock the BPC Action Paneand dock it again. If this does not work then close and re-open Excel.





© 2012 SAP AG 56

Refreshing Client Cached Dimensions, Templates and Application Information

As previously detailed the client cache is stored in the C:\Program Files\SAPBusinessObjects\PC_NW\Cache directory. These files can become corrupt so can be deleted. This can bedone from the eTools menu directly or in the Client Options:

From the Client Options the locally cached Input Schedules and Reports can also be deleted as well asclearing all system connectivity information (in this case the user will need to run through the Import Wizardagain as no connection information will be present).

Note that the Planning and Consolidation local folder cannot be changed as the user will not have access tothis area of the registry.





© 2012 SAP AG 57

Excel Client Issues – Reporting and Data Manager

Complex non-BPC Spreadsheets are slow to Open and slow to Edit

Large and/or complex non-BPC spreadsheets, especially ones with many links, are slow to open and toupdate when logged on to BPC. These spreadsheets do not contain (and have never contained) EvDREqueries.

When opening the spreadsheet or updating, a BPC message appears in the progress bar on the bottom leftof the Excel window:

To prevent this from happening, the default BPC refresh options should be turned off for the spreadsheet:

Step Actions

1. Log off from BPC and open the spreadsheet concerned.

2. Log on to BPC whilst the spreadsheet is open.

3. Click on eTools > Workbook Options.

4.

Under Refresh options untick:Refresh workbook on worksheet update;

Refresh workbook on workbook open;





© 2012 SAP AG 58

All Input Schedules and Reports generate an EvDRE Error for a Particular User

This symptom is a generic EvDRE error so this fix only applies if all EvDRE reports are failing for a particular user:

This can be symptomatic of an inconsistent Dimension so refresh the client side dimension cache.

If this symptom is happening to a group of users then the application being queries may need to beprocessed. If this does not work there may be a problem with the report itself – such as using invaliddimension members. In this case check the report/ template.

All Input Schedules and Reports generate an EvDRE Error after Data Load

If refreshing the dimension members doesn‟t work then the next step is to process the application in whichthe error is occurring. This is done in the Administrative Client – do not do this if any data loads, exports or

optimize packages are running.

Step

Actions

1.

Log into the BPC Administration Client and select the application to be processed.Click on Modify Application.





© 2012 SAP AG 59

Step

Actions

2.

Click on Modify Application.

3.

The application is successfully processed.

If this still does not work then run a Lite Optimise. Do not run this from the Administration Client in case a jobis running – use the Data Manager package.





© 2012 SAP AG 60

All Input Schedules and Reports generate an EvDRE Error for all Users/ Applications

Occasionally the IIS .NET Application Pool can stop responding and Input Schedules and Reports generatea generic EvDRE error that retries every 30s (as in the previous section).

In case you should restart the ASP .NET 2.0 Application Pool in IIS Manager on the .NET server:

This issue is less clear when there are multiple .NET servers (there are 4 in production). You can test this bylogging on to a specific server in the Connection Wizard rather than the load balancer name.

Note that if any user is currently running a query or sending data via that Application Pool, their connectionwill be terminated.

Using any eData Component Generates an Error

When trying to use any eData component (e.g. Run Package) an error is generated:

The EvServerDataMgr COM+ component has failed to start. The service account password may havechanged.





© 2012 SAP AG 61

Input Schedule Send Data Gives Overflow Error

Sending data from an Input Schedule results in the following error:

The error is some data being sent has more than 7 decimal places.

Users cannot see the Data Manager Package Logs – blank error messages

If no Data Manager logs are viewable from within Data Manager – users see a blank screen and a blankerror message – then the EvServerDataMgr COM+ component should be restarted (this is a BASIS task).





© 2012 SAP AG 62

Data Manager Packages are recorded as Cancelled Status

Users running a package see the status as Cancelled even though in the Detail the log states success:

If this happens to a Run BW Process Chain Package then check the Process Chain in the BW system (BWtechnical task). This can happen (for instance) if the period selection is incorrectly or not populated in BAUBW for the inbound transaction data Package Links.

Data Manager Export Packages get cancelledPackages with the retraction BAdi get cancelled with message: Error found in NetWeaver BI, RSDRI readerror OTHERS.

This happened after a system copy and could be resolved with setting the application‟s cube load behaviour

to „normal‟ and then back to „planning-cube‟. After that a light optimization worked.





© 2012 SAP AG 63

Admin – Loading Master Data Generates a Hierarchy Does not Exist Error

In the second step to loading a dimension (Import BW MasterData process chain), the package fails with aFailed to read hierarchy xxxxx error:

After a transport the Data Manager Hierarchy selections are lost and need to be added. In the OrganisePackage Link List, edit the relevant Package Link and add the hierarchy to both the following steps:

Load MD Attributes into BPC;

Load MD Hierarchy into BPC;

Step Actions

1. Edit the Package Link (Organise package List), select the Load MD Attributes into BPC

Package and click on Set Prompt .





© 2012 SAP AG 64

Step Actions

2.

Click on Set Selection and click on OK to the error message.

3.

Select the Hierarchy tab and enter the hierarchy details and the Key Date. Click on OK .





© 2012 SAP AG 65

Step Actions

4.

Select the Load MD Hierachy into BPC Package and click on Set Prompt . Make the

same hierarchy changes as before and click on OK .

5. Save the Package Link and Package Link List.





© 2012 SAP AG 66

BPC Web Interface

No BPF Interface is displayed when Logging on to BPC Web

When BPC Web is launched there is no BPF interface at all (as opposed to just no BPF‟s). This can happenespecially in the Citrix environment:

Either refresh the browser or click on the Business Process Flows link:





© 2012 SAP AG 67

Viewing BPF‟s in Web Interface Times Out

When viewing Business Process Flows (BPFs) in the BPC Interface for Web the main screen displays a waittimer and eventually times out:

The interface is trying to load too much data. This should not be the case for a user but an administrator may be able to see many steps for all BPFs. In normal operation this should not be a problem but if a BPF iscreated in error with too many steps (e.g. every Cost Centre in the hierarchy) and has not been removedcorrectly, then this error could occur.

Rather than searching through all the BPFs, the number of BPF Instance Steps generated can be checkedby looking in table UJB_STEP_RGN. Order by the third ID used in BPF:





© 2012 SAP AG 68

Export this result set to an Excel spreadsheet, select the third ID used in BPF column and use the Subtotalbutton:

In the above example the instance ID 4ECD051441EA3C80E10080000A09652C has 4795 steps. Use theinstance ID to find the BPF template ID:

Template ID is 4EA541F230420303E10080000A09652C. Use this to find the template:

In this case the template has been deleted (status of D) so the instance steps can be deleted from theUJB_STEP_REGION table.





© 2012 SAP AG 69

Appendix 1. Transformation and Conversion Files

An example outbound Transformation file :*OPTIONSFORMAT = DELIMITEDHEADER = YESDELIMITER = ,

AMOUNTDECIMALPOINT = .SKIP = 0SKIPIF =VALIDATERECORDS=YESCREDITPOSITIVE=YESMAXREJECTCOUNT=-1ROUNDAMOUNT=

*MAPPINGZACCOUNT=ACCOUNTZASSCL=ASSETCLASSESZCOSTCTR=COSTCENTREZDATASRC=DATASOURCEZDETAIL=DETAILZGRADETYP=GA_GRADETYPEZRPTCURR=RPTCURRENCYZBPCTIME=TIMEZTRADEP=TRADEPARTNERSZVERSION=VERSIONZAMOUNT=SIGNEDDATA

*CONVERSIONZCOSTCTR=EXPORT_TD_INDIRECTCOSTS_CONV.xls!COSTCENTREZGRADETYP=EXPORT_TD_INDIRECTCOSTS_CONV.xls!GA_GRADETYPEZASSCL=EXPORT_TD_INDIRECTCOSTS_CONV.xls!ASSETCLASSESZDETAIL=EXPORT_TD_INDIRECTCOSTS_CONV.xls!DETAILZTRADEP=EXPORT_TD_INDIRECTCOSTS_CONV.xls!TRADEPARTNERSZVERSION=EXPORT_TD_INDIRECTCOSTS_CONV.xls!VERSIONZDATASRC=EXPORT_TD_INDIRECTCOSTS_CONV.xls!DATASOURCEZACCOUNT=EXPORT_TD_INDIRECTCOSTS_CONV.xls!ACCOUNT

An example Conversion file for the outbound dataflow:





© 2012 SAP AG 70

Appendix 2. Program to Delete Contents of Custom Z table******************************************************************************************** * Report : Z_BPC_DELETE_RETRACT_DATA

* * AUTHOR :

* * DATE(DD/MM/YYYY) : 28/09/2011

* * DEV STREANM : BW

* * TRANSPORT NO. : BWDK900334

* * DESCRIPTION : Delete BPC Retarcation Data for an Application

* *

* ********************************************************************************************

********************************************************************************************

REPORT z_bpc_delete_retract_data.

DATA:ls_control TYPE z_bpc_control,lv_tabname TYPE tabname, " Placeholder for the destin

ation table name. ls_message TYPE uj0_s_message,lv_variant TYPE rspc_variant,l_s_log TYPE rspcabapasync .

PARAMETERS: p_appst LIKE uja_appl-appset_id OBLIGATORY.PARAMETERS: p_appli LIKE uja_appl-application_id OBLIGATORY.

START-OF-SELECTION.* Get the target table name from the control table Z_BPC_CONTROL

SELECT SINGLE * FROM z_bpc_control INTO ls_controlWHERE appset_id = p_appst

AND app_id = p_appli.

lv_tabname = ls_control-dest_tabname.IF lv_tabname IS INITIAL.

MESSAGE e000(zpsrp_bpc_msgs) "INTO ls_message-message WITH 'Retract Z-table not found for' p_appstp_appli' ' .

ELSE.DELETE FROM (lv_tabname).COMMIT WORK.

ENDIF.





© 2012 SAP AG 71

Appendix 3. BAdi for Retraction

The custom implementation class is created via transaction SE80 and choosing the „Class / Interface‟ optionfrom the drop down box.

This example code is only to give an idea of how the retraction BADI could be coded. It is not meant as atemplate and cannot be copied into a customer system.

METHOD if_ujd_retract~retract.*********************************************************************** * ENHANCEMENT IMPLEMENTATION : ZPSRP_RETRCT_BPC_DATA * * IMPLEMENTATION CLASS : ZCL_RETRCT_BPC_DATA * * BADI Filter : ZBPC2BW * * AUTHOR : SWATI PATNAIK / Arun Kumar * * DATE(DD/MM/YYYY) : 04/08/2011 / 14/02/2012 * * DEV STREANM : HCP * * TRANSPORT NO. : BWDK900843 * * DESCRIPTION : BADI implementation for retracting data* * BPC to a Staging Table fro BW. This can * * will work for FINANCE, HEADCOUNT, * * PROJECTS & INDIRECTCOSTS *

*********************************************************************** * TYPE-POOLS abap . ***** BADI implementation for retracting data from BPC to BW ***** **** Dynamic

** Data defination TYPES: BEGIN OF ty_vers_data,

id TYPE char20,year TYPE char4,version_type TYPE char10,

END OF ty_vers_data.TYPES: BEGIN OF ty_vers_data02,

/bic/zversion TYPE char15,

/bic/zbfyodp TYPE char4,END OF ty_vers_data02.

DATA: it_vers TYPE HASHED TABLE OF ty_vers_data02WITH UNIQUE KEY /bic/zversion,ls_vers LIKE LINE OF it_vers.

TYPES: BEGIN OF ty_field,bpc_field TYPE fieldname,zfield TYPE fieldname,

END OF ty_field.

DATA: lt_fields TYPE HASHED TABLE OF ty_fieldWITH UNIQUE KEY bpc_field,ls_fields LIKE LINE OF lt_fields.

TYPES: BEGIN OF ty_acct_data,account TYPE char20,group TYPE char5,

END OF ty_acct_data.DATA:

lv_tabname TYPE tabname, " Placeholder for the de





© 2012 SAP AG 72

stination table name. lv_index TYPE sy-tabix,lv_member TYPE uj_dim_member,lv_acct TYPE uj_dim_member,lv_acctn TYPE numc10,lv_version TYPE uj_dim_member,

*

ls_acct TYPE ty_acct_data,ls_hcpdata TYPE zhcp_retract,ls_control TYPE z_bpc_control,ls_comments TYPE /1cpmb/mrxatcmt,ls_message TYPE uj0_s_message,ls_header TYPE string,ls_tab_line TYPE REF TO data,lt_attr_list TYPE uja_t_attr_name,ls_attr_list TYPE uj_attr_name,

* lt_indata TYPE TABLE OF uj_dim_member,lt_acct TYPE HASHED TABLE OF ty_acct_data

WITH UNIQUE KEY account,

lt_header TYPE TABLE OF string,lt_field_list TYPE ddfields,lt_table TYPE REF TO data, " Dynamic table lt_data TYPE REF TO data,lt_comments TYPE STANDARD TABLE OF /1cpmb/mrxatcmt,lt_comment TYPE STANDARD TABLE OF /1cpmb/mrxatcmt,lt_hcp_data TYPE STANDARD TABLE OF zhcp_retract,

* lo_master_data TYPE REF TO cl_uja_dim,lo_struct TYPE REF TO cl_abap_structdescr,rf_data TYPE REF TO data.

*

* FIELD-SYMBOLS:

<ls_dataline> TYPE ANY,<lv_line> TYPE ANY,<lv_value> TYPE ANY,<lv_version> TYPE ANY,<lv_group> TYPE ANY,<lv_acct> TYPE ANY,<lv_account> TYPE ANY,<lv_costcc> TYPE ANY,<lv_datasrc> TYPE ANY,<lv_timewrit> TYPE ANY,

<lv_time> TYPE ANY,<lv_endprd> TYPE ANY,<lv_funct> TYPE ANY,<lv_genjob> TYPE ANY,<lv_gradetyp> TYPE ANY,<lv_year> TYPE ANY,<lv_position> TYPE ANY,<lv_amount> TYPE ANY,<lv_rptcurr> TYPE ANY,<lv_startprd> TYPE ANY,





© 2012 SAP AG 73

<lv_ver> TYPE ANY,<lv_emp> TYPE ANY,<ls_indata> TYPE ANY,<ls_data> TYPE zhcp_retract,<ls_acct_data> TYPE ANY,<ls_vers> TYPE ty_vers_data02,<ls_field_list> TYPE dfies,

<lt_acct_data> TYPE HASHED TABLE,<lt_table> TYPE STANDARD TABLE,<lt_data> TYPE STANDARD TABLE,<lt_indata> TYPE STANDARD TABLE.

* * DATA: lv_i TYPE i VALUE '1'. *** To be used only for debugging use tranx SM50 and look for class ZCL_RETRCT_BPC_DATA * DO. * IF lv_i = 2. * EXIT. * ENDIF. * ENDDO.

* Get the target table name from the control table Z_BPC_CONTROL SELECT SINGLE * FROM z_bpc_control INTO ls_control

WHERE appset_id = i_source_info-appset_idAND app_id = i_source_info-app_id.

lv_tabname = ls_control-dest_tabname.

IF lv_tabname IS INITIAL.

MESSAGE e000(zpsrp_bpc_msgs) INTO ls_message-message WITH text-001

i_source_info-appset_idi_source_info-app_id' ' .

APPEND ls_message TO et_message.ENDIF.

SELECT /bic/zversion /bic/zbfyodpFROM /bic/mzversionINTO CORRESPONDING FIELDS OF TABLE it_versWHERE objvers = 'A'.

**** IF i_source_info-app_id = 'FINANCE'(026).

* READ the ACCOUNT Dimension master data.

TRY.CREATE OBJECT lo_master_dataEXPORTING

i_appset_id = i_source_info-appset_idi_dimension = 'ACCOUNT'(027).

CATCH cx_uja_admin_error . "#EC NO_HANDLER ENDTRY.

REFRESH: lt_attr_list.ls_attr_list = 'ID'(003) .





© 2012 SAP AG 74

APPEND ls_attr_list TO lt_attr_list.ls_attr_list = 'GROUP'(028).APPEND ls_attr_list TO lt_attr_list.

* Call method using object created above to read member data. TRY.

CALL METHOD lo_master_data->read_mbr_dataEXPORTING

it_attr_list = lt_attr_listif_ret_hashtab = 'X'

IMPORTING er_data = rf_data.

CATCH cx_uja_admin_error . "#EC NO_HANDLER ENDTRY.

ASSIGN rf_data->* TO <lt_acct_data>.

IF <lt_acct_data> IS ASSIGNED.LOOP AT <lt_acct_data> ASSIGNING <ls_acct_data>.

ASSIGN COMPONENT 'ID'(003) OF STRUCTURE <ls_acct_data> TO <lv_account>.

ASSIGN COMPONENT 'GROUP'(028) OF STRUCTURE <ls_acct_data> TO <lv_group>.

ls_acct-account = <lv_account>.ls_acct-group = <lv_group>.

INSERT ls_acct INTO TABLE lt_acct.CLEAR ls_acct.

ENDLOOP.ENDIF.

ENDIF.

CREATE DATA lt_table TYPE STANDARD TABLE OF (lv_tabname).ASSIGN lt_table->* TO <lt_table>.

CREATE DATA lt_data TYPE STANDARD TABLE OF (lv_tabname).ASSIGN lt_data->* TO <lt_data>.

CREATE DATA ls_tab_line LIKE LINE OF <lt_table>.ASSIGN ls_tab_line->* TO <ls_dataline>.

* * Get the component structure of the destination table.

TRY.lo_struct ?= cl_abap_structdescr=>describe_by_name( lv_tabname ).

* Get the key Fields & Components lt_field_list = lo_struct->get_ddic_field_list( ).

ENDTRY.

IF i_source_info-app_id <> 'HEADCOUNT'.

LOOP AT lt_field_list ASSIGNING <ls_field_list>.

ls_fields-zfield = <ls_field_list>-fieldname.





© 2012 SAP AG 75

CASE <ls_field_list>-fieldname.

WHEN 'ZACCOUNT'.ls_fields-bpc_field = 'ACCOUNT'.

WHEN 'ZTRADEP'.ls_fields-bpc_field = 'TRADEPARTNERS'.

WHEN 'ZBPCTIME'.ls_fields-bpc_field = 'TIME'.

WHEN 'ZDETAIL'.ls_fields-bpc_field = 'DETAIL'.

WHEN 'ZVERSION'.ls_fields-bpc_field = 'VERSION'.

WHEN 'ZRPTCURR'.ls_fields-bpc_field = 'RPTCURRENCY'.

WHEN 'ZASSCL'.ls_fields-bpc_field = 'ASSETCLASSES'.

WHEN 'ZDATASRC'.ls_fields-bpc_field = 'DATASOURCE'.

WHEN 'ZCOSTCTR'.ls_fields-bpc_field = 'COSTCENTRE'.

WHEN 'ZGRADETYP'.ls_fields-bpc_field = 'GA_GRADETYPE'.

WHEN 'ZAMOUNT'.ls_fields-bpc_field = 'SIGNEDDATA'.

WHEN 'ZPRFTCTR'.ls_fields-bpc_field = 'PROFITCENTRE'.

WHEN 'ZSEGMENT'.ls_fields-bpc_field = 'SEGMENT'.

WHEN 'ZPROJECTS'.ls_fields-bpc_field = 'PROJECTS'.

ENDCASE.

INSERT ls_fields INTO TABLE lt_fields.

ENDLOOP.ENDIF."IF i_source_info-app_id <> 'HEADCOUNT'.

* When retracting large amounts of data, the data is split into * Packets and this code can be run more than once. Read in * Relevant data from previous package runs for a large load.

CALL FUNCTION 'ZZ_IMPORT_DATA' IMPORTING it_header = lt_header.

* IR data holds the import data ASSIGN ir_data->* TO <lt_indata>.

****************************************************************************************

IF i_source_info-app_id <> 'HEADCOUNT'.

IF <lt_indata> IS ASSIGNED.





© 2012 SAP AG 76

LOOP AT <lt_indata> ASSIGNING <ls_indata>.

* The first time this code is run for a retraction (for large amounts * of data it can be run many times) the first line of table <lt_indata> * will contain the strcuture of the data. We need to store this * in table LT_HEADER *

IF lt_header[] IS INITIAL.* build a list of fields from the header which continas the structure.r

ASSIGN COMPONENT 'LINE'(006) OF STRUCTURE <ls_indata> TO <lv_line>.SPLIT <lv_line> AT ',' INTO TABLE lt_header.

ELSE.

CLEAR: lv_version,lv_acct.

* Load the line contents into lt_indata ASSIGN COMPONENT 'LINE'(006) OF STRUCTURE <ls_indata> TO <lv_line>.SPLIT <lv_line> AT ',' INTO TABLE lt_indata.

* now we can loop and fill the data structure we need

LOOP AT lt_indata INTO lv_member.

* Get the field name for the value in LS_STRING READ TABLE lt_header INTO ls_header INDEX sy-tabix.

CHECK sy-subrc = 0.

* Is this field relavnt for the output table * IF ls_header+0(1) = 'Z'.

READ TABLE lt_field_list TRANSPORTING NO FIELDS "#EC * WITH KEY fieldname = ls_header.

READ TABLE lt_fields INTO ls_fieldsWITH TABLE KEY bpc_field = ls_header.

CHECK sy-subrc = 0.

ASSIGN COMPONENT ls_fields-zfield OF STRUCTURE <ls_dataline> TO <lv_value>.

CHECK sy-subrc = 0.

CASE ls_header.

WHEN 'ACCOUNT'.lv_acct = lv_member.

* lv_acctn = lv_member. * <lv_value> = lv_acctn. * CONTINUE.

WHEN 'ASSETCLASSES'.IF lv_member+0(4) = 'ACL_'.lv_member = lv_member+4(16).

ENDIF.





© 2012 SAP AG 77

WHEN 'VERSION'.lv_member = lv_member+4(16).lv_version = lv_member.

WHEN 'DATASOURCE'.lv_member = lv_member+3(17).

WHEN 'DETAIL'.lv_member = lv_member+4(16).

WHEN 'PROFITCENTRE'.lv_member = lv_member+3(17).

WHEN 'TRADEPARTNERS'.lv_member = lv_member+3(17).

WHEN 'SEGMENT'.lv_member = lv_member+4(16).

WHEN 'ZACCOUNT'.lv_acct = lv_member.

WHEN 'ZVERSION'.lv_version = lv_member.

WHEN 'COSTCENTRE'.lv_member = lv_member+3(17).

WHEN 'GA_GRADETYPE'.lv_member = lv_member+3(17).

WHEN 'PROJECTS'.

IF STRLEN( lv_member ) = 15 AND lv_member+0(1) = 'P'.CONCATENATE lv_member 'P0' INTO lv_member.

ENDIF.

TRANSLATE lv_member USING '- '.CONDENSE lv_member NO-GAPS.

ENDCASE.

<lv_value> = lv_member.

ENDLOOP.

* ASSIGN COMPONENT 'ZVERSION'(007) OF STRUCTURE <ls_dataline> TO <lv_version>.

IF lv_version IS NOT INITIAL.ASSIGN COMPONENT 'ZYEAR' OF STRUCTURE <ls_dataline> TO <lv_year>.

READ TABLE it_vers ASSIGNING <ls_vers> WITH TABLE KEY /bic/zversion= lv_version.

IF sy-subrc = 0.<lv_year> = <ls_vers>-/bic/zbfyodp.

ENDIF.

ENDIF."IF lv_version IS NOT INITIAL. * If it's Finance we are writing to get the account group

IF i_source_info-app_id = 'FINANCE'(026).

IF lv_acct IS NOT INITIAL.ASSIGN COMPONENT 'ZGROUP' OF STRUCTURE <ls_dataline> TO <lv_gr

oup>.

READ TABLE lt_acct INTO ls_acct WITH TABLE KEY account = lv_acct.IF sy-subrc = 0.





© 2012 SAP AG 78

<lv_group> = ls_acct-group.ENDIF.

ENDIF.

ENDIF."IF i_source_info-app_id = 'FINANCE'(026).

APPEND <ls_dataline> TO <lt_table>.CLEAR: <ls_dataline>.

ENDIF."IF lt_header[] IS INITIAL.

ENDLOOP.ENDIF."IF <lt_indata> IS ASSIGNED.

ELSE.IF <lt_indata> IS ASSIGNED.

LOOP AT <lt_indata> ASSIGNING <ls_indata>.

* The first time this code is run for a retraction (for large amounts

* of data it can be run many times) the first line of table <lt_indata> * will contain the strcuture of the data. We need to store this * in table LT_HEADER *

IF lt_header[] IS INITIAL.* build a list of fields from the header which continas the structure.r

ASSIGN COMPONENT 'LINE'(006) OF STRUCTURE <ls_indata> TO <lv_line>.SPLIT <lv_line> AT ',' INTO TABLE lt_header.

ELSE.

* Load the line contents into lt_indata ASSIGN COMPONENT 'LINE'(006) OF STRUCTURE <ls_indata> TO <lv_line>.SPLIT <lv_line> AT ',' INTO TABLE lt_indata.

* now we can loop and fill the data structure we need LOOP AT lt_indata INTO lv_member.

* Get the field name for the value in LS_STRING READ TABLE lt_header INTO ls_header INDEX sy-tabix.

CHECK sy-subrc = 0.

* Is this field relavnt for the output table READ TABLE lt_field_list TRANSPORTING NO FIELDS "#EC *

WITH KEY fieldname = ls_header.

CHECK sy-subrc = 0.

ASSIGN COMPONENT sy-tabix OF STRUCTURE <ls_dataline> TO <lv_value>.

CHECK sy-subrc = 0.

<lv_value> = lv_member.

ENDLOOP.

ASSIGN COMPONENT 'ZVERSION'(007) OF STRUCTURE <ls_dataline> TO <lv_ver





© 2012 SAP AG 79

sion>.ASSIGN COMPONENT 'ZYEAR'(008) OF STRUCTURE <ls_dataline> TO <lv_yea

r>.

READ TABLE it_vers INTO ls_vers WITH KEY /bic/zversion = <lv_version>+4(15).

IF sy-subrc = 0.<lv_year> = ls_vers-/bic/zbfyodp.

ENDIF.

APPEND <ls_dataline> TO <lt_table>.CLEAR: <ls_dataline>.

ENDIF."IF lt_header[] IS INITIAL.

ENDLOOP.ENDIF."IF <lt_indata> IS ASSIGNED.

ENDIF."IF i_source_info-app_id <> 'HEADCOUNT'. ****************************************************************************************

CASE lv_tabname.WHEN 'ZHCP_RETRACT'(009).

* Get comments from /1CPMB/MRXATCMT SELECT * FROM /1cpmb/mrxatcmt INTO TABLE lt_comments

WHERE ( accounthcp = 'ACCHC_COMM04'(010) OR accounthcp = 'ACCHC_COMM05'(011) ).

lt_hcp_data = <lt_table>.

LOOP AT lt_hcp_data ASSIGNING <ls_data>.

* REFRESH: lt_comment.

LOOP AT lt_comments INTO ls_comments WHERE employee = <ls_data>-zemployee

AND costcentre = <ls_data>-zcostcenter

AND version = <ls_data>-zversion

AND datasource = <ls_data>-zdatasrc

AND endperiod = <ls_data>-zendprd

AND functions = <ls_data>-

zparfunctAND genericjob = <ls_data>-

zjobAND gradetype = <ls_data>-

zgradetypAND positionname = <ls_data>-

zhrpositionAND rptcurrency = <ls_data>-

zrptcurrAND startperiod = <ls_data>-





© 2012 SAP AG 80

zstartprd.IF sy-subrc = 0.

APPEND ls_comments TO lt_comment.ENDIF.CLEAR ls_comments.

ENDLOOP.

* SORT lt_comment BY accounthcp datewritten DESCENDING.DELETE ADJACENT DUPLICATES FROM lt_comment COMPARING accounthcp.

* READ TABLE lt_comment INTO ls_comments

WITH KEY accounthcp = 'ACCHC_COMM04'(010).

IF sy-subrc = 0.* ls_hcpdata-zcomment1 = ls_comments-scomment+0(60).

<ls_data>-zcomment1 = ls_comments-scomment+0(60).ENDIF.

READ TABLE lt_comment INTO ls_comments

WITH KEY accounthcp = 'ACCHC_COMM05'(011).

IF sy-subrc = 0.* ls_hcpdata-zcomment2 = ls_comments-scomment+0(60).

<ls_data>-zcomment2 = ls_comments-scomment+0(60).ENDIF.

* MODIFY <lt_table> INDEX lv_index FROM ls_hcpdata.

ENDLOOP.*

MODIFY (lv_tabname) FROM TABLE <lt_table>.

****************************************************************************************

WHEN OTHERS.

* MODIFY (lv_tabname) FROM TABLE <lt_table>. INSERT (lv_tabname) FROM TABLE <lt_table>.

ENDCASE.

* The structure of the input data only comes once. If there are subsequent packages * we need to export this to global memeory.

IF i_more_data IS NOT INITIAL.

CALL FUNCTION 'ZZ_EXPORT_DATA' EXPORTING

et_header = lt_header.

ENDIF.

* ENDIF. " if <lt_indata> is ASSIGNED. ENDMETHOD.





© 2012 SAP AG 81




Copyright

© Copyright 2012 SAP AG. All rights reserved.

No part of this publication may be reproduced or transmitted in any form or for any purpose without the express permission of SAP AG.The information contained herein may be changed without prior notice.

Some software products marketed by SAP AG and its distributors contain proprietary software components of other software vendors.

Microsoft, Windows, Excel, Outlook, and PowerPoint are registered trademarks of Microsoft Corporation.

IBM, DB2, DB2 Universal Database, System i, System i5, System p, System p5, System x, System z, System z10, System z9, z10, z9,iSeries, pSeries, xSeries, zSeries, eServer, z/VM, z/OS, i5/OS, S/390, OS/390, OS/400, AS/400, S/390 Parallel Enterprise Server,PowerVM, Power Architecture, POWER6+, POWER6, POWER5+, POWER5, POWER, OpenPower, PowerPC, BatchPipes,BladeCenter, System Storage, GPFS, HACMP, RETAIN, DB2 Connect, RACF, Redbooks, OS/2, Parallel Sysplex, MVS/ESA, AIX,Intelligent Miner, WebSphere, Netfinity, Tivoli and Informix are trademarks or registered trademarks of IBM Corporation.

Linux is the registered trademark of Linus Torvalds in the U.S. and other countries.

Adobe, the Adobe logo, Acrobat, PostScript, and Reader are either trademarks or registered trademarks of Adobe SystemsIncorporated in the United States and/or other countries.

Oracle is a registered trademark of Oracle Corporation.

UNIX, X/Open, OSF/1, and Motif are registered trademarks of the Open Group.

Citrix, ICA, Program Neighborhood, MetaFrame, WinFrame, VideoFrame, and MultiWin are trademarks or registered trademarks of Citrix Systems, Inc.

HTML, XML, XHTML and W3C are trademarks or registered trademarks of W3C®, World Wide Web Consortium, MassachusettsInstitute of Technology.

Java is a registered trademark of Oracle Corporation.

JavaScript is a registered trademark of Oracle Corporation, used under license for technology invented and implemented by Netscape.

SAP, R/3, SAP NetWeaver, Duet, PartnerEdge, ByDesign, SAP Business ByDesign, and other SAP products and services mentionedherein as well as their respective logos are trademarks or registered trademarks of SAP AG in Germany and other countries.

Business Objects and the Business Objects logo, BusinessObjects, Crystal Reports, Crystal Decisions, Web Inte lligence, Xcelsius, andother Business Objects products and services mentioned herein as well as their respective logos are trademarks or registeredtrademarks of Business Objects S.A. in the United States and in other countries. Business Objects is an SAP company.

All other product and service names mentioned are the trademarks of their respective companies. Data contained in this documentserves informational purposes only. National product specifications may vary.

These materials are subject to change without notice. These materials are provided by SAP AG and its affiliated companies ("SAP

Group") for informational purposes only, without representation or warranty of any kind, and SAP Group shall not be liable for errors or omissions with respect to the materials. The only warranties for SAP Group products and services are those that are set forth in theexpress warranty statements accompanying such products and services, if any. Nothing herein should be construed as constituting anadditional warranty.

Documents

SAP BPC 7.5 NetWeaver - BW 7.01 Integration.pdf