|
The POP3ToJes utility is currently deprecated and will not be supported in the future. The equivalent functionality should be achieved by adding the appropriate email address to Jim2 to bring the email into Jim2 and creating a rule to process the email as an order. We recommend also configuring email archive rules to delete these emails after a short period of time to save database space. Refer to the Process As Order email rule. |
The POP3ToJes utility is used to download order emails from a POP3 email account and forward them to the Jim2 eBusiness Server (Jes) for processing. It can usually be found in the installation directory with Jes: C:\program files\happen business\jes\bin
|
You should not attempt setting up this utility unless you are confident editing your system registry. According to Microsoft:
'Using Registry Editor incorrectly can cause serious, system-wide problems that may require you to re-install Windows to correct them. Microsoft cannot guarantee that any problems resulting from the use of Registry Editor can be solved. Use this tool at your own risk.' |
Generating the Encryption Key
An encryption key can be generated using the -gk command line option. For example, run the following from a command prompt in the directory containing the POP3ToJes.exe file:
POP3ToJes -gk:C:\happen\keys\keyfile.bin
This will generate an encryption key in the file C:\happen\keys\keyfile.bin.
You will need to use this same file where you encrypt the email content for emailing to your online order email account.
To get the utility to use the key when decrypting emails, execute:
POP3ToJes -uk:C:\happen\keys\keyfile.bin
Note that the -uk option can only be used after the registry settings have been created (see below).
Configuring the Utility
Configuration for the utility must be set up in the registry under the HKEY_LOCAL_MACHINE\SOFTWARE\Happen Business\POP3ToJes key. This is a manual process and you will have to use the Registry editor or similar.
The values are as follows:
JesIP
string
The IP address for the Integration Server. Can be either the dotted IPv4 address or the DNS name of the machine.
JesPort
DWorD
The TCP/IP port for the Integration Server. Normally set to 5740.
POP3ServerIP
string
The TCP/IP address for the POP3 mail server. Can be either the dotted IPv4 address or the DNS name of the machine.
POP3ServerPort
DWorD
The TCP/IP port for the POP3 server. Optional. Normally not set.
POP3userID
string
The user ID for the account on the POP3 mail server.
POP3Passwd
string
The password for the account on the POP3 mail server.
POP3UseSSL
DWorD
Flag to indicate if SSL support is required. 0 to not use SSL, 1 to use SSL. Optional. Normally not set.
SMTPSenderAddress
string
The email address from which to send emails that could not be submitted to the Integration Server.
SMTPRecipientAddress
string
The email address to send emails to that could not be submitted to the Integration Server.
EncryptionKeyFile
string
The name of the file containing the encryption key with which to decrypt email content. Leave out if no decryption is required. This value is normally set using the utility's -uk command line option. This value is optional.
Example configuration
This example is shown in the format as exported by the registry editor.
Windows Registry Editor Version 5.00
[HKEY_LOCAL_MACHINE\SOFTWARE\Happen Business\POP3ToJes]
'JesIP'='127.0.0.1'
'JesPort'=dword:0000166c
'POP3ServerIP'='wendy'
'POP3ServerPort'=dword:0000006e
'POP3userID'='MailTest'
'POP3Passwd'='dodgybros'
'SMTPSenderAddress'='sender@nowhere.nowhere'
'SMTPRecipientAddress'='admin@nowhere.nowhere'
'SMTPServer'='pop3server.internal.company.nowhere'
'EncryptionKeyFile'='C:\\temp\\jimkey.bin'
Further information: