Oracle Essbase 9 Implementation Guide- P51 pot

Right-click on the test report script and then click on the Execute button as shown:... If you wish to save an output file, just provide an output file path and file name and click OK,

• Run reports from EAS

• Run reports using EssCmd

• Run reports using MaxL

• Run reports using API calls (as discussed in Chapter 8)

Run reports using EAS

Upto now you have learned many tasks that an Essbase developer or administrator can do through EAS Running report scripts is just one more better example of how you can effectively use EAS Like we discussed running calc scripts from EAS before, there are also many ways to execute report scripts from EAS

From EAS, drill-down to your Application | Database | Report Scripts and you

will see your report script test Right-click on the test report script and then click

on the Execute button as shown:

Once you click the Execute button a dialog box will open which asks if you want

to execute the script in the background and send the results to the Console or to

the Printer You can also specify if you want to send the retrieved results to an

output file Isn't this the coolest feature? You can then send this output file to your

customers to tell them that your data load and calc are completed and here is what

your data now looks like The output file can be rpt or txt file These are the

two options that are provided through EAS If you wish to save an output file, just

provide an output file path and file name and click OK, as shown and the report

will then be executed:

There are also other ways you can execute a report script from within EAS For

instance, you can open a report script and then click on the Execute button of the

Report menu or you can click on Options | Execute in the EAS menu or by pressing

the F5 button on your keyboard.

Running a report script using an Essbase

command script

As we have discussed in previous chapters about being able to execute calculation

scripts using Essbase command scripts, you are also able to run database report

scripts from an EssCmd as well When you run a report from an EssCmd, you

have the option to save the output in an ASCII text file or a formatted report file

EssCmd Syntax:

i) Local/Client based report script.

ii) Remote/Server report script

iii) Specifies that the file is not an Essbase default object and you need

to provide the fully qualified path with the name of the report script

• reportscript—name of the report script This parameter will depend on

the numeric value chosen for the first parameter

• Outputfile—fully qualified name and path for the output file If no path

is specified, Essbase will place the file in the default database folder

OUTPUT 1 "c:\EsscmdReport.log";

LOGIN "EssServerID" "EssID" "EssPass" "ESSCAR" "ESSCAR";

SELECT "ESSCAR" "ESSCAR"

RUNREPT 2 "test" "c:/book/test.dat"

LOGOUT;

EXIT;

Once you have executed the above EssCmd at the DOS prompt (as shown in the

following screenshot), the output data will be saved in the text file called test.dat, which will be created in the path described As you can see, we have created a file

with a dat extension, instead of creating an rpt or txt file We just want to make you aware that when you are saving an output file from an EssCmd, you are not

obligated to use any particular file extension and may choose any one you wish

Upon the execution of the command, you will see the return code in the form of

sts (Status code) If sts is 0, that means there is no error If the return code is not

zero, it will provide you an error message as shown:

Running calc using a MaxL script

How can we forget MaxL? There is no way we can forget MaxL MaxL is the new

generation of command scripting language used by Essbase If you look closely

at the MaxL statements, you will see that they are very close to your typical SQL

statements Since you will be exporting data, you will use the EXPORT MaxL

statement to run the report script

Syntax:

EXPORT DATABASE database name USING LOCAL/SERVER REPORT_FILE report

script name TO DATA_FILE output data file name.

Code:

export database 'ESSCAR'.'ESSCAR' using server report_file 'Test' to data_file 'c:/book/test.rpt';

This code, when executed from MaxL, will execute the Test.rep against the

ESSCAR application/ESSCAR database

To create a MaxL script file object, simply open the MaxL Script Editor in the EAS

tool by clicking the Editors menu pick, then click on MaxL Script Editor The MaxL

Script Editor is shown in the following screenshot:

You can execute the script by clicking on the Execute Script button on the MaxL menu

or on the EAS | Execute on the EAS menu or press F5 to execute the script Once the

script is executed, you will see the validation_6.rpt file in the location specified

Previewing data in EAS

Until now you have used EAS to create users, update the outline, load data, calculate the data, and so forth You will now see how EAS can also be used to preview the data

in an Essbase cube You can preview data for both aggregate storage and block storage databases You can preview the data in spreadsheet format or in HTML format

Here are the steps to preview data in EAS:

1 In EAS, select the database and click on Actions | Preview data or right-click

on the database and select Preview data.

2 On the right side of the EAS frame, you will see the Data Preview Grid

screen with two tabs, a Cubeview tab and a Properties tab as shown here:

Here, you can see there are two tabs, one is for the Cubeview and other tab is for the

Properties The Cubeview is the view that shows the data and is always defaulted to

the Dimension level view In order for you to look at the lower levels, you will need

to drill-down The properties for the Cubeview can be set in the Properties tab.