Trackable Reports

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.

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.

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.

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.

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.

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)

begin

Text := ‘’

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

begin

if JimSystem(‘ReportTrackable_PrintCount’) = 0 then

Text := ‘First time printed’

else

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

end

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

ReportLogger.IsLogging

ReportLogger.PrintCount

ReportLogger.PreviewCount

Reportlogger.ExportCount

Sample Scripting Engine code:

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

begin

// first time printed

...

end