Personal tools
You are here: Home / OSCAR EMR 15 / 4.0 Developers / 4.1 Installation / 4.1.2 Fax / 4.1.2.3.3 SRFax desktop client

4.1.2.3.3 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)

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

  • v1.0 – initial public release to oscarmanual.org – Nov 30, 2016
  • v1.1 – updated as the builds are no longer available – Mar 13, 2018
 copyright ©2016-2018 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 on your workstation

SRFax/Oscarservice have taken down the clients from the net.

You will need to build from source.  Note this is untested and may likely need modification to work

git clone https://github.com/oscarservice/yajhfc-srfax.git

change to the directory you just cloned (the one with build.xml)

cd yajhfc-srfax

and execute

ant dist

Use the proper build in the build directory

For Windows users you will want 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.

SRFax account setup

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/ . 

 

Document Actions