ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

This content has been translated automatically.  Click here  to view the French version.
Help / Editors / Report editor / Data sources
  • Overview
  • Creating a report based on an HFSQL view
  • Printing a report based on an HFSQL view
  • To print a report based on an HFSQL view
  • WINDEV example
WINDEV
WindowsLinuxJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac Catalyst
Others
Stored procedures
Report based on an HFSQL view
HFSQL ClassicHFSQL Client/ServerAvailable only with these kinds of connection
Overview
A report based on an HFSQL view is used to print records from an HFSQL Classic or Client/Server view.
Reminder An HFSQL view is a "memory treemap" of all or part of a data file. A view is stored in memory, which insulates it from the modifications made to the associated data file. Once created, a view can be handled like any HFSQL data file. For more details, see HFSQL views.
Characteristics of a report based on an HFSQL view:
  • a report based on an HFSQL view is linked to the base file of this HFSQL view. The report is used to print the records coming from this base file.
  • the order in which the records are printed corresponds to the order of the records found in the HFSQL view (defined when creating the view or by HSortView).
A report based on an HFSQL view can be created via the report creation wizard.
When the report based on an HFSQL view is created, you can:
  • change the data source of the report ("Data" tab in the report description).
  • add or delete Item controls linked to the HFSQL view associated with the report.
Reports & Queries cannot be used to create reports based on an HFSQL view. However, it is possible to customize reports on an HFSQL view created in the built-in report editor (color, fonts, size, etc.).
Creating a report based on an HFSQL view
To create a report based on an HFSQL view:
  1. Click in the quick access buttons.
    • The new element window appears. Click "Report", and then "Report".
    • The report creation wizard opens.
  2. Choose the layout of your report (table, form, label, ...). For more details, see The different types of reports.
  3. Select (if necessary) the report template to use. A report template allows you to use a specific layout. For more details on report templates, see Report templates.
  4. Select the data source of the report ("Other (programming, text file, memory area, HFSQL view, ..." option).
  5. Select the type of data source for the report ("From an HFSQL view").
  6. Select the base data file of the HFSQL view associated with the report.
  7. Select the items displayed in the report. Only the controls linked to the items of the HFSQL view will be filled.
    For each item displayed in the report:
    • type the corresponding caption. This caption will be displayed:
      • before the item. For example:
      • in the column header (for the Table reports). For example:
        You can also change the caption directly in the report editor.
    • select the block where the control associated with the item will be printed. The positions of different controls can be modified in the report editor. For more details on the different blocks and their position in a report, see Report blocks.
  8. Modify (if necessary) the display order of controls in the report with the arrow buttons found on the right of table.
  9. If the HFSQL view associated with the report contains at least one numeric item, you have the ability to perform calculations these items. Specify the calculation performed for each item (sum, average, ...). Two types of calculations are available:
    • general calculation: a Calculated field will be created in the block End of document.
    • calculation on break (useless in this type of report).
  10. Depending on the type of report being created, indicate the specific options.
    Type of reportSpecific options
    Report based on a formForm image, printing the form image, ...
    Options presented in detail in Report based on a form
    Label reportFormat of labels, number of identical copies, ...
    Options presented in detail in Label report
  11. Specify the format of the sheet on which the report will be printed. By default, the report is printed in A4 format.
    Note: By default, the report controls are displayed in a single column. To create a multi-column report, simply specify the desired number of columns in the "Format" tab of the report description window.
  12. Select the skin template of the report if necessary.
  13. Type the name and title of the report (name of the ".WDE" file corresponding to the report). This name will be used to identify the report in your programs.
  14. Confirm the report creation.
  15. The report editor automatically suggests changing the report format in the following cases:
    • the report includes a table.
    • the report format does not allow to display all table columns.
  16. If necessary, specify the mode for reducing the size of the report:
    • Print the report on several pages. In this case, the end user will have to group the pages. For more details, see Print on multiple pages.
    • Use the landscape mode.
    • Reduce the report size. Note: Depending on the reduction percentage selected, the printed report may become illegible.
  17. The report is displayed in the report editor.
Printing a report based on an HFSQL view

To print a report based on an HFSQL view

  1. Create the HFSQL view with HCreateView (or with HMergeView).
  2. Configure the report print destination:
      For more details, see Print modes of a report.
    • Specify the following parameters with iPrintReport:
      • name of the report to be printed.
      • the name of the HFSQL Classic view used.
    Remarks:
    • The HFSQL view must be created and initialized before printing the report. Only an HFSQL Classic or Client/Server view can be used.
    • If additional parameters must be passed to the report, these parameters must be specified in iPrintReport, after the name of the HFSQL view used. For more details, see Report with parameters.
    • When used in the code of the report, the ViewName property allows you to get and change the name of the HFSQL view associated with the report.
    • When used in the code of the report, the SourceName property allows you to get and change the name of the base data file of the HFSQL view associated with the report.
    In Reports & Queries, you can print a report:
    • by starting a print job ().
    • by testing the report ().
    Therefore, no programming is required to print the report.
    Reports and Queries

    WINDEV example

    The user selects the reference of an order in a list. "BTN_Print" allows you to:
    In this example, the click code of "BTN_Print" is as follows:
    // Créer la vue
    IF HCreateView("VueCommande", LigneCde, "*", "Référence", "", "", hViewExclusive + hViewBreakable) = False THEN
    	Error(HErrorInfo())
    ELSE
    	// Ouvrir le visualisateur de rapports
    	iDestination(iViewer)
    	// Imprimer l'état ETAT_Vue
    	iPrintReport(ETAT_Vue, "VueCommande")
    END
    Related Examples:
    Generate_reports Training: Generate_reports
    [ + ] This example shows the different methods for creating a report:

    - reports based on different data sources (queries, variables, etc.)
    - reports based on controls (Table, Spreadsheet, Pivot Table, etc.)
    - printing composite reports
    - specific reports (portrait/landscape, watermarks, reports with bar codes, etc.)
    Minimum version required
    • Version 9
    This page is also available for…
    Comments
    Click [Add] to post a comment

    Last update: 10/08/2025

    Send a report | Local help