SGHI FHIR Profile Implementation Guide
0.1.0 - ci-build
SGHI FHIR Profile Implementation Guide, published by Kathurima Kimathi. This guide is not an authorized publication; it is the continuous build for version 0.1.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/savannahghi/sil_fhir_profile_ig/ and changes regularly. See the Directory of published versions
| Active as of 2026-09-14 |
{
"resourceType" : "StructureMap",
"id" : "ExtractInpatientProgressNote",
"text" : {
"status" : "generated",
"div" : "<div xmlns=\"http://www.w3.org/1999/xhtml\"><p class=\"res-header-id\"><b>Generated Narrative: StructureMap ExtractInpatientProgressNote</b></p><a name=\"ExtractInpatientProgressNote\"> </a><a name=\"hcExtractInpatientProgressNote\"> </a><pre class=\"fml\">\r\n<span style=\"color: #cc00cc\">/// <b>url</b> = </span><span style=\"color: blue\">'https://fhir.slade360.co.ke/fhir/StructureMap/ExtractInpatientProgressNote'</span>\r\n<span style=\"color: #cc00cc\">/// <b>name</b> = </span><span style=\"color: blue\">'ExtractInpatientProgressNote'</span>\r\n<span style=\"color: #cc00cc\">/// <b>title</b> = </span><span style=\"color: blue\">'Inpatient Progress Note Extraction'</span>\r\n<span style=\"color: #cc00cc\">/// <b>status</b> = </span><span style=\"color: blue\">'active'</span>\r\n<span style=\"color: #cc00cc\">/// <b>description</b> = </span><span style=\"color: blue\">'Turns a response to the inpatient progress note into a single Composition with one section per SOAP heading. Nothing here is a discrete clinical fact -- a progress note is a document -- so no Observation, Condition or Task is produced. The QuestionnaireResponse remains the signed record and the Composition points back at it through relatesTo.'</span>\r\n\r\n<b>uses</b><span style=\"color: navy\"> "</span><a href=\"http://hl7.org/fhir/R5/questionnaireresponse.html\" title=\"QuestionnaireResponse\">http://hl7.org/fhir/StructureDefinition/QuestionnaireResponse</a><span style=\"color: navy\">" </span><b>alias </b>QR <b>as </b><b>source</b>\r\n<b>uses</b><span style=\"color: navy\"> "</span><a href=\"http://hl7.org/fhir/R5/bundle.html\" title=\"Bundle\">http://hl7.org/fhir/StructureDefinition/Bundle</a><span style=\"color: navy\">" </span><b>alias </b>Bundle <b>as </b><b>target</b>\r\n<b>uses</b><span style=\"color: navy\"> "</span><a href=\"http://hl7.org/fhir/R5/composition.html\" title=\"Composition\">http://hl7.org/fhir/StructureDefinition/Composition</a><span style=\"color: navy\">" </span><b>alias </b>Composition <b>as </b><b>target</b>\r\n\r\n<b>group </b>ExtractInpatientProgressNote<span style=\"color: navy\">(</span><b>source</b> <span style=\"color: maroon\">qr</span><span style=\"color: navy\"> : </span>QR, <b>target</b> <span style=\"color: maroon\">bundle</span><span style=\"color: navy\"> : </span>Bundle<span style=\"color: navy\">)</span><span style=\"color: navy\"> {\r\n</span> qr<span style=\"color: navy\"><b> -> </b></span>bundle.type = <span style=\"color: blue\">'transaction'</span> <i>"setBundleType"</i><span style=\"color: navy\">;</span>\r\n qr<span style=\"color: navy\"><b> -> </b></span> bundle.entry<b> as </b><span style=\"color: maroon\">entry</span><span style=\"color: navy\">, </span> entry.resource = <b>create</b><span style=\"color: navy\">(</span><span style=\"color: blue\">'Composition'</span><span style=\"color: navy\">)</span><b> as </b><span style=\"color: maroon\">comp</span><b> then</b><span style=\"color: navy\"> {\r\n</span> qr<span style=\"color: navy\"><b> -> </b></span> comp<span style=\"color: navy\">, </span> entry<b> then </b>BuildNoteBase<span style=\"color: navy\">(</span><span style=\"color: maroon\">qr</span><span style=\"color: navy\">, </span><span style=\"color: maroon\">comp</span><span style=\"color: navy\">, </span><span style=\"color: maroon\">entry</span><span style=\"color: navy\">)</span> <i>"noteBase"</i><span style=\"color: navy\">;</span>\r\n qr<span style=\"color: navy\"><b> -> </b></span>comp.name = <span style=\"color: blue\">'InpatientProgressNote'</span> <i>"noteName"</i><span style=\"color: navy\">;</span>\r\n qr<span style=\"color: navy\"><b> -> </b></span>comp.title = <span style=\"color: blue\">'Progress note'</span> <i>"noteTitle"</i><span style=\"color: navy\">;</span>\r\n qr<span style=\"color: navy\"><b> -> </b></span>comp.type<b> as </b><span style=\"color: maroon\">ty</span><b> then</b><span style=\"color: navy\"> {\r\n</span> qr<span style=\"color: navy\"><b> -> </b></span>ty.coding<b> as </b><span style=\"color: maroon\">sghi</span><b> then</b><span style=\"color: navy\"> {\r\n</span> qr<span style=\"color: navy\"><b> -> </b></span>sghi.system = <span style=\"color: blue\">'https://fhir.slade360.co.ke/fhir/CodeSystem/inpatient-document-type-codesystem'</span> <i>"sghiSystem"</i><span style=\"color: navy\">;</span>\r\n qr<span style=\"color: navy\"><b> -> </b></span>sghi.code = <span style=\"color: blue\">'progress-note'</span> <i>"sghiCode"</i><span style=\"color: navy\">;</span>\r\n qr<span style=\"color: navy\"><b> -> </b></span>sghi.display = <span style=\"color: blue\">'Progress note'</span> <i>"sghiDisplay"</i><span style=\"color: navy\">;</span>\r\n <span style=\"color: navy\">}</span> <i>"sghiCoding"</i><span style=\"color: navy\">;</span>\r\n qr<span style=\"color: navy\"><b> -> </b></span>ty.coding<b> as </b><span style=\"color: maroon\">loinc</span><b> then</b><span style=\"color: navy\"> {\r\n</span> qr<span style=\"color: navy\"><b> -> </b></span>loinc.system = <span style=\"color: blue\">'http://loinc.org'</span> <i>"loincSystem"</i><span style=\"color: navy\">;</span>\r\n qr<span style=\"color: navy\"><b> -> </b></span>loinc.code = <span style=\"color: blue\">'11506-3'</span> <i>"loincCode"</i><span style=\"color: navy\">;</span>\r\n qr<span style=\"color: navy\"><b> -> </b></span>loinc.display = <span style=\"color: blue\">'Progress note'</span> <i>"loincDisplay"</i><span style=\"color: navy\">;</span>\r\n <span style=\"color: navy\">}</span> <i>"loincCoding"</i><span style=\"color: navy\">;</span>\r\n qr<span style=\"color: navy\"><b> -> </b></span>ty.text = <span style=\"color: blue\">'Progress note'</span> <i>"typeText"</i><span style=\"color: navy\">;</span>\r\n <span style=\"color: navy\">}</span> <i>"noteType"</i><span style=\"color: navy\">;</span>\r\n <span style=\"color: navy\">// </span><span style=\"color: green\">Sections in the order the form asks for them, so the printed note reads</span>\r\n <span style=\"color: navy\">// </span><span style=\"color: green\">the way it was written. The `answer.value.exists()` guard is not</span>\r\n <span style=\"color: navy\">// </span><span style=\"color: green\">decoration: a section with a title and no content breaks cmp-1, and an</span>\r\n <span style=\"color: navy\">// </span><span style=\"color: green\">unanswered optional item still arrives as an empty item.</span>\r\n qr.item<b> as </b><span style=\"color: maroon\">it</span><b> where </b><span style=\"color: navy\">(</span>(linkId = 'subjective') and answer.value.exists()<span style=\"color: navy\">)</span><span style=\"color: navy\"><b> -> </b></span>comp.section<b> as </b><span style=\"color: maroon\">sec</span><b> then</b><span style=\"color: navy\"> {\r\n</span> it<span style=\"color: navy\"><b> -> </b></span>sec.title = <span style=\"color: blue\">'Subjective'</span> <i>"subjectiveTitle"</i><span style=\"color: navy\">;</span>\r\n it<span style=\"color: navy\"><b> -> </b></span>sec<b> then </b>AddSectionText<span style=\"color: navy\">(</span><span style=\"color: maroon\">it</span><span style=\"color: navy\">, </span><span style=\"color: maroon\">sec</span><span style=\"color: navy\">)</span> <i>"subjectiveText"</i><span style=\"color: navy\">;</span>\r\n <span style=\"color: navy\">}</span> <i>"subjectiveRule"</i><span style=\"color: navy\">;</span>\r\n qr.item<b> as </b><span style=\"color: maroon\">it</span><b> where </b><span style=\"color: navy\">(</span>(linkId = 'objective') and answer.value.exists()<span style=\"color: navy\">)</span><span style=\"color: navy\"><b> -> </b></span>comp.section<b> as </b><span style=\"color: maroon\">sec</span><b> then</b><span style=\"color: navy\"> {\r\n</span> it<span style=\"color: navy\"><b> -> </b></span>sec.title = <span style=\"color: blue\">'Objective'</span> <i>"objectiveTitle"</i><span style=\"color: navy\">;</span>\r\n it<span style=\"color: navy\"><b> -> </b></span>sec<b> then </b>AddSectionText<span style=\"color: navy\">(</span><span style=\"color: maroon\">it</span><span style=\"color: navy\">, </span><span style=\"color: maroon\">sec</span><span style=\"color: navy\">)</span> <i>"objectiveText"</i><span style=\"color: navy\">;</span>\r\n <span style=\"color: navy\">}</span> <i>"objectiveRule"</i><span style=\"color: navy\">;</span>\r\n qr.item<b> as </b><span style=\"color: maroon\">it</span><b> where </b><span style=\"color: navy\">(</span>(linkId = 'assessment') and answer.value.exists()<span style=\"color: navy\">)</span><span style=\"color: navy\"><b> -> </b></span>comp.section<b> as </b><span style=\"color: maroon\">sec</span><b> then</b><span style=\"color: navy\"> {\r\n</span> it<span style=\"color: navy\"><b> -> </b></span>sec.title = <span style=\"color: blue\">'Assessment'</span> <i>"assessmentTitle"</i><span style=\"color: navy\">;</span>\r\n it<span style=\"color: navy\"><b> -> </b></span>sec<b> then </b>AddSectionText<span style=\"color: navy\">(</span><span style=\"color: maroon\">it</span><span style=\"color: navy\">, </span><span style=\"color: maroon\">sec</span><span style=\"color: navy\">)</span> <i>"assessmentText"</i><span style=\"color: navy\">;</span>\r\n <span style=\"color: navy\">}</span> <i>"assessmentRule"</i><span style=\"color: navy\">;</span>\r\n qr.item<b> as </b><span style=\"color: maroon\">it</span><b> where </b><span style=\"color: navy\">(</span>(linkId = 'plan') and answer.value.exists()<span style=\"color: navy\">)</span><span style=\"color: navy\"><b> -> </b></span>comp.section<b> as </b><span style=\"color: maroon\">sec</span><b> then</b><span style=\"color: navy\"> {\r\n</span> it<span style=\"color: navy\"><b> -> </b></span>sec.title = <span style=\"color: blue\">'Plan'</span> <i>"planTitle"</i><span style=\"color: navy\">;</span>\r\n it<span style=\"color: navy\"><b> -> </b></span>sec<b> then </b>AddSectionText<span style=\"color: navy\">(</span><span style=\"color: maroon\">it</span><span style=\"color: navy\">, </span><span style=\"color: maroon\">sec</span><span style=\"color: navy\">)</span> <i>"planText"</i><span style=\"color: navy\">;</span>\r\n <span style=\"color: navy\">}</span> <i>"planRule"</i><span style=\"color: navy\">;</span>\r\n <span style=\"color: navy\">}</span> <i>"composition"</i><span style=\"color: navy\">;</span>\r\n<span style=\"color: navy\">}\r\n\r\n</span><span style=\"color: navy\">// </span><span style=\"color: green\">─────────────────────────────────────────────────────────────────────────────</span>\r\n<span style=\"color: navy\">// </span><span style=\"color: green\">Shared note scaffolding. Repeated in each note map rather than imported: the</span>\r\n<span style=\"color: navy\">// </span><span style=\"color: green\">transform engine resolves `imports` against whatever StructureMaps happen to</span>\r\n<span style=\"color: navy\">// </span><span style=\"color: green\">be on the server, and a note that stops extracting because a shared map was</span>\r\n<span style=\"color: navy\">// </span><span style=\"color: green\">not uploaded is a worse failure than a duplicated group.</span>\r\n<span style=\"color: navy\">// </span><span style=\"color: green\">─────────────────────────────────────────────────────────────────────────────</span>\r\n<span style=\"color: navy\">// </span><span style=\"color: green\">Two notes on what the publisher's StructureMap validator says about this file.</span>\r\n<span style=\"color: navy\">// </span><span style=\"color: green\">Source parameters below are left untyped on purpose. Writing `: Element` makes</span>\r\n<span style=\"color: navy\">// </span><span style=\"color: green\">the validator compare QuestionnaireResponse.item against the literal 'Element'</span>\r\n<span style=\"color: navy\">// </span><span style=\"color: green\">and report them as incompatible with each other, which is noise, not a finding.</span>\r\n<span style=\"color: navy\">// </span><span style=\"color: green\">Untyped, it says only that it cannot check the paths.</span>\r\n<span style=\"color: navy\">// </span><span style=\"color: green\">`evaluate(context, expression)` is flagged as "takes 1 parameter but 2 were</span>\r\n<span style=\"color: navy\">// </span><span style=\"color: green\">found". Leave it. The FML parser in the same jar refuses the one-argument form</span>\r\n<span style=\"color: navy\">// </span><span style=\"color: green\">outright -- it wants a parameter, a comma, then the FHIRPath -- so the publisher</span>\r\n<span style=\"color: navy\">// </span><span style=\"color: green\">is objecting to what its own compiler emits. Two arguments is the only form that</span>\r\n<span style=\"color: navy\">// </span><span style=\"color: green\">compiles, and it is what the R5 transform engine executes.</span>\r\n<b>group </b>BuildNoteBase<span style=\"color: navy\">(</span><b>source</b> <span style=\"color: maroon\">qr</span><span style=\"color: navy\"> : </span>QR, <b>target</b> <span style=\"color: maroon\">comp</span><span style=\"color: navy\"> : </span>Composition, <b>target</b> <span style=\"color: maroon\">entry</span><span style=\"color: navy\">)</span><span style=\"color: navy\"> {\r\n</span> qr<span style=\"color: navy\"><b> -> </b></span>comp.id = <b>uuid</b><span style=\"color: navy\">(</span><span style=\"color: navy\">)</span><b> then </b>SetCompositionFullUrl<span style=\"color: navy\">(</span><span style=\"color: maroon\">comp</span><span style=\"color: navy\">, </span><span style=\"color: maroon\">entry</span><span style=\"color: navy\">)</span> <i>"idAndFullUrl"</i><span style=\"color: navy\">;</span>\r\n qr<span style=\"color: navy\"><b> -> </b></span>entry.request<b> as </b><span style=\"color: maroon\">request</span><b> then</b><span style=\"color: navy\"> {\r\n</span> qr<span style=\"color: navy\"><b> -> </b></span>request.method = <span style=\"color: blue\">'POST'</span> <i>"requestMethod"</i><span style=\"color: navy\">;</span>\r\n qr<span style=\"color: navy\"><b> -> </b></span>request.url = <span style=\"color: blue\">'Composition'</span> <i>"requestUrl"</i><span style=\"color: navy\">;</span>\r\n <span style=\"color: navy\">}</span> <i>"entryRequest"</i><span style=\"color: navy\">;</span>\r\n qr<span style=\"color: navy\"><b> -> </b></span>comp.status = <span style=\"color: blue\">'final'</span> <i>"status"</i><span style=\"color: navy\">;</span>\r\n qr.subject<b> as </b><span style=\"color: maroon\">s</span><span style=\"color: navy\"><b> -> </b></span>comp.subject = <span style=\"color: maroon\">s</span><span style=\"color: navy\">;</span>\r\n qr.encounter<b> as </b><span style=\"color: maroon\">e</span><span style=\"color: navy\"><b> -> </b></span>comp.encounter = <span style=\"color: maroon\">e</span><span style=\"color: navy\">;</span>\r\n <span style=\"color: navy\">// </span><span style=\"color: green\">Composition.date is 1..1. `authored` is only 0..1 on the response, so when a</span>\r\n <span style=\"color: navy\">// </span><span style=\"color: green\">client sends none the extraction time stands in. It is a poor substitute for</span>\r\n <span style=\"color: navy\">// </span><span style=\"color: green\">when the note was written, but a document with no date at all is worse, and</span>\r\n <span style=\"color: navy\">// </span><span style=\"color: green\">extraction happens moments after submission in practice.</span>\r\n qr.authored<b> as </b><span style=\"color: maroon\">t</span><span style=\"color: navy\"><b> -> </b></span>comp.date = <span style=\"color: maroon\">t</span> <i>"date"</i><span style=\"color: navy\">;</span>\r\n qr<b> where </b><span style=\"color: navy\">(</span>authored.exists().not()<span style=\"color: navy\">)</span><b> then</b><span style=\"color: navy\"> {\r\n</span> qr<span style=\"color: navy\"><b> -> </b></span>comp.date = evaluate<span style=\"color: navy\">(</span>qr<span style=\"color: navy\">, </span>now()<span style=\"color: navy\">)</span> <i>"dateFromExtractionTime"</i><span style=\"color: navy\">;</span>\r\n <span style=\"color: navy\">}</span> <i>"dateFallback"</i><span style=\"color: navy\">;</span>\r\n <span style=\"color: navy\">// </span><span style=\"color: green\">Composition.author is 1..1 minimum. R5 QuestionnaireResponse carries both</span>\r\n <span style=\"color: navy\">// </span><span style=\"color: green\">`author` (who recorded the answers) and `source` (who supplied them); the</span>\r\n <span style=\"color: navy\">// </span><span style=\"color: green\">author is the one who wrote the note, so it wins, and `source` only stands</span>\r\n <span style=\"color: navy\">// </span><span style=\"color: green\">in when the client did not send an author. If the response carries neither,</span>\r\n <span style=\"color: navy\">// </span><span style=\"color: green\">the note comes out unauthored -- there is nothing on a QuestionnaireResponse</span>\r\n <span style=\"color: navy\">// </span><span style=\"color: green\">to invent one from, and guessing at who wrote a clinical note is not a thing</span>\r\n <span style=\"color: navy\">// </span><span style=\"color: green\">a map should do.</span>\r\n qr.author<b> as </b><span style=\"color: maroon\">a</span><span style=\"color: navy\"><b> -> </b></span>comp.author = <span style=\"color: maroon\">a</span> <i>"authorFromAuthor"</i><span style=\"color: navy\">;</span>\r\n qr<b> where </b><span style=\"color: navy\">(</span>author.exists().not()<span style=\"color: navy\">)</span><b> then</b><span style=\"color: navy\"> {\r\n</span> qr.source<b> as </b><span style=\"color: maroon\">src</span><span style=\"color: navy\"><b> -> </b></span>comp.author = <span style=\"color: maroon\">src</span> <i>"authorFromSource"</i><span style=\"color: navy\">;</span>\r\n <span style=\"color: navy\">}</span> <i>"authorFallback"</i><span style=\"color: navy\">;</span>\r\n <span style=\"color: navy\">// </span><span style=\"color: green\">The note is derived from the response, not a copy of it. relatesTo is the</span>\r\n <span style=\"color: navy\">// </span><span style=\"color: green\">only element on R5 Composition that can say so.</span>\r\n qr<span style=\"color: navy\"><b> -> </b></span>comp.relatesTo<b> as </b><span style=\"color: maroon\">rel</span><b> then</b><span style=\"color: navy\"> {\r\n</span> qr<span style=\"color: navy\"><b> -> </b></span>rel.type = <span style=\"color: blue\">'derived-from'</span> <i>"relatesToType"</i><span style=\"color: navy\">;</span>\r\n qr<span style=\"color: navy\"><b> -> </b></span>rel.resourceReference = <b>create</b><span style=\"color: navy\">(</span><span style=\"color: blue\">'Reference'</span><span style=\"color: navy\">)</span><b> as </b><span style=\"color: maroon\">ref</span><b> then</b><span style=\"color: navy\"> {\r\n</span> <span style=\"color: navy\">// </span><span style=\"color: green\">`qr.id` already resolves to the type-qualified relative reference under</span>\r\n <span style=\"color: navy\">// </span><span style=\"color: green\">this engine, so it is used unprefixed.</span>\r\n qr.id<b> as </b><span style=\"color: maroon\">qid</span><span style=\"color: navy\"><b> -> </b></span>ref.reference = <span style=\"color: maroon\">qid</span> <i>"relatesToRef"</i><span style=\"color: navy\">;</span>\r\n <span style=\"color: navy\">}</span> <i>"relatesToTarget"</i><span style=\"color: navy\">;</span>\r\n <span style=\"color: navy\">}</span> <i>"linkQuestionnaireResponse"</i><span style=\"color: navy\">;</span>\r\n<span style=\"color: navy\">}\r\n\r\n</span><span style=\"color: navy\">// </span><span style=\"color: green\">The narrative half of a section. The title stays with the caller because a</span>\r\n<span style=\"color: navy\">// </span><span style=\"color: green\">group can only be invoked with variables, not string literals.</span>\r\n<span style=\"color: navy\">// </span><span style=\"color: green\">Two things here are deliberate. `create('xhtml')` rather than assigning the</span>\r\n<span style=\"color: navy\">// </span><span style=\"color: green\">string straight to `div`: the engine hard-casts whatever it is given to</span>\r\n<span style=\"color: navy\">// </span><span style=\"color: green\">XhtmlType, so a plain string fails with a ClassCastException. And</span>\r\n<span style=\"color: navy\">// </span><span style=\"color: green\">`escape('html')` on the answer: a nurse writing "sats < 92% & falling" would</span>\r\n<span style=\"color: navy\">// </span><span style=\"color: green\">otherwise produce a div the server refuses to parse.</span>\r\n<b>group </b>AddSectionText<span style=\"color: navy\">(</span><b>source</b> <span style=\"color: maroon\">it</span>, <b>target</b> <span style=\"color: maroon\">sec</span><span style=\"color: navy\">)</span><span style=\"color: navy\"> {\r\n</span> it.answer first<b> as </b><span style=\"color: maroon\">a</span><b> then</b><span style=\"color: navy\"> {\r\n</span> a.value<b> as </b><span style=\"color: maroon\">v</span><span style=\"color: navy\"><b> -> </b></span>sec.text<b> as </b><span style=\"color: maroon\">narrative</span><b> then</b><span style=\"color: navy\"> {\r\n</span> v<span style=\"color: navy\"><b> -> </b></span>narrative.status = <span style=\"color: blue\">'generated'</span> <i>"narrativeStatus"</i><span style=\"color: navy\">;</span>\r\n v<span style=\"color: navy\"><b> -> </b></span>narrative.div = <b>create</b><span style=\"color: navy\">(</span><span style=\"color: blue\">'xhtml'</span><span style=\"color: navy\">)</span><b> as </b><span style=\"color: maroon\">xhtml</span><b> then</b><span style=\"color: navy\"> {\r\n</span> v<span style=\"color: navy\"><b> -> </b></span>xhtml.value = evaluate<span style=\"color: navy\">(</span>a<span style=\"color: navy\">, </span>'<div xmlns="http://www.w3.org/1999/xhtml"><p>' + value.toString().escape('html') + '</p></div>'<span style=\"color: navy\">)</span> <i>"narrativeDiv"</i><span style=\"color: navy\">;</span>\r\n <span style=\"color: navy\">}</span> <i>"narrativeXhtml"</i><span style=\"color: navy\">;</span>\r\n <span style=\"color: navy\">}</span> <i>"sectionText"</i><span style=\"color: navy\">;</span>\r\n <span style=\"color: navy\">}</span> <i>"sectionAnswer"</i><span style=\"color: navy\">;</span>\r\n<span style=\"color: navy\">}\r\n\r\n</span><b>group </b>SetCompositionFullUrl<span style=\"color: navy\">(</span><b>source</b> <span style=\"color: maroon\">comp</span><span style=\"color: navy\"> : </span>Composition, <b>target</b> <span style=\"color: maroon\">entry</span><span style=\"color: navy\">)</span><span style=\"color: navy\"> {\r\n</span> comp.id<b> as </b><span style=\"color: maroon\">id</span><span style=\"color: navy\"><b> -> </b></span>entry.fullUrl = <b>append</b><span style=\"color: navy\">(</span><span style=\"color: blue\">'https://fhir.slade360.co.ke/fhir/Composition/'</span><span style=\"color: navy\">, </span><span style=\"color: maroon\">id</span><span style=\"color: navy\">)</span> <i>"assignFullUrl"</i><span style=\"color: navy\">;</span>\r\n<span style=\"color: navy\">}\r\n\r\n</span></pre></div>"
},
"url" : "https://fhir.slade360.co.ke/fhir/StructureMap/ExtractInpatientProgressNote",
"version" : "0.1.0",
"name" : "ExtractInpatientProgressNote",
"title" : "Inpatient Progress Note Extraction",
"status" : "active",
"date" : "2026-09-14T06:31:13+00:00",
"publisher" : "Kathurima Kimathi",
"contact" : [
{
"name" : "Kathurima Kimathi",
"telecom" : [
{
"system" : "url",
"value" : "https://www.linkedin.com/in/kathurima-kimathi/"
},
{
"system" : "email",
"value" : "kathurimakimathi415@gmail.com"
}
]
},
{
"name" : "Oscar John",
"telecom" : [
{
"system" : "email",
"value" : "oscarjohnotieno@gmail.com",
"use" : "work"
}
]
},
{
"name" : "Kennedy Omondi",
"telecom" : [
{
"system" : "email",
"value" : "kennankole@gmail.com",
"use" : "work"
}
]
}
],
"description" : "Turns a response to the inpatient progress note into a single Composition with one section per SOAP heading. Nothing here is a discrete clinical fact -- a progress note is a document -- so no Observation, Condition or Task is produced. The QuestionnaireResponse remains the signed record and the Composition points back at it through relatesTo.",
"structure" : [
{
"url" : "http://hl7.org/fhir/StructureDefinition/QuestionnaireResponse",
"mode" : "source",
"alias" : "QR"
},
{
"url" : "http://hl7.org/fhir/StructureDefinition/Bundle",
"mode" : "target",
"alias" : "Bundle"
},
{
"url" : "http://hl7.org/fhir/StructureDefinition/Composition",
"mode" : "target",
"alias" : "Composition"
}
],
"group" : [
{
"name" : "ExtractInpatientProgressNote",
"input" : [
{
"name" : "qr",
"type" : "QR",
"mode" : "source"
},
{
"name" : "bundle",
"type" : "Bundle",
"mode" : "target"
}
],
"rule" : [
{
"name" : "setBundleType",
"source" : [
{
"context" : "qr"
}
],
"target" : [
{
"context" : "bundle",
"element" : "type",
"transform" : "copy",
"parameter" : [
{
"valueString" : "transaction"
}
]
}
]
},
{
"name" : "composition",
"source" : [
{
"context" : "qr"
}
],
"target" : [
{
"context" : "bundle",
"element" : "entry",
"variable" : "entry"
},
{
"context" : "entry",
"element" : "resource",
"variable" : "comp",
"transform" : "create",
"parameter" : [
{
"valueString" : "Composition"
}
]
}
],
"rule" : [
{
"name" : "noteBase",
"source" : [
{
"context" : "qr"
}
],
"target" : [
{
"context" : "comp"
},
{
"context" : "entry"
}
],
"dependent" : [
{
"name" : "BuildNoteBase",
"parameter" : [
{
"valueId" : "qr"
},
{
"valueId" : "comp"
},
{
"valueId" : "entry"
}
]
}
]
},
{
"name" : "noteName",
"source" : [
{
"context" : "qr"
}
],
"target" : [
{
"context" : "comp",
"element" : "name",
"transform" : "copy",
"parameter" : [
{
"valueString" : "InpatientProgressNote"
}
]
}
]
},
{
"name" : "noteTitle",
"source" : [
{
"context" : "qr"
}
],
"target" : [
{
"context" : "comp",
"element" : "title",
"transform" : "copy",
"parameter" : [
{
"valueString" : "Progress note"
}
]
}
]
},
{
"name" : "noteType",
"source" : [
{
"context" : "qr"
}
],
"target" : [
{
"context" : "comp",
"element" : "type",
"variable" : "ty"
}
],
"rule" : [
{
"name" : "sghiCoding",
"source" : [
{
"context" : "qr"
}
],
"target" : [
{
"context" : "ty",
"element" : "coding",
"variable" : "sghi"
}
],
"rule" : [
{
"name" : "sghiSystem",
"source" : [
{
"context" : "qr"
}
],
"target" : [
{
"context" : "sghi",
"element" : "system",
"transform" : "copy",
"parameter" : [
{
"valueString" : "https://fhir.slade360.co.ke/fhir/CodeSystem/inpatient-document-type-codesystem"
}
]
}
]
},
{
"name" : "sghiCode",
"source" : [
{
"context" : "qr"
}
],
"target" : [
{
"context" : "sghi",
"element" : "code",
"transform" : "copy",
"parameter" : [
{
"valueString" : "progress-note"
}
]
}
]
},
{
"name" : "sghiDisplay",
"source" : [
{
"context" : "qr"
}
],
"target" : [
{
"context" : "sghi",
"element" : "display",
"transform" : "copy",
"parameter" : [
{
"valueString" : "Progress note"
}
]
}
]
}
]
},
{
"name" : "loincCoding",
"source" : [
{
"context" : "qr"
}
],
"target" : [
{
"context" : "ty",
"element" : "coding",
"variable" : "loinc"
}
],
"rule" : [
{
"name" : "loincSystem",
"source" : [
{
"context" : "qr"
}
],
"target" : [
{
"context" : "loinc",
"element" : "system",
"transform" : "copy",
"parameter" : [
{
"valueString" : "http://loinc.org"
}
]
}
]
},
{
"name" : "loincCode",
"source" : [
{
"context" : "qr"
}
],
"target" : [
{
"context" : "loinc",
"element" : "code",
"transform" : "copy",
"parameter" : [
{
"valueString" : "11506-3"
}
]
}
]
},
{
"name" : "loincDisplay",
"source" : [
{
"context" : "qr"
}
],
"target" : [
{
"context" : "loinc",
"element" : "display",
"transform" : "copy",
"parameter" : [
{
"valueString" : "Progress note"
}
]
}
]
}
]
},
{
"name" : "typeText",
"source" : [
{
"context" : "qr"
}
],
"target" : [
{
"context" : "ty",
"element" : "text",
"transform" : "copy",
"parameter" : [
{
"valueString" : "Progress note"
}
]
}
]
}
]
},
{
"name" : "subjectiveRule",
"source" : [
{
"context" : "qr",
"element" : "item",
"variable" : "it",
"condition" : "(linkId = 'subjective') and answer.value.exists()"
}
],
"target" : [
{
"context" : "comp",
"element" : "section",
"variable" : "sec"
}
],
"rule" : [
{
"name" : "subjectiveTitle",
"source" : [
{
"context" : "it"
}
],
"target" : [
{
"context" : "sec",
"element" : "title",
"transform" : "copy",
"parameter" : [
{
"valueString" : "Subjective"
}
]
}
]
},
{
"name" : "subjectiveText",
"source" : [
{
"context" : "it"
}
],
"target" : [
{
"context" : "sec"
}
],
"dependent" : [
{
"name" : "AddSectionText",
"parameter" : [
{
"valueId" : "it"
},
{
"valueId" : "sec"
}
]
}
]
}
],
"documentation" : "Sections in the order the form asks for them, so the printed note reads\r\nthe way it was written. The `answer.value.exists()` guard is not\r\ndecoration: a section with a title and no content breaks cmp-1, and an\r\nunanswered optional item still arrives as an empty item."
},
{
"name" : "objectiveRule",
"source" : [
{
"context" : "qr",
"element" : "item",
"variable" : "it",
"condition" : "(linkId = 'objective') and answer.value.exists()"
}
],
"target" : [
{
"context" : "comp",
"element" : "section",
"variable" : "sec"
}
],
"rule" : [
{
"name" : "objectiveTitle",
"source" : [
{
"context" : "it"
}
],
"target" : [
{
"context" : "sec",
"element" : "title",
"transform" : "copy",
"parameter" : [
{
"valueString" : "Objective"
}
]
}
]
},
{
"name" : "objectiveText",
"source" : [
{
"context" : "it"
}
],
"target" : [
{
"context" : "sec"
}
],
"dependent" : [
{
"name" : "AddSectionText",
"parameter" : [
{
"valueId" : "it"
},
{
"valueId" : "sec"
}
]
}
]
}
]
},
{
"name" : "assessmentRule",
"source" : [
{
"context" : "qr",
"element" : "item",
"variable" : "it",
"condition" : "(linkId = 'assessment') and answer.value.exists()"
}
],
"target" : [
{
"context" : "comp",
"element" : "section",
"variable" : "sec"
}
],
"rule" : [
{
"name" : "assessmentTitle",
"source" : [
{
"context" : "it"
}
],
"target" : [
{
"context" : "sec",
"element" : "title",
"transform" : "copy",
"parameter" : [
{
"valueString" : "Assessment"
}
]
}
]
},
{
"name" : "assessmentText",
"source" : [
{
"context" : "it"
}
],
"target" : [
{
"context" : "sec"
}
],
"dependent" : [
{
"name" : "AddSectionText",
"parameter" : [
{
"valueId" : "it"
},
{
"valueId" : "sec"
}
]
}
]
}
]
},
{
"name" : "planRule",
"source" : [
{
"context" : "qr",
"element" : "item",
"variable" : "it",
"condition" : "(linkId = 'plan') and answer.value.exists()"
}
],
"target" : [
{
"context" : "comp",
"element" : "section",
"variable" : "sec"
}
],
"rule" : [
{
"name" : "planTitle",
"source" : [
{
"context" : "it"
}
],
"target" : [
{
"context" : "sec",
"element" : "title",
"transform" : "copy",
"parameter" : [
{
"valueString" : "Plan"
}
]
}
]
},
{
"name" : "planText",
"source" : [
{
"context" : "it"
}
],
"target" : [
{
"context" : "sec"
}
],
"dependent" : [
{
"name" : "AddSectionText",
"parameter" : [
{
"valueId" : "it"
},
{
"valueId" : "sec"
}
]
}
]
}
]
}
]
}
]
},
{
"name" : "BuildNoteBase",
"documentation" : "─────────────────────────────────────────────────────────────────────────────\r\nShared note scaffolding. Repeated in each note map rather than imported: the\r\ntransform engine resolves `imports` against whatever StructureMaps happen to\r\nbe on the server, and a note that stops extracting because a shared map was\r\nnot uploaded is a worse failure than a duplicated group.\r\n─────────────────────────────────────────────────────────────────────────────\r\nTwo notes on what the publisher's StructureMap validator says about this file.\r\nSource parameters below are left untyped on purpose. Writing `: Element` makes\r\nthe validator compare QuestionnaireResponse.item against the literal 'Element'\r\nand report them as incompatible with each other, which is noise, not a finding.\r\nUntyped, it says only that it cannot check the paths.\r\n`evaluate(context, expression)` is flagged as \"takes 1 parameter but 2 were\r\nfound\". Leave it. The FML parser in the same jar refuses the one-argument form\r\noutright -- it wants a parameter, a comma, then the FHIRPath -- so the publisher\r\nis objecting to what its own compiler emits. Two arguments is the only form that\r\ncompiles, and it is what the R5 transform engine executes.",
"input" : [
{
"name" : "qr",
"type" : "QR",
"mode" : "source"
},
{
"name" : "comp",
"type" : "Composition",
"mode" : "target"
},
{
"name" : "entry",
"mode" : "target"
}
],
"rule" : [
{
"name" : "idAndFullUrl",
"source" : [
{
"context" : "qr"
}
],
"target" : [
{
"context" : "comp",
"element" : "id",
"transform" : "uuid"
}
],
"dependent" : [
{
"name" : "SetCompositionFullUrl",
"parameter" : [
{
"valueId" : "comp"
},
{
"valueId" : "entry"
}
]
}
]
},
{
"name" : "entryRequest",
"source" : [
{
"context" : "qr"
}
],
"target" : [
{
"context" : "entry",
"element" : "request",
"variable" : "request"
}
],
"rule" : [
{
"name" : "requestMethod",
"source" : [
{
"context" : "qr"
}
],
"target" : [
{
"context" : "request",
"element" : "method",
"transform" : "copy",
"parameter" : [
{
"valueString" : "POST"
}
]
}
]
},
{
"name" : "requestUrl",
"source" : [
{
"context" : "qr"
}
],
"target" : [
{
"context" : "request",
"element" : "url",
"transform" : "copy",
"parameter" : [
{
"valueString" : "Composition"
}
]
}
]
}
]
},
{
"name" : "status",
"source" : [
{
"context" : "qr"
}
],
"target" : [
{
"context" : "comp",
"element" : "status",
"transform" : "copy",
"parameter" : [
{
"valueString" : "final"
}
]
}
]
},
{
"name" : "subject",
"source" : [
{
"context" : "qr",
"element" : "subject",
"variable" : "s"
}
],
"target" : [
{
"context" : "comp",
"element" : "subject",
"transform" : "copy",
"parameter" : [
{
"valueId" : "s"
}
]
}
]
},
{
"name" : "encounter",
"source" : [
{
"context" : "qr",
"element" : "encounter",
"variable" : "e"
}
],
"target" : [
{
"context" : "comp",
"element" : "encounter",
"transform" : "copy",
"parameter" : [
{
"valueId" : "e"
}
]
}
]
},
{
"name" : "date",
"source" : [
{
"context" : "qr",
"element" : "authored",
"variable" : "t"
}
],
"target" : [
{
"context" : "comp",
"element" : "date",
"transform" : "copy",
"parameter" : [
{
"valueId" : "t"
}
]
}
],
"documentation" : "Composition.date is 1..1. `authored` is only 0..1 on the response, so when a\r\nclient sends none the extraction time stands in. It is a poor substitute for\r\nwhen the note was written, but a document with no date at all is worse, and\r\nextraction happens moments after submission in practice."
},
{
"name" : "dateFallback",
"source" : [
{
"context" : "qr",
"condition" : "authored.exists().not()"
}
],
"rule" : [
{
"name" : "dateFromExtractionTime",
"source" : [
{
"context" : "qr"
}
],
"target" : [
{
"context" : "comp",
"element" : "date",
"transform" : "evaluate",
"parameter" : [
{
"valueId" : "qr"
},
{
"valueString" : "now()"
}
]
}
]
}
]
},
{
"name" : "authorFromAuthor",
"source" : [
{
"context" : "qr",
"element" : "author",
"variable" : "a"
}
],
"target" : [
{
"context" : "comp",
"element" : "author",
"transform" : "copy",
"parameter" : [
{
"valueId" : "a"
}
]
}
],
"documentation" : "Composition.author is 1..1 minimum. R5 QuestionnaireResponse carries both\r\n`author` (who recorded the answers) and `source` (who supplied them); the\r\nauthor is the one who wrote the note, so it wins, and `source` only stands\r\nin when the client did not send an author. If the response carries neither,\r\nthe note comes out unauthored -- there is nothing on a QuestionnaireResponse\r\nto invent one from, and guessing at who wrote a clinical note is not a thing\r\na map should do."
},
{
"name" : "authorFallback",
"source" : [
{
"context" : "qr",
"condition" : "author.exists().not()"
}
],
"rule" : [
{
"name" : "authorFromSource",
"source" : [
{
"context" : "qr",
"element" : "source",
"variable" : "src"
}
],
"target" : [
{
"context" : "comp",
"element" : "author",
"transform" : "copy",
"parameter" : [
{
"valueId" : "src"
}
]
}
]
}
]
},
{
"name" : "linkQuestionnaireResponse",
"source" : [
{
"context" : "qr"
}
],
"target" : [
{
"context" : "comp",
"element" : "relatesTo",
"variable" : "rel"
}
],
"rule" : [
{
"name" : "relatesToType",
"source" : [
{
"context" : "qr"
}
],
"target" : [
{
"context" : "rel",
"element" : "type",
"transform" : "copy",
"parameter" : [
{
"valueString" : "derived-from"
}
]
}
]
},
{
"name" : "relatesToTarget",
"source" : [
{
"context" : "qr"
}
],
"target" : [
{
"context" : "rel",
"element" : "resourceReference",
"variable" : "ref",
"transform" : "create",
"parameter" : [
{
"valueString" : "Reference"
}
]
}
],
"rule" : [
{
"name" : "relatesToRef",
"source" : [
{
"context" : "qr",
"element" : "id",
"variable" : "qid"
}
],
"target" : [
{
"context" : "ref",
"element" : "reference",
"transform" : "copy",
"parameter" : [
{
"valueId" : "qid"
}
]
}
],
"documentation" : "`qr.id` already resolves to the type-qualified relative reference under\r\nthis engine, so it is used unprefixed."
}
]
}
],
"documentation" : "The note is derived from the response, not a copy of it. relatesTo is the\r\nonly element on R5 Composition that can say so."
}
]
},
{
"name" : "AddSectionText",
"documentation" : "The narrative half of a section. The title stays with the caller because a\r\ngroup can only be invoked with variables, not string literals.\r\nTwo things here are deliberate. `create('xhtml')` rather than assigning the\r\nstring straight to `div`: the engine hard-casts whatever it is given to\r\nXhtmlType, so a plain string fails with a ClassCastException. And\r\n`escape('html')` on the answer: a nurse writing \"sats < 92% & falling\" would\r\notherwise produce a div the server refuses to parse.",
"input" : [
{
"name" : "it",
"mode" : "source"
},
{
"name" : "sec",
"mode" : "target"
}
],
"rule" : [
{
"name" : "sectionAnswer",
"source" : [
{
"context" : "it",
"element" : "answer",
"listMode" : "first",
"variable" : "a"
}
],
"rule" : [
{
"name" : "sectionText",
"source" : [
{
"context" : "a",
"element" : "value",
"variable" : "v"
}
],
"target" : [
{
"context" : "sec",
"element" : "text",
"variable" : "narrative"
}
],
"rule" : [
{
"name" : "narrativeStatus",
"source" : [
{
"context" : "v"
}
],
"target" : [
{
"context" : "narrative",
"element" : "status",
"transform" : "copy",
"parameter" : [
{
"valueString" : "generated"
}
]
}
]
},
{
"name" : "narrativeXhtml",
"source" : [
{
"context" : "v"
}
],
"target" : [
{
"context" : "narrative",
"element" : "div",
"variable" : "xhtml",
"transform" : "create",
"parameter" : [
{
"valueString" : "xhtml"
}
]
}
],
"rule" : [
{
"name" : "narrativeDiv",
"source" : [
{
"context" : "v"
}
],
"target" : [
{
"context" : "xhtml",
"element" : "value",
"transform" : "evaluate",
"parameter" : [
{
"valueId" : "a"
},
{
"valueString" : "'<div xmlns=\"http://www.w3.org/1999/xhtml\"><p>' + value.toString().escape('html') + '</p></div>'"
}
]
}
]
}
]
}
]
}
]
}
]
},
{
"name" : "SetCompositionFullUrl",
"input" : [
{
"name" : "comp",
"type" : "Composition",
"mode" : "source"
},
{
"name" : "entry",
"mode" : "target"
}
],
"rule" : [
{
"name" : "assignFullUrl",
"source" : [
{
"context" : "comp",
"element" : "id",
"variable" : "id"
}
],
"target" : [
{
"context" : "entry",
"element" : "fullUrl",
"transform" : "append",
"parameter" : [
{
"valueString" : "https://fhir.slade360.co.ke/fhir/Composition/"
},
{
"valueId" : "id"
}
]
}
]
}
]
}
]
}