From the upcoming version of the OpenMRS Guide at http://booki.flossmanuals.net/openmrs-guide/_full/ A Visit in OpenMRS represents exactly what it sounds like: a time period when a patient is actively interacting with the healthcare system, typically at a location. The metadata differentiating different types of visits is a Visit Type. Visit Types are displayed in the user interface, and can be searched against. A visit containsEncounters, which store more granular data about treatments or services. Historical note: Encounters were supposed to be what Visits are, but we got them wrong…
Visit Encounter ◦ Patient ◦ Patient ◦ Visit Type ◦ Encounter Type ◦ Location (optional) ◦ Location (optional) ◦ Start DateTime ◦ DateTime ◦ End DateTime i.e. a single instant i.e. a duration ◦ Providers ◦ Contains Encounters ◦ Contains Obs Think of an Encounter as a “data collection transaction” or a “clinical transaction”
A big improvement in our information model ◦ Especially if you’re doing point-of-care work If you already have workflows and forms built around encounters, shifting to visits may require significant work and reconfiguration. Disabling visits lets you continue with the old model
To categorize Visits Displayed in the UI Make them granular enough for meaningful use: Outpatient Primary Care is better than just Outpatient Just a Name and Description ◦ In the future Visit Type may drive which encounters are allowed/expected in a visit
Reporting and Reporting Compatibility don’t let you search on them ◦ If you want this, create a ticket or vote for it! HTML Form Entry and XForms don’t explicitly support visits ◦ thus you need to configure automatic assignment of encounters to visits
Choose one of the two “Assign …” options As each encounter is created (assuming it doesn’t have a visit specified explicitly) it will be assigned to a visit with: ◦ encounter location is visit.location or a sublocation ◦ visit start <= encounter datetime<= visit end “Create New” option also requires you to set “Encounter Type to Visit Type Mapping” GP This is all very new. Let us know how it works out. Tickets welcome!
HTML Form Entry works fine with Visits if you configure your forms right!Bad:<encounterDate default=“today”/>Good:<encounterDate default=“now” The UI creates visits showTime=“true”/> starting “now.” An encounter at 00:00 today cannot be assigned to a visit started at 9:15.
??? ◦ I haven’t used XForms in OpenMRS 1.9. ◦ I assume it works. ◦ Can someone comment?
Outpatient visits typically do not have an official check-out Need to auto-close outpatient visits, or they If you’re building a custom UI, you will never get closed. probably want something like this: Inpatient visits typically have a real-life discharge workflow.
Custom attributes, Recorde d for each visit Virtual “columns” in the visit table Arbitrary use cases. I can’t think of any good examples. :-)
Data collected pre-1.9 doesn’t have visits We need to improve this UI a bit ◦ https://tickets.openmrs.org/browse/TRUNK-3299
Start Visit defaults to “now”. Add Visit asks you to enter the date Billing code should be shown as required. We have some UI issues to work out.