This wiki has undergone a migration to Confluence found Here
<meta name="googlebot" content="noindex">

Difference between revisions of "Availability FHIR Resource Proposal"

From HL7Wiki
Jump to navigation Jump to search
(Created page with "{{subst::Template:FHIR Resource Proposal}}")
 
 
(12 intermediate revisions by the same user not shown)
Line 6: Line 6:
 
</div>
 
</div>
 
</div>
 
</div>
[[Category:FHIR Resource Proposal]]
+
http://wiki.hl7.org/index.php?title=Schedule_FHIR_Resource_Proposal
[[Category:Pending FHIR Resource Proposal]]
 
 
 
  
 
<!-- For additional guidance on considerations for resource creation, refer to [[FHIR Resource Considerations]] -->
 
<!-- For additional guidance on considerations for resource creation, refer to [[FHIR Resource Considerations]] -->
  
  
=PutProposedResourceNameHere=
+
=Schedule=
 
+
(formerly Availability - THIS PAGE REMOVED)
<!-- Resource names should meet the following characteristics:
 
* Lower camel case
 
* U.S. English
 
* Domain-friendly
 
* Short
 
* Clear
 
* Unique
 
* Avoid non-universal abbreviations (e.g. URL would be ok)
 
* Be expressed as a noun
 
* Be consistent with other similar resources
 
-->
 
  
 
==Owning committee name==
 
==Owning committee name==
 
+
[[Patient Administration]]
<!-- The name of the committee that is proposed to have responsibility for developing and maintaining the resources. -->
 
[[YourCommitteeName]]
 
  
 
==Contributing or Reviewing Work Groups==
 
==Contributing or Reviewing Work Groups==
 
+
* "None"
<!-- Additional work groups that may have an interest in contributing to, or reviewing  the content of the resource (optional) -->
 
* Work Group Name
 
* or link
 
* or "None"
 
  
 
==FHIR Resource Development Project Insight ID==
 
==FHIR Resource Development Project Insight ID==
 
+
pending
<!-- Please specify the id of your work group’s PSS for doing FHIR work.  (If submitted but not yet approved, just write “pending”.) The link to the PSS template can be found here: http://gforge.hl7.org/gf/download/docmanfileversion/6832/9398/HL7FHIR_DSTUballotPSS-20120529.doc -->
 
  
 
==Scope of coverage==
 
==Scope of coverage==
 +
The Schedule is used to cover:
 +
* a "planning horizon" of time where a resource has schedule resources defined
 +
* What type of appointment(s) may be booked into the slots associated with this schedule (This may be over-ruled by the associated slots)
 +
* Although the Schedule will normally be associated with Location, Practitioner, Device, Patient or RelatedPerson resources, they should be able to be associated with any resource type (likely other resources could be Group, or the recently defined EpisodeOfCare or HealthcareService)
  
<!-- Define the full scope of coverage for the resource.  The scope must be clearly delineated such that it does not overlap with any other existing or expected resource.  The scope will be used to govern "what is the set of potential applications to consider when evaluating what elements are 'core' – i.e. in the 80%"
+
The schedule does not cover:
 
+
* the start/end times for any particular time interval on the schedule (this is covered by the Slot resource)
Scope should consider numerous aspects of breadth of scope, including:
+
* a template for a recurrence pattern that could be used to "derive" associated slots. E.g. Mon-Fri 9am-5pm (at this point - this would be an extension if desired as in many systems this is a very complex structure and interaction with timezones would also need to be considered)
* Subject: Human vs. non-human vs. non-patient (e.g. lab bench medicine)
 
* Disciplines: Environmental Health, Palliative, Respiratory, Psychology, Maternity, Clinical Research
 
* Delivery environment (Community, Geriatric, Home care, Emergency, Inpatient, Intensive, Neonatal, Pediatric, Primary)
 
* Locale: Country, region
 
 
 
As a rule, resources should encompass all of these aspects.
 
-->
 
  
 
==RIM scope==
 
==RIM scope==
 
+
Act(Classcode=Slot and ActMood = ActMoodResourceSlot)
<!-- Identify the formal RIM mapping for the root concept of the resource.  The expectation is that the RIM mapping will be sufficiently precise so as to not overlap with any other resource definition. -->
 
  
 
==Resource appropriateness==
 
==Resource appropriateness==
 +
Many existing systems publish their resource availability information for consumers (software and people) to be able to understand if/when they can request to book appointments.
  
<!-- Does the resource meet the following characteristics?
+
Existing products that have calendaring information publish this type of information - often in the iCal standard Free-Busy format.
  
Must
+
A Schedule resource always exists with an associated set of slot resources except when it is intended to indicate that there are no available time slots within a planning horizon.
* Represents a well understood, "important" concept in the business of healthcare
 
* Represents a concept expected to be tracked with distinct, reliable, unique ids
 
* Reasonable for the resource to be independently created, queried and maintained
 
  
Should
+
==Expected implementations==
* Declared interest in need for standardization of data exchange</span>
+
This resource is expected to be implemented in scheduling systems used by clinics, general practices and specialist healthcare provider's to share their schedule's availability information.
* Resource is expected to contain an appropriate number of "core" (non-extension) data elements (in most cases, somewhere in the range of 20-50)
 
* Have the characteristics of high cohesion & low coupling – need to explore whether coupling is good some places, not elsewhere – layers from Bo’s document
 
-->
 
  
==Expected implementations==
+
This information can be used to take appointments directly from users internal or external to the organization providing the information.
  
<!--Key resources are justified by CCDA, for resources not deemed "key", what interest is there by implementers in using this particular resource. Provide named implementations if possible - ideally provide multiple independent implementations. -->
+
The users could be either the Patient, the Provider, or an agent acting on the Patients behalf (such as his General Practitioner or Care Manager)
  
 
==Content sources==
 
==Content sources==
 +
The slot resource has some overlap with the iCal standard, the mapping to this standard will also be in scope of the resource.
  
<!-- List all of the specifications (beyond those in the "standard" (FHIR_Design_Requirements_Sources) list of source specifications) that you’re planning to consult
+
We also considered the HL7 v2 and v3 schedule messages and models which are also closely related to the iCal standard and this proposed resource.
  
Are there any source specifications that you wish to consult but are concerned about access to or expertise to consider? -->
+
==Example Scenarios==
 +
A Physio-Therapy clinic wants to publish a 2 month planning horizon for where appointments can be booked. It will publish a single Availability resource describing the 2 month range; what it can be used for, and then create the set of time slots that can actually be booked against.
  
==Example Scenarios==
+
An outpatients clinic's Operating Room publishes its schedule availability information. Several schedule records are created to cover the different types of surgery that can be booked into the associated time slots. At this particular outpatient clinic, the mornings slots are available for general surgery appointments, and the afternoon is restricted in the types of appointments due to staffing restrictions and reduced recovery times. By using several schedule records the slots associated with these would not need to over-ride the default service type.
  
<!-- Provide a listing of the types of scenarios to be represented in the examples produced for this resource.  They should demonstrate the full scope of the resource and allow exercising of the resources capabilities (full element coverage, inclusion & omission of optional elements, repeating and singleton repeating elements, etc.) -->
 
  
 
==Resource Relationships==
 
==Resource Relationships==
 +
The Schedule Resource can reference "any" other resource as the individual that it is defining schedule availability information for, but will typically be used for Location, Practitioner, HealthcareService, Device, Patient or RelatedPerson resources.
  
<!-- What are the resources do you expect will reference this resource and in what context?
+
This resource will be referenced by the new Slot resource.
 
 
What resources do you expect this resource reference and in what context?
 
 
 
Note: These may be existing resources or "expected" resource
 
  
Reference to resources is really only relevant at the "same or higher level" (Bo – fix this wording)
+
Note: This resource will not be referenced by Appointment resources, the Appointment will reference the Slot resource directly (which then references this schedule record)
-->
 
  
 
==Timelines==
 
==Timelines==
 
+
Given the progress to date, we expect that this resource will be ready for inclusion in the DSTU2 Ballot the resource has already undergone a great deal of review in PA over the last 6 months.
<!-- Indicate the target date for having the resource complete from a committee perspective and ready for vetting and voting -->
 
  
 
==gForge Users==
 
==gForge Users==
 
+
brian_pos
<!-- Identify the userids who will require commit access to gForge to maintain the resource.  (Ensure all users have registered for gForge.) -->
+
ewoutkramer
 +
grahameg

Latest revision as of 18:25, 10 December 2014

http://wiki.hl7.org/index.php?title=Schedule_FHIR_Resource_Proposal


Schedule

(formerly Availability - THIS PAGE REMOVED)

Owning committee name

Patient Administration

Contributing or Reviewing Work Groups

  • "None"

FHIR Resource Development Project Insight ID

pending

Scope of coverage

The Schedule is used to cover:

  • a "planning horizon" of time where a resource has schedule resources defined
  • What type of appointment(s) may be booked into the slots associated with this schedule (This may be over-ruled by the associated slots)
  • Although the Schedule will normally be associated with Location, Practitioner, Device, Patient or RelatedPerson resources, they should be able to be associated with any resource type (likely other resources could be Group, or the recently defined EpisodeOfCare or HealthcareService)

The schedule does not cover:

  • the start/end times for any particular time interval on the schedule (this is covered by the Slot resource)
  • a template for a recurrence pattern that could be used to "derive" associated slots. E.g. Mon-Fri 9am-5pm (at this point - this would be an extension if desired as in many systems this is a very complex structure and interaction with timezones would also need to be considered)

RIM scope

Act(Classcode=Slot and ActMood = ActMoodResourceSlot)

Resource appropriateness

Many existing systems publish their resource availability information for consumers (software and people) to be able to understand if/when they can request to book appointments.

Existing products that have calendaring information publish this type of information - often in the iCal standard Free-Busy format.

A Schedule resource always exists with an associated set of slot resources except when it is intended to indicate that there are no available time slots within a planning horizon.

Expected implementations

This resource is expected to be implemented in scheduling systems used by clinics, general practices and specialist healthcare provider's to share their schedule's availability information.

This information can be used to take appointments directly from users internal or external to the organization providing the information.

The users could be either the Patient, the Provider, or an agent acting on the Patients behalf (such as his General Practitioner or Care Manager)

Content sources

The slot resource has some overlap with the iCal standard, the mapping to this standard will also be in scope of the resource.

We also considered the HL7 v2 and v3 schedule messages and models which are also closely related to the iCal standard and this proposed resource.

Example Scenarios

A Physio-Therapy clinic wants to publish a 2 month planning horizon for where appointments can be booked. It will publish a single Availability resource describing the 2 month range; what it can be used for, and then create the set of time slots that can actually be booked against.

An outpatients clinic's Operating Room publishes its schedule availability information. Several schedule records are created to cover the different types of surgery that can be booked into the associated time slots. At this particular outpatient clinic, the mornings slots are available for general surgery appointments, and the afternoon is restricted in the types of appointments due to staffing restrictions and reduced recovery times. By using several schedule records the slots associated with these would not need to over-ride the default service type.


Resource Relationships

The Schedule Resource can reference "any" other resource as the individual that it is defining schedule availability information for, but will typically be used for Location, Practitioner, HealthcareService, Device, Patient or RelatedPerson resources.

This resource will be referenced by the new Slot resource.

Note: This resource will not be referenced by Appointment resources, the Appointment will reference the Slot resource directly (which then references this schedule record)

Timelines

Given the progress to date, we expect that this resource will be ready for inclusion in the DSTU2 Ballot the resource has already undergone a great deal of review in PA over the last 6 months.

gForge Users

brian_pos ewoutkramer grahameg