Data ManagerData Manager is a Business Planning and Consolidation (BPC) module that helps you move data in to BPC, as well as copy or move data within and across applications. In addition to allowing you to move and copy data, Data Manager supports mapping and complex transformations of data. Integration Data Manager is integrated with BPC for Excel. To start Data Manager, choose Desktop icon BPC for Excel Manage Data . Features These are the main features of Data Manager. About Packages Packages allow you to move data among your BPC databases and to effect business processes (such as legal consolidation and inter-company booking). By default, there are three types of packages that have been added to Data Manager: y y y BPC Data Management Financial Processes System Administration In addition to the above-named package types, BPC provides several example packages. These are not part of the default configuration, but you can add them to Data Manager using the Organize Packages feature. If a file has an associated transformation file, you can assign the file to the package as is, or modify it to suit your needs. See Data Transformations. Note Data Manager packages are standard and shared among all applications within all application sets within a given BPC installation. Organize Packages Data Manager package organization involves adding, editing, moving, copying, and removing packages. You can start organizing your packages by selecting Manage Data Organize Package List from the action pane. See Adding or Modifying Packages, Moving or Copying Packages, and Removing a Package from the List. You use the eData View Status. Assign Packages to Teams You can determine who runs packages in BPC by assigning packages to be available to specific BPC teams. Monitor Package Status The Data Manager Status function lets you view the status of packages that are currently running and packages that have been completed. the source data may not be in the correct format. The process chain allows you to set up pre-defined answers to package prompts so that you can automate running packages. For example. At the dialog box. This is just one example of what you can do with data transformations. function to do this. it reads the transformation file (which has a pointer to a conversion file) and correctly maps the data. But you might want to modify packages to behave differently or to perform additional functions. You can clear these saved prompt values so that the system starts over with no values automatically filled in inside dialog boxes.. To clear saved prompt values.lgf) for your application when importing . See Data Transformations. when performing a data import. select Yes to clear the saved prompt values. The correct dimension members are defined in the conversion file. and select eData Clear Saved Prompt Values. When the Data Manager import package is run. You use the eData Manage User Package Access function to do this.Modify Packages You might have to modify Data Manager packages to meet your specifications. Clear Saved Prompt Values Data Manager saves values you type into various dialog boxes so that you do not have to repeat the information each time. or No to leave the saved prompt values in place. See Adding or Modifying Packages. you start BPC for Excel. The packages that come with BPC 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. Transform Data Data Manager performs data transformations and mapping using transformation and conversion files. Most packages automatically run default logic (default. Run BPC Logic with Packages You can set up BPC logic to work together with your Data Manager packages. Group The folder group to which the package will be added. you can view a list of available packages (when you select the file package type). See Example Packages. 5. choose Maintain data management Manage packages (organize list) . Enter data as required. choose the browse icon. Package Properties The following table describes the fields you must complete when adding or editing packages. o If you are adding a package. 3. Adding or Modifying Packages Procedure 1. On the action pane. If any of these fields are incorrect or left blank. You can define a new group here. or you can prompt users for logic files that they would like to use. Saving it makes it available for use. choose Add. 4. Adding the package only adds it to the folder list. choose Save. You can also include logic files in packages. If you select Admin Package. 2. You can upload package files to the MyFiles or Examples group. only users who are BPC Administrators will be able to run this package. See Adding or Modifying Packages. Alternatively. o If you are editing a package. If the file contains packages. Description A description of the package. a File text box is displayed so that you can specify the file that contains the package. Field PackageType File Description FILE or Repository. the package generates an error when the package is executed. See **Data Transfer and Preview**. you can browse for files. Note You must save the package before you can run it. See Package Properties To create a new group. enter the group's name in the roup field. Select the package and choose Save Package List. If the FILE package type is selected. PackageName The name of the package. To add a new package. The package can still be saved to a team that does not comprise non-administrative users (such users will be able to see²but not run²the .data. Task Type You can control who has access to run the package. Choose Add Package or select the package and choose Modify Package. AdminTask_Validate Clear_Journals ClearComments Default_Formulas Export_Journal Full_Optimize ICBooking (Intercompany Balance Booking) ICData (Intercompany . Package Name AdminTask_MakeDim Description Creates dimension members and schedules the processing of dimension members. as desired. Features The following tables describe the example packages that are included as default packages. It is best run during non±business hours. and processes intercompany booking according to the logic defined in icbooking. and time dimensions for the user. Prompts you for the name of the export journal file. This option takes the system offline. For example. These packages are available to all AppSets. currencies. application set. This process chain prompts you for entities.package).lgf. Validates the logic file. you can add the package and use it as is. selection. Example Packages BPC also provide example packages. If you select User Package. and currency to clear. With the exception of the ImportUsingFTP package (see below for details). categories. or modify. See Application Management.xls file. Intercompany balances are tracked in order to perform intercompany eliminations. This process chain prompts you for entities. Prompts you to select categories. See Scheduling Dimension Member Processing. or modify it as needed. this process updates the application data with the updated list. users who have been assigned the Execute Data Management task security privilege will be able to execute the task. application. This package clears both real-time and short-term data storage and processes the dimensions. if a new member ID is added. The following table describes the BPC sample packages that you can use as provided. Schedule a full optimization. Clears comments from the comments table. categories. This package executes default formulas stored in your default. time dimensions. and selection. and calculates opening balances for the user. For more information on inter-company eliminations. application. You can modify the server name within the package. according to the logic defined in consolidation. A light optimization clears real-time data storage and moves it to short-term data storage. holding method. You can use this process chain to schedule a light optimization. This process chain prompts you for categories. application. you can run this package at any time. see Inter-Company Booking Setup. currencies. accounting method. according to the logic defined in consolidation. This process chain allows you to import an ASCII file to download from an FTP site into the current application. application. After you modify the server name. and calculates ownership (including ownership percentage.lgf. categories. This option does not take the system offline. and time dimensions and processes intercompany booking for the user. and selection according to the logic defined in icdata. and calculates consolidation for the user. See Import Master Data Descriptions from Data File. and time dimensions. the descriptions will appear will appear in the user's specified language. and time dimensions. Restores Journals tables from an output file. You can specify the transformation file that defines conversion as well as data value signs. currencies. See Application Management. This setting can be modified in BPC for Web. This process chain prompts you for entities. Import_Using_FTP Legal_Consolidation Light_Optimize Load_Infoprovider Opening_Balances OwnershipCalc Restore_Journals . This process chain imports dimension member description records. You can associate a tranformation file to do the mapping. Import an ASCII file and send the result to specific user.lgf. application. so you can schedule it to run during normal business activity. This process chain is used to perform inter-company eliminations. and time dimensions. application set. and parent information) for the user. currencies. application set. Note that when these descriptions are entered in another language in the EVDESCRIPTION table (and the correct SAP NetWeaver language code is used) . and selection.Reconciliation) IC_Elimination Import ImportAndSendMail Import_Descript currencies. application set. This process chain prompts you for categories. and selection. This process chain imports an ASCII file into the current application. application set.lgf. This process chain allows you to load data from one BI Cube (EDW or BPC) into a BPC Application. Activities To add sample packages to Data Manager. This process chain prompts you for dimensions and categories on which you can run validation logic (as defined in validation. application set. You can use the member selector anywhere you see a Choose Members button in the Data Manager interface. Data Transfer and Preview Data Manager allows you to transfer data files to and from the server. depending on the context. such as when you run a package. categories. This process chain validates the transformation file. choose eData Organize Package List Package icon. application. or text data files. You can also use the data preview feature to preview database. Excel. Add Use the Member Lookup The Member Lookup provides a hierarchical view of the members in a dimension. and runs calculate account for the user. according to the logic defined in calcaccount.lgf.RunCalcAccount Validate_Transform Validations This process chain prompts you for entities. then save it.lgf. by default). and time dimensions. Complete the Add Package dialog box. See Data Transfer and Preview. click Add. and selection. This allows you to see the format of your data when deciding on how to set up a transformation. . currencies. You can choose one or more members. You can also use the Member Lookup when you select a dimension and click the Show Member List button on the Data Manager toolbar. named Instructions. Note All dimensions of an application must be mapped in the transformation. y After you set up these files.Data Transformations You define data transformations so that you can map external data to internal BPC data structures. (period) . you run packages to use these files to define your data transformations. The Instructions worksheet has three sections: o *Options o *Mapping o *Conversion Conversion file ² Allows administrators to map member names from external to internal dimension structures. Options Section The *Options section of the Transformation file contains definitions for various options that you can set for your transformation. So if the import file does not have a dimension (such as DATASRC). Here are the available options and descriptions for each: y AMOUNTDECIMALPOINT=text character Default: . then you would use *NEWCOL (see below). Features Required Files To perform data transformations. See Data Conversions. See Running and Scheduling Packages. an administrator must set up at least two BPC for Excel workbook files: y Transformation file ² Allows administrators to set up the rules for reading data from an external source and putting it in the proper form for your BPC database. You can set up multiple sheets in a conversion file so that many transformations can access the same conversion workbook. Transformation files are Microsoft Excel files that contain one worksheet. You can have one conversion file per dimension. 10. seeData Conversions . y CREDITPOSITIVE= YES | NO Default: YES If No. INC) will have their signs reversed. this option defines the single character that is the delimiter between columns.0 y HEADER= YES | NO . Delimited means that there is a special character between each column of data. This option must be defined. For example. such as a comma. Use the keywords SPACE or TAB if the columns are delimited by spaces or tabs. For more information about conversion files. all amounts referring to an ACCOUNT type (LEQ.0 Default: There is no default. You must enter a format type. y DELIMITER text_character| SPACE | TAB Default: . If there is no formula in the Formula column of the Amount conversion sheet. y FORMAT = DELIMITED | FIXED | VARIANT Required Parameter The format of the data in the input or output file. All accounts will be increased by 10% during the conversion. y CONVERTAMOUNTWDIM=dimension name Default: Account Specifies which dimension to look at for value calculations. Fixed means that the data is in a fixed field format. defined by the Delimiter option (below).Allows you to specify a non-period decimal point for countries that use a different character. You must specify a dimension conversion sheet using the Amount *Conversion option.CategoryByTime is out of scope for BPC 7. the Formula column has the following formula: Value*1. The character specified in this option must differ from the character specified for the DELIMITER. Note CategoryByTime is out of scope for BPC 7. this parameter has no effect at all. (comma) If the FORMAT option is set to DELIMITED. If your data file has a header.in the above case. no matter how many rejected records exist. The strings are separated by |. above. If a record contains <text_string> or <text_string2>.Default: YES If YES. When specifying integer. Setting this option to an empty string means that no lines are skipped in the body of the data file. the integer can be zero or any positive integer. If you do have a header row. the record will be skipped. specifies the number of rejected records at which to stop processing. set this value so that those lines are skipped during transformation. y MAXREJECTCOUNT=empty_string | -1 | positive number Default: empty_string If validating records. Default: <empty_string> y VALIDATERECORDS= No | Yes . A value of -1 implies that Data Manager should keep processing. then your input file contains one header row that defines the fields. you can refer to a field by name in the MAPPING section. y ROUNDAMOUNT=integer Required Parameter Specifies the amount of decimal places to round values during the transformation. y SKIPIF= text_string | text_string2 Required parameter Default: empty_string Skip a line in the data file if it begins with the specified strings. Header lines can still be skipped using the SKIP command. which can be represented by an empty string. The default value is 500. Default: no rounding occurs y SKIP= integer Default: 0 (zero) Number of lines to skip at the top of a data file. it is illegal when running other packages. If the import file has an extra field that is not mapped.<Dimen sion2_value> This option is only used for importing transaction data from infoprovider. For example 0SX_ACCS.0). for a member ID is not mapped. The SELECTION option set the select rules when exacting transaction data from infoprovider. all records will be rejected during validation. <Dimension1_value> is the value of Condition statement set to this dimension. 1 represents the selection statement 0SX_ACCS=US and 0SX_CSLC= 1 Note This is used for loading transactional data as is (new in BPC 7. that specific record would be rejected during validation and ignored. Note This is used for loading master data as is (new in BPC 7.<Dimension2_techname>. The FORMULA option sets the K2 functions referenced by the master data member¶s formula attribute The libraries are syslib. Default: <empty> y FORMULA = LIB.LGF This option is only used for importing master data. In this case. it is illegal when running other packages.LGF|LIB1. Different libraries are separated by | . validate the mapping and that members exist and that the record is proper for the BPC application before the import. the *syslib prefix is not needed here.<Dimension1_techname> is the technique name of the dimension.0SX_CSLC.<Dimension1_value>. Example .Default: No If YES.0). US. y SELECTION = <Dimension1_techname>. Data Manager associates fields to header names when you have a header row in your data file. Mapping Section The *Mapping section of the transformation file defines how data is mapped to your BPC database. There are no reasons to change this in BPC 7.LGF Default: <empty> y CONVERT_INTERNAL = YES | NO If NO. you can map the Account dimension to the Account field from the data file this way: Account = AccountVal Example If you have a header row and it defines a column named "AccountVal. If YES. This makes it easier to define mappings in this section of the transformation file. Note By default. the input member names will be compared with external column in conversion file.DAVY_KP1_DEV7A2_Q_Mdxlib_1.0 and later versions. the input member names will be compared with internal column in conversion file. if you have a header row and it defines a column named AccountVal. Default: NO Recommendation Do not change the default setting.LGF| DAVY_KP1_DEV7A2_Q_Mdxlib_2. This setting is here for the purposes of backward compatibility only. For example." you can map the Account dimension to the Account field from the data file this way: Account = AccountVal y *COL(A) A = column index in the data file . IntCo.JAN. this option allows you to define the start and end character columns for each field.DATASRC.OCT.FEB.M AY.AUG.JUL. In the example below.SEP.RptCURRENCY.entity. Example Account =*COL(2) y *COL(A.DEC .Category. Example Account=*COL(3.JUN.MAR. Example Consider a case in which you have the following columns: Account. the columns 4 through 7 represent the Account dimension. Example Example: Account=*FCOL(4:7) y *MVAL(A:B) A:B = start/end column of time period Use this command if your data file has multiple time period columns.Defines a dimension for a field in the data file when the data file does not have a header row. B:C) A = column index in the data file B:C = start/end position within the column Defines a dimension for a subset of a field in the data file.APR.1:4) y *FCOL(A:B) A:B = start/end position within the data row When using Fixed format data files. See the note below about automatic field names when you do have a header row.NOV. If this evaluates to "True. map using this Default Action Condition1 and Condition 2 can contain multiple items that are added together (using the plus (+) sign). open the existing conversion definition window. If your data does not have a header row.." map using Action2 Default Action .Since columns 7 through 18 contain data based on time periods..Condition2 then Action2. the resulting value is A123.Default Action) Condition1 . y *NEWCOL(A) A = dimension member Creates a new field with the given value. Using this command requires that you use a Time. as in this example: . To see the sample Time.If both Condition1 and Condition2 are "False". P2... y *If(Condition1 then Action1. except that the field names contain extra characters (either before or after the name). Example Entity = *Str(NE) + *COL(1) y *PAD Useds for padding imported fields.xls conversion file. Useful if you need to map data file fields to fields in your database that have the same names. the time periods will be named P1. Example Account=*NEWCOL(Revenue) y *Str(string) Adds a text string to the members of a column." map using Action1 Condition2 . If the field contained 123 before the command.PN by default.. To place the letter A before a field (such as the member ID) use *PAD(A). P3.xls conversion sheet.If Condition1 is "False" and Condition2 is "True. you could use the following command: Time = *MVAL(7:18). 52 AB.ID(1:1) = *str(C) then *str(XX) .ENTITY 14.KL Given this data: Entity.Example Product=*if (Product+ID+Entity = *str(148552) then *str(MHarn).EF GH. *str(YY)) The result is: PRODUCT.ID.IJ.ENTITY MHarn.KL And this mapping formula: Product=*IF (product+ID+Entity=*Str(148552) then *str(MHarn).EF YY. SEntity .85. Example Given this data: PRODUCT.CD.IJ.ID.85. *str(YY)) Explanation: This means that if the sum of the product.52 AB. and entity value are equal to ³148552´ then change product value to ³MHarn´ or Else IF first value of ID field is equal to ³C´ then Change Product value to ³XX´ Else change product value to ³YY´ Note The *STR() function must be used when evaluating numeric constants in an *IF statement.XX.ID(1:1) = *str(C) then *str(XX) . ID. JP04 Conversion Section The *CONVERSION section of the transformation file defines which conversion sheet(s) to use with which dimensions.U1000000. The name of the worksheet to use within the conversion file.3:6). Otherwise Data Manager looks in the appropriate Site folder.1:1)=Z then *col(1. The following table describes the variables. Use the Amount option to specify the conversion file to DimensionName be used if you specify the ConverAmountWDim option in the *Options section. *STR(ERR)) The result is: Entity. CA03 ERR. This allows you to use a formula to scale the input or output values. and has the following syntax: Dimension Name = [COMPANY]WorkbookName[!SheetName] Note Items in brackets are optional. SEntity US01. CA03 K3430000.1:1)=U then SEntity. Variable . Data Manager assumes the sheet name is Conversion If [COMPANY] is defined then Data Manager tries to obtain the [COMPANY] conversion file from the main company Data Manager folder. If not SheetName specified. US01 A01. JP04 And this mapping formula: Entity=*IF(*col(1.*col(1. Description Either the dimension name to correlate with the conversion file or the keyword Amount. Workbookname The name of the conversion file. US01 Z2000A01. xls!newaccount . select eData Manage Transformation Files.Activities To create a new transformation file.BPC for Excel action pane. select data as required. then To copy a transformation file. Account = AccountConv. browse to the desired file. Select Maintain transformations Manage existing transformation. open the file you want to copy by selecting Manage Data from the Getting Started .xls (Use the Amount keyword with the ConvertAmountWDim transformation option) Account = AccountConv. Enter To edit a transformation files. To copy dimension files between applications. eData New Transformation File.xls!newaccount Account = [COMPANY]AccountConv. Open the desired file and select Copy Transformation File. Example Where AccountConv.xls is the name of the Account dimension conversion file.xls Amount = AccountConv. See Sample Transformation File. Enter data as required. you create a transformation file to map the dimensions. You can create a transformation file like the following: *OPTIONS FORMAT = DELIMITED HEADER = YES DELIMITER = SKIP = 0 SKIPF = CREDITNEGATIVE=NO CONVERTAMOUNTWDIM= MAXREJECTCOUNT= VALIDATERECORDS=YES *MAPPING cat=category Acc=Account Ent = Entity Tim=time Currency=Rptcurrency int=intco dat=Datasrc *CONVERSION . Int. you can create a transformation file to map the dimensions. Entity. Rptcurrency. For example. the dimensions in the source application are: Category. Ent. Time. Tim. Currency. Intco. and Dat.Sample Transformation File When you are copying or importing data between applications and need to map the dimensions which are different. Acc. Account. andDatasrc and the dimensions in the target application are: Cat. pow(10. too. Precede the Java Script code with string µjs:¶. Each conversion file can contain one or more sheets for different types of data transformations.replace("apples". the target value will be 200. the javascript can be used in Internal column. You create one conversion file per dimension in a transformation.Data Conversions Conversion files define the mapping (by dimensions) from external member names to internal member names. Java Script can be used in the FORMULA column o Examples: js:Math. as in the following example. we cannot guarantee it will work with BPC for Excel.2))/Math. you can place the keyword *skip in the Internal column. ensure that the following parameters are set: y y y y y CONVERT_INTERNAL o If the transformation option Convert_internal = NO.length Return the length of the string contained in external. You can use Java Script code in IF statements.2). Of the Source value is 200. o If transformation option Convert_internal = YES.pow(10. As a best practice. While VBA can be used successfully in some instances. They also provide the ability to perform arithmetic and rounding on data as it is converted.round(VALUE*Math.36 Features *skip If you want to ignore certain external data. Note Data Manager supports VB script in conversion files. the javascript can be used in External column. To use Javascript. Examples: o js: %external%. "oranges") Return a string in which a specified substring has been replaced with another substring a specified number of times. .356.2) Return a Long containing the number of characters in a string o js: %external%. conversion files should be named the same as the dimension for which they are being used.substring(0. which is mandatory. o js: %external%. For example. Select Copy Conversion. then choose Open. select Maintain Conversions Manage existing conversion definition . select a conversion file.10 Formula To validate a conversion file. Select a file. if you want to reference all members. The following example would increase all of the members by ten percent: External * Activities To create a conversion file. open the conversion file then select Process Conversion File. Enter data as required.External ACCPAY Wildcards *skip Internal You can use the asterisk (*) and question mark (?) wildcards in the External or Internal columns. use the asterisk (*). An asterisk (*) stands for ANY character. while a question mark (?) stands for any SINGLE character. . eData Validate & * Internal Value*1. This would be useful to apply a formula to all members. select eData New conversion file. To copy a conversion file. then choose Save.
Report "Compilado Data Manager, Transformation, Conversion y Packages"