Parameters
Introduction
There are two
types of parameters: user parameters
and system parameters.
User
Parameters
�User
parameters� will be used to manage the
behavior and output of your reports.
System
Parameters
�System
parameters� will be used to manage the
report runtime behavior of your reports such
as defining your output destination.
Parameter Form
Builder
�Parameter
Form Builder� tool will be used to
design your runtime parameter form. The
Runtime Parameter Form appears whenever
you run your report.
Hands-on
The user wants
to execute this report just against a
specific company�s symbol. They want to use
company�s symbol as a parameter to pass to
the report. Also the report should calculate
the total and average of shares sold for the
company at the end of report.
You should
create a simple report to list the name of
customers including their shares owned.
See Figure 9.
Your tasks
are:
1- Create a
new portfolio report for each company.
2- Use
parameter to run the report for a specific
symbol.
3- Print the
list of their customers and their number of
shares.
4- Print the
total and average of shares sold for the
company.
5- Run the
report.
6- Test the
report.
You will learn how to: use the �group
above,� use the �query builder,� set table
relationship, create and use binding
variable, calculate total and average
shares, delete the object from layout.
Figure 9
Open the
Report Builder.
Create a New
Report
In the Object
Navigator, highlight the Reports item, and
click on the "create" icon (Green �+�) to
create a new report.
Use the Report
Wizard
In the New
Report window, choose the �Use the Report
Wizard� option, and click �OK.�
Select a style
In the Report
Wizard, type �Customer List� in the Title
box, choose the �Group Above� style and
click Next.
Group-Above
A
Group-Above report is a style you use to
demonstrate a master/detail relationship in
your database. You should define a master
group, and for each master record, the
report obtains the related values from the
detail groups.
SQL Query
Statement
In the SQL
Query Statement, write a SQL statement to
query customers� information (Name), and
their portfolio information (Number of
shares, and stock�s symbol) with an binding
variables to be used as parameter field.
(SQL Query
Statement)
SELECT ALL
first_name, last_name,
stock_symbol,
shares_owned
FROM
customers, portfolio
WHERE id =
customer_id and
stock_symbol =
:symbol
Use of a Colon
The colon next
to the symbol (:symbol) means: pass a symbol
as a parameter to the report.
Click OK. You
get This message:
Note: The
query �Q_1� has created the bind parameter(s)
�SYMBOL�.
Click "OK" to
confirm it.
Group fields
In the Report
Wizard, in the Group Field section, select
the "Stock_Symbol" item as a "Group Fields."
Display Fields
In the Display
Fields section, select all the items to
display in your report. You may add other
fields later.
Total and
Average �
Calculate the
total and average shares sold for a company
(Sum(SHARES_OWNED), Average(SHARES_OWNED)).
Label and
Template Sections
In the Label
section, modify the labels and widths for
your fields and totals as desired.
In the
Template section, use the default template
and click Next.
In the
congratulation section, click Finish to run
the report.
Parameter Form
Prompt
The parameter
form will be opened. In the Runtime
Parameter Form, enter the company�s symbol
such as ORCL, MSFT, etc. The click on the
Run icon to run the report.
Remove an
object or objects
Hold the
control key and click on the duplicate Total
and Average objects. Then press the "delete"
function key to remove them. Objects will be
removed.
Format Masking
and Layout adjustment
Do all the
items format mask and layout adjustment, if
needed! Navigate through the report pages.
After testing the report output, highlight
the �UNTITLED� report and save the changes
as the report number 9 (REPT09).
Run a report
and pass a parameter
In the Object
Navigator on the vertical toolbar, click on
the �Run� icon to run the report with
different company symbol. In the Runtime
Parameter Form, enter the company�s symbol
that does not exist. The click on the Run
icon to run the report.
Questions:
Q: How do you
create a binding variable?
Q: How do you
use a binding variable?
Q: How do you
remove an object from Layout Editor?
Q: The user
wants to execute this report just against a
specific company�s symbol. They want to use
company�s symbol as a parameter to pass to
the report. Also the report should calculate
the total and average of shares sold for the
company at the end of report.
You should
create a simple report to list the name of
customers including their shares owned.
See Figure 9.
Your tasks
are:
1- Create a
new portfolio report for each company.
2- Use
parameter to run the report for a specific
symbol.
3- Print the
list of their customers and their number of
shares.
4- Print the
total and average of shares sold for the
company.
5- Run the
report.
6- Test the
report. |