5.3. List of GnuMed client internal signals

Supplied by Horst Herb

All signals are defined in the module gmSignals.py, located in the source tree under gnumed/client/python-common.

Developers never should use these signal strings directly, but always refer to the signal strings via their factory functions in the module gmSignals.

The name of the factory function is identical with the signal it represents: gmSignals.popup_notice() would thus return the string 'popup_notice'.

However, these factory functions may do more than just that; they can also trigger a 'listen' signal for asynchronous backend notifications, and they can do some house keeping in order to avoid that the same callback is triggered multiple times unneccessarily.

Table 5-1. Signals

SignalMeaningParameter(s)Origin
General messages
popup_noticeA popup notice wants to be displayed (can be disabled if client does not want to be interrupted)

  • id_sender (ID of sender)

  • id_recipients ( IDs of recipients as list (-1 = broadcast message))

Frontend or Backend
popup_alertA popup alert wants to be displayed (high priority message - should not be disabled by the client)

  • id_sender (ID of sender) id_recipients

  • ( IDs of recipients as list (-1 = broadcast message))

Frontend or Backend
"Current patient" related messages
patient_selectedA patient has been selected within the client user interface. This patient is now the "current" patient. All widgets displaying client data must update themselves accordinglyid_patient (ID of patient)Frontend
patient_modifiedA patient's demographic data has been updated. Widgets displaying a patient's demographic data must update themselvesid_patient (ID of patient)Frontend or Backend
medication_modifiedThe current patient's medication has been modified. Medication related widgets have to update themselves. This can also be used for drug interaction checking, drug allergy checking etc. id_patient (ID of patient)Frontend or Backend
Waiting room related
waitingroom_addedA patient has been added to the waiting room

  • id_patient (ID of patient)

  • id_doctor (ID of doctor to see patient)

Frontend or Backend
waitingroom_inconsA patient has entered a consultation (is seen by a doctor)

  • id_patient (ID of patient)

  • id_doctor (ID of doctor to see patient)

Frontend or Backend
waitingroom_leftA patient has left the waitingroom (finished consultation)

  • id_patient (ID of patient)

  • id_doctor (ID of doctor to see patient)

Frontend or Backend