using active report variables
TRANSCRIPT
Viewing Variables in Active Reports
Nature of Document: Troubleshooting
Product(s): IBM Cognos Active Reports
Area of Interest: Development
Business Analytics
Viewing Variables in Active Reports
Copyright and Trademarks Licensed Materials - Property of IBM.
© Copyright IBM Corp. 2010
IBM, the IBM logo, and Cognos are trademarks or registered trademarks of InternationalBusiness Machines Corp., registered in many jurisdictions worldwide. Other product andservice names might be trademarks of IBM or other companies. A current list of IBMtrademarks is available on the Web at http://www.ibm.com/legal/copytrade.shtml
While every attempt has been made to ensure that the information in this document isaccurate and complete, some typographical errors or technical inaccuracies may exist. IBMdoes not accept responsibility for any kind of loss resulting from the use of informationcontained in this document. The information contained in this document is subject to changewithout notice.This document is maintained by the Best Practices, Product and Technology team. You cansend comments, suggestions, and additions to [email protected].
Business Analytics
2
Viewing Variables in Active Reports
Table of Contents1 IBM COGNOS Acitve Report Variables. ........................................................................... 4
1.1 What is the purpose? ...................................................................................................... 4
2 Creating the Report. ..................................................................................................... 4
3 Viewing Active Report Variable Values ........................................................................... 9
4 Conclusion ................................................................................................................. 12
Business Analytics
3
Viewing Variables in Active Reports
1 IBM COGNOS Active Report Variables.
1.1 What is the purpose?
It’s possible during the creation of an Active Report that the controls and objects in the report do notinteract as the author intended. This document will highlight the ability to watch the active reportvariable values, and change those values to diagnose issues around report design. This documentwill step the user through creating a report (without the need for data) that will demonstrate how toview the active report variables and their values, as well as changing the values to see how thosechanges impact the active report objects
2 Creating the Report.1. Open report Studio against any Package. (note the package isn’t important as no data
items will be uses from the package to create the report. Only static items such as textitems).
2. When prompted select Create New, then select Blank Active Report.
3. From the Insertable Objects pane insert a Deck object into the blank report.
Business Analytics
4
Viewing Variables in Active Reports
4. In the properties of the Deck, under General, click the ellipses beside the Deck CardsDefinition entry to change the default settings.
5. Change the default Label values for each card to Deck1, Deck2 and Deck3 respectively.
6. Next insert into the body of Deck1 a text item, and type the text “Deck Number1”.
7. Repeat the process for Deck2 and Deck3 three, changing the text to correspond to the cardthat is currently active. To change the active card either select the card from the drop
down list in the deck or select the blue double arrows to move to the next card in thedeck .
8. Insert a button bar into the blank report.
Business Analytics
5
Viewing Variables in Active Reports
9. In the properties of the button, in the General section select ellipses beside the Button BarDefinition entry.
10. In the dialog box that opens select the New button to add a new column in the data tableand when prompted enter “Value”. Then select OK.
11. In the label column change each label to be Deck1, Deck2, Deck3 and then change theValue column to read Deck1, Dck2, Deck3. Then hit OK.
Business Analytics
6
Viewing Variables in Active Reports
12. In the properties of the Button Bar select the ellipses in the Set Variable Values entry toopen the Set Variable Values dialog box.
13. Click the Hyperlink “Manage Active Report Variables…” to create a new variable. Click thenew icon to create a new variable and name it v_buttonbar. Press OK.
Business Analytics
7
Viewing Variables in Active Reports
14. In the Set Variable Value dialog box in the Value drop down box select Value. This is thecolumn we created in step 11. Press OK.
15. In the properties of the Deck, under Interactive Behavior click the three ellipses beside theContainer Select entry.
16. In the Condition Comparison dialog box select OK. The default entry is fine for this sample.It creates a filter between the label for each card in the deck and the variable v_buttonbar.Press OK, and then OK again to close the Container Select dialog box.
17. Save the report.
Business Analytics
8
Viewing Variables in Active Reports
3 Viewing Active Report Variable ValuesIt is important to note, that you can only see and adjust the Active Report Variables whenrunning the report from Report Studio. It is not possible to view the variables in the waydetailed in this document, by running the report in Cognos Connection.
1. In Report Studio run the report created in the previous steps. When the report hasexecuted, in the viewer right click and select Show Variables.
Business Analytics
9
Viewing Variables in Active Reports
2. A new frame will appear showing all variables in the report, in this example onlyv_buttonbar is displayed. Currently the value is blank as the user hasn’t selected anybuttons.
3. As you click on the buttons notice that the value in the variable v_buttonbar changes.
4. Notice that when you click on the button Deck2, nothing happens. The value in the textitem remains the same as it was in the previous button selection. This is because the valuefor the label in card2 is Deck2, where the value Button2 submits is Dck2. These two valuesdon’t match and as a result nothing happens when Button2 is pressed.
Business Analytics
10
Viewing Variables in Active Reports
5. To see how changing the value will impact the interaction between the Button Bar and thedeck place your mouse cursor in the Value section of the Variables dialog. Notice the cursorchanges from an arrow to the text crossbar.
6. Click inside the box to highlight the current value of the variable and change the value toDeck2. Then hit enter on the keyboard.
7. The value in the report changes to show the text item in Card 2.
Business Analytics
11
Viewing Variables in Active Reports
4 ConclusionWith the ability to track the values of variables in Active Reports the author can work to determinehow the variables they create will interact with the other control object and report objects withintheir report.
Business Analytics
12