Creating a Report Template
You can create a Report Template from:
• a Report DataSet
• a GraphSet
• a TreeSet
• a query
Else you can create a Report Template using a Report Data View.
To answer specific needs, you can also implement a Report Template using macro.
Creating a Report Template from a Report DataSet
In HOPEX Power Studio, you can create a Report Template from a Report DataSet.
From the Data page of the Report DataSet, you can launch an Instant Report, then save the report as:
• a report, to get its Report Template
• a Report Data View, to use it in a Report Template
To create a Report Template from a Report DataSet:
1. Access the Report DataSet properties (from Studio > Other Reports > My Report DataSets).
2. Display its Data page.
3. In the Report DataSet section, click Instant Report 
.
.4. Select the required instant report type.
E.g.: Breakdown (pie chart, bar chart, set of gauges, word cloud), Matrix (bar chart, radar chart, Quantitative (bar chart, line chart, radar chart), Table.
5. Click OK.
The instant report is displayed in the View edit area, Report section.
6. (Optional) You can customize the report display.
7. In the Report section, click More > Save As Report 
.
.8. Enter a Name to the report.
A report is created and its Report Template is also automatically created. They both have the same name:
• The Report Template is accessible from Studio > Report Template Definition: Report Templates > Private Report Template > My Report Templates folder.
• The report is accessible in your Home page, from My Reports tile.
Alternative: from Studio > Other Reports > My Reports.Creating a graph-type Report Template from a GraphSet
In HOPEX Power Studio, you can create a Report Template from a GraphSet.
From the Preview page of the GraphSet Definition, you can save the graph as:
• a report, to get its Report Template
• a Report Data View, to use it in a Report Template
To create a graph-type Report Template from a GraphSet:
1. Access the GraphSet Definition properties.
2. Display its Preview page.
3. In the graph, click More > Save as Report.
4. Enter a Name to the report.
The GraphSet is saved as a report.
A report is created and its Report Template is also automatically created. They both have the same name:
• The Report Template is accessible from Studio > Report Template Definition: Report Templates > Private Report Template > My report Templates folder.
• The report is accessible in your Home page, from My Reports tile.
Alternative: from Studio > Other Reports > My Reports.Creating a tree-type Report Template from a TreeSet
In HOPEX Power Studio, you can create a Report Template from a TreeSet.
From the Preview page of the TreeSet Definition, you can save the tree as:
• a report, to get its Report Template
• a Report Data View, to use it in a Report Template
You can save only one tree report at a time:
• a breakdown
• a dendrogram
• a TreeMap
• a TreeTabble
To create a Report Template from a tree report:
1. Access the TreeSet Definition properties.
2. Display its Preview page.
3. Click the renderer type you want to save.
E.g.: Breakdown, Dendrogram, TreeMap, or TreeTable.
4. In the graphic, click More > Save as Report.
5. Enter a Name to the report.
A report is created and its Report Template is also automatically created. They both have the same name:
• The Report Template is accessible from Studio > Report Template Definition: Report Templates > Private Report Template > My Report Templates folder.
• The report is accessible in your Home page, from My Reports tile.
Alternative: from Studio > Other Reports > My Reports.Creating a gauge-type Report Template from a query
In HOPEX Power Studio, you can create a Report Template from a query (without parameters). This Report Template enables to create gauge reports.
See use cases in How to Create and Customize a Gauge Report Template section.To create a gauge-type Report Template from a query:
1. Connect to HOPEX Studio desktop.
2. Click the navigation menu and select Studio > Queries 
.
.3. In the Queries without mandatory parameters list, right-click a query and select New gauge report.
4. In the Name field, enter a name for your report.
5. Click OK.
The gauge report is displayed and its Report Template (with associated Report Value View) is also automatically created. They all have the same name:
• The Report Template is accessible from Studio > Report Template Definition: Report Templates > Private Report Template > My report Templates folder.
• The report is accessible in your Home page, from My Reports tile.
Alternative: from Studio > Other Reports > My Reports.• The Report Value View is accessible from Studio > Report Template Definition: Public Report Data Views.
Creating a Report Template using a Report Data View
You can create a Report Template right away including a Report Chapter with a Report Data View saved in the Public Report Data Views folder.
Prerequisite: your Report Data View is created.
To create a Report Data View, see Creating a Report Data View.To create a Report Template using a Report Data View:
1. Access the Report Templates folders.
2. Right-click My Report Templates folder, and select New > Report Template.
As at creation a Report Template is "private" (see Report Template Properties), if you create a Report Template from another sub-folder, the Report Template is still saved in My Report Template folder.
Your Report Template Basic Properties window appears.
3. In the Name field, enter your Report Template name.
By default the Report Template name is: Report Template-x (x is a number).4. In the drop-down list select the Report Data View you want to fill your first chapter with.
5. Click OK.
The Report Template is created with a single chapter based on the Report Data view selected.
You can:
• add other chapters.
• customize the Report Template.
Implementing a Report Template using a macro
To build your report chapters, you can use an existing macro on condition that parameters are compatible.
To implement a Report Template using a macro:
1. Access the Report Templates folders.
2. Right-click My Report Templates folder, and select New > Report Template.
As at creation a Report Template is "private" (see Report Template Properties), if you create a Report Template from another sub-folder, the Report Template is still saved in My Report Template folder.The Basic Properties page appears.
3. In the Name field, enter your Report Template name.
By default the Report DataSet Definition name is: Report Template-x (x is a number).Example: Application
4. Click Next.
The Parameters definition wizard appears.
Parameter definition indicates the input data type the user must enter for the report calculation (e.g.: Applications).
Do not define any parameter if you want the report to be launched without requiring the user to select any input objects.For each parameter define the available object type that can be instantiated for the report (parameter with HOPEX objects or with simple types).
5. Click Next to continue the Report Template definition:
Else click OK to terminate the Report Template definition later. You need to define at least one Report Template Chapter. See Adding a Report Chapter to a Report Template.The Chapters definition wizard appears.
6. Click Add 
.
. 7. In the Name field, enter the Report Chapter name.
Else you can select an existing Report chapter in the drop-down list. To build your report chapters, you can use an existing macro, provided that parameters are compatible.
MEGA provides in particular the " Analysis - Set of Parameters" macro, which describes report template parameters and the way in which they are interpreted by the report chapter.
Macros have a comment available in the form of a system note.
8. Click Next.
9. In the Based on field, select "Macro".
10. In the Macro field, click the right-oriented arrow and select Add Macro.
If the macro is already created, select the macro in the drop-down list and click OK.11. In the Name field, enter a name for the macro.
12. Click Next.
13. Select Create a Java Macro and click Next.
14. In the Setup JAVA Macro:
• In the Class Name field, enter the class defined in Eclipse when developing the Java macro.
• In the Package Name field, enter the macro path.
Example: "com.mega.modeling.analysis.reports" for those supplied by MEGA.
To create the macro, see How to Define Parameters in a Report Template.15. Click OK.
The macro name appears in the Macro field.
For such a Report Template example, see Report Template Example with Report Chapters Based on Macros.The macro appears in the Report Template tree, under the Report Chapter concerned.
ted.
You can:
• add other chapters.
• customize the Report Template.