Doc. Version 1.0 Updated:

Transcription

1 OneStop Reporting Report Designer/Player 3.5 User Guide Doc. Version 1.0 Updated:

2 Table of Contents Introduction... 3 Who should read this manual... 3 What s included in this manual... 3 Symbols and conventions... 3 Installation... 4 Report Designer... 5 Overview... 5 Excel Ribbon... 6 Layout Editor Designer Menu Logging In Creating a Connection to a Database Creating a Report Using Report Designer Report Building Options Modules Data Items Functions Expression Trees Drill-To Definitions Report Parameters Report Parameter Wizard Layout Editor Property Hierarchy Executing a Report Linking Sheets Copy and Pasting Drilldown Drill-To Macros Built-in Excel Security Report Player Excel Ribbon Copyright OneStop Reporting AS Page 1 OSR Report Designer/ Player User Guide

3 Options Button Login tab Report tab Appendix A. Glossary B. Expand Types Copyright OneStop Reporting AS Page 2 OSR Report Designer/ Player User Guide

4 Introduction OneStop Reporting(OSR) Report Designer is the reporting application in the OSR product suite. It is a full-blown Excel-based report writer enabling the user to report directly on top of their ERP database, OSR Data Warehouse, or any other data source where an integration package has been or will be set up. In a few hours, business users with basic Microsoft Excel experience will be able to create presentation-quality financial statements, operational reports, and KPI reports with charts and graphical indicators. The OSR Report Designer provides complete financial and operational report writing based on the familiar Microsoft Excel user interface. As long as an integration (either existing or custom built) exists, users can use Report Designer to report on all of the following data sources: The organizational ERP system (GL, sub-ledgers, and custom tables) Other SQL-based transactional databases SQL-based data warehouses (i.e. OSR Data Warehouse) The OSR Report Player can be viewed as the read-only version of Report Designer. In other words, the user can execute the report with the ability to apply simple modifications to reports. Who should read this manual This manual is designed for OSR administrators and power users who are responsible for designing budget and report templates. What s included in this manual This manual is designed to give an in-depth understanding of how to use the features of the OSR Report Designer/Player. The manual is divided into the following parts: Overview: introduction to the OSR Report Designer/Player. This section will include information on the menu and the toolbars as well as information such as logging in and creating a connection to a database. Building Reports: explains the functions available in OSR Report Designer, including expanding groups, summation, and drill down. Symbols and conventions This manual uses the following symbols to make specific types of information stand out. Symbol Description The sunlight symbol indicates helpful tips, shortcuts, and suggestions. The warning symbol indicates situations we recommend to be aware of when completing tasks. Typically, this includes cautions about completing steps in their proper order or important reminders about how other information in OSR may be affected. Copyright OneStop Reporting AS Page 3 OSR Report Designer/ Player User Guide

5 Installation Please consult the OSR installation guide for details on installing OSR Reporting. The installation guide can be found at Prior to running either OSR Reporting applications, administrators must create a repository and assign access to the users through the OSR Administration Tool application. See the Administration Tool User Guide for more information Copyright OneStop Reporting AS Page 4 OSR Report Designer/ Player User Guide

6 Report Designer Using the Report Designer, users can create highly formatted Excel-based reports that any Designer or Player user can run live from their own desktop. The Report Designer uses the familiar Microsoft Excel user interface and an easy to learn drag-and-drop system to create high quality reports. Moreover, Excel formatting, calculations, and charts can be applied to the reports. With each execution of the report, users can group and filter information based on report parameters, making the reports dynamic. The following sections will explain the interface and report building with Report Designer so that the user will be able to create business intelligence assets for their organization. Overview Prior to designing a report, users should have a good understanding of the Report Designer interface. The following sections cover the three important components of Report Designer (the OneStop Reporting Excel ribbon, Layout Editor window, and the Designer Menu). OneStop Reporting Excel Ribbon Designer Menu Layout Editor Copyright OneStop Reporting AS Page 5 OSR Report Designer/ Player User Guide

7 Excel Ribbon The OneStop Reporting Excel ribbon can be found at the top of the Excel window and provides easy navigation and access to the key functions in Report Designer. Each button is explained in the following table: Excel Ribbon Button Function Creates a new report in a new workbook. Uses the current workbook as the foundation for a new report. Allows users to change user accounts by prompting the login window. Opens the Report Configuration window, which allows the user to configure the source database and company. Generally the Report Configuration is prompted when creating a new report. Allows users to input optional additional information such as the report title and description. Moreover, users can enter the password for protected worksheets. Provides access to report behavior settings, details on the version of Report Designer, and miscellaneous options. More details regarding the Options button will be described below. Opens and closes the Report Designer menu bar on the left side of the screen, where users may find the integrated fields from the database as well as predefined period functions, trees, and more. Opens and closes the Layout Editor window, where users can apply filters, sorting, and grouping for the report. Copyright OneStop Reporting AS Page 6 OSR Report Designer/ Player User Guide

8 Enables and disables layout comments that display the filters, groupings, and functions used on the sheet, row, column, or cell level of the report. Opens and closes the Report Parameter window, where users can manage the properties for the parameters that have been applied to the report definition. Enables and disables automatic creation of parameters. When disabled, report parameters will not be created unless the user explicitly creates one using the Report Parameters window. Options Button More information regarding the three tabs in the Options button is as follows: 1. Designer Tab a. Always open Designer in Run-mode: if the box is checked and a saved report is opened, Designer will always open the Report Designer Menu in the Run tab. b. Insert field title above cell on drop: if the box is checked, when a data field is dragged into Excel sheet, Report Designer will automatically create a title one cell above the data field. The title can be modified or deleted in the cell. c. Show Create new group button in Layout Editor window: if the box is checked, the Layout Editor window will display a new button, which allows the user to manually create a group from the Layout Editor. Copyright OneStop Reporting AS Page 7 OSR Report Designer/ Player User Guide

9 d. Create Group Dialog: The vertical slider has three settings (always, conditionally, and on CTRL). Dependent on the position, Report Designer will always, conditionally, or never prompt the user to create a new group when a data field is dragged into the report definition. If the slider is set to on CTRL, Designer will never prompt the user and the user must manually create a group by holding the CTRL key while dragging the field. e. Integration Dictionary: The dropdown list allows the user to select the integration language. 2. Application Tab Copyright OneStop Reporting AS Page 8 OSR Report Designer/ Player User Guide

10 a. Sign in automatically: if the box is checked, Report Designer will automatically sign-in with the previously logged-on user. b. License: displays the license information. c. About : clicking the button will display a new window with information on the Designer version number, build, and the license. Copyright OneStop Reporting AS Page 9 OSR Report Designer/ Player User Guide

11 3. Misc Tab a. Report query timeout: users can setup the duration of time a report should be allowed to query the database before it times out (the default is 300 seconds). b. Show RQL output & Show SQL output: if this box is checked, a new window will open that displays the query during the report definition. Generally, this option is used for technical analysis or troubleshooting. c. Export definition file on save: if this box is checked, an.osr formatted file will be created in the same file path as the saved file. Layout Editor The Layout Editor allows users to create, edit, and delete business rules. The Layout Editor window can be accessed through the Layout Editor button in the OneStop Reporting Excel ribbon. The Layer Editor window contains several areas: 1. Report Level: selects the entire report so that rules (parameter) can be applied to the entire Excel report. 2. Column/ Row Level: users can select a column or row to create, edit, or delete business rules at the column or row level. 3. Data display settings: users may specify the settings for displaying the data in the report. a. Expanding: if checked, the report will list the details of dimension and create what is known as an expanding group (i.e. list each account rather than grouping the accounts together and displaying a total). Only available at row or column level. b. Display blank records: if checked, the report will display dimensions with blank records in the report (i.e. if unchecked, empty datasets will not be displayed). Only available at row or column level. c. Limit: the value in the text box will be the number of records displayed in the expanding group. The 0 value corresponds to an unlimited number of results. Only available at row or column level. Copyright OneStop Reporting AS Page 10 OSR Report Designer/ Player User Guide

12 4. Business rule settings: Users can specify settings for the business rule in this area. 5. Tabs: The tabs allow users to configure different rules for the selected level For details on business rules, see the Glossary. Designer Menu The Designer Menu contains two tabs. The Design tab generates the modules and dimensions based on the integration of the database that the user is connected to. The other tab is a Run tab that allows the user to select parameters and execute reports. Each tab contains unique interfaces and they are explained below. Copyright OneStop Reporting AS Page 11 OSR Report Designer/ Player User Guide

13 1 2a 3a 2b 3b The Designer Menu contains several areas: 1. Tabs: the user can switch between the Design tab and the Run tab. Dependent on the active tab, certain functions within Designer will be deactivated. 2. Design Tab a. Data items: a generated list of data items in the database. Data items are dragged into the Excel sheet to create a report template. b. Modules: the generated list of modules integrated from the ERP system using the metadata. The modules contain the dimensions and measures that can be used to create a report. In addition, functions, expression trees, and report parameters are included below the list of modules. 3. Run Tab a. Parameters: parameters defined in the report design will be listed. Users have the option to specify a parameter by using the Lookup button. b. Run button: in order to execute the report, the Run button must be used. Users have the option of running the report in Report Designer or it can be published to a regular Excel worksheet by clicking the drop-down arrow. Copyright OneStop Reporting AS Page 12 OSR Report Designer/ Player User Guide

14 Logging In OSR Report Designer utilizes the Access Management configuration created through the OSR Administration Tool to create a secure environment for the organization. Therefore, the user will be prompted for authentication each time OSR Report Designer is opened unless the Sign me in automatically option is activated. Users may login using the OneStop or Windows User Authentication in the login window as shown below. Dependent on the authentication, users will have access to data as described. OneStop Admin: the built-in Administrator has access to all modules and dimensions in the connected database. Windows User: the Windows User will have restricted access as configured in the Access Management in the OSR Administration Tool (see the user guide for the OSR Administration Tool for details on configuration). As mentioned above, users may activate the Sign me in automatically option to automatically sign-in to Report Designer as the previously logged in user. Users may activate this option in one of two ways. 1. The first method is to check the box next to Sign me in automatically in the login window. Copyright OneStop Reporting AS Page 13 OSR Report Designer/ Player User Guide

15 2. The second method is by accessing the Options menu in the OneStop Reporting ribbon, selecting the Application tab, and checking the box next to Sign in automatically The second method can also be used to deactivate the Sign me in automatically option. Users may change login authentication after the initial start-up of Report Designer by selecting the Change Login button in the OneStop Reporting Excel ribbon. Note that if the Auto-login with Windows User option is flagged in the Administration Tool, then all users will be automatically logged-in with their Windows user when opening Report Designer for the first time. However, after the initial access, the Sign me in automatically option specified in Designer will override the Auto-login with Windows User option specified in the Administration Tool. Copyright OneStop Reporting AS Page 14 OSR Report Designer/ Player User Guide

16 The best practice is to never log-in with the built-in Administrator for the purpose of accessing data in a reporting module. Rather, an admin level role should be created in the Administration Tool so that all end-users are using Windows Authentication as their login. This is the safest way to use the login structure because if an admin-level user accidentally clicks on sign-in automatically for Report Designer on a terminal server, the next user will be automatically logged in with their AD user, thus preventing any security breaches. On the other hand, if a user logs in with the built-in Administrator and clicks on sign-in automatically, then the next user will be automatically logged in as the built-in Administrator, thus giving access to all data. Creating a Connection to a Database The connection setup for OSR Report Designer is similar to configuring a connection for other applications from the OSR suite. Each time a new report is created, Report Designer will prompt the user to connect to a database through the Report Configuration window. In addition, users may manually open this window by clicking on the Report Configuration button in the OneStop Reporting Excel ribbon. If a connection to the database has been previously configured, the database will be generated in the drop-down list. However, if a connection has not been configured, follow the steps below: 1. In the Report Configuration window, select Data Connection, then click on the Setup button as shown in the image on the following page. Copyright OneStop Reporting AS Page 15 OSR Report Designer/ Player User Guide

17 2. The user will be prompted with a login window. Only the built-in Administrator may configure connection settings. 3. Click New to add a new connection. Copyright OneStop Reporting AS Page 16 OSR Report Designer/ Player User Guide

18 4. In the new window, enter the information required to create a new connection and click on Test to confirm access to the database. An example is given in the image below. User and Password is only required if an SQL Authentication was created. For Windows Authentication, login information may be left blank. After the new connection is created, click on OK to close the prompted windows. In the Report Configuration window, the newly created connection will be generated in the drop-down list and can be selected for the report. If the database contains multiple companies, the proper company can be selected under the Company tab, as shown in the image on the following page. Copyright OneStop Reporting AS Page 17 OSR Report Designer/ Player User Guide

19 Creating a Report Using Report Designer Report Building Options Through the use of OSR Report Designer, users have several different ways of building a report: 1. Copy an existing report definition and modifying the report 2. Import a report definition from Solver, a partner, or someone outside of the organization 3. Use Report Composer to design the basis for the report and transfer the report to Report Designer 4. Paste an Excel export from another report writer into the Report Designer Excel window (then, add Designer properties to the report) 5. Open an Excel report from another Excel report (i.e. FRx, XL Reporter, SQL Reporting Services, Crystal Reports) and use the New Current option 6. Build a report from scratch in Report Designer and use a pre-defined Excel template (which could contain company logo, header styles, etc.) 7. Build a report from scratch in Report Designer starting with an empty Excel sheet by using the New Blank option Modules Modules can be found in the Designer tab in the Designer Menu area of the screen as shown in the image on the next page. Modules represent the first layer of organization in the database and contain attributes and dimensions, which can be dragged into the report definition. They can be managed in the organization s ERP system or the OSR Data Warehouse. See the section on Designer Menu for more details. Copyright OneStop Reporting AS Page 18 OSR Report Designer/ Player User Guide

20 Data Items Data items can be found in the Designer tab in the Designer Menu area of the screen. Data items are considered to be sub-groups and contain information pertaining to the specific module. While designing a report template, users will drag-and-drop different types of data items into the Excel worksheet. Data items Copyright OneStop Reporting AS Page 19 OSR Report Designer/ Player User Guide

21 The three types of data items are explained below. Dimension Dimensions represent a table in the connected database. If the dimension is expanded by clicking the button to the left of the dimension name, all attributes of the dimension will be displayed. All attributes and the dimension can be used as filters or displayed in the report view. Light Dimension Represents a descriptive field in the transaction table of the connected database. Light dimensions can be used as a filter or displayed in the report view. Measure Represents a value field in the transaction table of the connected database. Measures can be used as a filter or displayed in the report view. It is important to note that the different types of data items will trigger certain features such as grouping or filters. Functions Currently, all functions are period based and allow the designer to control the group s displayed data by period. Functions may be dragged into the report definition or the Layout Editor. Expression Trees Expression trees can be created and managed through the Designer Menu under Expression Trees. Copyright OneStop Reporting AS Page 20 OSR Report Designer/ Player User Guide

22 Manage Trees After accessing the Expression Trees tab, users will be able to see a list of existing trees and the link to Manage Trees. Clinking on the link to Manage Trees will open a new window as shown below. From the Expression Trees window, users will have access to the following options to manage the Expression Trees. Button Function Click to create a brand new expression tree in the Expression Tree Editor. Click to open the Expression Tree Editor and edit the currently selected tree. Click to delete the selected tree. It is recommended to export the tree before deleting because deleted trees will not be recoverable. Click to create a copy of the selected tree. The newly created tree may be modified with the Change function. Click to open a network browser window and import a tree. Valid files are other OSR Expression Trees with the *.xml format. Click to open a network browser window and export a tree to the location. The newly exported tree will be in the *.xml format. Copyright OneStop Reporting AS Page 21 OSR Report Designer/ Player User Guide

23 Expression Tree Editor The Expression Tree Editor may be accessed when creating a new expression tree or modifying an existing tree. From the Expression Tree Editor, the user is able to create new nodes and branches and has the ability to modify their properties. The following table explains the options available in the Expression Tree Editor. Button Function Allows users to enter a name for the expression tree. An optional field that allows users to enter additional information regarding the expression tree. Adds a new node or branch to the expression tree. Deletes the highlighted node or branch. Moves the highlighted branch up one level on the expression tree. Moves the highlighted branch down one level on the expression tree. After right-clicking on a node or branch, the user will have the option to rename the node or branch. Copyright OneStop Reporting AS Page 22 OSR Report Designer/ Player User Guide

24 After right-clicking on a node or branch, the user may display the combined filters in a new window. Node/Branch Properties From the Expression Tree Editor, users will be able to configure the property for each node or branch on the right side of the window. Each property and their functions will be explained in detail in the following paragraphs. Common Code: Filled out with the name entered on the node/branch in the tree. The Code property is an important property the report uses to create the link to the node. It is recommended not to change the Code property manually. Instead, users should rename the node or branch using the Rename function in the tree view. In addition, users should avoid using the same name for different nodes or branches. Description: An optional field that allows users to enter additional information regarding the node or branch. Filter: Users may define the selection to be included in the report. This is similar to configuring a filter in the Layout Editor Window. For more details, refer to the Filters section. The Filter field is only active when the Expand Type is set to None, Group, or Expanding Group. Copyright OneStop Reporting AS Page 23 OSR Report Designer/ Player User Guide

25 Composer Reverse Sign: only applies when the tree is used in OSR Report Composer. Setting this option to true will reverse the sign (+ or -) for the ad-hoc report. This option is available because GL accounts are posted with opposite signs (negative for revenue and positive for expenses). For the OSR Report Designer, signs may be reversed by manually entering a formula, such as (=OSRGet( Amount )*-1), into the report definition. Designer Expand Type: Users are able to select the expand type from the drop-down menu. This is one of the most important properties of nodes and branches and will dictate exactly how rows are grouped and expanded in the report definition and the generated report. Below shows a summary matrix of the each expand type available for the user. For more details of each Expand Type and their functionality, refer to Appendix B. Expand Type Functionality Node None Text Group Expanding Group Row Group created Expanding Flag checked Filter capability (aggregate Automatic Update If Add/delete BRANCHES? accounts) (aggregate accounts) (list accounts) If Add/delete FILTERS? n/a n/a Display Branch displays in Tree Design Branch displays in Report Design (when tree dragged out) Branch displays in finished report (when report is run) (only displays accounts from children) (one aggregate row of filtered accounts (placeholder description or result of associated formula) (one aggregate row of filtered accounts) (list with each account in filter on its own row) Expanding Field: This field is only active if the Expand Type is set to Expanding Group. Users can specify which dimension or attribute the expansion will group on and be displayed in the report definition and generated report. o The process to choose the dimension or attribute is similar to using the Designer Menu. Simply select the desired module and browse for the dimension or attribute. Copyright OneStop Reporting AS Page 24 OSR Report Designer/ Player User Guide

26 If the Expand Type is set to Node, then the Expanding Field will automatically be filled as Node Name and may not be changed by the user. Style: Configures the row with the selected Excel formatting style. Customized styles can be created by the user in Excel and used here as well. Below displays the pre-set styles offered in Excel. Styles 20% - Accent % - Accent Currency [0] $ 1,000 20% - Accent % - Accent Explanatory Text % - Accent % - Accent Good % - Accent Accent Heading % - Accent Accent Heading % - Accent Accent Heading % - Accent Accent Heading % - Accent Accent Input % - Accent Accent Linked Cell % - Accent Bad 1000 Neutral % - Accent Calculation 1000 Normal % - Accent Check Cell 1000 Note % - Accent Comma 1, Output % - Accent Comma [0] 1,000 Percent % 60% - Accent Currency 1, $ Title 1000 Total 1000 Warning Text 1000 Drill-To Definitions Drill-To Definitions created in the report definition will be populated in the Drill-To Definitions pane. Furthermore, Drill-To definitions created in the Layout Editor can be reused throughout various Copyright OneStop Reporting AS Page 25 OSR Report Designer/ Player User Guide

27 sections of the report design by drag-and-dropping the populated Drill-To Definitions into the Drill-To tab of the Layout Editor. In the Drill-To Definitions pane, users can Edit and Delete definitions by highlighting the desired definition and clicking on the appropriate option presented near the bottom of the pane. New Drill-To Definitions must be created from the Layout Editor. More details on how to use the Drill-To feature to drilldown from one module to another will be explained later in this document. Report Parameters The parameters created in the report are generated in the Report Parameters pane. These parameters can be dragged into the report definition so that the reader can identify which parameters were used to generate the report. It is important to note that the Report Parameters pane is different than the Report Parameters Window which can be accessed through the OneStop Reporting ribbon. Copyright OneStop Reporting AS Page 26 OSR Report Designer/ Player User Guide

28 Report Parameter Wizard Report parameters allow designers to create a dynamic report so that the same report template can be used for multiple reports with minimal adjustments. For instance, a departmental budget report can be created for multiple departments by changing the Department parameter at the time of execution. Parameters can be managed through two methods. 1. The first is to access the Report Parameters button in the OneStop Reporting Excel ribbon. The new window will allow users to create, modify, and delete parameters. To create a parameter, drag a data item from the Designer Menu into the Report Parameter Window. In order to modify or delete a parameter, click on and respectively. Moreover, parameters can be reordered by using the arrow buttons, which in turn affects the display order of parameters in Run tab. Whether users are creating or modifying a parameter, they will access the Report Parameter Wizard. The wizard is composed of three pages and they are explained below. i. On the first page, users can specify the name of the parameter and the text prompted in the Run tab. Copyright OneStop Reporting AS Page 27 OSR Report Designer/ Player User Guide

29 The parameter name cannot be changed after the initial creation of the parameter. ii. The next page allows users to select the parameter prompt style. By default, Lookup Edit is selected, but can be modified to fit the need of the report. Copyright OneStop Reporting AS Page 28 OSR Report Designer/ Player User Guide

30 iii. On the last page of the Wizard, users can modify several options. The image of the page is shown in the following page. a. Default value(s): The values entered into the text box or those selected through the Lookup button will automatically be inserted for the parameter when the Run tab is accessed. However, the value can be changed at run time. b. Lookup Filter: power-users can manage the data users are able to view in the Lookup Window for the particular parameter. For instance, this feature may be useful when reports are supposed to be run only for the last two periods. Keep in mind that this feature does not override restrictions set in Access Management. If a value is excluded in Access Management, then it will never be displayed in the Lookup Window for the particular user. c. Hidden: enabling this feature will hide the parameter in the Run tab. This feature is useful when the parameter is required for testing, but in actual deployment, the parameter will always be the same value. If the Hidden feature is enabled, users are required to choose a default value. d. Allow empty (=All): if the box is checked, then the report may be executed even if this parameter is left empty. If the parameter is left empty, then the report will contain all values in the parameter. Copyright OneStop Reporting AS Page 29 OSR Report Designer/ Player User Guide

31 e. Allow multi-selection: if the box is checked, then multiple values can be selected in the parameter prompt (i.e. multiple accounts vs. one account) f. Create sheet per value: if this box is checked, Designer will create a new Excel sheet in the same workbook for the unique values chosen for the parameter (i.e. selection of multiple departments will result in a sheet for each selected department). This feature cannot be used with OSR Planning templates. Otherwise, the template will not work properly. g. Sheet name field: if the Create sheet per value is active, then users can specify the name for the new sheets by using the Lookup icon. 2. The second method for managing parameters is through the Layout Editor. When filters are created at the sheet, column, or row level, users can specify parameters by using the Lookup button and accessing the Parameters tab. Users may create a parameter by assigning a parameter to the filter or selecting Create a new Parameter which will open the Report Parameter Wizard. Copyright OneStop Reporting AS Page 30 OSR Report Designer/ Player User Guide

32 Existing parameters can be found by selecting the Report Parameters button in the Excel ribbon or by selecting the Report Parameters module in the Designer Menu. Layout Editor The Layout Editor is primarily used to manage filters, grouping/sorting, and functions for cell, row, column, and sheet level business rules. Moreover, the Layout Editor can be accessed by clicking the Layout Editor button in the OneStop Reporting Excel ribbon. The various functions in the Layout Editor are explained in the following sections. Filters Filters maybe applied to groups created at the sheet, row, column, or cell level. In order to create filters, the user may drag-and-drop an item from the Designer Menu into the area in the Layout Editor, which states Drag fields into area below to create filters. An example is shown in the image on the next page. Copyright OneStop Reporting AS Page 31 OSR Report Designer/ Player User Guide

33 Creating and managing filters is a key feature in designing a report definition. The following sections will cover the basics of configuring filters. Existing filters can be accessed by clicking on the boxes on the respective row or column as shown in the image below. Moreover, filters can be modified or deleted from the Layout Editor window. Operators Operators are one way that designers can create a customized filter for their need. Similar to operators in mathematics or programming languages, the operators dictate an action or procedure taken by Report Designer. Copyright OneStop Reporting AS Page 32 OSR Report Designer/ Player User Guide

34 In the first drop-down box, two options are available: Blank: this selection will include all data inside the specified filter. Not: this selection will include all data outside the specified filter. If there are additional filters in the same group, the following options are available in the first dropdown box: And: will filter the first condition AND the second condition. Or: will filter the first condition OR the second condition. And Not: will filter the first condition AND NOT the second condition. Or Not: will filter the first condition OR NOT the second condition. The filter operators contained in the second drop-down box are explained below: In: dimension is In (the selected parameters) <>: dimension is Not equal to <: dimension is Less than (for numerical values) >: dimension is Greater than (for numerical values) <=: dimension is Less than or equal to (for numerical values) >=: dimension is Greater than or equal to (for numerical values) Begins with: dimension Begins with (for any phrase contained in the dimension) Ends with: dimension Ends with (for any phrase contained in the dimension) Contains: dimension Contains (any part of the phrase contained in the dimension) Like: Report Designer will retrieve any data using LIKE in SQL. For more information on the LIKE operator, consult a SQL server guide. The Like operator is for advanced users and requires knowledge of SQL Copyright OneStop Reporting AS Page 33 OSR Report Designer/ Player User Guide

35 Dimension Lookup Filters can further be configured by using the Dimension Lookup function. The attributes available to filter for the specific dimension will be generated when the designer clicks on the Dimension Lookup button ( ). From the Dimension Lookup window, the user may specify the dimension to remain static or dynamic dependent on the report need. To create a static filter, select the List Tab in the Lookup window. Select the desired account, department, entity, etc. and click OK. o Use ranges: If this box is checked and multiple data are selected, the selected data will be displayed as a range at the bottom text box. If this box is not checked, all selected data will be displayed individually at the bottom text box. Copyright OneStop Reporting AS Page 34 OSR Report Designer/ Player User Guide

36 o Include empty: If this box is checked, the filter will include data associated with the NULL data set. To create a dynamic filter, select the Parameter Tab in the Lookup window. Refer to the Parameter section on how to setup a parameter. In order to manually create a parameter, designers can type {@Dimension_Name} For Period dimensions, users canspecify the value current period +/- for single period parameters. This allows the OSR Report Designer to select the correct period based on the computer date; therefore, report parameters do not need to be updated manually prior to running a scheduled report. Grouping/Sorting Grouping and sorting can be accessed by clicking the Grouping/Sorting Tab near the bottom of the Layout Editor window. Note: The Grouping/Sorting tab is unavailable if the report level is selected. In addition, grouping will not occur if the Expanding box is unchecked. Icons available in the Grouping/Sorting tab are explained in the following table: Icon Function Increase or decrease the precedence of the data item in the sorting order. The drop-down menu allows users to select the display option of the row, column, or cell. Options available are None, Group, Sum, Min, Max, and Count. Copyright OneStop Reporting AS Page 35 OSR Report Designer/ Player User Guide

37 If this icon is displayed, the sorting will be in ascending order for the group. Click on this icon to cycle through sorting options. If this icon is displayed, the sorting will not exist for the group. Click on this icon to cycle through sorting options. If this icon is displayed, the sorting will be in descending order for the group. Click on this icon to cycle through sorting options. Delete the data item from the Grouping/Sorting tab. Grouping Designer will automatically populate data items at the row or column level if a dimension or light dimension has been dragged into a cell and a group already exists at the row or column level. An example is depicted in the image on the following page. In essence, grouping the account dimension displays results at the account level even if there are detailed sub-accounts. If the account data field was not grouped, then the report will display all subaccounts at the time of execution. For more details on grouping, see the Expanding Group section. Sorting At the column and row level, dimensions can be reordered to create a hierarchy of sorting by clicking the Arrow buttons next the dimension name. For instance in the settings from image displayed above, the generated report will be presented in numerical order of account number (left image below). Copyright OneStop Reporting AS Page 36 OSR Report Designer/ Player User Guide

38 However, if the Description dimension is moved to take precedence over Account, then the generated report will be presented in alphabetical order of the account description (right image below). In addition, Designer will automatically populate data items in the Layout Editor at the cell level if a measure has been dragged into a cell and a group already exists at the row or column level. The same options are available for cell level grouping and sorting. An example is depicted in the image below. Functions Functions can be accessed by clicking on the Functions button at the bottom of the Layout Editor window. The Functions tab generates a list of functions applied to the selected column or row. In order to insert functions, which are found under Functions in the Designer Menu, users have two options. The first is to drag-and-drop the function into a cell of a report. Dragging a function into a report will automatically create a function for the column. The other method is to drag-and-drop the function into the Layout Editor window under the Functions tab. Both methods are shown in the following images. Method 1: Copyright OneStop Reporting AS Page 37 OSR Report Designer/ Player User Guide

39 Method 2: Currently, all functions are period based and allow the user to control the group s displayed data by period. Copyright OneStop Reporting AS Page 38 OSR Report Designer/ Player User Guide

40 Expanding Groups Expanding groups are an essential part of OSR Report Designer and will be explained in more detail in this section. As explained in a previous section, checking the Expanding box in the Layout Editor window will create expanding groups in the specified row or column for data items that have been set to Group in the Grouping/Sorting tab. The quickest way of creating an expanding group is by dragging a data item, such as Sales Person into the report definition and selecting Create a new selection group on the Row or Create a new selection group on the Column. By default, Report Designer will create an expanding group and can be seen in the Grouping/Sorting tab in the Layout Editor window. This process is depicted in the image in the following page. If the row/column is an expanding group, it will be indicated by a small green plus sign in the box ( ) of the respective row or column. Copyright OneStop Reporting AS Page 39 OSR Report Designer/ Player User Guide

41 When the report is generated and an expanding group is not created, the report will result in consolidation of all data in the account (shown in the first set of images). On the other hand, if an expanding group is created, the details of the account will be given (shown in the second set of images on the next page). Expanding Groups in expanding groups In order to create more flexible reporting, expanding groups can be created inside other expanding groups. The concept behind expanding groups nested inside expanding groups is explained in this section. An expanding group inside another expanding group can be thought of as a hierarchy. Imagine there are two data sets, one alphabetical and the other numerical (A, B, C & 1, 2, 3 ), and one is an attribute of the other. In order to create a nested expanding group, follow the steps below. 1. Drag-and-drop the data items into the report definition and when prompted, click on Create a new selection group on the Row. a. The two data items must be placed on consecutive rows. Copyright OneStop Reporting AS Page 40 OSR Report Designer/ Player User Guide

42 2. By default, Report Designer has created two separate expanding groups. However, in order to create a nested expanding group, go to the Layout Editor window and drag the expanding group box so that it extends over multiple rows. The reports for separate expanding groups (left) and a nested expanding group (right) are shown below. Property Hierarchy Before designing a report with Designer, it is important to understand how Designer applies dimensions so that reports can be created efficiently. Essentially, Designer asserts more control over the workbook than traditional Excel add-ins, which only applies business rules at the cell level. Designer allows users to insert business rules at four levels: Report Level: applies to the entire report Copyright OneStop Reporting AS Page 41 OSR Report Designer/ Player User Guide

43 Column Level: applies to all cells in the applicable column Row Level: applies to all cells on the applicable row Cell Level: applies only to the applicable cell A very typical example would be a financial statement with the following location for business rules: Period and department/company parameters (filters): report level Account selections: row level Period selections (Current Period, Year-to-Date, etc.): column level Sum and variance formulas: cell level Business rules can be seen in the Layout Editor window by clicking on the boxes displayed for the sheet level and the row or column level as depicted in the following page. To see the cell level business rule, users simply need to click on the particular cell in the Excel worksheet. Executing a Report After a report definition is completed, it can be run dynamically in two different ways; through the use of Report Designer or Report Player. In addition, the report can be published statically for individuals without a Designer or Player license. If the Run tab is selected in Report Designer, then users will be unable to save the document. OSR Reports may only be saved while in the Design tab. Dynamic Reporting 1. From Report Designer, the report definition can be run under the Run tab in the Designer Menu as shown in the image below. Copyright OneStop Reporting AS Page 42 OSR Report Designer/ Player User Guide

44 Depending on the report definition, there may be multiple parameters. For each parameter, the viewer can use the Lookup button to select the desired parameter. (See the Parameters section for more details) 3. After the parameters are chosen, the report can be executed by clicking the Run button. Static Reporting Static reports are normal Excel reports that can be ed to non-licensed users. The user follows the same steps as dynamic reporting, except on the last step, they must click on the drop-down arrow in the Run button and select Publish. After clicking the Publish button, the Designer Menu will disappear and the static report may now be saved as a regular Excel file and shared with non-licensed users. Copyright OneStop Reporting AS Page 43 OSR Report Designer/ Player User Guide

45 If the connection to the database is stopped or disconnected at any point, the report will not be generated correctly. This will occur even if the connection is reestablished. Linking Sheets Linking sheets in Report Designer cannot be done in the same manner as a regular workbook. Rather, formulas are required because of the complexities of expanding groups and references between worksheets. This section will explain the steps of setting up a simple linked sheet. The concept can be applied to design more complex reports. In this example, two identical sheets will be created, but the second sheet will reference cells from the first sheet. 1. First, create a simple report by accessing the General Ledger folder and inserting department, account, description (under the account dimension), and amount into cells B8 through E8. In addition, insert Period into cell E6 and the Year to date function from the Functions module into cell E3. The report should look like the image shown below. o Make certain that a group is created on row 8 and column E. Copyright OneStop Reporting AS Page 44 OSR Report Designer/ Player User Guide

46 2. Create a copy of the worksheet by right-clicking on the sheet tab, then selecting OneStop Reporting->Copy. Next, right-click on a new sheet tab, then select OneStop Reporting->Paste. 3. Now, reference names must be created on the first sheet. Access the first sheet (Sheet 1) and highlight cells E6 and F6. In the name box, rename this set of cells as Period2. Copyright OneStop Reporting AS Page 45 OSR Report Designer/ Player User Guide

47 The reason for selecting an extra cell to the right is because the group in column E contains an expanding group. The same would apply if an expanding group existed in the row group. However, for an expanding group on a row, the extra cell would be highlighted one cell below. 4. Next, access the copied version of the report in Sheet1(1). Erase the contents of cell E6 and link the period from the original sheet by inserting the formula =INDIRECT( Sheet1!Period2 ). 5. The report may now be executed and the sheets will look identical because the Period dimension in the second sheet is referencing the Period dimension in the original sheet. Copy and Pasting In a report definition created through Report Designer, copy and pasting can be different than using a regular workbook in MS Excel. This traces back to the fact that business rules are applied not only at the cell level, but also the report, row, and column level. This section will explain the rules of copy and pasting for various business rule levels. Cell level: the copy and paste rules in Report Designer are the same as a regular workbook. By default, formulas and groupings are preserved. Copyright OneStop Reporting AS Page 46 OSR Report Designer/ Player User Guide

48 Row/Column level: the copy and paste rules in Report Designer are the same as a regular workbook when working in a single worksheet. By default formulas and groupings are preserved. However, if rows/columns are pasted into a different tab than the original source, groupings will not be preserved. Report level: the copy and paste rules in Report Designer for an entire new tab requires designers to use a special copy button. By using this button, all formulas, groupings, and parameters will be preserved. i. The button can be found by right-clicking the desired tab to copy, then selecting OneStop Reporting->Copy. ii. Next, right click on a blank tab, then select OneStop Reporting ->Paste. Pasting the tab will overwrite all information on the tab that was selected when taking the second step. It is very important to create a blank worksheet so that no data will be lost. Drilldown The simple Drilldown option allows users to see the underlying detail of the value presented in the report. To enable this feature, users can select a measure field in the report definition, click on the Drill-To tab in the Layout Editor, and select the Use Default Drilldown feature. Copyright OneStop Reporting AS Page 47 OSR Report Designer/ Player User Guide

49 To drill-down on any number to see the underlying journal entry level detail from the same module, simply right-click on any number in the executed report. In the pop-up menu, choose OneStop Reporting and then Drilldown. The result of the drill-down will appear on a new tab in Excel called #DrillDown and each resulting column will automatically be given filters. Drill-To The Drill-To is an advanced Drilldown feature that will allow users to drilldown across multiple modules. Thus, users can begin with a report showing values from the General Ledger, but can see the underlying values from the Accounts Receivable sub-ledger. Copyright OneStop Reporting AS Page 48 OSR Report Designer/ Player User Guide

50 In order to use the Drill-To feature, users must configure the Drill-To Definition in the report template. Drill-To Definitions must be created on the cell level selecting a cell that will be the common dimension between the two different modules. For instance, the shared dimension could be the Account number or the Voucher number. When the Drill-To feature is used, Report Designer will use the specified dimension to retrieve entries from the sub-ledger. Below are descriptions of the interfaces involved in configuring the Drill-To feature. Button Drill-To tab Create Drill-To item Function This tab is only available when the user has selected a cell. This create button will create a new Drill-To definition and open the Drill-To Builder. A list of Drill-To definitions applied to the specific cell is populated. Users may edit or delete the definition by clicking on the appropriate buttons. Users will configure the Drill-To Definition through the Drill-To Builder. Configuration is required so that the Report Designer is able to filter through to the proper sub-ledger using parameters or drill source dimensions. Copyright OneStop Reporting AS Page 49 OSR Report Designer/ Player User Guide

51 Interface Name Name Module list Drill-To details Drill-To filters Function Users are able to create a descriptive name so they are able to easily identify the Drill-To Definition. The selection of Modules is populated in this section. From the Modules, users are able to drag-and-drop dimensions into the Drill-To details and filters section to configure the Drill-To Definition. Data items can be drag-and-dropped into this section to create column headers in the resulting Drill-To worksheet. The column headers can be reordered by dragging the header title. Moreover, the data item can be removed by clicking on the header title once. Data items can be drag-and-dropped into the filters section so that the Drill- To Definition can be configured to filter to the correct detailed transactions. When using the Lookup button in the Drill-To filters, users will have the following options: Copyright OneStop Reporting AS Page 50 OSR Report Designer/ Player User Guide

52 Tab List Parameter Drill-To Description A filter based on a constant value can be selected in this tab. A filter based on a parameter from the report definition can be selected in this tab. A filter based on the attribute context of the Drill-To originating cell can be selected in this tab. Available fields on this tab is based on the dimensions and attributes that are used on the particular row or column in the report definition. How to configure a simple Drill-To Definition In this section, a simple Drill-To Definition will be created that allow users to run a simple P&L statement using the OSR Data Warehouse integration and drill to the HR sub-ledger. In the HR subledger, there are details of the employee salaries. However, in the simple P&L statement, only a summary value exists. Begin with a simple P&L statement as shown in the image below. The Drill-To Definition will be created on cell E12 and will be configured to drill to the HR sub-ledger. Copyright OneStop Reporting AS Page 51 OSR Report Designer/ Player User Guide

53 To create the P&L statement above, refer to the OSR Planning User Guide and follow the Exercise section. Now, the Drill-To Definition will be configured. 1. The Drill-To configuration can be accessed in the Layout Editor. Click on the cell that corresponds to the Amount field for the Expenses section and access the Drill-To tab. 2. Create a new definition by clicking on the Create button. 3. The Drill-To Builder window is prompted. In the Name section, enter GL to HR Drill. 4. In the Module List, open the Payroll sub-ledger. From the Payroll sub-ledger, drag-and-drop dimensions into the Drill-To details area that the user wants to display in the Drill-To report. An example is shown in the image below. Note that this is very similar to creating column headers in Report Composer. Copyright OneStop Reporting AS Page 52 OSR Report Designer/ Player User Guide

54 5. Next, configure the filters used to Drill-To the values in the sub-ledger. These filters are crucial to setting up the correct Drill-To Definition. Dimensions used in the original report template can be used so that data from unrelated dimension codes can be filtered out. For this particular example, the Account and Period filters reference the drill source account and periods. This means that Report Designer will reference the dimension code found in the particular row or column when the Drill-To feature is used. The Category dimension uses a static filter, whereas the Department, Entity, and Scenario filters are using the parameters from the report definition. The Drill-To Definition has now been configured and the report is ready to be run. The images below show the generated report and the Drill-To sheet. Drill-To cell E15 by right-clicking the cell and selecting the Drill-To feature from the OneStop Reporting option. Copyright OneStop Reporting AS Page 53 OSR Report Designer/ Player User Guide

55 The Drill-To result will create a new tab and will populate values based on the Drill-To details and filters that were configured in the above steps. Macros Excel allows users to program custom Macros through the user of VBA (Visual Basic for Applications). Report Designer allows users to configure a report definition so that a Macro will be called after the report is generated. In order to set a macro to run automatically, follow these simple steps: 1. Press Alt+F11 to open the VBA window. 2. Double-click on This Workbook to open the coding window. 3. Create a macro in VBA under This Workbook. Copyright OneStop Reporting AS Page 54 OSR Report Designer/ Player User Guide

56 4. Name the macro OSR_ReportComplete(). 5. Generate the report and the macro will be triggered automatically. See the image below for specific details. Built-in Excel Security Excel has two different built-in security features. The first is security on the Excel file level. Users may protect the entire file by requiring a password to open and modify the workbook. This type of security does not interact with OSR Report Designer and purely restricts who can access the report definition. For more information on security on the file level, refer to the appropriate Microsoft Excel documentation. The second type of built-in security for Excel is the protect worksheet or protect workbook feature. By using either of these features, users can lock the worksheet cells so that users may not modify the contents of locked cells unless the worksheet or workbook is unprotected. If this feature is used, there is a direct interaction with Report Designer reading the protected report definition. Therefore, report designers MUST provide the password used to lock the worksheet/workbook in the Report Properties -> Protection tab (see image below). Otherwise, the report will not be generated and an error message will be shown. Copyright OneStop Reporting AS Page 55 OSR Report Designer/ Player User Guide

57 Formatting data with leading zeros in Excel If data generated in the report contains leading zeros (i.e. Department numbered 000), Excel will only display a single 0. However, users can properly display this by simply adding parenthesis before and after the OSR function in the formula bar. Copyright OneStop Reporting AS Page 56 OSR Report Designer/ Player User Guide

58 Copyright OneStop Reporting AS Page 57 OSR Report Designer/ Player User Guide

59 Report Player As previously mentioned, OSR Report Player is the read-only version of the Report Designer. Users with access to Report Player will be able to run reports and specify parameters similar to the features in the Run tab in Report Designer. However, Report Player has a unique interface and functions only available in Player. The Report Player contains an OneStop Reporting Excel ribbon, the Login tab, and the Report tab. The following sections will explain each feature in OSR Report Player. Excel Ribbon Report Player features an OneStop Reporting Excel ribbon similar to Report Designer. However, functionality is limited to three buttons for Report Player and they are explained in the table below. Button Function Opens the Report Configuration window, which allows the user to configure the source database and company. Generally the Report Configuration is prompted when creating a new report. Provides access to report behavior settings, details on the version of Report Player, and miscellaneous options. More details regarding the options button will be described below. Opens and closes the Report Player menu bar on the right side of the screen, where users may find the Login and Report tab. Options Button More information regarding the three tabs in the Options button is as follows: 1. Player Tab Copyright OneStop Reporting AS Page 58 OSR Report Designer/ Player User Guide

60 a. Integration Dictionary: The dropdown list allows the user to select the integration language. 2. Application Tab a. Sign in automatically: If the box is checked, Report Player will automatically sign-in with the previously logged-on user. b. License: Displays the license information. c. About : Clicking the button will display a new window with information on the Player version number, build, and the license. 3. Misc Tab Copyright OneStop Reporting AS Page 59 OSR Report Designer/ Player User Guide

61 a. Report query timeout: Users can setup the duration of time a report should be allowed to query the database before it times out (the default is 300 seconds). b. Show RQL output & Show SQL output: If this box is checked, a new window will open, which displays the code that is executed during the report definition. Generally, this option is used for technical analysis or troubleshooting. Login tab When OSR Report Player is opened, the application will prompt the user for authentication. As opposed to the Report Designer interface, users are prompted through the Login tab on the right side of the Excel window. The Login tab features three options: 1. Use Windows Authentication: by default, Player uses OneStop Reporting authentication. However, Windows User authentication can be used by checking the box next to Use Copyright OneStop Reporting AS Page 60 OSR Report Designer/ Player User Guide

62 Windows Authentication. If this option is used, the username and password fields will be completed automatically. 2. Remember my credentials: if this box is checked, Report Player will automatically insert the username of the previously logged-in user. 3. Sign me in automatically: if this box is checked, the previous user will be logged in automatically at the start of the application. Configuration of this feature is also available under the Application tab in the Options menu. Report tab After entering the proper credentials, the user can access the Report tab The Report tab has three functions as shown in the image above. Each function will be described in the following sections. 1. Parameters: The parameters are presented in the Report tab so that the user can execute dynamic reports. a. Depending on the report definition, there may be multiple parameters. For each parameter, the user can use the Lookup button to select the desired parameter. b. After the parameters are chosen, the report can be executed by clicking the Run/Publish button. Copyright OneStop Reporting AS Page 61 OSR Report Designer/ Player User Guide

63 2. Run/Publish: Pressing this button will execute the report in dynamic or static reporting mode dependent on the user s preference. Modes can be switched by pressing the Drop-down arrow on the button. a. In order to run a dynamic report, execute the report in Run mode. b. In order to run a static report, execute the report in Publish mode. Dynamic reports are only accessible for OSR Report Designer and Player users. Static reports are normal Excel reports that can be shared with non-licensed users. 3. Options: The options button in the Report tab allows users to gain access to more features of Report Player. a. Configure Report: this selection is the same as the Report Configuration button in the OneStop Reporting Excel ribbon. b. Refresh Parameters: this selection resets all parameters in the parameter selection of the Report tab. c. Restore Report Template: this selection resets the report to the report definition even if the report had been generated. d. Persist Report Template : this selection allows the user to save the format, layout, and formulas to be used the next time the report is run. e. Screenshot: this selection saves the specified screenshot to the local hard drive. Screenshots can be the entire Excel window, the used range, or the selected cell. Copyright OneStop Reporting AS Page 62 OSR Report Designer/ Player User Guide

64 Appendix A. Glossary Active Directory: A special-purpose database designed to handle a large number of read and search operations and a significantly smaller number of changes and updates. Most often, it stores user data and system configuration data. Ad-hoc reporting: Ad-hoc reporting is created through the Composer application. As opposed to template based reporting, Ad-hoc reporting means that the report is created specifically for one purpose. Application: An application refers to a product within OSR suite. This term is used because some of the products are stand-alone programs (Data Warehouse, Report Composer, Publisher, Administrative Tool), whereas others are add-ins to already-existing programs (Solver InfoManager, Report Designer, Player). built-in Administrator: The built-in Administrator is automatically installed. The initial password is established automatically, but administrators should change the password through the Administration Tool as soon as possible to ensure security. Business rules: Any filter, grouping, or functions applied at the report, row, column, or cell level. OSR Reporting allows users to apply business rules at four different levels. Data item: Data item refers to any item that can be dragged from the Designer Menu into the report definition. This includes dimensions, light dimensions, and measures. Design mode: When a user selects the Design tab in Designer, the user is in the design mode of the Report Designer application. Dynamic reporting: Dynamic reports are created when Designer or Player users run multiple reports with different parameters from the same report definition. ERP Database: Also known as enterprise resource planning, the ERP database contains information for across the entire organization. MS Dynamics AX, GP, NAV, and SL are all considered to be ERP software. Integration Packages: Integration packages include the logic to integrate to the ERP system and are required for communication between the SQL server and OSR applications. Module: A component of the database, which is organized by financial modeling such as General Ledger, Accounts Payable, Accounts Receivable, etc. Users can define modules via Data Warehouse. Report Definition: The report definition is the report template users see prior to running the report. Copyright OneStop Reporting AS Page 63 OSR Report Designer/ Player User Guide

65 Run mode: When a user selects the Run tab in Designer or Player, the user is in the run-mode of the reporting application. Static reporting: Static reports are created when the Designer or Player user executes the report using the publish button. Template based: Reports created in Designer are considered to be template based because many reports can be run on the same report design with adjustments to the parameters. B. Expand Types Expand Type Functionality Node None Text Group Row Group created Expanding Flag checked Filter capability (aggregate Automatic Update If Add/delete BRANCHES? accounts) (aggregate accounts) Expanding Group (list accounts) If Add/delete FILTERS? n/a n/a Display Branch displays in Tree Design Branch displays in Report Design (when tree dragged out) Branch displays in finished report (when report is run) (only displays accounts from children) (one aggregate row of filtered accounts (placeholder description or result of associated formula) (one aggregate row of filtered accounts) (list with each account in filter on its own row) Before going into the details of expanding types, the user should be familiar with the terms used in this section. Row Group: If an expand type creates a row group, then data will be pulled from the database. In addition, a row group will be displayed inside a cell on the report definition and a group on the row will be created in the Layout Editor. The illustration below contains two nodes. The first is an expand type that creates a row group and the second does not create a row group. Copyright OneStop Reporting AS Page 64 OSR Report Designer/ Player User Guide

66 A group is created on the row Expanding flag: If the expanding flag is checked for the particular expand type, the row will create an expanding group when the report is generated. In other words, individual accounts will be displayed in their own rows. For more details on expanding groups, see the section on Expanding Groups. Filter capability: The filter capability simply determines if the expand type allows users to create a filter similar to those seen in the Report Designer. When a filter is created, those dimension/attribute values will be the only ones pulled from the database. Dependent on the expanding flag, the filtered data will be consolidated or expanded on each row. Automatic Update: Expression trees may be used in multiple reports and their capability to automatically update makes them extremely useful. However, there are specific restrictions on when the trees will automatically update. o If filters are modified: Changes to Filters in any expand type will automatically update in any existing report using the specific tree. o If nodes/branches are modified: Trees will not be automatically updated unless they use a combination of Node and None types. If the layout of the report definition will be changed due to the modification of the tree, the tree will not automatically update to avoid unwanted changes to the report definition. Each expanding types have specific purposes in the expression tree and have restrictions on when they can be used. The following paragraphs will explain each expand type and special characteristics associated with each one. Node Copyright OneStop Reporting AS Page 65 OSR Report Designer/ Player User Guide

67 By default, the top-level of any tree will have its Expand Type set to Node. However, users may freely change the expand type. Most often, the Node type is used with the combination of the None type so that trees may be automatically updated. Moreover, a row group will be created, but the user will not be able to set a filter for the expand type. Rather, the filter of the node is determined by the child branches and their filters. For any child branch, the Node type will create an expanding group. None The None expand type cannot be used at a parent level or the summary level of an Expression Tree. In addition, if the child branch/node is the None type, then the parent MUST be a Node type. Moreover, a row group will not be created. In fact, the node or branch with the None expand type will not be displayed on the report definition. However, generating the report will cause the Node type to expand and display the None types. Not displayed on report definition Also, the user may set a filter, which will be referenced by the parent node and retrieve data from the database. Copyright OneStop Reporting AS Page 66 OSR Report Designer/ Player User Guide

68 Since the parent branch of the None expand types must be Node types and Node types will expand the group, each child branch will be displayed on the generated report. However, filters set on multiple accounts for the None expand type will consolidate the data onto one row. In summary, the None type must follow these rules: 1. Cannot be used for parent level node or branch. 2. Must be a child node or branch of a Node parent. Copyright OneStop Reporting AS Page 67 OSR Report Designer/ Player User Guide

69 3. The Expression Tree cannot be composed of all None types. 4. Filters on children of the None type cannot overlap. Text The simplest Expand Type which creates a row on the report definition with the name of the node or branch. The most common use is to create a placeholder for a subtotal or grand total. However, the summations must be created in the report definition and not in the Expression Tree. Moreover, the Text type will not create a row group nor allow the user to set filters. The image below depicts how a Text Expand Type works between the Tree Editor and report definition. Group The Group Expand Type is used to create an aggregation, or a summary, of several accounts onto a single row in a generated report. A simpler way of looking at the Group type is that it functions the same way as having the Expanding box unchecked in the Layout Editor when creating a report definition. Moreover, a row group will be created and the user may set a filter. All values associated with the set filter will be consolidated onto a row. For instance, if a node is created with the Group type and the filter is set to five accounts (100, 200, 300, 400, and 500), the generated report will display one unique row summarizing the data from all five accounts. For more details on the difference between Groups and Expanding Groups, refer to the section on Expanding Groups. Expanding Group The Expanding Group Expand Type is the only type that creates an expanding group dependent on the filter set by the user. Therefore, the Expanding Group type will be used when creating a report that requires a row for every unique account set in the filter. For instance, a detailed P&L statement would utilize the Expanding Group type. Users will be able to specify the field that the group will expand on by accessing the Expanding Field option. Moreover, a row group will be created and the user may set a filter. All values associated with the set filter will be displayed on a unique row. For instance, if a node is created with the Expand Group type Copyright OneStop Reporting AS Page 68 OSR Report Designer/ Player User Guide