Locale and Fonts - Unix

Complete

Locale

The reports and documents in the release package make use of the system's locale to get the appropriate date and currency formats and to select the appropriate resource bundle. Many unix systems use the standard en_US.UTF-8 locale. To change the locale on a ubuntu system you can use:

sudo apt-get install language-pack-en-base
sudo nano /etc/default/locale   

to set the required locale, then log out and in again, and restart Tomcat.

The locale being used is shown on the Help screen.

Document Fonts

OpenVPMS can generate documents using OpenOffice or Microsoft Word, or JasperReports templates. These have different requirements when it comes to fonts.

OpenOffice and Microsoft Word

OpenOffice (.odt) or Microsoft Word (.doc) templates can use any font installed on the system.
Fonts may get remapped if the template was created on a Windows system but the OpenVPMS server is running on a unix system and the named font isn't available.
For example 'Bradley Hand ITC' will be mapped to 'URW Chancery L'. To avoid this, install the required fonts.
To install specific fonts on an Ubuntu server, see here.

JasperReports

JasperReports templates (.jrxml) included in the distribution use the DejaVu Sans font. Prior to OpenVPMS 2.3, this was specified within each template. From OpenVPMS 2.3, it is specified in the file
<TOMCAT_HOME>/webapps/openvpms/WEB-INF/classes/jasperreports.properties:

net.sf.jasperreports.default.font.name=DejaVu Sans

DejaVu Sans is used as it is widely available, but doesn't support all languages.

To use an alternative font:

  1. package a JasperReports font extension, as per:
  2. copy the font extension .jar to <TOMCAT_HOME>/webapps/openvpms/WEB-INF/lib/
  3. change net.sf.jasperreports.default.font.name property in the <TOMCAT_HOME>/webapps/openvpms/WEB-INF/classes/jasperreports.properties to use the name of the new font extension
  4. restart Tomcat