Skip to content

Add procedure history management system with encounter type and form #41

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 3 commits into
base: main
Choose a base branch
from
+229 −3
Open

Add procedure history management system with encounter type and form #41

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
9117553
Add sample OCL procedure concepts, procedure history encounter type, …
Mwanje Sep 17, 2025
9072704
addressed PR comments
Mwanje Sep 24, 2025
2f68a80
addressing PR comments
Mwanje Sep 26, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
225 changes: 225 additions & 0 deletions configuration/backend_configuration/ampathforms/procedure-history-form.json
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,225 @@
{
"name": "Procedure Form",
"pages": [
{
"label": "Procedure History",
"sections": [
{
"label": "Procedure History",
"isExpanded": "true",
"questions": [
{
"type": "obs",
"questionOptions": {
"rendering": "select",
"isSearchable": true,
"concept": "1651AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",
"answers": [
{
"concept": "441AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",
"label": "Clean and dressing"
},
{
"concept": "1934AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",
"label": "Suture wound with dressing"
},
{
"concept": "654781a2-5b3d-4fc6-a55b-66e8d7bce2f8",
"label": "Orbital surgery"
},
{
"concept": "646e5c57-c07d-4752-b1b3-dc4e14959419",
"label": "Valvuloplasty"
}
]
},
"id": "procedurePerformed",
"label": "Procedure performed",
"required": true
},
{
"type": "obs",
"questionOptions": {
"rendering": "datetime",
"concept": "160715AAAAAAAAAAAAAAAAAAAAAAAAAAAAAA"
},
"id": "procedureStartDate",
"label": "Date/time procedure started",
"datePickerFormat": "both",
"validators": [
{
"type": "date",
"allowFutureDates": "false"
}
]
},
{
"type": "obs",
"questionOptions": {
"rendering": "datetime",
"concept": "167132AAAAAAAAAAAAAAAAAAAAAAAAAAAAAA"
},
"id": "procedureEndDate",
"label": "Date/time procedure ended",
"datePickerFormat": "both",
"validators": [
{
"type": "date",
"allowFutureDates": "true"
},
{
"type": "js_expression",
"failsWhenExpression": "procedureStartDate && procedureEndDate && (new Date(procedureEndDate) < new Date(procedureStartDate))",
"message": "Procedure End date/time cannot be before start date/time"
}
]
},
{
"type": "obs",
"questionOptions": {
"rendering": "text",
"concept": "163049AAAAAAAAAAAAAAAAAAAAAAAAAAAAAA"
},
"id": "procedureSite",
"label": "Procedure site"
},
{
"type": "obs",
"questionOptions": {
"rendering": "select",
"concept": "160721AAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",
"answers": [
{
"concept": "160717AAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",
"label": "Procedure outcome satisfactory to patient"
},
{
"concept": "160718AAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",
"label": "Procedure outcome satisfactory to physician"
},
{
"concept": "160719AAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",
"label": "Procedure outcome unsatisfactory to patient"
},
{
"concept": "160720AAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",
"label": "Procedure outcome unsatisfactory to physician"
}
]
},
"id": "procedureOutcome",
"label": "Procedure outcome"
},
{
"type": "obs",
"questionOptions": {
"rendering": "number",
"concept": "165929AAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",
"min": "1",
"max": "100000",
"step": 1
},
"id": "procedureDuration",
"label": "Procedure duration"
},
{
"type": "obs",
"id": "procedureDurationUnit",
"label": "Duration unit",
"questionOptions": {
"rendering": "select",
"concept": "1732AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",
"answers": [
{
"concept": "162582AAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",
"label": "Number of occurrences"
},
{
"concept": "162583AAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",
"label": "Seconds"
},
{
"concept": "1733AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",
"label": "Minutes"
},
{
"concept": "1822AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",
"label": "Hours"
},
{
"concept": "1072AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",
"label": "Days"
},
{
"concept": "1073AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",
"label": "Weeks"
},
{
"concept": "1074AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",
"label": "Months"
},
{
"concept": "1734AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",
"label": "Years"
}
]
},
"clearWhenExpression": "Number(procedureDuration) > 99 && (procedureDurationUnit === '1734AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA')",
"validators": [
{
"type": "js_expression",
"failsWhenExpression": "procedureDurationUnit === '1734AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA' && Number(procedureDuration) > 99",
"message": "Duration cannot exceed 100 years.. Change unit or reduce duration."
},
{
"type": "js_expression",
"failsWhenExpression": "procedureDurationUnit === '1733AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA' && Number(procedureDuration) > 1440",
"message": "Duration cannot exceed 1440 minutes.. Change unit or reduce duration."
},
{
"type": "js_expression",
"failsWhenExpression": "procedureDurationUnit === '1822AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA' && Number(procedureDuration) > 168",
"message": "Duration cannot exceed 168 hours.. Change unit or reduce duration."
},
{
"type": "js_expression",
"failsWhenExpression": "procedureDurationUnit === '1072AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA' && Number(procedureDuration) > 365",
"message": "Duration cannot exceed 365 days.. Change unit or reduce duration."
},
{
"type": "js_expression",
"failsWhenExpression": "procedureDurationUnit === '1073AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA' && Number(procedureDuration) > 52",
"message": "Duration cannot exceed 52 weeks.. Change unit or reduce duration."
},
{
"type": "js_expression",
"failsWhenExpression": "procedureDurationUnit === '1074AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA' && Number(procedureDuration) > 12",
"message": "Duration cannot exceed 12 months.. Change unit or reduce duration."
}
]
},
{
"type": "obs",
"questionOptions": {
"rendering": "textarea",
"concept": "160716AAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",
"rows": 5
},
"id": "procedureComment",
"label": "Procedure comment"
}
]
}
]
}
],
"processor": "EncounterFormProcessor",
"encounter": "Procedure History",
"encounterType": "e22e39fd-7db2-45e7-80f1-60fa0d5a4378",
"referencedForms": [],
"uuid": "a2a125b6-62c5-4b5a-b86e-d252266d4b92",
"description": "Procedure History Form - used for documenting completed medical procedures",
"version": "1.0.0",
"published": true,
"retired": false
}
7 changes: 4 additions & 3 deletions configuration/backend_configuration/encountertypes/encountertypes_core-demo.csv
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
Uuid,Void/Retire,Name,Description,View privilege,Edit privilege,_order:1000
0e8230ce-bd1d-43f5-a863-cf44344fa4b0,,Adult Visit,Encounter for adult visit form,,,,
dd528487-82a5-4082-9c72-ed246bd49591,,Consultation,Consultation encounter,,,,
0e8230ce-bd1d-43f5-a863-cf44344fa4b0,,Adult Visit,Encounter for adult visit form,,,
dd528487-82a5-4082-9c72-ed246bd49591,,Consultation,Consultation encounter,,,
ca3aed11-1aa4-42a1-b85c-8332fc8001fc,,Check In,Indicates the patient has done the required paperwork and check-in to begin a visit to the clinic/hospital.,,,
67a71486-1a54-468f-ac3e-7091a9a79584,,Vitals,For capturing vital signs,,,
e22e39fd-7db2-45e7-80f1-60fa0d5a4378,,Admission,"Indicates that the patient has been admitted for inpatient care, and is not expected to leave the hospital unless discharged.",,,
Expand All @@ -17,4 +17,5 @@ d3b07384-8d1c-4e6b-9b8e-2f3b8e4a1c9f,,Transfer,Indicates that a patient is being
a1f5c3d2-4b6e-4e8a-9f2d-1b3e8e4a2d7f,,Inpatient Note,A short free-text note written by a clinician about an inpatient during their stay,,,
b2c4d5e6-7f8a-4e9b-8c1d-2e3f8e4a3b8f,,Transfer Request,A stand-alone encounter type for a transfer request not part of a larger note,,,
f47ac10b-58cc-4372-a567-0e02b2c3d479,,Bed Assignment,Assigning a new bed to a patient without admitting or transferring them,,,
550e8400-e29b-41d4-a716-446655440000,,Cancel ADT,An encounter that notes that a request to admit/transfer/discharge a patient is being overridden,,,
550e8400-e29b-41d4-a716-446655440000,,Cancel ADT,An encounter that notes that a request to admit/transfer/discharge a patient is being overridden,,,
6f8393e7-cf3d-45e1-abc1-d83858a18d8c,,Procedure History,Encounter for documenting completed medical procedures,,,
Binary file added .../backend_configuration/ocl/openmrs_sampleprocedures_v1_autoexpand-1.2025-09-05_034146.zip
View file
Open in desktop
Binary file not shown.