Overview

This project will provide a Lost & Found, a central facility to view documents and results where the patient or investigation is not known, and attach them to the appropriate patient.

It will:

• provide a workspace to list documents and/or results that cannot be linked to a patient
• update the Document Loader store documents that cannot be loaded, so they can be managed by the workspace
• provide a plugin API to enable laboratory services to record documents and results that cannot be associated with patients

Background

At present, documents are loaded into OpenVPMS using the Document Loader.

This is a scheduled job that periodically load files from a directory and attaches them to documents or investigations.

Files are associated with documents or investigations by parsing their identifier from the file name.

If a document or investigation cannot be found, the file is moved to an error directory. Users must remember to check this periodically, and then manually attach the file to the patient history.

In OpenVPMS 2.2, there will be better laboratory integration, however results from these can still fail to be associated with a patient if the original investigation has been deleted, for example.

Lost & Found Workspace

The Lost & Found Workspace will be located under Workflow.

It will provide a table that displays all documents and results that cannot be matched to a patient, with the following columns:

• Date - the document date
• Patient Name - the patient name, if known
• Patient Id - the patient id, if known
• File Name - the file name
• Message - the reason the result cannot be attached
• InvestigationType - the investigation type, if known
• Document - link to view the document content
• Results - link to view any results

The following buttons will be provided:

• Recover - displays a dialog that links the document or result to the correct patient.
• Delete - deletes the document permanently

The Recover button displays a dialog that prompts for the:

• Patient
  • will be preselected, if known
• Type
  • one of Investigation, Attachment, Letter?
  • defaults to:
    • Investigation, if results are known to be for an investigation
    • Attachment, for other documents
• Investigation Type
  • the investigation type, if the Type is Investigation
• Patient Visit
  This will be preselected, based on the patient and document date.
  A History browser may be shown to select a different Visit, or create a new one.

When the relevant details are populated, clicking OK will add the appropriate record to the patient's history, and remove it from the list of 'lost' documents.

Document Loader

The Document Loader will be updated so that any document that cannot be loaded will be moved to Lost & Found.

Plugin API

A plugin API will be provided to allow plugins to log documents and results to Lost & Found.