DOC - Clinical Encounter
Naming and Coding
Each medical visit is a markdown
file named using the code format encXYZ-K-N.encounter
, where XYZ
is the patient's numeric identifier, K
is the clinical case number, and N
is the sequential number for the current visit. For example, enc100-1-2.encounter is the second visit of the patient with the alias – NIKOLAOS_PAPADOPOULOS_6945678901, related to the first clinical case.
If you click the pages icon at the top right of the title bar (see Fig. 1) above the banner, it will show the visit file under the patient’s folder within Windows System Explorer. Slightly to the left, there is another icon 📄; clicking this the file will appear in the left panel within Obsidian File Explorer.
Encounter/Visit Description
At the top of the visit page, Fig. 1, there are buttons that provide quick access to the patient's profile, history, medication, and medical library. Under these buttons there is the patient’s full name and age, the visit status (scheduled, in progress, completed, canceled, etc.), an internal link to the clinical case associated with the visit, and another link to the patient record summary. Just below the appointment date for the visit, also an internal link, is displayed. When you click the link it opens the appointment page (see appointment scheduling).
Content of Encounter
The visit is divided into the following sections. By clicking the corresponding link, you will be taken directly to the specific part of the patient's visit (see use of internal links):
Folding Sections/Text
Obsidian also provides the ability to fold and unfold text (folding). There are two buttons for this function above the banner image (Fold headings and list, Unfold headings and list). After folding, you can open just one section of the medical visit, e.g. General Review, to display the relevant information (Fig. 2).
Embedding a Section of the Visit
Thanks to the embedding capability that Obsidian provides, we can, embed the patient's Review of Systems (ROS) directly at this point:
New Encounter
To create a new visit for the patient NICKOLAOS_PAPADOPOYLOS_6945678901, open patient record summary and click the NEW VISIT
button, as shown in Fig. 3. The new visit is automatically linked to the current (latest) clinical case of the patient.
Scheduling an Appointment with Obsidian Calendar Plugin
Before we begin filling out the details of the new visit, Obsidian MEDILIG will first create a new appointment for the patient. This appointment is automatically named using a standardized format that includes:
- The date in the format
YYYY-MM-DD
, - The alias of the patient (full name and phone number),
- And a number at the end indicating the total number of appointments-visits the patient has had.
For example, in the left panel of the interface, the entry 2024-08-23 NICKOLAOS_PAPADOPOYLOS_6945678901 (3)
indicates the third appointment for this patient, which is also visible in the center of the screenshot (see Fig. 4).
These appointment files are stored separately from the patient’s folder, specifically under Calendar\Consultation
, to ensure compatibility with the Calendar plugin. This setup allows the calendar to properly display appointments by month, week, day, or in a list view. In the example, we can see the appointment appearing as a yellow box on the selected day and time, indicating its scheduled placement on the calendar (Fig. 4).
Rescheduling the Appointment in the Calendar
To change the date and time of a patient’s appointment, the right-hand panel must be opened and the 📅 icon selected in order to display the full calendar. From this view, it is possible to choose how appointments are displayed (by month, week, day, or in list format). Then, click on the appointment box that requires modification. A black window will appear showing the appointment details, Fig. 5. After adjusting the date and time, the Save Event
button must be pressed. The Open Note
button provides access to the appointment contents (in the figure, it is already open).
Rescheduling of the appointment must be carried out only in the manner described above. Otherwise, problems may arise, such as the loss of the link between the visit and the appointment, or the appointment may fail to appear in the calendar.
The Scheduled Appointment and the front-matter
Information (data) such as the appointment’s date, start time, and end time is automatically recorded in the fields of the front matter, which can be accessed from the right-hand panel of the application (Fig. 6) by clicking the 🛈 icon.
Patient's New Visit
Αφού προγραμματίσουμε το ραντεβού μπορούμε να πατήσουμε τον εσωτερικό σύνδεσμο enc100-2-3.encounter όπως φαίνεται στην Fig. 6 για να ανοίξει η καρτέλα με την νέα επίσκεψη του ασθενούς (Fig. 7). Ακόμη η πρόσβαση στην νέα, πιο πρόσφατη, επίσκεψη του ασθενούς μπορεί να γίνει και από την σύνοψη του φακέλου ασθενούς στο τελευταίο τμήμα του που αφορά όλες τις επισκέψεις για όλα τα περιστατικά:
Once the appointment has been scheduled, the internal link enc100-2-3.encounter can be selected, as shown in Fig. 6, to open the record of the patient’s new visit (Fig. 7). Access to the patient’s new, most recent visit can also be made through the patient record summary, in the final section that lists all clinical encounters for all cases.
Front-Matter Data for the Visit (Encounter)
The information (data) entered in the fields of the medical visit record is automatically recorded in the fields of the front matter, which can be accessed from the right-hand panel of the application (Fig. 8) by clicking the 🛈 icon.
Scheduled appointments for the current week of the year.
From the physician page you have access to the appointments for the current week of the year..