GNU Health/WebDAV

From Wikibooks, open books for an open world
< GNU Health
Jump to: navigation, search

Countries · Central Authentication

Symbol version newer.svg

This section applies to version 3.2 of GNU Health.

Introduction[edit]

GNU Health provides its own WebDAV and Caldav server. It allows to create and associate calendars to health professionals. The calendar entries for appointments, hospitalizations and other resources can be accessed via WebDAV clients.

Calendar capabilities of GNU Health using WebDAV protocol

Installation[edit]

To install the webdav functionality, you need to install the following packages

  • pywebdav3-gnuhealth : Python3 webDAV library for GNU Health (installed automatically when using the standard installation method)
  • trytond_webdav3 : Tryton webdav server, for Python3 and GNUHealth support
  • trytond_calendar_webdav3 : GNU Health calendar package with webdav3 support
  • health_calendar : Main calendar for appointments)
  • health_inpatient_calendar : Hospitalization / bed calendar support

If you have installed GNU Health from openSUSE packages, everything is already installed.

Setting up the WebDAV server[edit]

Check the settings for the host and port of the GNUHealth WebDAV server

[webdav]
listen = *:8080

In this sample from the default configuration file, the WebDAV server will accept connections from any network interface, on port 8080.

You can change the values editing the configuration file, using the command

editconf

Creating and Assigning Calendars[edit]

Creating a Calendar in GNU Health

In order to access a calendar, we first need to create it, and assign it to a user on our GNU Health Tryton instance.

To create a calendar, Follow the link:

Calendar -> Calendars

Assignment od the calendar to the login user.
  • Define a name to the calendar (use only letters, without punctuation or non-ascii characters).
  • Assign the calendar to a user (in this example, we assign the "Cordara" Calendar to the "Administrator" user
  • Enable read-access only to the calendar. Do this on the tab "Access Permissions"
  • Finally, assign the calendar to the user that will login to GNU Health. In this example, the user associated to the "Cordara" calendar is "Administrator", with username "admin". The credentials (username and password) used in the calendar are the same as for login into the GNU Health HMIS. For security reasons, use a SSL enabled connection.

Running the server[edit]

To start the webdav server, do the following

1) Check that the GNU Health server is running 2) Change to the webdav server directory

cdmods
cd trytond_webdav3/bin

Execute the server

nohup ./trytond-webdav &

openSUSE comes with a systemd-service called gnuhealth-webdav. It expects the database name as parameter. If your database is gnuhealth32, you can start the service with

systemctl start gnuhealth-webdav@gnuhealth32

Configuring the client[edit]

Known clients[edit]

Connection properties to add a new calendar in Mozilla Thunderbird, using Lightning

GNU Health Calendar system has been known to work on the following clients :

  • Mozilla Thunderbird, Lightning
  • Cadaver
  • Evolution

Set the hostname and port of the GNU Health WebDAV server . The default port is 8080

The nomenclature for the URL is :

http://your_server_hostname:your_server_port/database_name/Calendars/Calendar_name