DB2 Web Query New Features. July 2010 Hotfix

Transcription

1 DB2 Web Query New Features July 2010 Hotfix

2 Cactus, EDA, EDA/SQL, FIDEL, FOCUS, Information Builders, the Information Builders logo, iway, iway Software, Parlay, PC/FOCUS, RStat, TableTalk, Web390, and WebFOCUS are registered trademarks, and DataMigrator and Magnify are trademarks of Information Builders, Inc. Adobe, the Adobe logo, Acrobat, Adobe Reader, Flash, Adobe Flash Builder, Flex, and PostScript are either registered trademarks or trademarks of Adobe Systems Incorporated in the United States and/or other countries. Due to the nature of this material, this document refers to numerous hardware and software products by their trademarks. In most, if not all cases, these designations are claimed as trademarks or registered trademarks by their respective companies. It is not this publisher s intent to use any of these names generically. The reader is therefore cautioned to investigate all claimed trademark rights before using any of these names other than to refer to the product described. Copyright 2010, by Information Builders, Inc. and iway Software. All rights reserved. Patent Pending. This manual, or parts thereof, may not be reproduced in any form without the written permission of Information Builders, Inc.

3 IBM Contents 1. July 2010 Hotfix New Features...7 Change Management Utility Enhancements...8 Synonyms Supported in Change Management...8 Administration Console Enhancements...14 Creating Language Resource Files...14 Web Browser Support April 2010 Hotfix New Features...19 DB2 Web Query Client Security Enhancements...20 Stopping a DB2 Web Query Request...20 Monitoring Sessions January 2010 Hotfix New Features...23 DB2 Web Query Enhancements...24 Understanding DB2 Web Query Error Messages...24 Increased Security for Viewing Traces...26 Change IBM i User ID Password...26 Enhanced Error Message When No HTML Records Are Returned...27 DB2 Web Query Graphics Enhancements...28 New Minimum and Maximum Y-Axis Value Parameters for Gauge Charts...28 Report Assistant Enhancements...28 Prompt User if Selection Criterion Will Be Deleted on Save or Quit...29 OLAP Enhancements...29 Title Added to OLAP Graphs...29 Power Painter Enhancements...29 Faster Preview Load Times in RDBMS...29 New Visible Property for Coordinated Field Values...29 Developer Workbench Enhancements...30 Displaying the File Name Column in the Managed Reporting Area...30 Adding or Modifying External Tools...31 DB2 Web Query New Features 3

4 Contents HTML Composer Enhancements...33 Reporting Language Enhancements...54 Precision for Date-Time Values...54 Excel (EXL2K Format) Style Enhancements...58 Symbol Font Support...58 Displaying the Total Number of Pages in a Sort Group: <BYLASTPAGE...59 LCWORD2: Converting a Character String to Mixed-Case...61 DATEPATTERN in the Master File...62 Storing the Number of Repetitions of a Repeating Field in a Virtual Field...69 Browser Certification...71 Microsoft Internet Explorer Version 8 Certification...71 Firefox Version Certification...71 Upgrade Considerations...71 DB2 Web Query Administration Console...71 Power Painter...72 Developer Workbench...72 Graph Assistant October 2009 Hotfix New Features...73 Web Query Enhancements...74 Run with SQL Trace Option with Enhanced Detail...74 Report Assistant Enhancements...74 Displaying Repeated Sort Values in Report Assistant July 2009 Hotfix New Features...77 Report Development Tools Enhancements...78 DB2 Output Format Hold File Support for Domain Application Path Setting...78 Spreadsheet Client Enhancements...78 Configuration File...78 Support for Synonyms Outside of the baseapp Folder...78 DB2 Web Query Adapter for Microsoft SQL Server May 2009 Hotfix New Features...81 Report Broker Enhancements...82 Bursting With Wildcards, Java Regular Expressions, and Default Distribution IBM

5 Contents Active Reports Enhancements...83 Printing Active Reports Data...83 Using the Grid Tool...84 Using the Chart/Rollup Tool...90 Using the Pivot Tool...92 Filtering Selections Using Multiple Values...95 By Sort Field Values Appearing on Every Page...96 Adapter Enhancements...97 Increased Number of Joins Supported for SQL Adapters...97 Spreadsheet Client Enhancements...98 Spreadsheet Client License Check...98 OLAP Enhancements...98 Increased Limit of Entries in an OLAP Drop Down March 2009 Hotfix New Features...99 Metadata Tool Enhancements Metadata Automatically Created in the First Folder of Domain's Application Path Report Broker Enhancements Report Broker and i5 Support for Authenticated SMTP Limitation of Formats for Reports January 2009 Hotfix New Features Developer Workbench Enhancements New Applications Folder Under Managed Reporting Enhanced Domain Properties Dialog Box Administration Console Accessing the DB2 Web Query Administration Console V1M1R1 New Features Developer Workbench Enhancements Creating a New Application Folder Do Not Show on User s List Domain Property Tab Control Enhancements Entering Masked Text in HTML Layout Painter Formatting Text Elements DB2 Web Query New Features 5

6 Contents Creating Active Dashboards in HTML Layout Painter Adding Schedule Capability in HTML Layout Painter Adding a Tab Control to the Layout in HTML Layout Painter Setting Default Values in HTML Layout Painter Adding Comments to HTML Active Report Output Web Query Development Tools Enhancements Change Management Load Utility Pie Chart Enhancements Creating a Thermometer Gauge Chart Displaying All Instances of Sort Values Displaying a Fully Qualified Field Name Web Query Administration Enhancements Report Broker Server Configuration Settings Change Management Extract and Load Utilities Adapter Enhancements Procedures Adapters Reader Comments IBM

7 IBM 1 July 2010 Hotfix New Features This document describes the DB2 Web Query new features for the July 2010 Hotfix. All new features described in this document are available to end users, developers, and administrators unless otherwise noted. Topics: Change Management Utility Enhancements Administration Console Enhancements Web Browser Support DB2 Web Query New Features 7

8 Change Management Utility Enhancements Change Management Utility Enhancements In this section: Synonyms Supported in Change Management This section describes new features for the Change Management utility. Synonyms Supported in Change Management How to: Extract MR Change Management Packages Load MR Change Management Change Packages The Change Management utility supports DB2 Web Query metadata, for example, you can add synonyms to a Change Package to enable the move of a complete application from one DB2 Web Query environment to another. Please refer to the following documentation as it replaces the online version of the help found in the DB2 Web Query Administration Console. Administrators can use the Utilities section of the Administration Console to extract and load specific Change Packages from one environment to another. Note: This is a beta feature is only available in the English version of DB2 Web Query. Procedure: How to Extract MR Change Management Packages To extract MR Change Management Packages: 1. Log on to the Administration Console in the environment where you want to create a Change Package. 2. Click Utilities. The MR Change Management Extract and Load options appear. Note: If you are a DB2 Web Query developer, only the Extract option is available. An administrator ID, one that has the MRADMIN group profile, is required to perform a Change Management Load operation. 3. Select Extract to create a Change Package. 8 IBM

9 1. July 2010 Hotfix New Features The Change Management Extract utility appears as shown in the following image. 4. Expand the folders in the Domains Tree, and select individual objects from a Domain or all the objects within a Domain. When selecting an entire Domain, everything except the Applications folder is added to the Change Package. In order to add synonyms to a Change Package, they need to be selected by expanding the Applications folder tree. To select individual items from a Domain, single-click one or more objects from a Domain. To select the entire contents of a Domain, double-click a Domain. This adds the Domain to the Selected Source Objects pane. Note that this does not add the Applications folders where synonyms are stored. Properties of a Domain are not propagated by the change management process. Note that a selected Domain is a collection of content of the Domain, and not a complete clone of the original Domain. When you select an object or Domain, it appears in the Selected Source Objects pane. If you select duplicate objects or Domains, they are only added to the Change Package once. You should not select individual objects from a Domain that have already been selected. DB2 Web Query New Features 9

10 Change Management Utility Enhancements Synonyms are made up of two files, the Master File (.mas extension) and the Access File (.acx extension). If synonyms are being added to a Change Package, you can move both files together. When an Access File is added to a Change Package, you will receive the following message: Known Limitation: You must add the Domain folder contents to the Selected Change Packages pane before you add an Application folder to the Selected Change Packages pane, otherwise the Application folder is not added to the Change Package. In a future hotfix release, you will be able to add Application folder content and Domain folder content interchangeably. 5. Click OK to add the Access File to your Change Package. Remember that tables, views, and stored procedures, for example, on which the synonyms' Access File are based must exist on the target system. Otherwise any reports that references the synonyms will fail to execute. 6. If you need to remove an item or Domain from the Selected Files and Domains list, select the object and press the Delete key or double click the object. 7. To remove all items and Domains from the Selected Files and Domains list, click the Clear File List button. 10 IBM

11 1. July 2010 Hotfix New Features 8. By default, the Download File option is selected. Click Create Change Package to download the Change Package to your browser. You will then have the option to open it or save it locally, as shown in the following image. The naming format for the Change Package is: YYYYMMDD_admin_HHMMSS.zip. The format is Java Zip (which is WinZip compatible). If you have WinZip installed locally, open the Change Package. To ensure that the Change Management utility recognizes the file and processes it correctly, do not change the file name or the.zip file extension. The content of the Change Package includes the extracted file(s) and a cmrepos.xml document that contains metadata about the file(s), such as their internal references and properties. If you select the Save on Server option, the following window opens to provide you with the name of the Change Package created on the server. DB2 Web Query New Features 11

12 Change Management Utility Enhancements If you are a Managed Reporting administrator, consider whether you want developers to download and Change Packages to a coordinator, or create the packages on the Web server platform. Packages created on the server are written to install_dir/webfocus76/utilities/cm/extract. If authorized, you can change this location by editing the WebFOCUS deployment descriptor (web.xml) and changing the value of the context-parameter MRCMEXTRACTDIR. The directory specified by this setting must exist and be writable by the servlet container. We recommend that developers create the package on the server and also download and them to a coordinator. This may help audit the change process since you have a record of the intent of the developer, and can load the packages from a controlled location. Note: To ensure that the contents of a Change Package are not altered in any way, it is recommended that you always load Change Packages that were created with the Save on Server option. 9. If you are a Managed Reporting administrator, select Display Repository Metadata to open a window where you can view and extract metadata from the Repository for analysis. You can also query the Repository for metadata if desired. This may be helpful in planning or debugging. 10. Click Logout. Procedure: How to Load MR Change Management Change Packages 1. Log on to the Administration Console in the environment where you want to load the Change Package that was created with the Change Management Extract utility. You must use a DB2 Web Query administrator ID, one that has the MRADMIN group profile, in order to access the Change Management Load utility. 2. Click Utilities. 3. Select Load (below MR Change Management) to load a Change Package. 12 IBM

13 1. July 2010 Hotfix New Features The Change Management Load utility appears, as shown in the following image, and displays any folders in the /utilities/cm directory that contain Change Packages (.zip files). 4. To load a Change Package, select the desired.zip file Change Package in the Available Change Packages pane to add it to the Selected Change Packages pane. The available options you can select include Overwrite duplicates (default), Backup packages (available only when Overwrite duplicates is selected), Preserve Creation info, and Preserve Modifier info. 5. To remove a selected Change Package from the Selected Change Packages list, select the item and press the Delete key. To remove all selected Change Packages, click the Clear File List button. 6. Click Load Change Package to load the Change Package into the MR repository of your target environment. Note: You can click the Open Log File button to view the contents of the cmevent.log file that was created in the /utilities/cm directory. It contains helpful information about the success or failure of the load process. DB2 Web Query New Features 13

14 Administration Console Enhancements Known Limitations: The next DB2 Web Query PTF will address the following limitations of the Change Management Load utility. Domain properties are not preserved when loading a new Domain into a DB2 Web Query environment using the Load utility. An error loading a Domain occurs if the Domain once existed in the target DB2 Web Query environment. For example, you create a Change Package that contains a Domain named GBLSALES and subsequently delete the GBLSALES Domain. In this case, an error will occur when trying to load the Change Package back into the same DB2 Web Query environment. 7. Click Logout. Administration Console Enhancements In this section: Creating Language Resource Files This section describes new features for the Administration Console. Creating Language Resource Files How to: Create Language Resource Files Enable Greek in the Administration Console Perform NLS Configuration Log On to Web Query Using the Greek Option To enable the DB2 Web Query interface for a language which is not by default included in the Dynamic Language Switch function (for example Greek or Thai), you must execute the Language Resource Files utility, which creates the necessary resource files. Procedure: How to Create Language Resource Files The following steps describe how to create the Greek resource files. Ensure that your Web server and Application server are not running before following the following steps. 1. From QSH, navigate to the following directory: /qibm/proddata/webquery/ibi/webfocus76/utilities/lang. 2. Run CreateLangResAS4.sh. 14 IBM

15 1. July 2010 Hotfix New Features 3. Enter EL at the DB2 Web Query language code prompt. 4. Enter el at the Java language code prompt as shown in the following image. 5. Enter /qibm/proddata/webquery/ibi/webfocus76 for the DB2 Web Query install path. 6. Enter C to continue as shown in the following image. 7. Press Enter to finish. 8. Restart your Web server and Application server. Procedure: How to Enable Greek in the Administration Console 1. Log on to the DB2 Web Query Administration console with the QWEBQRYADM user id. 2. Use the URL and click the Configuration Section. DB2 Web Query New Features 15

16 Administration Console Enhancements 3. Click Dynamic Language Switch, and check Greek. Click Save to apply the changes to the configuration. 4. Click the NLS settings. 5. Select Greek. 6. Click Save to apply the changes to the configuration. 16 IBM

17 1. July 2010 Hotfix New Features Procedure: Procedure: How to Perform NLS Configuration Run the DB2 Web Query NLS Configuration (WQSETNLS) command to set the server code page and language: WQSETNLS VALUE(875) How to Log On to Web Query Using the Greek Option 1. From the Logon page, select Greek from the Select Language drop down, as shown in the following image. 2. Log on to DB2 Web Query. Web Browser Support Microsoft Internet Explorer Versions 8.0, 7.0, 6.0 SP2, and 6.0 SP3 are certified as of the July 2010 Hotfix release. Mozilla Firefox Version and Mozilla Firefox Version are certified as of July 2010 Hotfix release. DB2 Web Query New Features 17

18 Web Browser Support 18 IBM

19 IBM 2 April 2010 Hotfix New Features This document describes the DB2 Web Query new features for the April 2010 Hotfix. All new features described in this document are available to end users, developers, and administrators unless otherwise noted. Topics: DB2 Web Query Client Security Enhancements DB2 Web Query New Features 19

20 DB2 Web Query Client Security Enhancements DB2 Web Query Client Security Enhancements In this section: Stopping a DB2 Web Query Request Monitoring Sessions This section describes new features for DB2 Web Query Client Security. Stopping a DB2 WebQuery Request Reference: Stopping a DB2 Web Query Request Users can cancel active requests that are initiated from their browser session on the reporting server by clicking Stop Requests on the top banner as shown in the following image. Reference: Stopping a DB2 Web Query Request All active requests for the current browser session are canceled and the following confirmation message displays: xx request(s) stopped. where: xx Is the total number of requests that were canceled. Note: The Reporting Server may take some time to complete the stop request. Clicking Stop Requests during this time may result in an incorrect number of cancel requests being reported. 20 IBM

21 2. April 2010 Hotfix New Features Monitoring Sessions Once the request is canceled, DB2 Web Query displays the following information to the user that ran the request: Reporting server request terminated by operator. If the request is stopped while data is already being output, the following message displays in the report output: This report is invalid because the data retrieval has been killed or the job has been stopped. If report output is PDF and the request is stopped while data is already being output, the following message displays: The File is damaged and could not be repaired. The Session Monitor menu enables an administrator to track all Client sessions, as well as connections and activity on the DB2 Web Query Reporting Server. To refresh the information displayed, select the Refresh every check box and specify the frequency in seconds using the Seconds box. The Session Monitor displays information about connected users, report requests, and reporting server nodes, as shown in the following image. DB2 Web Query New Features 21

22 DB2 Web Query Client Security Enhancements 22 IBM

23 IBM 3 January 2010 Hotfix New Features This document describes the DB2 Web Query new features for the January 2010 Hotfix. All new features described in this document are available to end users, developers, and administrators unless otherwise noted. Topics: DB2 Web Query Enhancements DB2 Web Query Graphics Enhancements Report Assistant Enhancements OLAP Enhancements Power Painter Enhancements Developer Workbench Enhancements Reporting Language Enhancements Browser Certification Upgrade Considerations DB2 Web Query New Features 23

24 DB2 Web Query Enhancements DB2 Web Query Enhancements In this section: Understanding DB2 Web Query Error Messages Increased Security for Viewing Traces Change IBM i User ID Password Enhanced Error Message When No HTML Records Are Returned This section describes new features for DB2 Web Query. Understanding DB2 Web Query Error Messages How to: Define an Error Message You can use the Error Message Lookup feature to understand error messages. The link provides the full text associated with a Reporting Server error message (FOCXXXX). To use this feature, you need the numeric portion of the error message. Enter only the numeric portion of the error number. If you enter "FOC" an error will occur. This option is available for administrators and developers only, run only users will not see this option. To access the Error Message Lookup feature, click the Message Lookup link located on the DB2 Web Query banner. Procedure: How to Define an Error Message For administrators and developers, the banner contains a Message Lookup link, as shown in the following image. 1. Click the Message Lookup link. 24 IBM

25 3. January 2010 Hotfix New Features The Error Message Lookup dialog box appears. 2. Enter the numeric portion of the error message. DB2 Web Query New Features 25

26 DB2 Web Query Enhancements 3. Click Lookup. The full text description associated with the FOC error message appears. Increased Security for Viewing Traces Administrators for the DB2 Web Query Administrative Console can view traces, but developers can no longer view traces. This update enhances security for DB2 Web Query. You must have administrator privileges to view traces in the DB2 Web Query Administration Console. When a user that does not have administrator privileges selects the All Clients section under the Diagnostics menu, the following message displays: Failure, user has to be an ADMINISTRATOR Change IBM i User ID Password DB2 Web Query has a Change Password button that allows a user to change their IBM i User ID password. This feature is a benefit to those who do not have direct access to IBM i system. 26 IBM

27 3. January 2010 Hotfix New Features The Change Password button is located on the DB2 Web Query login page. Clicking the Change Password button brings up the following dialog box. After providing your credentials and a new password, click the Submit button to save the change. Enhanced Error Message When No HTML Records Are Returned There are some cases when no HTML records are returned to your browser, for example, if you choose DB2 as your report output format. All records are inserted into a DB2 table and you receive the message: No HTML Output! This message has been enhanced to read as follows: No output was generated! This can be caused by no rows being returned from the report data source or the output being directed to a destination such as a file or printer output. DB2 Web Query New Features 27

28 DB2 Web Query Graphics Enhancements DB2 Web Query Graphics Enhancements In this section: New Minimum and Maximum Y-Axis Value Parameters for Gauge Charts This section describes new features for DB2 Web Query Graphics. New Minimum and Maximum Y-Axis Value Parameters for Gauge Charts There are two new parameters, Minimum Y-axis value and Maximum Y-axis value. These parameters improve the readability of your gauge charts. While in Power Painter, select a gauge chart and open the Chart Editor by clicking on the Chart Editor button on the toolbar. Navigate to the Gauge axis parameters and click the General category. Click the Show Properties button to view and set these new parameters as shown in the following image. Report Assistant Enhancements In this section: Prompt User if Selection Criterion Will Be Deleted on Save or Quit This section describes new features for Report Assistant. 28 IBM

29 3. January 2010 Hotfix New Features Prompt User if Selection Criterion Will Be Deleted on Save or Quit If a selection criterion is defined and is checked for deletion but not explicitly deleted, Report Assistant and Graph Assistant will now prompt the user to confirm deletion before exiting the tool. OLAP Enhancements In this section: Title Added to OLAP Graphs This section describes new features in OLAP. Title Added to OLAP Graphs Multiple graphs are generated when using the Graph feature in OLAP with multiple sort fields. A title has been added to each graph where the title is equal to the value of the outer sort field. Power Painter Enhancements In this section: Faster Preview Load Times in RDBMS New Visible Property for Coordinated Field Values This section describes new features in Power Painter. Faster Preview Load Times in RDBMS When using an RDBMS data source, the preview will no longer pass aggregation to the RDBMS. This will result in any totals on the page to only encompass the number of records stated in the RECORDLIMIT. At run time, aggregation will be passed, and totals will reflect the entire database as expected. This change will result in faster preview load times. New Visible Property for Coordinated Field Values Coordinated fields have a new property, Visible, which can be set to Yes or No. Setting this to "Yes" will cause the value to appear on your report or chart. DB2 Web Query New Features 29

30 Developer Workbench Enhancements Right-click the coordinated field and select the Properties option to access this new property as shown in the following image. Developer Workbench Enhancements In this section: Displaying the File Name Column in the Managed Reporting Area Adding or Modifying External Tools HTML Composer Enhancements This section describes new features in Developer Workbench. Displaying the File Name Column in the Managed Reporting Area In the Explorer tree of the Managed Reporting area of Developer Workbench, the File name column specifies the resource of the hypertext reference (HREF) for files and folders. The HREF File name is displayed when selecting the Domains folder, Standard Reports folder, the Other folder, and when viewing content in any of the subfolders under Standard Reports and Reporting Objects. 30 IBM

31 3. January 2010 Hotfix New Features The following image shows the HREF File name for the subfolder of Standard Reports in the Managed Reporting area. Adding or Modifying External Tools How to: Add or Modify External Tools You may edit the list of registered external tools by clicking the Add or Modify External Tools button, located on the Commands Toolbar in Developer Workbench. The Commands Toolbar enables you to access any external program added in the External Tools tab of the Developer Workbench Options dialog box. When you add an external program, it appears as an additional button on the Commands Toolbar. Select the button from the Commands Toolbar to launch the external tool. DB2 Web Query New Features 31

32 Developer Workbench Enhancements An example of the Commands Toolbar with external tools (Notepad, Paint, and Excel) is shown in the image below. Procedure: How to Add or Modify External Tools 1. From the Developer Workbench Explorer, select Commands Toolbar from the View menu. Note: The Commands Toolbar is not visible by default. The Commands Toolbar appears next to the main toolbar, displaying the Add or Modify External Tools button. You may move, dock, or float this toolbar. 2. Click the Add or Modify External Tools button. The Developer Workbench Options dialog box opens at the External Tools tab. 3. Type the Tool title and enter the Tool path, or click the Browse button, to find the selected program. 4. Click OK to close the Developer Workbench Options dialog box. The external tool appears as an additional button on the Commands Toolbar. 5. Select the added program button from the Commands Toolbar to launch the external tool. Note: The external program added is also available from the Command menu. Tip: You may also access the Developer Workbench Options dialog box by selecting Options from the Windows menu. Click the External Tools tab to see the list of registered external tools. 32 IBM

33 3. January 2010 Hotfix New Features HTML Composer Enhancements In this section: Renaming the HTML Layout Painter Tool Creating Dynamic Parameters by Adding a Filter Loading Message at Run Time for HTML Composer Pages Chaining Icons From the Parameters Tab of the HTML Composer Setting the Form Type for the Parameter Grouping Options Adding a Label Control to the Layout Reloading the External Procedure in the Properties and Settings Dialog Box Undo/Redo Icons in the HTML Composer Toggling Parameter Selections From the New Parameters Dialog Box Chaining Controls for Dependencies Creating Parameter Values and Binding Controls Creating Hyperlink Actions With Additional Parameters Setting the Default Caching Option Grouping Objects on the HTML Page Reordering Selected Values in a List Box and Double List Control Sorting a Dynamic List of Values This section describes new features in the HTML Composer. Renaming the HTML Layout Painter Tool The HTML Layout Painter is now HTML Composer. Note: The functionality for this tool has not changed. Procedure: How to Access the HTML Composer 1. From the HTML Files folder, select File then New HTML File. The Add HTML File dialog box opens. 2. Enter a file name. DB2 Web Query New Features 33

34 Developer Workbench Enhancements 3. Select Composer (Layout) from the Create with drop-down list. 4. Click Open. 34 IBM

35 3. January 2010 Hotfix New Features The HTML Composer opens. Creating Dynamic Parameters by Adding a Filter In the HTML Composer, dynamic values are available by default if a data field used in the procedure is associated with the selected form control. You may also create new dynamic parameters by adding a filter to a report or graph component in the layout. Procedure: How to Create Dynamic Parameters by Adding a Filter You may create new dynamic parameters by adding a filter to a report or graph component in the layout. DB2 Web Query New Features 35

36 Developer Workbench Enhancements 1. To create dynamic parameters for your report or graph in the Composer (Layout), right-click the report or graph object and select Add a filter from the context menu. The Filter options dialog box opens. 2. Select the field to be used for the parameter, the Multiselect option, and click OK. 36 IBM

37 3. January 2010 Hotfix New Features The New Parameters dialog box appears. You may select a control type for the parameter from this dialog box, or adjust it later using the Parameters tab. Note: If the New Parameters dialog box does not appear, ensure that Show New Parameters dialog is selected from the Settings dialog box. Select Settings from the Tools menu to open the Settings dialog box. 3. Click OK to close the New Parameters dialog box. The following WHERE statement is added to the procedure. WHERE (MANAGER_ID EQ '&MANAGER_ID.(FIND MANAGER_ID IN SHORT).Select a manager_id.'); The filter appears above the report or graph object. 4. Repeat this procedure for each additional parameter for the report or graph. DB2 Web Query New Features 37

38 Developer Workbench Enhancements Loading Message at Run Time for HTML Composer Pages When running an HTML page from the HTML Composer, the Web browser displays a Loading, please wait message, as shown in the following image, until the page is fully loaded. Chaining Icons From the Parameters Tab of the HTML Composer In the HTML Composer, Add to Current chain and Remove from Current chain buttons have been added to the Positioning toolbar. These chaining buttons are available when controls are multi-selected on the Design or Parameters tab. Icons Description Adds a control to a chain. Each time a selection is made, all chained controls are dynamically updated. Note: This button is disabled if you multi-select controls that are already in a chain. Removes a control from a chain. Note: This button is disabled for the first control in a chain, but enabled for all others. 38 IBM

39 3. January 2010 Hotfix New Features Setting the Form Type for the Parameter Grouping Options You may create a single layer form or multiple layer form in the HTML Composer. These form types, available as the parameter grouping options, display the placement of the form control and the associated parameters on the Design tab. The default, multiple layer form, contains group boxes around each element in the form. You may move and resize each element of the form control. The single layer form contains all of the elements within a single group box. The Parameter grouping options menu in the New Parameters dialog box provides options for the placement of the form controls associated with new variable parameters created in the Report Assistant. The option selected is set from the Settings dialog box. You may create a single or multiple layer form, or select an existing form from the layout. Select Do not create a form to insert the form controls for each of the new parameters in separate locations on the HTML page. Select New multiple layer form to insert the form controls for all of the new parameters inside one form element you can position anywhere on the HTML page. This form element also contains submit (run) and reset buttons. The multiple layer form contains group boxes around each element in the form. You may move and resize each element of the form control. Note: Multiple layer is the default form type selected in the Settings dialog box. To change the default form type, select Settings from the Tools menu. Select New single layer form to insert the form controls for all of the new parameters inside one form element you can position anywhere on the HTML page. This form element also contains submit (run) and reset buttons. The single layer form contains all of the elements within a single group box. Select form(n), where n is the number of a form control that already exists in the layout. The parameter is added to the selected form control. Select Don't show this message again and use default selection to control whether or not the New Parameters dialog box appears when adding parameters in the HTML Composer. Select Toggle Selection to switch between creating controls for all or none of the parameters in the New Parameters dialog box. When importing or referencing a report with parameters to an HTML page, all of the controls will have Create control selected by default. Toggle selection is useful when there is a long list of parameters that you do not want to add controls for on the HTML page. You may select Multiple Layer Form or Single Layer Form as the form type from either the Components toolbar or from the Insert menu, as shown in the following images. If no form type is selected, Multiple Layer Form is the default. DB2 Web Query New Features 39

40 Developer Workbench Enhancements From the Components toolbar, click the Insert form button, as shown in the following image. From the Insert menu, select Form, as shown in the following image. The following image shows the Settings dialog box with the Form type options. Note: When None is selected, the parameter grouping options show Do not create a form on the New Parameters dialog box. When Single layer is selected, the parameter grouping options show New single layer form on the New Parameters dialog box. The single layer form contains all of the elements within a single group box. When Multiple layer is selected, the parameter grouping options show New multiple layer form on the New Parameters dialog box. The multiple layer form contains group boxes around each element in the form. You may move and resize each element of the form control. Note: Multiple layer is the default form type. 40 IBM

41 3. January 2010 Hotfix New Features Adding a Label Control to the Layout You may insert a label control from the Components toolbar in the HTML Composer. The label component enables you to create and name a label, and link it to a control by assigning the label HtmlFor property the same value as the Unique Identifier property for the control. Additionally, new pages will show label tags in the Properties window. Existing pages will continue to show SPAN tags in the Properties window. Procedure: How to Add a Label Control 1. Insert a label in the layout by doing one of the following: Click the Insert Label button from the Components toolbar. From the Insert menu, select Label. The cursor changes into a crosshair. Click and drag the crosshair to create the label and adjust it to the size you want. A label control is created in the layout and assigned the name labeln, where n is a number. 2. Replace the label text with the text you want to appear in the layout. 3. Assign the label to an existing control in the layout by assigning the label properties: Select the label control in the layout. Select the HtmlFor property field in the Properties tab of the Properties window. Type the Unique Identifier property name for the control you want to link the label to. For example, suppose you have a drop-down list in your layout. The default Unique Identifier property name assigned to the drop-down list object is combobox1. Type combobox1 in the HtmlFor property field to link the label to the drop-down list in your layout. Optionally, change the label properties by adjusting the properties displayed in the Properties tab of the Properties window. For details, see Label Properties in the Properties Window on page 42. DB2 Web Query New Features 41

42 Developer Workbench Enhancements Reference: Label Properties in the Properties Window When label is selected, the Properties tab in the Properties window contains options that control the properties of the label in your layout. New pages will show labels as <LABEL> tags in the Properties window. 42 IBM

43 3. January 2010 Hotfix New Features Reloading the External Procedure in the Properties and Settings Dialog Box When using an external procedure to supply dynamic values in the HTML Composer, once you edit the external procedure that is associated with a control, you can right-click and choose Reload external procedure to reload and display the new syntax in the Properties and settings dialog box, as shown in the following image. Undo/Redo Icons in the HTML Composer When using the Parameters tab in the HTML Composer, the Undo and Redo buttons are activated on the Standard toolbar, enabling you to reset or repeat the last action performed. Note: When using the Properties and settings dialog box from the Parameters tab, Undo/Redo treats the entire Properties and settings dialog as one action. Use caution if modifying multiple fields in the Properties and settings dialog box. DB2 Web Query New Features 43

44 Developer Workbench Enhancements Toggling Parameter Selections From the New Parameters Dialog Box In the HTML Composer, the Toggle selection option enables you to switch between creating controls for all or none of the parameters in the New Parameters dialog box. When importing or referencing a report with parameters to an HTML page, all of the controls will have Create control selected by default. Toggle selection is useful when there is a long list of parameters that you do not want to add controls for on the HTML page. The following image shows the New Parameters dialog box. Chaining Controls for Dependencies The process of chaining controls for dependencies is available through the Design or Parameters tab. Chaining will populate controls based on the selected value on the prior control in the chain. You can chain static and dynamic controls, link or unlink parts of a chain, and create conditions on links in a chain. Chains are represented by lines connecting control objects on the Parameters tab. By clicking on the arrow head in a link of a chain, the Properties and settings dialog box enables you to modify and set properties and/or conditions of the chain. Note: Chaining is applicable only for controls, not parameters. 44 IBM

45 3. January 2010 Hotfix New Features Creating Parameter Values and Binding Controls The process of creating parameters and binding controls in the HTML Composer has been enhanced through the Parameters tab. The Parameters tab enables you to create and modify parameter values, input controls, and customize parameter conditions. You may also bind parameters to controls and chain controls to one another. The Parameters tab consists of the following components: Input control objects. You may select the input control object to view and edit the Properties and settings of the control. Add new parameters. Manually adding a parameter creates an unbound parameter. Binding controls and parameters. Input controls and parameters can be bound and unbound from the Parameters tab. Binding a parameter to a control makes it an incoming parameter that will populate the control. Binding a control to a parameter will populate the parameter. Creating Hyperlink Actions With Additional Parameters When you manually add a new parameter on the Parameters tab, you may pass the parameter variable to a hyperlink action. The additional parameters appear on the Hyperlink Properties dialog box when you create a new action. Note: The Hyperlink Properties dialog box is available when you create a Hyperlink, Push button, Frame, Image, and Submit button. Procedure: How to Create a Hyperlink Action With Additional Parameters 1. Create a new parameter: Right-click anywhere on the Parameters tab and select Add parameter. The Properties and settings dialog box opens. Enter the name for the parameter in the Name field, or keep the default name. Optionally, you may use the Format field to define the format of the parameter, such as A20 or D12.2. If this field is left blank, it automatically applies the Alphanumeric format to the value field. Enter the parameter value information. Options are Single select, Multiselect OR, and Multiselect AND. Note: These are static parameter options. Close the Properties and settings dialog box to create an unbound parameter. DB2 Web Query New Features 45

46 Developer Workbench Enhancements To bind the new parameter to a control, select the Design tab and create an input control. For example, insert a list box, drop-down list box, and so on. Click the Parameters tab. The Properties and settings dialog box appears for the control. Close the Properties and settings dialog box. Select the center of the parameter name object, left-click, and drag the parameter to the center of the control object. This makes it an incoming parameter that will populate the control. If the control will populate the parameter, select the center of the control object, left-click, and drag the control object to the center of the parameter object. Release the mouse to complete the binding. The image below is an example of an incoming parameter. Note: To modify the parameter value, right-click the parameter on the Parameters tab and select Properties and settings. 2. From the Design tab, create and open the Hyperlink Properties dialog box for the input control to create the hyperlink action. For example, insert and right-click the Push Button object and select Create hyperlink. The Hyperlink Properties dialog box opens for the selected object. 3. Click the New icon to create a new action. The Additional parameters button appears on the Hyperlink Properties dialog box. 46 IBM

47 3. January 2010 Hotfix New Features Note: The Additional parameters button only appears if parameters were created from the Parameters tab of the HTML Composer. 4. Select the Action, Source, Target Type, and Target/Template Name for the hyperlink. 5. Click the Additional parameters button and select the parameter name(s) to pass in this hyperlink. 6. Click OK to close the Hyperlink Properties dialog box. Note: If you are linking hyperlink properties to another page or procedure, the HTML Composer parses the other file for unresolved parameters and opens the New Parameters dialog box. When you run the report and click the hyperlink, the action passes the parameter value to the entity specified in the Source column of the Hyperlink Properties dialog box. DB2 Web Query New Features 47

48 Developer Workbench Enhancements Setting the Default Caching Option You can set properties for the HTML Composer with the Settings dialog box. The default caching option controls whether cache run-time data is on or off for the HTML page. The default is off. Note: When adding dynamic parameters to the HTML page, input controls retrieve data using procedures. You may cache the run-time data for input controls by using the cache run time option on the Parameters tab. This setting overrides the Default caching option from the Settings dialog box. Grouping Objects on the HTML Page You may group objects together on an HTML page by inserting a group box, panel, or form. You can copy and paste components (such as images, push buttons, and so on) between the HTML page and the grouping object while maintaining the association to the grouping object or the page. Procedure: How to Group Objects on the HTML Page To insert a grouping object on the HTML page: 48 IBM

49 3. January 2010 Hotfix New Features 1. Select Form, Panel, or Group Box from the Insert menu. The cursor changes into a crosshair. 2. Click and drag the crosshair to create the grouping object on the HTML page. 3. Right-click the component(s) to be copied and select Copy. 4. Right-click the grouping object and select Paste. The component is copied into the grouping object as a new object. For example, button1 copied from the HTML page appears as button2 in the grouping object. The original, button1 is still associated with the HTML page, whereas button2 is associated with the grouping object. To delete a grouping object, right-click the grouping object and select Delete. Note: When deleting a grouping object, the associated components are also deleted. Reordering Selected Values in a List Box and Double List Control When using a list box or a double list control in the HTML Composer, you may reorder the selected values in the report. Procedure: How to Reorder the Selected Values in the List Box When using a list box, you may reorder the selected values in the report. In the Design view of the HTML page, 1. Right-click the list box object and select the Add Move Items control. An up and down arrow is added next to the list box control. 2. Run the HTML page. 3. Select values from the list box and run the report. 4. To reorder the selected values, click the up arrow to move the selected value up in the list box, or click the down arrow to move the selected value down in the list box. 5. Run the report again to view the results with the selected values. DB2 Web Query New Features 49

50 Developer Workbench Enhancements In the following example, CA is the first value in the By State list box. Select the down arrow to reorder the location of CA in the list box and run the report again. Procedure: How to Add a Double List Form Control 1. Add a double list control by doing one of the following. From the Components toolbar, click the Double List Control button. From the Insert menu, select Double List Control. The cursor changes to a crosshair. 2. Click and drag the crosshair to create a double list control, and adjust it to the size you want. A double list control is created in the layout and assigned the name customselect(n)_selectfrom and customselect(n)_selectto, where n is a number. 50 IBM

51 3. January 2010 Hotfix New Features 3. You may edit the default description for the double list control by double-clicking Enter text, and typing the description of your choice. 4. To associate an existing parameter with the double list control, click the Parameters tab and select the input control with the name of the double list control (customselectn). The Properties and settings dialog box opens. Select the data type and the corresponding parameter values to associate with the double list control. Note: You may also add a double list control from the New Parameters dialog box that appears when creating a report with multi-select parameters. 5. Optionally, change the double list control properties by adjusting the properties displayed in the Properties tab of the Properties window. 6. Run the HTML page and select values by using the right and left arrows to add or remove values to the selected column. DB2 Web Query New Features 51

52 Developer Workbench Enhancements Note: The selected values appear in the second column. The output is generated based on the selected values in the second column. In the example below, Action and Comedy are the selected values for the report. 7. Optionally, you may reorder the selected values in the report. Note: The up and down arrows reorder the selected values that appear in the second column of the double list control. Click the up arrow to move the selected value up in the second column of the double list control, or click the down arrow to move the selected value down in the double list control. Sorting a Dynamic List of Values In the HTML Composer, sort options enable you to set the sort order for displaying values in dynamic list controls. This option is useful when you want to sort each control independently from the others. 52 IBM

53 3. January 2010 Hotfix New Features Procedure: How to Sort the Dynamic List of Values Note: If sort options are not selected, the request retrieves dynamic display values from the BY sort field in the request, and the results display values based on the value field. Sort options are not selected by default. 1. Select a dynamic control from the Parameters tab. The Properties and settings dialog box opens. 2. Select Sort to enable the sort options. You may select the Sort by and Sort order options for the control. The following image shows the sort options that appear on the Properties and settings dialog box of the Parameters tab, when a dynamic control is selected. 3. Select the Sort by options: Sort by Value sorts the value by the field name from the Value field. This is the default Sort by selection. Sort by Display sorts the value by the field name from the Display field. 4. Select the Sort order options: Sort order Ascending sorts the value from lowest to highest. This is the default Sort order selection. Sort order Descending sorts the value from highest to lowest. 5. Close the Properties and settings dialog box. Tip: You may repeat these steps and select sort options for each dynamic control on the HTML page. 6. Run the HTML page to see the sort results. DB2 Web Query New Features 53

54 Reporting Language Enhancements Reporting Language Enhancements In this section: Precision for Date-Time Values Excel (EXL2K Format) Style Enhancements Symbol Font Support Displaying the Total Number of Pages in a Sort Group: <BYLASTPAGE LCWORD2: Converting a Character String to Mixed-Case DATEPATTERN in the Master File Storing the Number of Repetitions of a Repeating Field in a Virtual Field This section describes new features for Reporting Language. Precision for Date-Time Values How to: Specify Precision for Date-Time Values In prior releases, the seconds component of a date-time value could be displayed with zero, three, or six decimal digits. It can now be displayed with zero through nine decimal digits. In order to control the precision of the seconds component in a date-time format, you can specify a digit from 1 to 9 in the format. Syntax: How to Specify Precision for Date-Time Values Special format components exist for three decimal digits (milliseconds, s), six decimal digits (microseconds, m), and nine decimal digits (nanoseconds, n). To display: A Time-only value, when the format includes more than one time display component: The components must appear in the order hour, minute, second, millisecond, microsecond, or nanosecond. The first component must be either hour, minute, or second. No intermediate component can be skipped. If hour is specified, the next component must be minute; it cannot be second. 54 IBM

55 3. January 2010 Hotfix New Features To display a specific number of digits, include the format for seconds (S) followed by the number of digits to display. Alternatively, you can specify one or more of the following components: milliseconds (s), microseconds (m), nanoseconds (n). Both a date component and a time component, the time component is represented by one character, which specifies the smallest unit of time to be displayed. This character can be either: A number from 1 to 9, which specifies the number of decimal digits to display for the seconds component. One of the supported time components. In this case, all higher-order time components will also be included in the display. Example: Specifying Precision for Date-Time Values Use the COMPUTE or DEFINE dialog in the report development tools or the Synonym Editor in Developer Workbench to perform these transformations. Assume the date is February 5, 1999 and the time is 02:05: a.m. The following defines use of the nanosecond component or a precision in display formats and function calls: TRANSDT/HYYMDn = DT( :05: ); O_HSsmn/HSsmn = TRANSDT; O_HHIS2/HHIS2 = TRANSDT; O_HYYMDn/HYYMDn = TRANSDT; O_HYYMD1/HYYMD1 = TRANSDT; O_HADD/HYYMD9 = HADD(TRANSDT, 'NS', 2, 12, 'HYYMD9'); O_HCNVRT/A26 = HCNVRT(TRANSDT, '(H23)', 23, 'A26'); O_HDIFF/D12.2 = HDIFF(O_HADD, TRANSDT, 'NS', 'D12.2'); TRANSDATE_DATE/YYMD = HDATE(TRANSDT, 'YYMD'); O_HDTTM/HYYMDn = HDTTM(TRANSDATE_DATE,12, 'HYYMDn'); O_HEXTR/HHIS9 = HEXTR(TRANSDT, 'n',12, 'HHIS9'); O_HGETC/HYYMDn = HGETC(12, 'HYYMDn'); O_HINPUT/HYYMDn = HINPUT(14, O_HCNVRT,12, 'HYYMDn'); O_HMASK/HYYMDn = HMASK(O_HEXTR, 'HISsmn', TRANSDT, 12, 'HYYMDn'); O_HMIDNT/HYYMDn = HMIDNT(TRANSDT,12, 'HYYMDn'); O_HNAME/A10 = HNAME(TRANSDT, 'NANOSECOND', 'A10'); O_HPART/I10 = HPART(TRANSDT, 'NANOSECOND', 'I10'); O_HSETPT/HYYMDn = HSETPT(TRANSDT, 'NS', 28, 12,'HYYMDn'); O_HTIME/P20.2C = HTIME(12,TRANSDT, 'D16'); DB2 Web Query New Features 55

56 Reporting Language Enhancements Output of these Define fields in a report: TRANSDT 1999/02/05 02:05: O_HSsmn O_HHIS2 02:05:25.12 O_HYYMDn 1999/02/05 02:05: O_HYYMD1 1999/02/05 02:05:25.1 O_HADD 1999/02/05 02:05: O_HCNVRT O_HDIFF 2.00 O_HDTTM 1999/02/05 00:00: O_HEXTR 00:00: O_HGETC 2008/06/25 10:26: O_HINPUT 1999/02/05 02:05: O_HMASK 1999/02/05 00:00: O_HMIDNT 1999/02/05 00:00: O_HNAME O_HPART O_HSETPT 1999/02/05 02:05: O_HTIME 7,525,123,456, Note: Field O_HSsmn displays the seconds (S), milliseconds (s), microseconds (m), and nanoseconds (n) from TRANSDT. Field O_HHIS2 displays the hours (H), minutes (I), and seconds (S) from TRANSDT. The seconds are displayed with two decimal digits (2). Field O_HYYMDn displays TRANSDT with the date in YYMD format and the time down to nanoseconds (n). Field O_HYYMD1 displays TRANSDT with the date in YYMD format and the time down to seconds with one decimal digit (1). Field O_HADD is created by calling the HADD function to add 2 nanoseconds to the date-time value in TRANSDT. Field O_HCNVRT is created by calling the HCNVRT function to convert the date-time value in TRANSDT to alphanumeric format. Field O_HDIFF is created by calling the HDIFF function to subtract the date-time value in TRANSDT from the date-time version in O_HADD. Field O_HDTTM is created by calling the HDTTM function to create a date-time field by taking the date from TRANSDATE_DATE and setting the time components to zero. Field O_HEXTR is created by calling the HEXTR function to extract the nanoseconds (low order three digits of nine) from TRANSDT and set the remaining components to zero. 56 IBM

57 3. January 2010 Hotfix New Features Field HGETC is created by calling the HGETC function to retrieve the current date and time and display them with 9 decimal digits for the seconds component. Note that not all operating systems return all 9 decimal digits, in which case the digits not returned display as zeros. Field O_HINPUT is created by calling the HINPUT function to convert the alphanumeric date-time string stored in field O_HCNVRT to a date-time value and display it down to the nanosecond. Field O_HMASK is created by calling the HMASK function to extract the hours, minutes, seconds, milliseconds, microseconds, and nanoseconds from O_HEXTR and take the remaining components from TRANSDT. Field O_HMIDNT is created by calling the HMIDNT function to retrieve the date from TRANSDT and set the time to midnight. Field O_HNAME is created by calling the HNAME function to retrieve the nanosecond component from TRANSDT in alphanumeric format. Field O_HPART is created by calling the HPART function to retrieve the nanosecond component from TRANSDT in numeric format. Field O_HSETPT is created by calling the HSETPT function to set the nanoseconds component to the value 28. Field O_HTIME is created by calling the HTIME function to convert the time portion of TRANSDT to the number of nanoseconds. Reference: Usage Notes for Nanosecond Date-Time Format Component ACTUAL formats for date-time fields can be up to H12. USAGE formats can be up to H23. The following date-time functions take a component name as an argument: HADD, HDIFF, HNAME, HPART, and HSETPT. The component name for nanoseconds for use in these date-time functions is nanosecond, which can also be abbreviated as ns. In addition, the HEXTR and HMASK functions have a new component, n, that represents the low order three digits of nine decimal digits. The following functions have arguments whose length depends on the precision of the date-time format: HADD, HDIFF, HINPUT, HMIDNT, HSETPT, and HTIME have a length argument. The length can be 8, 10, or 12, where 12 is needed if the seconds value has more than six decimal digits. HDTTM and HGETC have an argument for the length of the date-time value, which can be 8, 10, or 12, where 12 is needed if the seconds value has more than six decimal digits. DB2 Web Query New Features 57

58 Reporting Language Enhancements HCNVRT takes one argument that specifies the format of the date-time field to be converted to alphanumeric and one for the length of that field. The length of these arguments can be up to 23. The format for the output must be long enough to hold all of the characters returned. HTIME converts the time portion of a date-time value to nanoseconds if the first argument is 12. Excel (EXL2K Format) Style Enhancements Symbol Font Support The StyleSheet options ORIENTATION=LANDSCAPE and BORDER=ON are now supported for EXL2K report output. The BORDER attribute supports the same options as currently available for FORMAT PDF except for border options available in Adobe PDF but not available in Microsoft Excel: Border line width. Excel 2003 does not have an option for specifying a number to precisely set the border line width (thickness) in points. Borders with grooves and ridges. Excel 2003 does not have an option for specifying grooved or ridged borders. Note: FORMAT EXL2K does not support the GRID=ON parameter. Reference: Usage Notes for the Symbol Font The Symbol font is now supported for PDF, DHTML, and PPT report output. To use the Symbol font, specify font=symbol in your Web Query StyleSheet. Reference: Usage Notes for the Symbol Font Some versions of Firefox 3 do not support the Symbol font and substitute it with another font. For information about Firefox support for the Symbol font, refer to Firefox sources. The Euro character displays in PDF output because the Adobe Symbol character set includes the Euro character. The Euro character does not display in DHTML and PPT report output because the Windows Symbol character set does not include the Euro character. 58 IBM

59 3. January 2010 Hotfix New Features The following style options can be rendered with the Symbol font: DHTML and PPT support style=normal, bold, italic, and bold+italic. PDF supports only style=normal. Any other style specified in the StyleSheet will be mapped to normal. The Symbol font was added to the DHTML.FMP fontmap file. Displaying the Total Number of Pages in a Sort Group: <BYLASTPAGE How to: Display the Total Number of Pages Within Each Sort Group You can use the <BYLASTPAGE variable in a heading or footing to display the number of pages of output within each sort group when a report uses the "Create a Page Break to reset the page numbers to 1" option for each sort group. This variable can only be used with styled output formats. If the REPAGE option is not used in the report, the total number of pages in the report (<TABLASTPAGE variable) is used for <BYLASTPAGE. DB2 Web Query New Features 59

60 Reporting Language Enhancements Syntax: How to Display the Total Number of Pages Within Each Sort Group The request must be a styled format output and contain a Sort By field that has the Create a page break and reset page number to 1. The following image shows Sorting options enabled. The heading or footing can use the following syntax to display "Page x of y" {HEADING FOOTING} "Page <TABPAGENO of <BYLASTPAGE" where: sortfield Is the sort field that has the REPAGE option. A PAGE-BREAK is required on the same sort field or a lower level sort field. PAGE-BREAK starts a new page for each sort break. REPAGE resets the page number to 1 for each sort break. <TABPAGENO Is the current page number. <BYLASTPAGE Is the last page number before the repage. 60 IBM

61 3. January 2010 Hotfix New Features This can be done in Report Assistant or Power Painter. The syntax is shown in the Page footing section of the Headings tab of Report Assistant. LCWORD2: Converting a Character String to Mixed-Case How to: Convert a Character String to Mixed-Case The LCWORD2 function converts the letters in a character string to mixed-case by converting every alphanumeric character to lowercase except the first letter of each new word. If LCWORD2 encounters a lone single quotation mark, the next letter is converted to lowercase. For example, 'SMITH' would be changed to 'Smith' and JACK'S would be changed to Jack's. Syntax: How to Convert a Character String to Mixed-Case LCWORD2(length, string, outfield) where: length Integer Is the length in characters of the character string or field to be converted, or a field that contains the length. string Alphanumeric Is the character string to be converted, or a temporary field that contains the string. outfield Alphanumeric Is the name of the field that contains the result, or the format of the output value enclosed in single quotation marks. The length must be greater than or equal to the length of length. DB2 Web Query New Features 61

62 Reporting Language Enhancements Example: Converting a Character String to Mixed-Case Use the COMPUTE or DEFINE dialog in the report development tools or the Synonym Editor in Developer Workbench to perform a conversion where LCWORD2 converts the string O'CONNOR's to mixed-case: MYVAL1/A10='O'CONNOR'S'; LC2/A10 = LCWORD2(10, MYVAL1, 'A10'); The report output for these fields: MYVAL1 LC O'CONNOR'S O'Connor's DATEPATTERN in the Master File In this section: Specifying Variables in a Date Pattern Specifying Constants in a Date Pattern In some data sources, date values are stored in alphanumeric format without any particular standard, with any combination of components such as year, quarter, and month, and with any delimiter. In a sorted report, if such data is sorted alphabetically, the sequence does not make business sense. To ensure adequate sorting, aggregation, and reporting on date fields, Web Query can convert the alphanumeric dates into standard Web Query date format using a conversion pattern that you can specify in the Master File attribute called DATEPATTERN. Each element in the pattern is either a constant character which must appear in the actual input or a variable that represents a date component. You must edit the USAGE attribute in the Master File so that it accounts for the date elements in the date pattern. The maximum length of the DATEPATTERN string is 64. Specifying Variables in a Date Pattern The valid date components (variables) are year, quarter, month, day, and day of week. In the date pattern, variables are enclosed in square brackets (these brackets are not part of the input or output). Note that if the data contains brackets, you must use an escape character in the date pattern to distinguish the brackets in the data from the brackets used for enclosing variables. 62 IBM

63 3. January 2010 Hotfix New Features Syntax: How to Specify Years in a Date Pattern [YYYY] Specifies a 4-digit year. [YY] Specifies a 2-digit year. [yy] Specifies a zero-suppressed 2-digit year (for example, 8 for 2008). [by] Specifies a blank-padded 2-digit year. Syntax: How to Specify Month Numbers in a Date Pattern [MM] Specifies a 2-digit month number. [mm] Specifies a zero-suppressed month number. [bm] Specifies a blank-padded month number. Syntax: How to Specify Month Names in a Date Pattern [MON] Specifies a 3-character month name in uppercase. [mon] Specifies a 3-character month name in lowercase. [Mon] Specifies a 3-character month name in mixed-case. [MONTH] Specifies a full month name in uppercase. [month] Specifies a full month name in lowercase. DB2 Web Query New Features 63

64 Reporting Language Enhancements [Month] Specifies a full month name in mixed-case. Syntax: How to Specify Days of the Month in a Date Pattern [DD] Specifies a 2-digit day of the month. [dd] Specifies a zero-suppressed day of the month. [bd] Specifies a blank-padded day of the month. Syntax: How to Specify Julian Days in a Date Pattern [DDD] Specifies a 3-digit day of the year. [ddd] Specifies a zero-suppressed day of the year. [bdd] Specifies a blank-padded day of the year. Syntax: How to Specify Day of the Week in a Date Pattern [WD] Specifies a 1-digit day of the week. [DAY] Specifies a 3-character day name, uppercase. [day] Specifies a 3-character day name, lowercase. [Day] Specifies a 3-character day name, mixed-case. [WDAY] Specifies a full day name, uppercase. 64 IBM

65 3. January 2010 Hotfix New Features [wday] Specifies a full day name, lowercase. [Wday] Specifies a full day name, mixed-case. For the day of the week, the WEEKFIRST setting defines which day is day 1. Syntax: How to Specify Quarters in a Date Pattern [Q] Specifies a 1-digit quarter number (1, 2, 3, or 4). For a string like Q2 or Q02, use constants before [Q], for example, Q0[Q]. Specifying Constants in a Date Pattern Between the variables, you can insert any constant values. If you want to insert a character that would normally be interpreted as part of a variable, use the backslash character as an escape character. For example: Use \[ to specify a left square bracket constant character. Use \\ to specify a backslash constant character. For a single quotation mark, use two consecutive single quotation marks (''). Example: Sample Date Patterns If the date in the data source is of the form CY 2001 Q1, the DATEPATTERN attribute is: DATEPATTERN = 'CY [YYYY] Q[Q]' If the date in the data source is of the form Jan 31, 01, the DATEPATTERN attribute is: DATEPATTERN = '[Mon] [DD], [YY]' If the date in the data source is of the form APR-06, the DATEPATTERN attribute is: DATEPATTERN = '[MON]-[YY]' If the date in the data source is of the form APR - 06, the DATEPATTERN attribute is: DATEPATTERN = '[MON] - [YY]' If the date in the data source is of the form APR '06, the DATEPATTERN attribute is: DATEPATTERN = '[MON] ''[YY]' DB2 Web Query New Features 65

66 Reporting Language Enhancements If the date in the data source is of the form APR [06], the DATEPATTERN attribute is: DATEPATTERN = '[MON] \[[YY]\]' (or '[MON] \[[YY]]' Note the right square bracket does not require an escape character. Example: Sorting By an Alphanumeric Date Consider a DATE1 file containing the following data: June 1, '02 June 2, '02 June 3, '02 June 10, '02 June 11, '02 June 12, '02 June 20, '02 June 21, '02 June 22, '02 June 1, '03 June 2, '03 June 3, '03 June 10, '03 June 11, '03 June 12, '03 June 20, '03 June 21, '03 June 22, '03 June 1, '04 June 2, '04 June 3, '04 June 4, '04 June 10, '04 June 11, '04 June 12, '04 June 20, '04 June 21, '04 June 22, '04 In the DATE1 Master File, the DATE1 field has alphanumeric USAGE and ACTUAL formats, each A18: SEGMENT=FILE1, SEGTYPE=S0, $ FIELDNAME=DATE1, ALIAS=E01, USAGE=A18, ACTUAL=A18, $ 66 IBM

67 3. January 2010 Hotfix New Features A report that uses the DATE1 field as a SORT field will generate output where the alphanumeric dates are sorted alphabetically, not chronologically: DATE June 1, '02 June 1, '03 June 1, '04 June 10, '02 June 10, '03 June 10, '04 June 11, '02 June 11, '03 June 11, '04 June 12, '02 June 12, '03 June 12, '04 June 2, '02 June 2, '03 June 2, '04 June 20, '02 June 20, '03 June 20, '04 June 21, '02 June 21, '03 June 21, '04 June 22, '02 June 22, '03 June 22, '04 June 3, '02 June 3, '03 June 3, '04 June 4, '04 In order to sort the data correctly, you can add a DATEPATTERN attribute to the Master File that enables Web Query to convert the date to a Web Query date field. You must also edit the USAGE format to make it a Web Query date format. To construct the appropriate pattern, you must account for all of the components in the stored date. The alphanumeric date has the following variables and constants: Variable: full month name in mixed-case, [Month]. Constant: blank space. Variable: zero-suppressed day of the month number, [dd]. Constant: comma followed by a blank space followed by an apostrophe (coded as two apostrophes in the pattern). Variable: two-digit year, [YY]. DB2 Web Query New Features 67

68 Reporting Language Enhancements The edited Master File follows. Note the addition of the DEFCENT attribute to convert the two-digit year to a four-digit year: SEGMENT=FILE1, SEGTYPE=S0, $ FIELDNAME=DATE1, ALIAS=E01, USAGE=A18, ACTUAL=A18, DEFCENT=20, DATEPATTERN = '[Month] [dd], ''[YY]', $ Now, the same report produces the following output. Note that DATE1 has been converted to a Web Query date in MtrDYY format (as specified in the USAGE format): DATE June 1, 2002 June 2, 2002 June 3, 2002 June 10, 2002 June 11, 2002 June 12, 2002 June 20, 2002 June 21, 2002 June 22, 2002 June 1, 2003 June 2, 2003 June 3, 2003 June 10, 2003 June 11, 2003 June 12, 2003 June 20, 2003 June 21, 2003 June 22, 2003 June 1, 2004 June 2, 2004 June 3, 2004 June 4, 2004 June 10, 2004 June 11, 2004 June 12, 2004 June 20, 2004 June 21, 2004 June 22, IBM

69 3. January 2010 Hotfix New Features Storing the Number of Repetitions of a Repeating Field in a Virtual Field How to: Specify an OCCURS Segment Using a Virtual Field Reference: Usage Notes for Using a Virtual Field With OCCURS The OCCURS attribute in a Master File describes repeating fields or groups of fields. The repeating group of fields is described as a descendent segment in the Master File, and the OCCURS attribute for that segment specifies how to determine the number of repetitions. The number of repetitions does not have to be the same for every record instance. Sometimes, the number of repetitions can be derived from a field in the data source. In that case, you can create a virtual field in the Master File that indicates the number of repetitions for each record and use that virtual field as the value of the OCCURS attribute. Syntax: How to Specify an OCCURS Segment Using a Virtual Field Use the Developer Workbench Synonym Editor to make the following types of edits. SEGNAME = parent, SEGTYPE = segtype,$... DEFINE definefield/in = expression; SEGNAME = osegname, SEGTYPE=S0, PARENT = parent, OCCURS = definefield,$ FIELDNAME = rfield, ALIAS = ralias, USAGE = rufmt, ACTUAL = rafmt,$... [FIELDNAME = orderfield, ALIAS = ORDER, USAGE = In, ACTUAL = I4,$] where: parent Is the name of the parent segment. segtype Is the SEGTYPE of the parent segment. DB2 Web Query New Features 69

70 Reporting Language Enhancements definefield In Is the virtual field that indicates the number of repetitions of the repeating field or group of fields. This field must be defined in a segment that is an ancestor of the segment containing the repeating fields. Is the format of the virtual field that describes the number of repetitions. It must be an integer format. expression Is a valid expression that derives the number of repetitions for each record instance. osegname Is the name of the descendent OCCURS segment. rfield Is the name of a repeating field in the OCCURS segment. ralias rufmt rafmt Is the alias of a repeating field in the OCCURS segment. Is the display format for a repeating field in the OCCURS segment. Is the actual format for a repeating field in the OCCURS segment. orderfield Is the name of an internal counter field that you can specify as the last field in the OCCURS segment. The ORDER field associates a sequence number with each occurrence and is useful when the order of the repeating data is significant. For example, the values may represent monthly or quarterly data, but the record itself may not explicitly specify the month or quarter to which the data applies. The USAGE format must be integer and the ACTUAL format is I4. Reference: Usage Notes for Using a Virtual Field With OCCURS The virtual field used as the OCCURS value cannot be redefined inside or outside of the Master File. 70 IBM

71 3. January 2010 Hotfix New Features Browser Certification In this section: Microsoft Internet Explorer Version 8 Certification Firefox Version Certification This section describes new features for browser certification. Microsoft Internet Explorer Version 8 Certification Web Query applications, Managed Reporting Dashboard, OLAP, and other end-user features are certified with Microsoft Internet Explorer Version 8. Developer Workbench is also certified with Microsoft Internet Explorer Version 8. Firefox Version Certification Web Query applications, Managed Reporting Dashboard, OLAP, and other end-user features are certified with Firefox Version Upgrade Considerations In this section: DB2 Web Query Administration Console Power Painter Developer Workbench Graph Assistant These topics provice upgrade considerations and product changes for DB2 Web Query January 2010 Hotfix. DB2 Web Query Administration Console You must have administrator privileges to view traces in the Administration Console. When a user that does not have administrator privileges selects the All Clients section under the Diagnostics menu, the following message displays: Failure, User has to be an ADMINISTRATOR DB2 Web Query New Features 71

72 Upgrade Considerations Power Painter As of January 2010 Hotfix, Power Painter requires Firefox Version DB2 Web Query for the October 2009 Hotfix and earlier support Firefox Version 2.0 and Version 1.5. Developer Workbench Graph Assistant The following lists product changes for HTML Composer. When adding a chained input control in the HTML Composer, the Default Visibility option has been removed from the Properties tab. The default visibility is based on the conditions of the chained parameters. When creating a static list of values for a double list control in the HTML Composer, the add everything value option is not available. When adding a dynamic calendar in the HTML Composer, you can set the calendar properties through the Parameters tab. Developer Workbench Options The "Store data as ANSI" option has been removed from the General tab of the Developer Workbench Options dialog box. To access the Options dialog box, choose Options from the Window menu in Developer Workbench. Markers have been removed for Area charts. They are only useful on a Line chart. 72 IBM

73 IBM October 2009 Hotfix New 4 Features This document describes the Web Query new features for the October 2009 Hotfix. All new features described in this document are available to end users, developers, and administrators unless otherwise noted. Topics: Web Query Enhancements Report Assistant Enhancements DB2 Web Query New Features 73

74 Web Query Enhancements Web Query Enhancements In this section: Run with SQL Trace Option with Enhanced Detail This section describes new features for Web Query. Run with SQL Trace Option with Enhanced Detail The Run with SQL Trace option includes additional informational messages that provide more detail on what SQL passes through to the database engine. For example, if your procedure contains a JOIN, the trace shows if the database engine received the JOIN or if the Web Query engine performed the JOIN. Also, the trace explains why the selected method was chosen. Report Assistant Enhancements In this section: Displaying Repeated Sort Values in Report Assistant This section describes new features for Report Assistant. Displaying Repeated Sort Values in Report Assistant How to: Display Repeated Sort Values in Report Assistant The Display all sort values option is available as a global setting from the Report options tab in Report Assistant. This option enables you to display the repeated sort values and to prevent discontinuous data in a report. This is recommended for use with Excel Named Ranges. Procedure: How to Display Repeated Sort Values in Report Assistant 1. Click the Font and Settings button from the Global report styling section of the Report options tab. 74 IBM

75 4. October 2009 Hotfix New Features The WebFOCUS styles dialog box opens. 2. Select the Display all sort values check box under the Global Settings section. 3. Click OK to close the WebFOCUS styles dialog box. DB2 Web Query New Features 75

76 Report Assistant Enhancements 76 IBM

77 IBM 5 July 2009 Hotfix New Features This document describes the Web Query new features for the July 2009 Hotfix. All new features described in this document are available to end users, developers, and administrators unless otherwise noted. Topics: Report Development Tools Enhancements Spreadsheet Client Enhancements DB2 Web Query Adapter for Microsoft SQL Server DB2 Web Query New Features 77

78 Report Development Tools Enhancements Report Development Tools Enhancements In this section: DB2 Output Format Hold File Support for Domain Application Path Setting This section describes new features for Report Development Tools. DB2 Output Format Hold File Support for Domain Application Path Setting Report Assistant creates reports in DB2 format. When you select DB2 format, Report Assistant generates a temporary hold file. In previous releases, Report Assistant generated the hold file in the baseapp folder. In this release, Report Assistant respects a Domain's application path setting and generates the hold file. Spreadsheet Client Enhancements Configuration File In this section: Configuration File Support for Synonyms Outside of the baseapp Folder This section describes new features for the Web Query Spreadsheet Client. DB2 Web Query Spreadsheet Client is a Microsoft Office add-in that enables you to connect Microsoft Excel directly to Web Query reporting tools where you can access and analyze your data on IBM i. When you connect Excel to the Web Query reporting engine, Spreadsheet Client leverages all the available adapters to Web Query. The Spreadsheet Client Add-in has a new configuration file, wqsclient.cfg. It is a template for the administrator to design a default Web Query environment for Spreadsheet Client users. Support for Synonyms Outside of the baseapp Folder The Web Query Domain that stores Structured Ad hoc Forms now supports synonyms outside of the baseapp folder. Synonyms found in the Domain's application path are available to the Spreadsheet Client when you use the Report Assistant method to populate your spreadsheet with data. Note that you must enable the Domain's application path property to take advantage of this feature. 78 IBM

79 5. July 2009 Hotfix New Features DB2 Web Query Adapter for Microsoft SQL Server The DB2 Web Query Adapter for Microsoft SQL Server allows applications to access Microsoft SQL Server data sources. The adapter converts data or application requests into native Microsoft SQL Server statements and returns optimized answer sets to the requesting program. DB2 Web Query New Features 79

80 DB2 Web Query Adapter for Microsoft SQL Server 80 IBM

81 IBM 6 May 2009 Hotfix New Features This document describes the Web Query new features for the May 2009 Hotfix. All new features described in this document are available to end users, developers, and administrators unless otherwise noted. Topics: Report Broker Enhancements Active Reports Enhancements Adapter Enhancements Spreadsheet Client Enhancements OLAP Enhancements DB2 Web Query New Features 81

82 Report Broker Enhancements Report Broker Enhancements In this section: Bursting With Wildcards, Java Regular Expressions, and Default Distribution Report Broker is a scheduling and distribution application that centralizes the execution and distribution of Web Query reports, the contents of URLs, and files. Report Broker supports multiple administrators and provides a single point of control for managing information distribution within an organization. Bursting With Wildcards, Java Regular Expressions, and Default Distribution Bursting enables you to target relevant sections of a report to individual users. Each report section is saved as a separate file. If you are distributing a burst tabular report, the first BY field detemines the burst value. If you are distributing a burst graph report, the second BY field determines the second burst value. When you burst a report, you can use wildcards and Java regular expressions in the burst value. Each occurrence of a wildcard or Java regular expression in a burst value must be preceded by a keyword, as noted in the following rules: Wildcard Characters. Use an asterisk (*) to represent one or more characters, and a question mark (?) to represent a single character. These can be placed at the beginning, end, or middle of the burst value. Precede each instance of a burst value that uses a wildcard with the wildcard keyword enclosed in brackets followed by a colon, [wildcard]:, as shown in the following example: [wildcard]:a?c* = all values that start with 'a' and have a 'c' as the third character. Java Regular Expressions. Use to identify a string of text. Precede each instance of a burst value using a Java regular expression with the regular expression keyword enclosed in brackets followed by a colon, [regexp]:, as shown in the following example: [regexp]:[bcr]at = values that are bat, cat, or rat. You can provide a default destination for any burst values that are not specified in the Distribution List using the [elsesend]: keyword. Consider the following distribution list. Burst Value [wildcard]:*an* England Address sml@company.com apt@company.com 82 IBM

83 6. May 2009 Hotfix New Features Burst Value [elsesend]: Address If a report is burst on a Country field that contains values of Germany, USA, France, Canada, Italy, Chile, England, and Japan, then: report information for Germany, France, Canada, England, and Japan will be delivered to sml@company.com report information for England will be delivered to apt@company.com report information for USA, Italy, and Chile will be delivered to jt@company.com Active Reports Enhancements In this section: Printing Active Reports Data Using the Grid Tool Using the Chart/Rollup Tool Using the Pivot Tool Filtering Selections Using Multiple Values By Sort Field Values Appearing on Every Page Web Query Active Reports combines data and interactive controls to deliver completely portable business intelligence in a disconnected environment that requires no software. Active Cache speeds analysis of large data sets by making the first few pages of Active Reports available while the data is still being handled by the Reporting Server. Printing Active Reports Data How to: Print Active Reports Data Select an option to print all records, or filtered records, for Active Reports. Procedure: How to Print Active Reports Data 1. Click the arrow in any column heading and select Print. DB2 Web Query New Features 83

84 Active Reports Enhancements Using the Grid Tool You can print All records or Filtered only. Select All records to open an HTML-formatted page, showing all records, in a new browser window. Select Filtered only to open an HTML-formatted page, showing filtered data, in a new browser window. Tip: Click the arrow in any column heading and select Filter to filter data. The print dialog menu automatically appears when selecting a print option from Active Reports. The data is sent to the printer. How to: Use the Grid Tool Reference: Grid Tool Usage Notes The Grid Tool enables you to change the column order, select multiple columns to sort ascending or descending, hide and show columns, add a calculation result to a column, and add subtotals in Active Reports. 84 IBM

85 6. May 2009 Hotfix New Features Procedure: How to Use the Grid Tool 1. Run the Active Reports, click the arrow in any column heading, and select Grid Tool. The Grid Tool opens as shown in the following image. The columns are displayed in the order that they appear in the Active Reports. Tip: To reorder the list left-click and drag the columns in the Column Order section. 2. To hide/show columns, click the Hide Column icon next to the column name. Note: By default, the Grid Tool displays Hide icons for the hidden fields (HIDE=ON StyleSheet setting) and NOPRINT fields in the procedure. The Grid Tool displays Show icons for anything else. DB2 Web Query New Features 85

86 Active Reports Enhancements 3. To add a calculated result to the column, click the calculation icon next to the column name. You can assign different calculation results for each field. Note: There are no calculations set by default. Sum, Avg, Min, Max, Count, or Distinct are available for numeric fields. Min, Max, Count, or Distinct are available for Date type fields. Count or Distinct are available for non-numeric alpha string fields. None indicates that there will be no aggregation performed or applied for the column in the report. When None is selected, Detail appears next to the calculation icon, implying that the report will display detailed data for this column in the report. 4. Left-click and drag the columns from the Column Order into the Sort Order section. Alternatively, double-click to add columns. Note: When columns are added to the Sort Order section, options for sorting ascending or descending appear. The default sort order is ascending, lowest to highest (A to Z). Click the sort order icon to switch to descending, highest to lowest (Z to A). In the following example, COUNTRY is descending and CAR is ascending. 5. Edit sort fields by clicking the X icon to delete columns, dragging multiple columns into the Sort Order section, reordering the sort fields, and grouping sort columns. 6. Click Group sort columns to group the report by columns in the Sort Order section. A Subtotal column appears in the Sort Order section. No subtotals are selected by default. 86 IBM

87 6. May 2009 Hotfix New Features Note: When Group sort columns is selected, the columns in the report are grouped by the order specified in the Sort Order section. These columns are repositioned to the beginning of the report and override the Column Order list. 7. To add a subtotal for an aggregated column: Select the Subtotal check box next to the column name. Click Group sort columns again to hide the Subtotal column. In the following example, MODEL and SEATS are hidden, DEALER_COST and RETAIL_COST have a Sum aggregation type, COUNTRY, CAR, MODEL, and SEATS appear in the Sort Order column, Group sort columns is selected, and Subtotal is applied to CAR. 8. Click OK to close the Grid Tool. The Active Report is generated based on the sort fields selected. DB2 Web Query New Features 87

88 Active Reports Enhancements Note: In the following example, the subtotal of sum values appear under DEALER_COST and RETAIL_COST by the CAR field. Select Grid Tool from the column menu to open the Grid Tool again. Reference: Grid Tool Usage Notes The same column can appear in both the Column Order and Sort Order section. Column Order displays the order of how columns appear in the report, unless Group sort columns is selected. The Sort Order list overrides the Column Order if Group sort columns is selected. The Column Order and Sort Order sections can contain field names in a different order, as long as Group sort columns is not selected. Columns can be dragged from Column Order to Sort Order but they cannot be dragged from Sort Order to Column Order. 88 IBM

89 6. May 2009 Hotfix New Features Sort ascending is the default sort order, when columns are added to the Sort Order section. There are no calculations set by default. Sum, Avg, Min, Max, Count, or Distinct are available for numeric fields. Min, Max, Count, or Distinct are available for Date type fields. Count or Distinct are available for non-numeric alpha string fields. None indicates that there will be no aggregation performed or applied for the column in the report. When the Subtotal option is selected and an aggregation type is selected in the Column Order, subtotals display by the corresponding sort field (for the fields that have calculations specified). Total plus the aggregation type (Cnt, Sum, and so on), appear with the column in the report output when Subtotal is selected. Once Group sort columns is selected, deselect you may not add additional columns to Sort Order. To add additional columns deselect Group sort columns. If a column is hidden and appears in the Sort Order section, the subtotal value will also be hidden if Group sort columns is selected. When a filter is applied to the report, the subtotal will display the filtered value. The Active Report Sort Ascending and Sort Descending menus will override the options set in the Sort Order section of the Grid Tool. The subtotal background color and font color can be changed by using the CALC-AREA object in the STYLE section of the procedure. For example: TYPE=REPORT,OBJECT=CALC-AREA,COLOR=WHITE,BACKCOLOR=BLACK,$ The font style for the subtotal values can be changed by using the TITLE type in the STYLE section of the procedure. For example: TYPE=TITLE,FONT='GEORGIA',COLOR=RGB( ),$ DB2 Web Query New Features 89

90 Active Reports Enhancements Using the Chart/Rollup Tool How to: Use the Chart/Rollup Tool Reference: Chart/Rollup Tool Usage Notes The Chart/Rollup Tool enables you to select multiple group fields in the Chart or Rollup Table generated. The Chart/Rollup Tool contains a list of columns available in the Active Report and Group By and Measure sort fields. Click and drag the columns into the desired sort field. Procedure: How to Use the Chart/Rollup Tool 1. Run the Active Report, click the arrow in any column heading, and select Chart/Rollup Tool. The Chart/Rollup Tool opens as shown in the following image. 2. Left-click and drag the columns into the Group By and Measure sort fields. Note: For charts, Group By is the column(s) used for the X-axis and Measure is the column(s) used for the Y-axis. 3. Edit sort fields by clicking the X icon to delete columns, dragging multiple columns into the Group By and Measure sort fields, reordering the sort fields, and changing the aggregation type of the Measure by clicking on the calculation icon. 90 IBM

91 6. May 2009 Hotfix New Features 4. Select the Line, Pie, Bar, Scatter, or Rollup icon. Note: Pie chart is selected by default. In the following example, CAR and MODEL are the Group By sort fields, DEALER_COST and RETAIL_COST are the Measure fields, and Line chart is selected. 5. Click OK to close the Chart/Rollup Tool. The Chart or Rollup Table is generated based on the sort fields selected. To open the Chart/Rollup Tool again, click the New icon from the Chart or Rollup Table and select Chart/Rollup Tool. DB2 Web Query New Features 91

92 Active Reports Enhancements Reference: Chart/Rollup Tool Usage Notes The following apply when using the Chart/Rollup Tool in Active Reports: The Group By and Measure sort fields are required. You may use multiple Group By and Measure sort fields. Group By is the column(s) used for the X-axis and Measure is the column(s) used for the Y-axis. Use only one Measure sort field (as the Y-axis) when using a Pie chart. The same column can appear in both the Group By and Measure sort field. Columns can be dragged between the Group By and Measure sections but they cannot be dragged back to the Columns section. The Measure sort field displays Sum for numeric fields and Count for non-numeric fields by default. Headings for the chart are generated using the field name, or column title name. The report HEADING is inherited only if REPORT-VIEW=CHART is set in the Web Query procedure. When using the Chart/Rollup Tool with hidden fields (HIDE=ON StyleSheet setting), the hidden columns will not be displayed in the Rollup Table. To display the hidden columns in the Rollup Table generated, select Show Columns from the Active Report menu and select the column name you want to display. Using the Pivot Tool How to: Use the Pivot Tool Reference: Pivot Tool Usage Notes By default, a Pivot Table groups the selected column as the vertical sort field and the selected row as the horizontal sort field. The Pivot Tool enables you to select multiple group fields in the Pivot Table generated. Note: Pivot Tables reorganize and summarize selected columns and rows of data in order to obtain a desired report. The Pivot Tool contains a list of columns available in the Active Report and Group By, Across, and Measure sort fields. Click and drag the columns into the desired sort field. 92 IBM

93 6. May 2009 Hotfix New Features Procedure: How to Use the Pivot Tool 1. Run the Active Report, click the arrow in any column heading, and select Pivot Tool. The Pivot Tool opens as shown in the following image. 2. Left-click and drag the columns into the Group By, Across, and Measure sort fields. Note: A column must be included for the Group By and Measure sort fields (Measures typically define how much or how many). The Across sort field is optional. In the following example, CATEGORY and RATING are the Group By sort fields, COPIES is the Across sort field, and WHOLESALEPR is the Measure field. 3. Edit sort fields by clicking the X icon to delete columns, dragging multiple columns into the Group By or Across sort fields, reordering the columns in the sort fields, and changing the aggregation type of the Measure by clicking on the calculation icon. Note: You may not use multiple Measures. 4. Click OK to close the Pivot Tool. DB2 Web Query New Features 93

94 Active Reports Enhancements The Pivot Table is generated based on the sort fields selected. To open the Pivot Tool again click the New icon from the Pivot Table and select Pivot Tool. Reference: Pivot Tool Usage Notes The following apply when using the Pivot Tool in Active Reports: The Group By and Measure sort fields are required. You may not use multiple Measures. The same column cannot appear in both the Group By and Across sort field. Columns can be dragged between the Group By, Across, and Measure sections but they cannot be dragged back to the Columns section. If a column already exists in the Measure sort field, an additional column that is dropped into the Measures section will replace the existing column. The Measure sort field displays Sum for numeric fields and Count for non-numeric fields by default. 94 IBM

95 6. May 2009 Hotfix New Features Filtering Selections Using Multiple Values How to: Filter Selections Using Multiple Values When selecting a value in the Filter Selection dialog box, a value selection dialog box displays if there are over 20 data values. Additionally, when item(s) are selected in the value selection dialog box, the item is highlighted and checked to indicate the selection. Procedure: How to Filter Selections Using Multiple Values Note: While the value selection dialog box appears for both alphanumeric and numeric data, indicated selections only appear for alphanumeric data. 1. Click the arrow in the heading of the column you want to filter on. Click Filter and then the operation. The Filter Selection dialog box opens. 2. Enter a value or values, depending on the operation you select. Values are entered either by typing a value in a text box or selecting a value from a dropdown list. Note: If there are over 20 data values for the column, a value selection dialog box appears as shown in the following image. 3. Select a value or value(s) in the value selection dialog box. DB2 Web Query New Features 95

96 Active Reports Enhancements The item(s) selected are highlighted and checked, as shown in the following image. Note: While the value selection dialog box appears for both alphanumeric and numeric data, indicated selections only appear for alphanumeric data. 4. Close the value selection dialog box to add your selections to the Filter Selection dialog box. 5. Click Filter to apply the filter to the report. By Sort Field Values Appearing on Every Page When running an Active Report, the By sort field value appears on each new page in the report until the By sort field changes, as it does when using the HTML report output. 96 IBM

97 6. May 2009 Hotfix New Features In the following example, the By sort field (East North Central) appears on each new page in the report until the By sort field changes. The image shows page 35 of 174, with East North Central as the By sort field for Region. Adapter Enhancements In this section: Increased Number of Joins Supported for SQL Adapters This section describes new adapter features. The server supports adapters designed to access a wide variety of data sources. Increased Number of Joins Supported for SQL Adapters The maximum number of joins that can be optimized by an SQL adapter has been increased to 64, or to the maximum number permitted by each RDBMS, up to the 64 join limit. DB2 Web Query New Features 97

98 Spreadsheet Client Enhancements Spreadsheet Client Enhancements In this section: Spreadsheet Client License Check This section describes new features for the Web Query Spreadsheet Client. DB2 Web Query Spreadsheet Client is a Microsoft Office add-in that enables you to connect Microsoft Excel directly to Web Query reporting tools where you can access and analyze your data on IBM i. Connecting Excel to the Web Query reporting engine allows Spreadsheet Client to leverage all the available adapters to Web Query. Spreadsheet Client License Check The Spreadsheet Client will now perform a license check against the IBM i License Manager. A DB2 Web Query Spreadsheet Client 5733QU2 V1R1M license must exist in order to use the Spreadsheet Client. OLAP Enhancements In this section: Increased Limit of Entries in an OLAP Drop Down This section describes new features for OLAP enhancements. OLAP enables you to drill down or roll up on hierarchical data, pivot fields from columns to rows (or vice versa), and sliceand-dice information by filtering or querying data sources based on specified criteria thresholds. Increased Limit of Entries in an OLAP Drop Down The limit of entries in an OLAP drop down is now IBM

99 IBM 7 March 2009 Hotfix New Features This document describes the Web Query new features for the March 2009 Hotfix. All new features described in this document are available to end users, developers, and administrators unless otherwise noted. Topics: Metadata Tool Enhancements Report Broker Enhancements DB2 Web Query New Features 99

100 Metadata Tool Enhancements Metadata Tool Enhancements In this section: Metadata Automatically Created in the First Folder of Domain's Application Path This section describes that metadata is created automatically in the first folder of domain's application path. Metadata Automatically Created in the First Folder of Domain's Application Path The January 2009 Hotfix introduced a number of features that provided enhanced metadata management through the Developer Workbench. One of these features allows a Domain to contain an Application Path that can be customized by a Web Query administrator (see the January 2009 Hotfix Developer Workbench New Features section of this documentation for more information on these new features). If a Domain's Application Path feature has been enabled, the Web Query Metadata Tool will automatically create synonyms in the first folder of the application path definition. If a Synonym must be created in a different folder, the Developer Workbench must be used. Report Broker Enhancements In this section: Report Broker and i5 Support for Authenticated SMTP Limitation of Formats for Reports This section describes two new features: support for authenticated SMTP and a limitation of formats for reports. Report Broker and i5 Support for Authenticated SMTP Report Broker is including support for Simple Mail Transfer Protocol (SMTP). SMTP is the standard for transferring across the internet from Server SMTP to Client SMTP, or from one mail system to another mail system. SMTP is not involved if an is sent locally. Authentication has added two new settings to the Web Query Administration Console, as follows: SMTP User specifies the user ID for SMTP authentication. SMTP Password specifies the password associated with the SMTP User ID for SMTP authentication. 100 IBM

101 7. March 2009 Hotfix New Features Limitation of Formats for Reports When scheduling a chart or graph report, the available formats will depend on which tool was used to create the report. When the report was created using: Graph Assistant, then the available formats are PDF, JPEG, PNG, and SVG. Report Assistant, then the available formats are AHTML, DHTML, DOC, EXL2K, HTML, PDF, PS, and WP. Power Painter, then the available formats are AHTML, DHTML, EXL2K, and PDF. DB2 Web Query New Features 101

102 Report Broker Enhancements 102 IBM

103 IBM 8 January 2009 Hotfix New Features This document describes the Web Query new features for the January 2009 Hotfix. All new features described in this document are available to end users, developers, and administrators unless otherwise noted. Topics: Developer Workbench Enhancements Administration Console DB2 Web Query New Features 103

104 Developer Workbench Enhancements Developer Workbench Enhancements In this section: New Applications Folder Under Managed Reporting Enhanced Domain Properties Dialog Box This section describes two new features: applications folder under Managed Reporting and the enhanced domain's Properties dialog box for managing metadata. New Applications Folder Under Managed Reporting The DB2 Web Query Environments area contains sub-areas for the Data Servers and Managed Reporting environments. A developer can only see the Managed Reporting environment from which a developer or administrator can perform both development and administrative tasks. Developers will typically build and test procedures and Web pages that launch those procedures. Developers and administrators can also manage synonyms from here as well with this release of Developer Workbench. Administrators will manage the Domains properties, e.g., modifying the application path. In this image, the Managed Reporting node is expanded to show the Applications folders in its working environment. 104 IBM

105 8. January 2009 Hotfix New Features The Applications folder is a new addition to a domain's existing two folders, Reports and Other Files. Within the Applications folder, developers can create, modify, and delete synonyms. A developer no longer has access to the Data Server environment. The combination of these features provides a number of benefits to a Web Query deployment: Enhanced security since a developer is now restricted to managing only those synonyms within the Domain to which they belong. Previously, a developer would be able to access all synonyms across all Application Folders under the Data Server Environment. Independent Software Vendors (ISVs) who plan on packaging an application for Web Query can deliver their entire application, i.e., procedures and metadata, within a single Domain. In addition, the Domain property, Do Not Show on User's List, can be used to prevent a domain from being displayed on the Web Query User Interface. These features will make Web Query metadata and application deployment a more manageable task. DB2 Web Query New Features 105

106 Developer Workbench Enhancements Enhanced Domain Properties Dialog Box Developer Workbench has been enhanced to provide greater flexibility in managing metadata in a Web Query deployment. A Domain can now have more than one Applications folder associated with it. The administrator has the ability to create new application folders and make them available to a Domain by using the Domain Properties dialog box. Right-click a Domain and select the Properties option to display the domain Properties dialog box. The following image shows the NYCSALES properties. 106 IBM

107 8. January 2009 Hotfix New Features By default, the baseapp folder is always searched, unless it is deleted. Baseapp is a folder that contains synonyms that are shared across all Domains. Application folders can be added to a Domain by selecting the application folder from the Available list, and clicking the right arrow to move it to the Selected list. Once an application folder appears in the Selected list, all users that have access to this Domain will be able to access the synonyms in those respective application folders. Use the Up and Down arrows to control which application folders are searched first for metadata. If a synonym with the same name resides in more than one application folder, the one that is highest in the list will be used. For example, if a synonym called NYQ1Sales resided in both the ibinccen and baseapp folders, the version in ibinccen would be used. Administration Console In this section: Accessing the DB2 Web Query Administration Console This section describes the new feature, Clear Cache, available in the Administration Console. Accessing the DB2 WebQuery Administration Console You can access the DB2 Web Query Administration Console in one of the following ways: Enter the following URL where: hostname[:port] Is the host name and optional port number (specified only if you are not using the default port number) where the DB2 Web Query Web application is deployed. webquery_html Is the site-customized context root for the Web application deployed on your Application Server (webquery_html is the default value). DB2 Web Query New Features 107

108 Administration Console The logon screen opens where you can specify a valid user ID and password. The JSP Compiling Test verifies that the application server on which DB2 Web Query is installed can compile JavaServer Pages (JSP) using JDK Version 1.5. This ensures that application servers that require earlier versions than JDK 1.6 can compile and run all DB2 Web Query JSPs. To use the DB2 Web Query Administration Console to update DB2 Web Query Client configuration settings, click one of the categories in the menu at the left side of the screen (for example, Configuration). You can also click any of the following options located on the right side, along the top of the screen: Install Info. Displays information about the version of DB2 Web Query you are using and the installed and licensed product components. The following parameters appear: 108 IBM

109 8. January 2009 Hotfix New Features Product Release. Version and Release. Service Pack. Service pack. Build Version. Track version. Build/GEN Number. Specific DB2 Web Query build number. Build/GEN Date. Date and time the build number was generated. Application Server. Application Server and version number which Web Query is deployed against. Clear Cache. Clears your memory cache, which contains information that gets processed with every DB2 Web Query Servlet request. This includes DB2 Web Query script and configuration files, and the default Managed Reporting Driver cache. By clearing the cache, it fully revokes the Report Broker scheduling privileges from a user. This should be done after the MRSCHEDULE group profile is removed from a user. Login As. Redirects you to the DB2 Web Query Administration Console logon screen. Logout. Logs you off the DB2 Web Query Administration Console. Help. Opens the online help file. DB2 Web Query New Features 109

110 Administration Console 110 IBM

111 IBM 9 V1M1R1 New Features This document describes the Web Query new features for V1M1R1. All new features described in this document are available to end users, developers, and administrators unless otherwise noted. Online help is available within the Web Query product. Topics: Developer Workbench Enhancements Web Query Development Tools Enhancements Web Query Administration Enhancements Adapter Enhancements DB2 Web Query New Features 111

112 Developer Workbench Enhancements Developer Workbench Enhancements In this section: Creating a New Application Folder Do Not Show on User s List Domain Property Tab Control Enhancements Entering Masked Text in HTML Layout Painter Formatting Text Elements Creating Active Dashboards in HTML Layout Painter Adding Schedule Capability in HTML Layout Painter Adding a Tab Control to the Layout in HTML Layout Painter Setting Default Values in HTML Layout Painter Adding Comments to HTML Active Report Output This section describes the new features for Developer Workbench. Creating a New Application Folder How to: Open a New Application Developer Workbench has been enhanced to allow a developer or administrator to create a new application folder on the Web Query Data Server. Web Query metadata can be segregated into different application folders to narrow the scope of metadata seen in each domain. Procedure: How to Open a New Application 1. Expand Data Servers or Web Applications. 2. Expand a server, for example, EDASERVE. 112 IBM

113 9. V1M1R1 New Features 3. Right-click Applications and select New Application as shown in the illustration below. 4. Type the name of your new application, for example, salesapp, and click OK. Do Not Show on User s List Domain Property How to: Set Domain Properties A new Domain property, Do Not Show on User's List, has been added to allow a developer or administrator to restrict a domain from being seen by Web Query Basic and Run-Time Enabled users. This feature is useful for a developer or administrator who does not want to expose a domain until all the reports, graphs, and HTML content is ready for deployment. It can also be used by an ISV who wishes to deploy an SDK-based application, but not through the Web Query user interface. DB2 Web Query New Features 113

114 Developer Workbench Enhancements Procedure: How to Set Domain Properties 1. Right-click the domain for which you want to set properties and select Properties. The Domain Properties dialog box opens. The following image shows the Properties dialog box for a domain named NYCSALES. Notice that the Application Path property has been set to a application folder salesapp, which was created using the New Application folder feature. Also notice that the new Do not show on User's List property has been turned on. This will prevent Web Query Basic and Run-Time Enabled users from seeing the NYCSALES domain. Web Query developers and administrators will see the NYCSALES domain. 2. If you are a developer or administrator, you can make changes to any of the properties. 3. Click OK to set the new properties. Click Cancel to retain the original properties. Note: Domain properties can be set or reset at any time. Care must be taken so that any change you make does not adversely affect the behavior of existing reports. For example, if you change the server or application path settings in the domain properties, all reports and reporting objects in that domain inherit these changes when you click OK. 114 IBM

115 9. V1M1R1 New Features Tab Control Enhancements How to: Enable Full Screen Mode for the Tab Control Modify the Size, Appearance, and Location of the Tabs Use the Tab Item Background Properties Field The tab control options in the HTML Layout Painter have been enhanced so that you may resize the tab control to fit the full screen of your layout, change the default size of the tab labels, change the appearance of the tabs, and change the location of the tab items on the tab control. You may also add background images to tab items. Procedure: How to Enable Full Screen Mode for the Tab Control You may resize the tab control to fit the full screen of your layout, making the tab control the full background of your browser window at run time. When set to full screen mode, scroll bars will not be applied to the output window. Therefore, you may have to adjust the tab control (and any items on the tab) in the layout to ensure that they appear appropriately for display at run time. Note: It is recommended to set the tab control to full screen mode at the beginning of the development process. If there are existing components on the layout that are not part of the tab control, these components will become inaccessible if the tab control is changed to full screen mode. 1. Select tab control from the Insert menu. The cursor changes into a crosshair. 2. Click and drag the crosshair in the layout to create the tab control object. 3. Right-click the tab control and select Full screen mode from the context menu, as shown in the following image. DB2 Web Query New Features 115

116 Developer Workbench Enhancements The tab control displays as a full screen in the layout, as shown in the following image. Note: This setting can be applied only to one tab control in your application. If one tab control is set to full screen mode, the full screen mode item will be greyed out for any additional tab controls. 4. To resize the tab control, right-click and uncheck the Full screen mode option from the context menu. 116 IBM

117 9. V1M1R1 New Features Procedure: How to Modify the Size, Appearance, and Location of the Tabs When the tab control is selected, you may change the default size of the tab labels, the appearance of the tabs, and the location of the tab items on the tab control. Note: These properties are available from the Properties tab of the Properties window when the tab control is selected. The tab control appears as tab(n) in the Properties window dropdown list. 1. To change the default size of the tab labels, adjust the Tab: default distance, Tab: default height, and Tab: default width properties. 2. To change the appearance of the tabs, select Straight or Round from the Tab: edges properties field. Note: The default tab edge is Straight. 3. To change the location of the tab items on the tab control, select Top, Bottom, Left, or Right from the Tab: location properties field. Note: The default tab location is Top. If the tab location is changed, any background images applied to the tabs will not be rotated. You will have to reinsert a different image that is rotated appropriately. Procedure: How to Use the Tab Item Background Properties Field In addition to using the Style Composer, you can add background images to tab items by using the Background properties field. The Background properties field is available from the Properties tab of the Properties window when the tab item is selected. The tab item appears as tabitem(n) in the Properties window drop-down list. 1. Select the tab item in the layout, or click the tabitem(n) property from the Properties window drop-down list. 2. Click the Background ellipse button from the tab item properties window. DB2 Web Query New Features 117

118 Developer Workbench Enhancements The Get source file dialog box opens, as shown in the following image. 3. Select a file name and click Open. The background image is added to the tab item. Note: You may have to manually resize the tab item to fit the image. Tip: If the tab location is changed (from Top to Left, for example), any background images applied to the tabs will not be rotated. You will have to reinsert a different image that is rotated appropriately. Entering Masked Text in HTML Layout Painter How to: Enter Masked Data in a Text Box In HTML Layout Painter, when entering a value in a text box at run time, you may set the mask text property so that the text is not displayed as text, but masked by default characters. This is recommended when using passwords or other sensitive information. Procedure: How to Enter Masked Data in a Text Box 1. Select the Text Box object to view the associated properties. 118 IBM

119 9. V1M1R1 New Features You may also select the text box properties from the drop-down list of the Properties window. The text box appears as edit(n) <INPUT> as shown in the following image. 2. From the Mask text property field, select Yes. 3. Run the report and type a value in the text box. The value being entered appears as masked text, as shown in the following image. DB2 Web Query New Features 119

120 Developer Workbench Enhancements Formatting Text Elements How to: Apply Various Formatting in a Text Element Apply Formatting to an Entire Text Element Align Text Within the Text Element The text formatting options in the HTML Layout Painter have been enhanced so that you may format individual text elements and style entire strings of text, words, or individual characters. You may format individual pieces of text by using the Bold, Italic, Underline, Superscript, and Font Style options. If the entire text element is selected, Font Style and Alignment options are available. Procedure: How to Apply Various Formatting in a Text Element You may apply various formatting and style options to words and individual text characters within the text element. To apply formatting to a text element: 1. Add a text element to the page. Select Text from the Insert menu. or Select the text icon The cursor changes into a crosshair. from the Components toolbar. 2. Click and drag the crosshair to create the text element on the page and adjust it to the size you want. Double-click, or highlight and single-click the text element, to go into edit mode. 3. Type text in the text element. Note: Line breaks can be set by using the Enter key when typing text in a text element. 4. To format the text, highlight part of the text within the text element. 120 IBM

121 9. V1M1R1 New Features The Formatting toolbar is activated as shown in the following image. 5. Select Bold, Italic, Underline, Superscript, or Font Style from the Formatting toolbar. 6. The Font Style option opens the Font dialog box where you can change the type, style, color, size, and effect of the font. Tip: You may also access the Font Style dialog box from the Font ellipse button of the Styling Font field in the Properties window. 7. Click OK to close the Font dialog box. The font options are applied to the text selected. DB2 Web Query New Features 121

122 Developer Workbench Enhancements Procedure: How to Apply Formatting to an Entire Text Element You may apply formatting and style options to an entire text element. Note: Any formatting and styling that you may have applied to individual text strings within the text element will remain unchanged. Changes made to the entire text element are only applied to part of the text string that has not been formatted. 1. Insert a text element into the layout and type text in the text element. 2. Single-click the text box in the layout, as shown in the following image. or Select the text element from the Properties window drop-down list, which appears as text(n) as shown in the following image. 3. Select the Font ellipse button from the Styling Font field in the Properties window. 122 IBM

123 9. V1M1R1 New Features The Font dialog box opens as shown in the following image. 4. Select the type, style, color, size, and effect of the text element. Note: The default font is Arial 10pt. 5. Click OK to close the Font dialog box. The font options are applied to the text element. DB2 Web Query New Features 123

124 Developer Workbench Enhancements Procedure: How to Align Text Within the Text Element 1. Insert a text element into the layout and type text in the text element. 2. Single-click the text box in the layout. or Select the text element from the Properties window drop-down list, which appears as text(n). The Alignment options on the Formatting toolbar are activated as shown in the following image. 3. Select Align Left, Align Center, Align Right, or Full Justification. Note: The default is set to Align Left. The alignment format is applied to the text element. 124 IBM

125 9. V1M1R1 New Features Creating Active Dashboards in HTML Layout Painter In this section: Binding Objects to an Active Report Configuring Active Report Controls Exporting the Active Dashboard Scheduling and Distributing Active Dashboards The HTML Layout Painter has extended the functionality of Active Reports by providing the features to build an Active Dashboard: an HTML form with one or more Active Report procedures and controls to mimic Active Report menu options. This allows global modification of multiple Active Reports in HTML Layout created pages. An Active Report is a self-contained report that is designed for offline analysis, meaning it contains all of the data and Javascript within the HTML output file. A benefit of Active Reports is the ability to run these reports offline. An Active Dashboard combines multiple HTML Active Reports into a variety of scenarios that are coordinated with a common sort field. Active Dashboards can run reports offline and develop storyboards with multiple charts and tables that give you a complete view of a business issue. You can send Active Dashboards as standalone dashboard pages or incorporate them into corporate Dashboards. A typical Dashboard displays several different scenarios, each on their own page, that are accessible by selecting the appropriate panel at the top of the page. The process of creating Active Dashboards in the HTML Layout Painter consists of: Adding an Active Report to the HTML Layout. Binding, or synchronizing, other report and graph objects to the Active Report in the layout. Configuring Active Report controls that mimic Active Report menu options at run time. Saving the HTML Layout as a Web Query procedure (.fex) for scheduling and distributing Active Dashboards. The Export as Procedure option, available from the HTML Layout Painter, converts the HTML page and embeds the code into a Web Query procedure, so these too can be run offline. The layout is no longer a Web page or HTML file, but a Web Query procedure with embedded HTML code. Binding Objects to an Active Report You can create multiple views of an Active Report by binding a report or graph object to an Active Report. Binding, or synchronizing, is the act of configuring an association between an Active Report and other report/graph objects in the HTML Layout. DB2 Web Query New Features 125

126 Developer Workbench Enhancements You may synchronize report/graph objects and show the synchronized report groups in the HTML Layout. The synchronize options are available from the Positioning toolbar in the HTML Layout Painter. Note: You may only synchronize objects to one Active Report at a time. If you try to synchronize an object to a second Active Report, the first synchronization is removed. Procedure: How to Synchronize Report and Graph Objects to Active Reports 1. In the HTML Layout Painter, you may add an Active Report to the layout by using any of the following methods: Select New Report from the Insert menu. Right-click the report object and select Reference existing procedure from the context menu to add the Active Report. 2. Add a report or graph object to the layout: Select New Report or New Graph to from the Insert menu. The cursor changes into a crosshair. Click and drag the crosshair to create a report or graph object and adjust it to the size you want. 126 IBM

127 9. V1M1R1 New Features 3. Select the objects to be synchronized: Select the report/graph object as the object to be synchronized. While pressing and holding the Ctrl key on your keyboard, select the Active Report as the report that you want to bind to. The synchronize buttons on the Positioning toolbar are activated. In the example below, the Active Report is the binding object and the graph object is about to be synchronized to the Active Report. Note: The binding object (Active Report) is indicated by clear boxes around the edges. The synchronized object (report/graph object) is indicated by solid black boxes around the edges. 4. Click the Synchronize to Active Report button on the Positioning toolbar. DB2 Web Query New Features 127

128 Developer Workbench Enhancements The report or graph object is synchronized and refreshed with data from the Active Report. Note: There is no separate procedure associated with these Active Report objects. If you right-click on these items, there are no option to edit the procedure. Procedure: How to Show Synchronized Active Report Groups Select Show synchronized reports from the Positioning toolbar. The synchronized groups are shown in the layout. In the example below, there are two synchronized report groups. The Production Units Analysis graph is synchronized to the Production Units Analysis Active Report and the Sales by Category graph is synchronized to the Sales by Category Active Report. Procedure: How to Select Properties for Synchronized Reports You may change the Active Report object properties by using the Properties tab in the Properties window. 1. Select the synchronized Active Report object in the layout and click the Properties tab. The Active Report object properties appear. 128 IBM

129 9. V1M1R1 New Features 2. Select the Active report type drop-down list to change the type of Active report for the object. The options are: <Not Set>, Grid, Pivot, Bar, Line, Pie. 3. Optionally, If you select Bar, Line, or Pie as the Active Report type, additional X and Y axis selections are available for the synchronized report. Select the Active report X axis drop-down list. Select the Active report Y axis drop-down list. Note: If you change the X and Y values for a graph object, the selections are not reflected in the Design View of the HTML Layout Painter. These values are applied at run time. Procedure: How to Delete An Active Report Object An Active Report object can only be populated if it is synchronized with an Active Report. To break the synchronization between a report or graph with an Active Report, delete the object. 1. Select the synchronized report or graph object in the layout. 2. Click Delete from Edit menu. The Active Report object is deleted. DB2 Web Query New Features 129

130 Developer Workbench Enhancements Configuring Active Report Controls To add an Active Report Control, it is required that you insert a new control to the layout and configure it as an Active Report control on the Parameters tab. Selecting Active Report as the control type creates an association between the HTML Layout control and an Active Report, thereby linking actions to directly affect bound Active Reports. Note: Active Report controls are only applicable if there are Active Reports embedded or referenced in the HTML Layout. Active Report Controls cannot be associated to any parameters in the layout. This type of control can only be associated with an Active Report in the Layout. Procedure: How to Add an Active Report Control to the Layout Any HTML Layout control can be configured as an Active Report control, but the following controls are the most applicable: Check box, Drop down list, List box, Radio button, and Push button. To add a HTML Layout control that mimics an Active Report menu option: 1. Select the control type (Drop Down List, List Box, and so on), from the Insert menu. The cursor changes into a crosshair. 2. Click and drag the crosshair to create a the control object and adjust it to the size you want. The HTML Layout control is added as the Active Report control. You may now configure the control by using the Parameters tab. 130 IBM

131 9. V1M1R1 New Features Reference: Parameters Tab in Properties Window (Active Reports) The following image is the Parameters tab in the Properties window with Active Report control values. The Parameters tab contains the following fields and options when Active Report is selected in the Control Values section: Control Name Contains the name of the form control associated with each parameter. DB2 Web Query New Features 131

132 Developer Workbench Enhancements Parameter Contains the name of each parameter in the current procedure. Unassigned - For an Active Report control, this should always be unassigned. Control Type Contains the type of form control associated with each parameter. The following control types are recommended form controls when using Active Report controls: Check box, Drop down list, List box, Radio button, Push button. Control values Determines whether parameter values are obtained from a static, dynamic, or active report control list. Active Report - Selecting the Active Report control will require you to bind the HTML Layout control to an Active Report. Refresh for Active Reports Enables Active Report controls to automatically modify current views of bound Active Reports when you select a new value at run time. Note: Refresh Active Reports is enabled by default when you select an Available Active Report from the Parameters window. For more information about the Refresh for Active Reports option, see Refreshing Active Reports on page 139. Available Active Reports The Available Active Reports list binds Active Report controls to an Active Reports in the layout. Thereby, at run time, when the Refresh Active Reports setting is triggered, the Active Reports selected in the Available Active Reports list are modified based on the current state of each Active Report control it is bound to. Note: Available Active Reports lists all Active Reports currently embedded in the HTML Layout Painter. No Active Reports are selected by default. Menu Option Types The Menu Option Types determine how Active Reports are modified when the Refresh Active Reports setting is triggered. Menu Option Types configure Active Dashboard controls to sort columns, filter content and change the Active Report presentation. Multiple Active Report controls, each with different Menu Option Types settings, can be used in combination to modify the Active Dashboard. Menu Option Types presents a list of options to designate which Active Report menu option an Active Report control inherits. To set the behavior of the current Active Report control, select only one Menu Option Types item. 132 IBM

133 9. V1M1R1 New Features Note: If no option is selected, the Active Report control will have no effect on the Active Dashboard. List of columns At run time, the Active Report control lists all common columns found in each bound Active Report. When the Refresh Active Reports setting is triggered, the data is sorted by the selected column. Note: If using AS Names for a field in a report, all common columns must have the same name across all reports. Column value At run time, the Active Report control lists all unique values found in a specified column, common in each bound Active Report. When the Refresh Active Reports setting is triggered, the Active Report control filters bound Active Reports based on the column value selected. List of filters At run time, the Active Report control lists multiple filtering actions. This type of control does not affect bound Active Reports by itself, but only when used in conjunction with Active Report controls set to Column Value. When the Refresh Active Reports setting is triggered, the Active Report control instructs how to filter bound Active Reports based on the value selected in the Column Valued control. The available list of filters are: Equals, Not equal, Greater than, Greater than or equal to, Less than, Less than or equal to, Between, Contains, Contains (match case), Omits, Omits (match case). Sort order At run time, the Active Report control lists two sorting actions; Sort Ascending and Sort Descending. When the Refresh Active Reports setting is triggered, the Active Report control sorts bound Active Reports based on the sorting action selected. By default, the Active Report control sorts the first common column in each of the bound Active Reports. DB2 Web Query New Features 133

134 Developer Workbench Enhancements Report type At run time, the Active Report control lists different Active Report presentation types; Grid, Pie Chat, Line Chart, Bar Chart, and Pivot Table. When the Refresh Active Reports setting is triggered, this Active Report control changes bound Active Reports to the presentation type selected. Common Columns The Common Columns list only appears when the Column value Menu Option Type is selected. Common Columns lists all common columns found in each bound Active Report. Select one field to bind to the Active Report control. At run time, the Column value control lists all unique values across each bound Active Report's Common Columns field selected. Note: The Common Column selection can be overridden at run time when the Column Value control is chained to the List of columns Menu Option Type. Selected Value Enter the value(s) to be selected as the default value whenever the procedure is run. Note: The Selected Value option is only available for Active Report controls when the Column Value Menu Option Type is selected. Add "ALL" Option Adds the option to select ALL data source values to the control. Alternate text can be substituted for "ALL" using the text field to the right. Procedure: How to Configure an Active Report Control Once the Active Report control is added to the layout, you may configure the Active Dashboard control by using the Parameters tab of the Properties window. 1. Select the Active Report control in the layout and click the Parameters tab in the Properties window. 2. Select Active Report as the Control Value. 134 IBM

135 9. V1M1R1 New Features The Active Report controls appear. 3. Bind the Active Report control to an Available Active Report in the layout: Select one or more Active Reports from the list of Available Active Reports. When an Active Report is selected, Refresh for Active Reports is enabled by default. The Active Report(s) selected in the Available Active Reports list are modified based on the current state of each Active Report control it is bound to. Refresh for Active Reports refreshes current views of bound Active Reports when you select a new value at run time. For more information about the Refresh for Active Reports option, see Refreshing Active Reports on page 139. DB2 Web Query New Features 135

136 Developer Workbench Enhancements 4. Select the Menu Options Types for the Active Report control to sort, filter, list or select columns, and/or change presentations styles of the bound Active Report and the associated report and graph objects synchronized to the Active Report. Note: If no option is selected, the Active Report control will have no effect on the Active Dashboard. a. Select List of columns from Menu Option Types to list all common columns found in each bound Active Report. At run time, the bound Active Report output is sorted by the selected column. For example, the following Active Report control shows a list of all the columns in the bound Active Report. b. Select Column value from the Menu Option Types to list all unique values found in a specified column, common in each bound Active Report at run time. When Column Value is selected, the Active Report control panel dynamically presents Common Columns in each of the selected Active Reports in the Available Active Reports list. 136 IBM

137 9. V1M1R1 New Features Select one column from the Common Columns list. You may also use the Selected Value field to enter the value(s) to be selected as the default value whenever the procedure is run. The Add "ALL" option adds the option to select ALL data source values to the control at run time. For example, the following Active Report control shows RATING as the selected common column for the bound Active Report. c. Select List of filters from the Menu Option Types to list multiple filtering actions at run time. Note: List of filters is used in conjunction with the Column value. Both controls should be bound to the same Active Reports. The Active Report control instructs how to filter bound Active Reports based on the value selected in the Column value control. DB2 Web Query New Features 137

138 Developer Workbench Enhancements For example, the following Active Report control shows a list of filters in the bound Active Report. d. Select Sort order from the Menu Option Types to list sorting options (Ascending or Descending) at run time. The Active Report control sorts bound Active Reports based on the sorting action selected. Note: By default, the Active Report control sorts the first common column in each of the bound Active Reports. For example, the following Active Report control shows a list sort order options in the bound Active Report. e. Select Report types from the Menu Option Types to list different Active Report presentation types at run time. The Active Report control changes bound Active Reports to the presentation type selected. 138 IBM

139 9. V1M1R1 New Features For example, the following Active Report control shows report type options in the bound Active Report. Refreshing Active Reports The Refresh Active Reports setting enables Active Report controls to automatically modify current views of bound Active Reports when you select a new value. Each bound Active Report is modified not only by the new selection in the Active Report control with the Refresh Active Reports setting, but is based on the current state of all Active Report controls in the Active Dashboard. This action is triggered at run time when you select a new value in an Active Report control with Refresh Active Reports set. Enabled (or checked) empowers the Active Report control, only after you make a new selection, to modify bound Active Reports. Disabled (or unchecked) prevents any bound Active Report from being modified when you select a new value in the Active Report control. In order to update Active Reports when a value in the Active Report control changes, you must check the Refresh Active Reports check box on the Active Reports Control Panel. Note: Refresh Active Reports is selected by default. You may want to disable the Refresh option if there are multiple Active Report controls that require each control to be set before you refresh your output. If you are using multiple controls, you can associate the refresh option with a Push Button or Hyperlink, enabling you to refresh the output once all the controls are selected. DB2 Web Query New Features 139

140 Developer Workbench Enhancements Procedure: How to Refresh Active Reports in the Active Report Control Panel 1. From the Parameters tab of the Properties window, select Active Report as the Control Value. The Active Report controls appear. 2. Select the Refresh for Active Reports check box. Note: When an Active Report is first selected, Refresh for Active Reports is enabled by default. Procedure: How to Refresh Active Reports With a Push Button or Hyperlink 1. Insert a Push Button or Hyperlink to the layout: Select Push Button from the Insert menu. Select Hyperlink from Insert menu. The cursor changes into a crosshair. 2. Click and drag the crosshair to add the Push Button\Hyperlink object to the layout and adjust it to the size you want. If inserting a Push Button, right-click the push button object and select Create hyperlink from the context menu. The Hyperlink Properties dialog box opens. If inserting a Hyperlink, the Hyperlink Properties dialog box opens. 3. Optionally, you may change the name of the Push Button\Hyperlink in the Display Text field. 4. From the Hyperlink Properties dialog box, select the New icon to add a request to execute. 5. Select Refresh Active Reports from the Action drop-down list. 6. Select the Source drop-down list to select which Active Reports should be refreshed. 140 IBM

141 9. V1M1R1 New Features Note: The Source drop-down will only lists the embedded or referenced Active Reports in the layout. 7. Click OK to close the Hyperlink Properties dialog box. Exporting the Active Dashboard A benefit of Active Reports is the ability to run these reports off-line. You may export an HTML Layout as a Web Query procedure (.fex) to provide the ability to schedule and distribute Active Dashboards, so these too can be run off-line. Export As Procedure converts the HTML page and embeds the code into a Web Query procedure. The layout is no longer a Web page or HTML file, but a Web Query procedure with embedded HTML code. The procedure (.fex) is added to the subfolder in your Reports group folder (Managed Reporting environment). Once the HTML Layout is saved as a procedure, it cannot be converted back to an HTML Layout. Note: The Export As Procedure is recommended for saving Active Dashboards only, as many layout controls and report formats are not supported. Procedure: How to Use Export as Procedure Once the HTML Layout is exported as a procedure, it cannot be converted back to an HTML Layout. 1. After creating an Active Dashboard in the HTML Layout Painter, select Export as procedure from the File menu. The New Procedure File dialog box opens. DB2 Web Query New Features 141

142 Developer Workbench Enhancements 2. Type a File name and click Create. Note: If the layout contains any parameter controls other than an Active Report control, the Export as procedure option is unavailable. Reference: Reference: Conversions of Export as Procedure Export As Procedure converts the HTML page and embeds the code into a Web Query procedure. The layout is no longer a Web page or HTML file, but a Web Query procedure with embedded HTML code. This conversion requires conversion of each object on the HTML page. The purpose of creating a procedure from an HTML Layout is to provide the ability to run these forms off-line. Because you may not be connected to an environment, the new procedure removes all referenced objects and adds them to the procedure; and layouts with controls that require multiple requests to the server will not be supported. The following conversions occur when exporting as a procedure: Referenced procedures get read and written/embedded into the saved procedure. Report and Graph objects - Display format is converted to HTML format. For example, If the layout has embedded/referenced Excel, PowerPoint, or PDF documents, these will all be converted to HTML formatted output. Note: Active Reports (AHTML) format is preserved. Images - The reference to the image file is removed, and the image is embedded in the procedure as inline HTML code. Note: This code can become very long and it is recommended that only small images be used in layouts that will be exported as procedures. Limitations of Export As Procedure Note the following limitations when applying the Export As Procedure in the HTML Layout Painter: If using Static and Dynamic Parameter controls. The Export as Procedure menu item is disabled for any Layouts with static or dynamic parameter controls. Any scheduled report supports only one request to the server at run time. These types of controls require multiple requests to the server, and cannot be supported off-line. If exporting a procedure with background images. 142 IBM

143 9. V1M1R1 New Features Background images will not be embedded into the procedure due to size. The procedure will keep the reference. In offline mode, if this reference cannot be resolved, no image will be displayed. If exporting a procedure and using CSS stylesheets. The referenced stylesheets will not be embedded into the procedure and the procedure will keep the reference. In offline mode, if this reference cannot be resolved, no style from the CSS file will be applied. Scheduling and Distributing Active Dashboards If an HTML Layout has been exported as a procedure (.fex), it is now available to be scheduled with Report Broker. DB2 Web Query New Features 143

144 Developer Workbench Enhancements Adding Schedule Capability in HTML Layout Painter From the Developer Workbench HTML Layout Tool, you can add a Schedule button to an HTML form that will open the Report Broker single page Scheduler Tool. The Scheduler Tool provides the full function of Report Broker presented in a unified user interface. The following image shows the Scheduler Tool user interface that appears when you click the Schedule button on an HTML form. 144 IBM

145 9. V1M1R1 New Features The Scheduler Tool is partitioned into the following sections: Distribution. Provides a drop-down list of distribution methods and the corresponding distribution options. The Scheduler Tool template you select when creating the Schedule button can limit the choices in the Distribution drop-down list. Frequency. Provides the options related to the time interval to run the schedule. Report Options. Provides report options for the report format, burst option, and execution ID and password. Notification. Provides the options to set up notification of the schedule status. Advanced. Provides options to set the schedule priority level, and selections to enable or delete the schedule. All of the scheduling features and options available in the Scheduler Tool have the same functions as the standard Report Broker tool. Adding a Tab Control to the Layout in HTML Layout Painter You can add a tab control to the report page layout. Tab controls enable you to create one or more pages in one HTML form in order to improve the display of secondary data. Select Tab Control from the Insert menu to create the tab control object in the layout. Add reports and graphs inside the tab control object and add multiple tab items by using the right-click context menu. These tabs may be customized by using the Properties tab in the HTML Layout Painter. DB2 Web Query New Features 145

146 Developer Workbench Enhancements In the following image, the tab controls show the report and graph on separate pages. Setting Default Values in HTML Layout Painter How to: Set Default Values When using Dynamic or Active Report control values, you can enter value(s) to be selected as the default whenever the procedure is run. These values will be automatically selected (highlighted) when the procedure is run. Procedure: How to Set Default Values 1. Enter the exact parameter value in the Selected Value input field, as it appears in the report output. Note: Parameter values are case-sensitive. 146 IBM

147 9. V1M1R1 New Features 2. Optionally, you may enter more than one value by using a comma between the values. For example: CT, GA are entered as the Selected Value fields for the Dynamic State parameter in the following image. 3. Run the report. The Selected Value, if available from the report results, is automatically selected (highlighted) in the parameter list. DB2 Web Query New Features 147

148 Developer Workbench Enhancements The example below shows CT, GA as the Selected Values in the State parameter list in the report output. 4. Click the Run button to run the report with the Selected Value parameters. The report output appears. Note: If you import a procedure (.fex) that has a dynamic prompt value, then the input box is populated with values retrieved from the data source. If the Selected Value is available for the report output, then it is selected (highlighted) by default. If the Selected Value is not available for report output, then it is ignored and the first value retrieved from the data source is selected. Adding Comments to HTML Active Report Output How to: Add Comments to a Row in the Active Report Output An HTML Active Report is a report that is designed for offline analysis. The HTML Active Report Comments option enables you to comment individual rows of data in the Active Report output. You may add multiple comments per row. Comments cannot be edited but they can be deleted. 148 IBM

149 9. V1M1R1 New Features Procedure: How to Add Comments to a Row in the Active Report Output 1. Select the row of data that you want to add a comment to, click, and select Comments from the context menu. The Add Comment dialog box appears. 2. Type a comment in the Enter Comment field. 3. Click Add Comment to add the entry and close the dialog box. An asterisk (*) indicates that there is a comment in the row. 4. To view existing comments: Click the row with comments, and select Comments from the context menu. The Add Comment dialog box appears, displaying the comment entry and the date it was created. DB2 Web Query New Features 149

150 Developer Workbench Enhancements Select Expand from the Comments submenu of any column control. The comment date and entry are shown in the output. 5. To delete an existing comment: Click the row with comments and select Comments from the context menu. The Add Comment dialog box appears. Click the X next to the comment date and entry. The comment is removed. Click the X on the Add Comment toolbar to close the dialog box. 150 IBM

151 9. V1M1R1 New Features Web Query Development Tools Enhancements In this section: Change Management Load Utility Pie Chart Enhancements Creating a Thermometer Gauge Chart Displaying All Instances of Sort Values Displaying a Fully Qualified Field Name This section describes the new features for Web Query Development tools. Web Query provides a selection of reporting tools that can be used to create and edit reports, manipulate data in existing reports, submit reports for background processing, and view reports while protecting sensitive or confidential information. Web Query provides a streamlined reporting environment that virtually eliminates the complexities of today's corporate data. Users of Web Query can tailor reports to meet their individual business needs, without knowing the details of the underlying data source and reporting language. DB2 Web Query New Features 151

152 Web Query Development Tools Enhancements Change Management Load Utility The Change Management Load Utility is available in a GUI interface. The utility enables administrators to load change packages created with the Change Management Extract Utility. The Change Management Load Utility, as shown in the following image, is accessible from the Welcome Page by selecting the Change Management Load link. Previously, only the Change Management Extract Utility was available in a GUI interface. Pie Chart Enhancements Enhancements have been made to eliminate overlapping of feeler lines and labels when creating pie charts. This enhanced functionality is available in all graph reporting tools including Graph Assistant and Power Painter. 152 IBM

153 9. V1M1R1 New Features The following image shows a pie chart displaying numerous feeler lines and labels: Creating a Thermometer Gauge Chart A thermometer gauge chart type is available to users in the Power Painter tool. A thermometer gauge chart displays data in the form of a traditional thermometer. Depending on the number of sort values, one or more thermometers are displayed in the graph output. For each thermometer, the liquid on the inside indicates the current position of a single data value, and the numeric values displayed on the outside of the thermometer represent the given scale. The following image shows an example of a thermometer gauge chart comparing two data values: DB2 Web Query New Features 153

154 Web Query Administration Enhancements Displaying All Instances of Sort Values The "Display every sort value" property in the Report Properties palette in Power Painter enables new functionality to display all instances of a vertical sort (BY) field in a report. The default value for this property is set to No to omit duplicates. When this property is set to Yes, every instance of a vertical sort field value is displayed in the report. Displaying a Fully Qualified Field Name A check box is available in the Variable Editor to display the fully qualified field name for data source and field values when setting parameter properties. This functionality is available in the Report Assistant and Graph Assistant tools, and the setting is for display purposes only. Web Query Administration Enhancements In this section: Report Broker Server Configuration Settings Change Management Extract and Load Utilities This section describes the Administration Console enhancements in support of the Web Query Report Broker and Change Management new features. The Web Query Administration Console enables you to remotely manage your Web Query environment. Using the console, administrators can navigate through and change various configuration settings for the Web Query Client. Report Broker Server Configuration Settings You can use the Web Query Administration Console to invoke the Report Broker API to configure Report Broker, create the Report Broker repository, restart the Distribution Server, and turn Report Broker traces on and off. The Web Query Administration Console authenticates Report Broker, and if authentication fails, users are prompted for their credentials. 154 IBM

155 9. V1M1R1 New Features As shown in the following image, Report Broker functionality is grouped into the Repository, Configuration, Utilities, and Traces categories in the Report Broker menu of the Web Query Administration Console. Change Management Extract and Load Utilities The Change Management Extract Utility and Change Management Load Utility are available from the Web Query Administration Console. As shown in the following image, these utilities are accessible in GUI interfaces from the Change Management section of the Utilities menu by selecting either Extract or Load. Note: Administrators and developers can access the Change Management Extract Utility, but only administrators can access the Change Management Load Utility. DB2 Web Query New Features 155