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
  • BYOD_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 BYOD_config.xml.

Default Functionality:

This will run on a constant basis, accessing the email address you set up within the BYOD_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 BYOD_config.xml.

Modifying BYOD_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>
<Destination_Folder>C:\JetTrac\JobController\Server\Data\</Destination_Folder>
<XML_Destination_Folder>C:\JetTrac\JobController\Server\Data\</XML_Destination_Folder>
<PDF_Destination_Folder>C:\JetTrac\JobController\Server\Data\</PDF_Destination_Folder>
<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 Destination_Folder, XML_Destination_Folder, and PDF_Destination_Folder refer to the file path in which you want to save the attachments that POP3Scanner downloads from emails. XML_Destination_Folder is where any files with the .xml extension will be saved and PDF_Destination_Folder is where any files with the .pdf extension will be saved. In addition the Destination_Folder is where any files that are not .xml or .pdf will be saved to. It is likely that these three values will all be the same folder.

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:\BYOD_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 BYOD_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).