The FaxPack for FileMaker® Pro plug-in allows any FileMaker application to create and send faxes through 4-Sight FAX Server using the contact information and fax numbers contained in a FileMaker table.

Developers can perform a variety of tasks including:

- Integrate and automate faxing as part of any company workflow process.
- Link incoming / outgoing faxes to any Filemaker record for improved customer service & management.
- Display a list of all faxes for an entire company or a single contact.
- Retrieve and view a fax within any Filemaker application.
- Convert any incoming fax to .pdf, .png, .jpeg or .tiff format for improved document handling.
- Automate the batch or real-time sending of custom client invoices, blast faxes, announcements, etc..
- Request a list of available fax servers.
- Retrieve and select from a list of server-based cover pages.
- Fax any printable FileMaker forms to the current record or the current selection of records.
- Switch to the 4-Sight Fax print driver so your FileMaker print job generates a TIFF file.
- Restore the previous print driver selection.
- Create and send a fax message and more.

FaxPack v7.5 for FileMaker® Pro 7 and later:

FaxPack v7.0.3 program documentation for developers is available here.

FaxPack v7.0.3 for FileMaker® Pro 7 and later:

FaxPack v5 for FileMaker® Pro:

FileMaker Pro v5.5 and v6 users:

FaxPack v5.0.6 for FileMaker Pro 6 Download for *** Macintosh (.hqx)

FaxPack v5.0.6 for FileMaker Pro 6 Download for *** Windows (.zip)

FileMaker Pro v7 users:

FaxPack v5.0.6 for FileMaker Pro 7 Download for *** Macintosh (.hqx)

FaxPack v5.0.6 for FileMaker Pro 7 Download for *** Windows (.zip)

Pricing

- Pricing is for developer licensing only. There is no charge for deployment.

FaxPack for FileMaker FAQ

What is FaxPack?

FaxPack is a Filemaker plug-in (or language extension) providing faxing commands to work directly with the 4-Sight FAX product within any FileMaker application. FaxPack enables any FileMaker application to send faxes using the contact information and fax numbers directly from a FileMaker table. Developers can perform a variety of tasks, including: request a list of available fax servers, retrieve and select from a list of server-based cover pages, fax FileMaker forms to the current record or the current selection of records, switch to the 4-Sight Fax driver so your FileMaker print job generates a TIFF file, restore the previous print driver selection, create and send a fax message and more.

=============================================================

What version of FaxPack is required for FileMaker, version 10?

FaxPack 7.5 or later is required for compatibility with FileMaker 10 applications.

=============================================================

Will I need to purchase an upgrade for FaxPack version 5 if I upgrade FileMaker?

There would be no need to upgrade FaxPack 5.0 later when you upgrade. The FaxPack plug-in is currently a SuperFat plug-in, where this single plug-in file is already compatible with both FM6 and FM7 under the Macintosh OS 9, X and Windows operating system environments.

=============================================================

What will be the price for users, not developers?

There is only a charge for the developer license by platform (Windows and/or Macintosh). Deployment licenses are free. Users for 4-Sight FAX are issued as part of the 4-Sight FAX license.

=============================================================

What are the FaxPack error codes?

  -1 - FaxPack demonstration time has expired
-128 - User cancelled dialog
10003 - A file could not be opened for reading
10004 - A file could not be opened for writing
10005 - A file was empty
10006 - A read error
10007 - A write error
10008 - Could not obtain a session with the Server
10009 - Message ID was not found
10010 - Fax printer was not found
10011 - A time-out happened when waiting for a Fax printer file to complete
10013 - Must have at least one recipient for an outgoing fax
10014 - Printer does not exist
10015 - The Fax printer does not support this feature
10052 - Invalid User or Password
10053 - User is already logged-in
10054 - Logins are disabled at the Server
10073 - A valid 'From' is needed
10108 - Communication with the Server timed-out
10155 - Attachment cannot be located
10200 - The current Server has not been set
10201 - The current login information has not been set
10202 - Print preparation has not been called
10203 - Server is invalid or is not responding
10204 - A memory allocation failed
10205 - Command is unimplemented
10206 - "SPStartMessage" must be called first
10207 - Message command has been called in the wrong order
10208 - A message is already being created
10210 - Invalid path
10211 - Invalid array type
10212 - Navigation Services are not available
10213 - MacOS X 10.2.2 or later must be used for "SPGetPrinter" & "SPSwitchPrinter"
10214 - There were no calls to "SPPreparePrint"
10215 - There was more than one call to "SPPreparePrint"
10217 - The fax number parameter to "SPAddAddress" was empty.
10250 - Demo has expired.
10252 - The RegNumber is invalid. If both Mac & Win RegNumbers are involved, check to see that the codes are not transposed in the registration call.

 =============================================================

Why do I get the 10208 error when trying to send a layout fax and the only way to continue faxing is to restart FileMaker?

Each call to "4FAX-StartMessage" must be completed with a call to either "4FAX-SendMessage" or "4FAX-AbandonMessage". Another call to "4FAX-StartMessage" cannot be made until the first one is complete. If needed, "4FAX-AbandonMessage" can be called instead of restarting FileMaker.

=============================================================

Why am I unable to send a fax to a long distance number?

FaxPack takes the literal phone number string from your FileMaker database. If there is not a '1' in your number, FaxPack will not automatically add a '1'. You must tell FileMaker to add a '1' to the number being sent to the server. This can be accomplished through adding an "IF - THEN" statement to your script.

=============================================================

How do I get the version of the FaxPack plug-in?

 4FAX-version
 Function syntax:
External("4FAX-Version","")
 Parameters:
<none>
 Result:
Plug-in version

=============================================================

How do I search for Fax Servers in FaxPack version 5?

4FAX-Serverlookup
Function Syntax:
External("4FAX-ServerLookup","Timeout")

Parameters:
Timeout - maximum number of seconds to search

Result:
Result Code - ( 0 = successful, otherwise error code)
|
Name1 - 1st Server Name
;
IPAddress1 - 1st Server IP Address
;
Port1 - 1st Server Port
|
Name2 - 2nd Server Name
;
IPAddress2 - 2nd Server IP Address
;
Port2 - 2nd Server Port
.
.
.

=============================================================

How do I set internal FaxPack values for the Fax Server and User login?

 4FAX-ServerLogin

Function Syntax:
External("4FAX-ServerLogin","Server IP Address|Server Port|User Name|User Password|TrialLogin")

Parameters:
Server IP Address
Server Port
User Name
User Password
TrialLogin - do a trial login/logout? ( 0 = no, 1 = yes)

Result:
Result Code - ( 0 = successful, otherwise an error code is returned)

=============================================================

How do I switch printers in FaxPack?

4FAX-Switch Printer

Function Syntax:
External("4FAX-SwitchPrinter","Code") 

Paramerters:

Code - ( 1 = switch back "from" Fax Printer, 2 = switch "to" Fax Printer )

Result:
Result Code - ( 0 = successful, otherwise error code)

=============================================================

How do I start a fax message in FaxPack?

4FAX-StartMessage

Function Syntax:
External("4FAX-StartMessage","From|Subject|CoverPage Number")

Parameters:
From
Subject
CoverPage Number - (0 = none, otherwise greater than zero )

Result:
Result Code - ( 0 = successful, otherwise error code)

=============================================================

How do I add comment text to the fax message in FaxPack version 5?

4FAX-AddComment

Function Syntax:
External("4FAX-AddComment","Comment")

Parameters:
Comment

Result:
Result Code - ( 0 = successful, otherwise error code)

=============================================================

How do I add a recipient to the fax message in FaxPack version 5?

4FAX-AddRecipient

Function Syntax:
External("4FAX-AddRecipient","Full Name|Company|Fax Number")

Parameters:
Full Name
Company
Fax Number

Result:
Result Code - ( 0 = successful, otherwise error code )

=============================================================

How do I capture the next print job as an attachment for the fax message in FaxPack version 5?

4FAX-PreparePrint

Function Syntax:
External("4FAX-PreparePrint","Resolution Kind|Grayscale")

Parameters:
Resolution Kind - ( 1 = standard, 2 = fine )
Grayscale - ( 0 = no, 1 = yes )

Result:
Result Code - ( 0 = successful, otherwise error code )

=============================================================

How do I send the fax message to 4-Sight Fax Server in FaxPack version 5?

4FAX-SendMessaage

Function Syntax:
External("4FAX-SendMessage","")

Parameters:
<none>

Result:
Result Code - ( 0 = successful, otherwise error code )
|
Message ID - returned from the Server 

=============================================================

How do I abandon or abort the fax message in FaxPack version 5?

4FAX-AbandonMessage

Function Syntax:
External("4FAX-AbandonMessage","")

Parameters:
<none>

Result:
Result Code - ( 0 = successful, otherwise error code )

=============================================================

How do I install FaxPack version 5?

 OS 9/X/Windows With FileMaker 5.5, 6 and 7

Copy the contents of the folder that says “Copy Contents within folder to FM Extensions Folder” to the Filemaker extensions folder

Windows With FileMaker 5.5 and 6

Copy the contents of the folder that says “Copy Contents within folder to FM Extensions Folder” to the “*\Program Files\Filemaker\System” folder, then install the appropriate print driver for you operating system from the “Print Drivers” folder

==========================================================

How do I start the FaxPack version 5 plug-in?

Open the “FM FaxPack Demo.fp5” file with FileMaker.

=============================================================

How do I retrieve the cover page names from 4-Sight Fax Server in FaxPack version 5?

4FAX-GetCoverPages

Function Syntax:
External("4FAX-GetCoverPages","")

Parameters:
<none>

Result:
Result Code - ( 0 = successful, otherwise error code )
|
Name1 - 1st CoverPage Name
|
Name2 - 2nd CoverPage Name
.
.
.

=============================================================

How do I parse out delimited data in FaxPack version 5?

4FAX-GetRowColumn

Function Syntax:
External("4FAX-GetRowColumn","Row Number|Column Number|FaxPack Text List")

Parameters:
Row Number - starting with 1
Column Number - ( 0 = whole row, otherwise starts with 1)
FaxPack Text List - returned from "GetCoverPages" or "ServerLookup".

Result:
Value at (Row,Column)

=============================================================

How do I register the FM FaxPack Plug-in in FaxPack?

4FAXRegister

Function Syntax:
External("4FAX-Register","Developer Name|MacCode|WindowsCode|DeploymentCode")

Parameters:
DeveloperName
MacCode
WindowsCode
DeploymentCode

Result:
Result Code - ( 0 = successful, otherwise error code )

============= ================================================

How do I retrieve the status of a sent fax in FaxPack?

Function Syntax:
External(4FAX-GetItemStatus,"Message ID|Recipient Index")

Parameters:
Message ID - obtained from "4FAX-SendMessage"
Recipient Index - ( 1 or greater)

Result:
Result Code - ( 0 = successful, otherwise error code )
|
Status string
|
From
|
To
|
Subject
|
Fax Number
|
Page Count
|
Sent - ( 0 = false, 1 = true )
|
Printed - ( 0 = false, 1 = true )
|
Deleted - ( 0 = false, 1 = true )
|
Rejected - ( 0 = false, 1 = true )
|
Reason for rejection

=============================================================

Why do I receive a 10250 error in FaxPack?

This is the error returned for "Demo Expired"

In our plug-in, we capture the current TIME from the plug-in on FM startup. If the FM programmer correctly issues our registration command, we no longer make the TIME comparison, because the developer is registered and has unrestricted access to using the plug-in. If the FM developer has not issued a valid FaxPack registration, we allow the product to run in demostration mode for 45 minutes.

If you experience this error message, please ensure your registration information is correct.

=============================================================

I fax multiple pages from FileMaker from several different scripts but need to send them as one (1) fax. How is this done in FaxPack version 5?

The pages can be kept all in one fax by issuing a "4FAX-PreparePrint" before each print job. When combining two (2) or more fax/print jobs, the "4FAX-SendMessaage" will be issued only once for all print jobs.

=============================================================

Do the scripts need to be included in every file of a relational database one would want to fax from or use a separate file and attach print jobs from other files?

Under FMP6, you'd want to keep the preferences as a separate related file as it exists now in the demo - fax servers and cover pages are then stored there. You'd want to re-work the globals and scripts in "fm faxpack demo.fp5" into your existing solution. First, create the same fields in your solution, define the same relationships, and then import the scripts in.

In FMP7, since you can't import tables into a solution, you'd keep the preferences as a separate DB file and then call the functions as needed. Alternatively, you can recreate this table on your own.

=============================================================

I am not specifying a cover page. Why is one being sent?

On the FAX Server, there is a preference that will enforce "use of a cover page when none is specified". Make sure this option is turned OFF.

=============================================================

Why does the print job I attempt to fax, regardless of the switchprinter command, go to the print queue and not the fax queue in FaxPack version 5?

Be sure to always include the PreparePrint command (prior to issuing the FileMaker Print command), as this command is necessary for proper faxing. This will allow the "SwitchPrinter" command to work properly. Also, ensure the "4FAX-StartMessage" and "4FAX-SendMessage" are part of every fax job.

 =============================================================

The FaxPack plug-in always has to log in, even on consecutive faxing attempts, and regardless of the login status of the fax client. How to I do this?

When logging in, be sure to set the last parameter to 1. This actually runs the login. If this parameter is omitted or set to "0", then the log-in will not actually occur.