FaxMan SDK Version 4.7
Understanding Fax Scheduling Options

FaxMan provides a myriad of different options you can setup when scheduling a fax. This section will detail your options and what they mean.

 

To begin with, it’s important to remember that every fax in the FaxMan system has its own unique identifier (ID). In the FaxMan control, this ID is made available to your application through the FaxLogID property. The FaxLogID property only contains valid information right after your application schedules a fax. In other words, if you want to know the FaxMan ID of a fax that you’ve scheduled, the way to get it looks like this:

 

Dim id&

FaxMan1.SendFax  'schedule a fax

id = FaxMan1.FaxLogID 'now you’ve got the ID!

 

There are several other properties which reference a FaxMan ID–generally, you won’t need to use the FaxLogID property because there will be a more immediately useful alternative.

 

Specifying Files To Fax

 

Note: All files specified in the FaxFiles property must be in FaxMan file format, or FMF format. See the section on Creating Faxable Files.

 

FaxMan allows your application to send a single page or multiple pages in a single fax file. It also allows for "chaining" groups of these files together into a single fax job. This gives FaxMan the flexibility to send a virtually unlimited number of pages and files as a single fax job.

 

To schedule a fax file, you simply assign the file, including its path specification, to the FaxFiles property before calling the SendFax method. It would look something like this:

 

FaxMan.FaxNumber = "555-1212"

FaxMan.FaxFiles = "c:\myfax.fmf"

FaxMan.SendFax 'send the fax

 

To chain together multiple files, you would change the above to look like this:

 

FaxMan.FaxNumber = "555-1212"

FaxMan.FaxFiles = "c:\myfax.fmf+d:\anotherpage.fmf+c:\evenmore.fmf"

FaxMan.SendFax 'send the fax

 

Scheduling Your Faxes

When you call the SendFax method, you might think that you’re actually sending a fax. In fact, you are only scheduling a fax to be sent at the specified time and date. The difference may seem small, but is actually a significant consideration. Calling the SendFax method causes a new fax item to be placed in the Pending log. The FaxMan server will remove this item from the Pending log at the appropriate time and actually send it using the first available faxmodem. If there are no faxmodems available, no faxes will ever be sent. Similarly, you must supply a phone number and at least one page to be faxed (using either a cover page or the FaxFiles property). ). To ensure that a fax will be sent as soon as possible you can set the FaxPriority of the fax to be higher than that of other pending faxes. The FaxMan server will send high priority faxes ahead of lower priority ones.

 

Understanding Fax Resolution

Faxing technology allows any fax to be sent in either high or low resolution. FaxMan allows your application to switch between high and low resolution quite easily by setting the FaxResolution property to 0 for low resolution and 1 for high resolution. Simple, right?

 

Well, not quite so simple. The thing to keep in mind is that the files that you’re trying to fax may be in a resolution different from the resolution you’re trying to send them at. This means that FaxMan may have to stretch or compress your files to send them at the resolution you’re asking for. The practical result of this is that images you’ve created at low resolution and sent at high resolution may look somewhat blockier than you think they should. Likewise, high resolution images sent at low resolution may be missing lines, especially on detailed images or small text.

 

Using Banners and Coverpages

FaxMan allows your application to attach extra information to each fax that is specifically designed for use on cover pages and banners (the banner is the strip of small text at the top of each fax page that usually contains date, time, and page number information). The Banner And Coverpage Formatting Characters topic details these items, and how to access them from your FaxMan control-based applications. We’ll just briefly go over this information right now to provide a small sample.

 

OK, you can see that creating banners and setting the items for banners and cover pages is fairly straightforward. Basically, before you schedule a fax you fill in the information you’d like to make available for cover pages and banners (you may need this information for general reference also), then a simple string substitution is completed to get the desired look. So let’s look at a sample banner:

 

This sample generates a banner which contains the date and time on the left, the sender’s company name in the center, and the page count on the right hand side:

 

‘first we have to fill in the UserCompany...the date, time, and

‘page count FaxMan calculates for us...

FaxMan1.UserCompany = "My Company"

FaxMan1.FaxBanner = "Date:%d Time:%t|%m|Page %c of %p"

 

Now when we send the fax, each page will have the appropriate banner at the top. Pretty neat, huh? Most of the items you can set before scheduling a fax are available for use in banners and cover pages; the complete list is shown below. Just remember to set these items before you schedule your fax. These items will not ever be altered by any event or other side effect of using the control, so for the most part you can set these up just once and use them over and over again. This would be quite useful in a fax broadcast application – all that would need to be altered for each fax would be the FaxNumber property.

 

 

FaxComments

FaxCompany

FaxName

FaxSubject

FaxUserData

UserCompany

UserFaxNumber

UserName

UserVoiceNumber



 

Other Options When Sending a Fax

There are several properties that can be set before scheduling a fax. These properties have various effects, all of which are pretty self-explanatory. For more information, check out the reference section for the FaxMan ActiveX controls. The complete list of properties which affect your fax in some way (as opposed to "informational" items as used on banners and cover pages) is given below:

 

FaxBanner – adds a banner to each fax page

FaxCoverPage – adds a cover page to the fax

FaxDate – specifies date on which to send the fax

FaxFiles – specifies the list of files to send

FaxID – specifies the local identifier to use when sending this fax

FaxNumber – sets the phone number to send this fax to

FaxResolution – determines resolution used to send the fax

FaxRetries – sets the number of times to retry this fax in the event it fails

FaxRetryInterval – sets the time to wait before retrying a failed fax

FaxTime – sets time of day to send the fax

FaxPort – specifies the port to use when sending the fax

FaxPriority – sets the priority of this fax job

FaxQueue – specifies the queue to use when sending the fax

 

 


© 2013 Data Techniques, Inc. All Rights Reserved.

Send comments on this topic.