In this section: |
The only requirement for reporting is identifying a data source. Beyond that, the structure of a report request is very flexible and you only need to include the report elements you want. For example, you only need to include sorting instructions if you want your report to be sorted, or selection criteria if you want to report on a subset of your data.
The following are the most frequently used options for structuring a report request. (Except where otherwise noted, see Report Painter Basics in the Creating Reports With Report Painter manual for details about these and many other reporting features.)
You can sort information vertically, down a column, horizontally, or across a row. You can also combine vertical sorting and horizontal sorting to create a simple matrix.
For details see, Creating Temporary Fields.
For details, see Joining Data Sources in the Creating Reports With WebFOCUS Language manual.
For details, see Saving and Reusing Report Output in the Creating Reports With WebFOCUS Language manual.
You can run the request as an ad hoc query or save it as a procedure. Saving a report request as a procedure enables you to run or edit it at any time.
When working with WebFOCUS GUI tools that access directories and files from a UNIX system, the WebFOCUS Reporting Server returns lowercase directory names and files, by default. The WebFOCUS GUI tools also create directories and files in lowercase, regardless of the text case specified (for example, lowercase, uppercase, or mixed-case). If the user creates directories or files at the UNIX command level, they must create them in lowercase.
How to: |
A report request begins with the designation of a data source. You can then specify the details of your report request.
A report request can use a Master File that is stored in the application directory or in the WebFOCUS Reporting Servers APP PATH or baseapp directory.
or
The following image shows the Add Procedure dialog box that opens.
Procedure Viewer opens the Component Connector toolbox.
Report Painter enables you to create complex styled reports.
Compound (Layout) enables you to design reports, and to coordinate and distribute layouts made up of multiple reports and graphs in a single output file.
SQL Report Wizard assists you with SQL passthru which allows you to execute SQL code that retrieves data from an RDBMS. You can use the resulting extract file in the Report Painter or Graph Assistant.
Graph Assistant enables you to create a graph using an easy to use graphical tool.
Advanced Graph Assistant is a powerful graph tool that provides a user-friendly, easy-to-navigate interface with advanced functionality for creating and editing basic and complex graphs in Developer Studio and Managed Reporting Standard Reports.
Text Editor enables you to create a procedure with code.
If you selected Report Painter, Composer (Layout), or Text Editor, the selected tool opens.
If you select Procedure Viewer, the Component Connector toolbox opens. Do the following:
The Open dialog box opens.
The tool you selected opens.
The example in this topic is a simple report request that illustrates some of the basic functions of Developer Studio. However, there are many more functions not shown here that you can find information on throughout this documentation.
The following annotated example illustrates some of the basic functions of Developer Studio. The numbered explanation in this example corresponds with the code in this request. This request can be generated using Developer Studio graphical tools, or by typing the commands into a text editor.
1. JOIN PIN IN EMPDATA TO ALL PIN IN TRAINING AS J1 2. DEFINE FILE EMPDATA YEAR/YY=COURSESTART; 3. END 4. TABLE FILE EMPDATA 5. HEADING CENTER "Education Cost vs. Salary" 6. SUM EXPENSES AS 'Education,Cost' SALARY AS 'Current,Salary' 7. AND COMPUTE PERCENT/D8.2=EXPENSES/SALARY * 100; AS 'Percent' 8. BY DIV BY DEPT 9. WHERE YEAR EQ 1991 10. ON TABLE SUMMARIZE 11. ON TABLE SET STYLE * TYPE=HEADING, STYLE=BOLD, COLOR=BLUE,$ TYPE=REPORT, FONT=TIMES, SIZE=8,$ TYPE=REPORT, GRID=OFF,$ ENDSTYLE 12. END
The output is:
The request processes in the following way:
How to: |
When you exit a reporting tool, you are prompted to save the report you have created. For details see Report Painter Basics in the Creating Reports With Report Painter manual for additional save options available in that tool.
When you save a procedure created in the Report Painter or the Component Connector toolbox, the entire procedure is saved; not only the report component.
Close the reporting tool and choose Yes in response to the question: Do you want to update the FOCEXEC?
or
Select Save from the File menu. Your report is saved as a component in the procedure in which it was created.
If you add other components to a procedure or edit the report component, you will be prompted to update the FOCEXEC (FOCUS procedure). Click Yes to save your changes.
WebFOCUS |