SRFax desktop client

For those with SRFax, extend your use of your subscription with a desktop client to let you fax outside of OSCAR (see the gateway for having OSCAR use their API)

This page has been imported from http://www.oscarmanual.org and has not yet been reviewed by OSCAR EMR.


Preface

This is a basic installation of a SRFax desktop client as a general utility for faxing from the desktop outside of OSCAR.  The client was written by OSCARService as an open source product under GLP v3 based on YajHFC 0.6.0

Document Version History

 copyright ©2016 by Peter Hutten-Czapski MD under the Creative Commons Attribution-Share Alike 3.0 Unported License


Contents

  1. Preface
  2. Document Version History
  3. Prerequisites
  4. Installing Client

Prerequisites

Almost any workstation that runs Java 8 including Windows 2000 or newer, Mac OSX or Linux workstation

An account at SRFax.com

NOTE: While Windows XP is currently considered obsolete (consider reformatting and running Linux) both Java 8 and this client run fine on it

Installing Client

Install Java 8 according to the instructions for your system

Go to https://www.srfax.com/online-fax-features/srfax-client/ and download your choice of client

For Windows users you will download SRFax_Desktop_Win.zip

Extract the zip file using the decompression tool of preference (in Windows explorer will let you open zips) just extract

The zip will have an installer named SRFax_Desktop_Win.exe

Run it as administrator to install

Install the "full package" which will install ghostscript, and the printer driver

For Mac just move the installer to the Applications folder

For Linux install a normal YajHFC client version 0.6.0 to your machine from http://www.yajhfc.de/downloads/current-version .  Then download the Mac SRFax_Desktop.Mac client and extract the yajhfc.jar file.  Replace your existing jar in /usr/share/jajhfc (or similar) with the modified one from the SRFax client.

Configuring Client

Configure as you would a normal YajHFC client

Navigate the menu Extras > Options > Servers and edit a new or default server

Select the "SRFax Protocol" in "Fax Lists" and then insert your particulars for your account at SRFax including email, account number and fax number.

Click "Test connection" to ensure that you are communicating correctly with SRFax.

see https://www.srfax.com/online-fax-features/srfax-client/


Using the Client

To fax from the desktop use the client to print as you would normally on your workstation and choose the YajHFC Fax printer

The fax printer will then open the fax dialog where you can enter the number of your recipient

That's all you need to do.  However it will be useful to configure an address book.  You can configure an address book local to the workstation with the YajHFC type of address book.  The SRFax address book will draw from SRFax and any addresses you have saved there which may be better if you want to share these addresses.  Alternately consider configuring the client to use OSCAR's consultant database for a fax number address book using the JDBC address book type with instructions from http://files.yajhfc.de/doc/MySQL.shtml

There are extensive options for YajHFC.  Instructions are available on the YajHFC web pages http://www.yajhfc.de/