JetTrac POP3Scanner

Introduction:

The following document will go through the functionality found within JetTrac POP3Scanner. This can be used to pull email attachments from any emails that arrive at a specified email address and drop these attachments into a locally stored folder.

Please note that any files edited while setting up AcroFieldScrub 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 POP3Scanner™, call Pro Technology Automation, Inc. at 805-527-1248 or email us at support@protechinc.com. Please note that the JetTrac POP3Scanner™ 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 POP3Scanner:

To run the program, you will need to have the following files located in the same folder:

  • JTPop3Scanner.exe
  • ExitHandler.dll
  • Field Service_config.xml

The JTPop3Scanner.exe and ExitHandler.dll are files required for the program to run and should never be edited.
In addition you will need to have a configuration .xml file named Field Service_config.xml.

Default Functionality:

This will run on a constant basis, accessing the email address you set up within the Field Service_config.xml file and looking for new emails. When a new email is found, POP3Scanner will download any attachments the email has and save them to the folder you specify within Field Service_config.xml.

Modifying Field Service_config.xml:

This file must be a valid XML file. Here is an example:

<Configure_JetTrac_Pop3_Monitor>
<POP3_Server_Address>ssl:pop.gmail.com</POP3_Server_Address>
<POP3_Server_Port>995</POP3_Server_Port>
<User_Name>address@gmail.com</User_Name>
<Pass_Word>password</Pass_Word>
<ActiveAttachmentExtensions>.pdf|.xml</ActiveAttachmentExtensions>
<Destination_Folders>C:\JetTrac\JobController\Server\Data\|C:\JetTrac\JobController\Server\Data\</Destination_Folders>
<QueFile>C:\JetTrac\JobController\Server\Log\QueueFile.log</QueFile>
<RepeatIntervalSeconds>10</RepeatIntervalSeconds>
<MetaDataWanted>Y</MetaDataWanted>
</Configure_JetTrac_Pop3_Monitor>

Each of these nodes within the XML set up a different part of POP3Scanner. The first four values refer to the email address information you will be watching with POP3Scanner. The POP3_Server_Address, POP3_Server_Port, User_Name, and Pass_Word nodes are the POP3 login information for your email address and can be obtained from your email provider.

The ActiveAttchmentExtensions key value is a pipe-delimited list of the file extension types you wish to pick up and download to a local folder. After this is another pipe-delimited list for the Destination_Folders. This second list includes all of the folders you wish to use for each specific file extension. The first fully qualified folder file path is where the first extension in the previous key value will be placed, the second will be for the second, etc. It is likely that all of the folder file paths in the second key value will be the same.

The QueFile key value node is the fully qualified file path for a .log file that you wish to use to store the log data for the dashboard. If you are not using the Dashboard GUI you do not have to worry about modifying this line and can leave it as is.

The RepeatIntervalSeconds node is used to specify how often the POP3Scanner program will attempt a POP3 connection to the email address and check for new emails. This value is always in seconds.

The MetaDataWanted node is set to either “Y” if you wish to save any meta data associated with the email, or “N” if you do not want to save this.

Setting Up the POP3Scanner Command Line:

POP3Scanner in not a module, and therefore is run outside of JetTrac. You can either run this as a .bat file or you can also set up a service to run automatically. The command line for POP3Scanner is:

“C:\JTPop3Scanner.exe” “C:\Field Service_config.xml” “C:\POP3Scanner.log”

The first item in the command line is the location of the executable file, followed by the location of the Field Service_config.xml file and lastly the log file.

Additional Notes:

Please note that the information to set up your email address is specific to your email provider and will be the same information as setting up POP3 for anything else (third party mail applications such as Outlook).