Scheduling

NOTE - this screen does not automatically refresh - to check the current schedule, click the Find button.

This screen displays two tabs:

• Appointments - the diary of appointments  and their status.  The buttons allow you to move the appointment through its various stages from new to completed. For background see Concepts|Schedules, Work Lists and Workflow.
• Free Appointment Slots - provides a facility to find free appointment slots

Appointments

The appointments tab displays data in several modes:

• multi-schedule
• single schedule
• multi-day

Note that the left hand panel displays the current customer and patient. This will change as the different appointments are selected. Below the Bourke/Muffett appointment is selected (note the italic font).

First the multi-schedule display.

This is essentially a select screen. The selection fields area as follows:
View - this is used to select the Schedule View to be used
Schedule - this can be set to All or any one of the Schedules that are part of the current Schedule View.  If you select other that All, then the schedule will be displayed in single schedule mode - see below.
Clinician - this can be set to All or any one of the clinicians. If you select a clinician, then all the appointments for clinicians other that the one selected will be 'greyed out'.
Date - the date selector allows you to enter a date, go back or forth one day, or one week (the outer arrows), or, with the black square, select today.
Highlight - this can be set to Clinician, Event Type or Status and changes the colours used to display each appointment
Time - this can be set to All, Morning, Afternoon, Evening, AM or PM. This sets the part of the day for which the schedule is displayed. Note also that if there is part of the day for which the schedule is not available then there will be no slots in that part. In the picture, the Surgery starts at 8am but the main clinic not until 9am.

The display area consists of one column per schedule, each showing the appointments that match the selection conditions. What is displayed for each appointment is set via the Administration|Organisation|Schedule View screen. Here you can see that this view is set to display the customer, patient and status (but not the clinician).

The buttons are as follows: (see below for when the various buttons are displayed)
New - create a new appointment in the currently selected time slot. To select a time slot, click it and it will display in the slot, then press the New button (or click the slot again) and the New Appointment screen will open. The new appointment will have status Pending.
Edit - edit the selected appointment
Delete - delete the selected appointment, a confirm window will appear. Note that you cannot delete appointments that have status Completed - if you really do need to delete a completed appointment, then first edit it to change the status to other than  Completed.
Print - print the selected appointment
Check-In - initiates the check-in process      }
Consult - opens the Visit Editor window        } click here for details
Check-Out - initiates the check-out process  }
OTC - Over The Counter sale - opens the New Counter Sale window to allow you to make an OTC sale

 

Moving an appointment
If you want to move an appointment to another date/time, you can just edit the appointment and change the start and end times.

You can also 'cut and paste' it as follows (which also allows you to move it to another schedule):

• select the appointment by clicking on it
• cut it using Ctrl-X
• navigate to the day and schedule that you want
• click on the new time slot so that appears
• paste it using Ctrl-V

Copying an appointment
If you want to copy an appointment to another date/time, you can use 'copy and paste' as follows:

• select the appointment by clicking on it
• copy it using Ctrl-C
• navigate to the day and schedule that you want
• click on the new time slot so that appears
• paste it using Ctrl-V

---

 

The single-schedule display is as follows:

The selection fields and buttons are the same as for the multi-schedule display.

The display area columns are as follows:
Time - the slot start time
Status - the appointment status - which will be (in logical order) one of Pending, Waiting, Admitted, In-Progress, Billed, Completed, or Cancelled. Note that the status 'Checked-In' is translated here to 'Waiting' with the time since checked-in - see the 9.30 slot in the picture above.
Appointment Type - the type of appointment - those available are set via Administration|Types|Appointment Type
Customer - the customer - note that the name is a link - clicking on it will take you to the Customers|Information screen
Patient - the patient - note that the name is a link - clicking on it will take you to the Patients|Medical Records screen
Notes - the notes for the appointment
 

---

The multi-day display is the default display for Schedule Views that have Multiple Day View selected:

The selection fields and buttons are the same as for the multi-schedule display. It adds:

Dates - this allows the date range to be selected:

• Month - the default. Displays a months worth of appointments
• Week - displays a weeks worth of appointments
• Day - the same as the multi-schedule display

The display area consists of one column per day, and one row per schedule, each showing the appointments that match the selection conditions.

Appointments that start on a date before the first displayed date have an icon.

Appointments that end on a date after the last displayed date have an  icon.

 

 

Available Buttons
The following table shows when each button is displayed.

Button	Displayed When
OTC	always
New	time slot selected
Edit	appointment selected
Delete	appointment selected
Print	appointment selected
Check-In	status = Pending
Consult	status = In-Progress, Billed, Completed Note that if you press Consult on a Completed or Billed appointment, then the Visit Editor opens so that you can add to the visit record
Check-Out	status = In-Progress, Billed, Completed Note that if you press Check-out on a Completed appointment, a new invoice will be opened so that you can add items to it.

Find Free Appointments

The Find Free Appointments tab simplifies locating free appointment slots.

The upper part of the screen displays the query critiera. The lower part, the free slots matching the criteria.

Below, the query is for free slots in the Main Appointment Schedule from the 1/7 to the 3/7 between 10:00am and 1:00pm that are at least 1 hour in length.

Four matches have been shown. Clicking on one of these will switch to the appropriate Schedule View on the Appointments tab, selecting the Schedule time.

 

View - this is used to select the Schedule View to be used.
Schedule - this can be set to All, or any one of the Schedules that are part of the current Schedule View. 
From - the date to start searching from.
To - the date to search to.
From Time - the time of day to start searching from. If not set, this defaults to the time the schedule starts at.
To Time - the time of day to search to. If not set, this defaults to the time the schedule ends at.
Duration - the minumum duration to search for. This defaults to the minumum duration of the selected Schedule(s).

Boarding Schedules

Find Free Appointments can be used to locate consecutive days in boarding schedules. These should be configured to either have no Start Time nor End Time set, or to start at 0:00 and end at 24:00.

 

Work Lists

NOTE - this screen does not automatically refresh - to see the current status, click the Find button.

This screen is used to display the Work Lists - ie the list of tasks and their status. The buttons allow you to move the task through its various stages from pending to completed. For background see Concepts|Schedules, Work Lists and Workflow.

The screen displays data in two modes, multi-list and single list. Note that the left hand panel displays the current customer and patient. This will change as the different tasks are selected. Below the Casbolt/Bree task is selected (note the italic font).

First the multi-list display.

This is essentially a select screen. The selection fields area as follows:
View - this is used to select the Work List View to be used
Work List - this can be set to All or any one of the Work Lists that are part of the current Work List View.  If you select other that All, then the work list will be displayed in single list mode - see below.
Clinician - this can be set to All or any one of the clinicians. If you select a clinician, then all the tasks for clinicians other that the one selected will be 'greyed out'.
Date - the date selector allows you to enter a date, go back or forth one day, or one week (the outer arrows), or, with the black square, select today. Note that the date controls what is displayed as:
startTime <= day 23:59:59 and (endTime >= day 0:0:0 or endTime is null)
Functionally, this means that completed tasks will only be displayed if they were completed on the selected date.
Highlight - this can be set to Clinician, Event Type or Status and changes the colours used to display each task
Status - this can be set to All, Incomplete, or Complete

The display area consists of one column per work list, each showing the tasks that match the selection conditions. What is displayed for each task is set via the Administration|Organisation|Work List View screen. Here you can see that this view is set to display, the customer, patient and status (but not the clinician). The i balloon indicates that there is a note for the task - clicking the balloon will display the note. (If the task has been created as a result of checking-in a patient, then the task note will generated from the appointment reason and any appointment note.)

The buttons are as follows: (see below for when the various buttons are displayed)
New - create a new task in the currently selected work list. You may find it more obvious to click in the half slot at the bottom of the tasks in the desired work list column - this will display in the slot, then click it again (or press the New button) and the New Task screen will open.
Edit - edit the selected task
Delete - delete the selected task
Print - print the selected task
Consult - opens the Visit Editor window        } click here for details
Check-Out - initiates the check-out process  }
Transfer - transfers the task to another work list. If the target work list has templates or Use All Templates is ticked, a Print window will be displayed listing the available templates to print.
OTC - Over The Counter sale - opens the New Counter Sale window to allow you to make an OTC sale

 

---

 

The single-list display is as follows:

The selection fields and buttons are the same as for the multi-list display.

The display area columns are as follows:
Started - the time at which the task was created - not that only hours and minutes are shown even if the task was started say 3 days ago
Status - the task status - which will be (in logical order) one of Pending, In Progress, Billed, Completed, or Cancelled
Task Type - the type of task - those available are set via Administration|Types|Task Type
Customer - the customer - note that the name is a link - clicking on it will take you to the Customers|Information screen
Patient - the patient - note that the name is a link - clicking on it will take you to the Patients|Medical Records screen
Notes - the notes for the task
Time - the time (in hours and minutes) since the task was started

 

 Available Buttons
The following table shows when each button is displayed.

Button	Displayed When
OTC	always
New	work list selected
Edit	task selected
Delete	task selected
Print	task selected
Consult	status = In-Progress, Billed
Check-Out	status = In-Progress, Billed
Transfer	status = Pending, In-Progress, Billed

Messaging

This is the screen used to manage messages. For background, see also Concepts|Messages.

The screen is in two halves, the top is a standard select screen, the bottom displays the selected message, and then there are buttons to create, process and print the messages.

In the top half:
Type - selects the type of message (All, System, or User)
Status - selects the message status (Completed, Pending or Read). Newly received messages will be Pending until read by the To addressee, then Read, and then (when the Completed button is pressed), Completed.
Dates - normally you can leave the All box checked, otherwise uncheck it and enter the required from and to dates
User - by default this will be set to your user name, but you can enter any name in order to see the messages to that user.  Note that you cannot enter a user-group name.

The column headings are as follows:
Date - shows the date and time, or if it's today then just the time
Description - the message subject
From - the user who sent the message
Reason - the message reason
Status - its status. This will be Pending, Read (ie read by the To addressee), or Completed.
Item - this field will be blank for User messages, but may contain information for System messages

In the bottom half the fields are self-explanatory, except for the following:
From & To - note that these user names are links, and clicking on them will redisplay the screen with the User set to the name you clicked. Hence you can quickly switch to see the messages for the from or to person.
Customer & Patient - similarly, these are links to take you to the customer or patient workspace

Buttons - these are as follows: (only New will be visible if no message is selected)
New - create a new message
Reply - reply to the message
Forward - forward the message
Delete - delete the message
Complete - change the message status to Completed
Print - print the message

Note that you can forward and reply to completed messages - the resulting message will be 'Pending'.

 

Investigations

This Investigations screen is used to display the status of investigations. For background see Concepts|Investigations.

This is a standard select screen. As well as the date range you can select by:

Search - use this to locate investigations by patient names or investigation identifier.
Status - can be set to All, Incomplete, Cancelled, Completed, Final, In Progress, Preliminary or Received - see below. If set to Incomplete, this will match investigations that are neither Completed nor Cancelled.
Location - filters by the practice location where the investigation was created. Restricted to the locations visible to the current user. Investigations with no location (i.e. investigations created prior to OpenVPMS 1.8) will always be displayed.
Clinician - filters by the clinician who created the investigation.
Investigation Type - filters by investigation type.

The column headings are as follows:
Date - the date on which the investigation was initiated
Investigation Type - the type of investigation - clicking on the link takes you to the Administration|Types|Investigation View screen to view the details
Customer - the owner of the patient at the time of the investigation.
Patient - the patient - this is a link and you can click on it to go to the patient's medical records screen
Request Id - the unique number that identifies the investigation
Status - the status - see below
Product - the product that invoked the investigation, or, if the investigation was manually initiated, the product (if any) specified
Clinician - the name of the clinician (note that in this example the practice is using the convention of using 'short names' for their clinicians) - clicking on the link takes you to the Workflow|Messaging screen to display messages to this clinician.
Location - the practice location where the investigation was created. For investigations with no location (e.g. those created prior to OpenVPMS 1.8), this will display None.
Supplier - the organisation doing the test or procedure - clicking on the link takes you to the Suppliers|Information screen to display the supplier's details
Report - if results have been received, they will be shown here - clicking on the link will display or download the result image/document. Note that in the above screen shot you can see that the majority of the results files have the investigation number as the first part of the file name - this allows the automatic loading of the results file by the document loader program.

The status will be one of the following:

• In Progress - the initial status
• Received - results back
• Preliminary - results returned but preliminary
• Final - results returned and final
• Completed - vet reviewed and owners contacted and whatever other steps were needed
• Cancelled - investigation has been cancelled

All of these can be set manually. The document loader program sets the status to Received when it imports the results file.

 

The View and Edit buttons have their standard meanings.

Visit Editor

The Visit Editor allows you to do all the work of recording the activities in the visit.

It has a tabs for Summary, Invoice, Reminders/Alerts, Documents, Prescriptions and Estimates.

Although the Summary tab looks almost the same as the Patients|Medical Records screen Summary tab, it has two extra buttons at the bottom, OK and Cancel. OK means 'save any changes I have made and exit the visit editor'; Cancel means 'discard any changes I have made and exit the visit editor'.

These OK and Cancel buttons are present on all the tabs. Thus if you press OK on the Invoice tab, you will exit the Visit Editor. If you press OK but didn't intend to exit the Visit Editor, don't worry - just press the Consult button and that will return you to the Visit Editor.

Check-Out Print

The window below is displayed at the end of the check-out process when there are documents to be printed. Thes may be invoices, certificates and forms, etc.

Ensure the ones you want printed are checked, and uncheck all the rest. The buttons are as follows:

OK - initiate the printing of the selected documents
Skip - skip the printing
Cancel - abort the check-out
Mail - bring up an email write screen so that the selected documents can be emailed
 

Customer Orders

The Customer Orders screen displays the status of customer orders and returns.

In OpenVPMS 1.8, orders and returns are created by Pharmacy Services when pharmacy products are dispensed.

 

Query

Customer orders can be queried by:

Type	The customer order type. Defaults to All, indicating all order types.
Status	The customer order status. Defaults to In Progress.
Date Range	Filters orders and returns based on their creation date. If All is selected, no filtering occurs.
Location	The practice location where the order was created. Restricted to the locations visible to the current user.
Customer	The customer that the order belongs to
Clinician	The clinician responsible for the order

Actions

The following actions may be performed:

New	Create a new order or return
View	View the selected order/return
Edit	Edit the selected order/return
Delete	Delete the selected order/return
Invoice	Where possible, OpenVPMS will automatically process orders and returns during the Check-In, Consult, and Check-Out worfklows. This button can be used to charge orders and returns outside of workflows. See Order Charging and Return Charging below
Print	Print the selected order/return

Order Charging

If the selected order does not relate to an existing invoice, a new Invoice will be created.

If the order relates to an existing invoice, and the invoice is:

• In Progress - the order will update the invoice. For each corresponding line item:
  • The order Quantity will be added to the Received Quantity
  • The invoice Quantity will be set to the new Received Quantity
• Finalised - and the order quantity is:
  • equal to the invoice quantity - the order will be Finalised
  • greater than the invoice quantity - a new Invoice will be created. The new line item quantity will be the difference between the order and invoice quantity.
  • less than the invoice quantity - a new Credit will be created. The new line item quantity will be the difference between the invoice and order quantity.

Warning: if there are multiple orders or returns relating to a single invoice, and that invoice is Finalised, these will not be taken into account when determining the new Invoice/Credit quantity.

Return Charging

If the selected return relates to an existing invoice, and the invoice is:

• In Progress - the return will update the invoice
• Finalised - a new Credit will be created