Custom Application Sample

The example of the custom routing application (RouteOutCustom.exe) can be found in the Fax Voip T.38 Console installation folder, usually C:\Program Files (x86)\FaxVoip Console\RouteOutCustom.exe.

The source codes (RouteOutCustom.zip archive) can be found in the Fax Voip T.38 Console data folder, usually C:\ProgramData\\FaxVoip Console\Samples\RouteOutCustom.zip. To unpack the archive, right click it and then select Extract All... from the context menu.

The code example is a console application written in Visual Basic .Net and can be compiled using Microsoft Visual Studio 2013 or later versions.

This sample demonstrates the use of a custom routing method for outgoing faxes and audio messages, taking into account the requirements for writing such application, see also in the Custom Application Requirements (Developer's Guide) chapter of this user manual.

• The application parses the predefined command line and populates the internal structure where it stores path to the temporary fax file (TIFF, PDF or SFF file depending on your choice) or audio file (WAV) and other routing info parameters, such as Recipient Number, Sender Fax ID (TSID), Recipient Fax ID (CSID) etc.
• Writes the routing info into standard ini file.
• Copies the temporary fax file (TIFF, PDF or SFF) or audio file (WAV) to the specified folder with an unique name that contains the date and time the fax or audio message was sent.
• Before the application finishes, it deletes the temporary folder and the temporary fax or audio file placed in this folder.
• The application provides automatic completion after performing all necessary actions.
• The application uses folders and files for which the current user account and the Local System account definitely have write access.

To use the sample

1.     Copy the RouteOutCustom.exe file into the Fax Voip T.38 Console installation folder. You can use a different folder, but make sure that the current user account (Local System account) has access to your folder.

2.     Open Fax Voip T.38 Console Control Panel. Click Outgoing Methods in TreeView, then click Custom.

3.     On the Custom routing for outgoing faxes and audio messages page, select the Enable custom routing check box.

4.     In the Custom application that should be started after sending a fax or audio message field, enter the path to RouteOutCustom.exe file or select it using the small button placed to the right of the field.

5.     Select the Create temporary copy of the sent fax in the following format check box. Select the file format in which the temporary copy of the outgoing fax should be created. Can be TIFF, PDF or SFF.

6.     Select the Create temporary copy of the sent audio message check box.

7.     Click <Apply> button to save changes.

After sending a fax or audio message,

1.     Open the Fax Voip T.38 Console data folder in Windows Explorer, usually C:\ProgramData\FaxVoip Console\.

2.     Check the RouteOutCustom subfolder for RouteOutCustom.ini file.

3.     Check the RouteOutCustom\Outgoing Messages subfolder for copy of the outgoing fax or audio message.

4.     The RouteOutCustom.txt log file is stored in the log subfolder.