Skip to main content
Version: 4.x

Print view

Print view of the form consists of a set of templates (reports). When data is substituted in these templates, a document is formed in graphic (with pixel positioning) or pseudographic (with cell positioning) format. This document is displayed to the user using a special graphic component, inside which the user can navigate through pages, zoom in/out within pages and print the contents of the component or export it to various formats (for example, PDF or Excel). If necessary, it is possible to skip the display of the component to the user and send the document for printing or save it into a selected file in the specified format.

For each report, a set of the form object groups that it will display is determined.

Report hierarchy

Similar to an object group, each report has a parent report, so all reports form a hierarchy. The report hierarchy should:

  • include the hierarchy of object groups, i.e. if a group of objects of one report is a child of a group of objects of the other report, then the first report must match the second one or be its child as well
  • within one report, each group of objects must have exactly one child.

Building report hierarchy

Based on the report hierarchy restrictions, only "chains" of object groups can be included in one report (i.e., G1, G2, G3, ... Gn, where G2 is the only linear child object of G1, G3 is the only child of G2, etc.). Thus, the decision on how to break object groups into reports comes down to whether to merge an object group with its only child (if there is one) or not. By default, such a merge is performed, however, if necessary, the developer can disable it by specifying the corresponding option (SUBREPORT) for a child object group.

info

Using this option comes down to whether to display data for a parent object group when the child object group has no data.

Report hierarchy example

The form is similar to the example of building an object group hierarchy:


FORM myForm 'myForm'
OBJECTS A, B SUBREPORT, C, D, E
PROPERTIES f(B, C), g(A, C)
FILTERS c(E) = C, h(B, D)
;

The report hierarchy for this form is built as follows:

nullABmarkedSUBREPORTCEnull AСEDDB

Language

All of the above options, as well as defining the form structure, can be done using the FORM statement.

Open form

To display the form in print view, the corresponding open form in the print view operator is used.

Examples

FORM printOrder
OBJECTS o = Order
PROPERTIES(o) currency, customer

OBJECTS d = OrderDetail
PROPERTIES(d) idSku, price
FILTERS order(d) == o
;

print (Order o) {
PRINT printOrder OBJECTS o = o; // printing

LOCAL file = FILE ();
PRINT printOrder OBJECTS o = o DOCX TO file;
open(file());

//v 2.0-2.1 syntax
LOCAL sheetName = STRING[255]();
sheetName() <- 'encrypted';
PRINT printOrder OBJECTS o = o XLS SHEET sheetName PASSWORD 'pass';

//v 2.2 syntax
//PRINT printOrder OBJECTS o = o XLS SHEET 'encrypted' PASSWORD 'pass';
}