Introduction:
The following document will go through the functionality found within JetTrac PrepopFieldList. This module is used to along with JetTrac PrepopSaveData in order to prepopulate XML data from previous PDF submissions into future dispatched PDFs. This module inputs XML data from a PDF form and outputs a text file with the name of each field on the form that has a value.
Please note that any files edited while setting up JetTrac PrepopFieldList should be edited using Notepad or Notepad++. Do not use Microsoft Word or Wordpad as these text editors will add formatting that will interfere with the program reading the files.
Technical Support:
If you need assistance in installing and configuring JetTrac PrepopFieldList™, call Pro Technology Automation, Inc. at 805-527-1248 or email us at support@protechinc.com. Please note that the JetTrac PrepopFieldList™ 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 PrepopFieldList:
To run the program, you will need to have the following files located in the same folder:
- JTPrepopFieldList.pl
- perl.exe
- perl524.dll
The files are required for the program to run and should never be edited.
Default Functionality:
JetTrac PrepopFieldList inputs an XML with field data, any fields found to have a value within them are then saved to an output .txt file. Within the output .txt file only the field names are saved, not the actual value of the fields.
Job Step Configuration Window in JobConfig for JetTrac PrepopFieldList:
When setting up a job step using JTPrepopFieldList you will need to enter in an output .txt file and an input .xml file.
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 PrepopFieldList Command Line:
The command line for JetTrac PrepopFieldList is as follows:
Each part of the line is divided by spaces (the amount doesn’t matter), and contains the fully qualified file path to the file you are referencing surrounded by quotes.
C:\JetTrac\Extras\Perl\perl.exe “C:\JTPrepopFieldList.pl” “C:\input.xml” “C:\output.txt”
In this we are referencing the Perl executable, the module Perl script, the input XML file, and the output text file.
Additional Notes:
This modules functionality is specialized to work in tandem with JetTrac PrepopSaveData in order to allow you to prepopulate “previous inspection” data. When set up both modules work to save data from a specified list of fields on each returned inspection so that the next inspection can be populated with that data during the dispatch.