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="ExtractInpatientShiftHandoverNote"/>
<text>
<status value="generated"/>
<div xmlns="http://www.w3.org/1999/xhtml"><p class="res-header-id"><b>Generated Narrative: StructureMap ExtractInpatientShiftHandoverNote</b></p><a name="ExtractInpatientShiftHandoverNote"> </a><a name="hcExtractInpatientShiftHandoverNote"> </a><pre class="fml">
<span style="color: #cc00cc">/// <b>url</b> = </span><span style="color: blue">'https://fhir.slade360.co.ke/fhir/StructureMap/ExtractInpatientShiftHandoverNote'</span>
<span style="color: #cc00cc">/// <b>name</b> = </span><span style="color: blue">'ExtractInpatientShiftHandoverNote'</span>
<span style="color: #cc00cc">/// <b>title</b> = </span><span style="color: blue">'Inpatient Shift Handover 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 shift handover into a single Composition with one section per heading. The outstanding jobs stay narrative here rather than becoming Tasks: the handover form captures them as one free-text block for the incoming shift to read, and splitting one block into Tasks would invent boundaries the writer did not draw. Ward round jobs, which the design does treat as work items, become Tasks in their own map.'</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>ExtractInpatientShiftHandoverNote<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">'InpatientShiftHandoverNote'</span> <i>"noteName"</i><span style="color: navy">;</span>
qr<span style="color: navy"><b> -> </b></span>comp.title = <span style="color: blue">'Shift handover'</span> <i>"noteTitle"</i><span style="color: navy">;</span>
<span style="color: navy">// </span><span style="color: green">No LOINC document code. The four notes that have one carry it; the other</span>
<span style="color: navy">// </span><span style="color: green">eleven, this one included, have no LOINC concept that means the same</span>
<span style="color: navy">// </span><span style="color: green">thing, so the SGHI document type is the only coding.</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">'shift-handover-note'</span> <i>"sghiCode"</i><span style="color: navy">;</span>
qr<span style="color: navy"><b> -> </b></span>sghi.display = <span style="color: blue">'Shift handover'</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.text = <span style="color: blue">'Shift handover'</span> <i>"typeText"</i><span style="color: navy">;</span>
<span style="color: navy">}</span> <i>"noteType"</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 = 'situation') 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">'Situation'</span> <i>"situationTitle"</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>"situationText"</i><span style="color: navy">;</span>
<span style="color: navy">}</span> <i>"situationRule"</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 = 'watchFor') 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">'Watch for'</span> <i>"watchForTitle"</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>"watchForText"</i><span style="color: navy">;</span>
<span style="color: navy">}</span> <i>"watchForRule"</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 = 'outstanding') 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">'Outstanding jobs'</span> <i>"outstandingTitle"</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>"outstandingText"</i><span style="color: navy">;</span>
<span style="color: navy">}</span> <i>"outstandingRule"</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/ExtractInpatientShiftHandoverNote"/>
<version value="0.1.0"/>
<name value="ExtractInpatientShiftHandoverNote"/>
<title value="Inpatient Shift Handover 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 shift handover into a single Composition with one section per heading. The outstanding jobs stay narrative here rather than becoming Tasks: the handover form captures them as one free-text block for the incoming shift to read, and splitting one block into Tasks would invent boundaries the writer did not draw. Ward round jobs, which the design does treat as work items, become Tasks in their own map."/>
<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="ExtractInpatientShiftHandoverNote"/>
<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="InpatientShiftHandoverNote"/>
</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="Shift handover"/>
</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="shift-handover-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="Shift handover"/>
</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="Shift handover"/>
</parameter>
</target>
</rule>
<documentation
value="No LOINC document code. The four notes that have one carry it; the other
eleven, this one included, have no LOINC concept that means the same
thing, so the SGHI document type is the only coding."/>
</rule>
<rule>
<name value="situationRule"/>
<source>
<context value="qr"/>
<element value="item"/>
<variable value="it"/>
<condition
value="(linkId = 'situation') and answer.value.exists()"/>
</source>
<target>
<context value="comp"/>
<element value="section"/>
<variable value="sec"/>
</target>
<rule>
<name value="situationTitle"/>
<source>
<context value="it"/>
</source>
<target>
<context value="sec"/>
<element value="title"/>
<transform value="copy"/>
<parameter>
<valueString value="Situation"/>
</parameter>
</target>
</rule>
<rule>
<name value="situationText"/>
<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="watchForRule"/>
<source>
<context value="qr"/>
<element value="item"/>
<variable value="it"/>
<condition value="(linkId = 'watchFor') and answer.value.exists()"/>
</source>
<target>
<context value="comp"/>
<element value="section"/>
<variable value="sec"/>
</target>
<rule>
<name value="watchForTitle"/>
<source>
<context value="it"/>
</source>
<target>
<context value="sec"/>
<element value="title"/>
<transform value="copy"/>
<parameter>
<valueString value="Watch for"/>
</parameter>
</target>
</rule>
<rule>
<name value="watchForText"/>
<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="outstandingRule"/>
<source>
<context value="qr"/>
<element value="item"/>
<variable value="it"/>
<condition
value="(linkId = 'outstanding') and answer.value.exists()"/>
</source>
<target>
<context value="comp"/>
<element value="section"/>
<variable value="sec"/>
</target>
<rule>
<name value="outstandingTitle"/>
<source>
<context value="it"/>
</source>
<target>
<context value="sec"/>
<element value="title"/>
<transform value="copy"/>
<parameter>
<valueString value="Outstanding jobs"/>
</parameter>
</target>
</rule>
<rule>
<name value="outstandingText"/>
<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>