The Examination module consists a large number of elements to record different aspects of a patient examination. As a result, there are several configuration properties that can be set to control which of these elements appear by default (workflow), and how these elements behave (attribute definition and lookup configuration). There are also several core configurations that will have an impact on how the modules will behave.

Workflow

Workflows consist of a series of labelled element sets that are loaded by default as an examination progresses. The goal of this is to support a patient pathway of staged examinations, e.g. a nurse examines the patient to gather initial information, an optician performs some basic eye examinations, and then a consultant performs a specific Posterior Pole examination.

So a workflow is defined as OphCiExamination_Workflow w, which has 1 or more OphCiExamination_ElementSet s, which consists of 1 or OphCiExamination_ElementSetItem i. Each i points to a specific Examination element.

To determine which workflow applies to a new examination, 1 or more OphCiExamination_WorkflowRule r are defined for each w. These rules can filter on firm, subspecialty and episode status. Once an examination is created, it's workflow is fixed and it will follow the series of s sets that are defined on it.

As of 1.6 this is configurable through the admin interface. An example configuration can be found here

Attributes

Examination contains a model class called OphCiExamination_Attribute. This allows the dynamic definition of attributes that can be used on attributes. The OphCiExamination_AttributeElement class then allows these attributes to be mapped to one or more of the elements within examination. The options that exist for each of these attributes is defined through the OphCiExamination_AttributeOption class. Each option can be set to filter on the current subspecialty of the firm, or be available to all.

This is currently defined as a manual configuration process, and the attributes are only usable for specific elements in the examination. These are currently:

• History
• Adnexal Comorbidity
• Conclusion
• Investigation
• Management

Lookup Configuration

Lookups exist on many of the different Examination elements and serve different functions. The following list describes the lookups as of version 1.6. The table names are provided as a convenience for checking and updating values more easily.

Anterior Segment

OphCiExamination_AnteriorSegment_Cortical

ophciexamination_anteriorsegment_cortical

OphCiExamination_AnteriorSegment_Nuclear

ophciexamination_anteriorsegment_nuclear

OphCExaminiation_AnteriorSegment_Pupil

ophciexamination_anteriorsegment_pupil

CCT (child of Anterior Segment)

OphCiExamination_AnteriorSegment_CCT_Method

ophciexamination_anteriorsegment_cct_method List of possible methods for getting patient CCT

Clinic Outcome

OphCiExamination_ClinicOutcome_Role

ophciexamination_clinicoutcome_role Possible roles for clinic outcome follow up. Set 'requires_comment' field to true to force a comment to be entered when selected.

OphCiExamination_ClinicOutcome_Status

ophciexamination_clinicoutcome_status Possible outcomes for the element. The 'followup' flag being set to true will cause the follow up questions to be displayed in the element. The 'episode_status_id' sets what the episode status should become when this element status is selected.

OphCiExamination_ClinicOutcome_Template

ophciexamination_clinicoutcome_template A set of values to be assigned to the clinic outcome element by a separate element. Specifically used by OphCiExamination_GlaucomaRisk_Risk