FAXability supports an API that allows you to customize and automate the message preparation process.  When a new message is created, fax recipients, the subject, cover text and attachments can all be added to the message through the API.  A message that's constructed using the API can be sent automatically, or it can be left for the user to send manually.

The FAXability API can be applied uniquely for the four different ways that new messages are created: normal send, print-capture, forward and resend.  For example, it's possible to automatically set the cover text in a new message to the contents of a file when a message is created as the result of printing to the "FAXability" printer, but not when you select Fax->New Fax from the main menu.

How It Works

When a new message is created, FAXability examines a registry value based on the current message preparation process: normal send, print-capture, forward and resend.  If found, the registry value must be set to the name of a JavaScript file that FAXability can load and execute.  FAXability executes the script in same context as the new message, allowing the script to modify all aspects of the message.  Unless instructed otherwise, FAXability will delete the script file after script execution has finished. 

The four possible registry values are as follows.  Each registry value can be set to reference the same JavaScript file, or different files, all depending on the desired functionality.

[HKEY_CURRENT_USER\Software\FaxBack\FAXability]
"SendCommandFile"="<script command file>"
"PrintCaptureCommandFile"="<script command file>"
"ForwardCommandFile"="<script command file>"
"ResendCommandFile"="<script command file>"     

Examples

FAXability supports a set of functions that allow script in a command file to modify a new message in several ways (see API Reference below for a complete list).  The following examples demonstrate how these functions can be combined.  Keep in mind that these are JavaScript files, and that all JavaScript language features such as comments, loops and conditions can be used.

// Simply sets the subject for normal send messages
//
// Saved as file "C:\MyScripts\SetSubject.js"
// The registry is set as follows:
//   [HKEY_CURRENT_USER\Software\FaxBack\FAXability]
//   "SendCommandFile"="C:\\MyScripts\\SetSubject.js"

CmdSubject("Information You Requested");
CmdNoDeleteCmdFile();

// Sets message contents
//
// Saved as file "C:\MyScripts\SetupMessage.js"
// The registry is set as follows:
//   [HKEY_CURRENT_USER\Software\FaxBack\FAXability]
//   "SendCommandFile"="C:\\MyScripts\\SetupMessage.js"

CmdCoverTextFile("c:\\MyScripts\\CoverText.txt");
CmdURL("http://company.com/promo/xyz.html");
CmdNoDeleteCmdFile();

// Automatically sends a print-captured attachment
//
// Saved as file "C:\MyScripts\PrintAndSend.js"
// The registry is set as follows:
//   [HKEY_CURRENT_USER\Software\FaxBack\FAXability]
//   "PrintCaptureCommandFile"="C:\\MyScripts\\PrintAndSend.js"

CmdAddress("Fred","555-123-1234","Stoneage, Inc.");
CmdAddress("Barney","555-123-5432","");
CmdNoDeleteCmdFile();
CmdSendFax();