Automatic e-mail faxing
               
This website provides a short description how to configure MailToFax_Server so it can automatically fax e-mails sent to a specifed mailbox.        
               
               
MailToFax_Server Configuration    
The application resides in Windows system tray as a gray ball icon. When run for the first time or when something is wrong with your e-mail server connection, the icon becomes red. Error descriptions are always written into log files.    
Quick start              
When running the application for the first time, it is necessary to adjust mailbox settings. This can be done in the configuration window opened from the right-click menu. This window contains other available configuration settings as well.    
               
Registry entries    
[HKLM_MailToFax_Server] = HKEY_LOCAL_MACHINE\ SOFTWARE\ ROMICO\ MailToFax_Server    
               
Name Location Example Description Registry Key example Version    
Settings packages    
All mandatory POP3 settings [HKLM_MailToFax_Server]\
Mailbox
"POP3_ServerIp"="pop.example.com"
"POP3_ServerPort"="110"
"POP3_UseSSL"="0"
"POP3_User"="user_name"
"POP3_Password"="password"
"POP3_AuthenticationMethod"
    ="UsernameAndPassword"
All mandatory POP3 settings in a single file. These settings are necessary for the application to be able to receive e-mails for faxing. MailToFax_Server_Mailbox_
POP3_All.reg
MailToFax_Server: >= 1.0.0.230; 16.07.2012    
               
General and e-mail notification settings    
AppData_Path [HKLM_MailToFax_Server] "AppData_Path"="" A non-standard application data folder for the application.
[Default "%AppData%"] [Restart  necessary]
MailToFax_Server_AppData_
Path.reg
MailToFax_Server: >= 1.0.0.230; 16.07.2012    
CapiFaxWaitTimeout_ms [HKLM_MailToFax_Server]\
Settings
"CapiFaxWaitTimeout_ms"="120000" Determines how long to wait for CapiFax to finish processing a single file to be faxed.
[Default "60000"] [Restart  unnecessary]
MailToFax_ Server_Settings_
CapiFaxWaitTimeout_ms_
120000.reg
MailToFax_Server: >= 1.0.0.230; 16.07.2012    
PrintDialog_FileExtensions [HKLM_MailToFax_Server]\
Settings
PrintDialog_FileExtensions"=
".htm;.html"
In some cases print requests cause a print dialog window to show up. This semicolon-separated file extensions refer to files which cause that dialog to show up when printing them. MailToFax_Server will be expecting the window to show up for these file types only.
[Default ".htm;.html"] [Restart  unnecessary]
MailToFax_Server_Settings_
PrintDialog_FileExtensions_
htm_html.reg
MailToFax_Server: >= 1.0.0.230; 16.07.2012    
PrintDialog_ShowTimeout_ms [HKLM_MailToFax_Server]\
Settings
"PrintDialog_ShowTimeout_ms"=
"45000"
If a given file type causes a print dialog to show up during faxing, this value determines how long to wait for the dialog to show up. If it does not show up within the period specified, the current faxing operation fails.
[Default "30000"] [Restart  unnecessary]
MailToFax_ Server_Settings_
PrintDialog_ShowTimeout_ms_
45000.reg
MailToFax_Server: >= 1.0.0.230; 16.07.2012    
PrintDialog_Text [HKLM_MailToFax_Server]\
Settings
"PrintDialog_Text"="Print" Determines the title of the print dialog window by which MailToFax_Server finds the window to confirm printing automatically.
[Default "Drucken" and “Print”] [Restart  unnecessary]
MailToFax_ Server_Settings_
PrintDialog_Text_Print.reg
MailToFax_Server: >= 1.0.0.230; 16.07.2012    
PrintDialog_PrintButtonText [HKLM_MailToFax_Server]\
Settings
"PrintDialog_PrintButtonText"="&Print" Determines the title of the OK button of the print dialog window. This value is used by MailToFax_Server when looking for the print dialog window to confirm printing automatically.
[Default "&Drucken" and “&Print”] [Restart unnecessary]
MailToFax_ Server_Settings_
PrintDialog_PrintButtonText_
&Print.reg
MailToFax_Server: >= 1.0.0.230; 16.07.2012    
FaxingInterval_ms [HKLM_MailToFax_Server]\
Settings
"FaxingInterval_ms"="10000" Determines the time interval between consecutive faxing operations. This means how much time has to pass from the moment when the capifax.nxt file is deleted by CapiFax before a next faxing operation can start.
[Default "5000"] [Restart  unnecessary]
MailToFax_ Server_Settings_
FaxingInterval_ms_10000.reg
MailToFax_Server: >= 1.0.0.230; 16.07.2012    
CapiFaxDefaultWorkDir [HKLM_MailToFax_Server]\
Settings
"CapiFaxDefaultWorkDir"="" Determines the default working directory of CapiFax. It should be copied (before starting MailToFax_Server) from the “WorkDir” value of the following registry key:
[HKCU]\ SOFTWARE\ Shamrock\ CapiFax.
[Default ""] [Restart  necessary]
MailToFax_Server_Settings_
CapiFaxDefaultWorkDir.reg
MailToFax_Server: >= 1.0.0.423; 24.07.2012    
CTI_Config_MdbFilePath [HKLM_MailToFax_Server]\
Settings
"CTI_Config_MdbFilePath"="" Determines the path to a CTI_Config_xxx.mdb file of CTI_Server. The database file pointed to by this path (if any) will be the only one used for user identification.
[Default – the path to the CTI_Config_001.mdb file if CTI_Server is installed.] [Restart  necessary]
MailToFax_Server_Settings_
CTI_Config_MdbFilePath.reg
MailToFax_Server: >= 1.0.0.423; 24.07.2012    
FaxNumberExtractionPattern_
EmailRecipientAddress
[HKLM_MailToFax_Server]\
Settings
"FaxNumberExtractionPattern_
EmailRecipientAddress"=""
Defines a regular expression used to extract fax number from e-mail address. This regular expression is used only when fax number is extracted from e-mail recipient address (which is the default configuration setting).
The regular expression has to be defined in such a way that it matches only that fragment of e-mail address which represents a fax number.
[Default "[\+]?[0-9#*/()\- ]+(?=@)"] [Restart  unnecessary]
MailToFax_Server_Settings_
FaxNumberExtractionPattern_
EmailRecipientAddress.reg
MailToFax_Server: >= 1.0.0.622; 29.10.2012    
FaxNumberExtractionPattern_
EmailSubject
[HKLM_MailToFax_Server]\
Settings
"FaxNumberExtractionPattern_
EmailSubject"=""
Defines a regular expression used to extract fax number from e-mail subject. This regular expression is used only when fax number is extracted from e-mail subject.
The regular expression has to be defined in such a way that it matches only that fragment of e-mail subject which represents a fax number.
[Default "(?<=\bFAX:[ ]*)[\+]?[0-9*#]+"] [Restart  unnecessary]
MailToFax_Server_Settings_
FaxNumberExtractionPattern_
EmailSubject.reg
MailToFax_Server: >= 1.0.0.520; 27.07.2012    
UnknownSenders_Enable [HKLM_MailToFax_Server]\
Settings
"UnknownSenders_Enable"="1" Determines if unknown e-mail senders should be allowed to fax. If this flag is set to 1, documents from unknown senders are faxed using the default CapiFax account. It means that in that case only the default user will receive faxing reports and not the actual sender of the document.
An unknown sender is a sender that does not exist in CTI_Server users database.
[Default "0"] [Restart unnecessary]
MailToFax_Server_Settings_
UnknownSenders_Enable
_1.reg
MailToFax_Server: >= 1.0.0.623; 30.10.2012    
IdentifyUsersByFaxNumber_
Enable
[HKLM_MailToFax_Server]\
Settings
"IdentifyUsersByFaxNumber_Enable"=
"1"
If this value is set to 1, it is assumed that e-mail addresses of senders contain their own fax number (e.g. +1234567890@example.com). In that case the number is extracted from the address and searched for among all fax numbers of CTI Server fax users. This is the way users are identified.
When this value is set to 0 (default), users are identified directly by their e-mail addresses.
[Default "0"] [Restart unnecessary]
MailToFax_Server_Settings_
IdentifyUsersByFaxNumber_
Enable_1.reg
MailToFax_Server: >= 1.0.0.612; 02.08.2012    
FaxingError_Hold_Enable [HKLM_MailToFax_Server]\
Settings
"FaxingError_Hold_Enable"="1" If faxing can’t continue because of some external error (e.g. Adobe Reader does not print documents), e-mail processing can be held until the administrator reacts to the problem. If this flag is set to 1 and such problem occurs, an error message will be displayed and faxing will be stopped until the message box is closed. This approach should preserve unprocessed e-mails from deletion, because usually this problem can’t be solved automatically.
[Default "0"] [Restart unnecessary]
MailToFax_Server_Settings_
FaxingError_Hold_Enable
_1.reg
MailToFax_Server: >= 1.0.0.622; 29.10.2012    
FaxingError_OnHold_
NotificationAddress
[HKLM_MailToFax_Server]\
EmailReports
"FaxingError_OnHold_
NotificationAddress"
="support@romico.de"
If the FaxingError_Hold_Enable flag is set to 1, this e-mail address is used to notify its owner about holding faxing process, when an external faxing error occurs.Optional.
[Default: empty] [Restart unnecessary]
MailToFax_Server_
EmailReports_
FaxingError_OnHold_
NotificationAddress_
support@romico.de.reg
MailToFax_Server: >= 1.0.0.622; 29.10.2012    
AcceptEmailsFromUnknown
Senders_Enable
[HKLM_MailToFax_Server]\
Settings
"AcceptEmailsFromUnknownSenders_
Enable"="1"
Determines if unknown e-mail senders should be allowed to fax. If this flag is set to 1, documents from unknown senders are faxed using the default CapiFax account. It means that in that case only the default user will receive faxing reports and not the actual sender of the document.
An unknown sender is a sender that does not exist in CTI_Server users database.
[Default "0"] [Restart unnecessary]
MailToFax_Server_Settings_
AcceptEmailsFromUnknown
Senders_Enable_1.reg
MailToFax_Server: >= 1.0.0.520; 27.07.2012
MailToFax_Server: < 1.0.0.623; 30.10.2012
   
EmailSaveInWorkingFolder_
Enable
[HKLM_MailToFax_Server]\
Settings
"EmailSaveInWorkingFolder_Enable"=
"0"
Determines if all faxed e-mails should be saved in the working folder.
[Default "1"] [Restart  unnecessary]
MailToFax_ Server_Settings_
EmailSaveInWorkingFolder_
Enable_0.reg
MailToFax_Server: >= 1.0.0.230; 16.07.2012    
EmailDeleteFromMailbox_
Enable
[HKLM_MailToFax_Server]\
Settings
"EmailDeleteFromMailbox_Enable"="0" Determines if all faxed e-mails should be deleted from the mailbox.
[Default "1"] [Restart  unnecessary]
MailToFax_ Server_Settings_
EmailDeleteFromMailbox_
Enable_0.reg
MailToFax_Server: >= 1.0.0.230; 16.07.2012    
FaxNumberInEmailSubject [HKLM_MailToFax_Server]\
Settings
"FaxNumberInEmailSubject"="1" By default fax number is extracted from recipient’s e-mail address (e.g. 49123123123@example.com). If this value is set to 1, however, fax number is extracted from e-mail subjects if they are in the following format:
“Fax: 49123123123”.
[Default "0"] [Restart  unnecessary]
MailToFax_ Server_Settings_
FaxNumberInEmailSubject_1.reg
MailToFax_Server: >= 1.0.0.230; 16.07.2012    
EmailBodyFaxing_Enable [HKLM_MailToFax_Server]\
Settings
"EmailBodyFaxing_Enable"="1" Determines if e-mail body should be faxed. By default only attachments are faxed.
[Default "0"] [Restart unnecessary]
MailToFax_ Server_Settings_
EmailBodyFaxing_Enable_1.reg
MailToFax_Server: >= 1.0.0.230; 16.07.2012    
FaxNumberExtractionPattern_
EmailRecipientAddress
[HKLM_MailToFax_Server]\
Settings
"FaxNumberExtractionPattern_
EmailRecipientAddress"=""
Defines a regular expression used to extract fax number from e-mail address. This regular expression is used only when fax number is extracted from e-mail recipient address (which is the default configuration setting).
The regular expression has to be defined in such a way that it matches only that fragment of e-mail address which represents a fax number.
[Default "[\+]?[0-9#*]+(?=@)"] [Restart  unnecessary]
MailToFax_Server_Settings_
FaxNumberExtractionPattern_
EmailRecipientAddress.reg
MailToFax_Server: >= 1.0.0.520; 27.07.2012
MailToFax_Server: < 1.0.0.622; 29.10.2012
   
               
POP3 settings (e-mail reception)    
POP3_ServerIp [HKLM_MailToFax_Server]\
Mailbox
"POP3_ServerIp"="pop.example.com" POP3 server host name or IP address.
[Default ""] [Restart  necessary]
MailToFax_ Server_Mailbox_
POP3_ServerIp.reg
MailToFax_Server: >= 1.0.0.230; 16.07.2012    
POP3_ServerPort [HKLM_MailToFax_Server]\
Mailbox
"POP3_ServerPort"="110" POP3 server port.
[Default: "995"] [Restart necessary]
MailToFax_ Server_Mailbox_
POP3_ServerPort_110.reg
MailToFax_Server: >= 1.0.0.230; 16.07.2012    
POP3_User [HKLM_MailToFax_Server]\
Mailbox
"POP3_User"="user_name" POP3 user name.
[Default ""] [Restart  necessary]
MailToFax_ Server_Mailbox_
POP3_User.reg
MailToFax_Server: >= 1.0.0.230; 16.07.2012    
POP3_Password [HKLM_MailToFax_Server]\
Mailbox
"POP3_Password"="password” POP3 password.
[Default ""] [Restart  necessary]
MailToFax_ Server_Mailbox_
POP3_Password.reg
MailToFax_Server: >= 1.0.0.230; 16.07.2012    
POP3_UseSSL [HKLM_MailToFax_Server]\
Mailbox
"POP3_UseSSL"="0" Determines if secure POP3 should be used.
[Default "1"] [Restart  necessary]
MailToFax_ Server_Mailbox_
POP3_UseSSL_0.reg
MailToFax_Server: >= 1.0.0.230; 16.07.2012    
POP3_Check_Interval_ms [HKLM_MailToFax_Server]\
Mailbox
"POP3_Check_Interval_ms"="60000" Determines how often the mailbox should be checked for new e-mails.
[Default "300000"] [Restart  necessary]
MailToFax_ Server_Mailbox_
POP3_Check_Interval_ms_
60000.reg
MailToFax_Server: >= 1.0.0.230; 16.07.2012