OSCAR Fax Configuration

Owned by Marc Dumontier
Last updated: Feb 24, 2017
2 min read

OSCAR 15 is configured to fax from the desktop and provides freedom in how to connect the back end.  Currently OSCAR supports a sophisticated two way fax webservice, and simple one way faxing to a T.37 compliant fax machine, to any of a number of web fax gateways. 

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


OSCAR Fax Settings

To use faxing directly from Oscar for  Rx's, Consultation requests and eForms you need to

  1. Configure the Oscar properties file for pdf creation and faxing. 
  2. Ensure that the installation has Tomcat is on port 8443 (Other ports are possible but more work. Note: 'oscar_port' added to .properties file)
  3. Setup software for your choice of Webservice or a Fax Gateway or T.37 fax machine.

OSCAR property settings for faxing are already added by default with the deb installed OSCAR 15.

If you manually configure OSCAR you would need to add the following. 

# The WKHTMLTOPDF_COMMAND should be the path to the executable on your system
WKHTMLTOPDF_COMMAND=/var/lib/tomcat6/webapps/OscarDocument/wkhtmltopdf-i386
WKHTMLTOPDF_ARGS=-s Letter -T 10mm -L 8mm -R 8mm --print-media-type
oscar_port=8443

# Typical setting for faxing from Rx
rx_enhance=true
rx_signature_enabled=true
rx_fax_enabled=true

# Typical setting for faxing from consultation requests
faxEnable=yes
consultation_fax_enabled=true
consultation_signature_enabled=true
consultation_indivica_attachment_enabled=true

# Typical setting for faxing from eforms
eform_fax_enabled=true
eform_signature_enabled=true

 Then restart the Tomcat server

sudo service tomcat7 restart

Even if DEB installed you will need to install further utility software to allow for the files produced by OSCAR to be sent by fax.  You have the freedom with OSCAR to choose how you fax

  • by Webservice to Hylafax server 
  • or an email to a fax gateway
  • or via a T.37 protocol to a MFP.

Debugging:


 
The following command should return something like: wkhtmltopdf 0.12.4 (with patched qt)

wkhtmltopdf -V


To generate a test file, run the following command from a location where you have write permissions

/usr/local/bin/wkhtmltopdf -s Letter -T 10mm -L 8mm -R 8mm --print-media-type http://oscarmanual.org test.pdf