• configure the computer from which the faxes must be sent.
• create the WINDEV/WEBDEV application for sending faxes.
• configure (if necessary) the options of the fax server by programming.

Sending a fax from a WINDEV application or from a WEBDEV site

1. Prepare the fax, which means the file that will be sent. A specific first page (called "Cover page") can also be attached to the fax. This cover page is a ".cov" file and it can be created from the fax server.
2. Use FaxConnect. This function is used to connect the WINDEV application to the fax server installed on the current computer.
3. Send the fax:
   • by FaxSend. When sending the fax, you have the ability to specify the name of a WLanguage procedure. This procedure will be called whenever the status of the fax is modified by the fax server. The status of the fax is returned by FaxStatus. This function is used to fill the FaxCompleteStatus structure containing the characteristics of the fax.
   • with iPreview and the print functions. This solution allows you to directly print a report created with the report editor. In this case, you can give a name to the fax sent. The status of the fax will be returned by FaxStatus. This function is used to fill the FaxCompleteStatus structure containing the characteristics of the fax.
     Remark: A single fax can be sent at a time. However, FaxSend can be run several times in a row: the faxes will be added to the fax queue. The WLanguage procedure combined with FaxStatus allows you to find out which fax is currently processed. This function is used to fill the FaxCompleteStatus structure containing the characteristics of the fax.
4. When the faxes have been sent, all you have to do is disconnect the WINDEV application from the fax server with FaxDisconnect.

Sending a fax created with the report editor

• use iPreview only (syntax 3). The report printed by iPrintReport will be sent to the specified fax number. In this case, you cannot follow the progress of the fax.
  
  // Sends the "RPT_CustInvoice" report by fax
  iPreview(iFax, "0006050402")
  iPrintReport(RPT_CustInvoice)
  
• use the Fax functions and iPreview (syntax 4). iPreview establishes (if necessary) a connection to the fax server and returns the identifier of this connection. This identifier can be used by the Fax functions to follow the progress of the send operation.
  
  // Sends the "RPT_CustInvoice" report by fax
  ConnectID is int
  ConnectID = iPreview(iFax,"0006050402", "MyFax","\\MyFax\FaxPrinter")
  // "\\MyFax\FaxPrinter" is the share name of the fax printer
  iPrintReport(RPT_CustInvoice)
  

Options of fax server

• information regarding the sending of faxes (Windows 2000):
  The corresponding registry key is HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Fax:
  

  Number of attempts	Retries
  Number of minutes between two attempts	Retry Delay
  Number of days before deleting the unsent faxes	Dirty Days
  Archive the outgoing faxes	ArchiveOutgoingFax
  Directory of outgoing faxes	ArchiveDirectory
  Print the top header	Branding
  Forbid the custom cover pages	ServerCoverPageOnly
  Time when the economy rate starts	StartCheapTime
  Time when the economy rate ends	StopCheapTime

• information regarding the sender of the fax (Windows 2000):
  The corresponding registry key is HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Fax\UserInfo:
  

  Number of the fax sender	FaxNumber
  Mailbox Address	Mailbox
  Company	Company
  Title	Title
  Full name	FullName
  Service	Department
  Business address	Office
  Home phone	HomePhone
  Business phone	OfficePhone
  Displays the status monitor when sending AND receiving faxes	VisualNotification
  Status monitor always on the top	AlwaysOnTop
  Sound notification	SoundNotification
  Billing code	BillingCode

Tips

• No retry for sending faxes:
  RegistrySetValue("HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Fax","Retries",0)
• Time-out set to 0 mn between two attempts:
  RegistrySetValue("HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Fax","Retry Delay",0)
• 0 day for keeping the unsent faxes:
  RegistrySetValue("HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Fax","Dirty Days",0)