client readme.txt

PatientRunner 20 Source

PatientRunner Client Readme V2.0


Introduction
------------

PatientRunner is an open source mental health clinic medical records system.  Windows client software written in Delphi 7 connects to a MySQL database that contains progress notes, diagnoses, medications, and rating scales.  The client software features a "WYSIWYG" word processing style graphical user interface with spell checker that makes it easy to generate professional looking documents.  User customized templates allow for efficient note creation.  Multiple users can access the database simultaneously.

Ideally, the MySQL database server would be hosted on its own machine with client software installed on different machines.  However both the server and client server could be hosted on the same machine.


Installation
------------

Just run the Windows client self-installer.  The self-installer will install the PatientRunner executable, spell check dictionary file and required MySQL DLL file.


Compiling the Delphi 7 PatientRunner Windows Client
---------------------------------------------------

Read on if you want to create your own custom PatientRunner executable.

1.  PatientRunner relies on a 3rd party component (Addict) for spellchecking.  If you want to be able to compile the PatientRunner source, you will need to go to www.addictive-software.com and purchase a copy of Addict for a minimal cost.  The PatientRunner source code repository does not contain any of the Addict source code necessary to compile the application.  If you would rather not use Addict, you can delete the TAddictRichEdit components from the Patient Explorer and Template Manager forms and replace them with TRichEdit that comes with Delphi 7.

2.  Open the Addict a3RichEdit.pas file.  The TAddictRichEdit component is derived from TRichEdit.  TRichEdit has a protected OnDblClick event that PatientRunner needs to make use of.  In the a3RichEdit.pas source look in the TYPE declarations.  Just before this line "TAddictRichEdit = class(TRichEdit)" add:

TRichedit = class( ComCtrls.Trichedit )
public
  property OnDblClick;
end;

3.  If you don't want to use the TAddictRichEdit and prefer to use TRichEdit you will still need to add the interposer class.  Find the following block of code in PatientExplorer.pas and TemplateManager.Pas and uncomment it:

//The richedit control does not publish the OnDblClick event but it is there,
//only protected.  Use an interposer class as below to make it public.
//This commented out after addition of TAddictRichEdit for spelling

//TRichedit = class( ComCtrls.Trichedit )
//public
//  property OnDblClick;
//end;

4.  PatientRunner also relies on QuickReport.  QuickReport was replaced with Rave Reports in Delphi 7 however QuickReport still comes installed with Delphi 7.  To install QuickReport into Delphi, go to Components then Install package inside Delphi 7.  Manually add the dclqrt70.bpl package from the Delphi BIN directory.  You may need to go to QuickReport's home page at http://www.QuSoft.com and download the latest free upgrade to successfully compile the source.


Compiling the Self-installer with your Custom Executable
--------------------------------------------------------

1.  Download and install Inno Setup from http://www.jrsoftware.org/isinfo.php.
2.  Run Inno Setup
3.  Open the patientrunnerclient.isi Inno Setup script file
4.  Customize and compile
5.  Make sure you include all necessary dependency files (libmysql.dll and the dictionary files)


Notes
-----

Get involved by visiting the official PatientRunner site at http://sf.net/projects/patientrunner.  There you can download the latest software, participate in the discussion forums, submit bug reports, and feature requests.