Using CitectSCADA > Reporting Information > Report Format File

Report Format File

The report format file specifies how data is formatted in a report. You can use fixed text, Cicode expressions, and database variables in any report.

You use a text editor that is supported by Windows to create (and modify) the report format file. If your report format file is in RTF (Rich Text Format), use Microsoft Wordpad.

Including fixed text

You can include fixed text in the report, specifying the text exactly as you want it to appear (for example, Name of Report, Description, and so on).

Including OLE (RTF files only)

Objects can be linked to or embedded within an RTF report format file; however, such objects will not be displayed or printed from CitectSCADA.

Using fonts (ASCII format only)

If your format file is in ASCII format, you can use any text font supported by Windows in the report. To specify a font, use the PrintFont() function. RTF format files do not require this function, as they use the formatting features of the host word processor.

Including Cicode expressions and variables

You can include Cicode expressions and variables by enclosing them (and optional format specifications) in braces {} - for example:

{TIME(1)  } 
{PV12:####.##}
{PV12:4.2}

The size of each field (number of characters) is determined by either the format specification, or by the number of characters between the braces. In the above example, the variable PV12 is formatted with four characters before the decimal point and two characters after.

You do not have to include the format, for example:

{PV12}

Here, the variable is formatted using only four characters (the number of characters between the braces).

The following rules apply when logging a report to a database device:

Including blocks of Cicode

You can include a block of Cicode, using the following format:

{CICODE}
Statements;
{END}

The block of Cicode is delimited by the commands {CICODE} and {END}. After the {END} command, the report switches back into WYSIWYG mode. If the entire report is Cicode or the last section is Cicode, the {END} command is not necessary.

A block of Cicode does not send any output to the device unless you use either the Print() or PrintLn() functions. If you use one of these functions, the argument is printed to the device.

Cicode variables (ASCII format only)

You can also declare variables for use within your Cicode block. This is not available in RTF or HTML format files. Declare any variables at the beginning of the file (i.e. before any report format or Cicode). Add a {CICODE} block first; for example:

{CICODE}
INT nVar1;
STRING sVar2;
Statements;
{END}

Remainder of report

Including comments

You can include comments by using the comment character `!' enclosed in braces - for example:

{!This is a Comment}

A comment in the body of a report differs from a comment in a Cicode block: a comment in a Cicode block does not require braces.

Including other report elements

The following table describes other elements you can include in reports.

To...

Do this...

Issue a form feed

Use a form feed specifier: {FF}

Include a plot

Use the Plot functions.

Include trend data

Use the TrnGetTable() function.

Include trend graphs

Use the TrnPlot() function.

See Also