GemsTracker

GEneric Medical Survey Tracker

User Tools

Site Tools


userzone:definitions

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
userzone:definitions [2013/02/21 18:38]
Matijs [Questions]
userzone:definitions [2020/03/12 12:06] (current)
Line 6: Line 6:
  
 An answer is a single answer to a single question in a filled-in survey, coupled to a respondent through a token. An answer is a single answer to a single question in a filled-in survey, coupled to a respondent through a token.
 +
 +==== Appointment ====
 +
 +Appointments are usually imported from external sources, but can be entered by hand as well.
 +
 +Appointments consist these fields as specified by HL7. 
 +  - Admission time. The start time of the appointment. (Not the moment the patient should be there)
 +  - Discharge time. Optional.
 +  - Status. A two letter code: ACtive, COmpleted, ABorted or CAncelled. ​
 +  - Admission code. One letter: Ambulatory, Emergency, Field, Home, Inpatient, Short stay, Virtual
 +  - Attended by. The staff member or department with whom the patient has an appointment.
 +  - Referred by. Optional, the staff member or department requesting the appointment.
 +  - Activity. A high level description of the appointment (e.g. Checkup, Operation, Therapy, etc...).
 +  - Procedure. Describes the effects that the appointment should have on the patient (e.g. more information,​ specific changes to the body or a general description,​ e.g. condition improvement).
 +  - Location. The physical location.
 +  - Subject. An optional short free text description of the appointment.
 +  - Comment. A longer field for comments.
 +
 +The above values are default specified by HL7 and usually different for each specific medical area. Most projects do not use all these fields.
 +
 +==== Appointment filter ====
 +
 +Appointment filter are used to link appointments to specific appointment track fields by selecting these filters in the definition of the appointment track field. (You will only see them once the first filter has been defined in Setup => Agenda => Agenda filters.)
 +
 +There exist multiple types of appointment filters, e.g. filters on appointment activity and procedure and on appointment subject. Filters can be combined in AND and OR filters. Also it has been made easy to create new filters.
 +==== Event ====
 +
 +GemsTracker has an event systems that allows code to be executed when a survey is displayed, answered or about to be answered. These events allow the administrator to change the display of the answers to a survey, but also to preset some of the answers before the respondent answers the survey and to calculate answers (e.g. BMI values) or to switch later rounds on or off. E.g. to skip a '​Return to Work' survey when the respondent does not work.
 +
 +Events can be set for a specific survey or for a specific use of that survey in a round of a track. There is also an event class to be called when a track has completed as a whole, e.g. to create a new track depending on the outcome.
 +
 +While there are some standard event classes, the event system is mostly used with project specific events. Writing a project specific event is easy to do, though it does require some knowledge about programming in PHP. 
  
 ==== Group ==== ==== Group ====
Line 20: Line 52:
  
 Questions usually have a code name. These code names can be used e.g. to perform calculations on the answers to a survey after answering. E.g. when a survey has questions with the code names WEIGHT, HEIGHT and BMI, then the BMI Calculation Event can be used to automatically calculate the BMI after a survey has been answered. Questions usually have a code name. These code names can be used e.g. to perform calculations on the answers to a survey after answering. E.g. when a survey has questions with the code names WEIGHT, HEIGHT and BMI, then the BMI Calculation Event can be used to automatically calculate the BMI after a survey has been answered.
 +
 ==== Reception code ==== ==== Reception code ====
  
Line 37: Line 70:
  
 A results is the answer to a single question in a survey, that is deemed to be the result of that survey. These results are stored in GemsTracker for quick display of these results A results is the answer to a single question in a survey, that is deemed to be the result of that survey. These results are stored in GemsTracker for quick display of these results
 +
 +==== Role ====
 +
 +
  
 ==== Round ==== ==== Round ====
Line 60: Line 97:
 See round. See round.
  
-==== Track (nl: Traject) ====+==== Track (in Dutch: Traject) ====
  
-A track contains one or more rounds of surveys. ​+A track contains one or more rounds of surveys. Tracks are created in the Track builder in the menu and consist of zero or more fields with track specific data and one or more rounds, each defining a survey to be answered by or for a respondent.
  
 Respondents are assigned to tracks manually by the users or through code written specifically for a project. Respondents are assigned to tracks manually by the users or through code written specifically for a project.
  
-==== Token ====+==== Track fields ==== 
 + 
 +A track can have one or more track fields that can contain data that explains the assignment of the track to the respondent. Example fields are a description,​ some date or a list of choices stating that a track is assigned to e.g. the right side of the respondents body or the left side. Track fields can be mandatory or optional and they can be read-only or editable. All the values entered for track fields are bundled together to form a track description,​ unless you define the field not to be added to the track description. 
 + 
 +The most advanced type of track field is the **appointment field**. Appointments fields can be automatically filled using Appointment filters. You can even specify the field to automatically create a new track if an appointment matches the filter (and the patient does not have an existing unfinished track of that type). 
 + 
 +Appointment fields can also be used to fill other fields, e.g. setting the value of the location or attendant using the corresponding fields from the appointment. 
 + 
 +Projects can define their own track field types. 
 +==== Token (in Dutch: Kenmerk) ​====
  
 A token is an identification relating a single respondent to a single survey instance for a single round in a track assigned to that respondent. A token is an identification relating a single respondent to a single survey instance for a single round in a track assigned to that respondent.
userzone/definitions.1361468286.txt.gz · Last modified: 2020/03/12 12:08 (external edit)