Customising Report Layout

In Patriot 6, it is possible to customise or completely redesign the report layout to suit the needs of your company. There is standalone software which is required to modify the reports and re-import them into Patriot.

Prerequisites

The Microsoft Report Builder 2.0 must be installed in order to edit the report files. This can be downloaded from the Microsoft website at

Note: Do not install version 3.0 of this program as it is incompatible with Patriot.

Export Process

Reports should be created by modifying the existing standard report provided by Patriot. To export the report from Patriot, open the Reports->Settings->Report Names screen. Select the report that you want to export. If you want to make sure that you have the latest report file, click on the web download button and it will be downloaded from the Patriot webserver for you. Next, select the Export button, and an RDLC file will be saved. This file must be renamed to .RDL before it can be edited in the Report Builder.

Note: It is also possible to use the web download button to return the report to the standard layout if required. This will overwrite the existing RDLC file including customisation, so please ensure you have a backup of any customised files before doing this.

Modifying the report layout

Run Microsoft Report Builder 2.0. Open the .RDL file created above. You may get warnings about selecting a Report Server. You can safely ignore these, as Patriot will configure these settings when the report is run. Simply cancel the Report Server warning and continue editing.

Once the report has been opened in Report Builder, you will see a graphical editor that allows you to redesign the report as needed. For example, you can add extra text boxes, change fonts, add sections, and remove unneeded information. The report data itself is provided in a list along the left side of the screen. Extra fields can be dragged from this section onto the report to be included. The full features of the Report Builder are outside the scope of this document. More information can be found on the Microsoft website and around the web.

Adding Report Images

Images can be added to the report file by selecting Insert -> Image. For standard fixed images (e.g. Monitoring Station logo), select the image source as Embedded, and browse to the required file. The image will then be copied inside the .RDLC file itself, and the original is no longer required.

It is also possible to define a per-user image (e.g. for Dealer Branding, or Installer Logos). See Dealer Branding for information on how to save the images and enable branding.

Once this is configured, change the image settings in the RDLC file to match the following:

Image source : Database.

Use This Field:

=First(Fields!InstallerLogo.Value, "PresetReportDataSet")

Use This MIME Type:

=First(Fields!InstallerLogoMIME.Value, "PresetReportDataSet")

On the Visibility tab, select Show Or Hide Based On An Expression and set the expression to:

=IsNothing(First(Fields!InstallerLogo.Value, "PresetReportDataSet"))

This will display the dealer image as required, and hide the image area if the user has no image or if the report is being run for a single client grouping. Images will not be included if Dealer Branding is disabled.

Note: Patriot enforces a maximum file size for RDLC files when importing. Because standard images are stored inside the .RDLC file, embedding a lot of images could cause the maximum file size to be reached. If this happens, use smaller images or remove unnecessary items to reduce the file size.

Importing the file back into Patriot

Once the file is modified to suit, you can import it back into Patriot to test. First, you will need to rename the file back to .RDLC. Then, simply return to the Reports -> Settings -> Report Names screen in Patriot. If you wish to replace the existing report, you can select this report, browse to your new file, and import it.

It is also possible to create a new report so that multiple layouts for the same report can be used (e.g. for different customers). To do this, click on the + button, and enter the details. Select the same Report Type from the selection menu to make sure that the correct data is loaded for the report. Then, import your layout file as before.

You may need to log out and back in on the Patriot client before the new report appears in the menu.

Custom reports available for download

There are some examples of existing custom reports available from the following page:

Downloadable Custom Report Layouts

Incident Report Details Customisation

The Incident Report contains some information which is pre-processed by Patriot before being displayed in the RDLC, such as activation creation time, operator actions, and provided notes. Due to this information being processed before the RDLC layout, it is not possible to edit the information in the standard way. The phrases used can be edited through the translation options. See the translation documentation for a general overview of translating segments of Patriot. Once translation is set up, change the required phrases in the IncidentReportRes file. If a certain piece of information is not required in the report, leave the translated phrase blank. This will remove the phrase and the associated information. Ensure that the 'Translated' check-box is enabled to include the blank phrase. By default, a blank phrase indicates to use the original English phrase instead of translating.