• 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 programmatically.

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

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 the FaxConnect function. This function is used to connect the WINDEV application to the fax server installed on the current computer.
3. Send the fax:
   • with the FaxSend function. 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 iDestination 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.
     Note Only one fax can be sent at a time. However, it is possible to execute several FaxSend functions in succession: the various faxes will be placed in the fax send 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 only the iDestination function. The report printed by iPrintReport will be sent to the specified fax number. In this case, you cannot track the progress of the fax.
  

  // Envoie l'état "ETAT_FactureCli" par fax
  iDestination(iFax, "0006050402")
  iPrintReport(ETAT_FactureCli)

• use Fax functions and iDestination. iDestination 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 track the progress of the send operation.
  

  // Envoie l'état "ETAT_FactureCli" par fax
  IDConnect is int
  IDConnect = iDestination(iFax, "0006050402", "MonFax","\\monFax\ImprimanteFax")
  // "\\monFax\ImprimanteFax" est le nom de partage de l'imprimante fax
  iPrintReport(ETAT_FactureCli)

Options of fax server

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

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

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

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

Tips

• No retry for sending faxes:
  RegistrySetValue("HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Fax","Retries",0)
• Timeout 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)