Managed by the FaxBack Support Team
This article applies to NET SatisFAXtion 8.5.

SOLUTION


The FileName Fax Utility
FileName Fax Functional Overview
This NET SatisFAXtion utility provides a super-simple way to send faxes and track the results. Users simply copy the file they wish to fax to a specified directory. Information in the file name is used to deliver the fax. Delivery status is returned via a simple ASCII packet.
For example, to fax a PDF file to 206-445-5670, you would simply rename the file to: 206-445-5670.PDF and place it in the send directory.

FileName Usage
The FileNameConnector scans a directory. File names are comma delimited with the position in the string determining how the parameter is evaluated:

Position
Descriptions
1
Fax number {required field}
2
To field. {optional}
3
From field. {optional}
4-10
Future use.

Any file format supported by the NET SatisFAXtion server will work. For example TIF, PDF, DOC, etc.

Note: Quote marks are not supported in file names. Spaces are OK. Other disallowed characters in filenames are: \ / : * ? < > |
Example Usage
212-445-2345.PDF
Sends the fax to the number specified. The To and From fields at default found in FileNameAPI.INI.
4104342323,Tom.DOC
Sends a fax image of this Word document to Tom.
503-597-5399, Joe Smith, Tom Jones.TIF
Sends the fax image of this PDF file to Joe Smith from Tom Jones.

File Handling
The FileNameConnector saves a copy of the submitted file to a different directory. This directory can be periodically purged or archived.
Timing issues
When the Connector scan detects a new file in the directory, it can be configured to wait for a specified number of seconds before attempting to process the file. This allows time to avoid file contention issues with large files or slow networks.
Installation
There are only two files in this installation: FileNameAPI.exe and FileNameAPI.ini They can be downloaded from the FaxBack knowledge base. Search for “FileName Fax”.
FileNameConnector can be run on any Windows PC that has network access to a shared directory with NET SatisFAXtion systems. The NET SatisFAXtion systems must be configured with the “ClarityNS Connector” module activated. The FileNameConnector reads the file name submitted, and then generates a packet as per the ASCII “Connector” specification. This packet is then read by the NET SatisFAXtion server and the fax is delivered. Results packets are generated and written to the directory specified by the Connector.

Configuration
The only configuration is the FileNameAPI.INI. An example is shown here:

[FILENAMEAPI]
ScanPath=o:\art\FileNameAPI\FileIn\
DonePath=o:\art\FileNameAPI\Delivery\
PacketPath=o:\art\FileNameAPI\Orders\
ScanInterval=5
WaitInterval=3
To=File Send Recipient
From=Art King
;NotifyEmail=
;NetsatUser=
Debug=TRUE


Here are the settings in the INI file, all in the [FILENAMEAPI] section:
ScanPath Full pathname of directory to scan for files to send. Multiple ScanPath parameters can be used to scan more than one directory.
DonePath Full pathname of directory to put files in. This is necessary because once FileNameAPI.exe is done with them, ASC2CAS still has to be able to send the files. The file name is modified to preserve uniqueness, by appending digits to the end. A mechanism to clean this folder out should be implemented.

PacketPath Full pathname of ASC2CAS's packet directory, where the packet will be put.
ScanInterval Time to wait between scans of ScanPath, in seconds.
WaitInterval Time to wait after finding a file before sending it. This is to prevent file access issues.
To Optional. Allows setting a default value for the TO field.
From Optional. Allows setting a default value for the FROM field.
NotifyEmail <NOT YET IMPLEMENTED> Optional. Allows setting a default value for the email notification address field.
NetsatUser <NOT YET IMPLEMENTED> Optional. Allows setting a default value for the NetSat user field.
Debug Set to true or false to determine how much information is reported to the screen.


Copyright © FaxBack, Inc.