Designing Physician Documentation - Family History
We create new clinical document forms by building one reusable section at a time and then combining them into a single form.
First we login as admin/admin and click on the clinical sections link.
Step 1 Form Design
In this example we are going to create a new system form called Family History with the following goals in mind.
- Break the form into reusable sections.
- Add the data elements using OpenEHR archetypes where possible.
- Map terms to SNOMED where possible.
Step 2 Family Health History Design
- Sections - we will break the form by site.
- Data elements will come from the openEHR-EHR-EVALUATION.risk-family_history archetype.
- (EDIT) Due to disparities in the archetype we added a new group of data elements called Family History.
- SNOMED findings will be used for each record.
Step 3 Data Elements
- Login as admin/admin
- Open the Data Elements tool (right click on nodes to get the menu).
- Create subcategory History and Physical –> Past Medical History –> Risk Family History
- Find the archetype using http://www.openehr.org/knowledge/
- Import the Archetype into that category.
- (EDIT) we added a subcategory History and Physical –> Past Medical History –> Family History
- (EDIT) we added 3 data elements
- Family History Condition
—- Integer
—- Positive/Negative
- Family History Patient Relative
—- String
—- Value List: PatientRelative
- Family History Condition Notes
—- String
Step 4 Terms
- Open the Terms tool (right click on tree nodes).
- Create term category History and Physical –> Past Medical History –> Family History.
- Create all new subcategories e.g. System Family History Eyes.
- Find the concept ids using http://eagl.unige.ch/SNOCat/.
- Add terms selecting the appropriate subcategory
- Search for the concepts in PatientOS in the format <conceptid>|<conceptid>|.. etc.
- Repeat with each new subcategory.
- We also add a free text term ‘Other’ for the subcategory.
Step 5 Create Form
- Open the Clinical Sections tool
- Create a new form for the first section System - Family History Eyes
- We view the form properties
- change the columns to 4.
- add a custom column definition “1dlu, 1dlu, 1dlu, max(75dlu;p), 1dlu, 1dlu, 1dlu, max(25dlu;p), 1dlu, 1dlu, 1dlu, max(50dlu;p), 1dlu, 1dlu, 1dlu, max(75dlu;p)” - We add 4 labels, one per column
- Condition
- Present?
- Relation
- Notes - We then add 4 controls
- Condition
—- Custom Term Display Field
—- Record Item: Family History Condition
—- Term: Cataract
- Present?
—- Custom 3 state field
—- Record Item: Family History Condition
—- Term: Cataract
- Relation
—- Pick list
—- Record item: Family History Relation
—- Term: Cataract
- Notes
—- Free Text field
—- Record Item: Family History Condition Notes
—- Term: Cataract - We then copy the 4 controls and paste as 4 new controls
- Select the 4 new controls and press the Term toolbar button to change the term to Glaucoma for all 4
- Repeat 6-8 for the term Other in the Family History Eyes category
- Save the form
- Repeat for all form sections





