BusinessObjects Planning Excel Analyst User Guide BusinessObjects Planning Excel Analyst 5.2
Copyright Third-party contributors Copyright 2007 Business Objects. All rights reserved. Business Objects owns the following U.S. patents, which may cover products that are offered and licensed by Business Objects: 5,555,403; 6,247,008; 6,289,352; 6,490,593; 6,578,027; 6,768,986; 6,772,409; 6,831,668; 6,882,998; 7,139,766; 7,181,435; 7,181,440 and 7,194,465. Business Objects and the Business Objects logo, BusinessObjects, Crystal Reports, Crystal Xcelsius, Crystal Decisions, Intelligent Question, Desktop Intelligence, Crystal Enterprise, Crystal Analysis, Web Intelligence, RapidMarts, and BusinessQuery are trademarks or registered trademarks of Business Objects in the United States and/or other countries. All other names mentioned herein may be trademarks of their respective owners. Business Objects products in this release may contain redistributions of software licensed from third-party contributors. Some of these individual components may also be available under alternative licenses. A partial listing of third-party contributors that have requested or permitted acknowledgments, as well as required notices, can be found at: http://www.businessobjects.com/thirdparty
Contents Chapter 1 Introduction 9 Overview.................................................. 10 Conventions used in this guide................................. 10 About BusinessObjects Planning................................ 10 Related documentation....................................... 12 About this guide............................................. 14 Chapter 2 Basic Concepts 15 About BusinessObjects Planning Excel Analyst.................... 16 Specifying the application and working language................ 16 Viewing version information................................. 17 Business model properties..................................... 17 Dimensions................................................ 18 Currency types.............................................. 19 Currency settings............................................ 20 Inheritance................................................. 23 Chapter 3 Working with BusinessObjects Planning Reports in Excel 25 Accessing and viewing reports in Excel........................... 26 Logging on to the server...................................... 27 Working with the Log message workbook...................... 28 Using the BusinessObjects Planning Excel Analyst toolbar............ 28 Using the Drill-down toolbar.................................... 29 Opening a report............................................ 31 Specifying a missing dimension using the dimension list.......... 34 Specifying a missing Time Period dimension................... 36 Understanding how report values are determined................... 37 Drilling down in a report....................................... 38 Changing the Display currency................................. 39 BusinessObjects Planning Excel Analyst User Guide 3
Contents Launching a task from within a report............................. 40 Pivoting a report section....................................... 40 Editing data in a report........................................ 41 Updating multi-section reports............................... 42 Copying data between Excel and BusinessObjects Planning Analyst.... 43 Consolidating report data...................................... 43 Projecting future performance................................... 45 Using predefined projections................................. 50 Defining a projection....................................... 50 Prorating data............................................... 54 Proration methods......................................... 55 Distribute Evenly...................................... 55 Leaf Based........................................... 55 Scenario Based....................................... 56 Determining the behavior of prorations......................... 56 Prorating using different scenario types..................... 56 Prorating Revisable lines................................ 57 Prorating lines that are input within a version................. 57 Prorating formula lines.................................. 58 Using predefined prorations................................. 58 Defining a proration........................................ 59 Saving changes to data........................................ 64 Saving a report as an Excel file.................................. 64 Logging off of the server....................................... 65 Chapter 4 Working with Ad Hoc Reports in Excel 67 Overview................................................... 68 Logging on to the server....................................... 69 Using the Log message workbook............................ 70 Writing a Log message..................................... 70 Using the Ad hoc toolbar....................................... 71 Creating ad hoc reports........................................ 71 Creating ad hoc reports using report areas...................... 72 4 BusinessObjects Planning Excel Analyst User Guide
Contents Specifying report areas................................. 73 Renaming report areas................................. 74 Specifying a business model............................. 74 Validating business models.............................. 76 Adding rows to ad hoc reports........................... 76 Adding columns to ad hoc reports......................... 83 Specifying section properties using the Dimension Wizard..... 89 Specifying section properties manually..................... 94 Selecting members from the dimension list................. 96 Specifying time periods................................. 98 Specifying whether to allow data to be uploaded............ 100 Validating ad hoc reports.............................. 104 Clearing validation errors.............................. 104 Clearing validation errors using Excel macros.............. 105 Editing data in ad hoc reports........................... 106 Viewing and highlighting dimensions..................... 106 Creating ad hoc reports using functions...................... 108 Using the BusinessObjects Planning worksheet functions..... 108 Worksheet function error messages...................... 110 Opening a BusinessObjects Planning report as an ad hoc report...... 110 Drilling down in an ad hoc report............................... 113 Modifying and updating ad hoc reports.......................... 115 Opening ad hoc reports................................... 115 Modifying the contents of a report area....................... 116 Editing an identifier in a cell............................ 117 Editing a row range using the Dimension Wizard............ 118 Editing a row range manually........................... 121 Shrinking a row range................................. 122 Editing a column range using the Dimension Wizard......... 123 Editing a column range manually........................ 126 Shrinking a column range.............................. 127 Deleting dimensions from reports........................ 128 Scaling data............................................ 129 BusinessObjects Planning Excel Analyst User Guide 5
Contents Refreshing ad hoc reports.................................. 134 Uploading data from ad hoc reports to the database............. 134 Uploading and refreshing ad hoc reports...................... 135 Uploading and refreshing ad hoc reports using Excel macros...... 136 Copying ad hoc reports.................................... 139 Saving ad hoc reports..................................... 140 Logging off of the server...................................... 140 Appendix A The BusinessObjects Planning Worksheet Functions 141 Overview.................................................. 142 IGETVAL.................................................. 143 IPUTVAL.................................................. 145 IGETDIMATTR............................................. 149 IGETRATE................................................ 151 IGETMODATTR............................................ 153 IGETSCENATTR............................................ 154 Attributes for business objects................................. 156 Appendix B Time Period Tables 161 Overview.................................................. 162 Yearly time periods.......................................... 163 Yearly spot balance time periods............................ 164 Half yearly time periods....................................... 164 Quarterly time periods........................................ 166 Quarterly spot balance time periods.......................... 167 Monthly time periods......................................... 168 Monthly spot balance time periods........................... 172 Weekly time periods......................................... 173 Daily time periods........................................... 173 Determining the current week............................... 174 Time periods that reference the global current day of the model.... 175 Time periods that reference the local current day of the scenario... 181 Examples.................................................. 187 6 BusinessObjects Planning Excel Analyst User Guide
Contents Using advanced time periods.................................. 187 Appendix C BusinessObjects Planning Excel Analyst Hot Keys 193 Index 195 BusinessObjects Planning Excel Analyst User Guide 7
Contents 8 BusinessObjects Planning Excel Analyst User Guide
Introduction chapter
1 Introduction Overview Overview This guide serves two purposes. It describes how to use BusinessObjects Planning Excel Analyst to access, view, and analyze BusinessObjects Planning reports in a Microsoft Excel environment. It also describes how to use BusinessObjects Planning Excel Analyst to create ad hoc reports that query business rules and data in your environment. This guide assumes that you know how to use the Windows operating system and Microsoft Excel. This section discusses the following topics: Conventions used in this guide on page 10 About BusinessObjects Planning on page 10 Related documentation on page 12 About this guide on page 14 Conventions used in this guide The following table describes the conventions used in this guide. When you see Bold text Courier text BOLD SMALL CAPS It indicates A name of a user interface item that you should select. For example, Right-click a report and select Properties. Information you need to type into a data entry field. For example, when you see Type AuthorizationServers, you should type each individual letter key to make up the word AuthorizationServers. Specific keys you need to press. For example, when you see Press ENTER, you should press the ENTER key on your keyboard. About BusinessObjects Planning The BusinessObjects Planning product suite provides Web-enabled, vertical industry-targeted enterprise analytics software that helps companies measure, analyze, and predict business performance and profitability. Organizations leverage the suite for real-time business planning and 10 BusinessObjects Planning Excel Analyst User Guide
Introduction About BusinessObjects Planning 1 forecasting, accelerating mergers and acquisitions, understanding business performance by customer segment, product, channel and business line, and delivering performance management information across the enterprise. BusinessObjects Planning is the only suite that is selectively packaged into a series of applications, each one tailored to support a different segment of the user community. Moreover, every user leverages a common information infrastructure. All user applications are driven by the same set of data, business rules, user rights, and report templates, and any changes are automatically synchronized across the enterprise. The product suite includes the following applications: BusinessObjects Planning Administrator BusinessObjects Planning Administrator allows nontechnical users to rapidly and easily configure, deploy, and administer BusinessObjects Planning applications across multiple sites. From a central site and leveraging intuitive graphical interface, drag-and-drop function, and advanced automation capabilities users can install and synchronize geographically dispersed sites, assign user access rights, and build and manage multiple business models. BusinessObjects Planning Analyst Pro BusinessObjects Planning Analyst Pro is designed for nontechnical users who have sophisticated information requirements. A comprehensive range of formatting features, and drag-and-drop functions allow users to easily create and maintain reports. In addition, users can quickly build, manage, and execute scripts that automate complex tasks such as scheduled report production and distribution. BusinessObjects Planning Analyst BusinessObjects Planning Analyst provides secure remote access to realtime report information anywhere, anytime, through a Web browser. Intelligent graphic indicators, drill-down toolbars, built-in annotation capabilities, forecasting tools, and a sophisticated charting interface allow users to easily view, enter, and edit report data. BusinessObjects Planning Excel Analyst BusinessObjects Planning Excel Analyst allows users to leverage advanced analytics, superior performance, and automated information synchronization and distribution capabilities, all from within a familiar Microsoft Excel environment. BusinessObjects Planning Excel Analyst User Guide 11
1 Introduction Related documentation Related documentation For information about installing and using BusinessObjects Planning, please refer to the following documentation: BusinessObjects Planning Installation Guide This guide describes: how to install a BusinessObjects Planning site that uses either a Microsoft SQL Server or Oracle database, how to install the BusinessObjects Planning Server components to allow Internet-based use of BusinessObjects Planning, how to install and configure BusinessObjects Planning Administrator, BusinessObjects Planning Analyst Pro, and BusinessObjects Planning Excel Analyst on user workstations, and how to modify configurable properties in BusinessObjects Planning configuration files or executables to create customized installations. It also provides installation and configuration instructions for the BusinessObjects Planning Analyst site, the BusinessObjects Planning Gateway, BusinessObjects Planning Server, and BusinessObjects Planning Scheduler. BusinessObjects Planning Server Components Administration Guide This guide, designed for administrators, describes how to configure and manage BusinessObjects Planning Servers and BusinessObjects Planning Gateways. It provides information about: using the BusinessObjects Planning Site Monitor tool to manage the BusinessObjects Planning enterprise, the Planning.ini configuration file, load balancing, and other configurable properties. Using the BusinessObjects Planning Configuration Assistant This guide describes how to use the BusinessObjects Planning Configuration Assistant to configure client applications, create or modify connections to BusinessObjects Planning sites, or create configuration reports to aid in troubleshooting. Administrator s Guide This guide describes how to configure, customize, and maintain BusinessObjects Planning applications on behalf of other users. This guide includes conceptual and background information on the features and functions of the applications. It also gives examples of how to use BusinessObjects Planning Administrator and BusinessObjects Planning Analyst Pro. 12 BusinessObjects Planning Excel Analyst User Guide
Introduction Related documentation 1 BusinessObjects Planning Reporting Guide This guide describes how to create, use, and format reports using BusinessObjects Planning Administrator and BusinessObjects Planning Analyst Pro. This guide explains reporting-related concepts and provides step-by-step instructions. BusinessObjects Planning Analyst User Guide This guide describes how to use BusinessObjects Planning Analyst to access, view, and analyze BusinessObjects Planning reports in a World Wide Web environment. BusinessObjects Planning Excel Analyst User Guide This guide serves two purposes. It describes how to use the BusinessObjects Planning Excel Analyst to access, view, and analyze BusinessObjects Planning reports in an Excel environment. It also describes how to use the BusinessObjects Planning Excel Analyst to create ad hoc reports that query business rules and data in your BusinessObjects Planning environment. This guide explains reporting-related concepts and provides step-by-step instructions. BusinessObjects Planning Workflow Guide This guide is intended for BusinessObjects Planning users who deal with their organization's Workflow plans and who are responsible for administering, submitting, and approving Workflow scenarios. It contains conceptual and background information on the elements of Workflow in BusinessObjects Planning and gives examples of how to apply Workflow to an organization's planning and forecasting process. As Workflow functions are not specific to one application in BusinessObjects Planning, this guide includes Workflowrelated information for BusinessObjects Planning Administrator, BusinessObjects Planning Analyst Pro, BusinessObjects Planning Analyst, and BusinessObjects Planning Workflow Console. Online help The online help provides step-by-step instructions for using BusinessObjects Planning applications. The online help also provides reference and conceptual information. To access online help in BusinessObjects Planning Administrator or BusinessObjects Planning Analyst Pro, select Help from the Help menu on the Organizer toolbar, or press F1. To access online help in BusinessObjects Planning Analyst, BusinessObjects Planning Excel Analyst, or Workflow Console, click the Help button on the application toolbar. BusinessObjects Planning Excel Analyst User Guide 13
1 Introduction About this guide About this guide This guide serves two purposes. It describes how to use the BusinessObjects Planning Excel Analyst to access, view, and analyze BusinessObjects Planning reports in an Excel environment. It also describes how to use the BusinessObjects Planning Excel Analyst to create ad hoc reports that query business rules and data in your BusinessObjects Planning environment. This guide explains reporting-related concepts and provides step-by-step instructions. 14 BusinessObjects Planning Excel Analyst User Guide
Basic Concepts chapter
2 Basic Concepts About BusinessObjects Planning Excel Analyst About BusinessObjects Planning Excel Analyst The BusinessObjects Planning Excel Analyst is a Web-enabled application that gives you the ability, based on your user rights, to access, view, and analyze BusinessObjects Planning reports directly inside Microsoft Excel. The information displayed inside Excel is driven by the same core set of business rules and data that define the information produced in other BusinessObjects Planning applications. Many of the functions you perform on a report in other BusinessObjects Planning applications can be replicated in Excel. For example, you can drill down on dimensions as easily as you would in other applications, and you can enter or edit plans and forecasts directly into the Excel spreadsheet. For more information, see Working with BusinessObjects Planning Reports in Excel on page 25. Not only can you view existing BusinessObjects Planning reports using the BusinessObjects Planning Excel Analyst, you can also create ad hoc reports that query business rules and data that reside in your BusinessObjects Planning environment. This gives you the flexibility to incorporate BusinessObjects Planning report information into any spreadsheet file that you create in Excel. However, there are some limitations on what you can do to that information once it has been retrieved. For more information, see Working with Ad Hoc Reports in Excel on page 67. Specifying the application and working language BusinessObjects Planning content, such as editable fields in the application, report headings and titles, and metadata, appear in the working language of BusinessObjects Planning Excel Analyst. User interface elements, such as menu items and dialog box text, appear in the application language of BusinessObjects Planning Excel Analyst. You can specify which working and application language you want to use for your BusinessObjects Planning Excel Analyst sessions. Note: You must be logged on to the BusinessObjects Planning server to change your application or working language. Changes to the application language will take effect the next time you restart BusinessObjects Planning Excel Analyst, while changes to the working language will take effect the next time you open a report. 16 BusinessObjects Planning Excel Analyst User Guide
Basic Concepts Business model properties 2 To specify the application or working language: 1. From the BusinessObjects Planning menu, select Languages. 2. In the Languages dialog box, select a language from the Application language or Working language list. 3. Click OK. Viewing version information When you are logged on to the server, you can view version information about BusinessObjects Planning Excel Analyst, BusinessObjects Planning Web Gateway, and BusinessObjects Planning Server. To view version information, from the BusinessObjects Planning menu, select Help and BusinessObjects Planning Excel Analyst. Note: If you are not logged on to the server, you will be prompted to do so. Business model properties A business model presents a hierarchical structure of the business rules that define how core sets of measures for performance and profitability are calculated across your enterprise at a given point in time. Dimensions, rates, and filters define the business rules in a business model. For more information on how to specify which business model to use in an ad hoc report, see Specifying a business model on page 74. Users who are responsible for creating and maintaining business models are also responsible for setting model properties, some of which can affect reports. For example, if CAD is specified as the Default reporting slice for the model, your reports may access CAD from the database even though you have not explicitly set them up to do so. BusinessObjects Planning Excel Analyst User Guide 17
2 Basic Concepts Dimensions Dimensions You cannot change model properties unless you are granted modify rights to the model and have access to BusinessObjects Planning Administrator or BusinessObjects Planning Analyst Pro, but you can override properties at more specific reporting levels (report, column, or row). One of the most powerful features in BusinessObjects Planning is the ability to store information in a number of different dimensions. A dimension is an overall category of information. To understand dimensions, think of time. Time is broken down into years, months, days, hours, minutes, and seconds. Without these subcategories, time has no meaning. Nonetheless, time provides a way of understanding all the subcategories at once, as one entity. There are 10 different dimensions, although most large organizations only take advantage of the ones that are most relevant to their understanding of their organization, such as Unit, Line, and Currency. Each dimension is equipped with intelligent capabilities to facilitate consolidation, report construction, and analysis. Each dimension is sub-divided into members. A member is an individual component within a dimension. A member that is one level up in a hierarchy from another member is the parent. One or more members (children) can belong to a parent, in which case these members are called siblings. As well, children can be parents to other members. The parent value is typically a sum of the values of all its children. The following table describes each dimension. 18 BusinessObjects Planning Excel Analyst User Guide
Basic Concepts Currency types 2 Dimension Unit Line Currency Balance type Customer Product Channel Project Transaction Fiscal period Description Organizes information by line of business, subsidiary, geography, business activity, or legal entity. Units are planning or reporting components to which you assign costs and revenues. Organizes information according to measurement categories, like financial accounts. Lines also allow you to measure non-financial performance such as customer retention, channel usage, and transaction counts and/or volumes. The Line dimension has built-in functionality, such as time aggregation, as well as an area to build custom formulas similar to those created in a spreadsheet application. Organizes currencies as either pure or derived. A pure currency is the money in circulation. Each pure currency references a rate table, which defines the exchange rate for the currency at a particular point in time. A derived currency is a predefined grouping of currencies that is calculated based on pure currencies. Organizes data by booked amounts and adjustments that modify those amounts. Balance types also allow you to distinguish between As at Spot balances and Average balances in the same line. Organizes data by customer segment. Organizes data by product such as deposits, credit cards, or mortgages. Organizes data by channel such as ABMs, telephone banking, and internet banking. Tracks expenditures and revenues generated by business initiatives such as sales campaigns, acquisitions, and mergers. Tracks costs by activity or transaction grouping. Describes how you want to store data for each time period. You define fiscal periods by version (plan, forecast, or actual) and periodicity (monthly, quarterly, and annually). Currency types There are two main categories of currencies: pure and derived. A pure currency is the money in circulation in a country. Each pure currency references a rate table, which defines the exchange rate for the currency at a particular point in time. A derived currency is calculated based on pure currencies. The following table describes the three main derived currencies. BusinessObjects Planning Excel Analyst User Guide 19
2 Basic Concepts Currency settings Derived currency Local Currency (LC) Booked Currency (BK) Total All Currencies (TT) Description Source currency Display currency Retrieves and displays data using a unit s default reporting currency. Displays the currency as unconverted. Displays a specific value by all of the currencies that make it up. You normally should not use LC as a Source currency, as the report would only retrieve values stored on the currency slice as specified by one unit s default reporting currency. If you set the Source currency to Booked, when the report is opened, the user is prompted to specify a currency. You can also set the Source currency to Ask User to prompt users for a currency. TT is a frequently used setting for the Source currency. For example, if the Source currency is set to TT, you can drill down to see the value by each pure currency that contributes to the total value. You should use LC as the Display currency for reports that users edit (for example, those used to collect plan and forecast data). Users do not have to change the report s Display currency to match units. Booked is a frequently used setting for the Display currency. For example, if the Source currency is CAD and the Display currency is Booked, the values are retrieved from the CAD slice and displayed as Canadian dollars. No conversion takes place. You should not use TT as a Display currency. Note: The default reporting currency is part of a unit s properties. It is specified as part of the business model creation and maintenance process. You cannot change it from inside a report. Currency settings There are two main currency settings that affect reports: the source currency (also referred to as the currency slice) and the display currency (also referred to as the view currency). The source currency defines what currency is retrieved from the database. When you set the source currency, you can specify a pure currency like CAD or USD or a derived currency like TT or LC. The display currency defines how 20 BusinessObjects Planning Excel Analyst User Guide
Basic Concepts Currency settings 2 Source currency database values appear in the report. When you enter data in a report, it is interpreted as the currency you specify as the display currency. If you enter data for currencies that do not match the display currency, the data is converted when it is stored in the database. For examples of how these settings affect the data that you enter, see the table on the next page. The following table describes how these settings determine what value is displayed in a report. Display currency Unit s Default reporting currency Result CAD USD N/A The report retrieves only the CAD slice from the database, converts it to and displays it as US dollars. TT CAD N/A All currency slices are retrieved from the database and are converted to and displayed as Canadian dollars. LC CAD CAD The CAD slice is retrieved from the database and displayed in Canadian dollars. No conversion takes place. LC USD CAD The CAD slice is retrieved from the database, converted to and displayed as US dollars. TT LC CAD All currency slices are retrieved from the database and are converted to and displayed as Canadian dollars. CAD BK N/A The CAD slice is retrieved from the database and displayed in Canadian dollars. No conversion takes place. TT BK CAD All currency slices are retrieved from the database. The total of all the currencies is converted to and displayed as Canadian dollars. If you drill down by currency, the individual values for the currencies are displayed as they are stored in the database. No conversion takes place. In this case, the totals and the individual values will not appear to add up. If the Source currency is TT and the Display currency is BK, the total value may be displayed using the base currency of the model. BusinessObjects Planning Excel Analyst User Guide 21
2 Basic Concepts Currency settings Source Currency The following table describes how the data you enter is interpreted and stored in the database. Note: The default reporting currency is part of a unit s properties. It is specified as part of the business model creation and maintenance process and you cannot change it from inside a report. Display Currency Unit s Default reporting currency Result CAD USD N/A The data you enter is interpreted as US dollars. When it is stored in the database, it is converted to its CAD equivalent and stored in the CAD slice of the database. TT CAD N/A The data you enter is interpreted as Canadian dollars. If TT is defined as CAD+USD+GBP, you can drill down in your report to reveal the CAD, USD, and GBP slices. The data you enter for CAD is stored in the CAD slice as is, but the data you enter for USD is converted to US dollars and stored in the USD slice, and the data you enter for GBP is converted to pounds and stored in the GBP slice. LC CAD CAD The data you enter is stored in the CAD slice as Canadian dollars. No conversion is necessary. LC USD CAD The data you enter is interpreted as US dollars. When it is stored in the database, it is converted to its CAD equivalent and stored in the CAD slice in the database. 22 BusinessObjects Planning Excel Analyst User Guide
Basic Concepts Inheritance 2 Source Currency Display Currency TT LC CAD The data you enter is interpreted as Canadian dollars. If TT is defined as CAD+USD+GBP, you can drill down in your report to reveal the CAD, USD, and GBP slices. The data you enter for CAD is stored in the CAD slice as is, but the data you enter for USD is converted to US dollars and stored in the USD slice, and the data you enter for GBP is converted to pounds and stored in the GBP slice. CAD BK N/A The data you enter is stored in the CAD slice as Canadian dollars. No conversion is necessary. TT BK N/A If TT is defined as CAD+USD+GBP, you can drill down in your report to reveal the CAD, USD, and GBP slices. The data you enter for CAD is stored in the CAD slice as Canadian dollars, the data you enter for USD is stored in the USD slice as US dollars, and the data you enter for GBP is stored in the GBP slice as pounds. No conversion takes place. Inheritance Unit s Default reporting currency Result Inheritance is the sharing of properties from one level of report attributes to another level. For example, properties that you set at the report level may be inherited in the columns and rows of the report. In BusinessObjects Planning reports, inheritance of report properties operates from the most general to the most specific levels, as the following list indicates: Model properties, as the most general properties, are used, except where you have defined... Site default properties, which are used, except where you have defined... User default properties, which are used, except where you have defined... Report properties, which are used, except where you have defined... Column properties, which are used, except where you have defined... Row properties, which are the most specific properties. BusinessObjects Planning Excel Analyst User Guide 23
2 Basic Concepts Inheritance Model, site, and user properties are specified using BusinessObjects Planning Administrator and BusinessObjects Planning Analyst and are used if you do not specify a property in the ad hoc report you are creating. However, if you want your user default properties to apply to ad hoc reports, your User default report has to be located in your Public folder. If it is in your Private folder, its settings will not be used. Inheritance applies to report, column, and row properties, as described above. For example, if you set the display currency to CAD in a column and to USD in a row, USD is used for the intersecting cell. 24 BusinessObjects Planning Excel Analyst User Guide
Working with BusinessObjects Planning Reports in Excel chapter
3 Working with BusinessObjects Planning Reports in Excel Accessing and viewing reports in Excel Accessing and viewing reports in Excel Using the BusinessObjects Planning Excel Analyst, you can access, view, and analyze BusinessObjects Planning reports in a Microsoft Excel environment. When you work with BusinessObjects Planning reports in BusinessObjects Planning Excel Analyst you can: Access live BusinessObjects Planning reports and open them in Microsoft Excel Drill down into, view, and edit BusinessObjects Planning reports in Excel Distribute information to a wider audience by providing Excel spreadsheets to non-businessobjects Planning users Select favorites to navigate to reports Open multiple BusinessObjects Planning reports in Excel The BusinessObjects Planning Excel Analyst does not support: The creation or revision of annotations. Cell annotations that exist in the original BusinessObjects Planning report are read-only, and any annotations created within Excel are not included in the BusinessObjects Planning version of the report. Charts created using a BusinessObjects Planning application. However, you can create charts in Excel using BusinessObjects Planning data. Note: It is not necessary for a BusinessObjects Planning application to be running when you use the BusinessObjects Planning Excel Analyst. 26 BusinessObjects Planning Excel Analyst User Guide
Working with BusinessObjects Planning Reports in Excel Logging on to the server 3 Logging on to the server Before you can open a BusinessObjects Planning report within the Excel environment, you are required to log on to a web server. Once you log on to the server, you have access to a hierarchy of favorites that represent live BusinessObjects Planning reports. Before attempting to log on, you should know: The name of the web server onto which you are logging Your user name Your domain Your domain password (the password you use to log on to Windows) To log on to the server: 1. From the BusinessObjects Planning menu, select Log On. 2. In the Log On dialog box, type your server name in the Server text box. 3. In the User text box, type your user name. 4. In the Domain text box, type your domain. (If you do not know your domain, contact your administrator.) 5. In the Password text box, type your password. 6. To save this log on profile, select Save this profile. Note: If you select Save this profile, all information entered in this dialog box is remembered, except for your password. Depending on how your web server is configured to authenticate users, you may not require your domain, name, or password to log on to the server. 7. Click OK. BusinessObjects Planning Excel Analyst User Guide 27
3 Working with BusinessObjects Planning Reports in Excel Using the BusinessObjects Planning Excel Analyst toolbar Working with the Log message workbook When you first attempt to connect to the server from the BusinessObjects Planning Excel Analyst, a Log message workbook is created. This is a page where any error messages, warnings and faults reported by the server are listed, along with the date and time they were generated. The information displayed in the Log window is for the current session only. Once you close Excel, the information is lost; therefore, you may want to save the information as a text file before ending a session. To save the contents of the Log window, select Save from the File menu in Excel. In the Save as dialog box, specify a name and location for the text file and click Save. You can also clear the information in the Log window. You may want to do this to see the exact information a task generates. If you clear the Log window before performing the task, you know that all messages pertain to that task. To clear the contents of the Log window, right-click the window and select BusinessObjects Planning and Clear Log Window from the menu. Using the BusinessObjects Planning Excel Analyst toolbar When you start BusinessObjects Planning Excel Analyst with Excel 2003, you will see the BusinessObjects Planning Excel Analyst toolbar on the screen. To access the toolbar with Excel 2007, you must first click on the Add-Ins tab. The toolbar contains some of the operations you will perform during a typical BusinessObjects Planning Excel Analyst session. Icon Tool Tip Description Open Report Opens a report. Edit Edits a report cell-by-cell. Fast Edit Edits a range of cells. Consolidate Consolidates the data for scenarios that are in parent level units, and displays the updated values in the report. 28 BusinessObjects Planning Excel Analyst User Guide
Working with BusinessObjects Planning Reports in Excel Using the Drill-down toolbar 3 Icon Tool Tip Description Expand Drills down through a selected row of your report. Collapse Collapses a row you have drilled down. Report Options Changes the view currency. Environment Zoom In Zoom Out Hides the grid lines and row and column headings. If the grid lines and headings are hidden, clicking displays them again. Enlarges the view of your report. The report is at its maximum view when it is first imported into Excel. Reduces the view of your report. BusinessObjects Planning Help Accesses online help for the BusinessObjects Planning Excel Analyst. Note: Additional BusinessObjects Planning Excel Analyst commands are available using the BusinessObjects Planning Menu and the right-click menu. The BusinessObjects Planning Menu is located in the menu bar at the top of the Excel 2003 interface and under the Add-ins tab in Excel 2007. You can right-click anywhere within the spreadsheet area to produce the right-click menu, which includes BusinessObjects Planning options. Using the Drill-down toolbar You use the drill-down toolbar to navigate in a report (for example, to expand rows and columns, or to summarize rows and columns). BusinessObjects Planning Excel Analyst User Guide 29
3 Working with BusinessObjects Planning Reports in Excel Using the Drill-down toolbar Icon Tool Tip Description Formula If the selected row of a report contains a formula, drill down to reveal the rows that are used in the formula. Related Line Unit Scenario Drill down on a related line to see its associated line. For example, you could drill down on an Interest Earned line to see an Asset line, or you could drill down on an Asset line to see tis related Interest Earned lines. Drill down from high level units to lower level units. Units are the basic organization framework for business models in BusinessObjects Planning. You can use different unit hierarchies to represent alternative views of your organization, such as line of business and geography. For example, if your units are organized by geography, drill down on the data for a high level unit like North America to see data for a lower level unit like New York City. If the report contains calculated scenario data, drill down and see the pre-calculated amount. Line Currency Balance Type Product Drill down on Heading and Formula lines to see the underlying data. For example, you could drill down on Total Revenues and find Net Interest Income, Fees and Commissions, and Other Income. If the report retrieves a derived currency, such as the total of all currencies, drill down to see each pure currency that makes up that derived currency. If the report retrieves a derived balance type, such as Net After Adjustment, drill down to see the break down of data for the booked balance and the adjustment. Drill down on derived products to see the underlying data. Project Drill down on derived projects to see the underlying data. 30 BusinessObjects Planning Excel Analyst User Guide
Working with BusinessObjects Planning Reports in Excel Opening a report 3 Icon Tool Tip Description Channel Drill down on derived channels to see the underlying data. Customer Drill down on derived customers to see the underlying data. Transaction Drill down on derived transactions to see the underlying data. Time Period Drill down on derived time periods to see the underlying data. Opening a report Once you connect to the server, you can select a report from the Open Report dialog box. This dialog box displays the reports that are stored in your Favorites folder in BusinessObjects Planning Administrator and BusinessObjects Planning Analyst Pro. When the report opens, it displays a Report Summary page. Each report has a default summary page that contains information about that report, including a list of the section names if it is a multi-section report. The section names on the Report Summary page are links to the tabs in which the sections are stored. Tabs cannot be renamed in Excel, but you can change the order of tabs by dragging them to a new position. Excel places certain restrictions on BusinessObjects Planning reports: If there is a BusinessObjects Planning report tab named "Summary," an extension of "_1" is added to the name to distinguish it from the BusinessObjects Planning Excel Analyst summary tab. For example, the tab will be called "Summary_01." Section names are restricted to 31 characters. Section names longer than 31 characters are truncated and replaced by ellipses (...). Section names cannot contain characters such as (,),*,\,?,'. These characters will be removed from a BusinessObjects Planning report opened in Excel. BusinessObjects Planning Excel Analyst User Guide 31
3 Working with BusinessObjects Planning Reports in Excel Opening a report When you click a section name, or its corresponding tab, the section is displayed and only its data is loaded. Data is not loaded for a section until you access it. Note: To reopen a report that you have recently opened, from the BusinessObjects Planning menu, select Open and the report name. To open a report: 1. On the BusinessObjects Planning Excel Analyst toolbar, click (Open Report). You may be prompted to log on if you have not already done so. 2. In the Open Report dialog box, ensure that the Open as an Ad hoc report check box is cleared. Note: For information on opening a BusinessObjects Planning report as an ad hoc report, see Opening a BusinessObjects Planning report as an ad hoc report on page 110. 3. Select the report you want to open. (You may have to expand the hierarchy to see all available reports.) 32 BusinessObjects Planning Excel Analyst User Guide
Working with BusinessObjects Planning Reports in Excel Opening a report 3 4. If the Select Report Dimensions wizard appears, specify members for the missing dimensions. The wizard indicates how many dimensions need to be specified. If you do not have any missing dimensions, skip to Step 8. 5. If your missing dimension is a dimension other than Time Period or Scenario, type the member identifier in the text box provided, and press TAB. OR Click to select a member from a dimension list. See Specifying a missing dimension using the dimension list on page 34 for more information on the dimension list. 6. If your missing dimension is a Time Period, specify the time period components in the boxes provided. See Specifying a missing Time Period dimension on page 36 for more information on specifying a missing time period. 7. If your missing dimension is a Scenario, type the member identifier in the text box provided, and press TAB. OR BusinessObjects Planning Excel Analyst User Guide 33
3 Working with BusinessObjects Planning Reports in Excel Opening a report Click Browse to select a scenario from the list of available scenarios for the report s Unit dimension. In the Scenario Browser, select a scenario, and click OK. 8. On the Report Summary page, click a report section. Specifying a missing dimension using the dimension list When you are opening a report, and are using the Dimension Wizard to select a member for a missing dimension, you can click to view a list of all members of that dimension. You can then select the member from this dimension list. 34 BusinessObjects Planning Excel Analyst User Guide
Working with BusinessObjects Planning Reports in Excel Opening a report 3 From the dimension list, you can select a member by either expanding the dimension tree provided or searching for a member in the dimension tree. To expand a portion of the dimension tree, click the button located to the left of a displayed member. This displays the children of the member. When searching for a member in the dimension tree, you can search by member name or member ID. When searching, you can specify any or all of the following limitations: The search must match the entire word The matched member must start with the text specified in the search The matched member must be the same case as the text specified in the search; for example, TEXT only matches TEXT, not text or Text. (This option is only available if you are searching by member name.) By default, a search matches a member if the search text is contained anywhere in the member name or identifier. To select a member from the dimension list: 1. In the Dimension Wizard, click to display the dimension list. 2. Select a member from the dimension hierarchy displayed. If the member you want to select is not displayed, and you know which part of the dimension hierarchy contains the member, click as necessary to display the member. OR BusinessObjects Planning Excel Analyst User Guide 35
3 Working with BusinessObjects Planning Reports in Excel Opening a report In the Search for dimension member text box, enter some or all of a member name or identifier, and click Find. To repeat the search after finding a member, click Find Next. 3. Click OK to select the member. Specifying a missing Time Period dimension When you are opening a report, and are using the Dimension Wizard to select a member for a missing Time Period dimension, you are asked to supply the three components of the time period identifier: a year, a version, and the time period itself. These components are separated by period characters. An example of a valid time period identifier is 2002.A.M3 (which is the 2002 monthly actuals for month 3). The following table describes the time period identifier components in more detail. Time Period Identifier Component Year range Version Time Period Description Any four-digit year, such as 2003, or one of the following: Current The current year Scenario The scenario s year One of the following: Scenario The scenario s version Actual Actual data Forecast Forecasted data Plan Planned data A valid time period. For details on time periods, see Time Period Tables on page 161. The Dimension Wizard contains boxes for each of these time period identifier components: 36 BusinessObjects Planning Excel Analyst User Guide
Working with BusinessObjects Planning Reports in Excel Understanding how report values are determined 3 To specify a time period: 1. From the Year range list, select a year. 2. From the Version list, select a version. 3. In the Time period text box, type a time period. OR Click Browse and select a time period from the list that appears. If necessary, expand the hierarchy to find the time period you want. Understanding how report values are determined When looking at the data in a report, it is important that you understand how the values are determined. For example, if a report has a variance row and a variance column, the intersecting cell will contain the value for the variance column. This is determined by predefined precedence rules. BusinessObjects Planning Excel Analyst User Guide 37
3 Working with BusinessObjects Planning Reports in Excel Drilling down in a report Row type The following table describes these rules: Column type Text Band & Trend Variance Formula Data Text The cell is Text Text Text Text left blank. Band & Trend Text Band & Trend Band & Trend Band & Trend Band & Trend (col) Variance Text Band & Trend Variance (col) Formula Variance Formula Text Band & Trend Variance Formula (col) Formula Data Text Band & Trend Variance Formula Data Note: For the intersection of Data and Data, the existing precedence rules apply. If a dimension is explicitly set in the Row template, it will override anything set in the Column Template (or higher). Otherwise, the dimension is inherited. Drilling down in a report One of the key differences between viewing and working with BusinessObjects Planning reports instead of a standard spreadsheet program is the ability to drill down rows by dimensions. This allows you to narrow your focus on selected data, displaying its underlying details. Whether you can drill down is determined by: The dimensions in the business model. If the business model contains two or three dimensions only, your choices for drilling down are limited. However, if your business model includes several dimensions (for example, unit, line, currency, product, and channel), your choices are considerable. The type of data in the report. You can either drill from summary data for high-level members to more detailed data for lower level members, or you can drill from calculated data to pure data. When drilling down on a row, you should be aware of the following behavior: When you drill down on a calculated row (for example, a variance row), the rows used in the calculation are displayed. You will get the same result no matter which dimension you drill down. You can then drill down on the rows used in the calculation by a particular dimension to see the details. 38 BusinessObjects Planning Excel Analyst User Guide
Working with BusinessObjects Planning Reports in Excel Changing the Display currency 3 If you drill down on a row by currency, and the resulting currencies have N/A values, the total of the currencies may be zero. Depending on the report settings, if your hierarchy contains calculated formulas, drilling to leaf may stop at the calculated formula's component members. You could then drill to leaf on the component members to display their lowest-level details. When you drill down on a row, the report settings control whether detail rows that contain only zeroes are displayed. To drill down through a report: 1. On the Drill-down toolbar, click the button for the dimension by which you want to drill down. For example, to drill down by Line, click (Line). 2. Right-click a row and select BusinessObjects Planning, Expand to, and one of the following menu options: Leaf Level expands only the lowest level member of the selected row One Level expands the selected row by one level Note: You can collapse a row by right-clicking it and selecting BusinessObjects Planning and Collapse from the menu. Changing the Display currency The Display currency defines how database values appear in the report. When you enter data in a report, it is interpreted as the currency you specified as the Display currency. If you enter data for currencies that do not match the Display currency, the data is converted when it is stored in the database. For example, the Source currency for a report could be set to CAD and the Display currency could be set to USD. In this case, the report retrieves values only from the CAD slice in the database and converts them to, and displays them in, US dollars. If you edit the data for this report, the values you enter are shown in US dollars. When stored in the database, they are converted to Canadian dollars and stored in the CAD slice. Note: Another name for Display currency is View currency. For more information on the display currency, see Currency settings on page 20. To change the Display currency: 1. On the BusinessObjects Planning Excel Analyst toolbar, click (Report Options). BusinessObjects Planning Excel Analyst User Guide 39
3 Working with BusinessObjects Planning Reports in Excel Launching a task from within a report 2. In the Report Options dialog box, select the currency in which you want to view the report. (You may have to expand the hierarchy to see all available currencies.) 3. Click OK. Launching a task from within a report You can launch a task (also referred to as a script) from inside a report and see its effect immediately. For this feature to work, a Site Administrator has to set up the task for that report. To run a task, in an open report, right-click a data cell and select BusinessObjects Planning, Tasks, and the name of the task from the menu. Note: You cannot run tasks that use dialog boxes in the BusinessObjects Planning Excel Analyst. Pivoting a report section You can pivot a report section. This means that the columns and the rows for a report section are switched. To pivot a report, the rows or columns cannot be drilled down, the row template must not have page breaks, and the column template cannot contain super-titles. 40 BusinessObjects Planning Excel Analyst User Guide
Working with BusinessObjects Planning Reports in Excel Editing data in a report 3 To pivot a report section, right-click a cell in the report section, and select BusinessObjects Planning and Pivot Section from the menu. Editing data in a report When you edit data, you are actually editing scenarios. A scenario is a collection of BusinessObjects Planning data that is stored in a database. There are two ways in which you can edit data: regular edit mode and fast edit mode. In regular edit mode, each cell s existing value is updated by the BusinessObjects Planning server before you edit it. In fast edit mode, the cells you edit do not have their values updated by the server as you edit them, which allows you to edit more quickly. In either mode, the database is not updated until you save the report data. For information on saving report data, see Saving changes to data on page 64. Note: You can only be in edit mode, whether it be regular or fast, in a single section of a report at one time. You must exit edit mode before switching to a different section of a report. For more information, see Updating multi-section reports on page 42. To edit data, you must meet the following conditions: Data can only be edited in Excel if the equivalent data can be edited in the BusinessObjects Planning version of the report. In particular, you can only edit data at the input level. Depending on your site's configuration, only one user may be able to edit a cell at a time. If concurrent editing of scenarios is allowed at your site, multiple users can simultaneously edit the data contained in a scenario. You can include additional text at the bottom of a report for reference purposes, but any text added in Excel will not appear in the BusinessObjects Planning version of the report. You can also annotate cells, but annotations created in Excel will not appear in the BusinessObjects Planning version of the report. Annotations that are a part of the original BusinessObjects Planning report can be viewed but not edited in Excel. If the cell is associated with a related line, you can enter the value as either a dollar amount or a rate. To enter a rate value, type a percentage sign before the cell data. Data that is not preceded by a percentage sign defaults to a dollar value. To enter an N/A value, type N/A, na, n/a, or (na) into the report cell. Unlike entering zero, entering N/A ensures the value of the cell is ignored in calculations. This is critical when performing, in particular, statistical calculations where a 0 value could significantly alter the outcome of the calculation. BusinessObjects Planning Excel Analyst User Guide 41
3 Working with BusinessObjects Planning Reports in Excel Editing data in a report The changes you make do not immediately appear in the parent level units of the report or in other reports referencing the same data. You have to consolidate the data to update the data in parent level Units. For information on consolidating data, see Consolidating report data on page 43. Note: The changes you make do not immediately appear in other sections of the report. To edit data in regular edit mode: 1. On the BusinessObjects Planning Excel Analyst toolbar, click (Edit). 2. Click inside the cell you want to edit, and begin editing the cell data. 3. Press ENTER. 4. Repeat steps 2 and 3 for each cell that you want to edit. 5. To exit regular edit mode, release (Edit). To edit data in fast edit mode: 1. On the BusinessObjects Planning Excel Analyst toolbar, click (Fast Edit). 2. Click inside the cell you want to edit, and begin editing the cell data. Repeat this step for any number of cells. You can use the tab key or the up and down arrows on your keyboard, as well as the mouse, to navigate from cell to cell. Note: You can cut and paste entire ranges of cells in fast edit mode. 3. To exit fast edit mode, click (Fast Edit). Updating multi-section reports When using the BusinessObjects Planning Excel Analyst, each section of a multi-section report is updated separately. If you change data in one section, other sections of your report are not automatically updated to reflect this change. If you want to see your changes to report data migrated to all report sections, you must close the report and reopen it. The only exception to this is if a change affects a report section that you have not yet viewed. In this case, you will see the latest updates when you view the section for the first time, as the BusinessObjects Planning Excel Analyst only retrieves report section data when you first view it. 42 BusinessObjects Planning Excel Analyst User Guide
Working with BusinessObjects Planning Reports in Excel Copying data between Excel and BusinessObjects Planning Analyst 3 Copying data between Excel and BusinessObjects Planning Analyst You can copy and paste a range of cells from Excel to BusinessObjects Planning Analyst and from BusinessObjects Planning Analyst to Excel. If you are copying from BusinessObjects Planning Analyst to the BusinessObjects Planning Excel Analyst, you must start Excel before beginning the copy operation. Note: To copy from Excel to BusinessObjects Planning Analyst, you must be in Fast Edit mode in BusinessObjects Planning Analyst before pasting cell data into a report. To copy from BusinessObjects Planning Analyst to the BusinessObjects Planning Excel Analyst, you must be editing data in the BusinessObjects Planning Excel Analyst before pasting cell data into a report. To copy data from Excel to BusinessObjects Planning Analyst: 1. In the report you want to copy from, select a range of cells. 2. Right-click the cells, and select Copy from the menu. 3. In the report you want to copy to, right-click anywhere in the report and select Paste from the menu. Consolidating report data If you have made changes to the data in a report, you can consolidate it, which updates the data for scenarios that are in parent level units and displays the updated values in the report. The consolidation only affects the units that you have open in the report. Any scenarios that you have edited are checked in before consolidation takes place. Consolidating may be time-intensive, depending on the units affected. To reduce the consolidation time, you can choose which units and scenarios to consolidate. The Size field of the consolidation dialog box contains an integer value that provides an estimate of the time required to consolidate the unit and scenario. A Size value of OK indicates a scenario that is not a parent-level unit, and cannot be consolidated. The Size value also indicates whether you have the rights to consolidate a unit and scenario. If you do not have the rights to consolidate a scenario, the Size value is enclosed in parentheses. If you have partial rights to consolidate BusinessObjects Planning Excel Analyst User Guide 43
3 Working with BusinessObjects Planning Reports in Excel Consolidating report data a scenario, the Size value is marked with an asterisk; this normally happens when your scenario is a Compound scenario, and you have rights on only some of the Compound scenario's component scenarios. To consolidate data: 1. On the BusinessObjects Planning Excel Analyst toolbar, click (Consolidate). 2. In the dialog box that appears, click OK to check in any checked-out scenarios used by the report. 3. In the Warning dialog box, click Details. 4. From the list, select the units and scenarios you want to consolidate. Note: Scenarios with a size of OK cannot be selected because they are not parent level units. 5. Click OK. 44 BusinessObjects Planning Excel Analyst User Guide
Working with BusinessObjects Planning Reports in Excel Projecting future performance 3 Projecting future performance In planning and forecast reports, you can define and use projections, which calculate future data values based on past data. The following example shows a report that calculates values for May, June, July, and August based on values from January, February, March, and April. The projection method used in this example is Run Rates, which calculates the average value from January through April and projects that value forward. Note: For information on specifying projection methods, see Using predefined projections on page 50 and Defining a projection on page 50. The following table describes the projection methods that you can use to calculate future values: BusinessObjects Planning Excel Analyst User Guide 45
3 Working with BusinessObjects Planning Reports in Excel Projecting future performance Projection method Run Rates Linear Trend Growth Trend Description Use this method when the source data is relatively constant from period to period, and this average run rate is expected to continue into the projection period. This method projects the average value of historical data. For example, if you select four source time periods, the target time periods all display the same value, which is an average of the four source time periods. Source 4 5 4 5 Target 4.5 4.5 4.5 4.5 Use this method when you expect that the projected data will change by the same absolute amount in each time period, based on the trend in the source range. This method produces a straight line rather than the increasing or decreasing curve produced using the Growth Trend method. If the values of the source time periods are not linear, this method smoothes out the trend to produce the straight line for the target time periods. Source 100 150 250 200 Target 275 315 355 395 Use this method when you know that there is, or has been, increasing or decreasing growth in past periods. This method produces an increasing or decreasing curve rather than the straight line produced using the Linear Trend method. If the values of the source time periods are increasing over time, this method produces an upward curve. If the values are declining, this method produces a downward curve. The values of the source time periods must be positive numbers. Source 100 150 200 250 OR 200 150 150 125 Target 353.55 478.99 648.94 879.19 108.25 94.02 81.65 70.91 46 BusinessObjects Planning Excel Analyst User Guide
Working with BusinessObjects Planning Reports in Excel Projecting future performance 3 Projection method Linear Series Growth Series Seasonal Description Use this method when you expect a fixed amount of growth in each period. This method uses an additive growth factor to generate forecasted values. If you select more than one source time period, the last source time period is used to calculate the value for the first target time period. The next target time period is calculated as the value of the first target time period plus the additive growth factor, and so on. For example, if the last source time period you select has a value of 12,000 and you specify the Linear Series growth factor to be equal to 100, the values for four target time periods will be 12,100, 12,200, 12,300, and 12,400. Source 9,000 12,000 Target 12,100 12,200 12,300 12,400 Use this method when you expect that the data will change by the same percentage from one period to the next. For each target time period, the value of the previous time period is multiplied by the percentage growth factor to generate the projected value. If you select more than one source time period, the last source time period is used to calculate a value for the first target time period. The value of the first target time period is then used to calculate the value for the second target time period, and so on. For example, if the last source time period you select has a value of 12,000 and if you specify the Growth Series growth factor to be equal to 1.1 (a 10% increase), the values for four target time periods will be 13,200, 14,520, 15,972, and 17,569. Source 9,000 12,000 Target 13,200 14,520 15,972 17,569 Use this method when an annual seasonal pattern exists and you want to reflect the same pattern in the projection period, along with some growth. This method applies a growth factor to each source time period to generate forecasted values. (This method requires that you have equal numbers of source and target time periods.) For example, if two source time periods have values of 10,000 and 12,000, and you specify the Seasonal growth factor to be equal to 1.1 (10%), the two target time periods will have values of 11,000 and 13,200. Source 10,000 12,000 Target 11,000 13,200 BusinessObjects Planning Excel Analyst User Guide 47
3 Working with BusinessObjects Planning Reports in Excel Projecting future performance Projection Description method Naive Forecasting Use this method to provide users with a base case for projecting items that are not expected to change significantly year over year. This method uses the values of the source time periods to generate the forecasted values. The number of source time periods must be greater than or equal to the number of target time periods. For example, if four source time periods have values of 100, 150, 200, and 250 respectively, the four target time periods will have values of 100, 150, 200, and 250 respectively. Source 100 150 200 250 Target 100 150 200 250 48 BusinessObjects Planning Excel Analyst User Guide
Working with BusinessObjects Planning Reports in Excel Projecting future performance 3 Projection method Moving Average Single Exponential Smoothing (SES) Description Smoothes out past data by averaging the last several periods and projecting that value forward. The number of source time periods you choose determines the number of time periods used to calculate each projected value. For example, if you choose four source time periods, each projected value is an average of the previous four time periods. For example, suppose that you have four source time periods with values of 100, 150, 200, and 250 respectively. Your first target time period will have a value of 175, which is the average of the source time periods. The next target time period will have a value of 193.75, which is the average of the last three source time periods and the first target time period. Subsequent target time periods will be the average of the last four time periods calculated. Source 100 150 200 250 Target 175 193.75 204.69 205.86 Projects future values by calculating a weighted average. The smoothing value determines how the weighting occurs. The smoothing value must be between 0 and 1. If you specify 0, 100% of the weighting is applied to the value for the last time period. If you specify 1, 100% of the weighting is applied to the value for the first time period. A smoothing value closer to 1 places more emphasis on values for older time periods, and a smoothing value closer to 0 places more emphasis on values for more recent time periods. This allows you to specify whether the projected values should be more sensitive to recent changes in the data or more sensitive to older data values. For example, suppose the source time periods are 500, 600, 700, and 1,000. If you specify a smoothing value of 0.2, the more recent source time periods will have a greater weighting than the earlier values. As a result, the projected value will be greater than the non-weighted average of the source time periods because the last two source time periods have larger values. However, if you specify a smoothing value of 0.8, the older source time periods have greater weighting. As a result, the projected value is less because the values of the older time periods are smaller. Smoothing value = 0.2 Source 500, 600, 700, 1,000 Smoothing value = 0.8 Source 500, 600, 700, 1,000 Target 935, 935, 935, 935 Target 645, 645, 645, 645 BusinessObjects Planning Excel Analyst User Guide 49
3 Working with BusinessObjects Planning Reports in Excel Projecting future performance Using predefined projections You can project values in a BusinessObjects Planning report only if the report creator enables projections for the section of the report that you are viewing. When projections are enabled, the report creator may have defined one or more projection methods for use in the report. To project values using a predefined projection method, select one or more rows of the report, right-click a selected row, and select BusinessObjects Planning, Projection and the name of the projection from the menu. If you cannot select Projection, projections have not been enabled for your report. Projection is only possible if the report has not been pivoted. The report creator may also have allowed you to define your own projection method for the report. For more information on defining your own projection method, see Defining a projection on page 50. For information on how to enable projections for a report, see the Reporting Guide. Defining a projection You can define projections for your report if the report creator has granted permission to do so. When you define a projection, you are specifying the time periods on which to base the projection, the projection method to use, and the time periods in which to project values. For best results: 50 BusinessObjects Planning Excel Analyst User Guide
Working with BusinessObjects Planning Reports in Excel Projecting future performance 3 Make sure the column template contains time periods Use as many source time periods in your historical data set as possible And remember that: You can hide the columns containing the source time periods to make the report easier to read The data in the report has to be editable To define a projection: 1. Select one or more rows of the report. 2. Right-click a selected row, and select BusinessObjects Planning, Projection, and Define Projection from the menu. Note: If Define Projection is not available, you may not have permission to define projections for this report. See the Reporting Guide for more information on projection permissions. BusinessObjects Planning Excel Analyst User Guide 51
3 Working with BusinessObjects Planning Reports in Excel Projecting future performance 3. In the Projection Input Parameters dialog box, select the time periods on which you want to base the projection. (The list contains all of the time periods in the column template.) 4. Specify whether you want to apply the projection to selected items only or to all items in the section. (This setting determines whether the projection is applied to the rows you have selected or to the entire section.) 5. Click Next. 6. In the Projections Methods dialog box, select a projection option from the Method list. (For a description of the methods, see Projecting future performance on page 45.) 52 BusinessObjects Planning Excel Analyst User Guide
Working with BusinessObjects Planning Reports in Excel Projecting future performance 3 7. If the projection method you select requires parameters, specify them in the Projection parameters text boxes. 8. Click Next. 9. In the Projection Output Parameters dialog box, select the time periods to which you want to project future values. Note: After you have specified the default projection settings, if you delete the columns you have specified as the source or target, you will not be able to repeat the projection. BusinessObjects Planning Excel Analyst User Guide 53
3 Working with BusinessObjects Planning Reports in Excel Prorating data 10. To specify an alternative balance type in which to store the future values, click the Write incremental values to selected balancetype option, then choose a balance type from the list. (You may want to select an alternative balance type if the output time periods you select contain actual data. In this way, you ensure that you do not overwrite actuals.) Prorating data To select a balance type from this dimension list, follow the steps described in Specifying a missing dimension using the dimension list on page 34. 11. Click Project Now to perform the projection. In planning and forecast reports, you can enter or adjust data at a summary level and then prorate those values down to a detailed level. When you are working with prorations, keep the following points in mind: The proration feature is enabled at the section level. If you want to prorate data, prorations must be enabled in each section you want to use. To use prorations, the section must contain time periods in the column template. If you perform a proration on units, you will not see the results until you consolidate the data. 54 BusinessObjects Planning Excel Analyst User Guide
Working with BusinessObjects Planning Reports in Excel Prorating data 3 Proration methods You can choose how you want to prorate data using three proration methods: Distribute Evenly, Leaf Based, and Scenario Based. The values distributed to each member of the target scenario depend on the proration method you choose. Distribute Evenly When using the Distribute Evenly proration method, a value, which you define, is divided evenly from the target data cells at the parent level, then distributed down to the leaf-level members. In the following example, 8000 was entered as the value to prorate over Total Income for October 2002. Using Distribute Evenly proration, 8000 is distributed evenly to each child member of Total Income. Since there are two child members of Total Income, each receives a value of 4000. The value of 4000 is then distributed evenly to each child member of License Fee and Support. Leaf Based When using Leaf Based proration, a value, which you define, is divided among the target data cells at the leaf level using the same ratio as the target scenario. The values at the leaf level are then rolled up to the parent level. In the following example, 6000 was entered as the value to prorate over Total Income for October 2002. Using Leaf Based proration, 6000 is distributed to the leaf-level members. Since there are six leaf-level members, each receives a value of 1000. These values are then rolled up to the parent level to total 6000. BusinessObjects Planning Excel Analyst User Guide 55
3 Working with BusinessObjects Planning Reports in Excel Prorating data Scenario Based When using the Scenario Based proration method, the value of the source data cell is divided among the target data cells using the same ratio as another scenario. In the following example, Investments Securities Held to Maturity is the parent line of the other lines in the report. The prorated value of 1,000,000 is divided among the child lines for each month in 2003. In this example, the prorated value is divided based on the monthly results from 2003. Determining the behavior of prorations When prorating data, the results of your proration depend on several factors, including the type of scenario associated with the report and the type of lines contained in the report. Prorating using different scenario types The behavior of your proration depends on the type of scenario associated with the report, as described in the following table. 56 BusinessObjects Planning Excel Analyst User Guide
Working with BusinessObjects Planning Reports in Excel Prorating data 3 Scenario type Editable Rollup Calculated Compound Proration behavior across units The proration is applied across the target time periods and down to the leaf-level members. When you consolidate, the values in the leaf-level members are rolled up to their parents to give the total for each target time period. The proration is applied to the unit dimension members specified in the consolidation formula for the scenario, provided the report scenario for the leaf is Editable. Normally, these will be the leaf-level descendants of the unit. Adjustments entered using an adjustment rollup balance type are cleared. The Rollup scenario consolidates the values of the Editable scenarios that are below it in the unit hierarchy. Proration cannot be performed. The source time period for the proration (specified in the Proration Input Parameters dialog box) indicates the scenario on which the proration is to be performed. If this scenario is an Editable or a Rollup scenario, the proration is performed as previously described. If this scenario is a Calculated scenario, the proration is not performed. Prorating Revisable lines When prorating revisable lines, the results of the proration may differ depending on the proration method you choose and the type of data cells you are prorating. The following rules apply: When prorating revisable lines using Scenario Based proration, if the source data cell is revised, the target data cell will be treated as a revised cell, and the value is not prorated to the children of that member. If the source data cell is not revised and the target data cell is revised, the target data cell is treated as not revised and the target data cell and its children are prorated. When prorating revisable lines using Leaf Based or Distribute Evenly proration, a revisable target data cell is always treated as not revised and the value is prorated to the children members. For information on Revisable lines, see the Administrator s Guide. Prorating lines that are input within a version When prorating lines that are input within a scenario version, such as Actual, Forecast, or Plan, the results of the proration may differ depending on the proration method you choose and the type of data cells you are prorating. The following rules apply: BusinessObjects Planning Excel Analyst User Guide 57
3 Working with BusinessObjects Planning Reports in Excel Prorating data When prorating lines that are input within a version using any proration method, if the target data cell is input, the prorated value is not distributed to the child members of the target data cell. When prorating lines that are input within a version using scenario based proration, if the source data cell is input and the target is a formula, leaf based proration is always used to prorate values to the child members of the target data cell. For information on Input Within lines, see the Administrator s Guide. Prorating formula lines You can prorate formula lines that contain other formula lines, input lines, and rates. The formula lines you prorate can use addition, subtraction, multiplication, and division; however, they can contain one operator only. For example, you can prorate a formula line that uses multiplication only, but you cannot prorate a formula line that contains both multiplication and division. If you want to prorate more complex formulas, you can do so by referencing other formula lines within the formula of the line that you are prorating. Using predefined prorations You can prorate in a BusinessObjects Planning report only if the report creator enables prorations for the section of the report that you are viewing. When prorations are enabled, the report creator has defined one or more proration methods for use in the report. To prorate values using a predefined proration method, select one or more rows of the report, right-click a selected row, and select BusinessObjects Planning, Proration and the name of the proration from the menu. 58 BusinessObjects Planning Excel Analyst User Guide
Working with BusinessObjects Planning Reports in Excel Prorating data 3 Proration is only possible if the report has not been pivoted. The report creator may also have allowed you to define your own proration method for the report. For more information on defining your own proration method, see Defining a proration on page 59. For information on how to enable prorations for a report, see the Reporting Guide. Defining a proration You can define prorations for your report if the report creator has granted permission to do so. When you define a proration, you are specifying the source time period, the proration method to use, the value to prorate, and the target time periods for the prorated data. For example, if you expect deposits to increase by 10% across the board, you can define a proration that increases a current source value by 10% and prorates this increased value on all children of the source value. Report users can then use this proration instead of having to define their own. The following is a list of rules that apply to the value you choose to prorate: If you do not specify a value to prorate (you leave it blank), the existing source value is prorated. BusinessObjects Planning Excel Analyst User Guide 59
3 Working with BusinessObjects Planning Reports in Excel Prorating data You can enter the value to prorate as a negative amount by typing =- before the value. For example, if the value you want to prorate is - 1,000,000, type =-1000000. You can also specify that you want the existing source value to increase or decrease by an absolute amount or a percent. For example, if the existing source value is 100,000, and you want to prorate 150,000, type +50000. If the existing source value is 100,000 and you want to prorate a value that is 10% less, type -10%. In this case, a value of 90,000 is prorated. When prorating data, you select a source and target time period. A source time period can be: A derived time period (for example, a full year plan) in the same scenario as the target time periods. You would do this if you know the full-year plan amount and want to distribute this to each month. A derived time period (for example, full year actual) in a different scenario than the target time periods. You would do this if you wanted to increase a plan by a certain percentage over last year s actual data. An input time period (for example, January plan) that is the same as the target time period. You would do this if you wanted to adjust the January plan by $100,000. The target time period receives a partial amount of the total prorated value. The amount the target receives is determined by the proration method. Selecting a derived time period distributes a partial amount to each of its leaf time periods. For example, if you select a full-year time period, all of the months for that year receive data. You can prorate from: A non-derived time period to a non-derived time period A non-derived time period to a derived time period A derived time period to a derived time period, if the source and the target have the same frequency. For example, you can prorate from Q1 to Q2, from Q1 to M1, M2, and M3, and from M? to M+6. Suppose, for example, that you want to set up a report that allows users to plan monthly expenses for 2005 based on actual expenses from 2004. The users want to see prorated values for their branch and any units below it. To set up this report, you need a column template with the total for 2004 actuals and a column for each month in the 2005 plan. You would then enable prorations and specify the following default settings: Source time period: 2004 full year actuals 60 BusinessObjects Planning Excel Analyst User Guide
Working with BusinessObjects Planning Reports in Excel Prorating data 3 Method: Leaf Based (or use Scenario Based and specify the 2004 monthly actuals scenario) Value: Leave this blank to prorate the value in the source time period Target time periods: January-December 2005 To define a proration: 1. If you are performing a scenario-based proration on all children including units, consolidate the report before prorating. This ensures that your proration is performed using the correct data. 2. Select one or more rows of the report. 3. Right-click a selected row, and select BusinessObjects Planning, Proration, and Define Proration from the menu. Note: If Define Proration is not available, you may not have permission to define prorations for this report. See the Reporting Guide for more information on proration permissions. 4. In the Proration Input Parameters dialog box, select the time period to use as the source. 5. Specify whether you want to apply the proration to selected rows only or to all rows in the section. BusinessObjects Planning Excel Analyst User Guide 61
3 Working with BusinessObjects Planning Reports in Excel Prorating data 6. Specify the items on which you want to perform the proration. 7. Click Next. 8. In the Prorations Methods dialog box, select a proration option from the Method list. 9. Specify the value to prorate. (The value you specify is entered as the value for the source time period. If you leave this blank, the existing source value is prorated. This only works for one row at a time.) 10. Click Next. 62 BusinessObjects Planning Excel Analyst User Guide
Working with BusinessObjects Planning Reports in Excel Prorating data 3 11. In the Proration Output Parameters dialog box, select the target time periods. 12. To specify an alternative balance type in which to store the prorated values, click the Write incremental values to selected balancetype option, then choose a balance type from the list. Note: If the output time periods you select contain actual data, you may want to select an alternative balance type. In this way, you ensure that you do not overwrite actuals. BusinessObjects Planning Excel Analyst User Guide 63
3 Working with BusinessObjects Planning Reports in Excel Saving changes to data To select a balance type from this dimension list, follow the steps described in Specifying a missing dimension using the dimension list on page 34. 13. Click Prorate Now to perform the proration. Note: If you delete the columns you have specified as the source or target, you will not be able to repeat the proration. Saving changes to data If you have modified the data in a report, you can save it. Your choices are to: Save and check in scenarios, which copies the data to the database Save to a working copy (save and leave the scenarios checked out) Abandon all changes (undo the checked-out scenarios) To save changes to data: 1. From the BusinessObjects Planning menu, select Save and Changes to Scenarios. 2. In the Save Changes to Scenarios dialog box, select an option, and click OK. Saving a report as an Excel file You can save a BusinessObjects Planning report as an Excel spreadsheet (.xls file), which is useful when you need to distribute reports to non- BusinessObjects Planning users. To save a report as an Excel file: 1. On the Excel toolbar, click (Save). 64 BusinessObjects Planning Excel Analyst User Guide
Working with BusinessObjects Planning Reports in Excel Logging off of the server 3 2. In the Save As dialog box, specify a name and location for the spreadsheet and click Save. Logging off of the server You can log off to end a report session. Logging off of the application assists in the conservation of server resources, improving overall performance of the BusinessObjects Planning Excel Analyst. To log off of the server, from the BusinessObjects Planning menu, select Log Off. BusinessObjects Planning Excel Analyst User Guide 65
3 Working with BusinessObjects Planning Reports in Excel Logging off of the server 66 BusinessObjects Planning Excel Analyst User Guide
Working with Ad Hoc Reports in Excel chapter
4 Working with Ad Hoc Reports in Excel Overview Overview Ad hoc reporting is an extension of the BusinessObjects Planning Excel Analyst, and becomes available when you install the BusinessObjects Planning Excel Analyst. Some functionality is shared between the BusinessObjects Planning Excel Analyst and ad hoc reporting. For example, ad hoc reporting is Web-enabled, it accesses the BusinessObjects Planning Server through your Internet or Intranet, and you do not have to run a BusinessObjects Planning application to use it. Ad hoc reporting is unique in that it allows you to create reports that query business rules and data in your BusinessObjects Planning environment. Primarily, ad hoc reporting allows you to: Use report areas or functions to create one or more reports that query business rules and data from your BusinessObjects Planning environment Retrieve data from the database Upload the data you enter to the database Ad hoc reporting also allows you to: Open a copy of a BusinessObjects Planning report as an ad hoc report Create and edit reports offline Drill down from summary information to more detailed data Format reports using Microsoft Excel functionality and take advantage of all other Excel tools (for example, charting) E-mail reports to another user Specify the display state of data in an ad hoc report by specifying whether the data is a dollar amount or a rate. If you are specifying the display state of the data, type either a % for rate or a $ for a dollar amount. If a row is set to rate and a column to dollar, the setting for the row is used for the intersecting cell. Note: For information on how to use Microsoft Excel functionality, see the online help that comes with that application. Ad hoc reporting does not allow you to modify existing BusinessObjects Planning reports. You can perform this task using BusinessObjects Planning reports. For more information, see Working with BusinessObjects Planning Reports in Excel on page 25. 68 BusinessObjects Planning Excel Analyst User Guide
Working with Ad Hoc Reports in Excel Logging on to the server 4 Logging on to the server You can create ad hoc reports while working online or offline. Some tasks, such as validating a business model, require that you be logged on to the server. However, if you try to perform these tasks while working offline, you are automatically prompted to log on. Before attempting to log on, you should know: The name of the web server onto which you are logging Your user name Your domain Your domain password (the password you use to log on to Windows) To log on to the server: 1. From the BusinessObjects Planning menu, select Log On. 2. In the Log On dialog box, type your server name in the Server text box. Note: All information entered in this dialog box is remembered, except for your password. Depending on how your web server is configured to authenticate users, you might not require your domain, name, or password to log on to the server. 3. In the User text box, type your user name. 4. In the Domain text box, type your domain. (If you do not know your domain, contact your administrator.) 5. In the Password text box, type your password. 6. To save this log on profile, select Save this profile. 7. Click OK. BusinessObjects Planning Excel Analyst User Guide 69
4 Working with Ad Hoc Reports in Excel Logging on to the server Using the Log message workbook When you first attempt to connect to the server from the BusinessObjects Planning Excel Analyst, a Log message workbook is created. This is a page where any error messages, warnings and faults reported by the server are listed, along with the date and time they were generated. The information displayed in the Log window is for the current session only. Once you close Excel, the information is lost; therefore, you may want to save the information as a text file before ending a session. To save the contents of the Log window, select Save from the File menu in Excel. In the Save as dialog box, specify a name and location for the text file and click Save. You can also clear the information in the Log window. You may want to do this to see the exact information a task generates. If you clear the Log window before performing the task, you know that all messages pertain to that task. To clear the contents of the Log window, right-click the window and select BusinessObjects Planning and Clear Log Window from the menu. Writing a Log message From within an Excel macro, you can use the CLogMessage macro to write messages to the Log message workbook. This allows you to warn users of unusual conditions. When you call CLogMessage, you must pass the message as a parameter. For example: CLogMessage "Missing data in report!" To create a macro that writes a log message: 1. Create a macro using the Excel macro creation functionality. (Refer to the Microsoft Excel help for information on how to create macros in Excel.) 2. From the Tools menu, select Macro and Macros. 3. From the Macro window, select your macro from the list provided, and click Edit. 4. In the Microsoft Visual Basic window, select Tools and References. 5. Select the BusinessobjectsPlanningExcelAnalyst check box to link your current code with the BusinessObjects Planning project. 6. Click OK. 7. In the Code window, which contains the code for your macro, add the CLogMessage macro. This macro can be in either of two formats: CLogMessage "Missing data in report!" 70 BusinessObjects Planning Excel Analyst User Guide
Working with Ad Hoc Reports in Excel Using the Ad hoc toolbar 4 Application.Run "CLogMessage", "Missing data in report!" If you use the second format, you do not need to follow steps 4, 5, and 6 above, as this format is independent of any project dependencies. 8. In the Microsoft Visual Basic window, from the File menu, select Close and Return to Microsoft Excel. 9. Save your Microsoft Excel file. Using the Ad hoc toolbar When you start the BusinessObjects Planning Excel Analyst, you will see the Ad hot toolbar on the screen. It contains some of the operations you will perform when using ad hoc reporting. Icon Tool Tip Description Validate Report Validates the report to ensure that the report design is correct and that the member identifiers are valid. Checking this button will not validate the business model. Refresh Ad Hoc Report Upload Data Validates the report, retrieves data from the database, and displays it in the report. Validates the report and sends data to the database. Upload and Refresh Validates the report, sends data to the database, retrieves the updated data, and displays it in the report. This is useful for updating planning lines, and then downloading the updated totals or ratios, all in one step. Creating ad hoc reports There are two ways to create ad hoc reports using the BusinessObjects Planning Excel Analyst: You can define report areas and download report data into them (see Creating ad hoc reports using report areas on page 72) You can specify BusinessObjects Planning functions in cells that retrieve report information from the database (see Creating ad hoc reports using functions on page 108) BusinessObjects Planning Excel Analyst User Guide 71
4 Working with Ad Hoc Reports in Excel Creating ad hoc reports Note: You can specify a BusinessObjects Planning function in a cell contained in a report data area. In this case, the value of the function overrides the value that would otherwise be displayed in the cell. When you create ad hoc reports, you do not need to have BusinessObjects Planning Administrator or BusinessObjects Planning Analyst Pro installed. However, you do have to understand how your organization s business rules are set up in your BusinessObjects Planning environment. You also need to understand the basic BusinessObjects Planning report building rules. For example, if you are creating a planning report in which you want users to be able to enter data, all the members you specify for the report must be at the lowest level in their respective hierarchies or they must be revisable lines. However, if you specify a revisable line in the report, there are implications when uploading data to the database. Note: If you do not specify a dimension at the row, column, or report level, the report inherits defaults from the user, site, or model level. These defaults are specified using BusinessObjects Planning Administrator or BusinessObjects Planning Analyst Pro. Creating ad hoc reports using report areas In the BusinessObjects Planning Excel Analyst, you can create a report by specifying a report area, which is a block of cells on a worksheet. You then build your report by specifying a business model, columns, rows, and report properties within this report area. You can create multiple reports in a single worksheet by specifying a report area for each report, provided the maximum number of data cells in the worksheet does not exceed the cell upload or cell download limit imposed by your site. (Contact your system administrator for more details on these limits.) At a minimum, to create a report, you must: Specify a report area Specify a business model (Do this before specifying columns, rows, or report properties.) Specify columns Specify rows Specify report properties, such as the dimensions not specified in the columns and rows (See Specifying section properties using the Dimension Wizard on page 89.) You also have the option to: 72 BusinessObjects Planning Excel Analyst User Guide
Working with Ad Hoc Reports in Excel Creating ad hoc reports 4 Specify general rates and currency exchange rates (Although you can apply rates to rows, columns, and the entire report, it makes most sense to add them to rows.) Specify the display currency (See Currency settings on page 20.) Specify the state of the data (You can specify whether data is a dollar amount or a rate. By default, data is interpreted as dollar amounts and therefore if you want it displayed as a rate, you must specify the display state.) Specify whether to allow data to be uploaded (See Specifying whether to allow data to be uploaded on page 100.) If you do not specify a dimension at the row, column, or report level, the report inherits defaults from the user, site, or model level. These defaults are specified using BusinessObjects Planning Administrator or BusinessObjects Planning Analyst Pro. Specifying report areas You can create an ad hoc report on a worksheet by specifying a report area. Within this report area, you then build your report by specifying a business model, columns, rows, and section properties. To specify a report area for an ad hoc report: 1. Click the cell you want as one corner of the report area, hold down the SHIFT key, and click the cell that you want as the opposite corner of the report area. 2. Right-click a cell and select BusinessObjects Planning and Create New Report Area from the menu. BusinessObjects Planning Excel Analyst User Guide 73
4 Working with Ad Hoc Reports in Excel Creating ad hoc reports Renaming report areas For each report area you create, BusinessObjects Planning assigns the name INEACONTAINER_REPORTx, where x is a number beginning with 0 and incrementing with each report area you create. For example, BusinessObjects Planning defines the first report area you create as INEACONTAINER_REPORT0, the second as INEACONTAINER_REPORT1, and so forth. If the name of a BusinessObjects Planning report area contains double digits, such as when you create more than 10 report areas in a single BusinessObjects Planning report, BusinessObjects Planning ignores the last digit in the name and the report does not refresh properly. To ensure that the report refreshes correctly, you should replace the last two characters in the report area name with a single character. For example, when you specify the eleventh report area, it will be assigned the name INEACONTAINER_REPORT10, which you can rename to INEACONTAINER_REPORTA. To rename a report area: 1. From the Insert menu, select Name and Define. 2. Select the name you want to change from the Names in Workbook list. 3. Type a new name in the Names in Workbook text box and click Add. 4. To delete the original name, select it from the Names in Workbook list and click Delete. Specifying a business model If you are using report areas to create a report, you need to specify which business model to use with each ad hoc report you create. The dimensions that appear in the Ad hoc menus change depending on your choice of business model. The dimensions for each model that you specify are saved in the registry. If you specify a new business model that is not part of the registry, you are prompted to log on to the server to retrieve the rules for the new model. Once you do so, the settings for that model are also saved to the registry. When you create a report offline using a model that you have previously used, the dimensions that appear in the Ad hoc menus are based on the model settings saved in the registry. Therefore, you may occasionally want to log on to the server and validate the models to ensure that they accurately reflect what is in the BusinessObjects Planning environment, for example, to ensure that no additional dimensions have been added since you specified the business model or you last validated it. For more information on validating a business model, see Validating business models on page 76. 74 BusinessObjects Planning Excel Analyst User Guide
Working with Ad Hoc Reports in Excel Creating ad hoc reports 4 To specify a business model for ad hoc reports: 1. Right-click a cell, and select BusinessObjects Planning, Business Model, and Select from the menu. 2. In the Select Business Model dialog box, select a business model from the list provided. Note: You can only select a business model if an identifier has been defined for it. Business models for which identifiers have been defined are displayed in blue. 3. Click OK. BusinessObjects Planning Excel Analyst User Guide 75
4 Working with Ad Hoc Reports in Excel Creating ad hoc reports Validating business models If you are using report areas to create a report, you would validate a business model if you are reusing an old report and want to ensure that the model it accurately reflects what is in the BusinessObjects Planning environment. For example, you would validate a business model to ensure that no additional dimensions have been added to it since the last time you validated. To validate a business model: 1. Right-click the cell you specified for the business model and select BusinessObjects Planning, Business Model, and Validate from the menu. 2. If the Log On dialog box appears, log on to the server. (This dialog box only appears if you were working offline.) See Logging on to the server on page 69 for details on how to log on to the server. Adding rows to ad hoc reports If you are using report areas to create ad hoc reports, you must define rows for each ad hoc report you create. To define a row, select its range, associate it with dimensions, display currencies, display states, or rates, and then specify individual members for each cell in the range. When you specify the row range, it can span only one Excel column. If you select cells that span multiple Excel columns, you will not be able to associate the range with a dimension. You can nest rows in the report. For example, you can define lines and balance types in the rows. To do this, first define a range in one column, associate this range with the line dimension, and specify a line for each cell in 76 BusinessObjects Planning Excel Analyst User Guide
Working with Ad Hoc Reports in Excel Creating ad hoc reports 4 that range. Then, define a second range in a second column, associate this range with the balance type dimension, and specify a balance type for each cell in that range. Note: Even though you must use member identifiers when specifying rows, you can add additional rows that use member names and then hide those rows that contain the identifiers. Hidden information still applies to the report. (For information on how to hide a row, see the Microsoft Excel help.) If you are using nested rows in a report, both ranges must be of the same length. You cannot have one range that spans 5 cells and a second range that spans 4 cells. If either of the ranges contains a blank cell, that row is considered a text row, and no values are loaded into that row. To add rows to an ad hoc report: 1. Specify a business model on which to base the report. (If the model you specify is not valid, dimensions will not appear in the Row menu when you perform Step 3. For information on how to specify a business model, see Specifying a business model on page 74.) 2. Click the cell you want as the first row in the report, hold down the SHIFT key, and click the cell that you want as the last row in the report. (The second cell you select must be in the same column as the first cell you selected.) 3. Right-click one of the selected cells, and select BusinessObjects Planning, Row, and an item from the menu. (For example, if you want lines in the rows, select Line from the Row menu.) BusinessObjects Planning Excel Analyst User Guide 77
4 Working with Ad Hoc Reports in Excel Creating ad hoc reports Note: If you want to create a row range while not logged on to the server, or you want to create a row range of display states or scenarios, see Editing a row range manually on page 121. 78 BusinessObjects Planning Excel Analyst User Guide
Working with Ad Hoc Reports in Excel Creating ad hoc reports 4 Once you have selected your range, the Dimension Wizard automatically appears if you are logged on to the BusinessObjects Planning server, and provided you have not selected Scenario or Display State. For all dimensions except the Time Period dimension, the Dimension Wizard appears as follows: BusinessObjects Planning Excel Analyst User Guide 79
4 Working with Ad Hoc Reports in Excel Creating ad hoc reports For the Time Period dimension, the Dimension Wizard appears as follows: 4. If you are selecting time periods, select and enter time period components in the boxes provided. See Specifying time periods on page 98 for more details on selecting time period components. OR In the text box to the left of the button, type all or part of a member identifier. If necessary, press TAB to display the complete member identifier in the text box. OR 80 BusinessObjects Planning Excel Analyst User Guide
Working with Ad Hoc Reports in Excel Creating ad hoc reports 4 Click to select a member or member hierarchy from the dimension list. See Selecting members from the dimension list on page 96 for more details on selecting members from the dimension list. Note: If you are selecting a member of the Currency dimension, do not select either Pure Currencies or Derived Currencies, as these are folders, not members. To select a currency, expand either or both of the Pure Currencies and Derived Currencies folders. 5. If you did not use the dimension list to select the member, click to add the selected member to the Members selected list. (If you used the dimension list, the member has already been added.) For each selected member, the Members selected list displays the member s identifier and name, but the Dimension Wizard uses only the member identifier as a row header. See Step 9 for information on how to use the Dimension Wizard to display member names in your report. 6. Repeat steps 4 and 5 to add additional members to your row range. If you want to leave a row blank, click Blank. 7. To move a member up or down in your row range, select the member from the Members selected list, and click Up to move the member up or click Dn to move the member down. 8. To remove a member from the row range, select the member from the Members selected list and click. BusinessObjects Planning Excel Analyst User Guide 81
4 Working with Ad Hoc Reports in Excel Creating ad hoc reports 9. To specify member labels for your row range, select the Display Member Name check box and click Select column. When the Label position dialog box appears, go to your report, click a cell in the column in which the labels are to appear, then click OK in the Label Position dialog box. The label text box now specifies the column in which labels are to appear. The labels are positioned to line up with your row range. For example: If your row range is rows 7-11 of your spreadsheet, and you have selected column B for your labels, your labels appear in cells B7 through B11. Note: If a member identifier in your row range consists of one or two alphabetic characters followed by one or more digits (such as AA15), the BusinessObjects Planning Excel Analyst may interpret this as a cell location, not a member identifier. To keep this from happening, enclose the identifier in quotes (for example, AA15 ). 82 BusinessObjects Planning Excel Analyst User Guide
Working with Ad Hoc Reports in Excel Creating ad hoc reports 4 10. Click OK. This displays the range starting at the first cell you selected. If you specified labels for your row range, they are displayed in the column specified in the label text box. Each label appears in the same column as its corresponding member. 11. To nest rows in the report, repeat the above steps. (If you nest rows in a report, and you leave a cell in one of the ranges blank, the entire row becomes a text row. The row remains a text row even if another range defines data for it.) If you forget which cells you defined as a row range, you can use View Dimensions to display the range. For more information on View Dimensions, see Viewing and highlighting dimensions on page 106. Adding columns to ad hoc reports If you are using report areas to create ad hoc reports, you must define columns for each ad hoc report you create. To define a column, select its range, associate it with dimensions, display currencies, display states or rates, and then specify individual members for each cell in the range. When you specify the column range, it can span only one Excel row. If you select cells that span multiple Excel rows, you will not be able to associate the range with a dimension. Note: Even though you must use member identifiers when specifying columns, you can add additional columns that use member names and then hide those columns that contain the identifiers. Hidden information still applies to the report. (For information on how to hide a column, see the Microsoft Excel help.) You can nest columns in the report. For example, you can define units and currencies in the columns. To do this, first define a range in one row, associate this range with units, and specify a unit for each cell in that range. Then, define a range in a second row, associate this range with the currency dimension, and specify a currency for each cell in that range. If you are using nested columns in a report, both ranges must be of the same length. You cannot have one range that spans 5 cells and a second range that spans 4 cells. If either of the ranges contains a blank cell, that column is considered a text column, and no values are loaded into that column. To add columns to an ad hoc report: 1. Specify a business model on which to base the report. (If the model you specify is not valid, dimensions will not appear in the Column menu when you perform Step 3. For information on how to specify a business model, see Specifying a business model on page 74.) BusinessObjects Planning Excel Analyst User Guide 83
4 Working with Ad Hoc Reports in Excel Creating ad hoc reports 2. Click the cell you want as the first column in the report, hold down the SHIFT key, and click the cell that you want as the last column in the report. (The second cell you select must be in the same row as the first cell you selected.) 3. Right-click one of the selected cells, and select BusinessObjects Planning, Column, and an item from the menu. (For example, if you want units in the columns, select Unit from the Column menu.) Note: If you want to create a column range while not logged on to the server, or you want to create a column range of display states or scenarios, see Editing a column range manually on page 126. 84 BusinessObjects Planning Excel Analyst User Guide
Working with Ad Hoc Reports in Excel Creating ad hoc reports 4 Once you have selected your range, the Dimension Wizard automatically appears if you are logged on to the BusinessObjects Planning server, and provided you have not selected Scenario or Display State. For all dimensions except the Time Period dimension, the Dimension Wizard appears as follows: BusinessObjects Planning Excel Analyst User Guide 85
4 Working with Ad Hoc Reports in Excel Creating ad hoc reports For the Time Period dimension, the Dimension Wizard appears as follows: 4. If you are selecting time periods, select and enter time period components in the boxes provided. See Specifying time periods on page 98 for more details on selecting time period components. OR In the text box to the left of the button, type all or part of a member identifier. If necessary, press TAB to display the complete member identifier in the text box. OR 86 BusinessObjects Planning Excel Analyst User Guide
Working with Ad Hoc Reports in Excel Creating ad hoc reports 4 Click to select a member or member hierarchy from the dimension list. See Selecting members from the dimension list on page 96 for more details on selecting members from the dimension list. Note: If you are selecting a member of the Currency dimension, do not select either Pure Currencies or Derived Currencies, as these are folders, not members. To select a currency, expand either or both of the Pure Currencies and Derived Currencies folders. 5. If you did not use the dimension list to select the member, click to add the selected member to the Members selected list. (If you used the dimension list, the member has already been added.) For each selected member, the Members selected list displays the member s identifier and label, but the Dimension Wizard uses only the member identifier as a column header. See Step 10 for information on how to use the Dimension Wizard to display member labels in your report. 6. Repeat steps 4 and 5 to add additional members to your column range. If you want to leave a column blank, click Blank. 7. To move a member up or down in your column range, select the member from the Members selected list, and click Up to move the member up or click Dn to move the member down. BusinessObjects Planning Excel Analyst User Guide 87
4 Working with Ad Hoc Reports in Excel Creating ad hoc reports 8. To remove a member from the column range, select the member from the Members selected list and click. 9. To specify member labels for your column range, select the Display Member Name check box and click Select row. When the Label position dialog box appears, go to your report, click a cell in the row in which the labels are to appear, then click OK in the Label Position dialog box. The label text box now specifies the row in which labels are to appear. The labels are positioned to line up with your column range. For example: If your column range is columns D-I of your spreadsheet, and you have selected row 3 for your labels, your labels appear in cells D3 through I3. Note: If a member identifier in your column range consists of one or two alphabetic characters followed by one or more digits (such as AA15), the BusinessObjects Planning Excel Analyst may interpret this as a cell location, not a member identifier. To keep this from happening, enclose the identifier in quotes (for example, AA15 ). 10. Click OK. This displays the range starting at the location specified in the Dimension position text box. 88 BusinessObjects Planning Excel Analyst User Guide
Working with Ad Hoc Reports in Excel Creating ad hoc reports 4 If you specified labels for your column range, they are displayed in the row indicated in the Label text box. Each label appears in the same column as its corresponding member. 11. To nest columns in the report, repeat the above steps. (If you nest columns in a report, and you leave a cell in one of the ranges blank, the entire column becomes a text column. The column remains a text column even if another range defines data for it.) If you forget which cells you defined as a column range, you can use View Dimensions to display the range. For more information on View Dimensions, see Viewing and highlighting dimensions on page 106. Specifying section properties using the Dimension Wizard At the section properties level, you can specify dimensions, display currencies, display states, and rates. When you set a section property, it applies to the entire report unless it is also specified in a column or row. As a best practice, the cells you select to define section properties should appear vertically in the report. In this way, you can create a table that displays the identifiers next to their names. For example: If you are specifying a dimension (such as Balance Type) as a section property, and you are logged on to the server, the Dimension Wizard automatically appears to help you create the section property. If you are specifying a scenario or display state, or you are not logged on to the server, you must specify the section property manually. For information on specifying a section property manually, see Specifying section properties manually on page 94. For information on how to log on to the BusinessObjects Planning server, see Logging on to the server on page 69. To specify section properties using the Dimension Wizard: 1. Specify a business model on which to base the report. (If the model you specify is not valid, dimensions will not appear in the Section menu when you perform Step 3. For information on how to specify a business model, see Specifying a business model on page 74.) BusinessObjects Planning Excel Analyst User Guide 89
4 Working with Ad Hoc Reports in Excel Creating ad hoc reports 2. Right-click a single cell and select BusinessObjects Planning, Section, and an item from the menu. (For example, to specify the display currency for the report, select Display Currency from the Section menu.) 90 BusinessObjects Planning Excel Analyst User Guide
Working with Ad Hoc Reports in Excel Creating ad hoc reports 4 Once you have selected your cell, the Dimension Wizard automatically appears if you are logged on to the BusinessObjects Planning server, and provided you have not selected Scenario or Display State. For all dimensions except the Time Period dimension, the Dimension Wizard appears as follows: BusinessObjects Planning Excel Analyst User Guide 91
4 Working with Ad Hoc Reports in Excel Creating ad hoc reports For the Time Period dimension, the Dimension Wizard appears as follows: 3. If you are selecting a time period, select and enter time period components in the boxes provided. See Specifying time periods on page 98 for more details on selecting time period components. OR In the text box to the left of the button, type all or part of a member identifier. If necessary, press TAB to display the complete member identifier in the text box. OR 92 BusinessObjects Planning Excel Analyst User Guide
Working with Ad Hoc Reports in Excel Creating ad hoc reports 4 Click to select a member from the dimension list. See Selecting members from the dimension list on page 96 for more details on selecting a member from the dimension list. Note: If you are selecting a member of the Currency dimension, do not select either Pure Currencies or Derived Currencies, as these are folders, not members. To select a currency, expand either or both of the Pure Currencies and Derived Currencies folders. 4. If you did not use the dimension list to select the member, click to add the selected member to the Members selected list. (If you used the dimension list, the member has already been added.) BusinessObjects Planning Excel Analyst User Guide 93
4 Working with Ad Hoc Reports in Excel Creating ad hoc reports 5. To specify a member label for your section property, select the Display Member Name check box and click Select position. When the Label position dialog box appears, go to your report, click the cell in which the label is to appear, then click OK in the Label Position dialog box. The label text box now specifies the cell in which the label is to appear. 6. Click OK when you have completed adding your section property. 7. Repeat the above steps for each section property that you want to set. If you forget which cell you defined as a section property, you can use View Dimensions to display the property. For more information on View Dimensions, see Viewing and highlighting dimensions on page 106. Specifying section properties manually If you are specifying a scenario or display state, or you are not logged on to the server, you must specify the section property manually. In other cases, a Dimension Wizard automatically appears to help you create your section property. Note: For more information on specifying a section property using the Dimension Wizard, see Specifying section properties using the Dimension Wizard on page 89. 94 BusinessObjects Planning Excel Analyst User Guide
Working with Ad Hoc Reports in Excel Creating ad hoc reports 4 If a member identifier that you are editing consists of one or two alphabetic characters followed by one or more digits (such as AA15), the BusinessObjects Planning Excel Analyst may interpret this as a cell location, not a member identifier. To keep this from happening, enclose the identifier in quotes (for example, AA15 ). If a member identifier begins with a zero (0), Excel may treat the zero as a leading zero and remove it. To prevent this, type a ' (single-quote) before typing your identifier, or change the cell to a text cell by right-clicking the cell, selecting Format Cells, and selecting Text from the Category list. To specify section properties manually: 1. Specify a business model on which to base the report. (If the model you specify is not valid, dimensions will not appear in the Section menu when you perform Step 3. For information on how to specify a business model, see Specifying a business model on page 74.) 2. Right-click a single cell and select BusinessObjects Planning, Section, and an item from the menu. (For example, to specify one Display state for the report, select Display State from the Section menu.) You cannot select more than one cell. BusinessObjects Planning Excel Analyst User Guide 95
4 Working with Ad Hoc Reports in Excel Creating ad hoc reports 3. Click the cell you selected in Step 2 and type a member identifier for the dimension or rate you are adding. OR If you are specifying the display state of the data, type either a % for rate or a $ for a dollar amount. 4. Repeat the above steps for each section property that you want to set. If you forget which cell you defined as a section property, you can use View Dimensions to display the property. For more information on View Dimensions, see Viewing and highlighting dimensions on page 106. Selecting members from the dimension list When you are using the Dimension Wizard to select members for a row range or a column range, or a member for a section property, you can click to view a list of all members of that dimension. You can then select a member or member hierarchy from this dimension list. Also, a dimension list appears when you specify a balance type for a projection or proration, or when you open a report that contains missing dimensions. 96 BusinessObjects Planning Excel Analyst User Guide
Working with Ad Hoc Reports in Excel Creating ad hoc reports 4 From the dimension list, you can select members by either expanding the dimension tree provided or searching for a member in the dimension tree. To expand a portion of the dimension tree, click the button located to the left of a displayed member. This displays the children of the member. When searching for a member in the dimension tree, you can search by member name or member ID. When searching, you can specify any or all of the following limitations: The search must match the entire word The matched member must start with the text specified in the search The matched member must be the same case as the text specified in the search; for example, TEXT only matches TEXT, not text or Text. (This option is only available if you are searching by member name.) By default, a search matches a member if the search text is contained anywhere in the member name or identifier. When you use the dimension list to select a member from the dimension tree, the selected member is at the top of a dimension hierarchy, and the hierarchy has been expanded, the member s children are transferred to the Members selected list along with the selected member. For example: BusinessObjects Planning Excel Analyst User Guide 97
4 Working with Ad Hoc Reports in Excel Creating ad hoc reports Here, if you select CM00 and click OK, all of its children are also transferred. If you want to transfer a member but not its hierarchy, click, located to the left of the member. This hides the hierarchy, and ensures that only the member itself is transferred. For more details on using the Dimension Wizard to specify a row range, column range, or section property, see one of the following: Adding rows to ad hoc reports on page 76 Adding columns to ad hoc reports on page 83 Specifying section properties using the Dimension Wizard on page 89 To select members from the dimension list: 1. In the Dimension Wizard, click to display the dimension list. 2. Select a member from the dimension hierarchy displayed. If the member you want to select is not displayed, and you know which part of the dimension hierarchy contains the member, click as necessary to display the member. OR In the Search for dimension member text box, enter some or all of a member name or identifier, and click Find. To repeat the search after finding a member, click Find Next. 3. Click OK to select the member or member hierarchy. Specifying time periods You can use the Dimension Wizard to specify one or more time period identifiers in a section property, row, or column of your report. A time period identifier consists of three components: a year, a version, and the time period itself. These components are separated by a period (.). An example of a valid time period identifier is 2002.A.M3 (which is the 2002 monthly actuals for month 3). The following table describes the time period identifier components in more detail. 98 BusinessObjects Planning Excel Analyst User Guide
Working with Ad Hoc Reports in Excel Creating ad hoc reports 4 Time Period Identifier Component Year Version Time Period Description Any four-digit year, such as 2003, or one of the following: Current The current year Scenario The scenario s year One of the following: Scenario The scenario s version Actual Actual data Forecast Forecasted data Plan Planned data A valid time period. For details on time periods, see Time Period Tables on page 161. The Dimension Wizard contains boxes for each of these time period identifier components: For more details on using the Dimension Wizard to specify a row range, column range, or section property, see one of the following: Adding rows to ad hoc reports on page 76 BusinessObjects Planning Excel Analyst User Guide 99
4 Working with Ad Hoc Reports in Excel Creating ad hoc reports Adding columns to ad hoc reports on page 83 Specifying section properties using the Dimension Wizard on page 89 To specify a time period: 1. From the Year list, select a year. 2. From the Version list, select a version. 3. In the Time Period text box, type a time period. OR Click Browse, and select a time period from the list that appears. Specifying whether to allow data to be uploaded By default, you cannot upload the data you enter in an ad hoc report area to the database. This is a safety feature to protect against accidentally overwriting values in the database. Note: Cells containing calls to the IPUTVAL function always have their values uploaded, even if you have not specified any upload flags. You can allow uploading of data to the database in the following ways: You can allow uploading of an entire report by defining a single Upload flag. This upload is restricted to input level members only. For details, see Uploading an entire report on page 100. You can indicate that particular rows of your report are to be uploaded. For details, see Uploading specified report rows on page 101. You can indicate that particular columns of your report are to be uploaded. For details, see Uploading specified report columns on page 102. You can indicate that particular cells of your report are to be uploaded. For details, see Uploading individual report cells on page 104. You must use a row or column Upload flag to upload a revisable line. A reportlevel Upload flag has no effect on revisable lines. If you want to upload data from a report that contains non-editable lines, use row or column Upload flags to avoid error messages. Uploading an entire report To allow uploading of an entire report, you can define a single Upload flag for the report. This upload is restricted to input level members only. Note: If you want to upload revisable lines, you must specify individual Upload flags for each of the rows or columns that contain the revisable lines. For more information, see Uploading specified report rows on page 101 and Uploading specified report columns on page 102. 100 BusinessObjects Planning Excel Analyst User Guide
Working with Ad Hoc Reports in Excel Creating ad hoc reports 4 If your report contains non-editable rows or columns, and you do not want error messages to appear when you upload, specify individual Upload flags for either or both of the rows and columns of your report. To upload an entire report: 1. Specify a business model on which to base the report. 2. Right-click a blank cell and select BusinessObjects Planning, Section, and Upload from the menu. 3. To allow uploading of data to the database, type Y in the cell you specified in Step 2. (If you do not type Y, the default is N, which means Do not upload data. ) Uploading specified report rows You can specify individual Upload flags for each of the rows of your report. This allows you to selectively upload editable rows of your report, including revisable lines. To upload specified report rows: 1. Specify a business model on which to base the report. BusinessObjects Planning Excel Analyst User Guide 101
4 Working with Ad Hoc Reports in Excel Creating ad hoc reports 2. Right-click blank cells that correspond to the range of rows in your report, and select BusinessObjects Planning, Row, and Upload from the menu. 3. In the cells you specified in Step 2, type Y in the cells that correspond to the rows from which you want to upload data. (If you do not type Y, the default is N, which means Do not upload data. ) Note: If Y is set for a non-editable row, an error message is displayed when you attempt to upload the report data. Uploading specified report columns You can specify individual Upload flags for each of the columns of your report. This allows you to selectively upload editable columns of your report, including revisable lines. 102 BusinessObjects Planning Excel Analyst User Guide
Working with Ad Hoc Reports in Excel Creating ad hoc reports 4 To upload specified report columns: 1. Specify a business model on which to base the report. 2. Right-click blank cells that correspond to the range of columns in your report, and select BusinessObjects Planning, Column, and Upload from the menu. 3. In the cells you specified in Step 2, type Y in the cell or cells that correspond to the columns from which you want to upload data. (If you do not type Y, the default for unspecified cells is N, which means Do not upload data. ). BusinessObjects Planning Excel Analyst User Guide 103
4 Working with Ad Hoc Reports in Excel Creating ad hoc reports Note: If Y is set for a non-editable column, an error message is displayed when you attempt to upload the report data. Uploading individual report cells You can specify that only particular cells are to be uploaded. To do this, specify Upload flags for the rows of your report, and specify Upload flags for the columns of your report. A cell is only uploaded if both its row and its column can be uploaded. To upload individual report cells: 1. Specify Upload flags for the rows of your report, as described in Uploading specified report rows on page 101. 2. Specify Upload flags for the columns of your report, as described in Uploading specified report columns on page 102. Validating ad hoc reports If you are using report areas to create a report, you can validate it once you have created it, or after you have made changes to its properties. Validation ensures that the report design is correct and that member identifiers are valid. If report design errors occur, they are reported in message boxes. If identification errors occur, they are reported directly in the spreadsheet. Inaccurate cells are filled with a color and a comment is added to the cell. To proceed, fix the error, and then clear the error. (For more information on clearing errors, see Clearing validation errors on page 104.) Note: Validating the report does not validate the business model. Model validation is a separate step. To validate an ad hoc report: 1. From the BusinessObjects Planning menu, select Ad Hoc Reporting and Validate Report. 2. If the Log On dialog box appears, log on to the server. (This dialog box only appears if you were working offline.) See Logging on to the server on page 69 for details on how to log on to the server. Note: When you right-click within the report area, BusinessObjects Planning validates the ad hoc report automatically. Clearing validation errors If errors are detected when you validate an ad hoc report, inaccurate cells are filled with a color, and a comment is added to each cell. You can clear errors detected in a worksheet without having to reset the colors and comments manually. 104 BusinessObjects Planning Excel Analyst User Guide
Working with Ad Hoc Reports in Excel Creating ad hoc reports 4 To clear the errors in a worksheet, right-click the worksheet, and select BusinessObjects Planning and Clear errors. You can also clear validation errors using Excel macros. For details, see Clearing validation errors using Excel macros on page 105. Note: When you validate, upload, or refresh an ad hoc report, any existing errors are automatically cleared. If the validation errors have not been fixed, they reappear when you revalidate the report. Clearing validation errors using Excel macros From within an Excel macro, you can use the CClearErrors macro to clear validation errors in ad hoc reports in a worksheet. You can also clear validation errors manually. For details, see Clearing validation errors on page 104. Note: When you validate, upload, or refresh an ad hoc report, any existing errors are automatically cleared. If the validation errors have not been fixed, they reappear when you revalidate the report. To create a macro that clears validation errors: 1. Create a macro using the Excel macro creation functionality. (Refer to the Microsoft Excel help for information on how to create macros in Excel.) 2. From the Tools menu, select Macro and Macros. 3. From the Macro window, select your macro from the list provided, and click Edit. 4. In the Microsoft Visual Basic window, select Tools and References. BusinessObjects Planning Excel Analyst User Guide 105
4 Working with Ad Hoc Reports in Excel Creating ad hoc reports 5. Select the BusinessObjectsPlanningExcelAnalyst check box to link your current code with the BusinessObjects Planning project. 6. Click OK. 7. In the Code window, which contains the code for your macro, add the CClearErrors macro. This macro can be in either of two formats: CClearErrors Application.Run "CClearErrors" If you use the second format, you do not need to follow steps 4, 5, and 6 above, as this format is independent of any project dependencies. 8. In the Microsoft Visual Basic window, from the File menu, select Close and Return to Microsoft Excel. 9. Save your Microsoft Excel file. Editing data in ad hoc reports You can enter data in an ad hoc report and then upload that data to the database. To enter data in an ad hoc report, type a number into the cell you want to edit. If the cell is associated with a related line, you can enter the value as either a dollar amount or a rate. To enter a rate value, type a percentage sign before the cell data. Data that is not preceded by a percentage sign defaults to a dollar value. To enter an N/A value, type N/A, na, n/a, or (na) into the report cell. Note: Unlike entering zero, entering N/A ensures the value of the cell is ignored in calculations. This is critical when performing, in particular, statistical calculations where a 0 value could significantly alter the outcome of the calculation. When you are finished editing the report, you can upload the data to the database. For information on how to upload data, see Uploading data from ad hoc reports to the database on page 134. Viewing and highlighting dimensions An ad hoc report is composed of the data area, rows, columns, and section properties. In addition, you may have added names to the report to provide a user-friendly way to identify dimension members. In such an environment, you may need a way to easily locate the members for each dimension used in a report. BusinessObjects Planning provides a way to identify members more easily by allowing you to fill each dimension range with a color. For example, you may want to identify certain members in a range so that you can modify or delete them. 106 BusinessObjects Planning Excel Analyst User Guide
Working with Ad Hoc Reports in Excel Creating ad hoc reports 4 To view and highlight a dimension in a report: 1. Right-click any cell in the report area and select BusinessObjects Planning and View Dimensions from the menu. 2. In the View Dimensions dialog box, from the Ad hoc Reports list, select the report whose dimensions you want to view. (The current report is selected by default.) 3. From the Dimensions list, select the dimension you want to view. BusinessObjects Planning Excel Analyst User Guide 107
4 Working with Ad Hoc Reports in Excel Creating ad hoc reports Note: If you have specified labels for your rows, columns, or section properties, you can view these labels from the Dimensions list. However, if you have opened a BusinessObjects Planning report as an ad hoc report, the report s row and column headings are imported as text, not labels, and do not appear in the Dimensions list. 4. To apply a fill color to the dimension, click the Fill button, and in the Fill Color dialog box, select a color from the palette, and click OK. 5. Click Cancel to close the View dimensions dialog box. Creating ad hoc reports using functions You can create ad hoc reports by using worksheet functions within cells. Note: When you create ad hoc reports, you do not need to have BusinessObjects Planning Administrator or BusinessObjects Planning Analyst Pro installed. However, you do have to understand how your organization's business rules are set up in your BusinessObjects Planning environment. The following worksheet functions are supported: IGETVAL Retrieve a data item IPUTVAL Write a data item IGETDIMATTR Retrieve dimension attributes IGETMODATTR Retrieve business model attributes IGETSCENATTR Retrieve scenario attributes Each of these functions operates on a single cell of a worksheet. To create larger reports, specify the appropriate function in each of the cells of your report. For details on the syntax and parameters for these functions, see The BusinessObjects Planning Worksheet Functions on page 141. Using the BusinessObjects Planning worksheet functions To use a BusinessObjects Planning worksheet function in a cell, follow the same procedure you would use to add an ordinary Excel function to a cell. To use a BusinessObjects Planning worksheet function: 1. Click the cell in which the new data is to appear. 2. Select Function from the Insert menu. 3. In the Paste Function dialog box, from the Function Category list, select BusinessObjectsFunctions. 108 BusinessObjects Planning Excel Analyst User Guide
Working with Ad Hoc Reports in Excel Creating ad hoc reports 4 4. From the Function Name list, select the function you want to include in the cell. 5. Click OK. 6. In the formula box that appears, enter valid values for the parameters to the function. As you enter a parameter, the formula box displays a brief description of what the parameter does. If you want to enter a string parameter consisting of a single alphabetic letter followed by a numeric value, such as L1, you must enclose the parameter in quotes to ensure that Excel does not treat the parameter as Excel cell coordinates. (Normally, you do not need to supply quotes when entering string parameters.) Note: For a complete list of the parameters to the BusinessObjects Planning worksheet functions, see The BusinessObjects Planning Worksheet Functions on page 141. 7. Click OK when you have finished entering parameters. BusinessObjects Planning Excel Analyst User Guide 109
4 Working with Ad Hoc Reports in Excel Opening a BusinessObjects Planning report as an ad hoc report 8. Refresh the report to retrieve the data value for the function. (See Refreshing ad hoc reports on page 134 for more details on refreshing reports.) Worksheet function error messages When you specify a BusinessObjects Planning worksheet function in a cell formula, and the numeric value is not displayed, the cell formula displays one of the values listed in the table below: Value $VALUE! $GET! $ATTR! Description Syntax error, or function specification not complete. A cell containing a call to IGETVAL has not been refreshed, or a communication error has occurred while attempting to refresh. A cell containing a call to IGETDIMATTR, IGETMODATTR, or IGETSCENATTR has not been refreshed, or a communication error has occurred while attempting to refresh. Any other value Microsoft Excel has detected an error. See the Microsoft Excel help for details. Opening a BusinessObjects Planning report as an ad hoc report You can open most previously created BusinessObjects Planning reports as ad hoc reports. Once a BusinessObjects Planning report is open, it behaves just like any other ad hoc report. This allows you to use a BusinessObjects Planning report as a template when creating a new ad hoc report. Warning: If you open a BusinessObjects Planning report as an ad hoc report and it contains band or trending rows or columns, you cannot upload or refresh the data. To work with a BusinessObjects Planning report containing band or trending rows or columns, use BusinessObjects Planning Administrator or BusinessObjects Planning Analyst Pro. For example, here is a typical BusinessObjects Planning report opened in Excel: 110 BusinessObjects Planning Excel Analyst User Guide
Working with Ad Hoc Reports in Excel Opening a BusinessObjects Planning report as an ad hoc report 4 When you open this BusinessObjects Planning report as an ad hoc report, it looks like this: BusinessObjects Planning Excel Analyst User Guide 111
4 Working with Ad Hoc Reports in Excel Opening a BusinessObjects Planning report as an ad hoc report In this ad hoc report, all dimensions are displayed on a green background. Member identifiers are displayed on a blue background. Row and column headings are displayed on a yellow background. Note: When you open a BusinessObjects Planning report as an ad hoc report, the cells containing the member identifiers and the cell containing the business model identifier are set to Text format. This ensures that identifiers containing leading zeroes are displayed correctly. The business model for your report, and the default values for its dimensions, are listed at the top of the report. The dimensions defined in the rows and columns of the report override the definitions listed there. If your report does not have a default value specified for the business model, a comment appears when the ad hoc report is opened: To delete the comment, right-click the cell next to it, and select Delete Comment from the menu. Note: When you open a BusinessObjects Planning report as an ad hoc report, you are creating a copy of the report. This means that any changes you make do not affect the original BusinessObjects Planning report. To open a BusinessObjects Planning report as an ad hoc report: 1. On the BusinessObjects Planning Excel Analyst toolbar, click (Open Report). 112 BusinessObjects Planning Excel Analyst User Guide
Working with Ad Hoc Reports in Excel Drilling down in an ad hoc report 4 You may be prompted to log on if you have not already done so. 2. In the Open Report dialog box, select the Open as an Ad hoc report check box. 3. Select the report you want to open. (You may have to expand the hierarchy to see all available reports.) Drilling down in an ad hoc report One of the key differences between viewing and working with BusinessObjects Planning reports instead of a standard spreadsheet program is the ability to drill down rows by dimensions. This allows you to narrow your focus on selected data, displaying its underlying details. Whether you can drill down in an ad hoc report is determined by: The dimensions that are visible in the ad hoc report. You cannot drill down by dimensions that are not part of the report s layout. Therefore, if the ad hoc report displays two or three dimensions only, your choices for drilling down are limited. However, if the ad hoc report displays several dimensions (for example, Unit, Line, Currency, Product, and Channel), your choices are considerable. The type of data in the report. You can either drill from summary data for high-level members to more detailed data for lower level members, or you can drill from calculated data to pure data. BusinessObjects Planning Excel Analyst User Guide 113
4 Working with Ad Hoc Reports in Excel Drilling down in an ad hoc report When drilling down in ad hoc reports, you should be aware of the following behavior: To accommodate drill-down data in a report, the BusinessObjects Planning Excel Analyst increases the report s range by either inserting new rows or columns in the worksheet or by shifting cells in the report area down or to the right. Therefore, if a worksheet contains more than one report, drilling down in one report may affect the layout or visibility of another report. When you drill down on a calculated row (for example, a variance row), the rows used in the calculation are displayed. You will get the same result no matter which dimension you drill down. You can then drill down on the rows used in the calculation by a particular dimension to see the details. If you drill down on a row by currency, and the resulting currencies have N/A values, the total of the currencies may be zero. Depending on the report settings, if your hierarchy contains calculated formulas, drilling to leaf may stop at the calculated formula's component members. You could then drill to leaf on the component members to display their lowest-level details. When you drill down on a row, the report settings control whether detail rows that contain only zeroes are displayed. Hidden rows and columns are not included in drill-downs. You cannot drill down by the Time Period dimension. Once you have drilled down on rows or columns, you cannot collapse them. To drill down in an ad hoc report: 1. Locate the row or column in the ad hoc report that is associated with the dimension you want to drill down by. 2. Double-click the cell containing the dimension member that you want to expand. If the dimension member can be expanded, the Extend Report Area dialog box appears. If the dialog box does not appear, you cannot drill down on the selected dimension member. 3. In the Extend Report Area dialog box, choose one of the following options (options vary depending on whether you are drilling down on a row or column): 114 BusinessObjects Planning Excel Analyst User Guide
Working with Ad Hoc Reports in Excel Modifying and updating ad hoc reports 4 Shift report cells down/shift report cells right Extends the report area by shifting all report cells down or to the right from the point of drill down. Select this option if your worksheet contains only one report. Insert entire row(s)/insert entire column(s) Extends the report area by inserting new rows or columns for drill-down data. Select this option if your worksheet contains more than one report and the row or column ranges of other reports extend beyond the current report s range. 4. Click OK. Modifying and updating ad hoc reports Once you have created an ad hoc report, you can work with it by retrieving, entering, and uploading data. Opening ad hoc reports on page 115 Modifying the contents of a report area on page 116 Scaling data on page 129 Refreshing ad hoc reports on page 134 Uploading data from ad hoc reports to the database on page 134 Uploading and refreshing ad hoc reports on page 135 Uploading and refreshing ad hoc reports using Excel macros on page 136 Copying ad hoc reports on page 139 Saving ad hoc reports on page 140 Opening ad hoc reports When you open an ad hoc report created using report areas, the data appears as it did when the report was last saved. When you open an ad hoc report created using function calls, the appearance of the data depends on how calculations are performed in your workbook. To determine this, select Options from the Tools menu, click the Calculation tab, and examine the current value of the Calculation option. What you see next depends on the current setting of this option: If Calculation is set to Manual, the current values of the data cells are saved when the spreadsheet is saved, and appear when you open the report. BusinessObjects Planning Excel Analyst User Guide 115
4 Working with Ad Hoc Reports in Excel Modifying and updating ad hoc reports If Calculation is set to Automatic or Automatic except tables, the data cells display $GET! when you open the report. In all cases, if you want to ensure that the report data is up-to-date, refresh the report. For information on how to refresh a report, see Refreshing ad hoc reports on page 134. To open an ad hoc report: 1. Select Open from the File menu. 2. In the Open dialog box, locate and select the file, and click Open. Modifying the contents of a report area You can modify the contents of a report area in an ad hoc report after you have created it. The BusinessObjects Planning Excel Analyst allows you to do the following: Edit any identifier contained in a column range, contained in a row range, or specifying a section property Edit a row or column range using the Dimension Wizard Edit a row or column range manually Delete dimensions from ad hoc reports 116 BusinessObjects Planning Excel Analyst User Guide
Working with Ad Hoc Reports in Excel Modifying and updating ad hoc reports 4 Editing an identifier in a cell The BusinessObjects Planning Excel Analyst provides a convenient way to change a single identifier contained in a row range or column range, or specifying a section property. To edit an identifier in a cell: 1. Right-click the cell whose identifier you want to change, and select BusinessObjects Planning. 2. From the popup menu that appears, select Select dim, where dim is the dimension of the identifier you are currently changing. For example, if the cell is a member of the Line dimension, select Select Line. 3. In the Select dim from dimension list dialog box (where dim is the dimension you are specifying), type an identifier into the text field, and press TAB. OR BusinessObjects Planning Excel Analyst User Guide 117
4 Working with Ad Hoc Reports in Excel Modifying and updating ad hoc reports If you want to view the dimension list to locate the identifier you want to select, click to display the dimension list. See Selecting members from the dimension list on page 96 for more details on how to use the dimension list. 4. Click OK. Editing a row range using the Dimension Wizard Once you have created a row range, you can edit it using the Dimension Wizard. You can also use the Dimension Wizard to increase the size of a row range. To reduce the size of a row range, you must shrink the row range manually. You can also edit the row range manually. For details on shrinking a row range, see Shrinking a row range on page 122. For details on editing a row range manually, see Editing a row range manually on page 121. 118 BusinessObjects Planning Excel Analyst User Guide
Working with Ad Hoc Reports in Excel Modifying and updating ad hoc reports 4 To edit a row range using the Dimension Wizard: 1. Right-click a cell in the row range, and select BusinessObjects Planning Planning and Dimension Wizard from the menu. 2. If you are working with the time period dimension, and want to add a new time period to your row range, select and enter the time period components in the boxes provided. See Specifying time periods on page 98 for more details on selecting time period components. OR BusinessObjects Planning Excel Analyst User Guide 119
4 Working with Ad Hoc Reports in Excel Modifying and updating ad hoc reports If you want to add a member to your row range, and you know the identifier of the member, type all or part of the identifier in the Dimension members available text box. If necessary, press TAB to display the complete member identifier in the text box. OR If you want to add a member to your row range, and you want to view the dimension list to locate it, click to display the dimension list. See Selecting members from the dimension list on page 96 for more details on selecting a member from the dimension list. OR If you want to move a member up or down in your row range, select the member from the Members selected list. Click Up to move the member up, or click Dn to move the member down. OR If you want to remove a member from the row range, select the member from the Members selected list and click. (This does not reduce the length of your row range. To do this, you must explicitly shrink it.) 120 BusinessObjects Planning Excel Analyst User Guide
Working with Ad Hoc Reports in Excel Modifying and updating ad hoc reports 4 3. If you are adding a new member, and did not use the dimension list to select the member, click to add the selected member to the Members selected list. (If you used the dimension list, the member has already been added.) 4. Repeat steps 2 and 3 until you have completed editing your row range. 5. Click Finish. If your new row range is the same size as your original row range, you are done, and can skip steps 6 and 7. 6. If your new row range is longer than the row range you started with, click Yes when you are asked whether you want to extend the report area. 7. In the Extend Report Area dialog box, select Shift report cells down to move existing report cells down to make room for your new rows. This only affects the report you are editing. OR Select Insert entire row(s) to insert new rows in your worksheet, leaving existing rows where they are. Inserting a new row in your worksheet affects the entire worksheet, including any other BusinessObjects Planning reports that may have been created. Editing a row range manually Once you have created a row range, you can edit it manually. You can also create a row range manually if you cannot use the Dimension Wizard (for example, if you are creating a row range while not logged on to the server). If a member identifier that you are editing consists of one or two alphabetic characters followed by one or more digits (such as AA15), the BusinessObjects Planning Excel Analyst may interpret this as a cell location, not a member identifier. To keep this from happening, enclose the identifier in quotes (for example, AA15 ). If a member identifier begins with a zero (0), Excel may treat the zero as a leading zero and remove it. To prevent this, type a ' (single-quote) before typing your identifier, or change the cell to a text cell by right-clicking the cell, selecting Format Cells, and selecting Text from the Category list. BusinessObjects Planning Excel Analyst User Guide 121
4 Working with Ad Hoc Reports in Excel Modifying and updating ad hoc reports To edit a row range manually: 1. If the row range does not yet exist, click the cell you want as the first row in the report, hold down the SHIFT key, and click the cell that you want as the last row in the report. Then, right-click one of the selected cells, and select BusinessObjects Planning, Row, and an item from the menu. 2. In the row range, select the cell that you want to edit. (If you are having trouble locating the row range, right-click and select Business Model and View Dimensions to display a window containing a list of dimensions defined in your report. Select the row range from this window to display it.) 3. In this cell, enter the identifier of the member whose values you want displayed in this report row. (For example, ROA could be the identifier for the Return on Assets line.) OR If you are specifying the display state of the data, type either a % for rate or a $ for a dollar amount. 4. Repeat this step for each cell in the range that you want to edit. (You can leave a row blank. If you do so, it becomes the equivalent of a text row in BusinessObjects Planning Administrator and BusinessObjects Planning Analyst Pro.) Shrinking a row range If you want to reduce the length of a row range in your report, you must specify the new row range by selecting it. You can then use the Dimension Wizard to edit the range. To shrink a row range: 1. Click the cell you want as the first cell in the row range, hold down the SHIFT key, and click the cell that you want as the last cell in the row range. 2. Right-click one of the selected cells, and select BusinessObjects Planning, Row, and the row range dimension from the menu. Note: If you have forgotten the dimension of your row range, you can view it. See Viewing and highlighting dimensions on page 106 for more information. 122 BusinessObjects Planning Excel Analyst User Guide
Working with Ad Hoc Reports in Excel Modifying and updating ad hoc reports 4 3. In the dialog box that asks you whether you want to replace the previous selection, click Yes. 4. In the dialog box that asks you whether you want to replace the old dimension, click Yes. 5. In the Select Report Dimensions dialog box, you can edit the row range if necessary. See Editing a row range using the Dimension Wizard on page 118. 6. Click Finish. Editing a column range using the Dimension Wizard Once you have created a column range, you can edit it using the Dimension Wizard. You can also use the Dimension Wizard to increase the size of a column range. To reduce the size of a column range, you must shrink the column range manually. You can also edit the column range manually. For details on shrinking a column range, see Shrinking a column range on page 127. For details on editing a column range manually, see Editing a column range manually on page 126. BusinessObjects Planning Excel Analyst User Guide 123
4 Working with Ad Hoc Reports in Excel Modifying and updating ad hoc reports To edit a column range using the Dimension Wizard: 1. Right-click a cell in the column range, and select BusinessObjects Planning and Dimension Wizard from the menu. 2. If you are working with the time period dimension, and want to add a new time period to your column range, select and enter the time period components in the boxes provided. See Specifying time periods on page 98 for more details on selecting time period components. OR 124 BusinessObjects Planning Excel Analyst User Guide
Working with Ad Hoc Reports in Excel Modifying and updating ad hoc reports 4 If you want to add a member to your column range, and you know the identifier of the member, type all or part of the identifier in the Dimension members available text box. If necessary, press TAB to display the complete member identifier in the text box. OR If you want to add a member to your column range, and you want to view the dimension list to locate it, click to display the dimension list. See Selecting members from the dimension list on page 96 for more details on selecting a member from the dimension list. OR If you want to move a member up or down in your column range, select the member from the Members selected list. Click Up to move the member up, or click Dn to move the member down. OR If you want to remove a member from the column range, select the member from the Members selected list and click. (This does not reduce the length of your row range. To do this, you must explicitly shrink it.) BusinessObjects Planning Excel Analyst User Guide 125
4 Working with Ad Hoc Reports in Excel Modifying and updating ad hoc reports 3. If you are adding a new member, and did not use the dimension list to select the member, click to add the selected member to the Members selected list. (If you used the dimension list, the member has already been added.) 4. Repeat steps 2 and 3 until you have completed editing your column range. 5. Click Finish. If your new column range is the same size as your original column range, you are done, and can skip steps 6 and 7. 6. If your new column range is longer than the column range you started with, click Yes when you are asked whether you want to extend the report area. 7. In the Extend Report Area dialog box, select Shift report cells right to move existing report cells right to make room for your new columns. This only affects the report you are editing. OR Select Insert entire column(s) to insert new columns in your worksheet, leaving existing columns where they are. Inserting a new column in your worksheet affects the entire worksheet, including any other BusinessObjects Planning reports that may have been created. Editing a column range manually Once you have created a column range, you can edit it manually. You can also create a column range manually if you cannot use the Dimension Wizard (for example, if you are creating a column range while not logged on to the server). If a member identifier that you are editing consists of one or two alphabetic characters followed by one or more digits (such as AA15), the BusinessObjects Planning Excel Analyst may interpret this as a cell location, not a member identifier. To keep this from happening, enclose the identifier in quotes (for example, AA15 ). 126 BusinessObjects Planning Excel Analyst User Guide
Working with Ad Hoc Reports in Excel Modifying and updating ad hoc reports 4 If the member identifier begins with a zero (0), Excel may treat the zero as a leading zero and remove it. To prevent this, type a ' (single-quote) before typing your identifier, or change the cell to a text cell by right-clicking the cell, selecting Format Cells, and selecting Text from the Category list. To edit a column range manually: 1. If the column range does not yet exist, click the cell you want as the first column in the report, hold down the SHIFT key, and click the cell that you want as the last column in the report. Then, right-click one of the selected cells, and select BusinessObjects Planning, Column, and an item from the menu. 2. In the column range, select the cell that you want to edit. (If you are having trouble locating the column range, right-click and select BusinessObjects Planning and View Dimensions to display a window containing a list of dimensions defined in your report. Select the column range from this window to display it.) 3. In this cell, enter the identifier of the member whose values you want displayed in this report column. (For example, 2002.P.M3 is a time period identifier for the third month of the 2002 plan.) OR If you are specifying the display state of the data, type either a % for rate or a $ for a dollar amount. Note: For more information on time periods, see Specifying time periods on page 98. 4. Repeat this step for each cell in the range that you want to edit. (You can leave a column blank. If you do so, it becomes the equivalent of a text column in BusinessObjects Planning Administrator and BusinessObjects Planning Analyst Pro.) Shrinking a column range If you want to reduce the length of a column range in your report, you must specify the new column range by selecting it. You can then use the Dimension Wizard to edit the range. To shrink a column range: 1. Click the cell you want as the first cell in the column range, hold down the SHIFT key, and click the cell that you want as the last cell in the column range. 2. Right-click one of the selected cells, and select BusinessObjects Planning, Column, and the column range dimension from the menu. BusinessObjects Planning Excel Analyst User Guide 127
4 Working with Ad Hoc Reports in Excel Modifying and updating ad hoc reports Note: If you have forgotten the dimension of your column range, you can view it. See Viewing and highlighting dimensions on page 106 for more information. 3. In the dialog box that asks you whether you want to replace the previous selection, click Yes. 4. In the dialog box that asks you whether you want to replace the old dimension, click Yes. 5. In the Select Report Dimensions dialog box, you can edit the column range if necessary. See Editing a column range using the Dimension Wizard on page 123. 6. Click Finish. Deleting dimensions from reports When you delete a dimension, you are simply specifying that you do not want it as part of the report. Once deleted, you can add it again at a different level in the report or you can leave it unspecified. If left unspecified, its member is inherited from the user default, site default, or model properties. To delete a dimension for a report: 1. Right-click any cell in the report area and select BusinessObjects Planning and View Dimensions from the menu. 2. In the Report Dimensions dialog box, from the Ad hoc Reports list, select the report whose dimensions you want to delete. The default is to delete dimensions from the current report. 128 BusinessObjects Planning Excel Analyst User Guide
Working with Ad Hoc Reports in Excel Modifying and updating ad hoc reports 4 Note: You must select a cell in a report area in order to be able to delete dimensions from any report. Scaling data 3. From the Dimensions list, select the dimension you want to delete. 4. Click Delete to delete the dimension. Warning: If you delete all of the dimensions, the report area is also deleted. 5. Click Cancel to close the Report dimensions dialog box. You can scale the data contained in ad hoc reports to make them easier to read. For example, you can display revenue and expense numbers in thousands ($M), and assets and liabilities in millions ($MM). You can also display other non-financial numbers, such as percentages and FTEs, as unscaled. Note: Typically, when data is loaded into the database, it is stored as unscaled. However, your organization may scale data before loading it. If your data is pre-scaled in the database, the scaling factors in your reports may need to be changed. The following table describes your options: BusinessObjects Planning Excel Analyst User Guide 129
4 Working with Ad Hoc Reports in Excel Modifying and updating ad hoc reports Scaling Option Setting in Excel Assets/ Liabilities Revenues/ Expenses No scaling (default) NONE none none none User defined n Divides by the factor you specify (n) Assets/Liabilities $MM, all else $M Assets/Liabilities $M MM M Divides the number by 1,000,000 Divides the number by 1,000 Divides by the factor you specify (n) Divides the number by 1,000 none Non-Financial Divides by the factor you specify (n) none none You can scale data at the section, column, and row levels of a report. The scaling factor that you set at the row level overrides what you set at the column level, and the scaling factor that you set at the column level overrides what you set at the section level. You can also scale data that is displayed and entered in function-based ad hoc reports by setting the ScalingFactor parameter for the IGETVAL and IPUTVAL functions. For more information, see Creating ad hoc reports using functions on page 108 and The BusinessObjects Planning Worksheet Functions on page 141. To scale data at the section level in an ad hoc report: 1. Specify a cell for the ScalingFactor section property by right-clicking a single cell in the report and selecting BusinessObjects Planning, Section, and Scaling Factor from the menu. (For more information on specifying section properties, see Creating ad hoc reports using report areas on page 72.) OR If a cell that specifies the ScalingFactor section property already exists in the ad hoc report, right-click that cell and select BusinessObjects Planning, Select Scalingfactor from the menu. (If the ad hoc report was 130 BusinessObjects Planning Excel Analyst User Guide
Working with Ad Hoc Reports in Excel Modifying and updating ad hoc reports 4 created from an existing BusinessObjects Planning report, the cell specifying the ScalingFactor section property will be located with the other section properties at the top left of the report.) 2. In the Select Scaling Factor dialog box, select an option from the Scaling factor list. (The scale factor you choose here will be applied to data contained in the entire section of the report.) 3. If you chose the User defined option, specify a scaling factor in the User defined text box. 4. Click OK. Note: To see report data scaled by the factor that you specified, you must first refresh the report by clicking the Ad Hoc toolbar. (Refresh Ad Hoc Report) on BusinessObjects Planning Excel Analyst User Guide 131
4 Working with Ad Hoc Reports in Excel Modifying and updating ad hoc reports To scale data at the column level in an ad hoc report: 1. Create a column range by clicking the cell in an empty row where the report data begins, holding down the SHIFT key, and clicking the cell in the empty row where the data ends. Then, right-click one of the highlighted cells and select BusinessObjects Planning, Column, and Scaling Factor from the menu. Note: If the ad hoc report was created from an existing BusinessObjects Planning report that contained scaled data at the column level, the ad hoc report will already contain a column range for the scaling factor. 2. In the Select Scaling Factor dialog box, select an option from the Scaling factor list. (The scale factor you choose here will only be applied to data contained in the first column of the column range.) 3. If you chose the User defined option, specify a scaling factor in the User defined text box. 4. Click OK. 5. If you want to copy the scaling factor across the rest of the column range, press CTRL + R. OR If you want to specify a different scaling factor for a column contained in the column range, right-click the appropriate cell in the column range, select BusinessObjects Planning, Select Scalingfactor from the menu, choose a scaling factor from the list, and click OK. Repeat this step for each column in the range whose scaling factor you want to set. 132 BusinessObjects Planning Excel Analyst User Guide
Working with Ad Hoc Reports in Excel Modifying and updating ad hoc reports 4 Note: To see report data scaled by the factor(s) that you specified, you must first refresh the report by clicking the Ad Hoc toolbar. (Refresh Ad Hoc Report) on To scale data at the row level in an ad hoc report: 1. Create a row range by clicking the cell in an empty column where the report data begins, holding down the SHIFT key, and clicking the cell in the empty column where the data ends. Then, right-click one of the highlighted cells and select BusinessObjects Planning, Row, and Scaling Factor from the menu. Note: If the ad hoc report was created from an existing BusinessObjects Planning report that contained scaled data at the row level, the ad hoc report will already contain a row range for the scaling factor. 2. In the Select Scaling Factor dialog box, select an option from the Scaling factor list. (The scale factor you choose here will only be applied to data contained in the first row of the row range.) 3. If you chose the User defined option, specify a scaling factor in the User defined text box. 4. Click OK. 5. If you want to copy the scaling factor down the rest of the row range, press CTRL + D. OR BusinessObjects Planning Excel Analyst User Guide 133
4 Working with Ad Hoc Reports in Excel Modifying and updating ad hoc reports If you want to specify a different scaling factor for a row contained in the row range, right-click the appropriate cell in the row range, select BusinessObjects Planning, Select Scalingfactor from the menu, choose a scaling factor from the list, and click OK. Repeat this step for each row in the range whose scaling factor you want to set. Note: To see report data scaled by the factor(s) that you specified, you must first refresh the report by clicking the Ad Hoc toolbar. Refreshing ad hoc reports (Refresh Ad Hoc Report) on There are any number of situations when you will want to refresh a report and retrieve data from the database. For example, when you first open a report, you may want to refresh it so that it displays the latest database values. Note: The first time you retrieve data from the database, it is unformatted. For example, you will have to format the data in Microsoft Excel to display the number of decimal places you want and to display negative numbers in the way that you want. (For information on how to use Microsoft Excel functionality, see the online help that comes with that application.) If you are entering data for a report built using report areas, be sure to upload the data before refreshing it. This ensures that the data is sent to the database. If you refresh before uploading, the data you entered will be lost. When you refresh an ad hoc report built using functions, the refresh recalculates all cells whose values are obtained by the IGETVAL function. To refresh an ad hoc report: 1. From the BusinessObjects Planning menu, select Ad hoc Reporting, and Refresh Ad hoc Report. 2. If the Log On dialog box appears, log on to the server. (This dialog box only appears if you were working off line.) Uploading data from ad hoc reports to the database If you have entered data in an ad hoc report, you may want to upload it to the database. If you save and close a report without uploading the data first, the data is saved with the report but is not added to the database. It is not added to the database until you upload it. By default, you cannot upload the data you enter in an ad hoc report area to the database. You need to explicitly specify that you want the data uploaded. However, cells containing calls to the IPUTVAL function always have their 134 BusinessObjects Planning Excel Analyst User Guide
Working with Ad Hoc Reports in Excel Modifying and updating ad hoc reports 4 values uploaded, even if you have not specified any upload flags. For more information on specifying data uploading, see Specifying whether to allow data to be uploaded on page 100. For more information on IPUTVAL, see The BusinessObjects Planning Worksheet Functions on page 141. If a cell is empty when you upload data, it is ignored. Only the cells containing data are loaded to the database. The data is uploaded only if the scenarios that are affected are not already checked out by another user. If you attempt to upload data to a cell that is not editable, or if any other error occurs during upload, an error dialog box is displayed, and an error message is written to the Log worksheet. If you want to upload data from a report that contains a non-editable cell, ensure that the upload flag for either the row or the column containing the cell is set to N ( do not upload data ). To upload data from an ad hoc report to the database: 1. From the BusinessObjects Planning menu, select Ad hoc Reporting, and Upload Data. 2. If the Log On dialog box appears, log on to the server. (This dialog box only appears if you were working offline.) Uploading and refreshing ad hoc reports If you have entered data in an ad hoc report, you may want to upload the data periodically. If you want to continue to work with the data, you may want to retrieve the uploaded data before continuing. With ad hoc reports, you can upload and refresh data at the same time. This is useful for updating planning lines, and then downloading the updated totals or ratios. By default, you cannot upload the data you enter in an ad hoc report area to the database. You need to explicitly specify that you want the data uploaded. However, cells containing calls to the IPUTVAL function always have their values uploaded, even if you have not specified any upload flags. For more information on specifying data uploading, see Specifying whether to allow data to be uploaded on page 100. For more information on IPUTVAL, see The BusinessObjects Planning Worksheet Functions on page 141. If a cell is empty when you upload data, it is ignored. Only the cells containing data are loaded to the database. The data is uploaded only if the scenarios that are affected are not already checked out by another user. If you attempt to upload data to a cell that is not editable, or if any other error occurs during upload, an error dialog box is displayed, and an error message is written to the Log worksheet. If you want to upload data from a report that contains a non-editable cell, ensure that the upload flag for either the row or the column containing the cell is set to N ( do not upload data ). BusinessObjects Planning Excel Analyst User Guide 135
4 Working with Ad Hoc Reports in Excel Modifying and updating ad hoc reports When you refresh an ad hoc report built using functions, the refresh recalculates all cells whose values are obtained by the IGETVAL function. To upload and refresh an ad hoc report: 1. From the BusinessObjects Planning menu, select Ad hoc Reporting, and Upload and Refresh. 2. If the Log On dialog box appears, log on to the server. (This dialog box only appears if you were working offline.) Uploading and refreshing ad hoc reports using Excel macros The BusinessObjects Planning Excel Analyst provides macros that allow you to upload or refresh reports from within other Excel macros. If you attempt to upload data to a cell that is not editable, or if any other error occurs during upload, an error dialog box is displayed, and an error message is written to the Log worksheet. The following macros are defined: Macro CUpload CRefresh Description Upload all data on the current worksheet. This is equivalent to selecting Upload Data from the BusinessObjects Planning menu. For more information on uploading reports, see Uploading data from ad hoc reports to the database on page 134. By default, you cannot upload the data you enter in an ad hoc report area to the database. You need to explicitly specify that you want the data uploaded. However, cells containing calls to the IPUTVAL function always have their values uploaded, even if you have not specified any upload flags. For more information on specifying upload flags, see Specifying whether to allow data to be uploaded on page 100. For more information on IPUTVAL, see The BusinessObjects Planning Worksheet Functions on page 141. Refresh all reports on the current worksheet. This is equivalent to selecting Refresh Ad hoc Report from the BusinessObjects Planning menu. For more information on refreshing reports, see Refreshing ad hoc reports on page 134. 136 BusinessObjects Planning Excel Analyst User Guide
Working with Ad Hoc Reports in Excel Modifying and updating ad hoc reports 4 Note: You can use the CLogMessage macro to write messages to the Log message workbook. For more information, see Writing a Log message on page 70. You can use these macros to update multiple worksheets quickly and easily. To create a macro that updates or refreshes ad hoc reports: 1. Create a macro using the Excel macro creation functionality. (Refer to the Microsoft Excel help for information on how to create macros in Excel.) 2. From the Tools menu, select Macro and Macros. 3. From the Macro window, select your macro from the list provided, and click Edit. 4. In the Microsoft Visual Basic window, select Tools and References. BusinessObjects Planning Excel Analyst User Guide 137
4 Working with Ad Hoc Reports in Excel Modifying and updating ad hoc reports 5. Select the BusinessObjectsPlanningExcelAnalyst check box to link your current code with the BusinessObjects Planning project. 6. Click OK. 7. In the Code window, which contains the code for your macro, specify the worksheet containing the report you want to refresh or upload. For example, the following code selects a worksheet named Sheet1: Sheets("Sheet1").Select 8. Add the BusinessObjects Planning Excel Analyst macros. These macros can be in either of two formats: CRefresh CUpload Application.Run "CRefresh" Application.Run "CUpload" 138 BusinessObjects Planning Excel Analyst User Guide
Working with Ad Hoc Reports in Excel Modifying and updating ad hoc reports 4 If you use the second format, you do not need to follow steps 4, 5, and 6 above. 9. In the Microsoft Visual Basic window, from the File menu, select Close and Return to Microsoft Excel. 10. Save your Microsoft Excel file. Copying ad hoc reports BusinessObjects Planning allows you to make duplicate copies of worksheets in Excel. When you duplicate a worksheet, all ad hoc reports contained in the original worksheet, including all dimensions, functions and report properties, are copied to the new worksheet. To duplicate a worksheet, right-click within the worksheet and select BusinessObjects Planning and Duplicate Worksheet from the menu. Note: When you right-click within a report area, BusinessObjects Planning will attempt to validate the report. For information, see Validating ad hoc reports on page 104. BusinessObjects Planning Excel Analyst User Guide 139
4 Working with Ad Hoc Reports in Excel Logging off of the server Saving ad hoc reports When you save an ad hoc report, you are simply saving a static Excel file. The data is saved with the file but not uploaded to the database. If you want to upload the data to the database, you have to do so before closing the report. For information on how to upload data, see Uploading data from ad hoc reports to the database on page 134. To save an ad hoc report: 1. Select Save from the File menu. 2. If the Save as dialog box appears, choose a location for the report, type a name for it, and click Save. Logging off of the server You can log off to end a report session. Logging off of the application assists in the conservation of server resources, improving overall performance of the BusinessObjects Planning Excel Analyst. To log off of the server, from the BusinessObjects Planning menu, select Log Off. 140 BusinessObjects Planning Excel Analyst User Guide
The BusinessObjects Planning Worksheet Functions appendix
The BusinessObjects Planning Worksheet Functions A Overview Overview This section provides descriptions of the worksheet functions that allow you to create reports by defining functions in cells. For more information on how to use these functions, see Creating ad hoc reports using functions on page 108. 142 BusinessObjects Planning Excel Analyst User Guide
The BusinessObjects Planning Worksheet Functions IGETVAL A IGETVAL Specifies that a value is to be loaded from the database. The value is displayed in the cell when the report is refreshed. Function syntax IGETVAL(Model,Unit,Scenario,Line,Currency,BalanceType, TimePeriod,DisplayCurrency,DisplayState,ScalingFactor,Pr oduct,customer,channel, Project,Transaction) Parameters Parameter Required Description Model Mandatory The business model identifier (not the name) To determine the identifier associated with a business model, start BusinessObjects Planning Administrator or BusinessObjects Planning Analyst Pro, use the Organizer to locate the business model, click its Properties tab, and click the Information tab. The business model identifier is displayed in the Identifier text box. If this Identifier text box is empty, enter a unique identifier and click Apply. Unit Mandatory The unit dimension member for this value Scenario Mandatory The scenario to which this value belongs Line Mandatory The line dimension member for this value Currency Mandatory The currency dimension member for this value BalanceType Mandatory The balance type dimension member for this value TimePeriod Mandatory The time period for this value DisplayCurrency Mandatory The display currency for this value BusinessObjects Planning Excel Analyst User Guide 143
The BusinessObjects Planning Worksheet Functions A IGETVAL Parameter Required Description DisplayState Mandatory Specifies whether this value is to be displayed as a percentage, a dollar value, or as originally entered. Must be one of the following: % Force display as a percentage. $ Force display in dollars. Current Display as entered. ScalingFactor Optional Determines whether this value is to be displayed as a scaled value and specifies the scaling factor. Possible values are the following: None No scaling is applied to the value. M Divide assets and liabilities by 1,000 and display the result. MM Divide assets and liabilities by 1,000,000, and revenues and expenses by 1,000 and display the result. n (userdefined integer) Divide value by n and display the result. Product Optional The product dimension member for this value. If not specified, the business model s default product dimension member is used. Customer Optional The customer dimension member for this value. If not specified, the business model s default customer dimension member is used. 144 BusinessObjects Planning Excel Analyst User Guide
The BusinessObjects Planning Worksheet Functions IPUTVAL A Parameter Required Description Channel Optional The channel dimension member for this value. If not specified, the business model s default channel dimension member is used. Project Optional The project dimension member for this value. If not specified, the business model s default project dimension member is used. Transaction Optional The transaction dimension member for this value. If not specified, the business model s default transaction dimension member is used. Note: If any parameter starts with 0 (zero), it must be enclosed in double quotes ("). Return values If the cell is not displaying the data value, it displays one of the following: Value $VALUE! $GET! Any other value Description Syntax error, or function specification not complete Your worksheet needs to be refreshed. To refresh your worksheet, from the BusinessObjects Planning menu, select Ad Hoc Reporting and Refresh Ad Hoc Report. If $GET! is displayed after the report is refreshed, a communication error has occurred. Microsoft Excel has detected an error. See the Microsoft Excel help for details. IPUTVAL Example Retrieve the value of the cell defined by the following dimensions: unit CM01, scenario 2002AM, line Assets, currency USD, balance type BKD, and time period M1. The display currency is USD, and the display state is CURRENT. =IGETVAL("STATEBANK","CM01","2002AM","Assets","USD","BKD","2 002.A.M1", "USD","CURRENT","Total","All","Total") Specifies that a value is to be written to the database. The value is written to the database when the report is uploaded. BusinessObjects Planning Excel Analyst User Guide 145
The BusinessObjects Planning Worksheet Functions A IPUTVAL The value written is not the value contained in the cell in which the IPUTVAL function is defined. The value written is contained in the cell specified by the Value parameter. Function syntax IPUTVAL(Value,Model,Unit,Scenario,Line,Currency,BalanceType, TimePeriod,DisplayCurrency,DisplayState,ScalingFactor,Pr oduct,customer, Channel,Project,Transaction) Parameters Parameter Required Description Value Mandatory The location of the spreadsheet cell containing the value to be written (for example, A5). The value contained in this cell is sent to the database when the report is uploaded, and is copied to the cell containing the IPUTVAL function. IPUTVAL uploads data even if you have not specified any upload flags. For more information on specifying upload flags, see Specifying whether to allow data to be uploaded on page 100. Model Mandatory The business model identifier (not the name) To determine the identifier associated with a business model, start BusinessObjects Planning Administrator or BusinessObjects Planning Analyst Pro, use the Organizer to locate the business model, click its Properties tab, and click the Information tab. The business model identifier is displayed in the Identifier text box. If this Identifier text box is empty, enter a unique identifier and click Apply. Unit Mandatory The unit dimension member for this value Scenario Mandatory The scenario to which this value belongs Line Mandatory The line dimension member for this value Currency Mandatory The currency dimension member for this value 146 BusinessObjects Planning Excel Analyst User Guide
The BusinessObjects Planning Worksheet Functions IPUTVAL A Parameter Required Description BalanceType Mandatory The balance type dimension member for this value TimePeriod Mandatory The time period for this value DisplayCurrenc Mandatory The display currency for this value y DisplayState Mandatory Specifies whether this value is to be displayed as a percentage, a dollar value, or as originally entered. Must be one of the following: % Force display as a percentage. $ Force display in dollars. Current Display as entered. ScalingFactor Optional Determines whether this value is to be scaled before it is uploaded to the database and specifies the scaling factor. Possible values are the following: None Upload value as entered. M Multiply assets and liabilities by 1,000 and upload the result. MM Multiply assets and liabilities by 1,000,000, and revenues and expenses by 1,000 and upload the result. n (userdefined integer) Multiply value by n and upload the result. Product Optional The product dimension member for this value. If not specified, the business model s default product dimension member is used. Customer Optional The customer dimension member for this value. If not specified, the business model s default customer dimension member is used. BusinessObjects Planning Excel Analyst User Guide 147
The BusinessObjects Planning Worksheet Functions A IPUTVAL Parameter Required Description Channel Optional The channel dimension member for this value. If not specified, the business model s default channel dimension member is used. Project Optional The project dimension member for this value. If not specified, the business model s default project dimension member is used. Transaction Optional The transaction dimension member for this value. If not specified, the business model s default transaction dimension member is used. Note: If any parameter starts with 0 (zero), it must be enclosed in double quotes ("). Return values When you perform a successful refresh, the value displayed in the cell is identical to the value displayed in the cell specified as the Value parameter to IPUTVAL. When you perform a successful upload, the uploaded value (obtained from the cell specified by the Value parameter) is displayed in the cell. When you perform an unsuccessful upload, the value currently in the database is downloaded and displayed in the cell. If the cell is not displaying a data value, it displays one of the following: Value Description $VALUE! Syntax error, or function specification not complete Any other value Microsoft Excel has detected an error. See the Microsoft Excel help for details. Example Upload the value in cell E1, using the following dimension values to specify the database entry to update: unit CM01, scenario 2002AM, line Assets, currency USD, balance type BKD, and time period M1. The display currency is USD, and the display state is CURRENT. =IPUTVAL(E1,"STATEBANK","CM01","2002AM","Assets","USD","BKD","2002.A.M1", "USD","CURRENT","Total","All","Total") 148 BusinessObjects Planning Excel Analyst User Guide
The BusinessObjects Planning Worksheet Functions IGETDIMATTR A IGETDIMATTR Retrieves an attribute of a specified member from the database. Function Syntax IGETDIMATTR(Model,DimensionName,Member,Attribute) Parameters Parameter Required Description Model Mandatory The business model identifier (not the name) To determine the identifier associated with a business model, start BusinessObjects Planning Administrator or BusinessObjects Planning Analyst Pro, use the Organizer to locate the business model, click its Properties tab, and click the Information tab. The business model identifier is displayed in the Identifier text box. If this Identifier text box is empty, enter a unique identifier and click Apply. Name Mandatory The dimension name (see below) MemberIdentifier Mandatory The member identifier. If this member identifier starts with 0 (zero), this parameter must be enclosed in double quotes ("). Attribute Mandatory The attribute to retrieve. For a complete list of valid dimension names and attributes, see Attributes for business objects on page 156. The DimensionName parameter must be one of the following: Unit Line Currency BalanceType Product Project Customer Channel BusinessObjects Planning Excel Analyst User Guide 149
The BusinessObjects Planning Worksheet Functions A IGETDIMATTR FiscalPeriod Transaction TimePeriod Rate, which is a defined general rate in a business model ExchangeRate, which is a defined exchange rate in a business model If your business model has renamed any of these dimension names, you must use the renamed dimension name, not the name shown here. All of these values, except for TimePeriod, Rate and ExchangeRate, correspond to potential dimensions in your business model. Any of these values can be specified if the dimension is defined in your model. TimePeriod is a time period for which a name is defined. To determine the general rates and exchange rates defined in a business model, in BusinessObjects Planning Administrator or BusinessObjects Planning Analyst Pro, expand the business model in the Organizer, and expand Business Rules and Rates. IGETDIMATTR allows you to obtain any attribute of a business object associated with a business model. Return values When you perform a successful refresh, the dimension attribute is displayed in the cell. If the cell is not displaying the dimension attribute, it displays one of the following: Value Description $VALUE! $ATTR! Any other value Syntax error, or function specification not complete Your worksheet needs to be refreshed, a value is not defined for this field, or a communication error has occurred. To refresh your worksheet, from the BusinessObjects Planning menu, select Ad Hoc Reporting and Refresh Ad Hoc Report. When you refresh your worksheet, the value of the cell specified as the IValue parameter is copied to this cell. Microsoft Excel has detected an error. See the Microsoft Excel help for details. Example Retrieves the name of the unit with member identifier "CM011": =IGETDIMATTR("STATEBANK","Unit","CM011","Name") 150 BusinessObjects Planning Excel Analyst User Guide
The BusinessObjects Planning Worksheet Functions IGETRATE A IGETRATE Retrives the name of a Line with the identifier BAL: IGETDIMATTR(StateBank,Line,BAL,Name) Retrieves the name of the first month of the fiscal year in the StateBank business model: IGETDIMATTR(StateBank,TimePeriod,M1,Name) Retrieves the name of a rate, given a rate identifier of BASERATES: IGETDIMATTR(StateBank,Rate,BASERATES,Name) Retrieves a currency exchange rate or a general rate. If you specify the mandatory parameters only, BusinessObjects Planning retrieves the global rate. If you specify additional optional parameters, BusinessObjects Planning retrieves the dimension specific rate, if one exists. Function Syntax IGETRATE(Model,Unit,Scenario,TimePeriod,Rate,Line,Currency,B alancetype,product, Customer,Channel,Project,Transaction) Parameters Parameter Required Description Model Mandatory The business model identifier (not the name) To determine the identifier associated with a business model, start BusinessObjects Planning Administrator or BusinessObjects Planning Analyst Pro, use the Organizer to locate the business model, click its Properties tab, and click the Information tab. The business model identifier is displayed in the Identifier text box. If this Identifier text box is empty, enter a unique identifier and click Apply. Unit Optional The unit identifier for the unit for which the scenario is defined. If this unit identifier starts with 0 (zero), this parameter must be enclosed in double quotes ("). Scenario Mandatory The scenario whose rate is to be retrieved. TimePeriod Mandatory The time period for this rate. Rate Mandatory The rate identifier for this rate. BusinessObjects Planning Excel Analyst User Guide 151
The BusinessObjects Planning Worksheet Functions A IGETRATE Parameter Required Description Line Optional The Line dimension member for this rate. Currency Optional The Currency dimension member for this rate. BalanceType Optional The Balance Type dimension member for this rate. For currency exchange rates, if you specify a spot balance type, BusinessObjects Planning retrieves the spot rate. Product Optional The Product dimension member for this rate. Customer Optional The Customer dimension member for this rate. Channel Optional The Channel dimension member for this rate. Project Optional The Project dimension member for this rate. Transaction Optional The Transaction dimension member for this rate. Return Value When you perform a successful refresh, the rate is displayed in the cell. If the cell does not display the rate, it displays one of the following: Value Description $VALUE! $RATE! Any other value Syntax error, or function specification not complete Your worksheet needs to be refreshed, a value is not defined for this field, or a communication error has occurred. To refresh your worksheet, from the BusinessObjects Planning menu, select Ad Hoc Reporting and Refresh Ad Hoc Report. Microsoft Excel has detected an error. See the Microsoft Excel help for details. Example Retrieves the January, 2002 prime rate for the unit with member identifier "CM011": =IGETRATE("STATEBANK","CM011","2002AM","1","PRIME") 152 BusinessObjects Planning Excel Analyst User Guide
The BusinessObjects Planning Worksheet Functions IGETMODATTR A IGETMODATTR Retrieves an attribute of a specified business model from the database. Function syntax IGETMODATTR(Model,Attribute) Parameters Parameter Required Description Model Mandatory The business model identifier (not the name) To determine the identifier associated with a business model, start BusinessObjects Planning Administrator or BusinessObjects Planning Analyst Pro, use the Organizer to locate the business model, click its Properties tab, and click the Information tab. The business model identifier is displayed in the Identifier text box. If this Identifier text box is empty, enter a unique identifier and click Apply. Attribute Mandatory The business model attribute to retrieve, which can be any of the following: Attribute Description Name The name of the model CurrentYear The current year of the model CurrentMonth The current month of the model CurrentQuarter The current quarter of the model DefaultReportingSli cedim DefaultEditSlicedim The default reporting slice for dimension dim of the model; for example, DefaultReportingSliceLine specifies the default reporting line for the model The default edit slice for dimension dim of the model; for example, DefaultEditSliceLine specifies the default edit line for the model BusinessObjects Planning Excel Analyst User Guide 153
The BusinessObjects Planning Worksheet Functions A IGETSCENATTR Return values When you perform a successful refresh, the business model attribute is displayed in the cell. If the cell is not displaying the business model attribute, it displays one of the following: Value $VALUE! $ATTR! Any other value Description Syntax error, or function specification not complete Your worksheet needs to be refreshed, a value is not defined for this field, or a communication error has occurred. To refresh your worksheet, from the BusinessObjects Planning menu, select Ad Hoc Reporting and Refresh Ad Hoc Report. When you refresh your worksheet, the value of the cell specified as the IValue parameter is copied to this cell. Microsoft Excel has detected an error. See the Microsoft Excel help for details. Example Retrieves the current year of the StateBank business model: =IGETMODATTR("STATEBANK","CurrentYear") IGETSCENATTR Retrieves an attribute of a specified scenario from the database. Function syntax IGETSCENATTR(Model,Unit,Scenario,Attribute) 154 BusinessObjects Planning Excel Analyst User Guide
The BusinessObjects Planning Worksheet Functions IGETSCENATTR A Parameters Parameter Required Description Model Mandatory The business model identifier (not the name) To determine the identifier associated with a business model, start BusinessObjects Planning Administrator or BusinessObjects Planning Analyst Pro, use the Organizer to locate the business model, click on its Properties tab, and click the Information tab. The business model identifier is displayed in the Identifier text box. If this Identifier text box is empty, enter a unique identifier and click Apply. Unit Mandatory The unit identifier for the unit for which the scenario is defined. If this unit identifier starts with 0 (zero), this parameter must be enclosed in double quotes ("). Scenario Mandatory The scenario whose attribute is to be retrieved Attribute Mandatory The scenario attribute to retrieve, which can be any of the following: Attribute Description Name The scenario name ScenarioType The scenario type (for example, Rollup ) FiscalPeriod The fiscal period of the scenario Formula The formula (if any) defined for the scenario ExchangeRate Version ExchangeRate Year OtherRateVersi on OtherRateYear The currency exchange rate version used in calculations The currency exchange rate year used in calculations The other rate version (if applicable) used in calculations The other rate year (if applicable) used in calculations BusinessObjects Planning Excel Analyst User Guide 155
The BusinessObjects Planning Worksheet Functions A Attributes for business objects Return values When you perform a successful refresh, the scenario attribute is displayed in the cell. If the cell is not displaying the scenario attribute, it displays one of the following: Value $VALUE! $ATTR! Any other value Description Syntax error, or function specification not complete Your worksheet needs to be refreshed, a value is not defined for this field, or a communication error has occurred. Your worksheet needs to be refreshed. To refresh your worksheet, from the BusinessObjects Planning menu, select Ad Hoc Reporting and Refresh Ad Hoc Report. When you refresh your worksheet, the value of the cell specified as the IValue parameter is copied to this cell. Microsoft Excel has detected an error. See the Microsoft Excel help for details. Example Retrieve the scenario type of the 2002 monthly actuals scenario for unit STATE: =IGETSCENATTR("STATEBANK","STATE","2002AM","ScenarioType") Attributes for business objects The following table identifies the field names whose values can be retrieved by the IGETDIMATTR worksheet function. In the IGETDIMATTR function, the business object (or dimension) is specified by the DimensionName parameter, and the field name (or dimension attribute) is specified by the Attribute parameter. For more information on IGETDIMATTR, see IGETDIMATTR on page 149. 156 BusinessObjects Planning Excel Analyst User Guide
The BusinessObjects Planning Worksheet Functions Attributes for business objects A BusinessObjects Planning Excel Analyst User Guide 157
The BusinessObjects Planning Worksheet Functions A Attributes for business objects Business object (DimensionName parameter) Unit Line Field name (Attribute parameter) Id Name ReportingCurrencyId DateOpened DateClosed ConsolidationFilters Domain Source Type Id Name EditDomain Type Content CalcMode Annualisis TimeAggregation DefaultSign DisplayMode Domain InputCurrencyId CurrencyId DateOpened DateClosed RelatedLineId PricingLineId SumToLineId Description ScaleFactor CoreFormula IncludeExcludeGridMC PostList Source 158 BusinessObjects Planning Excel Analyst User Guide
The BusinessObjects Planning Worksheet Functions Attributes for business objects A Business object (DimensionName parameter) Currency Balance Type Product Project Customer Field name (Attribute parameter) Id Name NonFinancial RateId Formula Source Id Name Type Category Formula Source Id Name Description Revisable Formula Source Id Name Description Revisable Formula Source Id Name Description Revisable Formula Source BusinessObjects Planning Excel Analyst User Guide 159
The BusinessObjects Planning Worksheet Functions A Attributes for business objects Business object (DimensionName parameter) Channel Transaction FiscalPeriod TimePeriod Rates ExchangeRates Field name (Attribute parameter) Id Name Description Revisable Formula Source Id Name Description Revisable Formula Source Id Name FiscalYear TimePeriodSet FPVersion Id Name IsCalculated TimePeriodSet Id Name Annualisis IsAllowedInheritance Id Name Annualisis IsAllowedInheritance 160 BusinessObjects Planning Excel Analyst User Guide
Time Period Tables appendix
Time Period Tables B Overview Overview A reporting period consists of three components: a year, a version, and a time period. For example, 2004.A.M3 represents the 2004 monthly actual data for month 3. The following table describes the reporting period components in more detail. Component Description Year Any four-digit year, such as 2003 Version One of the following: A Actuals F Forecast P Plan Time period A valid time period This section describes the time periods that you can use to define reporting periods. 162 BusinessObjects Planning Excel Analyst User Guide
Time Period Tables Yearly time periods B Yearly time periods You can use yearly time periods in yearly, half yearly, quarterly, monthly, and daily scenarios. Time Period If the current year is: 2000 2001 2002 2003 ID Description Examples the Years used as the time period are: Y or Y? Current year Y 2000 2001 2002 2003 Y-n n years ago Y-2 1998 1999 2000 2001 Y+n n years from Y+3 2003 2004 2005 2006 now YR Full year YR 2000 2001 2002 2003 Y.y Yearly rolling forecast for y years Y.3 2000, 2001, 2002 2001, 2002, 2003 2002, 2003, 2004 2003, 2004, 2005 Y-n.y Y+n.y Yearly rolling forecast for y years, starting n years ago Yearly rolling forecast for y years, starting n years from now Y.4 2000, 2001, 2002, 2003 Y-1.3 1999, 2000, 2001 Y-3.4 1997, 1998, 1999, 2000 Y+1.3 2001, 2002, 2003 Y+3.4 2003, 2004, 2005, 2006 2001, 2002, 2003, 2004 2000, 2001, 2002 1998, 1999, 2000, 2001 2002, 2003, 2004 2004, 2005, 2006, 2007 2002, 2003, 2004, 2005 2001, 2002, 2003 1999, 2000, 2001, 2002 2003, 2004, 2005 2005, 2006, 2007, 2008 2003, 2004, 2005, 2006 2002, 2003, 2004 2000, 2001, 2002, 2003 2004, 2005, 2006 2006, 2007, 2008, 2009 These definitions can only be evaluated if the scenario specified is a compound, and the compound has scenarios of the relevant years. BusinessObjects Planning Excel Analyst User Guide 163
Time Period Tables B Half yearly time periods Yearly spot balance time periods Note that yearly time periods containing the :SPOT suffix can only be used in daily scenarios. Time Period ID Description Examples Definitions coded with * can only be evaluated if the scenario specified is a compound, and the compound has scenarios of the relevant years. These examples assume that your fiscal year starts in January. If your fiscal year starts in a month other than January, you will need to adjust these dates appropriately. Half yearly time periods If the current year is 2003, the Day used as the time period is: Y:SPOT The last day of the current year Y:SPOT December 31, 2003 or Y?:SPOT Y-n:SPOT The last day of the specified year, which is n years before the current year Y-2:SPOT December 31, 2001* Y+n:SPO T Y- n.y:spot Y+n.y:SP OT The last day of the specified year, which is n years after the current year The last day of the last year of the specified rolling forecast. To determine this year, start with the current year, then subtract n, add y, and subtract 1. The last day of the last year of the specified rolling forecast. To determine this year, start with the current year, then add n, add y, and subtract 1. Y+3:SPOT December 31, 2006* Y-1.3:SPOT December 31, 2004* Y-3.2:SPOT December 31, 2001* Y+1.3:SPOT December 31, 2006* Y+3.2:SPOT December 31, 2007* You can use half yearly time periods in half yearly, quarterly, monthly, and daily scenarios. 164 BusinessObjects Planning Excel Analyst User Guide
Time Period Tables Half yearly time periods B Time Period ID Description Examples If the Half year of the model is: H1 H2 the Half years used as the time period are: H- Previous half year H- 2* 1 H+ Next half year H+ 2 1** H? or H Current half year H 1 2 H-n n half years ago H-2 1* 2* H+n n half years from now H+3 2** 1## Hn Half year n, relative to the start of H2 n in all cases the fiscal period (n must be a number from 1 to 2) H.h Semi-annual rolling forecast for h H.3 1,2,1** 2,1,2** half years H.4 1,2,1,2** 2,1,2,1## H-n.h Half yearly rolling forecast for h half H-1.3 2,1,2* 1,2,1** years, starting n half years ago H-3.4 2,1,2,1# 1,2,1,2* H+n.h Half yearly rolling forecast for h half years, starting n half years from now H+1.3 2,1,2** 1,2,1## Definitions coded with an * can only be evaluated if the scenario specified is a compound, and the compound has a scenario of the previous fiscal year. Definitions coded with an ** can only be evaluated if the scenario specified is a compound, and the compound has a scenario of the following fiscal year. Definitions coded with a # can only be evaluated if the scenario specified is a compound, and the compound has a scenario of the previous two fiscal years. Definitions coded with a ## can only be evaluated if the scenario specified is a compound, and the compound has scenarios of the next two fiscal years. BusinessObjects Planning Excel Analyst User Guide 165
Time Period Tables B Quarterly time periods Quarterly time periods Time Period You can use quarterly time periods in quarterly, monthly, and daily scenarios. ID Description Example s If the Quarter of the model is: Q1 Q2 Q3 Q4 the Quarters used as the time period are: Q- Previous quarter Q- 4* 1 2 3 Q+ Next quarter Q+ 2 3 4 1** Q? or Q Current quarter Q 1 2 3 4 Q-n n quarters ago Q-2 3* 4* 1 2 Q+n n quarters from now Q+3 4 1** 2** 3** ROYQ Rest of Year from a ROYQ 2-4 3-4 4 none quarterly scenario YTDQ Year to Date YTDQ 1 1-2 1-3 1-4 Qn Quarter n, relative to the Q2 n in all cases start of the fiscal period (n must be a number from 1 to 4) YTDQn Quarter n year to date (n YTDQ3 1-n in all cases must be a number from 1 to 4) Q.q Quarterly rolling forecast Q.3 1,2,3 2,3,4 3,4,1** 4,1,2** for q quarters Q.4 1,2,3,4 2,3,4,1** 3,4,1,2** 4,1,2,3** Q-n.q Quarterly rolling forecast Q-1.3 4,1,2* 1,2,3 2,3,4 3,4,1** for q quarters, starting n quarters ago Q-3.4 2,3,4,1* 3,4,1,2* 4,1,2,3* 1,2,3,4 Q+n.q Quarterly rolling forecast for q quarters, starting n quarters from now Q+1.3 2,3,4 3,4,1** 4,1,2** 1,2,3** Q+3.4 4,1,2,3** 1,2,3,4** 2,3,4,1# 3,4,1,2# 166 BusinessObjects Planning Excel Analyst User Guide
Time Period Tables Quarterly time periods B Definitions coded with an * can only be evaluated if the scenario specified is a compound, and the compound has a scenario of the previous fiscal year. Definitions coded with an ** can only be evaluated if the scenario specified is a compound, and the compound has a scenario of the following fiscal year. Definitions coded with a # can only be evaluated if the scenario specified is a compound, and the compound has scenarios of the next two fiscal years. Quarterly spot balance time periods Note that quarterly time periods containing the :SPOT suffix can only be used in daily scenarios. Time Period ID Description Examples Q:SPOT or Q?:SPOT Qn:SPOT Q-n:SPOT Q+n:SPOT Q- n.q:spot Q+n.q:SPO T If the current year is 2003, and the current quarter is Q1, the Day used as the time period is: The last day of the current quarter Q:SPOT March 31, 2003 The last day of quarter n; n must be a number from 1 to 4 The last day of the specified quarter, which is n quarters before the current quarter The last day of the specified quarter, which is n quarters after the current quarter The last day of the last quarter of the specified rolling forecast. To determine this quarter, start with the current quarter, then subtract n, add q, and subtract 1. The last day of the last quarter of the specified rolling forecast. To determine this quarter, start with the current quarter, then add n, add q, and subtract 1. Q2:SPOT June 30, 2003 Q-2:SPOT September 30, 2002* Q+3:SPOT December 31, 2003 Q-1.3:SPOT June 30, 2003 Q-3.2:SPOT September 30, 2002* Q+1.3:SPOT December 31, 2003 Q+3.2:SPOT March 31, 2004** Definitions coded with an * can only be evaluated if the scenario specified is a compound, and the compound has a scenario of the previous fiscal year. BusinessObjects Planning Excel Analyst User Guide 167
Time Period Tables B Monthly time periods Definitions coded with an ** can only be evaluated if the scenario specified is a compound, and the compound has a scenario of the following fiscal year. These examples assume that your fiscal year starts in January. If your fiscal year starts in a month other than January, you will need to adjust these dates appropriately. Monthly time periods Time Period ID Desc. Exampl es YTDM ROYM M? or M Year-to- Date (Monthly) Rest of Year (Monthly) Current Month M- Previous Month You can use monthly time periods in monthly and daily scenarios. If the Month of the model is: M1 M2 M3 M4 M5 M6 M7 M8 M9 M10 M11 M12 the Months used as the time period are: YTDM 1 1-2 1-3 1-4 1-5 1-6 1-7 1-8 1-9 1-10 1-11 1-12 ROYM 2-12 3-12 4-12 5-12 6-12 7-12 8-12 9-12 10-12 11-12 12 n/m M 1 2 3 4 5 6 7 8 9 10 11 12 M- 12 * 1 2 3 4 5 6 7 8 9 10 11 M+ Next Month M+ 2 3 4 5 6 7 8 9 10 11 12 1** M-n n Months Ago M-2 11* 12 * 1 2 3 4 5 6 7 8 9 10 M+n Q?TD M n Months From Now Current Quarter Month to Date M-3 10 * 11* 12 * 1 2 3 4 5 6 7 8 9 M+2 3 4 5 6 7 8 9 10 11 12 1** 2** M+3 4 5 6 7 8 9 10 11 12 1** 2** 3** 1 1,2 1,2,3 4 4,5 4,5,6 7 7,8 7,8,9 10 10, 11 10, 11, 12 168 BusinessObjects Planning Excel Analyst User Guide
Time Period Tables Monthly time periods B Time Period ID Desc. Exampl es Q- TDM Q+TD M QnTD M Q?Mn Q?M Previous Quarter To Date Next Quarter To Date Quarter n Monthly to Date (n must be a number from 1 to 4) Current Quarter Month n (n must be a number from 1 to 3) Completed Quarter Total: divides the model month by 3 and rounds down. Only available in monthly scenarios. 10 * 10, 11* 4 4, 5 n=1 1 1, 2 n=2 4 4, 5 n=3 7 7, 8 n=4 10 10, 11 10, 11, 12 * 4, 5, 6 1, 2, 3 4, 5, 6 7, 8, 9 10, 11, 12 1 1,2 1,2,3 7 7, 8 1 1, 2 4 4, 5 7 7, 8 10 10, 11 7, 8, 9 1, 2, 3 4, 5, 6 7, 8, 9 10, 11, 12 4 4,5 4,5,6 7 7,8 7,8,9 10 10, 11 1 1, 2 4 4, 5 7 7, 8 10 10, 11 10, 11, 12 1, 2, 3 4, 5, 6 7, 8, 9 10, 11, 12 1** 1, 2** 1, 2, 3** 1 1, 2 1, 2, 3 4 4, 5 4, 5, 6 7 7, 8 7, 8, 9 10 10, 11 n=1 1 1 1 4 4 4 7 7 7 10 10 10 n=2 2 2 2 5 5 5 8 8 8 11 11 11 n=3 3 3 3 6 6 6 9 9 9 12 12 12 Q?M 10, 11, 12 * If the Month of the model is: M1 M2 M3 M4 M5 M6 M7 M8 M9 M10 M11 M12 the Months used as the time period are: 10, 11, 12 * 1, 2, 3 1, 2, 3 1, 2, 3 4, 5, 6 4, 5, 6 4, 5, 6 7, 8, 9 7, 8, 9 7, 8, 9 10, 11, 12 10, 11, 12 BusinessObjects Planning Excel Analyst User Guide 169
Time Period Tables B Monthly time periods Time Period ID Desc. Exampl es Q-M Q+M Q?YT D Previous Completed Quarter Total: divides the model month by 3, rounds down, and subtracts 1. Only available in monthly scenarios. Next Completed Quarter Total: divides the model month by 3, rounds down, and adds 1. Only available in monthly scenarios. Completed Quarter Year-to- Date Total Q-YTD Previous Completed Quarter Year-to- Date Total Q-M 7, 8, 9* Q+M 1, 2, 3 If the Month of the model is: M1 M2 M3 M4 M5 M6 M7 M8 M9 M10 M11 M12 the Months used as the time period are: 7, 8, 9* 1, 2, 3 10, 11, 12 * 4, 5, 6 Q?YTD x x 1, 2, 3 10, 11, 12 * 4, 5, 6 1, 2, 3 10, 11, 12 * 4, 5, 6 1, 2, 3 1, 2, 3 7, 8, 9 Q-YTD x x x x x 1, 2, 3 1, 2, 3 7, 8, 9 1, 2, 3 7, 8, 9 4, 5, 6 10, 11, 12 4, 5, 6 10, 11, 12 4, 5, 6 10, 11, 12 7, 8, 9 1, 2, 3** 1-6 1-6 1-6 1-9 1-9 1-9 1-12 1, 2, 3 1, 2, 3 1-6 1-6 1-6 1-9 170 BusinessObjects Planning Excel Analyst User Guide
Time Period Tables Monthly time periods B Time Period ID Desc. Exampl es YTDM n Month n year-todate (n must be a number from 1 to 12) Mn Month n, relative to the start of the fiscal period (n must be a number from 1 to 12) M.m Monthly rolling forecast for m months M-n.m Monthly rolling forecast for m months, starting n months ago M+n.m Monthly rolling forecast for m months, starting n months from now YTDM6 M4 M.3 1,2,3 M.4 1,2,3, 4 M-1.3 12, 1, 2* M-3.4 10, 11, 12, 1* M+1.3 2,3,4 M+3.4 4,5,6, 7 If the Month of the model is: M1 M2 M3 M4 M5 M6 M7 M8 M9 M10 M11 M12 the Months used as the time period are: 1-n in all cases n in all cases 2,3,4 2,3,4, 5 1,2,3 11, 12, 1, 2* 3,4,5 5,6,7, 8 3,4,5 3,4,5, 6 2,3,4 12, 1,2, 3* 4,5,6 6,7,8, 9 4,5,6 4,5,6, 7 3,4,5 1,2,3, 4 5,6,7 7,8,9, 10 5,6,7 5,6,7, 8 4,5,6 2,3,4, 5 6,7,8 8,9,10, 11 6,7,8 6,7,8, 9 5,6,7 3,4,5, 6 7,8,9 9, 10, 11, 12 7,8,9 7,8,9, 10 6,7,8 4,5,6, 7 8,9,10 10, 11, 12, 1** 8,9,10 8,9,10, 11 7,8,9 5,6,7, 8 9, 10, 11 11, 12, 1, 2** 9, 10, 11 9, 10, 11, 12 8,9,1 0 6,7,8,9 10, 11, 12 12, 1,2,3 ** 10, 11, 12 10, 11, 12, 1** 9, 10, 11 7,8,9,10 11, 12, 1** 1,2,3, 4** 11, 12, 1** 11, 12, 1, 2** 10, 11, 12 8,9,1 0, 11 12, 1, 2** 2,3,4, 5** 12, 1, 2** 12, 1, 2, 3** 11, 12, 1** 9, 10, 11, 12 1,2,3 ** 3,4,5, 6** BusinessObjects Planning Excel Analyst User Guide 171
Time Period Tables B Monthly time periods Definitions coded with * can only be evaluated if the scenario specified is a compound, and the compound has a scenario of the previous fiscal year. Definitions coded with ** can only be evaluated if the scenario specified is a compound, and the compound has a scenario of the next fiscal year. x = not meaningful. Monthly spot balance time periods Note that monthly time periods containing the :SPOT suffix can only be used in daily scenarios. Time Period ID Description Examples M:SPOT or M?:SPOT Mn:SPOT M-n:SPOT M+n:SPOT M- n.m:spot M+n.m:SPO T If the current year is 2003, and the current month is March, the Day used as the time period is: The last day of the current month M:SPOT March 31, 2003 The last day of month n; n must be a number from 1 to 12 The last day of the specified month, which is n months before the current month The last day of the specified month, which is n months after the current month The last day of the last month of the specified rolling forecast. To determine this month, start with the current month, then subtract n, add m, and subtract 1. The last day of the last month of the specified rolling forecast. To determine this month, start with the current month, then add n, add m, and subtract 1. M2:SPOT February 28, 2003 M-2:SPOT January 31, 2003 M+3:SPOT June 30, 2003 M-1.3:SPOT April 30, 2003 M-3.2:SPOT January 31, 2003 M+1.3:SPOT June 30, 2003 M+3.2:SPOT July 31, 2003 These examples assume that your fiscal year starts in January. If your fiscal year starts in a month other than January, you will need to adjust these dates appropriately. 172 BusinessObjects Planning Excel Analyst User Guide
Time Period Tables Weekly time periods B Weekly time periods Time Period You can use weekly time periods in weekly and daily scenarios. ID Description Exampl es Daily time periods If the Week of the model is: W1 W2 W3 W4 the Weeks used as the time period are: W[n] Identifies a particular week W1 1 2 3 4 in a fiscal period. W5 is the fifth week in the fiscal period W? Current week W 1 2 3 4 ROYW Rest of Year from a weekly ROYW 2-4 3-4 4 none scenario YTDW Year to Date YTDW 1-n in all cases YRW Full year aggregated value over the weekly data W[+ -][n][.m] A specific week with arbituary length based on the incremental decremental absolute offset from the current week YRW W+1 W2.3 Aggregated value of W1 to Wn in all cases W2 W2-W4 W3 W2-W4 W4 W2-W4 W5 W2-W4 Time periods that display data for individual days can use one of two current days: The global current day, which is the current day for the entire business model. To view the global current day for your business model, go to the Organizer window in BusinessObjects Planning Administrator or BusinessObjects Planning Analyst Pro, expand the Business Views folder, select the business model, and click the Properties tab. The global current day is displayed in the Current day field. For details on time periods that reference the global current day, see Time periods that reference the global current day of the model on page 175. BusinessObjects Planning Excel Analyst User Guide 173
Time Period Tables B Daily time periods The local current day for a scenario/unit combination, which can be set when a data file is loaded (usually by specifying it as a header row). If the local current day is not defined for this scenario and unit, or has not been set by your organization, the global current day is used. The local current day, if defined, cannot be viewed from the Organizer. For details on time periods that reference the local current day, see Time periods that reference the local current day of the scenario on page 181. The following values affect the day referred to by a particular time period: The current month (a value from 1 to 12) The current day (a value from 1 to 28, 29, 30, or 31, depending on the current month) The current week, which is calculated as described in the following section. Time periods that specify individual days display only the value for that day, even if the data is stored cumulatively. Determining the current week Many daily reporting time periods use a day or day range that is based on the current week. This current week depends on the current day and on the values of several settings in your shared Planning.ini file. To determine the current week: 1. Start with the current day value (either global or local). 2. Subtract the value of the BackdateNumberOfDays setting, which is found in the [Calendar] section of the Planning.ini file. For example, if the current day is Saturday, May 19, and BackdateNumberOfDays is 2, the result is Thursday, May 17. 3. Use the EndOfWeekDay setting to determine the weekday that has been designated as the end of the week. This setting is found in the [Calendar] section of the Planning.ini file, and contains a value from Monday to Sunday. 4. Determine the day in step 3 that is closest to, but not greater than, the result you calculated in step 2. Examples: If the current day is Saturday, May 19, the result you calculated in step 2 is Thursday, May 17, and EndOfWeekDay is Wednesday, the day you want is Wednesday, May 16. If the current day is Saturday, May 19, the result you calculated in step 2 is Thursday, May 17, and EndOfWeekDay is Thursday, the day you want is Thursday, May 17. 174 BusinessObjects Planning Excel Analyst User Guide
Time Period Tables Daily time periods B If the current day is Saturday, May 19, the result you calculated in step 2 is Thursday, May 17, and EndOfWeekDay is Friday, the day you want is Friday, May 11 (not May 18, since 18 is greater than 17). 5. The current week is the seven-day period ending in the day you determined in step 4. For example: If the day you determined in step 4 is May 16, the current week is May 10-16. Time periods that reference the global current day of the model Time Period ID Description Example s WEE or WEE? WEE+n If the fiscal year starts in January, the current month = 5 (May), EndOfWeekDay = Saturday, and BackdateNumberOfDays = 1: Current Day = Tuesday, May 6 Current Day = Monday, May 19 the Days used as the time period are: Last day of the current week May 3 May 17 May 26 Last day of the week that is n weeks later than the current week n=2 May 17 May 31 June 9 n=3 May 24 June 7 June 16 Current Day = Monday, May 28 WEE-n WES or WES? WES+n Last day of the n=2 April 19 May 3 May 12 week that is n weeks earlier than the current week n=3 April 12 April 26 May 5 First day of the current week April 27 May 11 May 20 First day of the week that is n weeks later than the current week n=2 May 11 May 25 June 3 n=3 May 18 June 1 June 10 BusinessObjects Planning Excel Analyst User Guide 175
Time Period Tables B Daily time periods Time Period ID Description Example s WES-n WEn First day of the week that is n weeks earlier than the current week Aggregate value for the nth complete week of the year n=2 April 13 April 27 May 6 n=3 April 6 April 20 April 29 The days in the nth complete week of the year in all cases D or D? Current day May 6 May 19 May 28 D+n n days from now n=2 May 8 May 21 May 30 n=3 May 9 May 22 May 31 D-n n days ago n=2 May 4 May 17 May 26 n=3 May 3 May 16 May 25 Dn Day n (n must be a number from 1 to 366) n in all cases; see note below for details on how this time period is displayed MTD or MTD? MTD+n If the fiscal year starts in January, the current month = 5 (May), EndOfWeekDay = Saturday, and BackdateNumberOfDays = 1: Current Day = Tuesday, May 6 Current Day = Monday, May 19 the Days used as the time period are: Current Day = Monday, May 28 Current month-to-date aggregate value May 1-6 May 1-19 May 1-28 Aggregate value n=2 May 1-8 May 1-21 May 1-30 from start of month to current day plus n days n=5 May 1-13 May 1-26 n/m MTD-n Aggregate value from start of month to current day minus n days n=2 May 1-4 May 1-17 May 1-26 n=8 n/m May 1-11 May 1-20 MTDM or MTDM? Current month-to-date aggregate value May 1-6 May 1-19 May 1-28 176 BusinessObjects Planning Excel Analyst User Guide
Time Period Tables Daily time periods B Time Period ID Description Example s MTDM+ n Aggregate daily value from start of month to current day for the month n months later than the current month MTDM-n Aggregate daily value from start of month to current day for the month n months earlier than the current month WE or WE? WE+n WE-n D.d or D?.d If the fiscal year starts in January, the current month = 5 (May), EndOfWeekDay = Saturday, and BackdateNumberOfDays = 1: Current Day = Tuesday, May 6 Current Day = Monday, May 19 the Days used as the time period are: Current Day = Monday, May 28 n=2 July 1-6 July 1-19 July 1-28 n=3 August 1-6 August 1-19 August 1-28 n=2 March 1-6 March 1-19 March 1-28 n=3 February 1-6 February 1-19 February 1-28 Rolling forecast total of daily values for the current week April 27-May 3* May 11-17 May 20-26 Rolling forecast n=2 May 11-17 May 25-31 June 3-9* total of daily values for the week that is n n=3 May 18-24 June 1-7* June 10-16* weeks later than the current week Rolling forecast n=2 April 13-19* April 27-May 3* May 6-12 total of daily values for the week that is n n=3 April 6-12* April 20-26* April 29-May 5* weeks earlier than the current week Daily rolling d=5 May 6-10 May 19-23 May 28-June 1* forecast for d days, starting with the global current day BusinessObjects Planning Excel Analyst User Guide 177
Time Period Tables B Daily time periods Time Period ID Description Example s D+n.d D-n.d D:MTD or D?:MTD D+n:MT D D- n:mtd If the fiscal year starts in January, the current month = 5 (May), EndOfWeekDay = Saturday, and BackdateNumberOfDays = 1: Current Day = Tuesday, May 6 Current Day = Monday, May 19 Current Day = Monday, May 28 the Days used as the time period are: Daily rolling d=5, n=2 May 8-12 May 21-25 May 30-June 3* forecast for d days, starting n days after the current day d=5, n=10 May 16-20 May 29-June 2* June 7-11* Daily rolling d=5, n=2 May 4-8 May 17-21 May 26-30 forecast for d days, starting n days prior to the d=5, n=10 April 26-30* May 9-13 May 18-22 current day Rolling forecast aggregation May 1-6 May 1-19 May 1-28 of daily values from the first day of the month to the current day Rolling forecast n=2 May 1-8 May 1-21 May 1-30 aggregation of daily values from the first day of month m to day d, where d is n n=10 May 1-16 May 1-29 June 1-7* days after the current day, and m is the month containing day d Rolling forecast n=2 May 1-4 May 1-17 May 1-26 aggregation of daily values from the first day of month m to day d, where d is n n=10 April 1-26* May 1-9 May 1-18 days before the current day, and m is the month containing day d 178 BusinessObjects Planning Excel Analyst User Guide
Time Period Tables Daily time periods B Time Period ID Description Example s D:QTD or D?:QTD D+n:QT D D- n:qtd D:YTD or D?:YTD Rolling forecast aggregation of daily values from the first day of the quarter to the current day April 1-May 6* April 1-May 19* April 1-May 28* Rolling forecast n=2 April 1-May 8* April 1-May 21* April 1-May 30* aggregation of daily values from the first day of quarter q to day d, where d is n n=40 April 1-June 15* April 1-June 28* July 1-7* days after the current day, and q is the quarter containing day d Rolling forecast aggregation of daily values from the first day of quarter q to day d, where d is n days before the current day, and q is the quarter containing day d Rolling forecast aggregation of daily values from the first day of the year to the current day If the fiscal year starts in January, the current month = 5 (May), EndOfWeekDay = Saturday, and BackdateNumberOfDays = 1: Current Day = Tuesday, May 6 n=2 April 1-May 4* April 1-May 17* April 1-May 26* n=40 January 1- March 27* January 1-May 6* Current Day = Monday, May 19 the Days used as the time period are: April 1-9* April 1-18* January 1-May 19* Current Day = Monday, May 28 January 1-May 28* BusinessObjects Planning Excel Analyst User Guide 179
Time Period Tables B Daily time periods Time Period ID Description Example s D+n:YT D Rolling forecast aggregation of daily values from the first day of year y to day d, where d is n days after the current day, and y is the year containing day d D-n:YTD Rolling forecast aggregation of daily values from the first day of year y to day d, where d is n days before the current day, and y is the year containing day d If the fiscal year starts in January, the current month = 5 (May), EndOfWeekDay = Saturday, and BackdateNumberOfDays = 1: Current Day = Tuesday, May 6 n=2 January 1-May 8* n=10 January 1-May 16* n=2 January 1-May 4* n=10 January 1-April 26* Current Day = Monday, May 19 the Days used as the time period are: January 1-May 21* January 1-May 29* January 1-May 17* January 1-May 9* Current Day = Monday, May 28 January 1-May 30* January 1-June 7* January 1-May 26* January 1-May 18* These examples assume that your fiscal year starts in January. If your fiscal year starts in a month other than January, you will need to adjust these dates appropriately. Definitions coded with * can only be evaluated if the scenario specified includes the month indicated. n/m = not meaningful (appears as -- in reports). The display format of the Dn time period is controlled by the JulianDailyTimePeriodDisplay setting, located in the [Calendar] section of the Planning.ini file. If JulianDailyTimePeriodDisplay is 0, the day is displayed as a Julian calendar date (such as June 10 ). If JulianDailyTimePeriodDisplay is 1, the day is displayed as a raw numeric value ( Day 100 in rows, and D100 in columns). 180 BusinessObjects Planning Excel Analyst User Guide
Time Period Tables Daily time periods B Time periods that reference the local current day of the scenario Time Period These time periods can only be used if the local current day is defined for the particular scenario/unit combination you are displaying in your report. These time periods are identical to the time periods that specify the global current day of the month, except that an L has been added to the time period identifier to indicate the local current day. ID Description Example s WEEL or WEEL? WEEL+n If the fiscal year starts in January, the current month = 5 (May), EndOfWeekDay = Saturday, and BackdateNumberOfDays = 1: Current Day = Tuesday, May 6 Current Day = Monday, May 19 the Days used as the time period are: Last day of the current week May 3 May 17 May 26 Last day of the week that is n weeks later than the current week n=2 May 17 May 31 June 9 n=3 May 24 June 7 June 16 Current Day = Monday, May 28 WEEL-n WESL or WESL? WESL+n Last day of the n=2 April 19 May 3 May 12 week that is n weeks earlier than the current week n=3 April 12 April 26 May 5 First day of the current week April 27 May 11 May 20 First day of the week that is n weeks later than the current week n=2 May 11 May 25 June 3 n=3 May 18 June 1 June 10 WESL-n First day of the week that is n weeks earlier than the current week n=2 April 13 April 27 May 6 n=3 April 6 April 20 April 29 BusinessObjects Planning Excel Analyst User Guide 181
Time Period Tables B Daily time periods Time Period ID Description Example s DL or DL? Local current day for the scenario If the fiscal year starts in January, the current month = 5 (May), EndOfWeekDay = Saturday, and BackdateNumberOfDays = 1: Current Day = Tuesday, May 6 Current Day = Monday, May 19 the Days used as the time period are: May 6 May 19 May 28 Current Day = Monday, May 28 DL+n n days from now n=2 May 8 May 21 May 30 n=3 May 9 May 22 May 31 DL-n n days ago n=2 May 4 May 17 May 26 n=3 May 3 May 16 May 25 MTDL or Current month-to-date May 1-6 May 1-19 May 1-28 MTDL? aggregate value MTDL+n Aggregate value n=2 May 1-8 May 1-21 May 1-30 from start of month to current day plus n days n=5 May 1-13 May 1-26 n/m MTDL-n MTDML or MTDML? MTDML+ n Aggregate value n=2 May 1-4 May 1-17 May 1-26 from start of month to current day minus n days n=8 n/m May 1-11 May 1-20 Current month-to-date May 1-6 May 1-19 May 1-28 aggregate value Aggregate value from start of month to current day for the month n months later than the current month n=2 July 1-6 July 1-19 July 1-28 n=3 August 1-6 August 1-19 August 1-28 182 BusinessObjects Planning Excel Analyst User Guide
Time Period Tables Daily time periods B Time Period ID Description Example s MTDML-n Aggregate value from start of month to current day for the month n months earlier than the current month WEL or WEL? WEL+n WEL-n DL.d or DL?.d DL+n.d DL-n.d If the fiscal year starts in January, the current month = 5 (May), EndOfWeekDay = Saturday, and BackdateNumberOfDays = 1: Current Day = Tuesday, May 6 Current Day = Monday, May 19 the Days used as the time period are: Current Day = Monday, May 28 n=2 March 1-6 March 1-19 March 1-28 n=3 February 1-6 February 1-19 February 1-28 Rolling forecast total of daily values for the current week April 27-May 3* May 11-17 May 20-26 Rolling forecast n=2 May 11-17 May 25-31 June 3-9* total of daily values for the n=3 May 18-24 June 1-7* June 10-16* week that is n weeks later than the current week Rolling forecast n=2 April 13-19* April 27-May 3* May 6-12 total of daily values for the week that is n n=3 April 6-12* April 20-26* April 29-May 5* weeks earlier than the current week Daily rolling d=5 May 6-10 May 19-23 May 28-June 1* forecast for d days Daily rolling d=5, n=2 May 8-12 May 21-25 May 30-June 3* forecast for d days, starting n d=5, n=10 May 16-20 May 29-June 2* June 7-11* days after the current day Daily rolling d=5, n=2 May 4-8 May 17-21 May 26-30 forecast for d days, starting n d=5, n=10 April 26-30* May 9-13 May 18-22 days prior to the current day BusinessObjects Planning Excel Analyst User Guide 183
Time Period Tables B Daily time periods Time Period ID Description Example s DL:MTD or DL?:MTD DL+n:MT D DLn:MTD DL:QTD or DL?:QTD If the fiscal year starts in January, the current month = 5 (May), EndOfWeekDay = Saturday, and BackdateNumberOfDays = 1: Current Day = Tuesday, May 6 Current Day = Monday, May 19 the Days used as the time period are: Current Day = Monday, May 28 Rolling forecast aggregation of daily values from the first day of the month to the current day May 1-6 May 1-19 May 1-28 Rolling forecast n=2 May 1-8 May 1-21 May 1-30 aggregation of daily values from the first day of month m to day d, where d is n n=10 May 1-16 May 1-29 June 1-7* days after the current day, and m is the month containing day d Rolling forecast n=2 May 1-4 May 1-17 May 1-26 aggregation of daily values from the first day of month m to day d, where d is n n=10 April 1-26* May 1-9 May 1-18 days before the current day, and m is the month containing day d Rolling forecast aggregation April 1-May 6* April 1-May 19* April 1-May 28* of daily values from the first day of the quarter to the current day 184 BusinessObjects Planning Excel Analyst User Guide
Time Period Tables Daily time periods B Time Period ID Description Example s DL+n:QT D DLn:QTD DL:YTD or DL?:YTD Rolling forecast aggregation of daily values from the first day of quarter q to day d, where d is n days after the current day, and q is the quarter containing day d Rolling forecast aggregation of daily values from the first day of quarter q to day d, where d is n days before the current day, and q is the quarter containing day d Rolling forecast aggregation of daily values from the first day of the year to the current day If the fiscal year starts in January, the current month = 5 (May), EndOfWeekDay = Saturday, and BackdateNumberOfDays = 1: Current Day = Tuesday, May 6 n=2 April 1-May 8* April 1-May 21* April 1-May 30* n=40 April 1-June 15* April 1-June 28* July 1-7* n=2 April 1-May 4* April 1-May 17* April 1-May 26* n=40 January 1- March 27* January 1-May 6* Current Day = Monday, May 19 the Days used as the time period are: April 1-9* April 1-18* January 1-May 19* Current Day = Monday, May 28 January 1-May 28* BusinessObjects Planning Excel Analyst User Guide 185
Time Period Tables B Daily time periods Time Period ID Description Example s DL+n:YT D Rolling forecast aggregation of daily values from the first day of year y to day d, where d is n days after the current day, and y is the year containing day d DL-n:YTD Rolling forecast aggregation of daily values from the first day of year y to day d, where d is n days before the current day, and y is the year containing day d If the fiscal year starts in January, the current month = 5 (May), EndOfWeekDay = Saturday, and BackdateNumberOfDays = 1: Current Day = Tuesday, May 6 n=2 January 1-May 8* n=10 January 1-May 16* n=2 January 1-May 4* n=10 January 1-April 26* Current Day = Monday, May 19 the Days used as the time period are: January 1-May 21* January 1-May 29* January 1-May 17* January 1-May 9* Current Day = Monday, May 28 January 1-May 30* January 1-June 7* January 1-May 26* January 1-May 18* These examples assume that your fiscal year starts in January. If your fiscal year starts in a month other than January, you will need to adjust these dates appropriately. Definitions coded with * can only be evaluated if the scenario specified includes the month indicated. n/m = not meaningful (appears as -- in reports). 186 BusinessObjects Planning Excel Analyst User Guide
Time Period Tables Examples B Examples To do this... Using advanced time periods Type this time period Display the results for the next 6 months of 2002: 2002.A.M.6 Display the results for six months of 2002, starting three 2002.A.M-3.6 months ago: Display the results for four quarters, starting two quarters 2002.A.Q+2.4 from the current quarter of 2002: Display the results for the first ten days of the current D-9:MTD month, assuming the current day is Day 19 (the following are equivalent): D-18.10 MTD-9 Display the daily value from ten days ago: D-10 Display the results for the previous full week: WE-1 This section provides details on the following time periods: The WE, WES and WEE daily time periods, which calculate or display the current week, relative to the global current day The WEL, WESL and WEEL daily time periods, which calculate or display the current week, relative to the local current day The MTD and MTDM daily time periods, which calculate or display the month-to-date aggregate value for the current month or a specified month, relative to the global current day The MTDL and MTDML daily time periods, which calculate or display the month-to-date aggregate value for the current month or a specified month, relative to the local current day The D.d daily time periods, which display a rolling forecast for a specified number of days, relative to the global current day The DL.d daily time periods, which display a rolling forecast for a specified number of days, relative to the local current day The D:MTD, D:QTD and D:YTD time periods, which display a rolling forecast from the start of a month, quarter or year to a specified day, relative to the global current day BusinessObjects Planning Excel Analyst User Guide 187
Time Period Tables B Using advanced time periods The DL:MTD, DL:QTD and DL:YTD time periods, which display a rolling forecast from the start of a month, quarter or year to a specified day, relative to the local current day The WE, WES and WEE daily time periods The WE, WES and WEE daily time periods display data for the current week, which is the last complete week prior to the global current day. (See Determining the current week on page 174 for a detailed explanation of how to calculate the current week.) The WE daily time period is a rolling forecast of the daily values for the current week. The WES daily time period displays the value for the first day of the current week, and the WEE daily time period displays the value for the last day of the current week. To provide data on a week before or after the current week, use the + or - modifier. For example, WE+2 specifies a rolling forecast of the daily values for the week that is two weeks after the current week, and WEE-3 displays the value for the last day of the week that is three weeks before the current week. You can use WE with a numeric modifier to display data for a particular week of the year. For example, WE5 displays a rolling forecast of the daily values for the fifth week of the year. You cannot use the numeric modifier with WEE or WES. The WEL, WESL and WEEL daily time periods The WEL, WESL and WEEL daily time periods reference the last complete week prior to the local current day instead of the week prior to the global current day. In all other respects, WEL, WESL and WEEL are identical to WE, WES and WEE, respectively. The MTD and MTDM daily time periods The MTD and MTDM daily time periods calculate or display the month-to-date aggregate value for the current month or a specified month, relative to the global current day. The MTD daily time period The MTD daily time period displays the current month-to-date aggregate value, relative to the global current day. For example, if the global current day is May 6, the MTD daily time period displays the aggregate value of the days from May 1 to May 6. You can use the + or - modifiers to display the aggregate value for any other day in the current month. For example, if the current day is May 6, MTD+5 displays the aggregate value of the days from May 1 to May 11. 188 BusinessObjects Planning Excel Analyst User Guide
Time Period Tables Using advanced time periods B The string "--" is displayed if the + or - modifier is used to reference a day that is not in the current month. For example, if the current day is May 6, MTD-7 displays "--", since -7 refers to a day in April, not May. The MTDM daily time period The MTDM daily time period, when specified with a + or - modifier, displays the month-to-date aggregate value for a month prior to or following the current month. For example, if the current day is May 6, MTDM+2 displays the aggregate value of the days from July 1 to July 6. If MTDM is specified without a + or - modifier, it is identical to MTD. The MTDL and MTDML daily time periods The MTDL and MTDML daily time periods calculate or display the month-todate aggregate value for the current month or a specified month, relative to the local current day, not the global current day. In all other respects, MTDL and MTDML are identical to MTD and MTDM, respectively. The D.d daily time periods The D.d daily time periods (where d is a numeric value) display a rolling forecast for a specified number of days, relative to the global current day. For example, if the global current day is May 6, D.5 provides a rolling forecast for the five days from May 6 to May 10. You can use the + or - modifier to change the starting date of the rolling forecast. For example, if the global current day is May 6, D+3.5 moves the starting date from May 6 to May 9, and provides a rolling forecast for the five days from May 9 to May 13. Similarly, D-2.3 moves the starting date to May 4, and provides a rolling forecast for the three days from May 4 to May 6. The DL.d daily time periods The DL.d daily time periods (where d is a numeric value) display a rolling forecast for a specified number of days, relative to the local current day, not the global current day. In all other respects, DL.d is identical to D.d. The D:MTD, D:QTD and D:YTD daily time periods The D:MTD, D:QTD and D:YTD time periods display a rolling forecast from the start of a month, quarter or year to a specified day, relative to the global current day. These time periods behave similarly; the only difference is whether they provide month-to-date (MTD), quarter-to-date (QTD) or year-todate (YTD) information. The D:MTD daily time periods The D:MTD time periods display a rolling forecast from the start of a month to a specified day. BusinessObjects Planning Excel Analyst User Guide 189
Time Period Tables B Using advanced time periods If D:MTD is specified without a + or - identifier, it displays a rolling forecast from the start of the current month to the global current day. For example, if the global current day is May 6, D:MTD displays a rolling forecast for the days from May 1 to May 6. You can use the + or - identifier to change the specified day. For example, if the global current day is May 6, D+5:MTD changes the specified day from May 6 to May 11, and displays a rolling forecast for the days from May 1 to May 11. Similarly, D-3:MTD changes the specified day to May 3, and displays a rolling forecast for the days from May 1 to May 3. If the + or - identifier moves the specified day to a different month, the rolling forecast displays data for that month. For example, if the global current day is May 6, and the time period is D-8:MTD, the specified day becomes April 28, and the value displayed is the rolling forecast for the days from April 1 to April 28. The D:QTD daily time periods The D:QTD time periods display a rolling forecast from the start of a quarter to a specified day. If D:QTD is specified without a + or - identifier, it displays a rolling forecast from the start of the current quarter to the global current day. For example, if the global current day is May 6, and the current quarter starts on April 1, D:QTD displays a rolling forecast for the days from April 1 to May 6. You can use the + or - identifier to change the specified day. For example, if the global current day is May 6, and the current quarter starts on April 1, D+5:QTD changes the specified day from May 6 to May 11, and displays a rolling forecast for the days from April 1 to May 11. Similarly, D-3:MTD changes the specified day to May 3, and displays a rolling forecast for the days from April 1 to May 3. If the + or - identifier moves the specified day to a different quarter, the rolling forecast displays data for that quarter. For example, if the global current day is April 6, the current quarter starts on April 1, and the time period is D-8:MTD, the specified day becomes March 29, and the value displayed is the rolling forecast for the days from January 1 to March 29. The D:YTD daily time periods The D:YTD time periods display a rolling forecast from the start of a year to a specified day. If D:YTD is specified without a + or - identifier, it displays a rolling forecast from the start of the current year to the global current day. For example, if the global current day is May 6, and the current year starts on January 1, D:YTD displays a rolling forecast for the days from January 1 to May 6. 190 BusinessObjects Planning Excel Analyst User Guide
Time Period Tables Using advanced time periods B You can use the + or - identifier to change the specified day. For example, if the global current day is May 6, and the current year starts on January 1, D+5:YTD changes the specified day from May 6 to May 11, and displays a rolling forecast for the days from January 1 to May 11. Similarly, D-3:YTD changes the specified day to May 3, and displays a rolling forecast for the days from January 1 to May 3. The DL:MTD, DL:QTD and DL:YTD daily time periods The DL:MTD, DL:QTD and DL:YTD time periods display a rolling forecast from the start of a month, quarter or year to a specified day, relative to the local current day, not the global current day. In all other respects, DL:MTD, DL:QTD and DL:YTD are identical to D:MTD, D:QTD and D:YTD, respectively. BusinessObjects Planning Excel Analyst User Guide 191
Time Period Tables B Using advanced time periods 192 BusinessObjects Planning Excel Analyst User Guide
BusinessObjects Planning Excel Analyst Hot Keys appendix
C BusinessObjects Planning Excel Analyst Hot Keys The BusinessObjects Planning Excel Analyst provides some shortcut keys (hot keys) that make certain operations easier. Whenever possible, these keys are compatible with those used in Excel and in other Windows applications. The following table lists these shortcut keys: Key ESC ENTER TAB SHIFT + TAB Up and down arrow keys Left arrow key Right arrow key Letter key (A-Z) Description Exits a dialog box or popup menu without performing any action. Performs the operation that has the current focus. For example, if the current focus is on the Cancel button, pressing ENTER is equivalent to clicking Cancel. To change the current focus, use TAB or SHIFT + TAB. The operation that has the current focus is always clearly outlined or highlighted. Changes the current focus from one element of a dialog box (text box, button) to the next element. OR When you have entered all or part of an identifier in the Dimension Wizard s search text box, TAB searches for the identifier in its dimension hierarchy. Changes the current focus from one element of a dialog box to the previous element. Moves up and down in a list of radio buttons in a dialog box. OR Moves up and down in a list contained in a list box. OR Moves up and down in a dimension hierarchy. Collapses a dimension hierarchy. Expands a dimension hierarchy. Selects an item from a popup menu. To determine the letter key that selects a particular menu item, look for the letter that is underlined. For example, the Open menu has O underlined, so it is activated when you press O. (These selections are case insensitive.) 194 BusinessObjects Planning Excel Analyst User Guide
Index A ad hoc reports adding columns 83 adding rows 76 copying 139 creating 71 deleting dimensions 128 editing data 106 modifying and updating 115 opening 115 refreshing 134, 135 refreshing using Excel macros 136 saving 140 specifying properties 89, 94 uploading data 134, 135 uploading data using Excel macros 136 using functions 108 validating 104 adding columns to ad hoc reports 83 rows to ad hoc reports 76 B balance type defined 19 business models defined 17 deleting dimensions from ad hoc reports 128 specifying for ad hoc reports 74 validating for ad hoc reports 76 viewing dimensions 106 BusinessObjects Planning Analyst copying to 43 BusinessObjects Planning reports drilling down 38, 113 editing 41 launching tasks 40 opening 31 pivoting 40 saving 64 C cell editing identifier in 117 channel defined 19 clearing validation errors 104 using Excel macros 105 column range editing manually 126 editing using Dimension Wizard 123 shrinking 127 columns adding to ad hoc reports 83 consolidating data 43 copying ad hoc reports 139 data 43 creating ad hoc reports 71, 108 CRefresh 136 CUpload 136 currency defined 19 display 20 customer defined 19 D daily time periods 173 data consolidating 43 copying 43 editing 41, 106 refreshing in ad hoc reports 134, 135, 136 BusinessObjects Planning Excel Analyst User Guide 195
Index saving 64 scaling 129 specifying whether to allow uploading 100 uploading for ad hoc reports 134, 135, 136 defining projections 50 prorations 59 derived currency, defined 19 dimension missing time period 36 specifying missing 34 Dimension Wizard editing a column range using 123 editing a row range using 118 specifying report properties using 89 dimensions defined 18 display currency 20 changing 39 drilling down 38, 113 E editing column range manually 126 column range using Dimension Wizard 123 data in ad hoc reports 106 data in BusinessObjectsPlanning reports 41 identifier in cell 117 row range manually 121 row range using Dimension Wizard 118 error messages for worksheet functions 110 errors clearing validation 104, 105 F fiscal period defined 19 functions in ad hoc reports 108, 142 H half yearly time periods 164 I IGETDIMATTR 149 IGETMODATTR 153 IGETRATE 151 IGETSCENATTR 154 IGETVAL 143 inheritance, defined 23 IPUTVAL 145 J JulianDailyTimePeriodDisplay 180 L launching tasks 40 leaf drilling down to 39 line defined 19 local currency (LC), defined 20 Log message workbook 28, 70 writing to 70 logging off of the server 65, 140 logging on to the server 27, 69 M missing dimensions 34 modifying ad hoc reports 115 monthly spot balance time periods 172 time periods 168 O opening ad hoc reports 115 BusinessObjects Planning reports 31 P pivoting BusinessObjects Planning reports 40 product defined 19 project 196 BusinessObjects Planning Excel Analyst User Guide
Index defined 19 projection methods growth series 47 growth trend 46 linear series 47 linear trend 46 moving average 49 naive forecasting 48 running rates 46 seasonal 47 single exponential smoothing 49 projections 45 defining 50 predefined 50 using 50 prorations 54 defining 59 predefined 58 rules 59 using 58 pure currency, defined 19 Q quarterly spot balance time periods 167 time periods 166 R refreshing ad hoc reports 134, 135 ad hoc reports using Excel macros 136 reports copying 139 opening 31 saving 140 specifying areas for 73 updating multi-section 42 row range editing manually 121 editing using Dimension Wizard 118 shrinking 122 rows adding to ad hoc reports 76 S saving ad hoc reports 140 BusinessObjects Planning reports in Excel 64 data 64 scaling data 129 at column level 132 at row level 133 at section level 130 servers logging off 65, 140 logging on 27, 69 shrinking column range 127 row range 122 source currency currency source 20 specifying ad hoc report properties 89, 94 business models for ad hoc reports 74 missing dimensions 34 report areas 73 the display currency 39 time periods 98 whether to allow data to be uploaded 100 spot balance monthly time periods 172 quarterly time periods 167 yearly time periods 164 T tasks, running 40 time periods advanced 187 daily 173 examples 187 half yearly 164 monthly 168 monthly spot balance 172 quarterly 166 quarterly spot balance 167 specifying 98 specifying missing 36 BusinessObjects Planning Excel Analyst User Guide 197
Index yearly 163 yearly spot balance 164 total all currencies (TT), defined 20 transaction defined 19 U unit defined 19 updating ad hoc reports 115 multi-section reports 42 uploading data for ad hoc reports 134, 135, 136 V validating ad hoc reports 104 business models for ad hoc reports 76 validation errors clearing 104 clearing using Excel macros 105 view currency 20 viewing business model dimensions 106 W worksheet functions 108, 142 writing to Log message workbook 70 Y yearly spot balance time periods 164 time periods 163 198 BusinessObjects Planning Excel Analyst User Guide