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