Proposal: add Find Appointments Query

Summary

This proposal seeks to add a new query interaction to the Appointment topic of the Scheduling (PRSC) domain.

The new Find Appointments Query (PRSC_IN010701UV) queries the Appoint Manager for apppintments that match a set of criteria (e.g. the time of the appointment and the resources associated with the appointment) as specified in the query parameters. The intent and underlyinh use-cases are the same as those for the HL7 version 2 SQM/SQR - Schedule Query Message and Response (Event S25) (up to version 2.6; now deprecated and moved to chapter 5).

Use-case

Helse Vest, the western region of Norway has a use-case whereby:

1. (covered by a different proposal) They use a Find Encounters query to find out (e.g.) who is currently sitting in the waiting room in Building X. For all patient IDs returned in the response:
2. Query the appointment manager to find appointments for a given Patient ID and a particular resource (e.g. the ID of a particular piece of equipment).

Table 1 Find Appointments Query, parameters

Parameter	Notes	Mapping to response model
PatientId	mandatory parameter	ActAppointment/subject/Patient(PAT role).id
AssignedPersonID		ActAppointment/performer/AssignedPerson(role).id
EquipmentID		ActAppointment/reusabledevice/ManufacturedDevice(role).id
ServiceDeliveryLocationID	Note: Ward/room/bed is modeled in a recursive-hierarchy of PartOf relationships between ServiceDeliveryLocation classes, with the initial one in the hierarchy being ActAppointment/Location/ServiceDeliveryLocation. The Part role link (in the response model) is used in such a way that the hierarchy starts at the most atomic level (bed or room) and moves "up" the hierarchy towards the ward.	ServiceDeliveryLocation.id	??	Clinic	ActAppointment/Location/ServiceDeliveryLocation role (initial ServiceDeliveryLocation in the hierarchy) - scoping Organization.id (in scoping E_Organization)
TypeOfEncounter		ActAppointment.code
EncounterTimeFrame		ActAppointment.effectiveTime
CareEventID	(not a Helse Vest requirement, added for the sake of completeness) Note: the entry appointment class is ENC (encounter); one of its components may be an appointment for a specific care event (treatment, operation, etc.)	component2/ActAppointment.id