Introduction:
Can be used to programmatically identify and highlight the differences between two versions of a PDF or XML.
Technical Support:
If you need assistance in installing and configuring JetTrac HighlightDiff™, call Pro Technology Automation, Inc. at 805-527-1248 or email us at support@protechinc.com. Please note that the JetTrac HighlightDiff™ license fee does not cover configuration services and technical support so there may be an additional charge. Please ensure you read these instructions carefully before calling for technical support.
How to Run JetTrac HighlightDiff:
To run JTHighlighDiff you will need these files in the same folder:
- JTHighlightDiff.exe
- ExitHandler.dll
- DebenuPDFLibraryDLL1311.dll
Executable files and dll files should not be edited for any reason.
Default Functionality:
Used in conjunction with JetTrac XMLDiff to identify differences between two XML’s/PDF’s. JetTrac HighlightDiff then highlights the fields in the two PDF’s that are different.
Job Step Configuration Window in JobConfig for JetTrac HighlightDiff:
When setting up a job step using JTHighlightDiff in JobConfig the only lines of the config you need to worry about are the first two and the last two, the Config file, Differences XML, the Input PDF and the Output PDF. If left as an asterisk * the input will be whatever file is in the data folder that triggered the job running. This works well if it’s the first step but if the input is also the output of a previous job step you would need to specify the fully qualified path of the input pdf you want to add highlights to. All other fields should be filled with the fully qualified path to the intended file. Eg: C:\JetTrac\…\input.pdf
In JobConfig, file paths entered should not be in quotes.
As with all modules, there is a dropdown to select whether or not the job should stop completely if this step fails. If you select Yes, any error will terminate the job process and write to the log file what happened, if no, then the job will try to continue anyways. However if any steps further down the line rely on the output of a job set to not stop on error, they may not work properly.
For more specifics go to the JetTrac Field ServiceJobConfig page.
JetTrac HighlightDiff Command Line:
“C:\JTHighlightDiff.exe” “C:\Differences.xml” “C:\JTHighlighDiff_Input.pdf” “C:\JTHighlightDiff_Output.pdf” “C:\JTHighlightDiff.ini” “C:\JTHighlightDiff.log”
The command line begins with the fully qualified path to the module’s executable file, followed by the path to the differences xml file, the input xml/pdf file, the output pdf, the config.ini file and ends with the log file.
JetTrac HighlightDiff Configuration.ini:
HighlightFieldParentNode=TagsMatchButValuesDifferent
HighlightFieldChildNode=Diff
HighlightFieldTag=TagName
HighlightColor=Yellow
Colors are expressed as a mixture of the three primary colors – red, green, and blue.
The relative mixture of each color is specified by a number between 0 and 1.
Close to 1 is a lot of that color, close to 0 is a small amount of that color.
So any color can be expressed as a series of three numbers between 0 and 1, separated by commas.
#
See the lines below for examples
Red is 1 for red, 0 for blue, and 0 for green
Blue is 0 for red, 1 for blue, and 0 for green
White is 1 for red, 1 for blue, and 1 for green
Shades of gray are the same number for r,g,b but that number is smaller than 1
DarkGrey is something like 0.2, 0.2, 0.2
#
lookup color mixing in wikipedia for more information
#
Red=1,0,0
Green=0,1,0
Blue=0,0,1
White=1,1,1
Black=0,0,0
Yellow=1,1,0
Magenta=1,1,0
Cyan=0,1,1
Grey=0.7,0.7,0.7
#
LightRed=1,0.8,0.8
LightBlue=0.8,0.8,1
LightGreen=0.8,1,0.8
#
DarkRed=1,0.2,0.2
DarkBlue=0.2,0.2,1
DarkGreen=0.2,1,0.2