SAP BusinessObjects Planning and Consolidation
SAP BusinessObjects Planning and Consolidation
Planning and Consolidation provides everything you need to meet your bottom-up and top-down financial and operational planning requirements, as well as complete consolidation and reporting through a single application and user interface.
Integration
There are two versions of the software: a version for the Microsoft platform and a version for SAP NetWeaver. While this application help focuses on the Microsoft platform version, there may be some notes related to the SAP NetWeaver version. You can ignore these notes. Certain client components are integrated with Microsoft Office (Word, Powerpoint, and Excel). Other client components are based on Windows or Web technologies.
Features
The SAP Library documentation for the system includes: Getting Started Describes the connection wizard and other logon tasks, the interfaces available (Administration, Excel, Word, PowerPoint, and Web), how to set the overall language for the system, and where to find more information, specifically, technical information. Administration Provides instructions for administrators about setting up and maintaining Planning and Consolidation applications. Data Management Provides instructions about moving data into and out of the system, and about copying and moving data within and across applications. Business Process Flows Provides information about using Business Process Flows (BPF). For information about setting up BPFs, see the Administration section. Reports and Input Schedules Provides instructions about building, distributing, and publishing reports, and about collecting data and submitting it to the database using input schedules. Journals Provides information about creating and posting journal entries to adjust data in the database. Functions Reference Provides reference information on using the Planning and Consolidation functions in your reports and input schedules.
More Information
More Information
Getting Started
You can start Planning and Consolidation from the Windows Start menu.
Prerequisites
To access the Web or Server Manager interfaces, you have installed the Planning and Consolidation server components. To access the Excel, Word, or PowerPoint interfaces, you have installed the Planning and Consolidation for Office client. To access the Administration interface, you have installed the Planning and Consolidation Administration client.
Activities
To start the program, select SAP BusinessObjects Consolidation from the Windows Start menu. Planning and Consolidation Planning and
More Information
Interface for Office Interface for Word or PowerPoint Interface for the Web Interface for Administration
Features
With Interface for Office, you can perform the following tasks: Utilize the powerful and flexible formulas and functions within reports and input schedules to retrieve, display, and submit data for a real-time view of the financial position of your organization. Use predefined report and input schedule templates that you can customize to meet your specific business requirements. Instantly change the information you see in a report or the entities, accounts, time period, and so on, of input data simply by changing your current view. Display accurate, live data from the database within Microsoft Excel worksheets, Microsoft Word documents, and Microsoft PowerPoint slides. Analyze data in reports, perform data entry in input schedules, and distribute information based on user access rights when you are completely offline from the system. Submit budgets with a wide range of supporting attachments in the form of spreadsheets, documents, and presentations. Create hypothetical scenarios of future outcomes using powerful modeling functions. Post journal entries to carefully track changes to your data. Schedule and run Data Manager packages for loading, transforming, and manipulating financial data.
Activities
To start one of the interfaces, select one of them from the launch page, or from another module (such as Interface for the Web or Administration), expand Available Interfaces in the action pane and make your selection. NOTE If you see a prompt to update files, select Yes.
More Information
Reports and Input Schedules Interface for Word and PowerPoint Journals Data Management for the NetWeaver platform or Data Management for the Microsoft platform
With Planning and Consolidation reporting, you can retrieve requested data from the database into the Excel interface. You can analyze your multidimensional data using the current view, which is available on the action pane. The system provides a variety of report templates to help you design your own reports. Input schedules allow you to send data directly from your spreadsheet to the databases. Input schedules contain all of the same formatting and functionality as reports. The difference is that reports are used for analysis purposes, and input schedules are used for writing data to the database. Data can be written to base-level members to which you have write access.
More Information
Creating Reports and Input Schedules Common Report and Input Schedule Features Dynamic Report and Input Schedule Templates EvDRE Builder Drag and Drop Reporting Live Reporting Data Submission
Activities
Saving Reports Locally You can save a report locally to the My Reports or My Schedules folder by choosing Save to My Reports folder in the Report State action pane. Saving Input Schedules Locally You can save an input schedule locally to the My Schedules folder by choosing Save to My Schedules folder in the Schedule Options action pane. Saving Reports and Input Schedules as Templates You can save a report or schedule as a template by selecting eTools Save Template Library . (You must have authorization for this task). After a template is saved, you can make it available for downloading to other users' machines by updating the template version number.
More Information
See Setting Template Version in Application Set Management.
Features
You can save reports locally, or save them as a template on the server (if you have administrator rights). If you modify an existing report template or create a custom report, you can save it as a template for
future use. Only administrators with the appropriate rights can save templates on the server. However, you can modify a template and save it locally for your own use. You can edit the template title and description in the language you require. NOTE If you make a change to an existing template and save it to the server, you should increment the template version number so that the new template can be downloaded to all client machines that access the server. See Application Set Management. NOTE To retrieve information on the Server name, User name, AppSet name and Application name for the current report, you can add the appropriate EvFunction. The following tables describe the provided templates. Since administrators can save any report as a template, your application set may contain a different set.
Variance
Comparative X
Comparison with 3 year Drill In Place Sort on Values or Sort on Members Nested Row
This custom report performs drill in place. This custom report contains data sorting by total value.
This custom report allows any two dimensions to be nested in the rows and a third dimension in the column. This custom report allows you to drill from one dimension to another in the rows.
Entity-Trend
This schedule contains Entity type members in Rows and Time periods in columns, using EVDRE based functions. This schedule contains Account type members in Rows and Entity type members in Columns, using EVDRE based functions. This schedule provides the ability to choose the dimensions and members on the Row, Column, and Page. Two Row dimensions can be selected and they will be nested. It uses EVDRE based functions. This schedule contains Account type members in Rows and Category type members in columns with a variance column, using EVDRE based functions.
Consolidating
Nested Row
Comparative
Description
This custom report allows any two dimensions to be nested in the rows and a third dimension in the column. This custom report contains any dimension in the rows and any dimension in the columns.
Any by Any
Description
This schedule provides the ability to choose the dimensions and members on the Row, Column, and Page. Two Row dimensions can be selected and they will be nested. This schedule provides the ability to choose which dimensions are on the Row and Column.
Any by Any
Activities
Open a report template
From Interface for Excel, select Reporting & Analysis from the Getting Started action pane. Select Build a report using a template, then select the desired template and choose Open.
can change the version number in the Admin Console, or from the Set application parameters page in the TemplateVersion field. See for more information.
Features
Adding New Application Sets
Administrators create new application sets by copying information from the ApShell application set provided with Planning and Consolidation. See New Application Sets and Application Set Status.
Viewing Application Set Statistics (applicable only to the Microsoft version of the system)
You can view the following application set statistics by selecting Show application set statistics in the Manage Application Sets action pane: Real time, short term, and long term application storage count The storage count comes from the row count of each the table in the Microsoft SQL Server Management Studio. Cube processing status Current application optimization status Dimension processing status
Admin Console, choosing Set template version from the Manage Application Sets action pane, incrementing the version number by 1, then choosing Update Template Version.
Viewing User Activity (Applicable only to the NetWeaver version of the system)
Planning and Consolidation logs user and administrator behavior by recording information about each remote function call made from .NET to ABAP. You can view activity logs from the Manage Application Sets action pane.
Features
You can copy database records, Content Library data, Live Reports, and journals from the source application set. When using the Microsoft version of Planning and Consolidation, you can also copy business process flows. After the copying is complete, you can begin to modify the default applications, add new ones, and assign users to them. When you create a new application set, Planning and Consolidation does the following: Copies the application set WebFolders/data within File Service
Creates a copy of all NetWeaver BI objects (in the NetWeaver system only) Copies all transactional and master data from the source application set to the new application set Copies security and Planning and Consolidation metadata If the system encounters an error when copying an application set, it rolls back to clear the objects created during the failed copy. You can modify the descriptive text associated with an application set. For example, you might want to change the description if you have made a significant change to the application set, such as adding a new application that performs new functions for your business. You change application set descriptions for a selected application set in the Administration main screen by choosing Application Set Tasks Add a new application set , then entering the new application set description.
Activities
You add a application set by choosing Add a new application set in the Manage Application Sets action pane and entering the required data.
More Information
ApShell Sample Application Set
Features
ApShell contains the following components needed to build a functioning application set: Two sample applications Planning and Rate that contain most of the functionality you need to start building your own application set (see Planning Sample Application and Rate Sample Application). If you need to build more complex application sets, for example, for legal reporting, consolidation, or ownership, you can build an application using the components included within ApShell. A set of dynamic EvDRE-based report and input schedule templates (see Dynamic Report and Input Schedule Templates) Data Manager packages Blank Content Library and Live reports Required administration setup parameters All required dimensions with the properties needed to create a basic planning and consolidation application set
More Information
New Application Sets Application Set Management
Features
The Planning application within ApShell contains the following dimensions: P_DataSrc: the source of data, such as manual input or uploaded Category: (category type) version of your data; secured dimension P_Activity: (user type) enriches the activity types by adding appropriate members P_ACCT: (account type) used for a list of planning accounts, account members, and member formula P_CC: (entity type) holds the cost entities in a cost center planning scenario; should reference the input currency dimension RptCurrency: (rate type) currency used for reporting Time: (time type) used for storing time periods NOTE Planning is a financial-type application, so a currency-type dimension is required. Default Application Parameters The following are the default parameters and values within the sample Planning application: Web Admin Parameter DIMSFORFACTTBLINDEX JNR_ACCDETAIL_DIM JRN_BALANCE JRN_CLOSING_CODE JRN_DESC_MODE JRN_IS_STAT_APP JRN_MAXCOUNT JRN_OPENING_CODE JRN_POST_OVERWRITE JRN_REOPEN JRN_REVSIGN_CODE JRN_VALIDATION_SP Default Value N/A N/A N/A N/A 0 N/A N/A N/A N/A N/A N/A N/A
Features
The Rate application within ApShell contains the following dimensions: R_ACCT: used for a list of planning accounts R_ENTITY: defines your organizational structure; secured dimension CATEGORY: version of your data; secured dimension INPUTCURRENCY: currency used for planning TIME: used for storing time periods Default Application Parameters The following are the default parameters and values within the sample Rate application: Web Admin Parameter CALCULATION COMMENT DIMSFORFACTTBLINDEX (for Microsoft version only) FXTRANS INTCOBOOKINGS OPENINGBALANCE USELIM WORKSTATUSVALIDATIONS YTDINPUT YTDInputTimeHir (for Microsoft version only) Default Value 0 Off N/A 0 0 0 0 N/A No H1
Advanced rules The ApShell Rate application has standard default advanced rules that calculate, divide, or multiply rates for currency translation, and requires the following:
The currency-type property must have a property named MD. The whole value is either M or D, which stands for Multiply currency and Divide currency. In the ApShell Rate application, the currency-type dimension is namedInputCurrency.
Features
You can save reports locally, or save them as a template on the server (if you have administrator rights). If you modify an existing report template or create a custom report, you can save it as a template for future use. Only administrators with the appropriate rights can save templates on the server. However, you can modify a template and save it locally for your own use. You can edit the template title and description in the language you require. NOTE If you make a change to an existing template and save it to the server, you should increment the template version number so that the new template can be downloaded to all client machines that access the server. See Application Set Management. NOTE To retrieve information on the Server name, User name, AppSet name and Application name for the current report, you can add the appropriate EvFunction. The following tables describe the provided templates. Since administrators can save any report as a template, your application set may contain a different set.
Variance
Comparative X
Comparison with 3 year Drill In Place Sort on Values or Sort on Members Nested Row
This custom report performs drill in place. This custom report contains data sorting by total value.
This custom report allows any two dimensions to be nested in the rows and a third dimension in the column.
Description This custom report allows you to drill from one dimension to another in the rows.
Consolidating
Nested Row
Comparative
Template name
Nested Row
Any by Any
Template name
Nested Row
Any by Any
Activities
Open a report template
From Interface for Excel, select Reporting & Analysis from the Getting Started action pane. Select Build a report using a template, then select the desired template and choose Open.
We recommend that you save all report copies locally, so that you have instant access to the reports you need if you do not have access to the server. From the report you want to save, select Save to My Reports folder. At the Lock down prompt, select Yes to lock down the current view, or select No if you want the report to continue to show live data. If you select Yes, then select a Park N Go option. For more information, see Park N Go. Enter a name for the report, then choose Save. The default folder is the Report folder on your local drive.
Park N Go
You use this function to lock the current view in a report or input schedule, or both the current view and data, or to take the workbook offline.
Features
The data and current view in a report or input schedule is live until you use one of these features from the Park N Go action pane: You can lock the current view by choosing Set to live data and static current view. Locking the current view allows you to store the file on the server and share it with others who are authorized. NOTE The term 'static' indicates that a refresh does not update the current view or the data. You can lock the current view and data by choosing Set to static data and static current view. You lock the current view and data when you want to protect the data in the report or input schedule from being refreshed. In addition, you can use this function to take a report or input schedule completely offline and bring it back online. You can make changes to the report or input schedule when you are disconnected from the server, then bring it back online later. You can take reports and input schedules offline by choosing Set to offline (no connectivity). When you want to send a report or input schedule to remote users, you can take the workbook offline. Remote users can look at published information and enter data in an offline workbook, but do not have authorization to update or view unpublished data. These users do not have access to
Interface for Excel. After a workbook has been taken offline, you can bring it back to its live state when you want to work with it in Interface for Excel (as long as there are no significant changes to the format). NOTE When you set reports and input schedules to offline, the system changes the Ev functions so that you can open the workbook in native Excel. If you want to set the template to be live and send the data, do not change the format or formulas.
Activities
To choose a Park N Go option, choose Park N Go from the Report State action pane, then select one of the options described above. To restore a locked report or input schedule, choose Park N Go Set to Live to restore data and live current view.
More Information
Working Offline
Working Offline
You use this function to work with a report or input schedule in a disconnected state.
Prerequisites
Before you can work with a workbook offline, the current view and data must be locked using the Park N Go feature. See Park N Go.
Features
When you work on the offline client, you can perform all your Excel tasks while disconnected from the system server, then bring the workbook back to its live state when you reestablish connectivity.
Activities
To work on a report or input schedule offline, start Interface for Excel. From the Login page, select the Work Offline button. Open the desired report or input schedule, and modify the workbook as desired. When you are finished, save it.
EvAST
The EvAST (Application set) function returns the name of the current application set. SYNTAX 1. EvAST() EXAMPLE EvAST( ) returns the name of the current application set.
EvAST
The EvAST (Application set) function returns the name of the current application set. SYNTAX 1. EvAST()
EXAMPLE EvAST( ) returns the name of the current application set. The EvAST (Application set) function returns the name of the current application set. SYNTAX 1. EvAST() EXAMPLE EvAST( ) returns the name of the current application set. The EvAST (Application set) function returns the name of the current application set. SYNTAX 1. EvAST() EXAMPLE EvAST( ) returns the name of the current application set.
EvSVR
The EvSVR (Interface on the Web Server) function returns the name of the web server to which the user is connected. SYNTAX EvSVR() EXAMPLE The following example returns Http://CorpServ01 if the current server is CorpServ01. EvSVR()
EvUSR
The EvUSR (User ID) function returns the name of the user who is logged on to the system. SYNTAX EvUSR EXAMPLE The following example returns JSmith, if Joe Smith is currently logged on to the system. EvUSR()
EvAPP
The EvAPP (Application) function returns the current application name. SYNTAX 1. EvAPP() EXAMPLE EVAPP() returns Financial Consolidation, if the current view application is Financial Consolidation.
Features
Adding New Application Sets
Administrators create new application sets by copying information from the ApShell application set provided with Planning and Consolidation. See New Application Sets and Application Set Status.
Viewing Application Set Statistics (applicable only to the Microsoft version of the system)
You can view the following application set statistics by selecting Show application set statistics in the Manage Application Sets action pane: Real time, short term, and long term application storage count The storage count comes from the row count of each the table in the Microsoft SQL Server Management Studio. Cube processing status Current application optimization status Dimension processing status
Viewing User Activity (Applicable only to the NetWeaver version of the system)
Planning and Consolidation logs user and administrator behavior by recording information about each remote function call made from .NET to ABAP. You can view activity logs from the Manage Application Sets action pane.
Features
If using the Microsoft version of the system: The following conditions determine who and when users can perform certain tasks when the application set is set to Not available: Users have Offline Access task security: When users attempt to log on to Interface for Office, the following prompt is displayed Application set is unavailable. Do you want to continue? A response of Yes allows them to log on. A response of No does not. If RETRIEVE_ON_OFFLINE is set to 1 and users have the OfflineAccess task security assigned to them, the prompt Application set is unavailable. Do you want to continue? is displayed when they try to retrieve data. A response of Yes allows them to see data. A response of No does not allow them to see data. When users do not have Offline Access task security: When users attempt to log on to Interface for Office, the following prompt is displayed The application is not available at this time. Contact your administrator. Users cannot log on. If the user is logged on when the administrator takes the application set offline and RETRIEVE_ON_OFFLINE is set to 1, the user cannot retrieve data. NOTE If RETRIEVE_ON_OFFLINE is set to 0, users cannot retrieve data while the system is offline, regardless of task security. For information about tasks that open the prompt, see the RETRIEVE_ON_OFFLINE parameter in Application Set Parameters.
If using the NetWeaver version of the system: When you attempt to log on to an application set that is unavailable, you receive a warning and can open the application set to work offline on parked or locked documents. You can also query the application information, but the data may not be completely accurate.
Activities
You can manually set the status of an application set by doing one of the following: Set to Not Available Choose Application Set Status .
Not Available
Update
You can enter informative text to display to users who try to perform a restricted task while the application set is unavailable. We recommend including the current date and time so that users can see that the message is current, and to give an estimated time when they can log back on again. Set to Available Choose
Available
Update
Change the AVAILABLE_FLAG on the Application Set Parameters page to 1 for Available and 2 for Unavailable.
More Information
Application Set Management Application Set Parameters
Prerequisites
You have Appset task security rights to view and change application set parameters.
Features
The following table describes the parameters you can set from the Administration Configuration action pane. The parameters that require a value include (R) in the Type column. Parameters that do not require a value include (O) in the Type column. If an application set parameter is required, you can leave it blank to accept the default, but if you delete the parameter, the system may not work correctly. If an application set parameter is optional, you can leave it blank or delete it. Type Key ID Description The maximum file size the system permits users to upload. A warning message appears if the file size exceeds the parameter value when you upload a file. The default value is 100 MB. This parameter is used in: Interface for the Web - when posting documents in Content library menu Interface for Office - sending data, journal posts, Data Manager imports, e-mail notification attachments
(O) for the ALLOW_FILE_SIZE Microsoft version (R) for the NetWeaver version
Type (O)
Key ID APPROVALSTATUSMAIL
Description Defines whether owners and managers receive an e-mail when there is a change to an assigned work status. Has the following possible values: Yes: Send e-mail No: Do not send e-mail In the Microsoft version of Planning and Consolidation, the following SMTP application set parameters must be set up as well to use e-mail notifications in the system: SMTPAUTH, SMTPPASSWORD, SMTPPORT, SMTPSERVER, and SMTPUSER. In the NetWeaver version of the system, the ABAP SMTP service is used for sending e-mails. Allows you to define a custom e-mail message that is sent to the owners and managers of a work status when a work status code is changed. The message is applicable to all applications in the application set. You can customize the message using the following variables: %USER% Name of user who changed this status %STA% Work status %OWNER% Entity owner (Microsoft version only) %TIME% Time of change %REGION% - Lock region (NetWeaver version only) For example: ENTITY: CG1, TIME: 2009.Q1, DATASRC: DC_1, PROJECT: PRJ_1, PRODUCT: PRO_1
(O)
APPROVALSTATUSMSG
EXAMPLE You can create a message such as, This is to inform you that %USER% has updated the work status for %REGION% on %TIME%. The text of the e-mail can be a maximum of 255 characters. There is no need for quotes or brackets around parameters. (R) AVAILABLEFLAG Controls whether the system is offline or not. Yes means the system is online and available for sending data to the database. You can take the system offline by changing the value to No. This parameter is used in Interface for Office - Send Data, Journal Posts, DM Imports
Type (R)
Key ID AVAILABLEMSG
Description The message that displays to users who try to access an application that is offline (AVAILABLEFLAG = No). The default value is Current Appset status is available EXAMPLE The message could be The system is temporarily unavailable due to scheduled maintenance. Try again later. This parameter is used in Interface for Office - Send Data, Journal-post, DM-Import.
(R)
The URL of the warning page that displays when a user attempts to access an application that is offline.
(O)
BPFSTEP_COMPLETE_MSG Determines the content of the message that is displayed when a (In Microsoft version only) Business Process Flow step is completed. The default message is: [%BPF_STEP_NAME%] step of [%BPF_NAME%] has been completed by %USER_NAME%. This parameter is used in Admin console - Manage Business Process Flows.
(O)
CLR_COMMENTS_HISTORY Deletes the comment history except for the last comment entered. Possible values for this parameter are: 0: This is the default value and saves the history of comments. 1: The historical comments are deleted and only the latest comments remain. COMMENT_MAX_LENGTH (In Microsoft version only) Customizes the length of comments. The default value is 256 and the maximum length is 4,000 characters. NOTE If you set a smaller value than current value, the newly entered value does not apply to comment length and the previous value still applies even though the setting is updated successfully in AppSet parameters page. Therefore, the new value should be larger than the previous value.
(O)
Type (O)
Description Use this parameter to add your corporate logo to the default templates in the interface for Excel. Enter the file name for the logo image that you want to display. This image must be stored in the Application Set directory, which is "[Server Install]\Data\WebFolders\[Appset]". EXAMPLE C:\Program Files\SAP BusinessObjects\PC_MS\Data\WebFolders\[Appset] If the COMPANY_LOGO does not exist or the file name is invalid, the default globe image displays. Allows the bmp, gif, and jpg image file types.
(O)
DEFAULT_EXTENSIONS
The system allows the default file type even if you do not set this parameter. The default file extensions are hard-coded internally. The file extensions the system allows users to upload by default: .XLS, XLT, .DOC, .DOT, .PPT, .POT, .XML, .MHT, .MHTML, .HTM, .HTML, .XLSX, .XLSM, .XLSB, .ZIP, .PDF, .PPTX, .PPTM, .POTX, .POTM, .DOCX, .DOCM, .DOTX, .DOTM, .CDM, .TDM, .PNG, .GIF, .JPG, .CSS, .MRC. See ALLOWEXTENSIONS above. The user can change the value. This parameter is used in: Interface for the Web - When posting documents in the Content library menu Interface for Office - Send Data, Journal-post, DM-Import
(O)
Use this parameter to hide or show the Refresh Status Every checkbox in the Data Manager Status View. If the checkbox is enabled and large records exist, the performance when refreshing the status degrades. By hiding the checkbox, the refresh is performed whenever a user calls the refresh button manually. Possible values for this parameter are: 0: Hides the checkbox 1: Show the checkbox
Type (O)
Description Use this parameter to specify a report or input template containing the default style sheet. If no style template is specified in the EVDRE builder in the Formatting section, then the default stylesheet is applied from the template specified in this parameter. This allows users to customize their formatting and save the customization as the default style template. They do not have to manually reapply the template for each new report. Users can overwrite the default formatting for a given report or input template by using existing formatting options. The priority of formatting for a new EVDRE report or input template is: If a template is supplied in the Allow Formatting section, it is used. Otherwise, the style template specified in the EVDRE_STYLES parameter is used. Otherwise, the default EVDRE colors are used. By default, this parameter is empty. Style templates that are used for EVDRE formatting can be stored in any folder in the file service. The full file service path must be specified in the parameter, starting with //root/ of the file service, so that one template can be used globally, regardless of the AppSet. Changes to the style template specified in this parameter do not affect reports and schedules previously created from this template. Set to Y to query the database using predefined SQL statements stored in the tblCustomQuery table.
(O)
Type (R)
Key ID
Description
FILESFOLDERDELIMITER When you create Web-ready files in Excel, the system creates (In Microsoft version only) subfolders based on the native Excel Save as HTML function. Since the naming rule of the subfolder is different for each Microsoft Office language, this parameter allows the system to find the subfolder having the defined delimiter when selecting Web-ready files in Interface for the Web. (Required) The default value is _:.:-. You must define a value for this parameter if the value is empty, or does not contain the required delimiter for your Microsoft Office version. Separate multiple delimiters with a colon; for example, :,:_. EXAMPLE For example, under a folder named 'Report.htm', the system creates the following subfolders: Chinese: report.file English: report_files French: report_fichiers German: report-Dateien Italian: report-file Japanese: report.files Korean: report.files The user can define this delimiter depending on their country. Use : to separate multiple values. This parameter is used in Interface for Office - book publishing.
(O)
JREPORTZOOM
This parameter allows you to set the default zoom magnification value on HTML journal reports. We recommend that you set the value to 75%. This parameter allows you to set up a web page as your home page for the Web interface. Once you set this, this page displays for all users of this application set. The page must first exist as a Web page in Interface for the Web. (See Creating a Web Page.) The default value is 1. or you can enter the number that represents the web page you want to make your home page. The least value for which the system processes logic. If a data value is smaller than this value, they system does not process the logic. For example, when you set 0.001, smaller data values, such as 0.0009, are not processed by logic. The default value is .00000001, so if the parameter is not set, logic ignores less than 0.00000001. This parameter is used in Script Logic - Processing of script logic.
(O)
LANDINGPAGEITEM
(O)
Type (O)
Description Controls the minimum level of ABAP messages to store in the log in terms of severity, which you view by the transaction SLG1. The default value for this parameter is Info. The possible values for this parameter are: Donothing Info Warning Error Fatal This parameter controls the severity level of messages to store in the log file. The default value for this parameter is Info. The possible values for this parameter are: None Info Warning Error Fatal This parameter takes the system offline during a minimal optimization of an application. The default value for this parameter is: 0. The possible values for this parameter are: 0 do not change to offline 1 change to offline This parameter is used in Admin - Lite optimize. The maximum number of columns to display in a live report in Interface for the Web. The value includes header and data columns. The default value is 30. EXAMPLE If you specify a value of 5, one heading column and four data columns are displayed.
(O)
(O)
LOPTZ_AVAILABLE
(O)
MAXLRCOLUMNS
(O)
MAXLRROWS
The maximum number of rows to display in a live report in Interface for the Web. The default value is 50. and the value includes both header and data rows. EXAMPLE If you specify a value of 5, one heading row and four data rows are displayed.
Type (O)
Key ID MSNIMPASSWORD
Description The password that the system uses to operate Instant Message alerts in Insight. The default value is blank. This parameter is used in Insight - Alert. The user name that the system uses to operate Instant Message alerts in Insight. The default value is blank. This parameter is used in Insight Alert. Use this parameter to support dimension formulas with member IDs that contain double-byte characters, such as those in Japanese, Chinese, Korean, and Russian. The value defines the dimension formula column type as Nvarchar or Varchar. The default value is blank. Possible values are: 1 Dimension formula column is nvarchar instead of varchar to support double-byte characters. N/A or blank or 0 - Dimension formula column is varchar. This parameter is used in Admin - Process dimension.
(O)
MSNIMUSER
(O)
(O)
Use this parameter to restrict data retrieval and export while an application set is unavailable (system offline). The options are: 0: Does not allow retrieving or exporting data while an application set is unavailable regardless of OfflineAccess task security. 1 (default): Allows retrieving or exporting data while an application set is unavailable (system offline) if the user has OfflineAccess task security.
: The following tasks are exceptions to rule, and can be executed when the value is 0: Execute logic (script, business rules) from DM packages Run Export from fact table package Run Append into Fact Table package Add new comments Save data through DHE (Dynamic Hierarchy Editor) This parameter is used in all functions that retrieve or export data. For example: Refresh data in Interface for Office and Interface for the Web, Export DM package, Book Publish, and so on.
Type (O)
Description Allows for the use of an .EXE file type wrapper for running a package out of process from COM+. The options are: 0: Run in process 1 (default): Run out of process Defines the session time (in minutes) for the Whos Online feature. The default value is 3000 minutes. The authentication method of the SMTP server. This setting does not change the method on the SMTP server, but must match the type of authentication enabled on it. Failure to set this appropriately can result in errors from the e-mail server. The default value is: 1. Possible values for this parameter are: 0 = Anonymous 1 = Basic 2 = NTLM This parameter is used in: Interface for the Web - When posting documents, Work status, Alert Interface for Office - Offline distributor The password for the user name defined as the SMTPUSER. This parameter is Optional except when SMTPAUTH is 1 (basic), this parameter is Required The default value is blank. The user can input
(O)
SESSIONTIME
(R)
(O)
Preview the output Display the page. Save and view the output Save and display the page.
Result
Once the page is open, you can add and view comments, modify the contents of the page, or delete the page.
EvDRE Builder
This function allows you to quickly create a report by selecting the dimensions you want in the columns and rows, as well as a few more report details.
Features
A default report contains one expansion on the columns using the Time dimension, one expansion on the rows using the Account dimension, and the MemberSet Dep. You can use the following options for modifying the default report: Screen Element Available dimensions Description
Lists the dimensions that are available in the active application. You can select one or more dimensions and place them on the In columns and In rows fields using the arrow icons. Lists the dimensions that are placed in the column axis of the report. Use the up and down arrows to change the nesting order. Lists the dimensions that are placed in the row axis of the report. Use the up and down arrows to change the nesting order. Lists the dimension that has its members enumerated across the worksheets. See Expansion Across Sheets. Displays the memberset for the dimensions. See Edit Membersets in Drag and Drop Reporting.
In columns
In rows
Enable Expand Select to generate an Expand range parameter. Range See Expand Range Parameter. Enable Options Select to generate an Options range. Range An Option Range is a range of cells in which you can define your EvDRE options. Alternatively, you can enumerate the options in a comma-delimited list in the Options field. See EvDRE Options for the Microsoft version or EvDRE Options for the SAP NetWeaver version.
Description
Select to generate a Formatting range. If not selected, you can still define a format range, but you must do it manually. If selected, you can keep the default format (the standard report colors or the style template defined by the administrator in the EvDRE_STYLES application set parameter), or import the style from a predefined workbook (either local or serverbased). See Style Imports and Format Ranges. Select to generate a Sorting parameter. You can have the system automatically insert a break total into the worksheet, and choose to display the values in descending order. See EvDRE Sorting Range.
More Information
Style Imports
Features
The expansion replicates the sheet defining the expansion in several sheets (one sheet per expanded member), generating a book of reports for the desired set of members. The generated sheets are named after the member being expanded in the sheet. The page key defining the page member of the sheet dimension also contains the hard coded ID of the current member. Each of the resulting tabs contains a replica of the starting EVDRE function, where the chosen dimension's member specified in the PAGEKEY is the (hard-coded) member ID associated with the current sheet. The starting sheet defining the expansion is the first sheet of the expanded set. The starting sheet also has the chosen dimension's ID hard-coded in the page key, even if it initially contained a reference to the current view (by the use of EvCVW, for example). The member set defining the sheet expansion cannot be specified as relative to the content of the page key (because it becomes hard-coded). Otherwise, the workbook is not reusable for further expansions on different current views (of the dimension expanded in the sheets). The member set of the sheet expansion can be either self-defined or you can relate it to what is defined in the current view bar by pointing to another cell in the sheet. When you perform an expansion across sheets, the following restrictions apply: There must be only one EvDRE function in the sheet defining the expansion You can expand only one dimension across sheets (no nested sheet expansions) The BeforeRange and the AfterRange parameters for the sheet expansion are ignored The system ignores the Insert parameter for the sheet expansion.
Activities
To expand a memberset across sheets, use the EvDRE Builder to create a report. From the Spread across worksheets field, select the desired dimension.
Example
The following is the result of a 3D expansion performed on Entity SalesEurope: App: FINANCE ACCOUNT CATEGORY DATASRC ENTITY INTCO NetIncome ACTUAL Input Net Income Actual from GL Input
SALESEUROPE Sales Europe Non_InterCo Non-Intercompany Periodic EURO 2008.Q1 2008.Q1 2008.Q1 2008.JAN 2008.JAN 2008.FEB 2008.FEB 2008.MAR 2008.MAR
MEASURES
PERIODIC
NETINCOME
Net income
Features
You can use the following screen elements to design your report: Screen element Start Designing Description Select this screen element to choose the desired dimensions, members, and other options for the columns and rows. Drag any available dimension name to either the column or row area. The system nests the dimension if one already exists on the column or row. Select this element to include the dimension description in the grid. Choose the dimension for which you want to define members, then select options from the following list: Add Member Lists To define the members for the dimension, use Member Lookup. Add Member Selection Rules Choose from the following expansion options: SELF: only the selected members ALL: the selected members and dependents BAS: base level of only selected members DEP: only dependents of the selected members BASEMEMBERS: all base members for the dimension MEMBERS: all dimension members NOEXPAND: only the selected members with no expansion options Clear MemberSet Clears the members and starts over. Allows you to apply special formatting options to this data grid. For more information, see one of the following: For the Microsoft version, see EvDRE Options. For the SAP NetWeaver version, see EvDRE Options
Dimensions list in Design Options action pane Include description Edit MemberSets
Set Options
Activities
To create a report using drag and drop, follow these steps: 1. Select Reporting & Analysis from the Getting Started action pane in Interface for Excel. 2. Select Build a report using drag & drop. 3. Drag the Data Grid object to a cell in the top-left corner of an EvDRE data grid, then use the screen elements listed above to define the report. 4. Click the check box until you return to the Report State action pane, then select Save to My Reports folder. To remove a dimension, choose Edit report using drag and drop - Start designing in the action pane. Then, select the dimension cell and drag it out of the key range.
More Information
Editing Reports and Input Schedules
EvDRE Options
You can define any of the following options in the key range parameter to customize your EvDRE data.
Features
You can use the following methods for entering EvDRE options: You can enter the appropriate keywords in the Options cell of the KeyRange. The Options cell (which can also be named OptionRange), may contain an EvRNG function pointing to a range of cells listing valid options. This range is the default, if you select the Allow options box in EvDRE Builder. The first column in the range must contain a valid option keyword. The second column activates the corresponding option with a Y value, or with a numeric value. A list of options is below with a description of each; the keywords are NOT case sensitive. Option ApplyColumnAbove Description Applies the colors and formulas in the Before/AfterRange to the column. Automatically adjusts the size of the columns containing the EvDRE ranges to fit the content after refreshing data. Shows only the specified number (n) of the lowest values in the entire data range. The content of the data cache is written in the log file EvDre_log.txt. Disables the refresh action and performs only an expansion, when requested. The system does not retrieve data from the database. When you expand a report using the Groups dimension, which is used to identify consolidation sequences. Hides the corresponding key ranges. Prevents the system from refreshing data from the database Prevents the system from sending data to the database. Enforces a different percentage of input data to trigger SQL queries (default is 20%) Manual (or blank for Automatic) NEXJ,TUPLE (or blank for Automatic)
AutofitCol
Bottom n
DumpDataCache
ExpandOnly
GroupExpansion
NoSend PctInput
QueryEngine QueryType
Description Use a user-defined view for querying SQL data Add an Excel comment in any DataRange cell with a formula, if the value retrieved from the database differs from the one displayed by the formula. All empty cells in the data range are filled with zeros. Sorts a given column. Forces the query engine to only issue SQL queries Inserts new rows with subtotals.
SuppressDataRow andSuppressDataCol Performs a suppression on the defined data range directly in Excel. SuppressNodata Prevent the suppression of zero values. Only missing (no data) values are suppressed. Otherwise, both zeros and missing data are suppressed. Shows only the specified number (n) of highest values in the entire data range.
Top n
Activities
To define options, follow these steps: 1. Open an EvDRE report or input schedule. 2. In the Options cell of the Key range parameter table, enter the desired options. When you enter more than one, use a comma as the delimiter. For example, you can enter SumParent, AutoFitCol, NoSend. 3. Choose the Expand All button and save the report or input schedule. NOTE The first column in the range must contain a valid option keyword. The second column activates the corresponding option with a Yes value, or with a numeric value, where appropriate.
EvDRE Options
You can define any of the following options in the key range parameter to customize your EvDRE data.
Features
You can use the following methods for entering EvDRE options: You can enter the appropriate keywords in the Options cell of the KeyRange. The Options cell (which can also be named OptionRange), may contain an EvRNG function pointing to a range of cells listing valid options. This range is the default, if you select the Allow options box in EvDRE Builder. The first column in the range must contain a valid option keyword. The second column activates the corresponding option with a Y value, or with a numeric value. A list of options is below with a description of each; the keywords are NOT case sensitive.
Option AutofitCol
Description Automatically adjusts the size of the columns containing the EvDRE ranges to fit the content after refreshing data. Shows only the specified number (n) of the lowest values in the entire data range. The content of the data cache is written in the log file EvDre_log.txt. Disables the refresh action and performs only an expansion, when requested. The system does not retrieve data from the database. Hides the corresponding key ranges. Prevents the system from refreshing data from the database Prevents the system from sending data to the database. Add an Excel comment in any DataRange cell with a formula, if the value retrieved from the database differs from the one displayed by the formula. All empty cells in the data range are filled with zeros. Sorts a given column. Inserts new rows with subtotals.
Bottom
DumpDataCache
ExpandOnly
NoSend ShowComments
SuppressDataRow andSuppressDataCol Performs a suppression on the defined data range directly in Excel. SuppressNodata Prevent the suppression of zero values. Only missing (no data) values are suppressed. Otherwise, both zeros and missing data are suppressed. Shows only the specified number (n) of highest values in the entire data range.
Top
Activities
To define options, follow these steps: 1. Open an EvDRE report or input schedule. 2. In the Options cell of the Key range parameter table, enter the desired option(s). When you enter more than one, use a comma as the delimiter. For example, you can enter SumParent, AutoFitCol, NoSend. 3. Choose the Expand All button and save the report or input schedule. NOTE
The first column in the range must contain a valid option keyword. The second column activates the corresponding option with a Yes value, or with a numeric value, where appropriate.
EvDRE
You use the EvDRE (Data Range Exchange) function to generate Planning and Consolidation reports and input schedules.
Features
The flexible EvDRE function provides the following features: You can use EvDRE to create large reports or input schedules with optimal performance. By accepting cell ranges as parameters, EvDRE workbooks are faster to download and upload because there are no send or retrieve functions in the data cells. EvDRE is bidirectional; it can both send and retrieve data. It combines and extends the functionality of other Planning and Consolidation functions such asEvGET and EvSND. EvDRE is faster than these functions because it does not evaluate each cell. You can use EvDRE to build static workbooks (without expansions) as well as dynamic workbooks (with expansions), or workbooks where some dimensions are defined using static members while others dynamically expand. You can define one or more expansions on the rows, columns, or both simultaneously. Workbook options determine how EvDRE sends data. If the workbook option Type is set to Report, you cannot send data; if the option is set to Input Schedule, the template can retrieve and send data. See Workbook Options. For the Microsoft version only, you can create a new style template from an active EvDRE workbook. The following commands are available from the eToolsmenu: Open EvDRE default Styles. You select this menu option to open the default style template. You can edit it, and then use Save EvDRE Default Stylesto save it. Save EvDRE default Styles. You select this menu option to save the current formatting as a style template. After defining the template, you can go to Application Set Parameters to define it as the default template for all users creating EvDRE workbooks. After a default template is defined there,
changes saved to that template are automatically applied to newly created EvDRE workbooks (that is, there is no need to reset the application set parameter). Changes to a style template do not affect workbooks previously created from the same template. You can define one default style template for each application set. For more information, see Application Set Parameters.
Activities
To create an EvDRE report, use EvDRE Builder or the Drag and Drop Reporting feature.
Workbook Options
You use this function to set behavior options in an active report or input schedule.
Features
The system determines default workbook option settings depending on whether a report or input schedule is active. You can change any of the following options: Option Type Description Options are Report and Input Schedule. The refresh options provide default selections to optimize the workbook performance. After setting the type, you can further customize the refresh options to suit your needs. When you refresh a workbook, the system goes to the server and returns data values for the cells whose retrieval formulas are affected. When you expand a workbook, the expansion functions dynamically expand dimensional data. All refresh and expansion options for both reports and input schedules are enabled by default except for Refresh by sheet. Refresh workbook on worksheet update: The system automatically performs a refresh when a change is made to an affected data cell. Refresh after data send: The system automatically performs a refresh after data is sent to the database. If not selected, you can perform a manual refresh by selecting eTools Refresh . Expand on workbook open: The system automatically expands the expansion functions when the workbook opens. If you do not select it, you can perform a manual expansion by selecting eTools Expand All . Expand on CurrentView change: The system automatically expands the expansion functions when the current view is changed. (SeeDynamic Expansion.) If not selected, you can perform a manual expansion by selecting eTools Expand All . Refresh by sheet: When you tab from one worksheet to another in an EvDRE report, select this option to refresh each worksheet individually. Unopened worksheets are not refreshed. If you select this, users, who are not administrators, can set workbook options on a workbook. If you leave it blank, only administrators can change these options. By default, this check box is selected.
Option Drill-down
Description This option controls member expansion behavior in the active spreadsheet. You can use Expand by Overwriting Rows or Expand by Inserting Rows. When you select Expand by Overwriting Rows, the expanded members display in the rows below the expanded member, clearing existing members. When you select Expand by Inserting Rows, any rows below the expanded member shift down, and new rows are inserted to accommodate the newly displayed members. For performance purposes, there is a maximum number of rows and columns to return when the row or column in the report or input schedule dynamically expands. For Microsoft Excel, the maximum number of rows is 65,535 and the maximum number of columns is 255. However, for a file format of Excel 12 (Excel 2007) html, xml workbook or template, the maximum number of rows is 1,048,575 and the maximum number of columns is 16,383. When you open a Planning and Consolidation report or input schedule in Interface for Office or Interface for the Web, the data changes based on your current view. If you want an active workbook to always open to specific members, you can override one or more of the current view members. To override current view settings, enter some data in two columns (for member names and values) of an empty cell on the workbook. Enter the names and values of the members you want to hard code. Select eTools Workbook Options , then select the two-column range of cells that represents the current view settings, and then choose Add. Choose the Remove button to remove the range. NOTE The Override applies only to non EvDRE templates. It points to the control panel to control non-specified EvGET/EvGTSdefinitions. If you define a row/column, you can override only the dimensions for the page keys because the EvGET refers specifically to the row/column member ID.
This option allows you to save the active current view with the workbook when you have multiple reports open for which you want to see different current views. Rather than use the active session current view for all three reports, you select, then save the desired current view with each workbook. When you switch between the reports, a unique current view is used for each. You can set a Planning and Consolidation password on the workbook. A Planning and Consolidation password is required when the report or input schedule is distributed or collected using the Offline Distribution Wizard. The password is different from native Excel's workbook password. If you use the Excel password to secure a workbook, Planning and Consolidation expansions may not work properly. To set the password, select eTools Workbook Options from the Excel interface. The Workbook Options dialog shows whether the current workbook is locked or unlocked. You can lock the report or input schedule using thePark N Go feature. This field is used for cell-based comments. If an EvCOM function returns a specific comment value, you can have it displayed as text in the cell or in a Microsoft Excel comment dialog box.
Lock status
Activities
To set workbook options, open the workbook for which you want to set the options and choose Set workbook options from the action pane.
More Information
Expansion Functions VBA Workbook Options
Dynamic Expansion
You use this function to dynamically change the members displayed in a report, based on any number of criteria. Dynamic expansion utilizes Planning and Consolidation functions. The expansion functions are: EvEXP EvNXP
Features
Dynamic expansion has the following features: The system detects when a new dimension member is added to the application. When you use expansion formulas in your reports and input schedules, the new member is automatically displayed when you select a dynamic expansion formula that calls for the member (provided you have updated your dimensions from the server; for more information, see Client Options). You can set dynamic expansion to automatically expand each time the current view is changed in a report or input schedule.
Activities
To set dynamic expansion, open the report or input schedule for which you want to enable automatic dynamic expansion and from the action pane choose Set workbook options Expand on CurrentView change .
Example
With dynamic expansion you can do much of your analysis in one report. By just changing the current view of the expansion member you can yield a new set of data. For example, say you have a report with Accounts in the rows. The expansion in this report is based on the AccountType property of the current Account member. The current account is Revenue, which is an income account; therefore, the system returns all accounts with theAccountType INC in the report body. If you change the current account member to Salaries, which is an Expense account, the members displayed in the report body change to expense account.
More Information
Expansion Functions
Client Options
Client options are available for maintenance purposes.
Features
You can perform the following tasks for client maintenance: Reset the Current View Bar
You can reset the current view bar so that for each dimension, the top hierarchical level member displays, which also clears the list of recently accessed members. You reset the current view bar within Interface for Excel by choosing eTools Client Options Clear current view bar . Clear Local Application Information You can clear the files associated with an application from your client. After you perform this procedure, the next time you log on to this Interface for Excel application, you are prompted to complete the Connection Wizard, which allows you to select a server and any authorized application sets. You can clear the files associated with an application from your client by choosing within Interface for Excel eTools Client Options Clear Local Application Information . Refresh Dimensions When you log on to an application set whose structure has changed (there are changes to dimensions and templates stored on the server), the system automatically updates your client information. You can also initiate this procedure manually, which you should do only when instructed by your administrator. You can refresh the dimension information on your client with the dimension and member information saved on the server by choosing within Interface for Excel eTools Refresh dimension members . Refreshing Templates You can update the wizard templates on your client with the templates saved on the server by choosing within Interface for Excel eTools Client Options Refresh Dynamic Templates . Set Local Folder for Clients You can set a user-defined working folder on each client machine by choosing within Interface for Excel eTools Client Options Set local folder for Planning and Consolidation . The default working folder is the My Documents folder of a user. Member Lookup You can set options that control behavior on the Member Lookup dialog box (see Member Lookup).
Member Lookup
You use this function to select specific members to use in reports, input schedules, journals, member security definitions, and data management packages. In addition, from Interface for Excel, you can use it to copy and paste member lists into spreadsheets.
Features
You can use the following features when using Member Lookup, some of which are available only when performing certain tasks within the system: Feature Description
Description You can select members at any time to display in your report or input schedule. You can select only the dimensions and members to which you have access. To select a member, do one of the following: Highlight that member and click OK. Right-click the member and choose an option: Select sibling members of the current member Select all children of the current member Unselect sibling members of the current member Unselect all children of the current member Populate all children of the current member If a section is disabled, all members in the dimension are selected, and all members are returned to the report or input schedule upon clicking OK. You can select the checkbox next to one or more members to copy them to the active spreadsheet.
Feature
Description
Filter members You can filter the member list based on member properties as well as hierarchy. You select a property, an operator, and a value, then click Refresh to apply your changes to the current list. You can specify a filter on one or more properties. If you define a filter, the members can only be displayed in Table data view (not hierarchical). When filtering by properties, the following options are available: = Equal < > Not equal LIKE A pattern match that supports using an asterisk ( * ) before or after the value BT A range between a low and high value If you set selections with the same property, the logic operator between each selection is OR. If you set selections with different properties, the logic operator between each selection is AND. For example, when you set the following selections: Attr1 = 1 Attr1 bt 3 to 7 Attr2 <> 10 The filter is ((Attr1 = 1 or (Attr1 >=3 and Attr1 <=7)) and Attr2 <> 10). The logic operator for hierarchy selections is OR. For example: 2006.JAN SELF 2005.TOTAL BAS The filter is (SELF(2006.JAN) or BAS(2005.TOTAL)). The logic operator between Hierarchy selections and Attribute selections is AND. For example: Attr1 = 1 Attr1 bt 3 to 7 Attr2 <> 10 2006.JAN SELF y2005.TOTAL BAS The filter is ((Attr1 = 1 or (Attr1 >=3 and Attr1 <=7)) and Attr2 <> 10) or (SELF(2006.JAN) or BAS(2005.TOTAL)). You can filter by hierarchy in Data Manager. The following information applies: You can use the following filter options: SELF the value itself DEP direct children of the value BAS all the base members of the values children ALL all the children of the value You can save and modify filters using Maintain Filter. You can use the saved filters when selecting members for Data Manager packages. You can choose whether to return the members or filter to Data Manager by choosing Return By.
Description You can view the property values and attributes of a selected member. Members that are available for use when creating and modifying reports or input schedules are enabled. Properties that are for information purposes only are disabled. You can view a member's properties by opening the Member Lookup, then doing one of the following: Right-click the desired member, then select Member properties. Click the Show selected member properties link. After reviewing the list, click OK to close the Properties dialog box.
You can set options that control behavior on the Member Lookup dialog box. Set Member Lookup options To access the Member Lookup Options dialog box, open the Member Lookup, then select the Options button. In the Double-click Options section, select the checkbox if you want to select the member and return to the worksheet by double-clicking a member. This option closes the Member Lookup and returns to the active report or input schedule. If unselected, a double-click expands or collapses the member when double-clicked. This option keeps the Member Lookup open. The Select All Children Behavior section determines how members are selected when you use the Copy option to copy one or more members and paste them into your spreadsheet. See Copy and Paste Member Lists, below. Do one of the following: Select Select direct children only to only copy the members directly below the selected member. Select Select all descendents to copy all descendents of the selected member. Copy and Paste Member Lists You can copy members from Member Lookup and paste them into a spreadsheet. You can use this feature to create journal entries, reports, or input schedules. You can copy and paste a member list by doing the following: 1. Open the report, input schedule, or journal template from the Excel interface. Open Member Lookup for the applicable dimension. 2. Select a member or choose Select sibling members for the selected member. 3. Select the rows and columns in which to place the members. Choose the Copy Members button, then in the Copy Members dialog box, select in rows to place the members in the rows, or select in columns to place the members on the columns. 4. Select the first cell in which you want to place the members. Select Edit Paste to paste the members.
Description You can select members from Dynamic Hierarchy if Dynamic Hierarchy is available. The Dynamic Hierarchy option is available only for the entity type and group type dimensions, or the currency type dimension if the group Members are included in the currency type dimension, in a consolidation application, and a dynamic hierarchy is built and stored in the ownership application. You can select only the dimensions and members to which you have access. With the Dynamic Hierarchy option, the Entity and Group (or Currency) dimension hierarchies are dynamically displayed according to the consolidation hierarchy that was built for the time and category member selected in the current view. To select a member from Dynamic Hierarchy, do one of the following: Select a group member from the dynamic hierarchy if the group (or currency) dimension member selector is open, or select an entity member from the dynamic hierarchy if the entity dimension member selector is launched. Highlight that member and click OK. Right-click the member and choose an option: Select sibling members of the current member Select all children of the current member Unselect sibling members of the current member Unselect all children of the current member Populate all children of the current member If a section is disabled, all members in the dimension are selected, and all members are returned to the report or input schedule upon clicking OK. If a dimension does not have a dynamic hierarchy, the dynamic hierarchy option is unavailable. You can select the checkbox next to one or more members to copy them to the active spreadsheet. The Dynamic Hierarchy option is available only in the Excel client, specifically in the action pane, EVDRE report, EVCVW function, and in the embedded Excel object in the Office client. Its availability also depends on ownership transaction data.
Activities
To access the Member Lookup, do one of the following: Choose a dimension member from the Session Information section of the action pane, select the down arrow next to a dimension, then select more. From the eTools menu, select Select Members, then select the dimension whose members you want to view. Right-click any cell in a workbook and select Select Members, then select the dimension whose members you want to view. Run Data Manager packages for which you need to select members. When selecting members, be aware that using the operator Between functions as expected for all types of dimensions except for Time. Between is a string comparison, and therefore does not take into account the concept of time. For example, if you want to select all members under 2005.TOTAL and 2006.TOTAL, setting up ID BT 2005.TOTAL to 2006.TOTAL would be incorrect because the string 2005.Q1 does not fall between 2005.TOTAL and2006.TOTAL. 2005.Q1 would not be selected.
More Information
Reports and Input Schedules Data Management for the NetWeaver platform or Data Management for the Microsoft platform
Journals
More Information
Creating Reports and Input Schedules Common Report and Input Schedule Features Dynamic Report and Input Schedule Templates EvDRE Builder Drag and Drop Reporting Live Reporting Data Submission
Features
The following table describes some of the basic tasks you can perform in reports and input schedules: Task Set workbook options Description You can set behavior options on an active report or input schedule in the Workbook Options dialog box. See Workbook Options. The current view represents the dimension members displayed. You can change any variable members in the current view. See Current View. The drill-down function allows you to drill down on member data within dimensions. See Drill Down. You can refresh your reports and input schedules to retrieve current data from the database. See Refresh Report Data.
Worksheet You can set dimension locks on a schedule. The locked dimension members display in dimension lock the action pane as not editable. See Dimension Locks. options Park and Go You can lock and unlock the current view, or both the current view and data, in an input schedule. See Park N Go.
Insert functions You can insert functions to build formulas. See Functions Reference. NOTE When you use a template that removes schedules, you can insert functions only into EvDRE reports. Add and view comments Insert Dashboard You can add or view text comments in your schedule. See Comments.
Allows you to embed an Xcelsius SWF file into an Excel workbook. The Xcelsius document is based on the current view. If you change the current view, the Xcelsius document is updated. If you embed an Xcelsius document in any other way through an Excel function, it is not based on the current view. Allows you to resize an Xcelsius SWF file frame once it has been inserted into an Excel workbook. If you want to apply special formatting to read-only cells, cells that are ready for input, or changed cells, you can use the FormatRange option in EvDRE. For example, for calculated cells, you can set theUSE formatting option to LOCK (then lock those cells through native Excel), to prevent the user from changing calculated cells. See Format Ranges.
Activities
Create a report or input schedule by using an existing template, report, or schedule, or by using an empty workbook. You can open a template from the template library, or create a new EvDRE report or schedule. For more information, see EvDRE Builder, Dynamic Report and Input Schedule Templates, or Drag and Drop Reporting.
Workbook Options
You use this function to set behavior options in an active report or input schedule.
Features
The system determines default workbook option settings depending on whether a report or input schedule is active. You can change any of the following options: Option Type Description Options are Report and Input Schedule. The refresh options provide default selections to optimize the workbook performance. After setting the type, you can further customize the refresh options to suit your needs. When you refresh a workbook, the system goes to the server and returns data values for the cells whose retrieval formulas are affected. When you expand a workbook, the expansion functions dynamically expand dimensional data. All refresh and expansion options for both reports and input schedules are enabled by default except for Refresh by sheet. Refresh workbook on worksheet update: The system automatically performs a refresh when a change is made to an affected data cell. Refresh after data send: The system automatically performs a refresh after data is sent to the database. If not selected, you can perform a manual refresh by selecting eTools Refresh . Expand on workbook open: The system automatically expands the expansion functions when the workbook opens. If you do not select it, you can perform a manual expansion by selecting eTools Expand All . Expand on CurrentView change: The system automatically expands the expansion functions when the current view is changed. (See Dynamic Expansion.) If not selected, you can perform a manual expansion by selecting eTools Expand All . Refresh by sheet: When you tab from one worksheet to another in an EvDRE report, select this option to refresh each worksheet individually. Unopened worksheets are not refreshed. If you select this, users, who are not administrators, can set workbook options on a workbook. If you leave it blank, only administrators can change these options. By default, this check box is selected.
Option Drill-down
Description This option controls member expansion behavior in the active spreadsheet. You can use Expand by Overwriting Rows or Expand by Inserting Rows. When you select Expand by Overwriting Rows, the expanded members display in the rows below the expanded member, clearing existing members. When you select Expand by Inserting Rows, any rows below the expanded member shift down, and new rows are inserted to accommodate the newly displayed members. For performance purposes, there is a maximum number of rows and columns to return when the row or column in the report or input schedule dynamically expands. For Microsoft Excel, the maximum number of rows is 65,535 and the maximum number of columns is 255. However, for a file format of Excel 12 (Excel 2007) html, xml workbook or template, the maximum number of rows is 1,048,575 and the maximum number of columns is 16,383. When you open a Planning and Consolidation report or input schedule in Interface for Office or Interface for the Web, the data changes based on your current view. If you want an active workbook to always open to specific members, you can override one or more of the current view members. To override current view settings, enter some data in two columns (for member names and values) of an empty cell on the workbook. Enter the names and values of the members you want to hard code. Select eTools Workbook Options , then select the two-column range of cells that represents the current view settings, and then choose Add. Choose the Remove button to remove the range. NOTE The Override applies only to non EvDRE templates. It points to the control panel to control non-specified EvGET/EvGTS definitions. If you define a row/column, you can override only the dimensions for the page keys because the EvGET refers specifically to the row/column member ID.
This option allows you to save the active current view with the workbook when you have multiple reports open for which you want to see different current views. Rather than use the active session current view for all three reports, you select, then save the desired current view with each workbook. When you switch between the reports, a unique current view is used for each. You can set a Planning and Consolidation password on the workbook. A Planning and Consolidation password is required when the report or input schedule is distributed or collected using the Offline Distribution Wizard. The password is different from native Excel's workbook password. If you use the Excel password to secure a workbook, Planning and Consolidation expansions may not work properly. To set the password, select eTools Workbook Options from the Excel interface. The Workbook Options dialog shows whether the current workbook is locked or unlocked. You can lock the report or input schedule using the Park N Go feature. This field is used for cell-based comments. If an EvCOM function returns a specific comment value, you can have it displayed as text in the cell or in a Microsoft Excel comment dialog box.
Lock status
Activities
To set workbook options, open the workbook for which you want to set the options and choose Set workbook options from the action pane.
More Information
Expansion Functions VBA Workbook Options
EvCOM
The EvCOM function references another cell and sends its value, a textual comment, to the database when specified. SYNTAX EvCOM(CommentRange,AppName,Member1,Member2,and so on) CommentRange The cell reference of the input cell. Insert AppName Insert Member1N EXAMPLE The following example sends the text value in cell D16 to the database. EvCOM(D16,Finance,Salaries,Budget,Jan2008)
Expansion Functions
Functions that allow dynamic expansion of dimensional data in reports and input schedules.
Features
When you use expansion functions in reports and input schedules, you can use the following features: You can dynamically expand dimensional data based on criteria defined in the expansion formula In the expansion formula, you can specify whether to expand the report by row, column, or both; and on which member to base the expansion criteria. NOTE The expansion copies the first row if there is no column expansion; it copies the first column if there no row expansion; and it copies the upper left cell of the data range if there is both first row and column expansion. When you choose a cell that contains an expansion formula, the system restructures the report to include the new members, while maintaining its original design.
Prerequisites
To apply these variables to the workbook, you should be familiar with VBA programming.
Features
The following table shows the available variables:
Variable EV__EXPOPTIONS__
Description
Example values
The drill down options control the 1 member expansion behavior in the active spreadsheet. 0: (Expand by Overwriting Rows) The expanded members display in the rows below the expanded member, clearing existing members as needed. 1: (Expand by Inserting Rows) Any rows below the expanded member shift down, and new rows are inserted to accommodate the newly-displayed members. Displays the time of the last refresh 20080715 10:38:24 (EVRTI function) NetIncome,ACTUAL,Input, Sales, Non_InterCo,LC, 2008.TOTAL, PERIODIC, 1
EV__LASTREFTIME__
Specifies the Park N Go status. 1: Live data and static current view 2: Static data and static current view 4: Offline workbook Specifies the maximum number of columns for expansion. Specifies the maximum number of rows for expansion.
EV__MAXEXPCOLS__
100
EV__MAXEXPROWS__
1000
EV__MEMORYCVW__
Specifies whether or not the system 1 memorizes the current view in the workbook. 0: Do not memorize 1: Memorize Specifies the workbook mode: 0: Report 1: Input schedule 1
EV__WBEVMODE__
Variable EV__WBREFOPTIONS__
Description Specifies refresh and expand options: 1: Recalculate workbook on worksheet update 2: Recalculate workbook on worksheet open 4: Recalculate on CurrentView change 8: Refresh after data send 16: Expand on workbook open 32: Expand on CurrentView change 134217728: Allow users to change options An internal flag.
Example values 41
EV__WBVERSION_
Current View
The Planning and Consolidation current view feature transforms static spreadsheets into dynamic, reusable reports and input schedules. The current view represents the following: The dimensions that are included in the current application. The members that are used in the current display of a live report (or the saved members in an offline report).
Features
You can dynamically select members to change the current view in a live report by selecting new members from the current view. Any cell in a report or input schedule that contains the EvCVW function is dependent on the current view. If you change the current view, the data displayed changes to reflect the new current view settings. You can set a workbook to refresh automatically upon selecting a member from the current view, or you can allow a manual refresh. For more information, see Workbook Options. If current view values are in conflict, the higher the rank, the higher the precedence. See Current View Precedence.
Activities
To change the current view, make sure the action pane is maximized. From the action pane, maximize the current view list in the Session Information section. Specify the desired member. If you are prompted to refresh the report or input schedule, choose Yes. NOTE If you choose to refresh data, the system goes to the server and returns new data values, and you lose any previous input.
You can define which current view has precedence by a combination of the settings described in the following table.
Features
The full key (current view) of a cell is controlled by EvDRE overlaying onto each cell the definitions of a current view as defined by any combination of the following settings: Rank 1 2 Description The system current view, as defined by the current view bar. The workbook current view, as defined in the workbook options. NOTE The Park N Go feature does not override the current view. 3 4 5 6 The page current view, as defined in the PageKeyRange. The column current view, as defined in the ColumnKeyRange. The row current view, as defined in the RowKeyRange. The cell current view, as defined in the CellKeyRange.
If these definitions are in conflict, the system takes precedence from the lowest to the highest. For example, the cell key, if it exists, takes precedence over the row key, the row key takes precedence over the column key, and the column key takes precedence over the page key.
More Information
Current View
Current View
The Planning and Consolidation current view feature transforms static spreadsheets into dynamic, reusable reports and input schedules. The current view represents the following: The dimensions that are included in the current application. The members that are used in the current display of a live report (or the saved members in an offline report).
Features
You can dynamically select members to change the current view in a live report by selecting new members from the current view. Any cell in a report or input schedule that contains the EvCVW function is dependent on the current view. If you change the current view, the data displayed changes to reflect the new current view settings. You can set a workbook to refresh automatically upon selecting a member from the current view, or you can allow a manual refresh. For more information, seeWorkbook Options. If current view values are in conflict, the higher the rank, the higher the precedence. See Current View Precedence.
Activities
To change the current view, make sure the action pane is maximized. From the action pane, maximize the current view list in the Session Information section. Specify the desired member. If you are prompted to refresh the report or input schedule, choose Yes. NOTE If you choose to refresh data, the system goes to the server and returns new data values, and you lose any previous input.
Drill Down
You use this function to drill down on member data within dimensions. You can drill down on members in a worksheet, or you can drill down on charts and graphs.
Prerequisites
To drill down on members in a worksheet: Expansion is enabled in the workbook. A hierarchy-based dimension is included either in the rows or columns. To perform graphical drill down: The source report has a hierarchy-based dimension in the rows and/or columns. The chart is on its own worksheet, and the worksheet appears immediately after the worksheet with the source data on it.
Features
You can do the following: You can drill down on members in a workbook. Upon selecting an expansion member, the spreadsheet automatically displays the immediate dependents of that member. You can create graphical drill downs. You can drill down on charts and graphs to make your charts and graphs dynamic.
Activities
To drill down on members in a workbook, select the member you want to drill down on and doubleclick the member ID or the description. You can use the action pane to both drill down and drill back up.
More Information
Dynamic Expansion
Features
You refresh your report data when you change members using the current view, and when your report contains dynamic expansions. You set up automatic refresh settings in workbook options. See Workbook Options. If the report contains EvSND functions, you are prompted to send updated data. You can refresh data in the following ways:
Description Refreshes data in the active cell. Refreshes data in the active worksheet.
Retrieve active workbook Refreshes data in the active workbook. Retrieve supporting documents Retrieve and refresh dimension members Set automatic refresh This option opens the Content Library, where you can retrieve a supporting document. See Content Library. Fetches the latest dimension information from the database.
This option automatically refreshes the report when you change the current view settings in the Workbook Options dialog box. See Workbook Options.
Activities
To refresh data in a report, open the report for which you want to refresh data and choose Retrieve data from the action pane. Select one or more of the available options.
More Information
Creating Reports and Input Schedules Dynamic Expansion
Content Library
The Content Library is a repository for storing files that you want to share. Valid file types include Microsoft Word, Excel, and PowerPoint, HTML, text (such as an e-mail), web pages and images, but the list of file types can be customized by your system administrator.
Integration
To use this feature, select Content Library in Interface for Web or go to http://<server_name>/OSoft/Contents/WebContentsList.aspx.
Features
You can use the Content Library features to post, share, retrieve, and manage the display of documents. Documents that have an application context are associated with a current view. For example, a Microsoft Word document might be associated with a particular report. If you want to view a report and anything that is associated with that report, you can view a particular current view. Relevant reports and documents are displayed.
Activities
You can post documents that reside on a hard drive or network folder. Posted files display in a list and are filtered by a users current view, a users view rights to information, and any manual filters set. You can delete items that you posted to the Content Library list. Select one or more items and click Delete Selected Items from the Content Library Options action pane.
When you post a document to the Content Library using the Content Library Options action pane, you can describe the document, set access to the document, and determine whether you want to send a notification e-mail about the posting. You can view one item by choosing its title. You can view multiple items from the Content Library list in tabs, which allows you to flip through the tabs to easily view each file. You select items you want to view and click Open selected items in tabs. To sort the list, click Sort this list from the Content Library Options action pane or by click a column heading. You can categorize, sort, and filter documents in the Content Library list by the following elements: Document type and subtype Application context Access rights Date You can filter the items in the Content Library list to see a subset of the files by clicking Filter this list from the Content Library Options action pane. You can assign a document type and subtype to aid sorting and filtering. System administrators define document types. Subtypes are defined by a user when the document is posted. You can create pages in the Content Library for displaying content and also set access to those pages. See Creating a Web Page. To open multiple Content Library items in separate tabs, select two or more items and choose Open selected items in tabs.
Result
Once the page is open, you can add and view comments, modify the contents of the page, or delete the page.
Dimension Locks
You can set dimension locks on the worksheets of a report or input schedule so end users cannot change those dimension members in the current view displayed in the action pane. The locked dimension's members display in the action pane as not editable.
NOTE In the Microsoft version of the product, the current view of a business process flow overrides the dimension locks in a worksheet. For more information, see Business Process Flows and Defining Actions.
Features
You lock dimensions on a worksheet by selecting the application and dimension members for which you want to prevent entry. You select the Worksheet Dimension Lock Options menu item from the Report State action pane, then select the desired application, and then the dimensions. NOTE You cannot lock a dimension if it is defined as secure for a specific application. You can unlock a dimension member by selecting the check box next to the dimension name to remove the check.
Features
You can use these business process flow features:
Personal To Do List
The To Do List displays required steps and optional substeps assigned to you, or completed steps that you must review, based on region. Therefore, they are called step regions. The To Do List displays the name and current status of each step region for which you are responsible. Steps can have the following statuses: Status Action Required Review Required Completed Rejected Waiting for Proper Work Status Pending Description Waiting for completion as a new step. Action has been taken and the step is waiting for review. The step has passed completion criteria. The step has failed to pass completion criteria. The step is waiting for its work status to be updated.
Status Reopen
Waiting for Reopen The step is waiting to be reopened by a reviewer. If it is a Review Required step, a user cannot reopen the step it can only be reopened by a reviewer. When a user requests a reviewer to reopen a step, it has the status of Waiting for Reopen. Unavailable The step is not available; no action can be undertaken.
Step Completion
When completing a step or substep, the action pane displays context-sensitive options to assist you with completing tasks. Completion of steps is audited by the system and appears in audit reporting. When a step is completed, all reviewers nominated for the step receive an e-mail if Send e-mail to reviewers on completion is set.
Reports
You can create reports on business process flows. See Reporting on Business Process Flows.
Activities
You access your Personal To Do List and business process flow reports using the links in the action pane that displays when you enter the Web interface. You perform the following business process flow activities: Click a step in the Personal To Do List to launch the appropriate Planning and Consolidation function. This allows you to complete the step or launches the next substep. To indicate you have completed a step, click Completed in the To Do List. This modifies the status of the step. To refresh your To Do List, click Refresh. This allows you to see the activity of other users who share ownership of a step. To reset a currently open business process flow instance, click Reset this BPF instance in the action pane of the To Do List. To reset a currently open instance, you must have the Reset task profile. To reopen a previously completed step, click Reopen this step in the action pane of the To Do List. To reopen a previously completed step, you must have the Reopen step task profile, the step must previously have been set by an administrator as Allow Reopen, and the status of the step must be Completed. If the step has a status of Review enabled, only the reviewer can open it.
Defining Actions
An action is a specific task a user performs when completing a step of a business process flow. You can assign actions to steps that do not have substeps, substeps themselves, and steps that require custom review by a participant. NOTE Since the BPF current view takes precedence over any dimension locks in a workbook, we recommend that the BPF actions do not reference workbooks that have locked dimensions. This prevents confusion about which dimension and member combination is being used. Another reason for this is that the BPF current view is applied only on the active sheet. If the person performing the action opens another sheet in the same workbook, the BPF current view is not transferred, and any dimensions locked in the worksheet apply. Therefore, if you want to apply a BPF current view to nonactivated sheets (that is, not the initially opened sheet), do not reference a workbook with locked dimensions. If you want to use the same current view across the workbook (and not the BPF current view), you can use the 'Override current view settings' option in the Workbook Options dialog box (see Workbook Options). The workbook current view settings impact the entire workbook's current view, but do not prevent users from manually changing their current view. Note that any locked dimensions not specified in the BPF current view are still locked in the opened worksheet. For example, if the BPF region uses Entity, Category, and Time, and the Entity and Category dimensions are locked in the workbook, the Entity and Category members are taken from the BPF, and the Time member is taken from the worksheet. EXAMPLE An action can be any user-authorized task, for example, opening a schedule or publishing a report.
Procedure
1. From Define Actions, choose a step or substep. 2. The name of the step or substep appears as the default action name. Add additional names or modify the name to be displayed if desired. The first action in the list is the one that displays when the user selects the action. 3. Associate a BPC interface and task with the action, entering valid parameters for the specified interface or task. 4. Associate an application with the action and specify the source of the values for each dimension. 5. Save the action, then define actions for additional steps and substeps as required. 6. Finish the BPF by reviewing the BPF and enabling it for use (see Finishing BPFs).
Finishing BPFs
In this final screen, you can review the new business flow, and release the BPF now, or hold it for use at a later date. Once the BPF is released, users can create instances of its use.
Procedure
1. From Finish, review the information you entered when setting up the BPF, defining steps and substeps, and defining actions. 2. Make the BPF immediately available to users, or reserve it for future use. 3. Save the BPF, then close the business process flow assistant.
Features
The following types of reports are available for business users. When generating a report, you choose the name of the business process flow and criteria for the report. Criteria include the start and end date and time frame for the BPF, the associated data region, and the orientation of the report. Standard BPF reports give you information about data regions, grouped by step. Step BPF reports give you information about steps, grouped by data region.
Activities
To generate a report for a business process flow, choose Launch Planning and Consolidation System Reports from the Getting Started Options action pane in the Interface for the Web. Choose BPF Report from the action pane and select a standard report or a step report. After specifying a start date, end date, orientation, and data region, choose OK to generate the report in a new browser window.
Defining Actions
An action is a specific task a user performs when completing a step of a business process flow. You can assign actions to steps that do not have substeps, substeps themselves, and steps that require custom review by a participant. NOTE
Since the BPF current view takes precedence over any dimension locks in a workbook, we recommend that the BPF actions do not reference workbooks that have locked dimensions. This prevents confusion about which dimension and member combination is being used. Another reason for this is that the BPF current view is applied only on the active sheet. If the person performing the action opens another sheet in the same workbook, the BPF current view is not transferred, and any dimensions locked in the worksheet apply. Therefore, if you want to apply a BPF current view to nonactivated sheets (that is, not the initially opened sheet), do not reference a workbook with locked dimensions. If you want to use the same current view across the workbook (and not the BPF current view), you can use the 'Override current view settings' option in the Workbook Options dialog box (see Workbook Options). The workbook current view settings impact the entire workbook's current view, but do not prevent users from manually changing their current view. Note that any locked dimensions not specified in the BPF current view are still locked in the opened worksheet. For example, if the BPF region uses Entity, Category, and Time, and the Entity and Category dimensions are locked in the workbook, the Entity and Category members are taken from the BPF, and the Time member is taken from the worksheet. EXAMPLE An action can be any user-authorized task, for example, opening a schedule or publishing a report.
Procedure
1. From Define Actions, choose a step or substep. 2. The name of the step or substep appears as the default action name. Add additional names or modify the name to be displayed if desired. The first action in the list is the one that displays when the user selects the action. 3. Associate a BPC interface and task with the action, entering valid parameters for the specified interface or task. 4. Associate an application with the action and specify the source of the values for each dimension. 5. Save the action, then define actions for additional steps and substeps as required. 6. Finish the BPF by reviewing the BPF and enabling it for use (see Finishing BPFs).
Functions Reference
All Planning and Consolidation reports and input schedules use custom functions to retrieve, send, and display data. These functions are commands that are used with cell references and values in formulas to make a report behave in a certain way, providing power and flexibility to reports and input schedules.
Features
You can insert functions into reports and input schedules to build formulas. You use the formulas to create or modify reports and input schedules.
Activities
You use the Insert function option on the action pane to insert functions.
Comments
Comments provide a vehicle for submitting, storing, and retrieving text commentary associated with Planning and Consolidation data cells. This allows users to annotate data so other users can view supporting information associated with a particular data point.
Integration
The Comments function is fully integrated in Interface for Excel, Interface for Word, Interface for PowerPoint, and Interface for the Web. Therefore, you can enter and view comments from within any interface that manages data.
Features
You can use comments in the following ways: You send/retrieve a comment using the action pane. You can see comments on a series of data such as a specific report or Content Library document that is not driven by the current view. You can retrieve a comment for a specific cell in Interface for Excel, but not in Interface for the Web live reports. You can use functions to retrieve comments based on a fully specified or partially qualified current view. See EvCGP and EvCGT.
Adding Comments
You can add comments using the EvCOM function or through the action pane. The Add comment link is available on any action pane from which the context of the page allows you to enter a comment. In the Microsoft version, you can set the comment length using the COMMENT_MAX_LENGTH parameter. The maximum length is 4,000 characters. For more information, see Application Parameters. NOTE If you use EvCOM, you must pass along all the dimension members and application with the text within the formula syntax. When adding a comment, you may specify the following items: Item Context Description Select how to apply the comment: The published page (Interface for the Web) This option is available when a published report or input schedule is active. The comment becomes associated with the active report or input schedule. The active report or schedule cell (Interface for Excel) This option is available when a live report or schedule is active. The comment is applied to the data region associated with the selected cell. The selected Planning and Consolidation data (Interface for Word/Powerpoint) This option is available when you select Insert data object. The active current view This option applies the comment to the current view shown in the action pane. Custom current view This option allows you to specify a specific current view to which to associate the comment. From the Comment for These CV Values table, select the application. For each dimension, select the check box next to the dimensions for which you want a specific member or all members to apply. Leaving a check box unselected ignores the members for that dimension for this comment. To select a member using the Member Lookup, click a dimension link. See Member Lookup. Select the desired priority level or No Priority. The reports show comments in order of their priority level.
Priority
Item
Description
Keywords Use keywords to organize and search for comments in the database. This field takes blanks and empty strings.
Viewing Comments
If you have a live report or input schedule open, you can view any comments that are associated with it. You can also view comments associated to the current view of a selected cell within that report or input schedule, or view any comments for a specific current view. To view relevant comments, you must answer some questions so the system can filter the database. Item Context Description Select how to apply the comment: The published page (Interface for the Web) This option is available when a published report or input schedule is active. The comment becomes associated with the active report or input schedule. The active report or schedule cell (Interface for Excel) This option is available when a live report or schedule is active. The comment is applied to the data region associated with the selected cell. The selected Planning and Consolidation data (Interface for Word/Powerpoint) This option is available when you select Insert data object. The active current view This option applies the comment to the current view shown in the action pane. Custom current view This option allows you to specify a specific current view to which to associate the comment. From the Comment for These CV Values table, select the application. For each dimension, select the check box next to the dimensions for which you want a specific member or all members to apply. Leaving a check box unselected ignores the members for that dimension for this comment. To select a member using the Member Lookup, click a dimension link. See Member Lookup. You select the checkbox to show multiple comments for the specified search criteria. Leave the checkbox blank to return only the most recent comment that meets the criteria. You select one or more priority options to return comments associated with that priority. You can enter a keyword (up to 50 characters) to return only comments with a matching keyword. You can select one of the following: Comments from anyone. This option returns comments entered by all users. Comments from myself. This option returns comments that were entered by you. Comments from another user. This option returns comments entered by a specific user. Enter a valid user in the User edit box.
Comments by You can select the Search by date range check box to specify a date range for which to return comments. Use the From and To drop-down lists to specify the desired date range. date range
Clearing Comments
You can delete comments from the comment history, except for the last comment entered, using the CLR_COMMENTS_HISTORY application set parameter. For more information see Application Set Parameters. You can also delete or remove comments with conditions through the ClearComment package in Data Manager.
Priority
Keyword
Originator Date
Activities
Adding Comments To add a comment, open the report or input schedule and select the cell in which you want to add a comment. From the Report State action pane, select theAdd a new comment link. Specify the requested information, then enter the comment (up to 265 characters). Viewing Comments To view a comment, from a live report/input schedule or a selected cell in a report/input schedule, select View comments from the action pane. Specify the requested information to view the Comments Summary page.
More Information
EvCOM
EvCGP
The Get Partial Comment function retrieves comments based on a partially-qualified current view. The system ignores any members not specified in the function. The comments returned are those added to the database using each one of the specified members or All. SYNTAX 1. EvCGP(Application Name,Member1,Member2,Membern) Application Name The name of the application. Member1- n The ID of the member from which to obtain associated comments.
EvCGT
The Get Comment function retrieves comments for a fully-specified current view. The system takes any members not specified in the function from the current view. The comments returned are those added to the database using each one of the specified members or [ALL]. SYNTAX 1. EvCGT(Application Name,Member1,Member2,Membern) Application Name The name of the application. Member1- n The ID of the member from which to get associated comments.
Application Parameters
Application parameters control the way certain features behave in an application.
Prerequisites
Administrators with Administration - Application task security rights can set application parameters.
Features
Application parameters can be different for each application within an application set. If an application parameter is required, you can leave it blank to accept the default. If you delete the parameter, the system may not work correctly. If an application parameter is optional, you can delete it. The following table describes the parameters you can set within the Administration interface using the Administration Configuration action pane. The parameters that require a value include (R) in the Type column. Parameters that do not require a value include (O) in the Type column. If an application parameter is required, you can leave it blank to accept the default, but if you delete the parameter, the system may not work correctly. If an application parameter is optional, you can leave it blank or delete it. Type Key ID Description
Type (O)
Description Use this parameter to specify that various modules write detailed runtime statistics to the tables UJ0_STAT_HDRand UJ0_STAT_DTL. You can use this information to monitor system performance. Valid values are: ON OFF
(O)
CUSTOMFACTBLINDEX(i Use this parameter to define a dimension list to create a custom n Microsoft version only) index in the appropriate database table and accelerate import processing. Valid values for this parameter are: Category, Time, Entity, Account, and RptCurrency. Enter a list of dimensions into this parameter, separated by commas. The default value is blank. When you use a custom fact table index, we recommend that when you modify the application, you select theReassign SQL Index option. This parameter is used in Admin - Modify application, Add a new application, Copy an application.
(O)
DIMSFORFACTTBLINDE Use this parameter to specify the fields and the field order for the indexes used by the Fact, Fac2 and write-back tables. The Fact and X(in Microsoft version Fac2 tables use a clustered index; the write-back table uses a only) composite index. Valid values are: Category Time Entity Account RptCurrency
Enter a list of dimensions into this parameter, separated by commas. The default value is: Category, Time, Entity, Account, RptCurrency If the parameter is blank, the default fields and field order are used. This parameter is used in Admin - Modify application, Add a new application, Copy an application. (O) DTSLOGPAGESIZE Use this parameter to set the number of records that display in the Data Manager Status View. Enter the number of records to display. The default value is 300. This parameter is used in Data Manager - Status View.
Type (O)
Key ID JRN_ACCDETAIL_DIM
Description Use this parameter to specify a special dimension name used to manage the Opening, Closing, and Reverse Sign codes. This is used with JRN_CLOSING_CODE, JRN_OPENING_CODE, and JRN_REVSIGN_CODE. This parameter is used in Interface for Office - Journal.
(O)
JRN_BALANCE
Use this parameter to control whether it is necessary for Journals to be balanced. Valid values are: 0 Journals need not be balanced 1 Journals need to be balanced The default value is 0. This parameter is used in Interface for Office - Journal.
(O)
JRN_CLOSING_CODE
Use this parameter to specify the member name for the Closing code. This member is part of the dimension name specified by JRN_ACCDETAIL_DIM. The member name must be set to use this feature. The default value is blank. This parameter is used in Interface for Office - Journal.
(O)
JRN_DESC_MODE
Use this parameter to allow the display of the description in the journal template. Valid values are: N Displays the member ID in the journal template for the application. This provides optimal readability. Y Displays the description of member in the journal template The default value is N. This parameter is used in Interface for Office - Journal.
(O)
JRN_IS_STAT_APP
Use this parameter to enable or disable subsequent journal fields, if the application is used for statutory consolidation. Valid values are: 1 Enables the subsequent journal fields 0 Disables the subsequent fields The default value is 0. This parameter is used in Interface for Office - Journal.
(O)
JRN_MAXCOUNT
Use this parameter to specify the maximum number of journal entries returned from a query in the Journal Manager. This is useful if you have a large number of Journal Entries and want to protect a user from launching a long query. The default value is blank. This parameter is used in Interface for Office - Journal.
Type (O)
Key ID JRN_OPENING_CODE
Description Use this parameter to specify the member name for the Opening code. This member is part of the dimension name specified by JRN_ACCDETAIL_DIM. The member name must be set to use this feature. The default value is blank. This parameter is used in Interface for Office Journal.
(O)
JRN_POST_OVERWRITE Use this parameter to specify whether the system keeps the same Journal ID when saving journals that were previously set to Posted status, but changed to Unposted status. Valid values are: Y Preserves the Journal ID when the unposted journal is saved N Creates a new ID when the unposted journal is saved The default value is N. This parameter is used in Interface for Office Journal.
(O)
JRN_REOPEN
Use this parameter to define the default for reopening journals. Valid values are: N Does not allow reopening of journals Y Allows the reopening of journals The default value is N. This parameter is used in Interface for Office Journal.
(O)
JRN_REOPEN_PROPERT Use this parameter to specify the property name in the account Y dimension that is used to further filter the journals to reopen. A valid value is a property in the account type dimension. The default value is GROUP. If this parameter is not set, the GROUP property must exist in the account type dimension. Alternatively, to use a property other than GROUP, change the value of the ACCOUNT_PROPERTY column in the Journal Translation template. This value can be any property in the account type dimension, or *. For more details, see SAP Note 1384731.
(O)
JRN_REVSIGN_CODE
Use this parameter to specify the member name that is used to reverse the sign during posting and unposting. This member is part of the dimension name specified by JRN_ACCDETAIL_DIM. The member name must be set to use this feature. The default value is blank. This parameter is used in Interface for Office Journal.
Type (O)
Key ID JRN_VALIDATION_SP
Description Use this parameter to specify the SQL stored procedure name to be executed before posting or unposting data. This stored procedure performs custom validation on the entire RecordSet to be posted or unposted and returns go/no-go to the posting engine. The default value is blank. This parameter is used in Interface for Office Journal. Use this parameter to specify a report name to launch when submission validation for a data region is not 0. The template must be located in the folder<drive>\webfolders\<appset>\<application>\eExc el\Input Schedules\Wizard\. A sample validation template provided with ApShell is located in<drive>\webfolders\ApShell\Planning\Excel\Input Schedules\Wizard\Validate.xlt. The default value is blank. This parameter is used in Interface for Office Validate submission.
(O)
(R)
ORG_ACCOUNTLIST
Use this parameter to specify what account dimension members of the ownership application represent the legal consolidation method, and the ownership percentage for the subsidiary company in the dynamic hierarchy. The account dimension members must exist in the ownership type application. The METHOD member for the consolidation method must be defined in the parameter. If you define any member other than METHOD, the legal consolidation fails due to the consolidation business rule referring to a reserved word. For the ownership percentage, you can define one or one more account dimension members according to your business needs. At least one member must be defined for the ownership percentage. This parameter is required if the application is an ownership type, and if performing legal consolidation that refers to the ownership application. The default value is METHOD,POWN,PCON. You can enter account dimension members from the ownership type application separated by a comma (,) delimiter. This parameter is used in Admin - Dynamic Hierarchy Editor.
Type (R)
Key ID ORG_ACCOUNTOWN
Description Use this parameter to specify the relationship of the parent and subsidiary companies in the dynamic hierarchy. The default value is PGROUP. If the parameter is not defined, Dynamic Hierarchy Editor does not work. During processing of the legal consolidation business rule, the rule refers to the parameter value as well. If the parameter is not defined, the rule finds the account dimension member named GROUP or PGROUP during processing. This parameter is required for ownership type applications that are used to perform legal consolidations. You can enter account dimension members of ownership type application. This parameter is used in Admin - Dynamic Hierarchy Editor.
(R)
ORG_INTCO
Use this parameter to specify a member ID from the INTCO dimension in the Ownership application. The default value is I_NONE. This parameter is used in Admin - Dynamic Hierarchy Editor.
(R)
ORG_PARENTPROPERTY Use this parameter to specify the property name of the group dimension for dynamic hierarchy statutory applications when defining fixed hierarchies. The value must match the value in the ParentProperty for entities in the statutory applications that support ownership application. This parameter is required for ownership type applications that are used to perform legal consolidations. The default value is PARENT_GROUP. This parameter is used in Admin - Dynamic Hierarchy Editor, Business Rules.
(O)
SEC_CACHE_EXPIRE (i Use this parameter to set the expiration time, in hours, for the n Microsoft version only) secured profile cache. This specifies how long member access security profiles are cached. This limits the amount of memory required for the cache. If a user does not retrieve data during the specified time period, the cache memory is released on the application server. A valid value is a positive integer larger than 0. The default value is 24. If you change this parameter, you must reset IIS on the application server.
Type (O)
Key ID
Description
SEND_SGTABLE_COUNT Use this parameter to specify the count of (in Microsoft version the sgData[Application] table that is used by the data sending only) process. It is to be scalable for sending data, and it process sending data parallel as the number of the table. Use this parameter so that the system can split the sgData[Application] table when it sends large amounts of data. Valid values are positive integers larger than 0. The default value is 2. After you add or modify this parameter, modify the application in the Administration console.
(O)
SIGNED_DATA_FORMAT Use this parameter to specify the decimal precision and scale of the signeddata column of the tablestblFact, tblFac2 and tblFactWB in an application. The default value is 25,10 (25 for precision and 10 for scale). This parameter is used in Admin Add a new application, Modify application, and Copy an application.
(R)
Use this parameter to define how to handle the approval of work status. Valid values are: Yes Top down approval of work status. Work status is approved regardless of whether sub-work status is approved No Bottom up approval of work status. Work status can be approved only if all sub-work statuses are approved. The default value is No. When you change the value of this parameter, existing work status information is removed. This parameter is required if work status setting is enabled in the Administration console.
(O)
VALIDATE_MBR_LOGIC Use this parameter to specify that the system validates members when processing logic. The performance of processing logic decreases due to this validation. Valid values are: 1 The system filters records that would otherwise post to a parent member to a member that no longer exists or a member calculated dimension formula 0 The system bypasses this validation The default value is 0. This parameter is used in Script Logic posting data during running script logic.
Type (O)
Key ID
Description
WORKSTATUSVALIDATE Use this parameter to specify that the system checks the value of a (in Microsoft version cell for which a user tries to change the work status. If 0, it passes only) the validation; if not, it is rejected. Valid values are: Yes Necessary to check validate No Not necessary to check The default value is No.
(O)
YTDINPUT
Use this parameter to specify whether data is entered in year-to-date (YTD) format. Valid values are: Yes YTD format No Periodic format The default value is No. This parameter is used in Admin - Application process.
YTDINPUTTIMEHIR (in Use this parameter to specify the time dimension hierarchy that is used by a YTD storage application. Microsoft version only) The default value is H1.
YTD_NECJ_RETRIEVE
Use this parameter to specify the query type to improve the performance of data retrieval when retrieving YTD measures on Periodic applications or the opposite. This parameter is useful in the following circumstances: YTD / QTD measures data is retrieved on periodic application or Periodic / QTD measures data is retrieved on YTD application. The retrieval range is huge, but the portion of the data existing cells is small. ColKeyRange or RowKeyRange has more than two dimensions. The retrieval range has no members with a dimension formula. Valid values are: 1 To use the NonEmptyCrossJoin query 0 Not to use the NonEmptyCrossJoin query The default value is 0. This parameter is used in Retrieve data functions EVDRE, EVGET, EVGTS, EVSND, EVINP.
Activities
To update the value of a parameter, start the Administration interface, and from the action pane, select Set Application parameters. Modify the parameters, as desired, and then click Update.
To add a new parameter (you can add any 'optional' parameter if it does not already display), add a new row, enter the parameter name, then enter the desired value.
Prerequisites
You have Appset task security rights to view and change application set parameters.
Features
The following table describes the parameters you can set from the Administration Configuration action pane. The parameters that require a value include (R) in the Type column. Parameters that do not require a value include (O) in the Type column. If an application set parameter is required, you can leave it blank to accept the default, but if you delete the parameter, the system may not work correctly. If an application set parameter is optional, you can leave it blank or delete it. Type Key ID Description The maximum file size the system permits users to upload. A warning message appears if the file size exceeds the parameter value when you upload a file. The default value is 100 MB. This parameter is used in: Interface for the Web - when posting documents in Content library menu Interface for Office - sending data, journal posts, Data Manager imports, e-mail notification attachments Defines whether owners and managers receive an e-mail when there is a change to an assigned work status. Has the following possible values: Yes: Send e-mail No: Do not send e-mail In the Microsoft version of Planning and Consolidation, the following SMTP application set parameters must be set up as well to use e-mail notifications in the system: SMTPAUTH, SMTPPASSWORD, SMTPPORT, SMTPSERVER, and SMTPUSER. In the NetWeaver version of the system, the ABAP SMTP service is used for sending e-mails.
(O) for the ALLOW_FILE_SIZE Microsoft version (R) for the NetWeave r version
(O)
APPROVALSTATUSMAIL
Type (O)
Key ID APPROVALSTATUSMSG
Description Allows you to define a custom e-mail message that is sent to the owners and managers of a work status when a work status code is changed. The message is applicable to all applications in the application set. You can customize the message using the following variables: %USER% Name of user who changed this status %STA% Work status %OWNER% Entity owner (Microsoft version only) %TIME% Time of change %REGION% - Lock region (NetWeaver version only) For example: ENTITY: CG1, TIME: 2009.Q1, DATASRC: DC_1, PROJECT: PRJ_1, PRODUCT: PRO_1
EXAMPLE You can create a message such as, This is to inform you that %USER% has updated the work status for %REGION% on %TIME%. The text of the e-mail can be a maximum of 255 characters. There is no need for quotes or brackets around parameters. (R) AVAILABLEFLAG Controls whether the system is offline or not. Yes means the system is online and available for sending data to the database. You can take the system offline by changing the value to No. This parameter is used in Interface for Office - Send Data, Journal Posts, DM Imports The message that displays to users who try to access an application that is offline (AVAILABLEFLAG = No). The default value is Current Appset status is available EXAMPLE The message could be The system is temporarily unavailable due to scheduled maintenance. Try again later. This parameter is used in Interface for Office - Send Data, Journal-post, DM-Import. (R) AVAILABLEURL (In NetWeaver version only) (O) The URL of the warning page that displays when a user attempts to access an application that is offline.
(R)
AVAILABLEMSG
BPFSTEP_COMPLETE_MS Determines the content of the message that is displayed when a G Business Process Flow step is completed. (In Microsoft version only) The default message is: [%BPF_STEP_NAME%] step of [%BPF_NAME%] has been completed by %USER_NAME%. This parameter is used in Admin console - Manage Business Process Flows.
Type (O)
Key ID
Description
CLR_COMMENTS_HISTOR Deletes the comment history except for the last comment entered. Y Possible values for this parameter are: 0: This is the default value and saves the history of comments. 1: The historical comments are deleted and only the latest comments remain. COMMENT_MAX_LENGTH Customizes the length of comments. The default value is 256 and (In Microsoft version only) the maximum length is 4,000 characters. NOTE If you set a smaller value than current value, the newly entered value does not apply to comment length and the previous value still applies even though the setting is updated successfully in AppSet parameters page. Therefore, the new value should be larger than the previous value.
(O)
(O)
COMPANY_LOGO
Use this parameter to add your corporate logo to the default (In Microsoft version only) templates in the interface for Excel. Enter the file name for the logo image that you want to display. This image must be stored in the Application Set directory, which is "[Server Install]\Data\WebFolders\[Appset]". EXAMPLE C:\Program Files\SAP BusinessObjects\PC_MS\Data\WebFolders\[Appset] If the COMPANY_LOGO does not exist or the file name is invalid, the default globe image displays. Allows the bmp, gif, and jpg image file types.
(O)
DEFAULT_EXTENSIONS
The system allows the default file type even if you do not set this parameter. The default file extensions are hard-coded internally. The file extensions the system allows users to upload by default: .XLS, XLT, .DOC, .DOT, .PPT, .POT, .XML, .MHT, .MHTML, .HTM, .HTML, .XLSX, .XLSM, .XLSB, .ZIP, .PDF, .PPTX, .PPTM, .POTX, .POTM, .DOCX, .DOCM, .DOTX, .DOTM, .CDM, .TDM, .PNG, .GIF, .JPG, .CSS, .MRC. See ALLOWEXTENSIONS above. The user can change the value. This parameter is used in: Interface for the Web - When posting documents in the Content library menu Interface for Office - Send Data, Journal-post, DM-Import
Type (O)
Key ID DTSSTATUSCHECK
Description
Use this parameter to hide or show the Refresh Status (In Microsoft version only) Every checkbox in the Data Manager Status View. If the checkbox is enabled and large records exist, the performance when refreshing the status degrades. By hiding the checkbox, the refresh is performed whenever a user calls the refresh button manually. Possible values for this parameter are: 0: Hides the checkbox 1: Show the checkbox EVDRE_STYLES Use this parameter to specify a report or input template containing (In Microsoft version only) the default style sheet. If no style template is specified in the EVDRE builder in the Formatting section, then the default stylesheet is applied from the template specified in this parameter. This allows users to customize their formatting and save the customization as the default style template. They do not have to manually reapply the template for each new report. Users can overwrite the default formatting for a given report or input template by using existing formatting options. The priority of formatting for a new EVDRE report or input template is: If a template is supplied in the Allow Formatting section, it is used. Otherwise, the style template specified in the EVDRE_STYLES parameter is used. Otherwise, the default EVDRE colors are used. By default, this parameter is empty. Style templates that are used for EVDRE formatting can be stored in any folder in the file service. The full file service path must be specified in the parameter, starting with //root/ of the file service, so that one template can be used globally, regardless of the AppSet. Changes to the style template specified in this parameter do not affect reports and schedules previously created from this template. EXECUTECUSTOMQUERY Set to Y to query the database using predefined SQL statements (In Microsoft version only) stored in the tblCustomQuery table.
(O)
(O)
Type (R)
Key ID
Description
FILESFOLDERDELIMITE When you create Web-ready files in Excel, the system creates R subfolders based on the native Excel Save as HTML function. (In Microsoft version only) Since the naming rule of the subfolder is different for each Microsoft Office language, this parameter allows the system to find the subfolder having the defined delimiter when selecting Web-ready files in Interface for the Web. (Required) The default value is _:.:-. You must define a value for this parameter if the value is empty, or does not contain the required delimiter for your Microsoft Office version. Separate multiple delimiters with a colon; for example, :,:_. EXAMPLE For example, under a folder named 'Report.htm', the system creates the following subfolders: Chinese: report.file English: report_files French: report_fichiers German: report-Dateien Italian: report-file Japanese: report.files Korean: report.files The user can define this delimiter depending on their country. Use : to separate multiple values. This parameter is used in Interface for Office - book publishing.
(O)
JREPORTZOOM
This parameter allows you to set the default zoom magnification value on HTML journal reports. We recommend that you set the value to 75%. This parameter allows you to set up a web page as your home page for the Web interface. Once you set this, this page displays for all users of this application set. The page must first exist as a Web page in Interface for the Web. (See Creating a Web Page.) The default value is 1. or you can enter the number that represents the web page you want to make your home page.
(O)
LANDINGPAGEITEM
(O)
LIMITOFDIFFERENCE
The least value for which the system processes logic. If a data (In Microsoft version only) value is smaller than this value, they system does not process the logic. For example, when you set 0.001, smaller data values, such as 0.0009, are not processed by logic. The default value is .00000001, so if the parameter is not set, logic ignores less than 0.00000001. This parameter is used in Script Logic - Processing of script logic.
Type (O)
Description Controls the minimum level of ABAP messages to store in the log in terms of severity, which you view by the transaction SLG1. The default value for this parameter is Info. The possible values for this parameter are: Donothing Info Warning Error Fatal
(O)
LOGLEVEL
This parameter controls the severity level of messages to store in (In Microsoft version only) the log file. The default value for this parameter is Info. The possible values for this parameter are: None Info Warning Error Fatal LOPTZ_AVAILABLE This parameter takes the system offline during a minimal optimization of an application. The default value for this parameter is: 0. The possible values for this parameter are: 0 do not change to offline 1 change to offline This parameter is used in Admin - Lite optimize. The maximum number of columns to display in a live report in Interface for the Web. The value includes header and data columns. The default value is 30. EXAMPLE If you specify a value of 5, one heading column and four data columns are displayed.
(O)
(O)
MAXLRCOLUMNS
(O)
MAXLRROWS
The maximum number of rows to display in a live report in Interface for the Web. The default value is 50. and the value includes both header and data rows. EXAMPLE If you specify a value of 5, one heading row and four data rows are displayed.
Type (O)
Key ID MSNIMPASSWORD
Description The password that the system uses to operate Instant Message alerts in Insight. The default value is blank. This parameter is used in Insight - Alert. The user name that the system uses to operate Instant Message alerts in Insight. The default value is blank. This parameter is used in Insight Alert.
(O)
MSNIMUSER
(O)
MULTIBYTE_FORMULA
Use this parameter to support dimension formulas with member (In Microsoft version only) IDs that contain double-byte characters, such as those in Japanese, Chinese, Korean, and Russian. The value defines the dimension formula column type as Nvarchar or Varchar. The default value is blank. Possible values are: 1 Dimension formula column is nvarchar instead of varchar to support double-byte characters. N/A or blank or 0 - Dimension formula column is varchar. This parameter is used in Admin - Process dimension.
(O)
RETRIEVE_ON_OFFLINE Use this parameter to restrict data retrieval and export while an (In Microsoft version only) application set is unavailable (system offline). The options are: 0: Does not allow retrieving or exporting data while an application set is unavailable regardless ofOfflineAccess task security. 1 (default): Allows retrieving or exporting data while an application set is unavailable (system offline) if the user has OfflineAccess task security.
: The following tasks are exceptions to rule, and can be executed when the value is 0: Execute logic (script, business rules) from DM packages Run Export from fact table package Run Append into Fact Table package Add new comments Save data through DHE (Dynamic Hierarchy Editor) This parameter is used in all functions that retrieve or export data. For example: Refresh data in Interface for Office and Interface for the Web, Export DM package, Book Publish, and so on.
Type (O)
Key ID RUNPKGBYEXE
Description
Allows for the use of an .EXE file type wrapper for running a (In Microsoft version only) package out of process from COM+. The options are: 0: Run in process 1 (default): Run out of process SESSIONTIME Defines the session time (in minutes) for the Whos Online feature. The default value is 3000 minutes.
(O)
(R)
SMTPAUTH
The authentication method of the SMTP server. (In Microsoft version only) This setting does not change the method on the SMTP server, but must match the type of authentication enabled on it. Failure to set this appropriately can result in errors from the e-mail server. The default value is: 1. Possible values for this parameter are: 0 = Anonymous 1 = Basic 2 = NTLM This parameter is used in: Interface for the Web - When posting documents, Work status, Alert Interface for Office - Offline distributor SMTPPASSWORD The password for the user name defined as the SMTPUSER.
(O)
(In Microsoft version only) This parameter is Optional except when SMTPAUTH is 1 (basic), this parameter is Required The default value is blank. The user can input the SMTP password. This parameter is used in: Interface for the Web - When posting documents, Work status, Alert Interface for Office - Offline distributor (R) SMTPPORT Port number for your SMTP e-mail server. (In Microsoft version only) The default is port 25, the default SMTP server port number. The user can input the port number. This parameter is used in: Interface for the Web - When posting documents, Work status, Alert Interface for Office - Offline distributor
Type (R)
Key ID SMTPSERVER
Description
The name or TCP/IP address of the SMTP e-mail server the (In Microsoft version only) system uses to send e-mail. The default value is blank. The user can input the SMTP Server name or TCP/IP address. This parameter is used in: Interface for the Web - When posting documents, Work status, Alert Interface for Office - Offline distributor SMTPUSER The user name from which e-mail from the system originates. (In Microsoft version only) The default value is blank. The user can input the User name. This parameter is used in: Interface for the Web - When posting documents, Work status, Alert Interface for Office - Offline distributor TEMPLATEVERSION Current version number of the dynamic templates in your application set. Whenever you add to or change your input schedule or report dynamic templates, you should increment this version number so that users automatically receive the new templates when they log on to this application set. You can also reset the template version from the Admin Console. The default value is the current version number of the dynamic templates in your application set. The user can input the version, or it changes automatically. This parameter is used in Interface for Office - Logon, Save dynamic template. Defines the level of tracing to conduct. The default value is Error. The following levels are available: Donothing Debug Path Info Warning Error Defines the Planning and Consolidation user for which the system performs remote tracing, in the formDomainName\UserName. This parameter is blank by default, and is populated by an administrator only when conducting tracing activities for a specific client.
(R)
(R)
(O)
TRACELEVEL
(O)
TRACEUSER
Type (O)
Key ID UNLIMIT_PRINT_LOG
Description
Determines whether all posted records are written in the log file. (In Microsoft version only) The default value is NO. The available options are: YES all posted records are written to the log file NO all posted records are written to the log file unless there are more than 300,000 records If there are more than 300,000 records, no records are written but replaced with the message More than 300,000 records. Details are not being logged. This parameter is used in Script Logic.
(R)
UPLOADTEMP
Temporary folder used to store Content Library documents. The default value is: <drive>\FTPServer\OSoftFTP (where <drive> is Folder name that was created at installation.) The user can input the path and, if the system was installed in a different named folder, the Administrator must change this path according to the path. This parameter is used in Interface for the Web - Upload document in the Content Library menu.
(O)
USE_VARCHAR_FOR_DIM This parameter will be available in a future release. (In Microsoft version only) To set the SQL data type as Nvarchar or Varchar for the dimension tables, you must edit the App column in the tblDefaults table. The default for dimension tables is Nvarchar, which is typically used for double-byte character languages such as Korean, Japanese, Chinese, or Russian. You might want to change the setting to Varchar if you have space restriction issues in SQL and OLAP, or if you are not storing unicode data. In the tblDefaults table, you can enter a specific dimension name or leave the KeyID cell blank. If the KeyID is a specific dimension name, it is applied to only the specific dimension; if the KeyID is blank, all dimensions are applied in all dim tables. EXAMPLE This is tblDefaults table that manages all of system parameters. User Id _GLOBA L Type App Key ID Valu e 1
SYSTE M
USE_VARCHAR_FOR_DI ACCOUN M T
Activities
To update the value of a parameter, start the Administration interface, and from the action pane, select Set AppSet parameters. Modify the parameters, as desired, and then click Update.
To add a new parameter (you can add any 'optional' parameter if it is not already displayed), add a new row, enter the parameter name, then enter the desired value.
Format Ranges
You define format ranges that can point either to one cell or to an entire range of cells.
Features
For one cell, EVDRE applies the format of the defined cell to the entire data range. For a range of cells, EVDRE interprets the content of the cells in the defined range to derive the formatting instructions, then applies them to different areas in the report range. When you leave the FormatRange cell blank, EvDRE automatically derives the format of the data range from the format of the top left cell of the data range to be expanded. You can define one or multiple format values: Define one format value You can point to one cell for the data cell format, define the format range, then select eTools Expand All . Define multiple format values You can define multiple format values when you want to define formatting for different areas of report. You can specify multiple formatting instructions using multiple rows, each row representing one formatting instruction. The system executes the EvDRE function in sequence from the first (top row) to the last (bottom row) in the range. You can define which format should prevail over conflicting formats (for example, the Locked format overwrites the Calc format, which in turn overwrites the Default format). You can overlay different formatting properties on the same cell. You can also define a different format for different ranges of the sheet. NOTE FormatRange supports empty members in both Row and Column MemberSet definitions to allow for more versatile formatting. Scaling EvDRE Data You can scale EvDRE data to the thousands using standard Excel options. From an EvDRE workbook, right click on the cell you want to scale. Select Format Cells Number Custom . Select #,##0.00,_);[Red](#,##0.00,), then choose OK. For example, if you enter 1000 in a cell with this formatting applied, Excel shows 1.00.
Activities
To define multiple formats, set up a table in EvDRE with six columns. Each column represents a separate parameter of a formatting instruction. See Multiple Format Ranges.
Data Modeling
You can use this function to input your numbers when creating an input schedule.
Features
You can use the following modeling options:
Spread The Spread modeling option allows you to take a value and allocate it among selected destination cells. The value can be allocated equally, or it can be weighted by a range of values. For example, you can take the value 100,000 and spread it across a number of columns that represent each month of the year. See Spread Modeling. Trend The Trend modeling option takes a value or percentage and grows it by a factor among selected cells. This option places the source value in the first cell of the destination range. Each subsequent cell in the destination increases by the amount or percentage specified. See Trend Modeling. Weight The Weighted modeling option lets you allocate a set of values by weighted factors in your spreadsheet. It allows you to take a set of values, grow them if desired, and then allocate the new amount based on the relative weights of the selected cells. The destination range is the same as the weight range. For example, you can weigh 12 months of revenue based on 12 months of cost of sales. See Weighted Modeling.
Spread Modeling
This function allows you to take a value and allocate it among selected destination cells.
Features
You use the following features for spread modeling: Feature Source Value Destination Weights (optional feature) Add to Existing Values (optional feature) Description The total value to be spread. The cells to which the system writes the results of the spread. A range containing weight values to apply to the spread. This range contains the same number of cells as the destination range. Select this checkbox to take the spread amount to each cell and add it to any existing values already in the destination range. If you leave it blank, the amount spread to each cell overwrites the amounts in the destination cells.
Activities
To spread an amount, open the input schedule and select Spread from the action pane.
Trend Modeling
This function allows you to take a value and grow it by a factor among selected cells.
Features
You can use the following features for trend modeling: Screen Element Source Value Description
Description
By Percentage A specified percentage of the previous value (previous cell) in the destination range. To create an increasing trend, use a positive percentage. To create a declining trend, use a negative percentage. By Value A specified amount over the previous value (previous cell) in the destination range. To create an increasing trend, enter a positive value. To create a declining trend, enter a negative value.
Add to Existing Select this checkbox to take the spread amount to each cell and add it to any existing Values values already in the destination range. If you leave it blank, the amount spread to each cell overwrites the amounts in the destination cells.
Activities
To use trend modeling, open the input schedule and select Trend from the action pane.
Weighted Modeling
You use this function to take an amount, grow it, and then allocate the new amount based on the relative weights of the selected cells.
Features
You use the following features for weighted modeling. Sum to Allocate The initial sum from which the allocation begins. This amount defaults to the sum of the selected cells. Weighted Destination A range of cells that contain relative weights, to which the results of the allocation are written. By Percentage Increase of the overall sum to allocate by the specified percentage before allocating. By Value Increase of the overall sum to allocate by the specified value before allocating.
Activities
To allocate an amount by a weighted factor, open the input schedule and choose Weight from the action pane.
Data Submission
You use this process to submit data to a central database.
Features
When submitting data, you can do the following: Send active worksheet or workbook. Sends all changed records on the active worksheet or workbook, respectively.
NOTE Planning and Consolidation places a limit on the number of digits it can send. Currently, the number of digits that Planning and Consolidation supports when sending data is from 9999999999999.9999999 (smallest: 13 digits on the left of decimal and 7 digits to the right of the decimal) to 99999999999999.9999999 (largest: 14 digits to the left of the decimal and 7 digits to the left of the decimal). A number smaller or larger, respectively, than the valid range is either rejected or regarded as invalid in the system. Submit supporting documents. This option opens the Content Library where you can post a file with or without application context. See Content Library. Set work status. See Work Status.
NOTE If the work status or data submission validation is enabled by your administrator, the system checks to make sure there are no work status locks or validity issues, respectively, on the data region. A validity check includes making sure that the members are valid, the periodicity is correct, and the member type is correct (for example, the member is not a calculated member). A concurrency check, which prevents data from being sent concurrently to the same region, is always performed by the system for data submissions.
Activities
From an input schedule, select Send Data from the Schedule Options action pane.
Member Lookup
You use this function to select specific members to use in reports, input schedules, journals, member security definitions, and data management packages. In addition, from Interface for Excel, you can use it to copy and paste member lists into spreadsheets.
Features
You can use the following features when using Member Lookup, some of which are available only when performing certain tasks within the system: Feature Select members Description You can select members at any time to display in your report or input schedule. You can select only the dimensions and members to which you have access. To select a member, do one of the following: Highlight that member and click OK. Right-click the member and choose an option: Select sibling members of the current member Select all children of the current member Unselect sibling members of the current member Unselect all children of the current member Populate all children of the current member If a section is disabled, all members in the dimension are selected, and all members are returned to the report or input schedule upon clicking OK. You can select the checkbox next to one or more members to copy them to the active spreadsheet.
Feature
Description
Filter members You can filter the member list based on member properties as well as hierarchy. You select a property, an operator, and a value, then click Refresh to apply your changes to the current list. You can specify a filter on one or more properties. If you define a filter, the members can only be displayed in Table data view (not hierarchical). When filtering by properties, the following options are available: = Equal < > Not equal LIKE A pattern match that supports using an asterisk ( * ) before or after the value BT A range between a low and high value If you set selections with the same property, the logic operator between each selection is OR. If you set selections with different properties, the logic operator between each selection is AND. For example, when you set the following selections: Attr1 = 1 Attr1 bt 3 to 7 Attr2 <> 10 The filter is ((Attr1 = 1 or (Attr1 >=3 and Attr1 <=7)) and Attr2 <> 10). The logic operator for hierarchy selections is OR. For example: 2006.JAN SELF 2005.TOTAL BAS The filter is (SELF(2006.JAN) or BAS(2005.TOTAL)). The logic operator between Hierarchy selections and Attribute selections is AND. For example: Attr1 = 1 Attr1 bt 3 to 7 Attr2 <> 10 2006.JAN SELF y2005.TOTAL BAS The filter is ((Attr1 = 1 or (Attr1 >=3 and Attr1 <=7)) and Attr2 <> 10) or (SELF(2006.JAN) or BAS(2005.TOTAL)). You can filter by hierarchy in Data Manager. The following information applies: You can use the following filter options: SELF the value itself DEP direct children of the value BAS all the base members of the values children ALL all the children of the value You can save and modify filters using Maintain Filter. You can use the saved filters when selecting members for Data Manager packages. You can choose whether to return the members or filter to Data Manager by choosing Return By.
Description You can view the property values and attributes of a selected member. Members that are available for use when creating and modifying reports or input schedules are enabled. Properties that are for information purposes only are disabled. You can view a member's properties by opening the Member Lookup, then doing one of the following: Right-click the desired member, then select Member properties. Click the Show selected member properties link. After reviewing the list, click OK to close the Properties dialog box.
You can set options that control behavior on the Member Lookup dialog box. Set Member Lookup options To access the Member Lookup Options dialog box, open the Member Lookup, then select the Options button. In the Double-click Options section, select the checkbox if you want to select the member and return to the worksheet by double-clicking a member. This option closes the Member Lookup and returns to the active report or input schedule. If unselected, a double-click expands or collapses the member when double-clicked. This option keeps the Member Lookup open. The Select All Children Behavior section determines how members are selected when you use the Copy option to copy one or more members and paste them into your spreadsheet. See Copy and Paste Member Lists, below. Do one of the following: Select Select direct children only to only copy the members directly below the selected member. Select Select all descendents to copy all descendents of the selected member. Copy and Paste Member Lists You can copy members from Member Lookup and paste them into a spreadsheet. You can use this feature to create journal entries, reports, or input schedules. You can copy and paste a member list by doing the following: 1. Open the report, input schedule, or journal template from the Excel interface. Open Member Lookup for the applicable dimension. 2. Select a member or choose Select sibling members for the selected member. 3. Select the rows and columns in which to place the members. Choose the Copy Members button, then in the Copy Members dialog box, select in rows to place the members in the rows, or select in columns to place the members on the columns. 4. Select the first cell in which you want to place the members. Select Edit Paste to paste the members.
Description You can select members from Dynamic Hierarchy if Dynamic Hierarchy is available. The Dynamic Hierarchy option is available only for the entity type and group type dimensions, or the currency type dimension if the group Members are included in the currency type dimension, in a consolidation application, and a dynamic hierarchy is built and stored in the ownership application. You can select only the dimensions and members to which you have access. With the Dynamic Hierarchy option, the Entity and Group (or Currency) dimension hierarchies are dynamically displayed according to the consolidation hierarchy that was built for the time and category member selected in the current view. To select a member from Dynamic Hierarchy, do one of the following: Select a group member from the dynamic hierarchy if the group (or currency) dimension member selector is open, or select an entity member from the dynamic hierarchy if the entity dimension member selector is launched. Highlight that member and click OK. Right-click the member and choose an option: Select sibling members of the current member Select all children of the current member Unselect sibling members of the current member Unselect all children of the current member Populate all children of the current member If a section is disabled, all members in the dimension are selected, and all members are returned to the report or input schedule upon clicking OK. If a dimension does not have a dynamic hierarchy, the dynamic hierarchy option is unavailable. You can select the checkbox next to one or more members to copy them to the active spreadsheet. The Dynamic Hierarchy option is available only in the Excel client, specifically in the action pane, EVDRE report, EVCVW function, and in the embedded Excel object in the Office client. Its availability also depends on ownership transaction data.
Activities
To access the Member Lookup, do one of the following: Choose a dimension member from the Session Information section of the action pane, select the down arrow next to a dimension, then select more. From the eTools menu, select Select Members, then select the dimension whose members you want to view. Right-click any cell in a workbook and select Select Members, then select the dimension whose members you want to view. Run Data Manager packages for which you need to select members. When selecting members, be aware that using the operator Between functions as expected for all types of dimensions except for Time. Between is a string comparison, and therefore does not take into account the concept of time. For example, if you want to select all members under 2005.TOTAL and 2006.TOTAL, setting up ID BT 2005.TOTAL to 2006.TOTAL would be incorrect because the string 2005.Q1 does not fall between 2005.TOTALand 2006.TOTAL. 2005.Q1 would not be selected.
More Information
Reports and Input Schedules Data Management for the NetWeaver platform or Data Management for the Microsoft platform
Journals
Data Management
The Data Manager is a Planning and Consolidation module that helps you move data into the Planning and Consolidation system, copy and move data within and across applications, and export data from an application by means of packages. Data Manager packages are based on process chains, which are sequences of processes that are scheduled to wait in the background for an event. Some of these processes trigger a separate event that can, in turn, start other processes.
Features
Data Transfer from an Application to the File Service The Data Manager allows you to transfer data files to and from the file service. You can also use the data preview feature to preview data files stored on the file service. This allows you to see the format of your data when deciding how to set up a transformation (see Previewing Data Files). Run and View the Status of Packages and Package Links The Data Manager allows you to schedule, run, and view the runtime status of any package and package link (see Running a Package and Viewing the Status of a Package. View Schedule Status of Packages and Package Links The Data Manager allows you to view the scheduling status of any package and package link (see Running a Package Link and Viewing the Status of a Package Link). Manage and Maintain Transformations and Conversions for Data Management Tasks This includes the management, maintenance, and validation of conversion and transformation files (see Data Conversion Maintenance and Data Transformation Maintenance). Manage Packages Package organization in the Data Manager involves adding, modifying, moving, copying, and removing packages and package groups. This also includes assigning them to be available to specific teams of users. You can use the dynamic script editor to set up scripts to create a user interface for package prompts, for example, to preassign parameters to automate the running of packages. You can modify existing prompts and create new ones. Packages and process chains that execute data management tasks are categorized as follows: Data management tasks Export data Import master data from an SAP NetWeaver Business Warehouse InfoObject Write mode examples Import compound SAP NetWeaver Business Warehouse InfoObjects Import hierarchies from an SAP NetWeaver Business Warehouse InfoObject Clear data Copy data Move data Import transaction data from a flat file Import master data from a data file Import master data descriptions from a flat file Import transaction data from an SAP NetWeaver Business Warehouse InfoProvider Retracting master data and transaction data via a BAdI Import and send e-mail package
Import using FTP Financial processes Run allocations Calculate ownership Currency restatement Intercompany reconciliations Intercompany bookings Intercompany eliminations Legal consolidation Opening balance calculation Account transformations Validations System administration tasks Application optimization Dimension member processing Validate logic Run activity archiving Run data archiving Starting the Data Manager The Data Manager is integrated within the Excel interface. To start the Data Manager, choose the Planning and Consolidation icon on your desktop, then choose Interface for Excel Manage Data .
Procedure
1. 2. 3. 4. Choose eData Data Preview . Select a site. Select a directory and a data file, and choose OK. Select a different file and choose Open to preview another file. Choose Cancel when you have finished previewing the data.
Running a Package
Prerequisites
The package has been defined (see Package Usage).
Procedure
1. In the Manage Data Options action pane, choose Run a package. 2. In the Run Package dialog box, perform the following steps: 1. Select a team (optional). 2. Select a folder from among the Package Group folders. NOTE
Administrators see the package group selection screen. Non-administrative users see the list of packages. 3. Click Run. 4. Enter data as required. The information you must enter depends on the definition of the package. NOTE After the package is executed or scheduled, you can check its status. If you are using the Microsoft version of Planning and Consoldiation, see Viewing the Status of a Package. If you are using the NetWeaver version, see Viewing the Status of a Package.
Package Usage
Access to packages in the Data Manager is controlled by the task security that an administrator sets.
Features
You can perform the following tasks with packages: Run or schedule packages (see Running a Package) View schedule package status (see Viewing the Status of a Package Schedule) View package status (see Viewing the Status of a Package) Maintain packages (see Package Maintenance (Organization)) Assign packages to teams (see Assigning Packages to Teams) Test packages (see Testing Packages) Use logic in your packages (see Logic Usage in Packages)
More Information
Standard Packages
Prerequisites
A package is scheduled.
Procedure
Choose eData Packages Schedule Status .
More Information
Running a Package
Prerequisites
A package is scheduled.
Procedure
Choose eData Packages Schedule Status .
More Information
Running a Package You can maintain the packages that are available in the Data Manager. You can perform the following package organization tasks: Add or edit packages. See Adding and Modifying Packages. Move or copy packages. See Moving or Copying Packages. Remove packages. See Removing Packages.
Prerequisites
You have created a package using SQL Server Business Intelligence Development Studio, and you have appropriate task security to add or modify packages. See the Planning and Consolidation Security Guide for more information.
Procedure
To add a package to Data Manager: 1. Choose eData Organize Package List 2. Select a team and package group and click Add Package. 3. Enter data as required. See Package Properties. 4. Save your changes. To modify a package: 1. From the application server, start Microsoft SQL Server Business Intelligence Developer Studio. 2. In the context menu of the Microsoft SSIS folder, click Open Package.
3. In the target application set and application, choose \\DataManager\PackageFiles\Examples\. 4. Select a sample package. 5. In the Select Package dialog box, select the package you want to modify and click OK. 6. Open the task to modify and view its properties. See Custom Tasks.
Package Properties
The following table describes the fields you must complete when adding or editing packages. If any of these fields are incorrect or left blank, the package generates an error when the package is executed. Field Package type File Description FILE or SQL
If the FILE package type is selected, a file text box is displayed so that you can specify the file that contains the package. NOTE You can find example packages in the Examples folder. See Adding Sample Packages to the Data Manager. Choose eData Data Upload to upload package files to the MyFiles or Examplespackage group. See Transferring Files Using OSoftTaskFtp2008. NOTE The System Files group is read-only and contains packages that are maintained by SAP. You cannot upload files to this group.
The name of the package. If the file contains packages, you can view a list of available packages (when you select the file package type). The folder group to which the package is added. You can define a new group here.
Task Type
You can control who has access to run the package. If you select Admin Package, only users who are Planning and Consolidation Administrators can run an administrative package. The package can still be saved to a team that contains non-administrative users. A non-administrative user can see the package, but cannot execute it. If you select User Package, users who have been assigned the Execute Data Management task security privilege can execute the task.
4.
Package Properties
5. 6. The following table describes the fields you must complete when adding or editing packages. If any of these fields are incorrect or left blank, the package generates an error when the package is executed. Field Package type File Description FILE or SQL
If the FILE package type is selected, a file text box is displayed so that you can specify the file that contains the package. NOTE You can find example packages in the Examples folder. See Adding Sample Packages to the Data Manager. Choose eData Data Upload to upload package files to the MyFiles or Examplespackage group. See Transferring Files Using OSoftTaskFtp2008. NOTE The System Files group is read-only and contains packages that are maintained by SAP. You cannot upload files to this group.
The name of the package. If the file contains packages, you can view a list of available packages (when you select the file package type). The folder group to which the package is added. You can define a new group here.
Description A description of the package. Task Type You can control who has access to run the package. If you select Admin Package, only users who are Planning and Consolidation Administrators can run an administrative package. The package can still be saved to a team that contains non-administrative users. A non-administrative user can see the package, but cannot execute it. If you select User Package, users who have been assigned the Execute Data Management task security privilege can execute the task.
Transferring Files
Prerequisites
The FTP task (OSoftTaskFtp2008.dll) is registered with Microsoft SSIS. See Registering Custom Tasks.
Procedure
1. Open a package or create a new package in Microsoft SSIS on the Planning and Consolidation server. 2. Select the task and add it to the package. See Adding and Modifying Packages. 3. Open the task and enter the application set, application, and the user ID. NOTE The user ID must have Planning and Consolidation administrator privileges to validate logic files. 4. Type the FTP site (tcp/ip address or url of the computer), user name and password to access the FTP site, and the port number (the default is port 21, which is the FTP protocol default). 5. Enter the number of times the task should retry to connect to the FTP site. 6. Enter a destination directory. 7. On the Files tab, select one or more files to transfer. Choose move to destination and select the files to be downloaded. NOTE You can select from a list of files in a directory. Alternately, choose move all to destination to select all displayed files for download. 8. Click OK. NOTE You can use TASK commands in the EvDTSModifyPkg task to automatically complete the information for you.
Procedure
To register multiple tasks
1. Copy the required <task>.dll files from <BPC_home>/BPC/Websrvr/Bin to the Microsoft SQL Server Business Intelligence Developer Studio tasks folder (/Program Files/Microsoft SQL Server/100/DTS/Tasks) RECOMMENDATION You must copy the files on the server where you intend to edit the SSIS packages using Visual Studio. In a multiserver environment, we recommend that this is on the application server tier not the database server tier. The files to copy are some or all of the following:
OSoftTaskAdmin2008.dll OSoftTaskAvailable2008.dll OSoftTaskComment2008.dll OSoftTaskConvert2008.dll OSoftTaskDumpLoad2008.dll OSoftTaskFtp2008.dll OSoftTaskLogic2008.dll OSoftTaskMakeDim2008.dll OSoftTaskOwnership2008.dll OSoftTaskSendMail2008.dll OSoftTaskTrigger2008.dll
2. From the server where you want to edit the SSIS packages, choose Start Programs Microsoft SQL server 2008 SQL Server Business Intelligence Development Studio 3. Choose File New Project 4. Select Business Intelligence Projects 5. Select Integration Services Project 6. Enter the package name, for example, test1 and click OK 7. In SSIS, click Toolbox on the Tool bar to open the Toolbox view 8. Right click the Toolbox label and select Choose Item 9. In the Choose Toolbox Items view, select the SSIS Control Flow Items tab and then select all the tasks that you copied in step 1 10. Click OK This registers the custom tasks and makes them visible in the toolbox. By default, the custom tasks are added to the Control Flow Items tab. To make a new tab for the custom tasks, do the following: Right click the Toolbox label and select Add Tab Enter a suitable title Move all the custom tasks to the new tab using drag and drop
Custom Tasks
Planning and Consolidation provides custom Microsoft SSIS tasks that allow you to manage your data and perform unattended administration tasks. You can also create your own custom tasks for use in Planning and Consolidation.
Prerequisites
Before you can use a custom task in Data Manager, take the following steps: Register the task. See Registering Custom Tasks.
Features
The following table describes the custom tasks that are provided in Planning and Consolidation: Task DumpLoad More Information This task has a number of data dump and data retrieval functions. See DumpLoad Task Usage. This task enables you to run one of a number of eAdmin tasks through Microsoft SSIS. See Admin Task Usage. Send Mail This task sends an e-mail message before or after another task has processed. See Send Mail Task Usage. This task allows you to wait for a trigger condition before processing the next task. See Trigger Task Usage. This task allows you to control whether the system is set to available (online) or not available (not online) status. See System Available Task Usage. This task allows you to transfer data files from an FTP site to the Planning and Consolidation server. See FTP Task Usage. This task is a Microsoft SSIS version of the Planning and Consolidation Logic module that can be used from within the Data Manager module. This allows you to use the full power of the logic module in a batch setting. See Logic Task Usage. This task takes an input data and transformation file (which may or may not use conversion files) to create an output file. For example, an input file could be a file exported from a similar product. You can use transformation and conversion files to convert to the Planning and Consolidation format. This task creates dimension members using a Microsoft SQL Server table and schedules the processing of dimension members. For example, if a new member ID is added, this process updates the fac2table with the updated list.
Admin
Trigger
System Available
FTP
Logic
Convert
Make Dimension
More Information
MODIFYSCRIPT Package Variable (DumpLoad)
More Information
DATATRANSFERMODE Property DumpLoad Task Usage
DATATRANSFERMODE Property
When using the Dumpload task (for example, TASK(DumpLoad, DATATRANSFERMODE, 4)), there are special property values for DATATRANSFERMODE. These values are shown in the following table: Property Value 0 Description More Information
Property Value 1
Description
More Information
Import into SQL This value is best for importing large data. You can check the work status setting on the data before importing. See Checking Work Status below. Export from SQL
Exporting from Microsoft SQL Server Exporting from a Cube Importing into a Cube
Import into Cube (Fac2) This value is best for importing small to medium data Clear data from SQL You can check the work status setting on the data before clearing. See Checking Work Status below. Import into Cube (WB) Import Into Cube Append Appends the value in the cube without clearing the existing data Export journal data
6 9
10
11
12
Checking Work Status When you use the 1 (Import into SQL) and 5 (Clear Data from SQL) property values, you can have the
system check the work status settings of the data being cleared from the database. Use the following rule in the MODIFYSCRIPT package variable for DumpLoad: TASK (Task Name, CHECKLCK, 1)
Process Mode
Property Value 1 Description
Full Process. This rebuilds the entire application. Select this option if the application structure has changed. Refresh. Clears data from the application and repopulates it with existing data
Property Value 4
Description
Fac2 Process. This option processes the short-term data storage (the FAC2 table). The Data Manager imports data to the short-term data storage by default, so there may be no need to process the entire application.
More Information
DumpLoad Task Usage MODIFYSCRIPT Package Variable (DumpLoad)
Prerequisites
You have advanced knowledge of Microsoft SSIS. The Admin task (OSoftTaskAdmin2008.dll) is registered with Microsoft SSIS. See Registering Custom Tasks.
Procedure
1. Open a package or create a new package in Microsoft SSIS on the Planning and Consolidation server. See Adding and Modifying Packages. 2. Select the task and add it to the package. 3. Open the task and choose Process application. 4. Enter the application set, application, and the user ID. NOTE The user ID must have Planning and Consolidation administrator privileges to validate logic files. 5. Select an application. 6. Select Incremental or Full. 7. Click OK. NOTE You can use TASK commands in the MODIFYSCRIPT Package Variable task to automatically complete the information for you.
More Information
Accessing Microsoft SSIS
1. Open the Microsoft SQL Server Business Intelligence Development Studio on the Planning and Consolidation server. 2. Start a new project and select Integration Services Project. Open the Microsoft SQL Server group and server. 3. Select the Microsoft SSIS folder. 4. Open or create a package and add Planning and Consolidation tasks to the package.
Procedure
1. Open a package or create a new package in Microsoft SSIS on the Planning and Consolidation server. 2. Select the task and add it to the package. See Adding or Modifying Packages. 3. Open the task and choose Data Management Import into SQL . 4. Fill in the application set, application, and the user ID. NOTE The user ID must have Planning and Consolidation administrator privileges to validate logic files. 5. Enter the path and name of an import file. NOTE By default, the import process appends the data in the import file to the data already in the database. To change this behavior, select Clear existing data and select the dimensions to clear. 6. Select the Process Cube option, then select one of the following options: The Full Process option rebuilds the entire application (cube). Select this option if the application structure is changed. The FAC2 option processes just short-term data storage (the FAC2 table). The Data Manager imports data to the short-term data storage by default, so there may be no need to process the entire application. The Refresh Data option clears data from the application and repopulates it with existing data. 7. Click OK. NOTE You can use TASK commands in the MODIFYSCRIPT Package Variable task to automatically complete the information for you.
Prerequisites
The DumpLoad task (OSoftTaskDumpLoad2008.dll) is registered with Microsoft SSIS. See Registering Custom Tasks.
Procedure
1. Open a package or create a new package in Microsoft SSIS on the Planning and Consolidation server. See Adding or Modifying Packages. 2. Select the task and add it to the package. 3. Open the task and choose Data Management Export from SQL . 4. Fill in the application set, application, and the user ID. NOTE The user ID must have Planning and Consolidation administrator privileges to validate logic files. Enter the path and name of an export file. Select Export time in timeID if you want the time members to use the TIMEID rather than time member names. Select a time measure from the Measure list. You can enter a selection file that contains either of the following methods for specifying members: A list of dimensions and members to export An SQL statement that returns the member list needed for export Click OK.
5. 6. 7. 8.
9.
NOTE You can use TASK commands in the MODIFYSCRIPT Package Variable task to automatically complete the information for you.
Prerequisites
The DumpLoad task (OSoftTaskDumpLoad2008.dll) is registered with Microsoft SSIS. See Registering Custom Tasks.
Procedure
1. Open a package or create a new package in Microsoft SSIS on the Planning and Consolidation server. 2. Select the task and add it to the package. See Adding and Modifying Packages. 3. Open the task and choose Data Management Export from Cube . NOTE The user ID must have Planning and Consolidation administrator privileges to validate logic files. See Validating Logic. Enter the application set, application, and the user ID. Enter the path and name of an export file. Select Export time in timeID if you want the time members to use the TIMEID rather than time member names. Select a time measure from the Measure list. You can enter a selection file that contains either of the following methods for specifying members: A list of dimensions and members to export An SQL statement that returns the member list needed for export
4. 5. 6. 7. 8.
9. Click OK. NOTE You can use TASK commands in the MODIFYSCRIPT Package Variable task to automatically complete the information for you.
Validating Logic
In the Admin package, you can validate logic using the Validate logic option.
Prerequisites
You have advanced knowledge of Microsoft SSIS. The Admin task (OSoftTaskAdmin2008.dll) is registered with Microsoft SSIS. See Registering Custom Tasks.
Procedure
1. Open a package or create a new package in Microsoft SSIS on the Planning and Consolidation server. 2. Select the task and add it to the package. See Adding and Modifying Packages. 3. Open the task and choose Validate logic. 4. Fill in the application set, application, and the user ID. NOTE The user ID must have Planning and Consolidation administrator privileges to validate logic files. 5. Select the logic file (*.lgf) to be validated. 6. Click OK. NOTE You can use TASK commands in the MODIFYSCRIPT Package Variable task to automatically complete the information for you.
Prerequisites
The DumpLoad task (OSoftTaskDumpLoad2008.dll) is registered with Microsoft SSIS. See Registering Custom Tasks.
Procedure
1. Open the package that you want to modify, or create a new package in Microsoft SSIS. 2. Select the DumpLoad task and add it to the package.
3. Open the task and choose or Import into Cube Append 4. Enter data as required.
Data Management .
NOTE The user ID must have Planning and Consolidation administrator privileges to validate logic files. 5. Select the Process Cube option, then select one of the following options: The Full Process option rebuilds the entire application (cube). Select this option if the application structure is changed. The FAC2 option processes just short-term data storage (the FAC2 table). The Data Manager imports data to the short-term data storage by default, so there may be no need to process the entire application. The Refresh Data option clears data from the application and repopulates it with existing data. 6. Select Run default logic if you want the logic contained in default.lgc to be run after importing the data. 7. Click OK. NOTE You can use TASK commands in the MODIFYSCRIPT Package Variable task to automatically complete the information for you.
Prerequisites
The DumpLoad task (OSoftTaskDumpLoad2008.dll) is registered with Microsoft SSIS. See Registering Custom Tasks.
Procedure
1. Open a package or create a new package in Microsoft SSIS on the Planning and Consolidation server. 2. Select the task and add it to the package. See Adding and Modifying Packages. 3. Open the task and choose Data Management Clear data from SQL . 4. Fill in the application set, application, and the user ID. NOTE The user ID must have Planning and Consolidation administrator privileges to validate logic files. For more information about validating logic, see Logic Task Usage. 5. To limit the clear action to a subset of members, enter a member selection. 6. Select Process Cube, then select one of the following options: The Full Process option rebuilds the entire application (cube). Select this option if the application structure is changed. The FAC2 option processes just short-term data storage (the FAC2 table). The Data Manager imports data to the short-term data storage by default, so there may be no need to process the entire application.
The Refresh Data option clears data from the application and repopulates it with existing data. 7. Click OK. NOTE You can use TASK commands in the MODIFYSCRIPT Package Variable task to automatically complete the information for you.
NOTE You can use MODIFYSCRIPT Package Variable tasks to manipulate the values of the Logic task. Alternatively, EvDTSModifyPkg tasks are given in the description of the Logic interface, below. For more information about MODIFYSCRIPT, see MODIFYSCRIPT Package Variable Task Usage.
Prerequisites
The DumpLoad task (OSoftTaskDumpLoad2008.dll) is registered with Microsoft SSIS. See Registering Custom Tasks.
Procedure
1. Open a package or create a new package in Microsoft SSIS on the Planning and Consolidation server. 2. Select the task and add it to the package. See Adding and Modifying Packages. 3. Open the task and choose Journal Management Export . 4. Enter the application set, application, and the user ID. NOTE
The user ID must have Planning and Consolidation administrator privilegesto validate logic files. For more information about validating logic, see Validating Logic. 5. Enter the path and name of the file to which the journal data is to be exported. 6. Click OK. NOTE You can use TASK commands in the MODIFYSCRIPT Package Variable task to automatically complete the information for you.
Prerequisites
The DumpLoad task (OSoftTaskDumpLoad2008.dll) is registered with Microsoft SSIS. See Registering Custom Tasks.
Procedure
1. Open a package or create a new package in Microsoft SSIS on the Planning and Consolidation server. See Adding and Modifying Packages. 2. Select the task and add it to the package. 3. Open the task and choose Data Management Import into SQL . 4. Fill in the application set, application, and the user ID. NOTE The user ID must have Planning and Consolidation administrator privileges to validate logic files. 5. Enter the path and name of the file that contains the target journal data. 6. Click OK. NOTE You can use TASK commands in the MODIFYSCRIPT Package Variable task to automatically complete the information for you.
Prerequisites
The DumpLoad task (OSoftTaskDumpLoad2008.dll) is registered with Microsoft SSIS. See Registering Custom Tasks.
Procedure
1. Open a package or create a new package in Microsoft SSIS on the Planning and Consolidation server. 2. Select the task and add it to the package. See Adding and Modifying Packages. 3. Open the task and choose Journal Management Clear . 4. Fill in the application set, application, and the user ID. NOTE
The user ID must have Planning and Consolidation administrator privileges to validate logic files. 5. Take one of the following actions: Enter the list of members to clear. Browse to a file that contains a list of members to clear. 6. Click OK. NOTE You can use TASK commands in the MODIFYSCRIPT Package Variable task to automatically complete the information for you.
The System Available task allows you to control whether the system is set to available (online) or not available (not online) status. You can set the system to a not available status, then run some tasks, and set it back to an available status using this task. You can add this task to your package by registering OSoftTaskAvailable2008.dll located in the BPC\websrvr\bin folder, with the Microsoft SSIS interface. See Registering Custom Tasks.
Removing Packages
You can remove packages if you no longer want them available to be run through the Data Manager.
Procedure
1. Choose eData Organize Package List . 2. Select a package and click Remove Package. 3. Save your changes.
Procedure
1. 2. 3. 4. Choose eData Manage Team User Package Access Select a team. Select the packages to assign to the team. Save your changes. .
Testing Packages
We recommend that you test all packages before making them available to users. Use the Debug script in the Dynamic Script Editor to verify the properties and values of packages.
Using the debug command you can check to see that all properties are assigned the correct values. The debug command has the following syntax: Debug(value) The following table describes the value parameters: Parameter Description ON APPEND Enables the debug feature. Enables the debug feature and specifies that debug messages are appended to the package log file.
The package log file can be shown in the Detail log window, which you can open from the View Status window. After you successfully run the debug script, you must comment out or remove the debug script command in the Dynamic Script Editor before running a Planning and Consolidation application. Use the following syntax to comment out the debug script: Debug(value) NOTE If you do not comment out or remove the debug script command, the package log file lists the properties of a package along with their current values.
Procedure
Simulating the Package Script (debug script)
1. In Excel, from the Data Manager menu, choose Organize Package List.. 2. Open Dynamic Script Editor by choosing Move Organize Package List . Select a package and choose Modify Package. Next to the Package File path, choose View Package. 3. Choose the Advanced button. 4. Set the debug script command in the Dynamic Script Editor, and save the package log script. For example, the package log script below includes the debug script command DEBUG(ON). 5. Choose Data Manager you modified. Run Package . In the Local Packages pane, run the package that
<BR>PROMPT(TRANSFORMATION,D:\PC_MS\Data\WebFolders\PCMS75Mpre\PLANNING\DATAMA NAGER\TRANSFORMATIONFILES\SYSTEM FILES\EXPORT.XLS,"TRANSFORMATION FILE:",,,EXPORT.XLS) <BR>PROMPT(COMBOBOX,PERIODIC,"PLEASE SELECT A MEASURE THAT YOU WANT TO EXPORT",1,PERIODIC,Periodic,QTD,YTD) <BR>INFO(D:\PC_MS\Data\WebFolders\PCMS75Mpre\PLANNING\PrivatePublications\Adm inistrator\TempFiles\Temp5v4i_89_.tmp,D:\PC_MS\Data\WebFolders\PCMS75Mpre\PLA NNING\PrivatePublications\Administrator\TempFiles\Tempwgxm_89_.tmp) <BR>TASK(DUMP DATA,APPSET,PCMS75Mpre) <BR>TASK(DUMP DATA,APP,PLANNING) <BR>TASK(DUMP DATA,USER,ICND50075752A\Administrator) <BR>TASK(DUMP DATA,DATATRANSFERMODE,3) <BR>TASK(DUMP DATA,MDX,D:\PC_MS\Data\WebFolders\PCMS75Mpre\PLANNING\PrivatePublications\Adm inistrator\TempFiles\FROM_89_.TMP) <BR>TASK(DUMP DATA,FILE,D:\PC_MS\Data\WebFolders\PCMS75Mpre\PLANNING\PrivatePublications\Ad ministrator\TempFiles\Temp5v4i_89_.tmp) <BR>TASK(DUMP DATA,GETMEASURE,PERIODIC) <BR>TASK(CONVERT DATA,INPUTFILE,D:\PC_MS\Data\WebFolders\PCMS75Mpre\PLANNING\PrivatePublicatio ns\Administrator\TempFiles\Temp5v4i_89_.tmp) <BR>TASK(CONVERT DATA,OUTPUTFILE,D:\PC_MS\Data\WebFolders\PCMS75Mpre\PLANNING\DataManager\Data Files\\Export_debug.txt) <BR>TASK(CONVERT DATA,CONVERSIONFILE,D:\PC_MS\Data\WebFolders\PCMS75Mpre\PLANNING\DATAMANAGER\ TRANSFORMATIONFILES\SYSTEM FILES\EXPORT.XLS) <BR>TASK(CONVERT DATA,STRUSERNAME,ICND50075752A\Administrator) <BR>TASK(CONVERT DATA,STRAPPSET,PCMS75Mpre) <BR>TASK(CONVERT DATA,STRAPP,PLANNING) <BR>TASK(CONVERT DATA,SELECTIONFILE,D:\PC_MS\Data\WebFolders\PCMS75Mpre\PLANNING\PrivatePublic ations\Administrator\TempFiles\FROM_89_.TMP))
TASK(CONVERT data,OUTPUTFILE,%FILE%)
Prompt for selecting output file in the Export package Description of Command
INFO(%FILE%, OUTPUTFIL D:\PC_MS\Data\WebFolders\PCMS75Mpre\PLANNING\DataManager\DataFiles\ E instruction \Export_debug.txt) is generated reserved (%FILE%) variable/ value for transferring into convert task. TASK(CONVERT data, OUTPUTFILE, OUTPUTFIL D:\PC_MS\Data\WebFolders\PCMS75Mpre\PLANNING\DataManager\DataFiles\ E \Export_debug.txt) variable(%FI LE%) is transferred into Convert Task. Any software coding and/or code lines / strings ("Code") included in this documentation are only examples and are not intended to be used in a productive system environment. The Code is only intended to better explain and visualize the syntax and phrasing rules of certain coding. SAP does not warrant the correctness and completeness of the Code given herein, and SAP shall not be liable for errors or damages caused by the usage of the Code, except if such damages were caused by SAP intentionally or by its gross negligence.
Standard Packages
You can use the packages provided in the Data Management package group to perform general data management tasks. If a file has an associated transformation file, you can modify the file or assign it directly to the package. See Data Transformations. Package Name Description Clear This package clears the data in the Fact and FAC2 table by importing zero values. The optimize process 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. NOTE To run this package, select at least one dimension. If you select [All], the package cannot run. Copy This package copies data between dimensions within the Planning and Consolidation application. See Copying Application Data. This package executes default formulas stored in your Default.LGF file.
This package exports data values from the Planning and Consolidation cube (including calculated values) into an ASCII file. You are prompted to enter a name for the export file and for a data selection to export. You can use the export.xls transformation file with this package. This package is used for currency translation. A sample logic file, FXTrans.lgf, is provided as an empty file. For more information, seeCurrency Conversions. This package imports one or more ASCII files into the current application. You are prompted for one or more import files and associated conversion files. The signs of the amounts are reversed based on the Account type. You can use the import.xls transformation file with this package. This package lets you move any selection of data within an application. You are prompted for source and destination data selections for all dimensions. The package clears records in the fact table in the destination before it moves records from the source fact table. When the records have been moved to the destination, the package clears the records in the source table.
FX Restatement Import
Move
More Information
Running and Scheduling Packages
Data Transformations
You define data transformations so that you can map external data to internal Planning and Consolidation data structures. EXAMPLE When performing a data import, the source data may not be in the correct format. The dimension names in the source data may not match the dimension names in Planning and Consolidation. In this case, you map the external dimensions to the internal dimensions in the conversion file. The Data Manager import
package reads the transformation file (which has a pointer to a conversion file) and correctly maps the data.
Prerequisites
To perform data transformations, at least two Interface for Excel workbook files must exist. The required files are described in the following table:
File
Description
Transformation This file allows you to set up the rules for reading data from an external source and put it file in the proper form for your system database. Transformation files are Microsoft Excel files that contain one worksheet named Instructions. The Instructions worksheet has the following sections: *Options *Mapping *Conversion Conversion file This file allows you to map member names from external to internal dimension structures. You can set up multiple sheets in a conversion file so that many transformations can access the same conversion workbook. You can have one conversion file per dimension. See Data Conversion Maintenance.
Features
After setting up a transformation file and a conversion file, you run packages using these files to define a data transformation. See Running a Package. NOTE All dimensions of an application must be mapped in the transformation. If the import file does not have a dimension (such as DATASRC), then you would use *NEWCOL (see below).
Options Section
The *Options section of the Transformation file contains definitions for various options that you can set for your transformation. The following table contains a list of available options and descriptions for each option:
Option
AMOUNTDECIMALPOINT =text character
Defaul Description t
. (perio This option allows you to specify a nonperiod decimal point for countries d) that use a different character, such as a comma. The character specified in this option must differ from the character specified for the DELIMITER.
Option
CONVERT_INTERNAL = YES | NO
Defaul Description t
NO This option compares input member names with columns in the conversion file. If NO, the input member names are compared with the external column in conversion file. If YES, the input member names are compared with the internal column in conversion file. RECOMMENDATION Do not change the default setting. This setting is here for the purposes of backward compatibility only. There are no reasons to change this in Planning and Consolidation 7.5 and later versions.
<Accou This option specifies which nt> dimension to look at for value calculations. You must specify a dimension conversion sheet using the Amount *Conversion option. For more information about conversion files, see Data Conversion Maintenance. If there is no formula in the Formula column of the Amount conversion sheet, this parameter has no effect. For example, if the Formula column has the following formula: <value>*1.10, all accounts are increased by 10% during the conversion. YES This option reverses the signs for a given account. If this parameter is set to NO, the option reverses the sign for all amounts referring to an ACCOUNT type (LEQ, INC).
Option
DELIMITER = text character| SPACE | TAB
Defaul Description t
, (com ma) This option defines the single character that is the delimiter between columns of the output if the FORMAT option is set to DELIMITED, Use the keywords SPACE or TAB if the columns are delimited by spaces or tabs. The delimiter character must be unique and must be the delimiter character used in the file. Otherwise, the Data Preview displays incorrectly. This option defines processing associated with an exported file. Using the CATEGORYBYTIME option generates an output file categorized by time period. Using the MULTIWITHHEADER option generates an output file with header information. Using the MULTIWITHNOHEADER option generates the same output file as MultiWithHeader without the header titles This option defines the format of the data in the input or output file. DELIMITED means that there is a special character between each column of data, defined by theDELIMITER option (above). FIXED means that the data is in a fixed field format. For this setting, use the FCOL mapping option. CATEGORYBYTIME means that the data is listed by categories that represent time periods.
EXPORTFORMAT =CATEGORYBYTIME |MULTIWITHHEADE There is no R |MULTIWITHNOHEADER default. This option must be defined.
Option
HEADER = YES | NO
Defaul Description t
YES This option specifies if your data has a header row. If this parameter is set to YES, your input file contains one header row that defines the fields. If you do have a header row, you can refer to a field by name in the MAPPING section.
empty This option specifies the number of string rejected records at which to stop processing if you are validating records. A value of -1 implies that the Data Manager should keep processing, no matter how many rejected records exist. The default value is 500, which can be represented by an empty string. a space This value allows you to assign a charact valued to null records. er , (com ma) This option defines the single character that is the delimiter between columns of the output if the FORMAT option is set to DELIMITED, Use the keywords SPACE or TAB if the columns are delimited by spaces or tabs. The delimiter character must be unique and must be the delimiter character used in the file. Otherwise, the Data Preview displays incorrectly.
Option
OUTPUTHEADER = text string
Defaul Description t
empty This option allows you to create a string custom header to export data. It is ignored when the transformation file is used to import data. You can use {CRLF} to create more than one row for the header. For example: MyCompany Data{CRLF}Category,Time,Acc ount, Entity,Datasrc,Intco,RPTCur rency,Amount. NOTE The complete OUTPUTHEADER text string should be in the same cell in the transformation file.
ROUNDAMOUNT = integer
This option specifies the amount of decimal places to which values are to be rounded during the transformation. By default, there is no rounding during data transformation. If you use this option, you must enter a parameter. The integer can be zero or any positive integer.
SKIP = integer
0 (zero) This option specifies the number of lines to skip at the top of a data file. EXAMPLE Use this option to skip header lines during transformation.
empty This option causes the string transformation to skip a line in the data file if it begins with the specified strings. The strings are separated by |, in the above case. If a record begins with<text string> or <text string2>, the record is skipped. To include all lines in the transformation, set this option to an empty string. If you use this option, you must enter a parameter. You can skip null database records by setting SKIPIF = NULL.
Option
VALIDATERECORDS = No |Yes
Defaul Description t
No This option specifies whether or not to validate records. If this parameter is set to No, the validation does not occur. If this parameter is set to Yes, check the following items before the import: Validate the mapping. Ensure that the members exist. Verify that the record is proper for the Planning and Consolidation application. When this option is enabled, the following rules apply: If a member ID is not mapped, the record associated with the ID is rejected during validation and ignored. If the import file has an extra field that is not mapped, all records are rejected during validation. VALIDATERECORDS is only relevant for importing files. If you are using Planning and Consolidation for the Microsoft platform, ensure that VALIDATERECORDS is set to Nowhen exporting files.
Mapping Section
The *Mapping section of the transformation file defines how data is mapped to your system database. EXAMPLE For a header row and that defines a column named AccountVal, you can map the Account dimension to the Account field from the data file this way: Account = AccountVal The following table details the available mapping functions:
Mapping Function
Parameter Description s
*COL(A)
This function 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)
*COL(A, B:C)
A = column index in the data file B:C = the start and end positions within the column A:B = the start and end positions within the data row
This function defines a dimension for a subset of a field in the data file. EXAMPLE Account=*COL(3,1:4)
*FCOL(A:B)
This option allows you to define the start and end character columns for each field when you are using Fixed format data files, In the example below, the columns 4 through 7 represent the Account dimension. EXAMPLE Account=*FCOL(4:7)
*MVAL(A:B)
A:B = the start and end or time period Dimension =*MVAL(keyfiguretype1|dim_m columns em1||keyfiguretype2|dim_mem 2||keyfiguretype3|dim_mem3)
This function supports the following types of usage: Allows you to use multiple time period columns EXAMPLE If you have a number of consecutive columns that are based on time periods, you can use this function to include all of them. In the following set of columns, you can use the following command: Time = *MVAL(7:18) Account,Category,DATASR C,entity,IntCo,RptCURRE NCY,JAN,FEB,MAR,APR,MAY ,JUN,JUL,AUG,SEP,OCT,NO V,DEC Using this command requires that you use a time.xls conversion sheet. To see the sample time.xls conversion file, open the existing conversion definition window. If your data does not have a header row, the time periods are named P1, P2, P3,...,PN by default. Allows you to convert multiple key figures to one key figure according to the following guidelines: The dimension must be an existing column in the cube. The dimension members in dim_mem must be the noncalculated members of the dimension. The keyfiguretype must be the field name of the source data. You can directly input the dimension members in the dim_mem, or input any existing mapping command in the dim_mem, such as *newcol, *col or *newcol(cash)+*col(1). EXAMPLE Source data: Account, Entity, Data source, LC, GC, TC. Cash, SalesItaly, Input, key1, key2, key3 Mapping command: Account=*MKEY(LC|* NEWCOL(Cash_lc)||G C|*COL(1)+*STR(gc) ||TC|*NEWCOL(Cash_ tc))
*NEWCOL(A)
A = dimension This function creates a new field with the given value. member EXAMPLE Account=*NEWCOL(Revenue)
*Str(string)
Not applicable This function adds a text string to the members of a column. This function is useful if you need to map data file fields to fields in your database that have the same names, except that the field names contain extra characters (either before or after the name). EXAMPLE Entity = *Str(NE) + *COL(1)
*PAD
Not applicable This function is used for padding imported fields. EXAMPLE To prepend the letter A to a field (such as the member ID) use *PAD(A). If the field contains 123 before the command, the resulting value is A123.
Planning and Consolidation takes the following actions, depending on the results of the condition evaluations: Condit ion1- If this evaluat es toTrue, map using Action1 Condit ion2- If Conditio n1 is "False" and Conditio n2 is "True," map using Action2 Defaul t Action - If both Conditio n1 and Conditio n2 are "False", map using this Default Action Condit ion1an dCondi tion2c an contain multiple items that are added together (using the plus + s ign).
This function allows you to test a series of conditions, and to apply a corresponding action if the condition is true. EXAMPLE Product=*if (Product+ID+Entity = *str(148552) then *str(MHarn);ID(1:1) = *str(C) then *str(XX) ; *str(YY)) Explanation: This means that if the sum of the product, ID, 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. EXAMPLE Examine the following series of data sets, mapping function examples, and result sets to gain an understanding of how the *IF function can be used in various scenarios:
Data Set 1:
PRODUCT,ID,ENTITY 14,85,52 AB,CD,EF GH,IJ,KL
Mapping Function 1:
Product=*IF (product+ID+Entity=*Str(148552) then *str(MHarn);ID(1:1) = *str(C) then *str(XX) ; *str(YY))
Result Set 1:
PRODUCT,ID,ENTITY MHarn,85,52 AB,XX,EF YY,IJ,KL
Data Set 2:
Entity, SEntity U1000000, US01 Z2000A01, CA03 K3430000, JP04
Mapping Function 2:
Entity=*IF(*col(1,1:1)=U then SEntity;*col(1,1:1)=Z then *col(1,3:6); *STR(ERR))
Result Set 2:
Entity, SEntity US01, US01 A01, CA03 ERR, JP04
Conversion Section
The *CONVERSION section of the transformation file defines which conversion sheet to use with which dimensions. Use the following syntax to associate a dimension with a conversion sheet: Dimension Name = [COMPANY]WorkbookName[!SheetName] NOTE Items in brackets are optional. The following table describes the variables. Variable Description
DimensionName Either the dimension name to correlate with the conversion file or the keyword Amount. Use the Amount option to specify the conversion file to be used if you specify the ConverAmountWDim option in the*Options section. This allows you to use a formula to scale the input or output values. Workbookname SheetName The name of the conversion file This is the name of the worksheet to use within the conversion file. If a name is not specified, the system assumes the sheet name is Conversion. If [COMPANY] is defined then the Data Manager tries to obtain the conversion file from the main company Data Manager folder. Otherwise the Data Manager looks in the appropriate Site folder.
[COMPANY]
Activities
To create a new transformation file, select eData New Transformation File. Enter data as required. To edit transformation files, select eData Manage Transformation Files, then browse to the desired file. Enter data as required. To copy a transformation file, open the file you want to copy by selecting Manage Data from the Getting Started - Interface for Excel action pane. Select Maintain transformations Manage existing transformation. Open the desired file and select Copy Transformation File. To copy dimension files between applications, you create a transformation file to map the dimensions. See Sample Transformation File.
Example
In this example, AccountConv.xls is the name of the Account dimension conversion file. Account = AccountConv.xls Amount = AccountConv.xls (Use the Amount keyword with the ConvertAmountWDim transformation option.) Account = AccountConv.xls!newaccount Account = [COMPANY]AccountConv.xls!newaccount
Features
*skip
If you want to ignore external data (as listed in the External column), you can place the keyword *skip in the Internal column, as in the following example. External ACCPAY Internal *skip
Wildcards
You can use the asterisk (*) and question mark (?) wildcards in the External or Internal columns. An asterisk (*) stands for any character, while a question mark (?) stands for any single character. For example, if you want to reference all members, use the asterisk (*). You also can use a colon (:) for a specified range: When Conversion_internal = NO, use a colon in the Internal column or formula column. When Conversion_internal = YES, use a colon in the External column or formula column.
In the following example, the formula, which uses an asterisk, would increase all of the members by 10 percent: External * Internal * Formula Value*1.10
*IF
You can use if statement in a conversion file. External Internal actual *If(%external%=act* then Actual; %external% = bud* then budget; forecast) If the transformation option Convert_internal = NO, *IF can be used in the Internal column. If transformation option Convert_internal = YES, *IF can be used in the External column.
Formula
To write a formula to update SIGNEDDATA, you write this formula with the FORMULA column. Example 1 Conversion file: RPTCURRENCY.XLS!SHEET1 External USD LC Conversion file: RPTCURRENCY.XLS!SHEET2 External LC Internal RMB Formula Value*1.10 Internal *skip RMB
The first rule is applied to RPTCURRENCY, and the second rule is applied to Signedata. The criteria checks the member value of RPTCURRENCY before and after the conversion. Before the conversion, the transaction data is the following: DATASRC,CATEGORY,ACCOUNT,ENTITY,TIME,PRODUCT,RPTCURRENCY,AMOUNT INPUT,ACTUAL,ExtSales,PETSTORE1,2006.JAN,DOGDRYPUPPY,USD,-100 INPUT,ACTUAL,ExtSales,PETSTORE1,2006.JAN,DOGDRYADULT,LC,-200 The meaning of this rule is the following: Convert the dimension members of RPTCURRENCY If the source value is USD, then the system skips this current record since the internal value is *skip. If the source value is LC, then this value is converted to RMB. Convert the SIGNEDDATA according to the member value of RPTCURRENCY If the source value is LC before conversion and is RMB after the conversion, then the signedata of this current record is increased by the formula. After the conversion, the transaction data is the following: Submitted: Transaction data: DATASRC,CATEGORY,ACCOUNT,ENTITY,TIME,PRODUCT,RPTCURRENCY,AMOUNT INPUT,ACTUAL,ExtSales,PETSTORE1,2006.JAN,DOGDRYADULT,RMB,-220 Skipped: Transaction data: DATASRC,CATEGORY,ACCOUNT,ENTITY,TIME,PRODUCT,RPTCURRENCY,AMOUNT INPUT,ACTUAL,ExtSales,PETSTORE1,2006.JAN,DOGDRYPUPPY,USD,-100 Example 2 Conversion file: RPTCURRENCY.XLS!SHEET1 External * Internal * Formula Value*1.10
Apply this conversion rule to dimension RPTCURRENCY. Before the conversion, the transaction data is the following: DATASRC,CATEGORY,ACCOUNT,ENTITY,TIME,PRODUCT,RPTCURRENCY,AMOUNT INPUT,ACTUAL,ExtSales,PETSTORE1,2006.JAN,DOGDRYPUPPY,USD,-100 INPUT,ACTUAL,ExtSales,PETSTORE1,2006.JAN,DOGDRYADULT,LC,-200 The meaning of this rule is: For any member of RPTCURRENCY, whatever it is before the conversion (External) and after conversion (Internal), the formula is applied to the signed data for the current data records. After the conversion, the transaction data is the following: Transaction data: DATASRC,CATEGORY,ACCOUNT,ENTITY,TIME,PRODUCT,RPTCURRENCY,AMOUNT INPUT,ACTUAL,ExtSales,PETSTORE1,2006.JAN,DOGDRYPUPPY,USD,-110 INPUT,ACTUAL,ExtSales,PETSTORE1,2006.JAN,DOGDRYADULT,LC,-220 Example 3 Conversion file: RPTCURRENCY.XLS!SHEET1 External Internal
Apply this conversion rule to dimension ENTITY. Before the conversion, the transaction data is the following: DATASRC,CATEGORY,ACCOUNT,ENTITY,TIME,PRODUCT,RPTCURRENCY,AMOUNT INPUT,ACTUAL,ExtSales,23,2006.JAN,DOGDRYPUPPY,USD,-100 INPUT,ACTUAL,ExtSales,C100,2006.JAN,DOGDRYADULT,LC,-200 The meaning of this rule is: For the dimension members of ENTITY, if the source value is in the range of the value in the external column, then the source value is converted to the value in the internal column After the conversion, the transaction data is the following: Submitted: Transaction data: DATASRC,CATEGORY,ACCOUNT,ENTITY,TIME,PRODUCT,RPTCURRENCY,AMOUNT INPUT,ACTUAL,ExtSales, PETSTORE1,2006.JAN,DOGDRYPUPPY,USD,-100 INPUT,ACTUAL,ExtSales, PETSTORE2,2006.JAN,DOGDRYADULT,LC,-200
In this example, if the source data contains the patten of act*, then the source data is converted to Actual. If the length of the source data is 4, then the source data is converted to Budget. Otherwise, the source data is converted to Forecast. Javascript can be used in the FORMULA column EXAMPLE The following item is an example of a Javascript command that can be used in the formula column: js:Math.round(VALUE*Math.pow(10,2))/Math.pow(10,2); If the source value is 200.356, the target value is 200.36.
Javascript is used to generate a target value or to do calculations for signed data. This means the following:
When Conversion_internal = NO, Javascript can be used in the Internal column or formula column. When Conversion_internal = YES, Javascript can be used in the External column or formula column.
Activities
You can perform the following tasks when maintaining data conversions: Maintaining a Data Conversion Definition Creating a Data Conversion File Copying Data Conversion Files Inserting Conversion Sheets Validating Conversion Definitions To maintain conversions, choose Data Maintain conversions. Any software coding and/or code lines / strings ("Code") included in this documentation are only examples and are not intended to be used in a productive system environment. The Code is only intended to better explain and visualize the syntax and phrasing rules of certain coding. SAP does not warrant the correctness and completeness of the Code given herein, and SAP shall not be liable for errors or damages caused by the usage of the Code, except if such damages were caused by SAP intentionally or by its gross negligence.
Procedure
Choose eData Maintain conversions Manage definition of existing conversion .
Procedure
Create a data conversion file by doing the following steps: 1. Choose eData Maintain conversions . 2. Choose Create new conversion. RECOMMENDATION Give the conversion file the same name as the dimension for which it is being used.
Procedure
1. Choose eData Maintain conversions 2. Open or create a new conversion file. 3. Choose Copy conversion. .
RECOMMENDATION Give the conversion file the same name as the dimension for which it is being used.
Procedure
1. Choose eData Maintain conversions 2. Open or create a new conversion file. 3. Choose Insert conversion sheet. .
RECOMMENDATION Give the conversion sheet the same name as the dimension for which it is being used.
More Information
Maintaining a Data Conversion Definition Creating a Data Conversion File
Procedure
1. Choose eData Maintain conversions . 2. Open or create a new conversion file. 3. Choose Validate conversion definitions or Validate and save conversion definitions.
4.
5. 6. When you are copying or importing data between applications and need to map the dimensions that are different, you can create a transformation file to map the dimensions. 7. The following table contains a list of the dimensions in a sample source and target application:
Source Application
Target Application
8. To map the dimensions from the source application to the target application, you can create a transformation file such as the following: 9. *OPTIONS 10. FORMAT = DELIMITED 11. HEADER = YES 12. DELIMITER = 13. SKIP = 0 14. SKIPF = 15. CREDITNEGATIVE=NO 16. CONVERTAMOUNTWDIM= 17. MAXREJECTCOUNT= 18. VALIDATERECORDS=YES 19. *MAPPING 20. cat=category 21. Acc=Account 22. Ent = Entity 23. Tim=time 24. Currency=Rptcurrency 25. int=intco 26. dat=Datasrc 27. *CONVERSION
28.
More Information
Procedure
1. Create a package using the corresponding process chains for copying data (see Package Usage). 2. Run the package. 1. Log onto the Planning and Consolidation Office client. 2. Choose Manage Data Run a package . 3. Choose the package you created in step 1 and choose Run. 4. Select one of the following methods to copy the data:
5. 6. 7. 8.
9.
Choose Merge data values. Choose Replace and clear data values. To run default logic after the copy process, choose Yes. To check the work status when importing the data, choose Yes. Select the data regions for the source and destination. Choose one of the following options: Run now Schedule Run now & schedule Choose Finish.
NOTE You can change the default package instructions (see Modifying the Dynamic Script of a Package). Dynamic script task parameters Task: /CPMB/CLEAR_SOURCE_CUBE Task /CPMB/CLEAR_SOURCE_CUBE Parameter CHECKLCK Default Value 0 Description Check work status 1 = YES 0 = NO INTERNAL INTERNAL 40.000 Package size Selection 40.000 Package size Selection destination 0 Delete data before writing 0 = NO 1= YES Check work status 1 = YES 0 = NO Run logic after process 0 = NO 1 = YES
/CPMB/APPEND_LOAD
CHCKLCK
/CPMB/APPEND_LOAD
RUNLOGIC
Task /CPMB/CLEAR_SOURCE_CUBE
Parameter CLEARDATA
Default Value 0
EXAMPLE Script PROMPT(RADIOBUTTON,%CLEARDATA%,"Select the method for copying the data from the source to destination database",0,{"Merge data values (Copies specified records, leaving all remaining records in the destination intact)","Replace && clear data values(Copies specified records, and clears the data values for any records that mirror each entity/category/time combination defined in the source)"},{"0","1"}) PROMPT(RADIOBUTTON,%RUNLOGIC%,"Select whether to run default logic for stored values after copying",0,{"Yes","No"},{"1","0"}) PROMPT(RADIOBUTTON,%CHECKLCK%,"Select whether to check work status settings when importing data.",1,{"Yes, check for work status settings before importing","No, do not check work status settings"},{"1","0"}) PROMPT(COPYMOVEINPUT,%SELECTION%,%TOSELECTION%,"Select the members to COPY and where to","%DIMS%") INFO(%TEMPNO1%,%INCREASENO%) INFO(%ACTNO%,%INCREASENO%) TASK(/CPMB/CM_CONVERT,OUTPUTNO,%TEMPNO1%) TASK(/CPMB/CM_CONVERT,ACT_FILE_NO,%ACTNO%) TASK(/CPMB/CM_CONVERT,SAPPSET,%APPSET%) TASK(/CPMB/CM_CONVERT,SAPP,%APP%) TASK(/CPMB/CM_CONVERT,SELECTION,%SELECTION%) TASK(/CPMB/CM_CONVERT,TOSELECTION,%TOSELECTION%) TASK(/CPMB/CM_CONVERT,CLEARDATA,%CLEARDATA%) TASK(/CPMB/CLEAR_SOURCE_CUBE,CHECKLCK,%CHECKLCK%) TASK(/CPMB/CLEAR_SOURCE_CUBE,SELECTION,%TOSELECTION%) TASK(/CPMB/APPEND_LOAD,INPUTNO,%TEMPNO1%) TASK(/CPMB/APPEND_LOAD,ACT_FILE_NO,%ACTNO%) TASK(/CPMB/APPEND_LOAD,RUNLOGIC,%RUNLOGIC%) TASK(/CPMB/APPEND_LOAD,CHECKLCK,%CHECKLCK%) TASK(/CPMB/APPEND_LOAD,CLEARDATA,%CLEARDATA%) Data The transaction data in the target selection is cleared to zero first, then all the transaction data in the source selection is written to the target. The transaction data in the source is not affected after the copy. When set option = Merge, this means CLEARDATA=0: Example1: Source selection: Entity=CASH Target selection: Entity=CASH1 Data in the application before the copy: ACTUAL,CASH,2006.MAY,200 ACTUAL,CASH,2006.JULY,300
ACTUAL,CASH1,2006.MAY,100 ACTUAL,CASH1,2006.JUNE,150 Data in the application after the copy: ACTUAL,CASH,2006.MAY,200 ACTUAL,CASH,2006.JULY,300 ACTUAL,CASH1,2006.MAY,200 ACTUAL,CASH1,2006.JUNE,0 ACTUAL,CASH1,2006.JULY,300 Example 2: Source selection: Time=2006.MAY, DataSrc = INPUT Target selection: Time=2006.JULY, DataSrc = INPUT Data in the application before the copy: INPUT, ACTUAL,CASH, LC, 2006.MAY,200 INPUT, ACTUAL,CASH, USD, 2006.MAY,100 INPUT, ACTUAL,CASH, LC, 2006.JULY,300 INPUT, ACTUAL, CASH, USD, 2006. AUG, 500 NO_IP, ACTUAL,CASH,LC, 2006.JULY,150 MANU, ACTUAL,CASH,LC, 2006.JUNE,250 MANU, ACTUAL,CASH,USD, 2006.AUG, 400 Data in the application after the copy: INPUT, ACTUAL,CASH, LC, 2006.JULY,200 INPUT, ACTUAL,CASH, USD, 2006.JULY,100 INPUT, ACTUAL,CASH, LC, 2006.MAY,200 INPUT, ACTUAL,CASH, USD, 2006.MAY,100 INPUT, ACTUAL, CASH, USD, 2006. AUG, 500 NO_IP, ACTUAL,CASH,LC, 2006.JULY,150 MANU, ACTUAL,CASH,LC, 2006.JUNE,250 MANU, ACTUAL,CASH,USD, 2006.AUG, 400 When set option = Replace and clear, this means CLEARDATA=1: Example3: Source selection: Time=2006.MAY, DataSrc = INPUT Target selection: Time=2006.JULY, DataSrc = INPUT Data in the application before the copy: INPUT, ACTUAL,CASH, LC, 2006.MAY,200 INPUT, ACTUAL,CASH, USD, 2006.MAY,100 INPUT, ACTUAL,CASH, LC, 2006.JULY,300 INPUT, ACTUAL, CASH, USD, 2006. AUG, 500 NO_IP, ACTUAL,CASH,LC, 2006.JULY,150 MANU, ACTUAL,CASH,LC, 2006.JUNE,250 MANU, ACTUAL,CASH,USD, 2006.AUG, 400 Data in the application after the copy: INPUT, ACTUAL,CASH, LC, 2006.JULY,200 INPUT, ACTUAL,CASH, USD, 2006.JULY,100 INPUT, ACTUAL,CASH, LC, 2006.MAY,200 INPUT, ACTUAL,CASH, USD, 2006.MAY,100
INPUT, ACTUAL, CASH, USD, 2006. AUG, 500 NO_IP, ACTUAL,CASH,LC, 2006.JULY,0 MANU, ACTUAL,CASH,LC, 2006.JUNE,250 MANU, ACTUAL,CASH,USD, 2006.AUG, 400 Any software coding and/or code lines / strings ("Code") included in this documentation are only examples and are not intended to be used in a productive system environment. The Code is only intended to better explain and visualize the syntax and phrasing rules of certain coding. SAP does not warrant the correctness and completeness of the Code given herein, and SAP shall not be liable for errors or damages caused by the usage of the Code, except if such damages were caused by SAP intentionally or by its gross negligence.
Data Transformations
You define data transformations so that you can map external data to internal Planning and Consolidation data structures. EXAMPLE When performing a data import, the source data may not be in the correct format. The dimension names in the source data may not match the dimension names in Planning and Consolidation. In this case, you map the external dimensions to the internal dimensions in the conversion file. The Data Manager import package reads the transformation file (which has a pointer to a conversion file) and correctly maps the data.
Prerequisites
To perform data transformations, at least two Interface for Excel workbook files must exist. The required files are described in the following table: File Description
Transformation This file allows you to set up the rules for reading data from an external source and put it file in the proper form for your system database. Transformation files are Microsoft Excel files that contain one worksheet named Instructions. The Instructions worksheet has the following sections: *Options *Mapping *Conversion Conversion file This file allows you to map member names from external to internal dimension structures. You can set up multiple sheets in a conversion file so that many transformations can access the same conversion workbook. You can have one conversion file per dimension. See Data Conversion Maintenance.
Features
After setting up a transformation file and a conversion file, you run packages using these files to define a data transformation. See Running a Package. NOTE All dimensions of an application must be mapped in the transformation. If the import file does not have a dimension (such as DATASRC), then you would use *NEWCOL (see below). Options Section
The *Options section of the Transformation file contains definitions for various options that you can set for your transformation. The following table contains a list of available options and descriptions for each option: Option AMOUNTDECIMALPOINT= text character Default Description . (perio This option allows you to specify a nonperiod decimal point for countries d) that use a different character, such as a comma. The character specified in this option must differ from the character specified for the DELIMITER. NO This option compares input member names with columns in the conversion file. If NO, the input member names are compared with the external column in conversion file. If YES, the input member names are compared with the internal column in conversion file. RECOMMENDATION Do not change the default setting. This setting is here for the purposes of backward compatibility only. There are no reasons to change this in Planning and Consolidation 7.5 and later versions. CONVERTAMOUNTWDIM= dimension name <Accou This option specifies which nt> dimension to look at for value calculations. You must specify a dimension conversion sheet using the Amount *Conversion option. For more information about conversion files, see Data Conversion Maintenance. If there is no formula in the Formula column of the Amount conversion sheet, this parameter has no effect. For example, if the Formula column has the following formula: <value>*1.10, all accounts are increased by 10% during the conversion. YES This option reverses the signs for a given account. If this parameter is set to NO, the option reverses the sign for all amounts referring to an ACCOUNT type (LEQ, INC).
CONVERT_INTERNAL =YES | NO
CREDITNEGATIVE =YES | NO
Default Description , (com ma) This option defines the single character that is the delimiter between columns of the output if the FORMAT option is set to DELIMITED, Use the keywords SPACE or TAB if the columns are delimited by spaces or tabs. The delimiter character must be unique and must be the delimiter character used in the file. Otherwise, the Data Preview displays incorrectly. This option defines processing associated with an exported file. Using the CATEGORYBYTIME option generates an output file categorized by time period. Using the MULTIWITHHEADER option generates an output file with header information. Using the MULTIWITHNOHEADER option generates the same output file as MultiWithHeader without the header titles This option defines the format of the data in the input or output file. DELIMITED means that there is a special character between each column of data, defined by the DELIMITER option (above). FIXED means that the data is in a fixed field format. For this setting, use the FCOL mapping option. CATEGORYBYTIME means that the data is listed by categories that represent time periods.
EXPORTFORMAT =CATEGORYBYTIME |MULTIWITHHEADE There is no R |MULTIWITHNOHEADER default. This option must be defined.
HEADER = YES | NO
YES
This option specifies if your data has a header row. If this parameter is set to YES, your input file contains one header row that defines the fields. If you do have a header row, you can refer to a field by name in the MAPPINGsection.
Default Description empty This option specifies the number of string rejected records at which to stop processing if you are validating records. A value of -1 implies that the Data Manager should keep processing, no matter how many rejected records exist. The default value is 500, which can be represented by an empty string. a space This value allows you to assign a charact valued to null records. er , (com ma) This option defines the single character that is the delimiter between columns of the output if the FORMAT option is set to DELIMITED, Use the keywords SPACE or TAB if the columns are delimited by spaces or tabs. The delimiter character must be unique and must be the delimiter character used in the file. Otherwise, the Data Preview displays incorrectly.
empty This option allows you to create a string custom header to export data. It is ignored when the transformation file is used to import data. You can use {CRLF} to create more than one row for the header. For example: MyCompany Data{CRLF}Category,Time,Acc ount, Entity,Datasrc,Intco,RPTCur rency,Amount. NOTE The complete OUTPUTHEADER text string should be in the same cell in the transformation file.
Default Description There is no default. You must define this option. This option specifies the amount of decimal places to which values are to be rounded during the transformation. By default, there is no rounding during data transformation. If you use this option, you must enter a parameter. The integer can be zero or any positive integer.
SKIP = integer
0 (zero) This option specifies the number of lines to skip at the top of a data file. EXAMPLE Use this option to skip header lines during transformation.
empty This option causes the string transformation to skip a line in the data file if it begins with the specified strings. The strings are separated by |, in the above case. If a record begins with<text string> or <text string2>, the record is skipped. To include all lines in the transformation, set this option to an empty string. If you use this option, you must enter a parameter. You can skip null database records by setting SKIPIF = NULL.
Default Description No This option specifies whether or not to validate records. If this parameter is set to No, the validation does not occur. If this parameter is set to Yes, check the following items before the import: Validate the mapping. Ensure that the members exist. Verify that the record is proper for the Planning and Consolidation application. When this option is enabled, the following rules apply: If a member ID is not mapped, the record associated with the ID is rejected during validation and ignored. If the import file has an extra field that is not mapped, all records are rejected during validation. VALIDATERECORDS is only relevant for importing files. If you are using Planning and Consolidation for the Microsoft platform, ensure that VALIDATERECORDS is set to No when exporting files.
Mapping Section The *Mapping section of the transformation file defines how data is mapped to your system database. EXAMPLE For a header row and that defines a column named AccountVal, you can map the Account dimension to the Account field from the data file this way: Account = AccountVal The following table details the available mapping functions: Mapping Function *COL(A) Parameters A = column index in the data file Description This function 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)
*COL(A, B:C)
A = column index in the data file B:C = the start and end positions within the column A:B = the start and end positions within the data row
This function defines a dimension for a subset of a field in the data file. EXAMPLE Account=*COL(3,1:4)
*FCOL(A:B)
This option allows you to define the start and end character columns for each field when you are using Fixed format data files, In the example below, the columns 4 through 7 represent the Account dimension. EXAMPLE Account=*FCOL(4:7)
*MVAL(A:B)
A:B = the start and end or time period Dimension =*MVAL(keyfiguretype1|dim_m columns em1||keyfiguretype2|dim_mem 2||keyfiguretype3|dim_mem3)
This function supports the following types of usage: Allows you to use multiple time period columns EXAMPLE If you have a number of consecutive columns that are based on time periods, you can use this function to include all of them. In the following set of columns, you can use the following command: Time = *MVAL(7:18) Account,Category,DATASR C,entity,IntCo,RptCURRE NCY,JAN,FEB,MAR,APR,MAY ,JUN,JUL,AUG,SEP,OCT,NO V,DEC Using this command requires that you use a time.xls conversion sheet. To see the sample time.xls conversion file, open the existing conversion definition window. If your data does not have a header row, the time periods are named P1, P2, P3,...,PN by default. Allows you to convert multiple key figures to one key figure according to the following guidelines: The dimension must be an existing column in the cube. The dimension members in dim_mem must be the noncalculated members of the dimension. The keyfiguretype must be the field name of the source data. You can directly input the dimension members in the dim_mem, or input any existing mapping command in the dim_mem, such as *newcol, *col or *newcol(cash)+*col(1). EXAMPLE Source data: Account, Entity, Data source, LC, GC, TC. Cash, SalesItaly, Input, key1, key2, key3 Mapping command: Account=*MKEY(LC|* NEWCOL(Cash_lc)||G C|*COL(1)+*STR(gc) ||TC|*NEWCOL(Cash_ tc))
*NEWCOL(A)
A = dimension This function creates a new field with the given value. member EXAMPLE Account=*NEWCOL(Revenue)
*Str(string)
Not applicable This function adds a text string to the members of a column. This function is useful if you need to map data file fields to fields in your database that have the same names, except that the field names contain extra characters (either before or after the name). EXAMPLE Entity = *Str(NE) + *COL(1)
*PAD
Not applicable This function is used for padding imported fields. EXAMPLE To prepend the letter A to a field (such as the member ID) use *PAD(A). If the field contains 123 before the command, the resulting value is A123.
Planning and Consolidation takes the following actions, depending on the results of the condition evaluations: Condit ion1- If this evaluat es toTrue, map using Action1 Condit ion2- If Conditio n1 is "False" and Conditio n2 is "True," map using Action2 Defaul t Action - If both Conditio n1 and Conditio n2 are "False", map using this Default Action Condit ion1an dCondi tion2c an contain multiple items that are added together (using the plus + s ign).
This function allows you to test a series of conditions, and to apply a corresponding action if the condition is true. EXAMPLE Product=*if (Product+ID+Entity = *str(148552) then *str(MHarn);ID(1:1) = *str(C) then *str(XX) ; *str(YY)) Explanation: This means that if the sum of the product, ID, 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. EXAMPLE Examine the following series of data sets, mapping function examples, and result sets to gain an understanding of how the *IF function can be used in various scenarios: Data Set 1: PRODUCT,ID,ENTITY 14,85,52 AB,CD,EF GH,IJ,KL Mapping Function 1: Product=*IF (product+ID+Entity=*Str(148552) then *str(MHarn);ID(1:1) = *str(C) then *str(XX) ; *str(YY)) Result Set 1: PRODUCT,ID,ENTITY MHarn,85,52 AB,XX,EF YY,IJ,KL Data Set 2: Entity, SEntity U1000000, US01 Z2000A01, CA03 K3430000, JP04 Mapping Function 2: Entity=*IF(*col(1,1:1)=U then SEntity;*col(1,1:1)=Z then *col(1,3:6); *STR(ERR)) Result Set 2: Entity, SEntity US01, US01 A01, CA03 ERR, JP04
Conversion Section The *CONVERSION section of the transformation file defines which conversion sheet to use with which dimensions. Use the following syntax to associate a dimension with a conversion sheet: Dimension Name = [COMPANY]WorkbookName[!SheetName] NOTE Items in brackets are optional. The following table describes the variables. Variable Description
DimensionName Either the dimension name to correlate with the conversion file or the keyword Amount. Use the Amount option to specify the conversion file to be used if you specify the ConverAmountWDim option in the *Options section. This allows you to use a formula to scale the input or output values. Workbookname SheetName The name of the conversion file This is the name of the worksheet to use within the conversion file. If a name is not specified, the system assumes the sheet name isConversion. If [COMPANY] is defined then the Data Manager tries to obtain the conversion file from the main company Data Manager folder. Otherwise the Data Manager looks in the appropriate Site folder.
[COMPANY]
Activities
To create a new transformation file, select eData New Transformation File. Enter data as required. To edit transformation files, select eData Manage Transformation Files, then browse to the desired file. Enter data as required. To copy a transformation file, open the file you want to copy by selecting Manage Data from the Getting Started - Interface for Excel action pane. Select Maintain transformations Manage existing transformation. Open the desired file and select Copy Transformation File. To copy dimension files between applications, you create a transformation file to map the dimensions. See Sample Transformation File.
Example
In this example, AccountConv.xls is the name of the Account dimension conversion file. Account = AccountConv.xls Amount = AccountConv.xls (Use the Amount keyword with the ConvertAmountWDim transformation option.) Account = AccountConv.xls!newaccount Account = [COMPANY]AccountConv.xls!newaccount
Prerequisites
To perform data transformations, at least two Interface for Excel workbook files must exist. The required files are described in the following table: File Description
Transformation This file allows you to set up the rules for reading data from an external source and put it file in the proper form for your system database. Transformation files are Microsoft Excel files that contain one worksheet named Instructions. The Instructions worksheet has the following sections: *Options *Mapping *Conversion Conversion file This file allows you to map member names from external to internal dimension structures. You can set up multiple sheets in a conversion file so that many transformations can access the same conversion workbook. You can have one conversion file per dimension (see Data Conversion Maintenance).
Features
The following details the transformation and conversion file rights that are granted: With the Execute task of DM security, a user can read, write, and select the transformation and conversion file in Company. With the GeneralAdmin task of DM security, a user can read and write the transformation and conversion file in Company and Team. With the PrimaryAdmin task of DM security, a user can read and write the transformation and conversion file in Company. With the TeamLeaderAdmin task of DM security, a user can read and write the transformation and conversion file in Team. After setting up a transformation file and a conversion file, you run packages using these files to define a data transformation (see Running a Package). NOTE All dimensions of an application must be mapped in the transformation. If the import file does not have a dimension (such as DATASRC), then you would use *NEWCOL (see below). Options Section The *Options section of the Transformation file contains definitions for various options that you can set for your transformation. The following table contains a list of available options and descriptions for each option: Option Default Description
Default
Description
. (period This option allows you to specify a nonperiod decimal ) point for countries that use a different character, such as a comma. The character specified in this option must differ from the character specified for the DELIMITER. You can use this option in the following two ways: AMOUNTDECIMALPO INT = Any single character For example, a period (.) or a comma (,). The decimal point is either a period or a comma and there is no thousands separator. AMOUNTDECIMALPO INT = Any two characters. The first character functions as the decimal point and the second functions as the thousands separator. There should be no space, tab, or any other character between the two characters. The default setting is that the decimal point of the signed data is a period and there are no thousand separators. For example, 10000.12.
Default
Description
<Accoun This option specifies which t> dimension to look at for value calculations. You must specify a dimension conversion sheet using the Amount in *Conversion option. For more information about conversion files, see Data Conversion Maintenance. If there is no formula in the Formula column of the Amount conversion sheet, this parameter has no effect at all. For example, in a case where the Formula column has the following formula: <value>*1.10, all accounts are increased by 10% during the conversion. NO This option compares input member names with columns in the conversion file. If NO, the input member names are compared with the external column in conversion file. If YES, the input member names are compared with the internal column in conversion file. RECOMMENDATION Do not change the default setting. This setting is here for the purposes of backward compatibility only. There are no reasons to change this in Planning and Consolidation 7.0 and later versions.
CONVERT_INTERNAL = YES | NO
CREDITNEGATIVE = YES | NO
YES
This option reverses the signs for a given account. If this parameter is set to NO, the option reverses the sign for all amounts referring to an ACCOUNT type (LEQ,INC).
Default
Description
, (comm This option defines the single character that is the delimiter a) between columns if the FORMAT option is set to DELIMITED. Use the keywords SPACE or TAB if the columns are delimited by spaces or tabs. <empty> This option specifies the filter value to call an End routine used in a BAdI.
ENDROUTINE
Description This option defines the format of the data in the input or output file. DELIMITED means that there is a special character between each column of data, defined by the DELIMITER option. Delimited format includes multiperiod and variant. FIXED means that the data is in a fixed field format. For this setting, use the FCOL mapping option. NOTE CATEGORYBYTIME is out of scope for Planning and Consolidation 7.5 Set FORMAT = DELIMITED for Variant format, which is still supported. Variant allows the user to define the name and position of the dimensions using multiple lines beginning with an asterisk (*). *CATEGORY=ACTUAL *TIME=2007.JAN *ENTITY, ACCOUNT, AMOUNT STORE1, EXTSALES, 1203 STORE2, EXTSALES, 1203 The variable format allows the user to define the name and position of the dimensions using multiple lines beginning with an asterisk (*). These lines (as many as needed) represent a header section. Besides a simple, one line header, the data file can also contain a variant header. The header can have several lines, each line starting with an asterisk (*). The following are examples of variant headers: The following example illustrates how you can use the variable format syntax, using a three line header section:
Default
Description
<empty> This option sets the K2 functions referenced by the master data members formula attribute. This option is only used for importing master data. It is illegal when running other packages. The libraries are syslib. The *syslib prefix is not needed here. Different libraries are separated by |. NOTE This is used for loading master data as is (new in Planning and Consolidation 7.0). EXAMPLE DAVY_KP1_DEV7A2_Q_Mdx lib_1.LGF| DAVY_KP1_DEV7A2_Q_Mdx lib_2.LGF
HEADER= YES | NO
YES
This option specifies if your data has a header row. If this parameter is set to YES, then your input file contains one header row that defines the fields. If you do have a header row, you can refer to a field by name in the MAPPING section.
MAXREJECTCOUNT=empty_string |-1 | positive number empty_s This option specifies the tring number of rejected records at which to stop processing if you are validating records. A value of -1 implies that the Data Manager should keep processing, no matter how many rejected records exist. The default value is 500, which can be represented by an empty string.
Option OUTPUTDELIMITER=
Default
Description
, (comm This is the same as DELIMITER, but defines the a) delimiter when using a transformation to export data. This option works only when exporting data. Normal It specifies the format of the data in the output file. Currently, only Normal format is supported.
OUTPUTFORMAT= NORMAL
OUTPUTHEADER=
<empty> It allows you to use a custom header to export data. This option only works when exporting data. You can use {CRLF} to create more than one row for the header. CATEGORY, TIME {CRLF} Entity, ACCOUTN, PRODUCT {CRLF} PERIODIC The exported file is shown in below. The above example should be placed all in the same one cell in the transformation file. *CATEGORY, TIME *ENTITY, ACCOUNT, PRODUCT *PERIODIC ACTUAL, 1999.JAN, UK, SALES, SEDAN, 1234 ACTUAL, 1999.JAN, UK, SALES, COUPE, 2345
ROUNDAMOUNT=integer
This option specifies the amount of decimal places to which values are to be rounded during the transformation. By default, there is no rounding during data transformation. If you use this option, you must enter a parameter. The integer can be zero or any positive integer.
Option
Default
Description
<empty> This option sets the selection SELECTION = <Dimension1_techname>,<Dimension1_value>;<Dimen rules when you are sion2_techname>,<Dimension2_value> extracting transaction data from an infoprovider. Use the following parameter definitions to set your selection: <Dimension1_techn ame> is the technical name of the dimension. Navigation attributes are not supported. <Dimension1_value > is the value of a condition statement set to this dimension. For one dimension, you can specify only one value. EXAMPLE 0SX_ACCS, US;0SX_CSLC, 1 is the result of the following selection statement: 0SX_ACCS=US and 0SX_CSLC= 1 This option is only used for importing transaction data from an infoprovider. It is illegal when running other packages. By the default value, it is to load all data. NOTE This is used for loading transactional data as is. SKIP= integer 0 (zero) This option specifies the number of lines to skip at the top of a data file. EXAMPLE Use this option to skip header lines during transformation.
Default
Description
empty_s This option causes the tring transformation to skip a line in the data file if it begins with the specified strings. The strings are separated by |, in the above case. If a record contains <text_string> o r <text_string2>, the record is skipped. To include all lines in the transformation, set this option to an empty string. If you use this option, you must enter a parameter.
Option SPECIFICMAPPING=YES/NO
Default No
Description It allows you to turn off the automatic dimension mapping feature. When set to YES, Data Manager does not automatically map dimension names. This option works both for importing and exporting and is especially useful for data export. For example: The columns in the database are CATEGORY, TIME, ENTITY, ACCOUNT, PRODUCT, SIGNEDDATA For importing: The columns in source data are CATEGORY, TIME_NEW, ENTITY_NEW, ACCOUNT_NEW, PRODUCT, SIGNEDDATA If SPECIFICMAPP ING = YES This means, after transformation, all data should have the same columns that you define in the mapping section of the transformation file. You should write mapping rules in the mapping section such as: CATEGORY = CATEGORY TIME = TIME_NEW ENTITY = ENTITY_NEW ACCOUNT = ACCOUNT_NEW PRODUCT = PRODUCT SIGNEDDATA = SIGNEDDATA This means, even when the column names
Option STARTROUTINE
Default
Description
<empty> This option specifies the filter value to call a Start routine used in a BAdI. No This option specifies whether or not to validate records. If this parameter is set to No, the validation does not occur. If this parameter is set to Yes, check the following items before the import: Validate the transformation. Ensure that the members exist. Verify that the record is proper for the Planning and Consolidation application. When this option is enabled, the following rules apply: If a member ID is not mapped, the record associated with the ID is rejected during validation and ignored. If the import file has an extra field that is not mapped, all records are rejected during validation. VALIDATERECORDS is only relevant for importing files. If you are using Planning and Consolidation for the Microsoft platform, ensure that VALIDATERECORDS is set to No when exporting files.
VALIDATERECORDS= No | Yes
Mapping Section The *Mapping section of the transformation file defines how data is mapped to the application. EXAMPLE For a header row and that defines a column named AccountVal, you can map the Account dimension to the Account field from the data file this way: Account = AccountVal The following table details the available mapping functions:
Description This function 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)
*COL(A, B:C)
A = column index in the data file B:C = the start and end positions within the column A:B = the start and end positions within the data row
This function defines a dimension for a subset of a field in the data file. EXAMPLE Account=*COL(3,1:4)
*FCOL(A:B)
This option allows you to define the start and end character columns for each field when you are using Fixed format data files, In the example below, the columns 4 through 7 represent the Account dimension. EXAMPLE Account=*FCOL(4:7)
*MVAL(A:B)
A:B = the start and end or time period Dimension =*MVAL(keyfiguretype1|dim_m columns em1||keyfiguretype2|dim_mem 2||keyfiguretype3|dim_mem3)
This function supports the following types of usage: Allows you to use multiple time period columns EXAMPLE If you have a number of consecutive columns that are based on time periods, you can use this function to include all of them. In the following set of columns, you can use the following command: Time = *MVAL(7:18) Account,Category,DATASR C,entity,IntCo,RptCURRE NCY,JAN,FEB,MAR,APR,MAY ,JUN,JUL,AUG,SEP,OCT,NO V,DEC Using this command requires that you use a time.xls conversion sheet. To see the sample time.xls conversion file, open the existing conversion definition window. If your data does not have a header row, the time periods are named P1, P2, P3,...,PN by default. Allows you to convert multiple key figures to one key figure according to the following guidelines: The dimension must be an existing column in the database. The dimension members in dim_mem must be the noncalculated members of the dimension. The keyfiguretype must be the field name of the source data. You can input the dimension members in the dim_mem with a *STR mapping command, or input any existing mapping command except *IF in the dim_mem, such as *newcol, *col or *newcol(cash)+*col(1), EXAMPLE Source data: Account, Entity, Data source, LC, GC, TC. Cash, SalesItaly, Input, key1, key2, key3 Mapping command: Account=*MKEY(LC|* NEWCOL(Cash_lc)||G C|*COL(1)+*STR(gc) ||TC|*NEWCOL(Cash_
*NEWCOL(A)
A = dimension This function creates a new field with the given value. member EXAMPLE Account=*NEWCOL(Revenue)
*Str(string)
Not applicable This function adds a text string to the members of a column. This function is useful if you need to map data file fields to fields in your database that have the same names, except that the field names contain extra characters (either before or after the name). EXAMPLE Entity = *Str(NE) + *COL(1)
*PAD(colname,length,directi on,letter)
colnam e column name in the source header length the length of the output value directio n the directio n padding the letter to the input value; could be L (left) or R (right) letter the letter to be padded; by default, is a space
This function is used for padding imported fields. EXAMPLE To prepend the letter A to the field time (such as the member ID) use Time = *PAD(time,5,L,A). If the time field contains 123 before the command, the resulting value is AA123. If you change the direction to R, the result is 123AA.
Planning and Consolidation takes the following actions, depending on the results of the condition evaluations: Condit ion1- If this evaluat es toTrue, map using Action1 Condit ion2- If Conditio n1 is "False" and Conditio n2 is "True," map using Action2 Defaul t Action - If both Conditio n1 and Conditio n2 are "False", map using this Default Action Condit ion1an dCondi tion2c an contain multiple items that are added together (using the plus + s ign).
This function allows you to test a series of conditions, and to apply a corresponding action if the condition is true. You cannot join *IF with other commands using a plus sign (+), such as *IF(..)+*COL(1). EXAMPLE Product=*if (Product+ID+Entity = *str(148552) then *str(MHarn);ID(1:1) = *str(C) then *str(XX) ; *str(YY)) Explanation: This means that if the sum of the product, ID, 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. EXAMPLE Examine the following series of data sets, mapping function examples, and result sets to gain an understanding of how the *IF function can be used in various scenarios: Data Set 1: PRODUCT,ID,ENTITY 14,85,52 AB,CD,EF GH,IJ,KL Mapping Function 1: Product=*IF (product+ID+Entity=*Str(148552) then *str(MHarn);ID(1:1) = *str(C) then *str(XX) ; *str(YY)) Result Set 1: PRODUCT,ID,ENTITY MHarn,85,52 AB,XX,EF YY,IJ,KL Data Set 2: Entity, SEntity U1000000, US01 Z2000A01, CA03 K3430000, JP04 Mapping Function 2: Entity=*IF(*col(1,1:1)=U then SEntity;*col(1,1:1)=Z then *col(1,3:6); *STR(ERR)) Result Set 2: Entity, SEntity US01, US01 A01, CA03 ERR, JP04
Conversion Section The *CONVERSION section of the transformation file defines which conversion sheet to use with which dimensions. Use the following syntax to associate a dimension with a conversion sheet: Dimension Name = [COMPANY]WorkbookName[!SheetName] NOTE Items in brackets are optional. The following table describes the variables. Variable Description
DimensionName Either the dimension name to correlate with the conversion file or the keyword Amount. Use the Amount option to specify the conversion file to be used if you specify the ConverAmountWDim option in the*Options section. This allows you to use a formula to scale the input or output values. Workbookname SheetName The name of the conversion file This is the name of the worksheet to use within the conversion file. If a name is not specified, the system assumes the sheet name is Conversion. If [COMPANY] is defined or does not exist, then the Data Manager tries to obtain the conversion file from the Main company Data Manager folder. If [TEAM_NAME] is defined, the Data Manager looks to the corresponding team folder.
[COMPANY]
Activities
To create a new transformation file, select eData New Transformation File. Enter data as required. To edit transformation files, select eData Manage Transformation Files, then browse to the desired file. Enter data as required. To copy a transformation file, open the file you want to copy by selecting Manage Data from the Getting Started - Interface for Excel action pane. Select Maintain transformations Manage existing transformation . Open the desired file and select Copy Transformation File. To copy dimension files between applications, you create a transformation file to map the dimensions. See Sample Transformation File.
Example
In this example, AccountConv.xls is the name of the Account dimension conversion file. Account = AccountConv.xls Amount = AccountConv.xls (Use the Amount keyword with the ConvertAmountWDim transformation option.) Account = AccountConv.xls!newaccount (This conversion file should be in the company folder.) Account = [COMPANY]AccountConv.xls!newaccount (This conversion file should be in the company folder.) Account = [AdminTeam]AccountConv.xls!newaccount (This conversion file should be located in the corresponding folder of AdminTeam.)
More Information
Validating Transformation Files Importing and Exporting Data Having Multiple Key Figures
BAdI for Start Routine and End Routine Any software coding and/or code lines / strings ("Code") included in this documentation are only examples and are not intended to be used in a productive system environment. The Code is only intended to better explain and visualize the syntax and phrasing rules of certain coding. SAP does not warrant the correctness and completeness of the Code given herein, and SAP shall not be liable for errors or damages caused by the usage of the Code, except if such damages were caused by SAP intentionally or by its gross negligence.
Source Application
Category Account Entity Time Rptcurrency Intco Datasrc
Target Application
Cat Acc Ent Tim Currency Int Dat
To map the dimensions from the source application to the target application, you can create a transformation file as follows: *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
More Information
Data Transformation Maintenance
Any software coding and/or code lines / strings ("Code") included in this documentation are only examples and are not intended to be used in a productive system environment. The Code is only intended to better explain and visualize the syntax and phrasing rules of certain coding. SAP does not warrant the correctness and completeness of the Code given herein, and SAP shall not be liable for errors or damages caused by the usage of the Code, except if such damages were caused by SAP intentionally or by its gross negligence.
Prerequisites
The ValidateRecords keyword has been set to Yes in the transformation file. When set to Yes, the system validates the data during the process of validating transformation file. The system also checks to see if the converted member exists in the current dimension. If it does not exist, the record is rejected. When the ValidateRecords keyword is set to No, the system does not perform this checking during the transformation process. If some members are converted incorrectly, the system rejects the data during writing process.
Features
After running a transformation file validation, you can view a status log of successful and unsuccessful tasks, the output file of the transformed data, and any rejected data. You can save the status log information in a Microsoft Excel workbook or a text file.
Activities
To validate transformation files, choose Validate transformation definitions from the Transformation Maintenance Options action pane, select a data type, and select a data file. To change the information displayed in the status log, choose the appropriate view option. To save the information displayed in the status log, choose Save in Excel Workbook or Save as Text File.
Prerequisites
The dimension must exist in the application. The passed dimension members in dim_mem must be the noncalculated (CALC = N) members of the dimension. The keyfiguretype must be the field name of the source data.
Procedure
1. Access the Launch Page and log on to to the ApShell application set.
2. Choose eData New transformation file . 3. Map the multiple key figures to the single key figure using a keyword in the mapping section of the transformation file. 4. Save the transformation file. 5. Run the package and choose the transformation file.
Example
Example 1: Source data: Account, Entity, Data source, LC, GC, TC. Cash, SalesItaly, Input, key1, key2, key3 Mapping command: Account =*MVAL(LC|*STR(Cash_lc)||GC|*COL(1)+*STR(gc)||TC|*STR(Cash_tc)) Target data: Account, Entity, Data source, keyfigure Cash_lc, SalesItaly, Input, key1 Cash_gc, SalesItaly, Input, key2 Cash_tc, SalesItaly, Input, key3 Example 2: Source data: Account, Entity, Data source, LC, GC, TC. Cash, SalesItaly, Input, key1, key2, key3 Mapping command: Keyfiguretype =*MVAL(LC|*NEWCOL(LC)||GC|*STR(GC)||TC|*NEWCOL(TC)) Target data: Account, Entity, Data source, Keyfiguretype, keyfigure Cash, SalesItaly, Input, LC, key1 Cash, SalesItaly, Input, GC, key2 Cash, SalesItaly, Input, TC, key3 Any software coding and/or code lines / strings ("Code") included in this documentation are only examples and are not intended to be used in a productive system environment. The Code is only intended to better explain and visualize the syntax and phrasing rules of certain coding. SAP does not warrant the correctness and completeness of the Code given herein, and SAP shall not be liable for errors or damages caused by the usage of the Code, except if such damages were caused by SAP intentionally or by its gross negligence.
Activities
1. Create a BAdI implementation for UJD_ROUTINE in transaction SE19. 2. Enter the filter of the BAdI. The filter value is used in the transformation file to call the BAdI implementation. 3. Create a transformation file.
4. Enter the BAdI filter value in the *OPTIONS section. 5. Define a package to use the transformation file. 6. Run the package.
Example
Transformation file *OPTIONS FORMAT = DELIMITED HEADER = YES DELIMITER = SKIP = 0 SKIPF = CREDITNEGATIVE=NO CONVERTAMOUNTWDIM= MAXREJECTCOUNT= VALIDATERECORDS=YES STARTROUTINE = BADI_FILTER1 ENDROUTINE = BADI_FILTER2 *MAPPING cat=category Acc=Account Ent = Entity Tim=time Currency=Rptcurrency int=intco dat=Datasrc *CONVERSION
More Information
Steps to Activate BAdI Implementations in the Business Address Services application help available on SAP Service Marketplace Any software coding and/or code lines / strings ("Code") included in this documentation are only examples and are not intended to be used in a productive system environment. The Code is only intended to better explain and visualize the syntax and phrasing rules of certain coding. SAP does not warrant the correctness and completeness of the Code given herein, and SAP shall not be liable for errors or damages caused by the usage of the Code, except if such damages were caused by SAP intentionally or by its gross negligence.
Procedure
1. Access the Launch Page and log on to the application set. 2. On the action pane, choose Manage data. 3. On the action pane, choose Maintain data management Manage packages (organize list) .
4. Select a package and choose Modify Package. 5. Choose the View package browse icon. 6. Choose <Package name> Dynamic Package Script (MODIFYSCRIPT) PROMPT. 7. Select the Type cell and select a prompt. Enter data as required. NOTE You cannot select or deselect the Activate option until you save the package. 8. Choose the Advanced button to change the script directly (see Defining Dynamic Script Instructions). 9. Save the package.
More Information
Process Chains Delivered with ApShell
More Information
Predefined Constants
INFO Instructions
An INFO instruction defines and assigns a value to a script variable. It is not an executable instruction nor does it affect a package directly.
Features
The syntax for an INFO instruction is: INFO("variablename",value) where variable name is the name of the variable value is the value of the variable Instead of assigning a value directly to a task, you can replace the value (or part of it) with the name of a variable defined in an INFO instruction. At runtime, the task replaces the name of all INFO variables found in all executable instructions with the value of those variables before executing the executable instructions. EXAMPLE The following example illustrates how to define a variable with an INFO instruction and how to use it in another instruction such as TASK. The parameters %EQU% and %TAB% are passed to the process type/CPMB/ALLOCATION_LOGIC, which is defined in the process chain /CPMB/ALLOCATION. INFO(%EQU%,=) INFO(%TAB%,;) TASK(/CPMB/ALLOCATION_LOGIC,TAB,%TAB%)
TASK(/CPMB/ALLOCATION_LOGIC,EQU,%EQU%) RECOMMENDATION We recommend the use of expressions that are enclosed between easily identifiable characters such as the % character (%VARIABLE%, for example), This makes the script more readable and less subject to errors when the substitutions are performed. NOTE All system generated INFO variables comply with this practice. For a list of predefined constants list, see Predefined Constants. Any software coding and/or code lines / strings ("Code") included in this documentation are only examples and are not intended to be used in a productive system environment. The Code is only intended to better explain and visualize the syntax and phrasing rules of certain coding. SAP does not warrant the correctness and completeness of the Code given herein, and SAP shall not be liable for errors or damages caused by the usage of the Code, except if such damages were caused by SAP intentionally or by its gross negligence.
Predefined Constants
The following constants are in use by the system, which you can use within the context of an INFO instruction: Predefined Constant %ACCOUNT_DIM% %APP% %APPBINAME% %APPLIST% %APPSET% %CATEGORY_DIM% %CURRENCY_DIM% %DATASRC_DIM% %DIMS% %ENTITY_DIM% %GROUP_DIM% Description
Returns dimension name where dimension type = A. Returns current application name. Returns current application technical name Returns a list of applications. Returns current application set name. Returns dimension name where dimension type = C. Returns dimension name where dimension type = R. Returns dimension name where dimension type = D. Returns list of dimensions based on the application. Returns dimension name where dimension type = E. Returns dimension name where dimension type = G or (type = U and has an attribute named GROUP_CURRENCY) Returns the file number Returns dimension name where dimension type = I.
%INCREASENO% %INTCO_DIM%
Return package ID Returns package size Returns dimension name where dimension type = S. Returns the temp folder path. The path returned has the trailing back slash (\) appended to it. Returns dimension name where dimension time = T. Returns full user name (with domain name).
%TIME_DIM% %USER%
Any software coding and/or code lines / strings ("Code") included in this documentation are only examples and are not intended to be used in a productive system environment. The Code is only intended to better explain and visualize the syntax and phrasing rules of certain coding. SAP does not warrant the correctness and completeness of the Code given herein, and SAP shall not be liable for errors or damages caused by the usage of the Code, except if such damages were caused by SAP intentionally or by its gross negligence.
Task Instructions
You can pass parameters to the process types defined in a process chain by using the TASK instruction. Only the process types that are defined for Planning and Consolidation process chains can be used. The parameters need to be defined in the process chain as well.
Example
The process type is /CPMB/ALLOCATION_LOGIC and the parameter is %TAB%. INFO(%TAB%,;) TASK(/CPMB/ALLOCATION_LOGIC,TAB,%TAB%) Any software coding and/or code lines / strings ("Code") included in this documentation are only examples and are not intended to be used in a productive system environment. The Code is only intended to better explain and visualize the syntax and phrasing rules of certain coding. SAP does not warrant the correctness and completeness of the Code given herein, and SAP shall not be liable for errors or damages caused by the usage of the Code, except if such damages were caused by SAP intentionally or by its gross negligence.
Prompt Commands
A prompt command generates customized dialog boxes that prompt users for answers. By completing these dialog boxes, a user can select such things as the files to upload, the data to export, or the target applications for selected data. When multiple prompt commands are entered in the same script, the system combines all of the prompts into one dialog box. This rule applies to all prompt commands asking for the selection of a file, a delimiter, or text, but not to the COPYMOVE and SELECT prompts. The COPYMOVE and SELECT prompts are presented individually, with as many dialog boxes as prompts are found in the script. All file selection prompts return the name of the selected file with the complete path. If the user leaves a selection field blank in a SELECT or COPYMOVE dialog box, the system assumes all members for that dimension; the system does not insert a range for the dimension in the returned statement.
Prompt commands are dependent on the variables defined in the process chains delivered with Planning and Consolidation. For information about the parameters you can change, see Process Chains Delivered with ApShell. Prompt commands are stored by package. Therefore, you can create multiple packages based on the same process chain template and provide different prompts to users for each package.
More Information
CHECKBOX Prompt() Command CHECKBOXGROUP Prompt() Command CHECKBOXNO Prompt() Command COMBOBOX Prompt() Command CONVERSION Prompt() Command COPYBOXNO Prompt() Command COPYBOXYES Prompt() Command COPYMOVE Prompt() Command COPYMOVEINPUT Prompt() Command DELIMITER Prompt() Command DIMENSIONMEMBER Prompt() Command DIMENSIONNAME Prompt() Command HIERARCHYSELECTION Prompt() Command INFILE Prompt() Command INFILES Prompt() Command LOGICFILE Prompt() Command MASTERSELECTION Prompt() Command MEASURELIST Prompt() Command MEMBERFROMTOINPUT Prompt() Command MESSAGE Prompt() Command OUTFILE Prompt() Command RADIOBUTTON Prompt() Command SELECT Prompt() Command SELECTINPUT Prompt() Command SELECTION Prompt() Command SELECTIONFILE Prompt() Command TEXT Prompt() Command TRANSFORMATION Prompt() Command
The Planning and Consolidation process chains do not require any modification. You can parameterize and execute them using packages. When creating a Data Manager package, you choose a Planning and Consolidation process chain (see Adding and Modifying Packages).
More Information
Package Properties Process Chains Delivered with ApShell Defining Dynamic Script Instructions
Package Properties
The following table describes the fields you must complete when adding or editing packages. If any of these fields are incorrect or left blank, the package generates an error when the package is executed. Field PackageType Description Choose Process Chain. There is currently only one type of package.
Process Chain Select the Planning and Consolidation process chain. Dynamic Script The dynamic script defines the user interface of the package. Dynamic scripts are delivered by default, which you can modify (see Modifying the Dynamic Script of a Package).
PackageName The name of the package. Group Description The folder group to which the package is added. A description of the package.
Task Type
You can control who has access to run the package. If you select Admin Package, you are defining this package as an administrative package. Only users who are Planning and Consolidation Administrators can see and run the package. A non-administrative user cannot see or run the package. If you select User Package, users who have been assigned the Execute Data Management task security privilege can execute the task.
More Information
Adding and Modifying Packages
Example
PROMPT(CHECKBOX,%CheckBox%,"Test for CheckBox",1) Any software coding and/or code lines / strings ("Code") included in this documentation are only examples and are not intended to be used in a productive system environment. The Code is only intended to better explain and visualize the syntax and phrasing rules of certain coding. SAP does not warrant the correctness and completeness of the Code given herein, and SAP shall not be liable for errors or damages caused by the usage of the Code, except if such damages were caused by SAP intentionally or by its gross negligence.
Default Value
The default value can be 0 (unchecked by default) or 1 (checked by default). NOTE Separate multiple values with commas.
Example
PROMPT(CHECKBOXGROUP,%CHECKGROUP%,"Text for CheckBoxGroup",{1,0,1},{"ch1","ch2","ch3"},,) Any software coding and/or code lines / strings ("Code") included in this documentation are only examples and are not intended to be used in a productive system environment. The Code is only intended to better explain and visualize the syntax and phrasing rules of certain coding. SAP does not warrant the correctness and completeness of the Code given herein, and SAP shall not be liable for errors or damages caused by the usage of the Code, except if such damages were caused by SAP intentionally or by its gross negligence.
Example
PROMPT(CHECKBOXNO,%CHECKBOXNO%,"Test for CheckBoxNo",,,,) Any software coding and/or code lines / strings ("Code") included in this documentation are only examples and are not intended to be used in a productive system environment. The Code is only intended to better explain and visualize the syntax and phrasing rules of certain coding. SAP does not warrant the correctness and completeness of the Code given herein, and SAP shall not be liable for errors or damages caused by the usage of the Code, except if such damages were caused by SAP intentionally or by its gross negligence.
Parameter
Description
COMBOBOX combo box [variable] [label] The name of the returned variable The text to display to the user
[combo style] The style of combo box 0 the item the user selects should be one of the items in the select items) Any number other than 0 the item the user selects can be any value, which does not need to be one of the items in the select items [default value] [dimensions] The preselected choice
Category, Time, Entity %DIMS% is the dimension list in the current application
The default value determines the preselected choice (in terms of order, starting with 0). NOTE Separate multiple values with commas.
Example
PROMPT(COMBOBOX,%COMOBOBOX%,"Text for Combobox:",0,t2,t1,t2) Any software coding and/or code lines / strings ("Code") included in this documentation are only examples and are not intended to be used in a productive system environment. The Code is only intended to better explain and visualize the syntax and phrasing rules of certain coding. SAP does not warrant the correctness and completeness of the Code given herein, and SAP shall not be liable for errors or damages caused by the usage of the Code, except if such damages were caused by SAP intentionally or by its gross negligence.
[path]
Example
PROMPT(CONVERSION,%CONVERSION%,"Text for Conversion:",Excel files (*.xls), *.xls, All files(*.*),*.*,,Import.xls) Any software coding and/or code lines / strings ("Code") included in this documentation are only examples and are not intended to be used in a productive system environment. The Code is only intended to better explain and visualize the syntax and phrasing rules of certain coding. SAP does not warrant the correctness and completeness of the Code given herein, and SAP shall not be liable for errors or damages caused by the usage of the Code, except if such damages were caused by SAP intentionally or by its gross negligence.
Example
PROMPT(CHECKBOXNO,%CHECKBOXNO%,"Test for CheckBoxNo",,,,) Any software coding and/or code lines / strings ("Code") included in this documentation are only examples and are not intended to be used in a productive system environment. The Code is only intended to better explain and visualize the syntax and phrasing rules of certain coding. SAP does not warrant the correctness and completeness of the Code given herein, and SAP shall not be liable for errors or damages caused by the usage of the Code, except if such damages were caused by SAP intentionally or by its gross negligence.
Example
PROMPT(CHECKBOXNO,%CHECKBOXNO%,"Test for CheckBoxNo",,,,)
The name of the second returned variable. The text to display to the user. The dimensions to select from.
EXAMPLE PROMPT(COPYMOVE,%SELECTION%,%TOSELECTION%,"Test for COPYMOVE",%DIMS%,) Any software coding and/or code lines / strings ("Code") included in this documentation are only examples and are not intended to be used in a productive system environment. The Code is only intended to better explain and visualize the syntax and phrasing rules of certain coding. SAP does not warrant the correctness and completeness of the Code given herein, and SAP shall not be liable for errors or damages caused by the usage of the Code, except if such damages were caused by SAP intentionally or by its gross negligence.
[variable]
%TOSELECTION%
Please select a file.. Category, Time, Entity %DIMS% is the dimension list in current application.
EXAMPLE PROMPT(COPYMOVEINPUT,%SELECTION%,%TOSELECTION%,"Test for COPYMOVEINPUT",%DIMS%,) Any software coding and/or code lines / strings ("Code") included in this documentation are only examples and are not intended to be used in a productive system environment. The Code is only intended to better explain and visualize the syntax and phrasing rules of certain coding. SAP does not warrant the correctness and completeness of the Code given herein, and SAP shall not be liable for errors or damages caused by the usage of the Code, except if such damages were caused by SAP intentionally or by its gross negligence.
If you are using Planning and Consolidation for the Microsoft platform, you need to distinguish between the delimiters for input and output. You do this in the Data Manager Dynamic Script editor by appending a command similar to the following: TASK(CONVERT data,DELIMITERFORINPUT,%DELIMITER%).
Example
PROMPT(DELIMITER,%DELIMITER%,"Text for delimiter") Any software coding and/or code lines / strings ("Code") included in this documentation are only examples and are not intended to be used in a productive system environment. The Code is only intended to better explain and visualize the syntax and phrasing rules of certain coding. SAP does not warrant the correctness and completeness of the Code given herein, and SAP shall not be liable for errors or damages caused by the usage of the Code, except if such damages were caused by SAP intentionally or by its gross negligence.
[variable]
EXAMPLE PROMPT(DIMENSIONMEMBER,% DIMENSIONMEMBER%,"Select a dimension","Select members","%DIMS%") Any software coding and/or code lines / strings ("Code") included in this documentation are only examples and are not intended to be used in a productive system environment. The Code is only intended to better explain and visualize the syntax and phrasing rules of certain coding. SAP does not warrant the correctness and completeness of the Code given herein, and SAP shall not be liable for errors or damages caused by the usage of the Code, except if such damages were caused by SAP intentionally or by its gross negligence.
[combo style]
The style of combo box 0 The item user selects should be one of the item in the select items Any number that is not 0 The item user selects can be any value, which does not need to be one of the item in the select items. The preselected choice
EXAMPLE PROMPT(DIMENSIONNAME,%DIMNAME%,"Test for DIMENSIONNAME:",TIME, "%DIMS%") Any software coding and/or code lines / strings ("Code") included in this documentation are only examples and are not intended to be used in a productive system environment. The Code is only intended to better explain and visualize the syntax and phrasing rules of certain coding. SAP does not warrant the correctness and completeness of the Code given herein, and SAP shall not be liable for errors or damages caused by the usage of the Code, except if such damages were caused by SAP intentionally or by its gross negligence.
Used to prompt for selecting an info object and the hierarchy selection when importing a hierarchy from an SAP NetWeaver InfoObject. Syntax: PROMPT (HIERARCHYSELECTION,[variable],[the second variable],[label]]) Where HIERARCHYSELECTION [variable] [the second variable] [label] Means Select info object and selection Variable for the selected info object The second variable for the selection The text to display to the user. Default Value n/a %INFOOBJECT% %HIERARCHYSELECTION% Set selection.
EXAMPLE PROMPT(HIERARCHYSELECTION,%INFOOBJECT%,%SELECTION%,"Test for HIERARCHYSELECTION") Any software coding and/or code lines / strings ("Code") included in this documentation are only examples and are not intended to be used in a productive system environment. The Code is only intended to better explain and visualize the syntax and phrasing rules of certain coding. SAP does not warrant the correctness and completeness of the Code given herein, and SAP shall not be liable for errors or damages caused by the usage of the Code, except if such damages were caused by SAP intentionally or by its gross negligence.
EXAMPLE PROMPT(HIERARCHYSELECTION,%INFOOBJECT%,%SELECTION%,"Test for HIERARCHYSELECTION") Any software coding and/or code lines / strings ("Code") included in this documentation are only examples and are not intended to be used in a productive system environment. The Code is only intended to better explain and visualize the syntax and phrasing rules of certain coding. SAP does not warrant the correctness and completeness of the Code given herein, and SAP shall not be liable for errors or damages caused by the usage of the Code, except if such damages were caused by SAP intentionally or by its gross negligence.
The INFILE prompt command supports file names stored on the Application Server and FTP. The qualified path and file name need to be entered, for example, \uxcikf1\usr\sap\TEMP\file.csv.
Example
PROMPT(INFILE,%FILE%,"Test for INFILE:",Data files (*.txt), *.txt, All files(*.*),*.*,) Any software coding and/or code lines / strings ("Code") included in this documentation are only examples and are not intended to be used in a productive system environment. The Code is only intended to better explain and visualize the syntax and phrasing rules of certain coding. SAP does not warrant the correctness and completeness of the Code given herein, and SAP shall not be liable for errors or damages caused by the usage of the Code, except if such damages were caused by SAP intentionally or by its gross negligence.
The INFILE prompt command supports file names stored on the Application Server and FTP. The qualified path and file name need to be entered, for example, \uxcikf1\usr\sap\TEMP\file.csv.
Example
PROMPT(INFILE,%FILE%,"Test for INFILE:",Data files (*.txt), *.txt, All files(*.*),*.*,) Any software coding and/or code lines / strings ("Code") included in this documentation are only examples and are not intended to be used in a productive system environment. The Code is only
intended to better explain and visualize the syntax and phrasing rules of certain coding. SAP does not warrant the correctness and completeness of the Code given herein, and SAP shall not be liable for errors or damages caused by the usage of the Code, except if such damages were caused by SAP intentionally or by its gross negligence.
EXAMPLE PROMPT(INFILES,%FILE%,"Test for INFILES:", All files(*.*),*.*,) Any software coding and/or code lines / strings ("Code") included in this documentation are only examples and are not intended to be used in a productive system environment. The Code is only intended to better explain and visualize the syntax and phrasing rules of certain coding. SAP does not warrant the correctness and completeness of the Code given herein, and SAP shall not be liable for errors or damages caused by the usage of the Code, except if such damages were caused by SAP intentionally or by its gross negligence.
EXAMPLE PROMPT(INFILES,%FILE%,"Test for INFILES:", All files(*.*),*.*,) Any software coding and/or code lines / strings ("Code") included in this documentation are only examples and are not intended to be used in a productive system environment. The Code is only intended to better explain and visualize the syntax and phrasing rules of certain coding. SAP does not warrant the correctness and completeness of the Code given herein, and SAP shall not be liable for
errors or damages caused by the usage of the Code, except if such damages were caused by SAP intentionally or by its gross negligence.
EXAMPLE PROMPT(LOGICFILE,%LOGICFILE%,"Test for LOGICFILE:", Logic files(*.lgx),*.lgx,) Any software coding and/or code lines / strings ("Code") included in this documentation are only examples and are not intended to be used in a productive system environment. The Code is only intended to better explain and visualize the syntax and phrasing rules of certain coding. SAP does not warrant the correctness and completeness of the Code given herein, and SAP shall not be liable for errors or damages caused by the usage of the Code, except if such damages were caused by SAP intentionally or by its gross negligence.
Used to prompt for selecting measures when exporting transaction data. The measures are: PERIODIC, YTD, QTD, and SIGNEDDATA. You can select SIGNEDDATA or any combination of PERIODIC, YTD, and QTD. Syntax: PROMPT (MEASURELIST,[variable],[label]) Where MEASURELIST [variable] [label] Means Select measures Variable The text to display to the user Default Value n/a %MEASURES% Select measures.
Example
PROMPT(MEMBERFROMTOINPUT,%SOURCE_TM%,%TARGET_TM%,Enter Source and Target Time,%TIME_DIM%) Any software coding and/or code lines / strings ("Code") included in this documentation are only examples and are not intended to be used in a productive system environment. The Code is only intended to better explain and visualize the syntax and phrasing rules of certain coding. SAP does not warrant the correctness and completeness of the Code given herein, and SAP shall not be liable for errors or damages caused by the usage of the Code, except if such damages were caused by SAP intentionally or by its gross negligence.
Example
PROMPT(MESSAGE,"When this package is running, end user functionality will be affected: Data cannot be sent to the database or incorrect numbers can be retrieved from the database")
Any software coding and/or code lines / strings ("Code") included in this documentation are only examples and are not intended to be used in a productive system environment. The Code is only intended to better explain and visualize the syntax and phrasing rules of certain coding. SAP does not warrant the correctness and completeness of the Code given herein, and SAP shall not be liable for errors or damages caused by the usage of the Code, except if such damages were caused by SAP intentionally or by its gross negligence.
EXAMPLE PROMPT(OUTFILE,%FILE%,"Test for OUTFILE:",Data files (*.txt), *.txt, All files(*.*),*.*,) Any software coding and/or code lines / strings ("Code") included in this documentation are only examples and are not intended to be used in a productive system environment. The Code is only intended to better explain and visualize the syntax and phrasing rules of certain coding. SAP does not warrant the correctness and completeness of the Code given herein, and SAP shall not be liable for errors or damages caused by the usage of the Code, except if such damages were caused by SAP intentionally or by its gross negligence.
Example
PROMPT(RADIOBUTTON,%CHECKLCK%,"Select whether to check work status settings when importing data.",1,{"Yes, check for work status settings before importing","No, do not check work status settings"},{"1","0"}) Any software coding and/or code lines / strings ("Code") included in this documentation are only examples and are not intended to be used in a productive system environment. The Code is only intended to better explain and visualize the syntax and phrasing rules of certain coding. SAP does not
warrant the correctness and completeness of the Code given herein, and SAP shall not be liable for errors or damages caused by the usage of the Code, except if such damages were caused by SAP intentionally or by its gross negligence.
Example
PROMPT(SELECT,%SELECTION%,,"Select the members to export","CATEGORY,ENTITY") Any software coding and/or code lines / strings ("Code") included in this documentation are only examples and are not intended to be used in a productive system environment. The Code is only intended to better explain and visualize the syntax and phrasing rules of certain coding. SAP does not warrant the correctness and completeness of the Code given herein, and SAP shall not be liable for errors or damages caused by the usage of the Code, except if such damages were caused by SAP intentionally or by its gross negligence.
Activities
%DIMS% is the dimension list in the current application. The value can be ACCOUT, ENTITY, TIME. %SELECTION% is the result that the user selects in the Run Package dialog box. PROMPT(SELECTINPUT,,,,"%DIMS%") %SELECTION% is the result that the user selects in the Run Package dialog box. The script can be the following:
PROMPT(SELECTINPUT,%SELECTION%,,,"%DIMS%") %DIMS% creates the screen, and the selected result is saved in %SELECTION%. Without %selection%, you use %SELECTION% as the default. Therefore, you can also write the script asPROMPT(SELECTINPUT,%ANYNAME%,,,"%DIMS%"), then use %ANYNAME% in the task commands.
Example
If you need only one SELECTINPUT prompt command, create the package script as follows: PROMPT(SELECTINPUT,%SOURCEENTITY%,,"Enter Source Entity","%ENTITY_DIM%") TASK(/CPMB/ALLOCATION_LOGIC,SELECTION,%SOURCEENTITY%) If you need more than one SELECTINPUT prompt command, create the package script as follows: PROMPT(SELECTINPUT,%SOURCEENTITY%,,"Enter Source Entity","%ENTITY_DIM%") PROMPT(SELECTINPUT,%TARGETENTITY%,,"Enter Target Entity","%ENTITY_DIM%") INFO(%EQU%,=) INFO(%TAB%,;) TASK(/CPMB/ALLOCATION_LOGIC,TAB,%TAB%) TASK(/CPMB/ALLOCATION_LOGIC,EQU,%EQU%) TASK(/CPMB/ALLOCATION_LOGIC,REPLACEPARAM,ASARENT%EQU%%ASARENT%%TAB%SOURCE%EQU %%SOURCEENTITY%%TAB %TARGET%EQU%%TARGETENTITY%) TASK(/CPMB/ALLOCATION_LOGIC,MEMBERSELECTION,SOURCE%EQU%%SOURCEENTITY%%TAB %TARGET%EQU%%TARGETENTITY%) You can hardcode the selection using INFO commands, as follows: INFO(%DIMVALUE%,E=24) INFO(%SELECTION%, /APP123/PLANNING/PrivatePublications/I045795/TempFiles/FROM.TMP@@@SAVE@@@@@@E XPAND@@@|DIMENSION:ENTITY|A1000|DIMENSION:CATEGORY||DIMENSION:TIME||) INFO(%DIMVALUE%,E=24) means that 24 different entity members are selected in a group. In the import package, the package_size specifies how large each group is. In the export, this value is used to specify the group to improve the export performance. Any software coding and/or code lines / strings ("Code") included in this documentation are only examples and are not intended to be used in a productive system environment. The Code is only intended to better explain and visualize the syntax and phrasing rules of certain coding. SAP does not warrant the correctness and completeness of the Code given herein, and SAP shall not be liable for errors or damages caused by the usage of the Code, except if such damages were caused by SAP intentionally or by its gross negligence.
[mask]
EXAMPLE PROMPT(SELECTION,%SELECTION%,"Test for SELECTION:",Data files (*.txt), *.txt, All files(*.*),*.*,) Any software coding and/or code lines / strings ("Code") included in this documentation are only examples and are not intended to be used in a productive system environment. The Code is only intended to better explain and visualize the syntax and phrasing rules of certain coding. SAP does not warrant the correctness and completeness of the Code given herein, and SAP shall not be liable for errors or damages caused by the usage of the Code, except if such damages were caused by SAP intentionally or by its gross negligence.
EXAMPLE PROMPT(SELECTIONFILE,%FILE%,"Test for SELECTIONFILE:",All files(*.*),*.*,) Any software coding and/or code lines / strings ("Code") included in this documentation are only examples and are not intended to be used in a productive system environment. The Code is only intended to better explain and visualize the syntax and phrasing rules of certain coding. SAP does not warrant the correctness and completeness of the Code given herein, and SAP shall not be liable for errors or damages caused by the usage of the Code, except if such damages were caused by SAP intentionally or by its gross negligence.
This is the function name. The name of the returned variable The text to display to the user
[PWD]
Use this variable when you want to display the password as asterisks (*****) in the text box.
None
[VALIDATE LIST]
This parameter contains a list of items used to validate the input text. The None delimiter must be a comma, and the list must close with a double quotation.
Example
Example 1 This function shows a text box with the label Application list:. The system validates the user entry against an application list. PROMPT(TEXT,%APPLIST%,"Application list:",,"%APP_LIST%") Example 2 This function shows a text box with the label Dimension list:. The system validates the user entry against a dimension list. PROMPT(TEXT,%DIMLIST%,"Dimension list:",,"%DIMS%") Example 3 This function shows a text box with the label Alphabet list:. The system validates the user entry against A,B,C,D,E. PROMPT(TEXT,%AlphabetList%,"Alphabet list:",,"A,B,C,D,E") Example 4 This function shows a text box with a password value shown in asterisks (*). PROMPT(TEXT,%Password%,"Please enter your password",PWD) CAUTION All parameter values containing the string password, for example, %Password1%, %password2% or %FtpPassword% are masked in the log. If you use PSD as the parameter name for passwords, the password values are not masked in the log. For instance, in PROMPT(TEXT,%PSD%,"Please enter your password",PWD)), the value for the parameter names %Password1%, %password2%, and %FtpPassword%are masked. Any software coding and/or code lines / strings ("Code") included in this documentation are only examples and are not intended to be used in a productive system environment. The Code is only intended to better explain and visualize the syntax and phrasing rules of certain coding. SAP does not warrant the correctness and completeness of the Code given herein, and SAP shall not be liable for errors or damages caused by the usage of the Code, except if such damages were caused by SAP intentionally or by its gross negligence.
[label]
Please select a transformation file. Excel files (*.xls), *.xls All files(*.*),*.* import.xls.
[mask]
The file types to display in the selected folder The default file name
Example
PROMPT(TRANSFORMATION,%TRANSFORMATION %,"Text for Transformation:",Excel files (*.xls), *.xls, All files(*.*),*.*,,Import.xls) Any software coding and/or code lines / strings ("Code") included in this documentation are only examples and are not intended to be used in a productive system environment. The Code is only intended to better explain and visualize the syntax and phrasing rules of certain coding. SAP does not warrant the correctness and completeness of the Code given herein, and SAP shall not be liable for errors or damages caused by the usage of the Code, except if such damages were caused by SAP intentionally or by its gross negligence.
Currency Conversions
Currency conversions typically run by default when default logic runs. You can also create a new logic file to run a currency conversion. You run this rule by calling the stored procedure SPRUNCONVERSION from any logic file. *RUN_STORED_PROCEDURE=SPRUNCONVERSION(Parameters list) Example: *RUN_STORED_PROCEDURE=SPRUNCONVERSION([%APP%],[%CATEGORY_SET%],[%CURRENCY_SET %],[GLOBAL],[%SCOPETABLE%],[%LOGTABLE%]) Parameter Application Category Currency Rateentity Description The application ID. The category ID. We currently support the handling of only one category at a time. The currency, blank, or Multi. The default Entity member for the Rate application.
%SCOPETABLE% %SCOPETABLE% is a variable used by the system to define the name of a logic table. %LOGTABLE% %LOGTABLE% is a variable used by the system to define the name of a Log table.
The stored procedure SPRUNCONVERSION scans all records found in the selected region of data. It translates them according to the RATETYPE property assigned to the ACCOUNT specified in each record, based on the mechanism that all ACCOUNTS are translated according to the definitions contained in the table of parameters called clcFXTRANS. For information on required properties of the Category and Data Source dimensions, see Dimensions Setup for Consolidations. The following table describes the fields for the currency conversion rules table.
Field name
Description
Account rate The currency conversion type, for example, AVG, END, HIST, taken from the Account type dimension's RATETYPE property. This is the main driving field, controlling the translation rule to apply to a given account. NOTE One RATETYPE may generate more than one translated value. This can be defined by entering more than one entry with the same RATETYPE in the business rule interface for currency rules. Source flow This field, combined with the 'Account rate type' field, completes the definition of the criteria that drive the applicability of a given rule. In other words, the instruction can be read as follows: If the account has such RATETYPE and the FLOW is such and such, then apply this rule. This field may contain the following values: A valid base level or parent member ID from the FLOW dimension A list of members of the FLOW dimension, as defined filtering the members using a value of the DIMLIST property (or any property whose name begins with DIMLIST)
For information about the Flow dimension, see Setting up a legal consolidation application set. Destination account Destination flow Formula The account that stores the specific conversion. If empty, it is the same as the source account's member. The specific Accdetail member where translations are stored. If empty, then it is the same as the source subtable member. This field can contain any arithmetic expression combining any defined RATE as per the ACCOUNT dimension of the RATE application. All rates with the RATETYPE property value of FX TRANS can be used. If checked, force the generation of an additional record where the member of the destination FLOW is the closing balance. The closing balance member of the FLOW dimension is identified as the member with the property FLOW_TYPE = CLOSING. This field should only be used in a YTD application for the cases in which the currency conversion should be performed on the PERIODIC values and not on the YTD values. If the box is checked, the engine calculates the difference between current period and prior period amounts, and it applies the rate specified in RATE_FORMULA field. At the end, the result is added back to prior period's value as written in current period. This field can be used to enforce a given set of rules to only apply to a desired set of ENTITIES. If this field has a value, the rule is only applied to the entities having a matching value in a similarly named property (FX_TYPE) of the ENTITY dimension. A short description for this rule.
Force closing
Apply to periodic
Entity FX type
Remarks
Formula field
In the FORMULA field, the rates must be enclosed in square brackets:
[END] [END] [AVG] The OPENING value of any rate can also be specified adding the prefix OPE to the rate itself. Examples: [OPEEND] [END] [OPEAVG] These OPENING rates do not need to exist in the RATE cube. For example, if there is an [END] rate, the currency translation also automatically recognizes a rate called [OPEEND], which simply corresponds to the [END] rate of the OPENING period (typically last period of last year). In addition, the RATE_FORMULA field supports the following keywords: [AS_IS]: Leave untouched a value already existing in the destination currency. The keyword cannot be combined with other rates in the same line. The only valid exception is the format [AS_IS]*-1. [COPYLC]: This correspond to applying a rate of 1 in the translation.
Prerequisites
The application set used for consolidations has been created and its parameters set up.
Features
You set up consolidation dimensions by: Setting up dimension library dimensions Updating dimension properties Updating dimension members and property values
For a rate application that contains exchange rates, the following dimension types are required: R_Acct (A) C_Category (C) R_Entity (E) InputCurrency(R) Time (T)
For an ownership application that stores ownership details, the following dimension types are required: O_Acct (A) C_Category (C) Entity (E) Time (T) IntCo (I) Groups (R)
FX_SOURCE_CATEGORY OPENING_PERIOD OPENING_YEAR RATE_CATEGORY RATE_PERIOD RATE_YEAR YEAR C_Acct Property DIMLIST ELIMACC IC_MATCH VARIATION O_Acct Property IS_Input Entity Property Elim FX_Type IntCo Owner C_DataSrc Property COPYOPENING DATASRC_TYPE IS_CONSOL Length 10 20 20 255 Length 2 Length 20 20 20 20
20 10 10 20 10 10 10
Length 2 2 2
IS_CONVERTED OPENING_DATASRC Groups Property CURRENCY_TYPE DATASRC_LEVEL ENTITY GROUP_CURRENCY PARENT_GROUP STORE_ENTITY STORE_GROUP_CURR Flow Property DIMLIST FLOW_TYPE IS_INPUT Time Property MonthNum Length 3 Length 20 10 2
2 20
Length 2 10 20 20 20 20 10
Dimension Management
A dimension consists of members. If the members of a dimension are arranged in a hierarchical order, the relationship between members is described with terms such as Parent, Child, and Sibling. Managing dimensions involves tasks such as creating new dimensions, defining members, and assigning properties. You manage dimensions in an application set using the dimension library. The dimensions in an application set's dimension library can be added to one or more applications in the application set.
Features
You can manage dimensions in the following ways:
Creating dimensions
You add dimensions to the dimension library of an application set to make them available to your applications. You can create a new dimension or copy an existing dimension. You can create a new dimension by clicking Add a new dimension from the Dimensions Tasks action pane, then entering the required data. Dimension names are not case sensitive and display in the case you typed; dimension names must be unique regardless of case.
Copying dimensions
You can copy an existing dimension within the dimension library of an application set by selecting a dimension and choosing Copy a dimension from the Dimension tasks action pane. You then select an existing dimension, enter a new name and description, then modify its members or properties if needed.
Naming conventions
You can use any name you want for a dimension as long as you follow these guidelines: When defining or importing dimensions or other metadata such as applications, members, or security profiles in the NetWeaver BW table, do not use special characters such as accented characters or Cyrillic fonts in IDs. Create dimension names with a maximum of 16 characters and without single quotation marks ('), double quotation marks ("), back slashes (\), or ampersands (&). Dimension IDs cannot contain a dash (-), but can support an underscore (_). Do not use the following names: App, AppAccess, AvlObject, CategoryAccess, CollabDoc, CollabIcons, Collab Recipient, CollabSupport, CollabType, DBVERSION, Defaults, DesktopStyleDef,Dime
nsion, DrillDef, DTIParam, Function, Formula, Group, InvestParam, MemberAccess, M essageLog, Packages, PageDef, Permission, PublishedBooks, Rate, ReportParam, Sec tionDef,Status, StatusCode, TaskAccess, User, UserGroup, UserPackages, UserPovDe f, WebContents, SOURCE, SIGNEDDATA Create dimension descriptions with a maximum of 50 characters and without double quotation marks ("). You have the ability to control the length of the user-defined properties to meet your needs. For information about changing the length of a property, see Member Behavior using Dimension Properties. You can add new properties to a dimension through Maintain dimension property, if needed.
Deleting dimensions
You can delete dimensions from an application set by choosing Dimension Library from the Admin Console, then choosing Delete dimension from the Manage Dimensions action pane. Select one or more dimensions, then choose Delete Selected Dimensions. You cannot delete a dimension when it is being used by an application.
Dimension Processing
When you create a dimension or make changes to an existing dimension, you need to manually process the dimensions.
Features
When you process a new dimension, its properties are defined in the database. Processing an existing dimension stores any changes made to a dimension in the database. When using the Microsoft version of the system, you can use Validate formula only to validate dimension formulas without processing the dimension. You can quickly validate any formulas in the dimension before sending them to the system. Schedule the processing of dimensions using a master Data Manager package (see Scheduling Dimension Member Processing). When using the Microsoft version of the system, you can use Show deleted members to have a list of deleted members appear before processing.
Activities
To process dimensions: 1. Go to the dimension library in the Admin Console. 2. Select Process Dimensions in the Manage Dimensions action pane. 3. Choose desired processing options and dimensions.
Procedure
1. Add the ADMINTASK_MAKEDIM package. 2. Run the package. See Running a Package.
3. Ensure that the correct dimension name is in the Input Dimension name field. Leave the Input Source table name field blank. Choose Next. 4. In the Schedule the processing of dimension members field, choose Yes, and choose Finish. 5. Enter data as required. 6. Enter the following package property. See Package Properties. TASK(Admin_Makedim,BSCHEDULEPROCESS,%ScheduleProcess%) Ensure that the value of %ScheduleProcess% is 1 (Yes).
Features
You can use the following features when working with dimensions: Default dimension properties Based on their assigned type, dimensions are assigned default properties, some of which are required. You can add more properties to further customize your dimension members. NOTE The SOLVE_ORDER property defines the order in which the system solves calculated members when they intersect with other calculated members. SOLVE_ORDER determines the order in which the system evaluates and calculates dimensions, members, calculated members, custom rollups, and calculated cells. The system evaluates the member with the highest solve order first, and calculates it last. Zero is the highest priority. Guidelines for implementing SOLVE_ORDER: Specify up to 3 measures and 5 members within a SOLVE_ORDER property. Specify dimensions by dimension name, making sure that capitalization is correct. EXAMPLE [ACCOUNT].[Account1] / [ACCOUNT].[Account2] [PRODUCT].[Product1] + [PRODUCT].[Product2] The only exception to this rule is that you do not need to specify an Account dimension by name. Adding properties to dimensions By assigning properties to dimensions, you can implement powerful features in your reporting, member lookup, formulas, Data Manager selections, and so on. You can filter on properties in many places in the system. For example, if you want to be able to easily select entities by geographic region, you simply add a Region property and enter a region value for each entity. Then you can filter and sort by region, apply account logic by region, or define a report format based on region. The system requires various properties depending on the dimension. You can also assign additional properties for your business needs. You can add properties to a dimension by selecting a dimension within the dimension library and adding a property ID at the bottom of the property list. Property names appear as column headings on the Member Sheet for a dimension. When you save the dimension after new properties have been added, columns are added to the Member Sheet for the new properties. The system does not permit you to keep columns on a member sheet that are not related to properties. NOTE
If you reorder the columns in the dimension sheet, the system does not maintain the new order when you close the sheet. Maintaining dimension properties You maintain dimension properties by adding new properties to a dimension. After you add a property to a dimension, you can assign property values to members in the dimension. To add dimension properties, select a dimension within the dimension library and enter the name of the property and the maximum alphanumeric size of the property values. There is no limit to the length of dimension attributes you create. To reduce the length of an existing dimension attribute, create a new property, copy the values over from the old property, then delete the old property. You can also delete dimension properties as long as they are not required. To delete a dimension property, select a dimension within the dimension library, delete the text from the Property Name column, then select Modify Dimension Property from the action pane. Dimension formulas The optional property FORMULA allows you to define calculations to perform for dimensions. This powerful feature of the system gives you the ability to customize data management to meet your business requirements. For information about implementing formulas, see Dimension Logic.
More Information
Required Properties for Account Dimensions Required Properties for Category Dimensions Required Properties for Currency Dimensions Required Properties for Entity Dimensions Required Properties for Intercompany Dimensions Required Properties for Time Dimensions Required Properties for User-Defined Dimensions Required Properties for Datasrc Dimensions Required Properties for Subtables Dimensions
Dimension Logic
Dimension logic, which is also known as member formulas, allows you to create and execute formulas and calculations on dimension members.
Features
Use the following guidelines when implementing formulas: The system calculates dimension formulas at retrieval time. Formulas can slow retrieval performance if you use them incorrectly. Implement dimension formulas only for members that need calculating after aggregations, such as ratios. Do not use formulas on members that need to aggregate. Use dimension formulas only for ratios that need to be calculated at both the base and parent level. If the resulting value is aggregated to the parent, use script logic to write the results to the database. Defining dimension logic To use dimension logic, you must add the property FORMULA to a dimension by choosing Maintain dimension property. FORMULA then appears as a column in the dimension member sheet, which is where you define the calculation you need Planning and Consolidation to execute. NOTE
The dimension property SOLVE_ORDER is required when you use the property FORMULA; the system automatically adds the property SOLVE_ORDER (see Member Behavior Using Dimension Properties. You cannot reference MDX functions, also known as user-defined functions, from a library file. For information about restrictions pertaining to dimension logic, see SAP Note 1356081.
Features
An account dimension has the following required properties: Property Name ACCTYPE Description Account type. Can be INC for Income, EXP for Expense, AST for Asset, LEQ for Liabilities and Equity
EVDESCRIPTION A user-defined description for the member. Can be up to 50 characters and does not need to be unique. It cannot contain double quotation marks ("). This description appears in the language specified in My Settings within Interface for the Web (see My Settings). For information about loading a list of languages into the system, see Data Management for the NetWeaver platform or Data Management for the Microsoft platform. RATETYPE SCALING Used by the currency conversion business rules. Value is optional. Scaling options are Y or N. Used by EvDRE, EvGTS, and Live Reporting. Value is optional, but if a value is not defined, scaling is unavailable for the associated member ID.
More Information
Member Behavior Using Dimension Properties Business Rules Management for the Microsoft platform or Business Rules Management for SAP NetWeaver
My Settings
You can select the language in which you view user interface text in Interface for the Web and member descriptions in your reports and input schedules in Interface for Office.
Prerequisites
To see messages and text in a specific language, the administrator has applied the language pack on the server. To see member descriptions in a specific language, the administrator has loaded the member descriptions in that language using Data Manager.
Activities
To change the language, start Interface for the Web, select My Settings from the action pane, and select the desired language.
Data Management
The Data Manager is a Planning and Consolidation module that helps you move data in to Planning and Consolidation, as well as copy or move data within and across applications. The Data Manager supports mapping and complex transformations of data.
Integration
You can use Microsoft SQL Business Intelligence Development Studio or the Data Manager user interface to manage your packages. If using Microsoft SQL, we recommend that you have advanced knowledge with working in Microsoft SQL Server Integration Services (SSIS).
Features
Starting Data Manager The Data Manager is integrated with Planning and Consolidation for Excel. To start the Data Manager, start Interface for Excel, then choose Manage Data from the Getting Started action pane. Data Manager Packages A package is a set of specific tasks that define the work to be done. These tasks are based on information you provide either by entering information in Data Manager package prompts or by modifying the package directly through Microsoft SQL Server. Planning and Consolidation is delivered with a set of standard packages that you can use as they are, or modify (see Standard Packages). The example packages provided need to be added to Data Manager from your file system (see Example Packages). Transforming Data Data Manager performs data transformations and mapping using transformation and conversion files (see Data Transformations).
More Information
Adding and Modifying Packages Interface for Office
Example Packages
In addition to the standard packages provided with the Data Manager, Planning and Consolidation provides several additional sample Microsoft SSISpackages that you can add to Data Manager. You need to modify some of the packages before they can be used. You can use all other sample packages as provided, or you can modify them to suit your needs. The following tables describe the sample packages. They can be found on the Planning and Consolidation file server in the \\DataManager\PackageFiles\Examples folder of the associated application set and application.
Features
Package Admin_Makedim 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. Optimizes applications with lite, incremental, or full option.
Admin_Optimize
AdminTask_LogicValidation AdminTask_Process Append AuditBackup AuditClear AuditPurge AuditRestore ClearComment Clear from Fact Table
Validates the logic file. Processes the application with incremental or full option. Appends an ASCII file into the current application. Backs up audit data. Clears audit data. Purges audit data. Restores audit data. Clears comments from the comments table. Removes the data from the Fact and FAC2 tables. The optimize process synchronizes the Fact and FAC2 tables with the cube. Running this package also clears comments from the comments table. Clears the Journals table and creates an output file. Copies the application database. Copies the Fact table. Exports the Journals table to an output file. Imports the Microsoft Access database into the Fact table. You can use the import.xls transformation file with this package. Imports the Microsoft Access database into the Fac2 table. You can use the import.xls transformation file with this package. Imports the MS Access 2007 database into the fac2 table. Imports Category by Time data into the fact table. You can use the Category_By_Time.xls transformation file with this package. Imports Category by Time data into the Fac2 table. You can use the Category_By_Time.xls transformation file with this package. Available for the purposes of backward compatibility.
Clear the Journal Tables Copy Application Copy from Fact Table Export the Journal tables Import Access into Fact Table Import Access
Import Access2007 Import Category by Time into Fact Table Import Category by Time
Import Dimension
Import Excel2007 into Fact Imports contents of a Microsoft Excel file into the fact table. You Table can use the import.xls transformation file with this package. Import Excel2007 Imports the contents of a Microsoft Excel 2007 file into the Fac2 table. You can use the import.xls transformation file with this package.
Import SQL into Fact Table Imports a Microsoft SQL Server database into the Fact table. When running this package, you are prompted for the SQL database and table to import. Import SQL Imports a Microsoft SQL Server database into the Fac2 table. You can use the import.xls transformation file with this package. When running this package, you are prompted for the SQL database to import. ImportUsingFTP Allows you to import an ASCII file to download from an FTP site into the current application. You can use Microsoft SQL to modify the server name in the package. After you modify the server name, you can run this sample package at any time. Imports an ASCII file and sends the result to specific user. Moves data from the fact table. Performs calculations typical of a statutory consolidation application. It is located in the Rate application in Apshell. Restores Journals tables from an output file. Allows you to use scenario modeling for forecasting purposes. This package calls a logic file, which is designed for your specific needs.
More Information
Adding and Modifying Packages
Prerequisites
You have created a package using SQL Server Business Intelligence Development Studio, and you have appropriate task security to add or modify packages. See the Planning and Consolidation Security Guide for more information.
Procedure
To add a package to Data Manager: 1. Choose eData Organize Package List 2. Select a team and package group and click Add Package. 3. Enter data as required. See Package Properties. 4. Save your changes.
To modify a package: 1. From the application server, start Microsoft SQL Server Business Intelligence Developer Studio. 2. In the context menu of the Microsoft SSIS folder, click Open Package. 3. In the target application set and application, choose \\DataManager\PackageFiles\Examples\. 4. Select a sample package. 5. In the Select Package dialog box, select the package you want to modify and click OK. 6. Open the task to modify and view its properties. See Custom Tasks.
Features
With Interface for Office, you can perform the following tasks: Utilize the powerful and flexible formulas and functions within reports and input schedules to retrieve, display, and submit data for a real-time view of the financial position of your organization. Use predefined report and input schedule templates that you can customize to meet your specific business requirements. Instantly change the information you see in a report or the entities, accounts, time period, and so on, of input data simply by changing your current view. Display accurate, live data from the database within Microsoft Excel worksheets, Microsoft Word documents, and Microsoft PowerPoint slides. Analyze data in reports, perform data entry in input schedules, and distribute information based on user access rights when you are completely offline from the system. Submit budgets with a wide range of supporting attachments in the form of spreadsheets, documents, and presentations. Create hypothetical scenarios of future outcomes using powerful modeling functions. Post journal entries to carefully track changes to your data. Schedule and run Data Manager packages for loading, transforming, and manipulating financial data.
Activities
To start one of the interfaces, select one of them from the launch page, or from another module (such as Interface for the Web or Administration), expandAvailable Interfaces in the action pane and make your selection. NOTE If you see a prompt to update files, select Yes.
More Information
Reports and Input Schedules
Interface for Word and PowerPoint Journals Data Management for the NetWeaver platform or Data Management for the Microsoft platform
Features
With the interfaces for Word and PowerPoint, you can perform many tasks on the data contained in your documents. Feature Insert data Description Allows you to insert a value from the database based on the current view. Clicking this link inserts a placeholder. You must select Retrieve all data to retrieve the value. You can insert or view comments in Word or PowerPoint. Once defined in Insight, KPIs, can be added to your documents and slides. When you are connected to a Planning and Consolidation server, the KPI is updated based on the current date. Choose Retrieve all data from the action pane to refresh all the KPI values in the Word document or PowerPoint slide. You can insert a report or input schedule into a Word document or PowerPoint slide. The report or input schedule you want to embed must be saved on the server. You can insert an object from the Getting Started action pane, then select Insert Interface for Excel object. If you insert an input schedule, you can enter data and use the Send data values link to submit it to the database. If you insert a report, you can use the Expand All and Retrieve all data links to refresh data. NOTE The system refreshes only embedded objects based on the current view. The individual objects are static at the time of the insert. Insert Dashboard Allows you to embed an Xcelsius SWF file into a Word document or PowerPoint presentation. The Xcelsius document is based on the current view. If you change the current view, the Xcelsius document is updated. If you embed an Xcelsius document in any other way through a Word or PowerPoint function, it is not based on the current view. Allows you to resize an Xcelsius SWF file frame once it has been inserted into a Word document. You can add a comment to the document or slide, or view associated comments. See Comments.
Description Allows you to retrieve data values from the database based on the current view. Clicking this link refreshes data values in the entire document or slide show. Allows you to expand functions contained in embedded objects. After at least one data value has been inserted in your document or slide show, you can use this link to send the values to the database. If there are multiple inserted data values, this command sends all of them to the database. Insert a base member and then enter a value over that object before sending the value.
Open/Save Dynamic You can open and save Word documents to the server. Documents Open/Save Dynamic You can open and save PowerPoint presentations to the server. Presentations
Activities
To start Interface for Word, select Interface for Word from the Launch page, or from the Available Interfaces drop down list in the action pane. To start the Interface for PowerPoint, select Interface for PowerPoint from the Launch page, or from the Available Interfaces drop-down list in the action pane.
Comments
Comments provide a vehicle for submitting, storing, and retrieving text commentary associated with Planning and Consolidation data cells. This allows users to annotate data so other users can view supporting information associated with a particular data point.
Integration
The Comments function is fully integrated in Interface for Excel, Interface for Word, Interface for PowerPoint, and Interface for the Web. Therefore, you can enter and view comments from within any interface that manages data.
Features
You can use comments in the following ways: You send/retrieve a comment using the action pane. You can see comments on a series of data such as a specific report or Content Library document that is not driven by the current view. You can retrieve a comment for a specific cell in Interface for Excel, but not in Interface for the Web live reports. You can use functions to retrieve comments based on a fully specified or partially qualified current view. See EvCGP and EvCGT.
Adding Comments
You can add comments using the EvCOM function or through the action pane. The Add comment link is available on any action pane from which the context of the page allows you to enter a comment. In the Microsoft version, you can set the comment length using the COMMENT_MAX_LENGTH parameter. The maximum length is 4,000 characters. For more information, see Application Parameters.
NOTE If you use EvCOM, you must pass along all the dimension members and application with the text within the formula syntax. When adding a comment, you may specify the following items: Item Context Description Select how to apply the comment: The published page (Interface for the Web) This option is available when a published report or input schedule is active. The comment becomes associated with the active report or input schedule. The active report or schedule cell (Interface for Excel) This option is available when a live report or schedule is active. The comment is applied to the data region associated with the selected cell. The selected Planning and Consolidation data (Interface for Word/Powerpoint) This option is available when you select Insert data object. The active current view This option applies the comment to the current view shown in the action pane. Custom current view This option allows you to specify a specific current view to which to associate the comment. From the Comment for These CV Values table, select the application. For each dimension, select the check box next to the dimensions for which you want a specific member or all members to apply. Leaving a check box unselected ignores the members for that dimension for this comment. To select a member using the Member Lookup, click a dimension link. See Member Lookup. Select the desired priority level or No Priority. The reports show comments in order of their priority level.
Priority
Keywords Use keywords to organize and search for comments in the database. This field takes blanks and empty strings.
Viewing Comments
If you have a live report or input schedule open, you can view any comments that are associated with it. You can also view comments associated to the current view of a selected cell within that report or input schedule, or view any comments for a specific current view. To view relevant comments, you must answer some questions so the system can filter the database. Item Description
Item Context
Description Select how to apply the comment: The published page (Interface for the Web) This option is available when a published report or input schedule is active. The comment becomes associated with the active report or input schedule. The active report or schedule cell (Interface for Excel) This option is available when a live report or schedule is active. The comment is applied to the data region associated with the selected cell. The selected Planning and Consolidation data (Interface for Word/Powerpoint) This option is available when you select Insert data object. The active current view This option applies the comment to the current view shown in the action pane. Custom current view This option allows you to specify a specific current view to which to associate the comment. From the Comment for These CV Values table, select the application. For each dimension, select the check box next to the dimensions for which you want a specific member or all members to apply. Leaving a check box unselected ignores the members for that dimension for this comment. To select a member using the Member Lookup, click a dimension link. See Member Lookup. You select the checkbox to show multiple comments for the specified search criteria. Leave the checkbox blank to return only the most recent comment that meets the criteria. You select one or more priority options to return comments associated with that priority. You can enter a keyword (up to 50 characters) to return only comments with a matching keyword. You can select one of the following: Comments from anyone. This option returns comments entered by all users. Comments from myself. This option returns comments that were entered by you. Comments from another user. This option returns comments entered by a specific user. Enter a valid user in the User edit box.
Comments by You can select the Search by date range check box to specify a date range for which to return comments. Use the From and To drop-down lists to specify the desired date range. date range
Clearing Comments
You can delete comments from the comment history, except for the last comment entered, using the CLR_COMMENTS_HISTORY application set parameter. For more information see Application Set Parameters. You can also delete or remove comments with conditions through the ClearComment package in Data Manager.
To change views, you can do one or more of the following: To change what displays in the Data Region with Comments table, choose the Display Criteria hyperlink at the top of the page. See Viewing Comments, above. To delete a comment, select the check box next to the comment in the Comments for the selected data region table, then choose Delete selected comments from the action pane. Only the owner of the comment or a user with administrative rights can delete a comment.
Priority
Keyword
Originator Date
Activities
Adding Comments To add a comment, open the report or input schedule and select the cell in which you want to add a comment. From the Report State action pane, select the Add a new comment link. Specify the requested information, then enter the comment (up to 265 characters). Viewing Comments To view a comment, from a live report/input schedule or a selected cell in a report/input schedule, select View comments from the action pane. Specify the requested information to view the Comments Summary page.
More Information
EvCOM
Features
A category dimension has the following required properties:
Property Name
Description
EVDESCRIPTION A user-defined description for the member. Can be up to 50 characters and does not need to be unique. It cannot contain double quotation marks ("). This description appears in the language specified in My Settings within Interface for the Web (see My Settings). For information about loading a list of languages into the system, see Data Management for the NetWeaver platform or Data Management for the Microsoft platform.. YEAR Used to assign a YEAR to the category, to be used with the EVGET and EVTIM functions in reporting. For more information, see Reports and Input Schedules.
More Information
Member Behavior Using Dimension Properties Business Rules Management for the Microsoft platform or Business Rules Management for SAP NetWeaver
Using Special Formatting If you want to apply special formatting to read-only cells, cells that are ready for input, or changed cells, you can use the FormatRange option in EvDRE. For example, for calculated cells, you can set the USE formatting option to LOCK (then lock those cells through native Excel), to prevent the user from changing calculated cells. See Format Ranges.
More Information
Creating Reports and Input Schedules Common Report and Input Schedule Features Dynamic Report and Input Schedule Templates EvDRE Builder Drag and Drop Reporting Live Reporting Data Submission
Prerequisites
You have task security rights to distribute and collect data.
Features
Note the following features when you distribute and collect input schedules: Reports or input schedules are locked (parked). You can collect changes to offline input schedules and send the data to a database. Reports and input schedules are distributed through e-mail or a designated network folder.
Activities
Distributing offline reports involves the following steps (with an optional step to collect modified input schedules): 1. Create a distribution list that defines the scope (current view) of the data for one or more users. See Create Distribution Lists. 2. Use the Distribution Wizard to distribute offline reports or input schedules through e-mail or a network folder. The system creates reports for each user and for each current view described by the distribution report. SeeDistribute Reports and Input Schedules. 3. (Optional) If you distribute input schedules, users can enter data offline, and then e-mail the reports back to you or save them in a designated directory. You can then use the Distribution Wizard to collect the data from the modified reports and send it to the database. See Collect Input Schedules.
Features
You can e-mail reports and input schedules to users, or place them in a designated folder. Users can modify offline input schedules and e-mail them back to you using the same distribution list. After creating one or more report or input schedules, you can create a new distribution list, or use the a Distribution List template as a guide. The template is located in\Webfolders\ApShell\Planning\eExcel\PDBooks\Distribtution Template.xlt.
The Distribution list template contains the following fields: Field BOOK SECTION Description The title of your distribution list. Denotes the beginning of a section of the distribution list. You can have multiple sections in your distribution list. Each section must include REPNAME, FIXKEY and VARYKEYS, defined below. The Distribution Wizard allows you to select the sections you want to publish within a book. See Distribute Reports and Input Schedules. The file path to the report template being used to create the reports. You can also add a title for the report in the cell immediately following the path. You must set a password before you distribute report or input schedule templates. See Workbook Options. Used to set a dimension value for all reports in the distribution (for example, TIME 2008.JAN). FixKey also supports the use of dimension members from another application within the application set. To specify a dimension member from another application, use the following syntax: APPLICATION:DIMENSIONNAME. VARYKEYS The list of dimensions and user IDs for which the distribution is created. Enter the dimensions and the user IDs in columns. The system creates reports for each intersection of dimensions and users that have access to the data. To include all the children of a parent use the following syntax: %All%. For example, SalesUS.%ALL% creates reports for Sales US and all its children. To include the base member of a parent, use the following syntax: %BAS%. For example, WorldWide1.%BAS% returns the base members of WorldWide1. To include the immediate descendants of a parent use the following syntax: %DEP%. For example, WorldWide1.%DEP% returns the children of WorldWide1. To use the CurrentView for a dimension instead of specifying a view use the following syntax: %CUR%.
REPNAME
FIXKEY
SECTIONEND Denotes the end of a distribution section. NOTE Any dimension not specified in the distribution template has its value (member) taken from the current view.
Activities
To create a distribution list, take the following steps: 1. From Interface for Excel, select ePublish Manage distribution list New . 2. Edit the distribution list, as described in the table above. Make sure to protect any specified reports or input schedule template(s) with a workbook password. See Workbook Options. 3. When you are satisfied with the distribution list, select ePublish Manage distribution list Validate . Validating checks the template for workbook protection, and errors in syntax, structure, and provided information. 4. Select ePublish Manage distribution list Save .
Features
You can use the Distribution Wizard to distribute the templates to a folder or through e-mail. The Offline Distribution Wizard also generates the reports or input schedules before distributing them.
Activities
To use the Offline Distribution Wizard, take the following steps: 1. From Interface for Excel, select ePublish Offline Distribution Wizard . Select Distribution, then do one of the following: Select Lockdown and Send mail. Select Lockdown and Save to folder. 2. Choose Distribute Now. 3. In the Select Distribution List dialog box, select the distribution list you want to use. See Create Distribution Lists. 4. If you chose to distribute into a folder, specify the folder. If you chose to distribute by e-mail, enter your e-mail address. 5. Choose Next to generate the reports or input schedules, and then send the e-mail or save the reports to the designated folder.
6.
7. 8. The entity dimension defines the organizational structure of the business units for your application and how the units aggregate. Any dimension that is assigned the type E is an entity dimension. Each application can have only one entity-type dimension.
9. Features
10. An entity dimension has the following required properties: Property Name CURRENCY Description The currency used by the entity
Property Name
Description
EVDESCRIPTION A user-defined description for the member. Can be up to 50 characters and does not need to be unique. It cannot contain double quotation marks ("). This description appears in the language specified in My Settings within Interface for the Web (see My Settings. For information about loading a list of languages into the system, see Data Management for the NetWeaver platform or Data Management for the Microsoft platform.
11.
More Information
12. Member Behavior Using Dimension Properties 13. Business Rules Management for the Microsoft platform or Business Rules Management for SAP NetWeaver
Features
Adding Business Rules to Applications When you create or modify an application, you can add business rules to it. You can add the following business rules: Account Transformations Automatic Adjustments Carry-Forwards Currency Conversions Intercompany Bookings US Eliminations Validations After adding a business rule to an application, you must customize it to meet your needs by specifying parameter values. You run the business rules by adding a stored procedure to a script logic file. For more information about adding business rules to applications, see Application Management. Business Rule Reports You can view and print a rule table report. You might want to save the report for historical purposes. Editing Business Rules You can edit the content of a business rule by choosing the business rule within an application, then selecting a header record. You can use standard Microsoft Excel functionality to perform the following actions: Select multiple detail record rows Copy, paste, and delete detail records by row Copy or paste within a cell by right-clicking and selecting a context menu option or using CTRL + C or CTRL + V respectively Copy rows from one header record to another You can look up members within the cells of a detail record by choosing the Lookup button that appears when you place the cursor within that cell. Validating Business Rules
The system automatically validates entries in the business rules tables. If it finds an invalid value, a tooltip displays the error. You can verify the structure of a business rule after modifying it by choosing Validate dimensions and properties in the action pane. This displays a successful status or any errors encountered.
More Information
Logic Execution