Servoy Components | IT2BE Fax Plug-in

stacks_image_FD8E95B4-6EB0-42A7-AA33-365E3E0F2915

Latest Fax Plug-in release available

2.2.125

06/11/2010

The Fax Plug-in makes faxing through a Servoy solution as simple as sending an email.

It was already possible to send your fax as if it were an email but the Plug-in gives you a more direct control over status information than before.
The Fax Plug-in for Servoy is freeware and is based on the Interfax© services. The Plug-in relies on their web services api.

The Plug-in implemented the following functions:

sendFax
Send the fax to the given fax number. The format of the fax can vary from plain text, through html to pdf and doc formats. Everything thatís included in the Interfax api!
getFaxStatus
This method will return an array with 10 types of status information from sent date to number of pages etc.
eSendFax
Does what it says, resend an existing fax to the same or an alternative number.

It is possible to add the username and password in every method call or place them in the Servoy properties file via the servoy-admin webpages.

Every company that needs to fax directly from a Solution will benefit.

		Smart client	Web client	Headless client
4+	1.5 +
5+	1.5 +

// Send a fax via Interfax (www.interfax.net) and return the status or faxid...
// For full documentation for formatting phonenumbers, errorcodes etc. check
// http://www.interfax.net/en/dev/webservice/reference.html

// Create a pdf of your selected form
var success = plugins.pdf_output.startMetaPrintJob();

if (success) {
	controller.print(true,false,plugins.pdf_output.getPDFPrinter());
	
	var document = plugins.pdf_output.endMetaPrintJob(); //The document we are going to fax
	var extension = "pdf"; //the type of document we are going to fax
	
	if (document) {
		//The sendFax method needs a usersname, password, telephone number, document and documenttype
		//When the username and password are entered in the servoy-admin web pages 
		//we can leave these two values out
		var result = plugins.it2be_fax.sendFax("faxnumber", document, extension);

if (result > 0) { 
			//The result Interfax will return is either a fax id (> 0) or an error code (< 0)
			//The error codes can be found at the above site
			
			//In This example we check the complete status info right away but this is in fac
			//too soon. Status info will therefor be incomplete now.
			//The getFaxStatus method needs the optional username and password as well as
			//a faxid which is in fact the result code of the fax we sent with the sendFax method.
			var values = plugins.it2be_fax.getFaxStatus("username", "password", result);
			//The value returned by getFaxStatus is an array with the below explained information 
			var message = "TransactionID: " + values[0] + "\n" +
			"SubmitTime: " + values[1] + "\n" +
			"PostponeTime: " + values[2] + "\n" +
			"CompletionTime: " + values[3] + "\n" +
			"DestinationFax: " + values[4] + "\n" +
			"RemoteCSID: " + values[5] + "\n" +
			"PagesSent: " + values[6] + "\n" +
			"Status: " + values[7] + "\n" +
			"Duration: " + values[8] + "\n" +
			"PagesSubmitted: " + values[9];
		} else {
			//We received an error from Interfax!
			var message = "ERROR: " + result;
		}
			plugins.dialogs.showInfoDialog("(Interfax) fax status", message);
	}
}

These video's will give you an introduction and simple instructions of how you can start using the Component.

Please do not forget to import the sample solution. You can find the sample solution in servoy_root/solutions/it2be-examples.

Our Fax Plug-in is distributed as Freeware.
Unlimited Deployment is allowed for every individual or company.

Using our components is always subject to our Terms and Conditions and License agreement.

2.2-125 07/14/2010
[chg] changed libraries to support (backward) compatibility between (beta) releases

2.2-123 05/05/2010
[chg] made several changes to fix security issue with latest Java release

2.2-120 01/29/2010
[chg] improved Framework to work with external (gui and command-line) installer

2.2-118 08/17/2009
[chg] changed Framework

2.2-116 03/16/2009
[chg] it is not longer necessary to register a developer license
[chg] removed signature from core-common.jar to avoid security issues

2.2-115 01/19/2009
[chg] made some adjustments to core activation wizard

2.2-114 12/05/2008
[new] added client preference panel
[chg] it is now possible to set username and password in user preference panels order will be scripting/user/server
[fix] when username and password are not set server settings will be used

2.1-113 10/30/2008
[chg] improved license feedback in log file
[fix] changed a couple of core functions

2.1-112 10/30/2008
[fix] preference panel 'Components' is now available again

2.1-111 10/21/2008
[fix] corrected issue with Eclipse update manager

2.1-109 08/16/2008
[fix] corrected startup file for client loaded from application server

2.1-008 06/30/2008
[chg] redesigned for Servoy 4.0

1.1-106 02/25/2008
[new] added method 'getVersionLicensed' to find out what version is licensed
[chg] reduced client download size for resources with overall savings up to 45%

1.1-105 06/18/2007
[new] added getVersion() and getLicense() methods to retrieve component information
[chg] the Plug-in is now lazy loading (again)
[chg] separate license file is no longer needed

1.1-104
[chg] added the plug-in to the new Update manager
[new] added sample solution

1.1-101
[new] readme window added.

1.0
[new] initial release