Professional Documents
Culture Documents
3. Design-time
Transformation Files
Conversion Files
UI Script
Security
Large Files
Delivered Objects
4. Future
5. Wrap-up
BPC Versions
BPC 5.x
Previously
MS Version
SAP NetWeaver
Today
Future
BPC 7
BPC 7.5
Migration
Utility
BPC 7 M
BPC 7.5 M
Microsoft based
SAP NW based
Data Manager
Data Manager is an SAP Business Planning and Consolidation (BPC) module that helps you
manage loading, transforming, and manipulating data
The focus of this session is to discuss Data Manager capabilities in general, however, when
examples are given, the details will be described for the NetWeaver version of the product
As opposed to using typical ETL tools such as Microsoft SQL Server Integration Services
(SSIS), or NetWeaver BI ETL (Process Chains, InfoPackages, DTPs, etc), the Data
Manager provides basic ETL operations to an business user (end-user).
The BPC User has no idea that this underlying technology is being used when they are
using the Data Manager
Data Manager includes a delivered with a set of packages to import, copy, clear and move
data within and across applications
Data means transactional data as well as master data (no meta data)
Data Manager
Within the two platforms, there are two different underlying base technologies employed
Object:
Acronym
Description
Data Manager
DM
Package
The operational unit that user can execute for a data process, like import,
export, etc.
The module to deal with specific functionality. E.g. load helps to transfer
data from file to cube, from cube to cube, from cube to file. Package is built
on Process Chains which include task(s).
Process Chain
InfoCube
DTS (SQL 2000)
SSIS (SQL 2005)
Dimension
PC
DTS or SSIS
Measure
Transformation File
Conversion File
From
the Launch Page, click SAP Business Planning and Consolidation for Excel.
From the Action Pane, click Manage Data.
3. Design-time
Transformation Files
Conversion Files
UI Script
Security
Large Files
Delivered Objects
4. Future
5. Wrap-up
3. Design-time
Transformation Files
Conversion Files
UI Script
Security
Large Files
Delivered Objects
4. Future
5. Wrap-up
Data
The
packages that come with BPC 7.0 are designed to be dynamic so that you do
not need to modify the packages in order for them to work with your applications
and dimensions.
You might want to modify packages to behave differently or to perform
additional tasks.
You can make modifications to the packages supplied with BPC (not best
practice) or use those packages as templates to build packages as per your
requirements
A typical activity a user would do would be to load a flat file into a BPC application (cube)
To do so, the user would first upload data to the BPC File Service as described below
Within the BPC 7.0NW product, files are stored within the NetWeaver database, whereas
within the BPC 7.0M product, files are stored on the .NET File Server (file system)
NOTE: The following web admin parameters affect the behavior of file upload
ALLOW_FILE_SIZE: This is the maximum file size a user is allowed to upload. The default value is
100 MB.
DEFAULT_EXTENSIONS: This is the list of default extensions that are allowed. This list includes:
XLS,XLT,DOC,DOT,PPT,POT,XML,MHT,MHTML,HTM,HTML,XLSX,XLSM,XLSB,ZIP,PDF,PPTX,PPT
M,POTX,POTM,DOCX,DOCM,DOTX,DOTM,CDM,TDM,PNG,GIF,JPG,CSS,MRC
In some cases, a user may want to download a file from the BPC File Service
To do so:
The files for data manager have special storage within the NW BI Database
The files are stored in a special generated table, not as a compressed file within file
service.
Data Preview
After
uploading a file, it is a good idea for users to preview the data just to ensure
that you havent made any mistakes with your file and the file is in the expected
format
Data
Preview is accessed by clicking Preview data file from the Action Pane.
It allows you to preview the first 200 lines of a data file.
The
source file for a data import can be a text file containing delimited strings.
The
Delimited
Fixed - requires a first row defining the name and position of all dimensions.
The
Variant - allows the user to define the name and position of the dimensions using multiple
lines beginning with an asterisk (*).
While the above example is very simple, some extra features of the variable format can
demonstrate its potential as a more useful tool.
Variable Format
Example 1
Repetitive field values can be moved into the header section. For example, the above file
could also be read in the following format, where the value of the category (ACTUAL) and
time (1999.Jan) are set in the header section and removed from the value rows
*<DIMENSION>=<VALUE> specify the value of the dimension, this has the same effect
with *NEWCOL command in mapping section. The line start with is the comment line
which will be skipped during process.
Variable Format
Example 2
If one of the pre-defined values changes along the body of the file, a redefinition of the
current member can be inserted anywhere in the file and as many times as desired, like in
this example:
If the *<Dimension> =<value> header occurs in the middle of data file, all the records
following this header are affected, but the records before the header will not.
Variable Format
Example 3
A set of members of one or more dimension can span across multiple columns (Typically 12
months of budget values). The following example of header section will accept 12 value
records:
Essentially, the variable format allows the user to specify which dimensions are in the page (CATEGORY=ACTUAL), which dimensions are in
column (TIME=1999.Jan, 1999.Feb, etc.) and which dimensions are in row (ENTITY,ACCOUNT,PRODUCT,PERIODIC).
Irrespective of the format of the source file, the output file will always be in the "fixed format" described for the input file, i.e:
The first line will contain the delimited list of all dimension names with their corresponding positions for the data fields.
All subsequent lines will define one data cell per line.
For example, the above 12 periods variable format file will generate the following output (if we exclude any conversion of the members labels):
users who are familiar with menus instead of the action pane, BPC has an
eData dropdown menu to choose all the actions available within Data Manager
action pane
Menu item
Run Package
Description
Opens the Run Package dialog box, where you can run a package for a user, team, or
company.
Package Schedule Status
Opens the Package schedule status dialog box, where you can view and edit
scheduled packages.
View Status
Opens the View Status dialog box, where you can see the status of currently running
or previously run packages.
Organize Package List
Opens the Organize Package List dialog box, where you can add packages and assign
them to teams.
Manage Team User Package Access Allows administrators to assign packages in certain teams to the users who belong to
these teams.
New Transformation File
Creates a new transformation file Excel workbook.
Manage Transformation File
Show file list and allow you to edit, save, copy, and validate transformation files.
Validate and Process
Checks the structure and syntax of transformation files and reports any potential
Transformation File
problems.
Copy Transformation File
Creates new transformation files based on existing ones that you can then modify for
your needs.
New Conversion File
Creates new conversion files.
Manage Conversion File
Allows you to edit, save, copy, and validate conversion files.
Validate and Process Conversion
Checks the structure and syntax of conversion files and reports any potential
File
problems.
Copy Conversion File
Creates new conversion files based on existing ones that you can then modify for
your needs.
Add Conversion Sheet
Adds a sheet to an existing conversion file. You can have multiple sheets in one
conversion file in order to use different sheets depending on the context of the
transformation.
Clear Saved Prompt Values
Clears saved values for all Data Manager dialog boxes. Values include references to
folders and lists of members.
Data Manager Help
Opens the help (Only available in BPC 7.0M, not BPC 7.0NW)
About Data Manager
Displays version information about Data Manager.
For
users who dont like the action pane or menu, BPC also has a Data Manager
toolbar
Icon
Task
Run Package
View Status
New Transformation File
Manage Transformation
File
Validate and Process
Transformation File
Copy Transformation File
New Conversion File
Manage Conversion File
Validate and Process
Conversion File
Copy Conversion File
Add Conversion Sheet
<Selected Dimension>
Description
Opens the Run Package dialog box, where you can run a package
for a team and application.
Opens the View Status dialog box, where you can see the status of
currently running or previously run packages.
Creates a new Transformation File Excel workbook.
Sub menus allow you to edit, save, copy, and validate
transformation files.
Checks the structure and syntax of transformation files and
reports any potential problems.
Creates new transformation files based on existing ones that you
can then modify for your needs.
Creates new conversion files.
Sub menus allow you to edit, save, copy, and validate conversion
files.
Checks the structure and syntax of conversion files and reports
any potential problems.
Creates new conversion files based on existing one that you can
then modify for your needs.
Adds a sheet to an existing conversion file. You can have multiple
sheets in one conversion file in order to use different sheets
depending on the context of the transformation.
Works with the Show Member List button to show the Data
Manager member selector for the selected dimension.
Show Member List button Clicking this button shows the Data Manager member selector.
3. Design-time
Transformation Files
Conversion Files
UI Script
Security
Large Files
Delivered Objects
4. Future
5. Wrap-up
When scheduling Data Manager Packages, you have the following toolbar to help
Icon
Task
View Status
Description
View the status of all scheduled and finished packages
New Automation
Edit Automation
Run Automation
Run an automation
Data Upload
Data Download
Exit
Data Manager Automation allows you to save particular schedules to reusable macro files
NOTE: To refresh the view, you can choose Refresh status every and specify the polling time
to refresh the job list.
The detailed log will give you detailed information for success or failed jobs:
The runtimes for each process type within the process chain
DEMO
3. Design-time
Transformation Files
Conversion Files
UI Script
Security
Large Files
Delivered Objects
4. Future
5. Wrap-up
Organizing Packages
Packages are arranged for the convenience of the customer and their end-users.
All packages in company are visible and available to all users with Data Manager task access
Packages can also be organized by defined security teams. In the image below, admin is a team of users.
The list is NOT a reflection of available packages, it is a reflection of what packages are available to the
users of an application.
These packages are copied from an application when you create a new application and are delivered
by default for all applications
Organize Package
Organize package is controlled by administrators and team leaders (only for their teams)
Package options
Add - allows authorized users to select from available packages on the server
Move moves a package between teams and/or package groups, it is common to remove
rarely used or potentially damaging packages from the company team to the admin team
Within the Company area or within a Team, you can create Package Groups which act like folders to
organize your packages within a team.
To do this, right click on any folder and choose Add Package Group
In BPC 7.0 NW, a Data Manager Package can be created from a BPC Process Chain
To Create a New Package, go to Manage Data -> Maintain Data Management -> Manage
Packages -> Add Package
In BPC 7.0NW, only one package type is available (called Process Chain)
You can then choose which process chain to use for Data Manager
In BPC 7.0M, the package types allow you to choose SSIS packages on the file system
You can then name your BPC Data Manager Package (ie. Import into Financial Application)
NOTE: The following screenshots are from the BPC 7.0NW version of the product
This is just used for organization and categorization. The group field has no functional impact.
This allows you to control who has access to run the package: A user or an administrator.
It only makes sense to flag either User Package or Admin Package but not both.
If you flag Admin Package, this will take precedence, and ignore that User Package is flagged
If the task type is flagged as Admin Package only users who are BPC Administrators will be able to run
this package.
This package can still be saved to any team (even non-Admin) teams, but only Administrators can run
this package
A BPC Administrator is defined by a user who has access all the DM Tasks assigned see the list
below
User Package can be seen by all BPC Users that are assigned Execute Data Management task security
Packages can be assigned to teams using the menu Manage team user package access by a team leader
or as part of organize packages if an administrator
The primary purpose is to restrict a user from running a package that could damage to the data like clearing
all data (zero values) by accident.
NOTE:
Special Package
Modify Package
BPC 7.0 allows for the modification of a package via the BPC Excel eData interface
Package type
Package name
Location
Task type
User
Admin
To assign a package to a team, go to Manage Data -> Maintain Data Management -> Manage team
userpackage access
Only packages that are flagged as Task Type = User Package and not flagged with Task Type =
Admin Package will be allowed to be executed by BPC Users that have the Execute
You will not see any packages within this list that have been flagged as Admin Package
In addition to using the context menu to organize package, BPC provides a toolbar to organize packages
After changes are complete, be sure to save your changes to the DM package list
Icon
Task
Add Package
Modify Package
Copy Package
Description
Used to add a new data manager package (choose the Process
Chain to assign)
Allows you to update package definition
Move Package
Remove Package
Delete a pacakge
may want to customize the list of packages you run often so you do
not have to find the packages each time. You do this using the
Selected List button on the Run Package dialog box.
You can also use the Selected List dialog box for the following: Use
the data file transfer button to upload packages to the server (see
Transferring data files) or use the view package status button to
view package status.
Users can create a package list using the Selected List
functionality
organize
SAP 2008 / SAP TechEd 08 / IM106 Page 41
3. Design-time
Transformation Files
Conversion Files
UI Script
Security
Large Files
Delivered Objects
4. Future
5. Wrap-up
Transformation Files
Process
Transformation
DEMO
Transformation Files
SAP 2008 / SAP TechEd 08 / <Session
IM106 Page
ID>44Page 44
the character specified in this option must differ from the character specified for the DELIMITER.
Default Value: Period
CONVERTAMOUNTWDIM = <dim_name>
Optional Parameter
Specifies which dimension to look at for value calculations.
You must specify a dimension conversion sheet using the Amount *Conversion option
If there is no formula in the Formula column of the Amount conversion sheet this parameter has no affect at all. For
example, the Formula column has the following formula: Value*1.10. All accounts will be increased by 10% during the
conversion.
Default Value: Account
CREDITPOSITIVE = YES | NO
Required Parameter
If No, all amounts referring to an ACCOUNT type (LEQ, INC) will have their signs reversed.
Default: YES
DELIMITER = <text_character> | SPACE | TAB
Required Parameter
If the FORMAT option is set to DELIMITED, this option defines the single character that is the delimiter between
columns. use the keywords SPACE or TAB if space- or tab-delimited.
Default: , (comma)
special character between each column of data, defined by the Delimiter option (below). Fixed means that the data is
in a fixed field format. Use the FCOL mapping option.
SUPPRESSCHARACTER = abc will remove all abc occurs in the data records.
Default: <empty>
Consolidation. For example, the Amount field is always moved to the end of the records even though it might be
written in the first line of the mapping section.
If NO, will not validate. In this case, if the mapping section is out of order or just wrong, fields will be skipped.
SAP 2008 / SAP TechEd 08 / IM106 Page 48
While this is supported, it will just cause confusion by setting this to yes
This is there for legacy reasons
The *MAPPING section of the transformation file defines how data is mapped to your
Business Planning and Consolidation Application
*COL(A)
*COL(A,B:C)
*FCOL(A:B)
*MVAL(A:B)
*NEWCOL(A)
*Str(string)
*Pad(A,B,C,D)
By default, Data Manager associates fields to header names when you have a header row in
your data file. This makes it easier to define mappings in this section of the transformation file.
For example, if you have a header row and it defines a column named "AccountVal," you can
map the Account dimension to the Account field from the data file this way:
Account = AccountVal
Defines a dimension for a field in the data file when the data file does not have a header row.
See the note below about automatic field names when you do have a header row.
Example:
Account =*COL(2)
Example:
Account=*COL(3,1:4)
When using Fixed format data files, this option allows you to define the start and end
character columns for each field. In the example below, the columns 4 through 7 represent
the Account dimension.
Example:
Account=*FCOL(4:7)
Use this command if your data file has multiple period columns. For example, if you have
columns that are like this:
Account,Category,DATASRC,entity,IntCo,RptCURRENCY,JAN,FEB,MAR,APR,MAY,JUN
,JUL,AUG,SEP,OCT,NOV,DEC
You would use Time = *MVAL(7:18), since columns 7 through 18 contain data based on time
periods. Using this command requires that you use a Time.xls conversion sheet. See the
sample Time.xls conversion file, located in the ConveresionFiles folder, for more information.
If your data does not have a header row, the time periods will be named P1, P2, P3,...,PN
by default.
Example:
Time = *MVAL(7:18)
A = dimension member
Example:
Account=*NEWCOL(Revenue)
Adds a text string to the members of a column. Useful if you need to map data file fields to
fields in your application that have the same names, except they have extra characters
appended or in front of the field name.
Example:
Arguments:
B = Total length
C = Padding direction
D = Padding character
Use to format exported data into fixed-width records. Use in conjunction with the "None"
delimiter. The Padding character is optional and is a space by default.
NOTE: This command is only valid in delimited format and with header turned ON
Example:
Account=*Pad(Account,10,L)
Account=*Pad(Account,10,L,0)
*IIf() Example 1
Example 1:
Entity, SEntity
U1000000, US01
Z2000A01, CA03
K3430000, JP04
Entity, SEntity
US01, US01
A01, CA03
ERR, JP04
*IIf() Example 2
Example 2:
PRODUCT,
ID,
ENTITY
14,
85,
52
AB,
CD,
EF
GH,
IJ,
KL
PRODUCT,
ID,
ENTITY
MHarn,
85,
52
AB,
XX,
EF
YY,
IJ,
KL
Besides the simple header(the header with only one line), the data file can also contain variant header, the header can have
several lines, each line must start with *(star), here is four cases for variant header
Case 1 This case is same as the simple header.
*CATEGORY, TIME
*ENTITY, ACCOUNT, PRODUCT
*PERIODIC
ACTUAL, 1999.Jan, UK, Sales, Sedan, 1234
ACTUAL, 1999.Jan, UK, Sales, Coupe, 2345
ACTUAL, 1999.Jan, FR, Sales, Sedan, 986
ACTUAL, 1999.Jan, FR, Sales, Coupe, 945
Case 2--*<DIMENSION>=<VALUE> specify the value of the dimension, this has the same effect with *NEWCOL command in
mapping section. The line start with is the comment line which will be skipped during process.
*CATEGORY=ACTUAL
*TIME=1999.Jan
*ENTITY, ACCOUNT, PRODUCT
*PERIODIC
'----------------------------------this is the comment line, will be skipped when processing
UK, Sales, Sedan, 1234
UK, Sales, Coupe, 2345
FR, Sales, Sedan, 986
FR, Sales, Coupe, 945
Case 3If the *<Dimension> =<value> header occurs in the middle of data file, all the records following this header are affected,
but the records before the header will not.
*CATEGORY, TIME
*ENTITY=UK
*ACCOUNT, PRODUCT, PERIODIC
ACTUAL, 1999.Jan, Sales, Sedan, 1234
ACTUAL, 1999.Jan, Sales, Coupe, 2345
*ENTITY=FR
ACTUAL, 1999.Jan, Sales, Sedan, 986
ACTUAL, 1999.Jan, Sales, Coupe, 945
The results of Case 3 is :
ACTUAL, 1999.Jan, UK, Sales, Sedan, 1234
ACTUAL, 1999.Jan, UK, Sales, Coupe, 2345
ACTUAL, 1999.Jan, FR, Sales, Sedan, 986
ACTUAL, 1999.Jan, FR, Sales, Coupe, 945
Case 4--*<Dimension> =<value1>,<value2> has the similar effect with *MVAL command in mapping section, this type of header
can only occurs in the beginning of the data file but not in the middle of data file.
*CATEGORY=ACTUAL
*TIME=1999.Jan, 1999.Feb, 1999.Mar, 1999.Apr, 1999.Jun, 1999.Jul, 1999.Aug, 1999.Sep, 1999.Oct, 1999.Nov, 1999.Dec
*ENTITY, ACCOUNT, PRODUCT
*PERIODIC
UK, Sales, Sedan, 100, 200,320,450,600,700,850,900,230,200,340,560
UK, Sales, Coupe, 1120, 1230,1220,470,1600,7900,1850,1900,1230,3200,3340,2560
Here is an example of loading data from an existing InfoCube from SAP NetWeaver BI (this is available in
the SAP NetWeaver BI version only)
You can validate the transformation file by itself, or by supplying a live data file.
If you are an application administrator, select eData > Validate & Process
Transformation File.
Transaction data
Master Data
Once you choose to validate, you will get a log telling you any issues validating the
transformation file.
You can choose Copy Transformation File to create a new transformation or use save as
with an open transformation file
When you want to copy dimension files between applications, but the dimension names are
different, you can create a transformation file to map the dimensions.
then you can use a transformation file to map the source to the target.
3. Design-time
Transformation Files
Conversion Files
UI Script
Security
Large Files
Delivered Objects
4. Future
5. Wrap-up
*Conversion
Wildcards:
You can use the asterisk (*) and
question mark (?) wildcards in the
External and/or Internal columns.
asterisk (*) stands for ANY character,
while question mark (?) stand for any
SINGLE character.
DEMO
Conversion Files
SAP 2008 / SAP TechEd 08 / <Session
IM106 Page
ID>70Page 70
Conversion files define how to map the master data in input files (external) to application
master data (internal)
Also supports formulas to convert the data
*CONVERSION
Examples:
Account = AccountConv.xls
the input member names of dimension Account will be converted according to the
conversion rules defined in the conversion file AccountConv.xls.
Amount = AccountConv.xls!Calculus
Use the keyword Amount and the transformation option ConvertAmountWDim to get
formula
Account = AccountConv.xls!newaccount
Account = [COMPANY]AccountConv.xls!newaccount
Account = [AdminTeam]AccountConv.xls!newaccount
To create a new conversion file, go to Manage Data -> Maintain Conversions -> Create
New Conversion
When working with this conversion file you have three columns:
EXTERNAL, INTERNAL, and FORMULA
NOTE: When transformation option CONVERT_INTERNAL = NO, the external column refers to the source value, the
internal column refers to the target dimension member you want to load into the application. When Convert_internal =
YES, the external column refers to the target and the internal column refers to the source value.
The following example is for when CONVERT_INTERNAL = NO
When working with conversion files, you can directly map external values to internal values
Anytime the External value appears in the source, Data Manager would low the Internal value into
the target
Special Options:
*SKIP: You can ignore some data records and just skip them without loading them into the target
cube.
The below example means that all the data records will be skipped and not be loaded into target cube, if the
Wildcards: You can use the asterisk (*) and question mark (?) wildcards in the External and/or
Internal columns. asterisk (*) stands for ANY character, while question mark (?) stand for any
SINGLE character. You also can use colon mark (:) for a specified range.
For example, if you want to reference all members, use the asterisk (*). This would be useful to apply a formula to
Using Wildcards
Wildcards can be used within both the external and internal columns!
(convert_internal = NO, the input member name will be compared with External column)
Correct examples:
Case
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
17
18
19
External
a*f
abc*
*f
a*f
abc*
*f
a*c*f
a*f
a*c?*f
a*c??
abcdef
abc???
1:100
aba:abz
c001:c999
Internal
c*g
c*g
c*g
cg*
cg*
*cg
cg
c*g*
cg
c*g
c*g
???cg
abc
def
def
Result
cbcdeg
cdefg
cabcdeg
cgbcde
cgdef
abcdecg
cg
cbcdegbcde
cg
cbg
cg
defcg
abc
edf
def
External
a*c*f
a*d*f
abc???
Internal
*cg
*c*g
????g
Result
Error, the meaning of asterisk (*) for replacement is vague.
Error, the meaning of asterisk (*) for replacement is vague.
Error, the number of ? is not consistent
Overview of Formulas
(SAP NetWeaver Version Example)
To write a formula for dimensions, you will write this formula within the INTERNAL column
This formula will do the following: If the value for category in the source file begins with act, then it will map this
value to Actual. Otherwise, it will check if the value for category in the source is 4 characters long. If it is, it will
write the value Budget. If not, it will write the value Actual
To write a formula to update SIGNEDDATA, you will write this formula with the FORMULA column
This formula will take multiple the value of signeddata in the source by 100 and round it to two places for all time
VALUE
It refers to the signeddata in the source file you are trying to load from.
AMOUNT
The keyword AMOUNT can only be used in the conversion section in transformation files;
Using Javascript
(SAP NetWeaver Version Example)
CONVERT_INTERNAL
If transformation option Convert_internal = NO, the javascript can be used in Internal column.
If transformation option Convert_internal = YES, the javascript can be used in External column;
Precede the Java Script code with string js:, which is mandatory.
Examples:
js: %external%.substring(0,2)
js: %external%.length
Return a string in which a specified substring has been replaced with another substring a
specified number of times.
Examples:
js:Math.round(VALUE*Math.pow(10,2))/Math.pow(10,2);
You cannot refer to another dimension or dimension property within a formula when trying
to derive the value of a dimension (writing formulas in the INTERNAL column) within a
conversion file
Example 1:
External
internal
acc*
Accpay
bcdef
Accrec
formula
Formulas Example 2
Example 2:
External
internal
Acc123
Accpay
bcdef
Accrec
formula
Formulas Example 3
Example 3:
ConvertAmountWDim = Account
The input member names of Account are Acc123 and bcdef with values 100 and 200
respectively.
External
Internal
Formula
Ac*
*pay
value*2+1
bcdef
Ac?rec
value*4+2
To add a conversion sheet to a conversion file, choose Add Conversion Sheet within the
eData menu
To validate a conversion file, choose Validate & Process Conversion File within the eData
menu
Click Save
3. Design-time
Transformation Files
Conversion Files
UI Script
Security
Large Files
Delivered Objects
4. Future
5. Wrap-up
The UI Script is used to display a dialog to pass user parameters back to the BPC Packages
Within BPC 7.0NW, this would be Process Chain Templates
Within BPC 7.0M, this would be SSIS packages
The User Interface of Data Manager Packages is dynamically generated from the UI Script
To get to the UI Script
Choose Organize Package and selected the package name
Right click for menu to choose Modify Package
Then choose the View Package button
UI Script
Dynamic Script Editor Tasks
The UI Script can be updated from the Dynamic Script Editor for BPC Data Manager
The tasks will display the BPC Process Types or SSIS tasks that are assigned to the BPC Package
UI Script
Dynamic Script Editor Dynamic Constants
The Dynamic Constants display any system parameters from BPC that can be sent to the backend Process
Types or SISS Tasks
UI Script
Dynamic Script Editor Advanced
In Advanced mode, all code for the dynamic script can be directly edited and saved.
The prompt, info, and task have template syntax here which can aide in writing the
dynamic script
The package options can be set in a script using the advanced option (rather than navigate
each option in previous dialog.
DEMO
UI Script
3. Design-time
Transformation Files
Conversion Files
UI Script
Security
Large Files
Delivered Objects
4. Future
5. Wrap-up
3. Design-time
Transformation Files
Conversion Files
UI Script
Security
Large Files
Delivered Objects
4. Future
5. Wrap-up
When the user wants to execute this package (i.e. package runtime), he will be asked to
select the file they want to use in their Data Manager package. The user will be given a
dialog box containing an F4/Value Help function, to select from a list of files.
Instead of choosing a file, the user can specify a NetWeaver application server file
system location to import a file from the NW Application Server.
This may be useful for any files that are already being stored on the NW Application
Server from 3rd party applications
For example:
/uscikp1_KP1_77/tmp/FINANCE2250000.txt
3. Design-time
Transformation Files
Conversion Files
UI Script
Security
Large Files
Delivered Objects
4. Future
5. Wrap-up
Financial Packages
Administrative Packages
Example Packages
These
Admin Task
Audit Archive
Clear Comments
Clear Cube
Convert
Create Dimension
Dynamic Modify
FTP
Finalize Optimize
Journals
Load
Optimize Cube
Ownership Calc
Run Logic
OnLine Status
Standard Data Manager Packages perform their function while the system is live (i.e. users
can be online).
For example, you can use a standard package to load monthly data.
Allow you to move data into and out of SAP BPC databases.
The packages that come with BPC 7.0NW are designed to be dynamic so that you do not
need to modify the packages in order for them to work with your applications and dimensions.
You might want to modify packages to behave differently or to perform additional tasks.
You can make modifications to the packages supplied with BPC or use those packages
as templates to build packages as per your requirements (best practice)
We recommend that you use standard packages whenever possible, because they work
within the SAP Business Planning and Consolidation user ID security framework and
there is little risk of data integrity issues.
7.0 (NW) delivers 7 process chain templates that are standard data manager
packages
Description
This package allows you to load dimension member data directly into a
BPC Dimension's Member Table (BW InfoObject's master data table)
TechName
/CPMB/IMPORT_MASTER
This package allows you to load dimension member texts directly into a /CPMB/IMPORT_DESCRIPT
EVDESCRIPTION (BW InfoObject's text table)
BPC: Import Transaction Data
This package imports one or more ASCII files into the current application. /CPMB/IMPORT
You are prompted for one or more import file and associated
transformation files. The signs of the amounts are reversed based on the
Account type.
You can use the import.xls transformation file with this package.
BPC: Load Transaction Data from Other Cube This package allows you to load data from one BI Cube (EDW or BPC)
/CPMB/LOAD_INFOPROVIDER
into a BPC Application. You can associate a tranformation file to do the
mapping.
BPC: Move Transaction Data in one cube
This package lets you move any selection of data within an application.
/CPMB/MOVE
You are prompted for source and destination data selections for all
dimensions. The destination selection's fact table records are cleared
before the source's records are moved. The source's fact table records
are cleared after they are moved to the destination.
BPC: Clear Transaction Data in One Cube
This package clears the data in the BPC Application by importing zero
/CPMB/CLEAR
values. The optimize process removes the zero values, which clears all
values from the table. Running this package also clears comments from
the comments table.
You can use the import.xls transformation file with this package.
You must select at least one dimension in order to run this package. If you
select [All], the package will not run.
BPC: Copy Transaction Data in One Cube
This package copies data between dimensions within BPC application. /CPMB/COPY
BPC: Append Transaction Data
This package imports data into the application by appending the data to /CPMB/APPEND
the fact table, and then runs default logic against the imported data set.
You can use the import.xls transformation file with this package.
If the source dimension member does not exist in the AppSet, the source
dimension will be inserted into AppSet as a new one
The dimension members in AppSet but not in source file will stay untouched
Example:
Example:
Dimension: Account. Member: ACCPAY
Description before:
ACCPAY
E Account Payable
ACCPAY
F Account Payable in French
Descriptions in data file:
ACCPAY
E Account Payable in English
ACCPAY
C Account Payable in Chinese
Description after:
ACCPAY
E Account Payable in English
ACCPAY
F Account Payable in French
ACCPAY
C Account Payable in Chinese
You are prompted for one or more source and associated transformation files
The signs of the amounts are reversed based on the Account type and option defined in
the transformation file
Replace lets the user reset that region of the Application similar reloading the file as if it
was a new data set
It is the same as inputting a new financial statement for a specific region of the Application
The business requirement for replace within the import package is the same as inputting a
new financial statement for a specific region of the cube
If your GL only provided a new export for actual and May on its entirety, you would not
be able to determine accounts that have been reclassified, changed or remain the same
Replace lets the user reset that region of the cube similar reloading the file as if it was
a new data set
The merge option (alternative to replace) changes only like data between source and
database
CATEGORY
DATASRC
ENTITY
INTERCO
RPTCURRENCY
TIME
SIGNEDDATA
FRINGEBENEFIT
ACTUAL
INPUT
NON_INTERCO
1500
ACTUAL
INPUT
NON_INTERCO
LC
LC
2006.JAN
OTHEREXP
SALESITALY
SALESITALY
2006.JAN
500
SALARIES.CAT1
ACTUAL
INPUT
SALESITALY
NON_INTERCO
LC
2006.JAN
250
FRINGEBENEFIT
BUDGET
INPUT
SALESITALY
NON_INTERCO
LC
2006.JAN
15
NON_INTERCO
LC
2006.JAN
20
NON_INTERCO
LC
2006.JAN
30
OTHEREXP
BUDGET
INPUT
SALESITALY
SALARIES.CAT1
BUDGET
INPUT
SALESITALY
Supposewewereloadinganewfilewiththesecontents:
ACCOUNT
CATEGORY
DATASRC
INPUT
NON_INTERCO
RPTCURRENCY
LC
SIGNEDDATA
ACTUAL
ENTITY
SALESITALY
TIME
FRINGEBENEFIT
INTERCO
2006.JAN
1600
DIRECTLABOR
ACTUAL
INPUT
SALESITALY
NON_INTERCO
LC
2006.JAN
160
InBPC7.0,usingtheMerge option,theoutputwouldbeasfollows:
ACCOUNT
CATEGORY
DATASRC
INPUT
NON_INTERCO
RPTCURRENCY
LC
SIGNEDDATA
ACTUAL
ENTITY
SALESITALY
TIME
FRINGEBENEFIT
INTERCO
2006.JAN
1600
OTHEREXP
ACTUAL
INPUT
SALESITALY
NON_INTERCO
LC
2006.JAN
500
SALARIES.CAT1
ACTUAL
INPUT
SALESITALY
NON_INTERCO
LC
2006.JAN
250
DIRECTLABOR
ACTUAL
INPUT
SALESITALY
NON_INTERCO
LC
2006.JAN
160
FRINGEBENEFIT
BUDGET
INPUT
SALESITALY
NON_INTERCO
LC
2006.JAN
15
OTHEREXP
BUDGET
INPUT
SALESITALY
NON_INTERCO
LC
2006.JAN
20
SALARIES.CAT1
BUDGET
INPUT
SALESITALY
NON_INTERCO
LC
2006.JAN
30
InBPC7.0,usingtheReplace option,theoutputwouldbeasfollows,becauseitwillfirstdeleteallCATEGORY=ACTUAL,DATASRC=INPUT,
ENTITY=SALESITALY andthenaddthedatatothecube ItwouldnotdeleteentrieswhereCategoryisbudget
ACCOUNT
CATEGORY
DATASRC
INPUT
NON_INTERCO
RPTCURRENCY
LC
SIGNEDDATA
ACTUAL
ENTITY
SALESITALY
TIME
FRINGEBENEFIT
2006.JAN
1600
DIRECTLABOR
ACTUAL
INPUT
SALESITALY
NON_INTERCO
LC
2006.JAN
160
FRINGEBENEFIT
BUDGET
INPUT
SALESITALY
NON_INTERCO
LC
2006.JAN
15
OTHEREXP
BUDGET
INPUT
SALESITALY
NON_INTERCO
LC
2006.JAN
20
SALARIES.CAT1
BUDGET
INPUT
SALESITALY
NON_INTERCO
LC
2006.JAN
30
INTERCO
This package allows you to load data from one BI Cube (EDW or BPC) into a BPC
Application
You are prompted for one or more source and associated transformation files
The signs of the amounts are reversed based on the Account type
Security is required to be granted to the BPC service users to allow NW BI access to any
source EDW cube if an EDW cube is used
You are prompted for source and destination data selections for all dimensions.
The destination selection's fact table records are cleared before the source's records are
moved
The source's fact table records are cleared after they are moved to the destination
BPC:
Running this package also clears comments from the comments table
BPC:
BPC:
This package imports data into the application by appending the data to the fact table
All packages that manage data can run default logic, must will unless a prompt is included
within the package or the administrator changes the behavior of the package.
CATEGORY
DATASRC
ENTITY
INTERCO
RPTCURRENCY
TIME
SIGNEDDATA
FRINGEBENEFIT
ACTUAL
INPUT
NON_INTERCO
1500
ACTUAL
INPUT
LC
LC
2006.JAN
OTHEREXP
SALESITALY
SALESITALY
2006.JAN
500
SALARIES.CAT1
ACTUAL
INPUT
2006.JAN
250
FRINGEBENEFIT
BUDGET
INPUT
2006.JAN
15
OTHEREXP
BUDGET
INPUT
2006.JAN
20
SALARIES.CAT1
BUDGET
INPUT
2006.JAN
30
SALESITALY
SALESITALY
SALESITALY
SALESITALY
NON_INTERCO
NON_INTERCO
NON_INTERCO
NON_INTERCO
NON_INTERCO
LC
LC
LC
LC
CATEGORY
DATASRC
FRINGEBENEFIT
ACTUAL
INPUT
DIRECTLABOR
ACTUAL
INPUT
ENTITY
SALESITALY
SALESITALY
INTERCO
NON_INTERCO
NON_INTERCO
RPTCURRENCY
LC
LC
TIME
SIGNEDDATA
2006.JAN
1600
2006.JAN
160
In BPC 7.0, using the Append capabilities, the result would be as follows:
ACCOUNT
CATEGORY
DATASRC
FRINGEBENEFIT
ACTUAL
INPUT
OTHEREXP
ACTUAL
INPUT
SALARIES.CAT1
ACTUAL
INPUT
DIRECTLABOR
ACTUAL
INPUT
FRINGEBENEFIT
BUDGET
INPUT
OTHEREXP
BUDGET
INPUT
SALARIES.CAT1
BUDGET
INPUT
ENTITY
SALESITALY
SALESITALY
SALESITALY
SALESITALY
SALESITALY
SALESITALY
SALESITALY
INTERCO
NON_INTERCO
NON_INTERCO
NON_INTERCO
NON_INTERCO
NON_INTERCO
NON_INTERCO
NON_INTERCO
RPTCURRENCY
LC
LC
LC
LC
LC
LC
LC
TIME
SIGNEDDATA
2006.JAN
3100
2006.JAN
500
2006.JAN
250
2006.JAN
160
2006.JAN
15
2006.JAN
20
2006.JAN
30
Can load master description from flat file into a NW text table
Example:
ID
NetIncome
LANG
EN
Text
Net Income
NetIncome
FR
NetIncome
DE
Nettoeinkommen
Logon will read the dimension member table, and join to this language specific table
The user can maintain there language view My Settings using BPC Web
Description
This package executes default formulas stored in your default.xls
file.
The package runs the Allocation logic.
The package runs the CalcOwnership logic.
This package is used for currency translation. The package runs
the FXTrans logic.
BPC: IC Elimination
This package is used to Perform Inter-Company eliminations. The
Package runs the ICElim logic.
BPC: ICBooking
The Package runs the ICBooking logic.
BPC: ICData
The Package runs the ICData logic.
BPC: Legal Consolidation The Package runs the LegalConsolidation logic.
BPC: Opening Balances The Package runs the OpeningBalances logic.
BPC: Run CalcAccount
The Package runs the CalcAccount logic.
BPC: Clear the Journal
Clears Journal tables and creates an output file.
Tables
BPC: Export the Journal
Exports Journal tables to an output file
Tables
BPC: Restore Journal
Allows you to load Journal tables from a File
Tables
TechName
/CPMB/DEFAULT_FORMULAS
/CPMB/ALLOCATION
/CPMB/OWNERSHIPCALC
/CPMB/FX_RESTATMENT
/CPMB/IC_ELIMINATION
/CPMB/ICBOOKING
/CPMB/ICDATA
/CPMB/LEGAL_CONSOLIDATION
/CPMB/OPENING_BALANCES
/CPMB/RUNCALCACCOUNT
/CPMB/CLEAR_JOURNALS
/CPMB/EXPORT_JOURNAL
/CPMB/RESTORE_JOURNALS
Designed
For example, you can use an administrative package to include back-end data
manipulation where you are loading bulk data for the first time, exporting an entire
database, and running default logic formulas on your data.
Take
Description
Creates dimension members using a SQL table and
schedules the processing of dimension members. For
example, if a new member ID is added, this process
updates the fac2 table with the updated list.
See Scheduling dimension member processing
TechName
/CPMB/ADMINTASK_MAKEDIM
/CPMB/ADMINTASK_VALIDATE
/CPMB/VALIDATE_TRANSFORM
/CPMB/VALIDATIONS
/CPMB/ARCHIVE_ACTIVITY
/CPMB/ARCHIVE_DATA
/CPMB/CLEARCOMMENTS
/CPMB/FULL_OPTMIZE
/CPMB/LIGHT_OPTIMIZE
Description
TechName
Import an ASCII file and send the result to specific user.
/CPMB/IMPORT_A_SEND_EMAIL
This package allows you to import an ASCII file to download from an FTP /CPMB/IMPORT_USING_FTP
site into the current application. You can use modify the server name
within the package. After you modify the server name, you can run this
sample package at any time.
3. Design-time
Transformation Files
Conversion Files
UI Script
Security
Large Files
Delivered Objects
4. Future
5. Wrap-up
We have plans on releasing information on how to build your own Process Chain
Templates and UI Scripts
Tighter integration between Data Manager prompts and Script Logic variables
In
Today, there is a how-to guide available for the MSFT version already
Tighter integration to NW BI
Use Data Manager packages to natively transform NW BI data to BPC format data
In
the future:
This slide outlines our general product direction and should not be relied on in making a purchase decision. This slide is not subject to your license agreement or
any other agreement with SAP. SAP has no obligation to pursue any course of business outlined in this slide or to develop or release any functionality
mentioned in this slide. This slide and SAP's strategy and possible future developments are subject to change and may be changed by SAP at any time for any
reason without notice. This slide is provided without a warranty of any kind, either express or implied, including but not limited to, the implied warranties of
merchantability, fitness for a particular purpose, or non-infringement. SAP assumes no responsibility for errors or omissions in this slide, except if such damages
were caused by SAP intentionally or grossly negligent.
SAP 2008 / SAP TechEd 08 / IM106 Page 117
3. Design-time
Transformation Files
Conversion Files
UI Script
Security
Large Files
Delivered Objects
4. Future
5. Wrap-up
Further Information
Thank you!
Feedback
Please complete your session evaluation.
Be courteous deposit your trash,
and do not take the handouts for the following session.
Thank You !
SAP 2008 / SAP TechEd 08 / IM106 Page 121