Show/Hide Toolbars

Jim2® Business Engine Help File

Trackable reports allow a report to be tracked when printed, emailed or exported (logged in History) from a security point of view, and records the number of times this has happened, providing printed X times functionality on reports, etc.


By default, all reports are not tracked, and must be flagged as Trackable to enable this functionality.



It is recommended to only flag key reports as trackable, based on either security requirements, or if printed X times  functionality is required (eg. picking slips).


Whenever a trackable report is previewed/printed/emailed/exported, a history log entry is made that includes the following information:

date and time report invoked

user who invoked the report

related Jim2 object (job, quote etc.)

related Jim2 object number (job no, quote no)

report event (print, preview emailed, etc.)

report path and name.


Mark a report trackable


System reports should never be modified – make a copy of the existing system report and make changes to that copy. This ensures that reports don't become broken during upgrades. A warning will pop to screen that system reports cannot be edited.


report cannot edit


To mark a report trackable, open Report Designer via Tools > Report Designer. Choose the report and select Properties on the ribbon. Change the Trackable report property to True.


mark report trackable


View a trackable report’s history

If a report is trackable and related to a Jim2 object (job, quote etc.), the report log is displayed within the history of that object. For example, if a picking slip was printed for Job#16 (image below), the log of that is displayed when viewing the history of Job#16.


trackable report history


For reports that are not related to an object, or to see any trackable reports, select Report Tracking as the object in the Tools > History selection criteria.


report tracking


Access trackable report variables

One of the benefits of marking a report trackable is the ability to display how many times it has been printed on the actual report.


Several variables are available within Report Designer, via the JimSystem report pipeline, to enable this functionality.


Report DataPipeline

Report Variable






Ticked if report is trackable.




Number of times exported.




Number of times previewed.




Numbers of times printed.


Typically, a Label component would be added to a report, and add an OnGetText event to that label with RAP code as follows:


procedure LabelTrackableOnGetText(var Text: String)



Text := ‘’


if (JimSystem(‘ReportTrackable’) = ‘T’) and (JimSystem(‘ReportDestination’) = ‘Printer’) then



if JimSystem(‘ReportTrackable_PrintCount’) = 0 then

Text := ‘First time printed’


Text := ‘Report print count = ‘ + IntToStr(JimSystem(‘ReportTrackable_PrintCount’))



The following properties are available within the Scripting Engine via the ReportLogger object







Sample Scripting Engine code:


if (ReportLogger.IsLogging) and (ReportLogger.PrintCount = 0) then


// first time printed




Further information

Report Designer

Report Designer at a Glance

Report Designer Menus

Report Designer Errors

Report Designer Toolbar

Report Explorer

Report Explorer Functions

Signable Reports


How to

Add a Signable Report for Jim2 Mobile

Add Images to Reports

Add Logo to Stick Report

Add Text to Reports

Change Sticker Report Size

Display Company Logo In Reports

Export a Report

Import a Report

Locate Reports to Export

Make a Report Inactive

Open a Report for Redesign

Set up Back of Page Text on Invoice


For more detailed information regarding Report Designer please refer to (copy and paste into a web browser).