Siebel Reports Administration Guide > Creating a Simple List Report >
Examining an Existing List Report
To learn more about the configuration of a simple list report, it is helpful to open a standard Siebel report of this type in Actuate e.Report Designer Professional and study it. A good report to study for this purpose is the Activity List report, which is invoked from a view in the Activities screen (typically the My Activities view). You examine the report output in Siebel Sales, and the report design in Actuate e.Report Designer Professional, leaving both open to compare them.
This topic describes how to generate the Activity List report in a Siebel client and how to open the report design for that report for examination.
To generate the Activity List report in a Siebel client
- In the Siebel client, navigate to the Activities screen, Activity List, My Activities view.
- From the application-level menu, click Reports, and then choose the Activity List menu item.
The Activity List report appears in the browser window.
To open the report design for the Activity List report
- Open Actuate e.Report Designer Professional.
- From the application-level menu, choose File, and then Open.
- In the Select File dialog box, navigate to the $\RPTSRC\STANDARD directory in your Siebel Tools installation directory. For example, $\Siebel\RPTSRC\STANDARD.
For more information, see Siebel Reports Directory Structure.
- Choose actlist.rod, and then click Open.
NOTE: Do not confuse the actlist.rod file with the aclist.rod file, which is the Account List report. The correct file to open for this procedure is actlist.rod, which is the Activity List report.
Explore the report design, by expanding and closing folders in the tree diagram on the left, comparing design elements to the corresponding features in the report output, and right-clicking components to view their property lists.
Notice some features of this report design:
- Component names that are light gray are being referenced in a library. Component names in black have been subclassed, making them available for local modification in the report without affecting the original. The same color scheme is used for methods. The name of a method (in the Methods tab in the Properties window for a component) that has been locally modified is black. The names of unmodified methods obtained from the superclass of the component are light gray.
- The name of the DataStream component, ActionsSort, is black, indicating that it is locally modified. If you expand the ActionsSort datastream component, you can see that it has a child Input component, ssActionQuery. The name of the Input component, ssActionQuery, is gray, indicating that it is referenced, and not local. If you open the Properties window for this component and click the Class tab, you can see that the original is in the ACTLIST.rol library file. ACTLIST.rol is the data supply library file generated from Siebel Tools.
- If you expand the datastream component, you can see that it has a child data row component, ssActionDataRow. This, too, is referenced rather than local, and comes with ssActionQuery from the data supply library file. If you open the Properties window for ssActionDataRow and click the Variables tab, you can see that the data row component consists of variables (such as ssAccount_Location, ssAccount_Name, and ssContact_First_Name) that are derived from the list of fields in the business component record supplying the data.
NOTE: Specifically, these fields are generated from the list of report field children of the report object definition from which the data supply ROL file is generated.
Data definition work for the report design is handled for you after you create your report and report field object definitions and generate the ROL file in Siebel Tools. In simple reports, the generated datastream is incorporated into your report design without modification, and you do not need to do anything else to set up data transfer between your Siebel application and Actuate.
- If you expand the page header component (ssFrmACTLISTHeader) and its child content frame (ssFrmBlueBack1), you can see how all the column heading labels and the blue line above them are defined. When you click a visual element in the layout pane or the structure pane, it is selected in both places. View the property list for one of the labels to see how its text, font, and other physical attributes are set up. Gray property text is the default from the parent object (ssLblHead in the sscustom.rol library); black text has been changed from the default.
- Click the Library Browser button. In the Choose Included Module window, double-click sscustom.rol. The listed components are library components; they serve as building blocks for your report. Browse through the list of library components in the sscustom library and compare them to similarly derived components in the report design.
Generally, any items that you need to incorporate into a simple report are derived from generic components in the sscustom.rol library (except the datastream, which comes from the data supply library). These library components generally require only minor modification after they are introduced into the report design. In Actlist.rod, the labels, text controls, content frames, horizontal lines, and pagelist are derived from library components in sscustom.rol.
You can now close or minimize the sscustom.rol Library Browser window.
- Expand the main content frame (ssFrmACTLISTContent). The child objects of this frame are data controls. A data control displays the value in a field (or fields) obtained through the datastream. Open the Properties window for one of the data controls and note the setting in the ValueExp property. The ValueExp property holds the expression that determines what appears in the text control.