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="ExtractProcedureConsent"/>
<text>
<status value="generated"/>
<div xmlns="http://www.w3.org/1999/xhtml"><p class="res-header-id"><b>Generated Narrative: StructureMap ExtractProcedureConsent</b></p><a name="ExtractProcedureConsent"> </a><a name="hcExtractProcedureConsent"> </a><pre class="fml">
<span style="color: #cc00cc">/// <b>url</b> = </span><span style="color: blue">'https://fhir.slade360.co.ke/fhir/StructureMap/ExtractProcedureConsent'</span>
<span style="color: #cc00cc">/// <b>name</b> = </span><span style="color: blue">'ExtractProcedureConsent'</span>
<span style="color: #cc00cc">/// <b>title</b> = </span><span style="color: blue">'Procedure Consent 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">'The three consent forms out as one Consent, with a provision per authorisation actually given: the procedure itself, the further-measures clause, the anaesthesia clause, and on an endoscopy form the tissue-disposal clause and each procedure ticked. Each provision is written only when its box was answered yes, so a consent nobody gave never appears as one. An Observation records whether the explanation was given in a language the person consenting understood, because that is what makes the consent informed and what an audit or a complaint turns on.'</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/consent.html" title="Consent">http://hl7.org/fhir/StructureDefinition/Consent</a><span style="color: navy">" </span><b>alias </b>Consent <b>as </b><b>target</b>
<b>uses</b><span style="color: navy"> "</span><a href="http://hl7.org/fhir/R5/observation.html" title="Observation">http://hl7.org/fhir/StructureDefinition/Observation</a><span style="color: navy">" </span><b>alias </b>Observation <b>as </b><b>target</b>
<b>group </b>ExtractProcedureConsent<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>
<span style="color: navy">// </span><span style="color: green">── The Consent ─────────────────────────────────────────────────────────</span>
<span style="color: navy">// </span><span style="color: green">Guarded on the person consenting having actually signed. Everything below</span>
<span style="color: navy">// </span><span style="color: green">hangs off that signature, and a Consent built from a half-filled form</span>
<span style="color: navy">// </span><span style="color: green">asserts a permission that was never given.</span>
qr<b> where </b><span style="color: navy">(</span>item.where(linkId = 'signatures').item.where(linkId = 'signatures/consenter-signed').answer.value = true<span style="color: navy">)</span><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">'Consent'</span><span style="color: navy">)</span><b> as </b><span style="color: maroon">consent</span><b> then</b><span style="color: navy"> {
</span> qr<span style="color: navy"><b> -> </b></span> consent<span style="color: navy">, </span> entry<b> then </b>BuildConsentBase<span style="color: navy">(</span><span style="color: maroon">qr</span><span style="color: navy">, </span><span style="color: maroon">consent</span><span style="color: navy">, </span><span style="color: maroon">entry</span><span style="color: navy">)</span> <i>"base"</i><span style="color: navy">;</span>
qr<span style="color: navy"><b> -> </b></span>consent.status = <span style="color: blue">'active'</span> <i>"status"</i><span style="color: navy">;</span>
qr<span style="color: navy"><b> -> </b></span>consent.decision = <span style="color: blue">'permit'</span> <i>"decision"</i><span style="color: navy">;</span>
qr<span style="color: navy"><b> -> </b></span>consent.category<b> as </b><span style="color: maroon">cat</span><b> then</b><span style="color: navy"> {
</span> qr<span style="color: navy"><b> -> </b></span>cat.coding<b> as </b><span style="color: maroon">cg</span><b> then</b><span style="color: navy"> {
</span> qr<span style="color: navy"><b> -> </b></span>cg.system = <span style="color: blue">'http://loinc.org'</span> <i>"sys"</i><span style="color: navy">;</span>
qr<span style="color: navy"><b> -> </b></span>cg.code = <span style="color: blue">'64293-4'</span> <i>"cd"</i><span style="color: navy">;</span>
qr<span style="color: navy"><b> -> </b></span>cg.display = <span style="color: blue">'Procedure consent Document'</span> <i>"dsp"</i><span style="color: navy">;</span>
<span style="color: navy">}</span> <i>"coding"</i><span style="color: navy">;</span>
<span style="color: navy">}</span> <i>"category"</i><span style="color: navy">;</span>
<span style="color: navy">// </span><span style="color: green">The signing time, from the form. Not qr.authored: a consent taken the</span>
<span style="color: navy">// </span><span style="color: green">evening before an operation and transcribed the next morning would</span>
<span style="color: navy">// </span><span style="color: green">otherwise be dated to the transcription, which is the one date a dispute</span>
<span style="color: navy">// </span><span style="color: green">about consent turns on.</span>
qr.item<b> as </b><span style="color: maroon">sg</span><b> where </b><span style="color: navy">(</span>linkId = 'signatures'<span style="color: navy">)</span><b> then</b><span style="color: navy"> {
</span> sg.item<b> as </b><span style="color: maroon">it</span><b> where </b><span style="color: navy">(</span>(linkId = 'signatures/consenter-signed-at') and answer.value.exists()<span style="color: navy">)</span><b> then</b><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> <span style="color: navy">// </span><span style="color: green">The form asks for a date *and time* signed, and Consent.date is a</span>
<span style="color: navy">// </span><span style="color: green">`date`. The timestamp goes to Consent.period.start, which keeps it:</span>
<span style="color: navy">// </span><span style="color: green">a consent taken the evening before theatre and one taken in the</span>
<span style="color: navy">// </span><span style="color: green">anaesthetic room are hours apart and share a date.</span>
a.value<b> as </b><span style="color: maroon">t</span><span style="color: navy"><b> -> </b></span> consent.period<b> as </b><span style="color: maroon">per</span><span style="color: navy">, </span> per.start = <span style="color: maroon">t</span> <i>"signedPeriodStart"</i><span style="color: navy">;</span>
<span style="color: navy">}</span><span style="color: navy">;</span>
<span style="color: navy">}</span> <i>"signedAtRule"</i><span style="color: navy">;</span>
<span style="color: navy">}</span> <i>"signaturesGroup"</i><span style="color: navy">;</span>
<span style="color: navy">// </span><span style="color: green">Who explained it becomes the verifier -- they attested that the</span>
<span style="color: navy">// </span><span style="color: green">discussion happened -- and who consented becomes the grantor.</span>
qr.item<b> as </b><span style="color: maroon">eg</span><b> where </b><span style="color: navy">(</span>linkId = 'explained-by'<span style="color: navy">)</span><b> then</b><span style="color: navy"> {
</span> eg.item<b> as </b><span style="color: maroon">it</span><b> where </b><span style="color: navy">(</span>(linkId = 'explained-by/clinician') and answer.value.exists()<span style="color: navy">)</span><b> then</b><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">ref</span><span style="color: navy"><b> -> </b></span>consent.verification<b> as </b><span style="color: maroon">ver</span><b> then</b><span style="color: navy"> {
</span> ref<span style="color: navy"><b> -> </b></span>ver.verified = <span style="color: blue">true</span> <i>"verified"</i><span style="color: navy">;</span>
ref<span style="color: navy"><b> -> </b></span>ver.verifiedBy = <span style="color: maroon">ref</span> <i>"verifiedBy"</i><span style="color: navy">;</span>
<span style="color: navy">}</span> <i>"verification"</i><span style="color: navy">;</span>
<span style="color: navy">}</span><span style="color: navy">;</span>
<span style="color: navy">}</span> <i>"clinicianRule"</i><span style="color: navy">;</span>
eg.item<b> as </b><span style="color: maroon">it</span><b> where </b><span style="color: navy">(</span>(linkId = 'explained-by/what-was-explained') and answer.value.exists()<span style="color: navy">)</span><b> then</b><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">txt</span><span style="color: navy"><b> -> </b></span> consent.provision<b> as </b><span style="color: maroon">prov</span><span style="color: navy">, </span> prov.code<b> as </b><span style="color: maroon">pc</span><span style="color: navy">, </span> pc.text = <span style="color: maroon">txt</span> <i>"explanationProvision"</i><span style="color: navy">;</span>
<span style="color: navy">}</span><span style="color: navy">;</span>
<span style="color: navy">}</span> <i>"explanationRule"</i><span style="color: navy">;</span>
<span style="color: navy">}</span> <i>"explainedByGroup"</i><span style="color: navy">;</span>
qr.item<b> as </b><span style="color: maroon">cg2</span><b> where </b><span style="color: navy">(</span>linkId = 'consenter'<span style="color: navy">)</span><b> then</b><span style="color: navy"> {
</span> cg2.item<b> as </b><span style="color: maroon">it</span><b> where </b><span style="color: navy">(</span>(linkId = 'consenter/name') and answer.value.exists()<span style="color: navy">)</span><b> then</b><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">txt</span><span style="color: navy"><b> -> </b></span> consent.grantor = <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><span style="color: navy">, </span> ref.display = <span style="color: maroon">txt</span> <i>"grantorDisplay"</i><span style="color: navy">;</span>
<span style="color: navy">}</span><span style="color: navy">;</span>
<span style="color: navy">}</span> <i>"consenterNameRule"</i><span style="color: navy">;</span>
cg2.item<b> as </b><span style="color: maroon">it</span><b> where </b><span style="color: navy">(</span>(linkId = 'consenter/relationship') and answer.value.exists()<span style="color: navy">)</span><b> then</b><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">txt</span><span style="color: navy"><b> -> </b></span> consent.grantor = <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><span style="color: navy">, </span> ref.display = <span style="color: maroon">txt</span> <i>"relationshipDisplay"</i><span style="color: navy">;</span>
<span style="color: navy">}</span><span style="color: navy">;</span>
<span style="color: navy">}</span> <i>"relationshipRule"</i><span style="color: navy">;</span>
<span style="color: navy">}</span> <i>"consenterGroup"</i><span style="color: navy">;</span>
<span style="color: navy">// </span><span style="color: green">── The provisions ────────────────────────────────────────────────────</span>
<span style="color: navy">// </span><span style="color: green">One per authorisation. The procedure itself is always a provision, since</span>
<span style="color: navy">// </span><span style="color: green">it is what the form exists for; the rest appear only where their own box</span>
<span style="color: navy">// </span><span style="color: green">was answered yes.</span>
qr.item<b> as </b><span style="color: maroon">g</span><b> where </b><span style="color: navy">(</span>linkId = 'consent-for'<span style="color: navy">)</span><b> then</b><span style="color: navy"> {
</span> g.item<b> as </b><span style="color: maroon">it</span><b> where </b><span style="color: navy">(</span>(linkId = 'consent-for/procedure') and answer.value.exists()<span style="color: navy">)</span><span style="color: navy"><b> -> </b></span>consent.provision<b> as </b><span style="color: maroon">prov</span><b> then</b><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">txt</span><span style="color: navy"><b> -> </b></span> prov.code<b> as </b><span style="color: maroon">pc</span><span style="color: navy">, </span> pc.text = <span style="color: maroon">txt</span> <i>"procedureText"</i><span style="color: navy">;</span>
<span style="color: navy">}</span><span style="color: navy">;</span>
<span style="color: navy">}</span> <i>"procedureProvision"</i><span style="color: navy">;</span>
g.item<b> as </b><span style="color: maroon">it</span><b> where </b><span style="color: navy">(</span>(linkId = 'consent-for/planned-for') and answer.value.exists()<span style="color: navy">)</span><b> then</b><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">d</span><span style="color: navy"><b> -> </b></span> consent.period<b> as </b><span style="color: maroon">per</span><span style="color: navy">, </span> per.start = <b>cast</b><span style="color: navy">(</span><span style="color: maroon">d</span><span style="color: navy">, </span><span style="color: blue">'dateTime'</span><span style="color: navy">)</span> <i>"plannedPeriodStart"</i><span style="color: navy">;</span>
<span style="color: navy">}</span><span style="color: navy">;</span>
<span style="color: navy">}</span> <i>"plannedForRule"</i><span style="color: navy">;</span>
<span style="color: navy">}</span> <i>"consentForGroup"</i><span style="color: navy">;</span>
qr.item<b> as </b><span style="color: maroon">g</span><b> where </b><span style="color: navy">(</span>linkId = 'additional-authorisations'<span style="color: navy">)</span><b> then</b><span style="color: navy"> {
</span> g.item<b> as </b><span style="color: maroon">it</span><b> where </b><span style="color: navy">(</span>(linkId = 'additional-authorisations/further-measures') and (answer.value.ofType(Coding).code = 'Y')<span style="color: navy">)</span><span style="color: navy"><b> -> </b></span>consent.provision<b> as </b><span style="color: maroon">prov</span><b> then</b><span style="color: navy"> {
</span> it<span style="color: navy"><b> -> </b></span> prov.code<b> as </b><span style="color: maroon">pc</span><span style="color: navy">, </span> pc.text = <span style="color: blue">'Further alternative operative measures or treatment found necessary during the procedure'</span> <i>"furtherMeasuresText"</i><span style="color: navy">;</span>
<span style="color: navy">}</span> <i>"furtherMeasuresProvision"</i><span style="color: navy">;</span>
g.item<b> as </b><span style="color: maroon">it</span><b> where </b><span style="color: navy">(</span>(linkId = 'additional-authorisations/anaesthesia') and (answer.value.ofType(Coding).code = 'Y')<span style="color: navy">)</span><span style="color: navy"><b> -> </b></span>consent.provision<b> as </b><span style="color: maroon">prov</span><b> then</b><span style="color: navy"> {
</span> it<span style="color: navy"><b> -> </b></span> prov.code<b> as </b><span style="color: maroon">pc</span><span style="color: navy">, </span> pc.text = <span style="color: blue">'Administration of general or other anaesthesia'</span> <i>"anaesthesiaText"</i><span style="color: navy">;</span>
<span style="color: navy">}</span> <i>"anaesthesiaProvision"</i><span style="color: navy">;</span>
g.item<b> as </b><span style="color: maroon">it</span><b> where </b><span style="color: navy">(</span>(linkId = 'additional-authorisations/no-named-practitioner') and (answer.value.ofType(Coding).code = 'Y')<span style="color: navy">)</span><b> then</b><span style="color: navy"> {
</span> it<span style="color: navy"><b> -> </b></span> consent.provision<b> as </b><span style="color: maroon">prov</span><span style="color: navy">, </span> prov.code<b> as </b><span style="color: maroon">pc</span><span style="color: navy">, </span> pc.text = <span style="color: blue">'The person consenting understands no assurance has been given that a particular practitioner will perform the procedure.'</span> <i>"noNamedPractitionerNote"</i><span style="color: navy">;</span>
<span style="color: navy">}</span> <i>"noNamedPractitionerRule"</i><span style="color: navy">;</span>
<span style="color: navy">}</span> <i>"additionalAuthorisationsGroup"</i><span style="color: navy">;</span>
<span style="color: navy">// </span><span style="color: green">Endoscopy: one provision per procedure ticked, so a consent for an upper</span>
<span style="color: navy">// </span><span style="color: green">GI endoscopy alone cannot be read as covering a colonoscopy.</span>
qr.item<b> as </b><span style="color: maroon">it</span><b> where </b><span style="color: navy">(</span>linkId = 'endoscopy-procedures'<span style="color: navy">)</span><b> then</b><span style="color: navy"> {
</span> it.answer<b> as </b><span style="color: maroon">a</span><span style="color: navy"><b> -> </b></span>consent.provision<b> as </b><span style="color: maroon">prov</span><b> then</b><span style="color: navy"> {
</span> a.value<b> as </b><span style="color: maroon">cv</span><span style="color: navy"><b> -> </b></span>prov.code<b> as </b><span style="color: maroon">pc</span><b> then</b><span style="color: navy"> {
</span> cv<span style="color: navy"><b> -> </b></span>pc.coding = <span style="color: maroon">cv</span> <i>"coding"</i><span style="color: navy">;</span>
cv.display<b> as </b><span style="color: maroon">d</span><span style="color: navy"><b> -> </b></span>pc.text = <span style="color: maroon">d</span> <i>"text"</i><span style="color: navy">;</span>
<span style="color: navy">}</span> <i>"endoscopyCode"</i><span style="color: navy">;</span>
<span style="color: navy">}</span> <i>"endoscopyProvision"</i><span style="color: navy">;</span>
<span style="color: navy">}</span> <i>"endoscopyProceduresGroup"</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 = 'endoscopy-tissue-disposal') and (answer.value.ofType(Coding).code = 'Y')<span style="color: navy">)</span><span style="color: navy"><b> -> </b></span>consent.provision<b> as </b><span style="color: maroon">prov</span><b> then</b><span style="color: navy"> {
</span> it<span style="color: navy"><b> -> </b></span> prov.code<b> as </b><span style="color: maroon">pc</span><span style="color: navy">, </span> pc.text = <span style="color: blue">'Examination, preservation or disposal of tissues and body fluids removed, and of X-ray or photographic records taken'</span> <i>"tissueDisposalText"</i><span style="color: navy">;</span>
<span style="color: navy">}</span> <i>"tissueDisposalProvision"</i><span style="color: navy">;</span>
<span style="color: navy">// </span><span style="color: green">Systemic anti-cancer therapy: the regimen is the provision, and the</span>
<span style="color: navy">// </span><span style="color: green">purpose and side effects explained are notes on the consent -- they are</span>
<span style="color: navy">// </span><span style="color: green">what was said, not what was permitted.</span>
qr.item<b> as </b><span style="color: maroon">g</span><b> where </b><span style="color: navy">(</span>linkId = 'anti-cancer-therapy'<span style="color: navy">)</span><b> then</b><span style="color: navy"> {
</span> g.item<b> as </b><span style="color: maroon">it</span><b> where </b><span style="color: navy">(</span>(linkId = 'anti-cancer-therapy/regimen') and answer.value.exists()<span style="color: navy">)</span><span style="color: navy"><b> -> </b></span>consent.provision<b> as </b><span style="color: maroon">prov</span><b> then</b><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">txt</span><span style="color: navy"><b> -> </b></span> prov.code<b> as </b><span style="color: maroon">pc</span><span style="color: navy">, </span> pc.text = <span style="color: maroon">txt</span> <i>"regimenText"</i><span style="color: navy">;</span>
<span style="color: navy">}</span><span style="color: navy">;</span>
<span style="color: navy">}</span> <i>"regimenProvision"</i><span style="color: navy">;</span>
g.item<b> as </b><span style="color: maroon">it</span><b> where </b><span style="color: navy">(</span>(linkId = 'anti-cancer-therapy/intended-purpose') and answer.value.exists()<span style="color: navy">)</span><b> then</b><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">txt</span><span style="color: navy"><b> -> </b></span> consent.provision<b> as </b><span style="color: maroon">prov</span><span style="color: navy">, </span> prov.code<b> as </b><span style="color: maroon">pc</span><span style="color: navy">, </span> pc.text = <span style="color: maroon">txt</span> <i>"purposeProvision"</i><span style="color: navy">;</span>
<span style="color: navy">}</span><span style="color: navy">;</span>
<span style="color: navy">}</span> <i>"purposeRule"</i><span style="color: navy">;</span>
g.item<b> as </b><span style="color: maroon">it</span><b> where </b><span style="color: navy">(</span>(linkId = 'anti-cancer-therapy/side-effects-and-risks') and answer.value.exists()<span style="color: navy">)</span><b> then</b><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">txt</span><span style="color: navy"><b> -> </b></span> consent.provision<b> as </b><span style="color: maroon">prov</span><span style="color: navy">, </span> prov.code<b> as </b><span style="color: maroon">pc</span><span style="color: navy">, </span> pc.text = <span style="color: maroon">txt</span> <i>"sideEffectsProvision"</i><span style="color: navy">;</span>
<span style="color: navy">}</span><span style="color: navy">;</span>
<span style="color: navy">}</span> <i>"sideEffectsRule"</i><span style="color: navy">;</span>
<span style="color: navy">}</span> <i>"antiCancerGroup"</i><span style="color: navy">;</span>
<span style="color: navy">}</span> <i>"createConsent"</i><span style="color: navy">;</span>
<span style="color: navy">// </span><span style="color: green">── Was it explained in a language they understood? ─────────────────────</span>
<span style="color: navy">// </span><span style="color: green">Its own Observation. It is not a permission, so it is not a provision; but</span>
<span style="color: navy">// </span><span style="color: green">it is the fact that makes the consent informed, and a complaint or an</span>
<span style="color: navy">// </span><span style="color: green">inquest turns on it. An interpreter's name, where one was used, rides</span>
<span style="color: navy">// </span><span style="color: green">alongside as a note.</span>
qr.item<b> as </b><span style="color: maroon">g</span><b> where </b><span style="color: navy">(</span>linkId = 'explained-by'<span style="color: navy">)</span><b> then</b><span style="color: navy"> {
</span> g.item<b> as </b><span style="color: maroon">it</span><b> where </b><span style="color: navy">(</span>(linkId = 'explained-by/language-understood') and answer.value.exists()<span style="color: navy">)</span><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">'Observation'</span><span style="color: navy">)</span><b> as </b><span style="color: maroon">obs</span><b> then</b><span style="color: navy"> {
</span> qr<span style="color: navy"><b> -> </b></span> obs<span style="color: navy">, </span> entry<b> then </b>BuildObsBase<span style="color: navy">(</span><span style="color: maroon">qr</span><span style="color: navy">, </span><span style="color: maroon">obs</span><span style="color: navy">, </span><span style="color: maroon">entry</span><span style="color: navy">)</span> <i>"base"</i><span style="color: navy">;</span>
qr<span style="color: navy"><b> -> </b></span>obs<b> then </b>SetSurveyCategory<span style="color: navy">(</span><span style="color: maroon">qr</span><span style="color: navy">, </span><span style="color: maroon">obs</span><span style="color: navy">)</span> <i>"category"</i><span style="color: navy">;</span>
it<span style="color: navy"><b> -> </b></span>obs.code<b> as </b><span style="color: maroon">cc</span><b> then</b><span style="color: navy"> {
</span> it<span style="color: navy"><b> -> </b></span>cc.coding<b> as </b><span style="color: maroon">cg</span><b> then</b><span style="color: navy"> {
</span> it<span style="color: navy"><b> -> </b></span>cg.system = <span style="color: blue">'https://fhir.slade360.co.ke/fhir/CodeSystem/inpatient-clinical-concept-codesystem'</span> <i>"sys"</i><span style="color: navy">;</span>
it<span style="color: navy"><b> -> </b></span>cg.code = <span style="color: blue">'capacity-to-consent'</span> <i>"cd"</i><span style="color: navy">;</span>
it<span style="color: navy"><b> -> </b></span>cg.display = <span style="color: blue">'Capacity to consent'</span> <i>"dsp"</i><span style="color: navy">;</span>
<span style="color: navy">}</span> <i>"coding"</i><span style="color: navy">;</span>
it<span style="color: navy"><b> -> </b></span>cc.text = <span style="color: blue">'Explained in a language the person consenting fully understands'</span> <i>"codeText"</i><span style="color: navy">;</span>
<span style="color: navy">}</span> <i>"code"</i><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">cv</span><span style="color: navy"><b> -> </b></span>obs.value = <b>create</b><span style="color: navy">(</span><span style="color: blue">'CodeableConcept'</span><span style="color: navy">)</span><b> as </b><span style="color: maroon">vc</span><b> then</b><span style="color: navy"> {
</span> cv<span style="color: navy"><b> -> </b></span>vc.coding = <span style="color: maroon">cv</span> <i>"valueCoding"</i><span style="color: navy">;</span>
cv.display<b> as </b><span style="color: maroon">d</span><span style="color: navy"><b> -> </b></span>vc.text = <span style="color: maroon">d</span> <i>"valueText"</i><span style="color: navy">;</span>
<span style="color: navy">}</span> <i>"codedValue"</i><span style="color: navy">;</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">cv</span><b> where </b><span style="color: navy">(</span>code = 'N'<span style="color: navy">)</span><span style="color: navy"><b> -> </b></span>obs.interpretation<b> as </b><span style="color: maroon">interp</span><b> then</b><span style="color: navy"> {
</span> cv<span style="color: navy"><b> -> </b></span>interp.coding<b> as </b><span style="color: maroon">icg</span><b> then</b><span style="color: navy"> {
</span> cv<span style="color: navy"><b> -> </b></span>icg.system = <span style="color: blue">'http://terminology.hl7.org/CodeSystem/v3-ObservationInterpretation'</span> <i>"sys"</i><span style="color: navy">;</span>
cv<span style="color: navy"><b> -> </b></span>icg.code = <span style="color: blue">'A'</span> <i>"cd"</i><span style="color: navy">;</span>
cv<span style="color: navy"><b> -> </b></span>icg.display = <span style="color: blue">'Abnormal'</span> <i>"dsp"</i><span style="color: navy">;</span>
<span style="color: navy">}</span> <i>"coding"</i><span style="color: navy">;</span>
<span style="color: navy">}</span> <i>"notUnderstoodInterp"</i><span style="color: navy">;</span>
<span style="color: navy">}</span> <i>"languageInterpretation"</i><span style="color: navy">;</span>
g.item<b> as </b><span style="color: maroon">ip</span><b> where </b><span style="color: navy">(</span>(linkId = 'explained-by/interpreter-name') and answer.value.exists()<span style="color: navy">)</span><b> then</b><span style="color: navy"> {
</span> ip.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">txt</span><span style="color: navy"><b> -> </b></span> obs.note<b> as </b><span style="color: maroon">n</span><span style="color: navy">, </span> n.text = <span style="color: maroon">txt</span> <i>"interpreterNote"</i><span style="color: navy">;</span>
<span style="color: navy">}</span><span style="color: navy">;</span>
<span style="color: navy">}</span> <i>"interpreterRule"</i><span style="color: navy">;</span>
<span style="color: navy">}</span> <i>"languageObservation"</i><span style="color: navy">;</span>
<span style="color: navy">}</span> <i>"languageGroup"</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 scaffolding. Repeated in each map rather than imported: the transform</span>
<span style="color: navy">// </span><span style="color: green">engine resolves `imports` against whatever StructureMaps happen to be on the</span>
<span style="color: navy">// </span><span style="color: green">server, and a form that stops extracting because a shared map was not</span>
<span style="color: navy">// </span><span style="color: green">uploaded is a worse failure than a duplicated group.</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">`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</span>
<span style="color: navy">// </span><span style="color: green">publisher is objecting to what its own compiler emits. Two arguments is the</span>
<span style="color: navy">// </span><span style="color: green">only form that compiles, and it is what the R5 transform engine executes.</span>
<span style="color: navy">// </span><span style="color: green">─────────────────────────────────────────────────────────────────────────────</span>
<b>group </b>BuildObsBase<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">obs</span><span style="color: navy"> : </span>Observation, <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>obs<b> then </b>SetResponseProvenance<span style="color: navy">(</span><span style="color: maroon">qr</span><span style="color: navy">, </span><span style="color: maroon">obs</span><span style="color: navy">)</span> <i>"responseProvenance"</i><span style="color: navy">;</span>
qr<span style="color: navy"><b> -> </b></span>obs.id = <b>uuid</b><span style="color: navy">(</span><span style="color: navy">)</span><b> then </b>SetObservationFullUrl<span style="color: navy">(</span><span style="color: maroon">obs</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">'Observation'</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>obs.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>obs.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>obs.encounter = <span style="color: maroon">e</span><span style="color: navy">;</span>
qr.authored<b> as </b><span style="color: maroon">t</span><span style="color: navy"><b> -> </b></span>obs.effective = <span style="color: maroon">t</span> <i>"effective"</i><span style="color: navy">;</span>
qr.source<b> as </b><span style="color: maroon">src</span><span style="color: navy"><b> -> </b></span>obs.performer = <span style="color: maroon">src</span> <i>"performerFromSource"</i><span style="color: navy">;</span>
qr<b> where </b><span style="color: navy">(</span>source.exists().not()<span style="color: navy">)</span><b> then</b><span style="color: navy"> {
</span> qr.author<b> as </b><span style="color: maroon">a</span><span style="color: navy"><b> -> </b></span>obs.performer = <span style="color: maroon">a</span> <i>"performerFromAuthor"</i><span style="color: navy">;</span>
<span style="color: navy">}</span> <i>"performerFallback"</i><span style="color: navy">;</span>
<span style="color: navy">// </span><span style="color: green">A stored response's id already reads "QuestionnaireResponse/<id>", so it is</span>
<span style="color: navy">// </span><span style="color: green">a relative reference as it stands. The hasValue() guard is what stops an</span>
<span style="color: navy">// </span><span style="color: green">unsaved response -- one posted straight to $extract rather than saved first</span>
<span style="color: navy">// </span><span style="color: green">-- from writing "QuestionnaireResponse/null" into the record.</span>
qr.id<b> as </b><span style="color: maroon">qid</span><b> where </b><span style="color: navy">(</span>$this.hasValue()<span style="color: navy">)</span><span style="color: navy"><b> -> </b></span> obs.derivedFrom = <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><span style="color: navy">, </span> ref.reference = <span style="color: maroon">qid</span> <i>"linkQuestionnaireResponse"</i><span style="color: navy">;</span>
<span style="color: navy">}
</span><b>group </b>SetObservationFullUrl<span style="color: navy">(</span><b>source</b> <span style="color: maroon">obs</span><span style="color: navy"> : </span>Observation, <b>target</b> <span style="color: maroon">entry</span><span style="color: navy">)</span><span style="color: navy"> {
</span> obs.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/Observation/'</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><span style="color: navy">// </span><span style="color: green">The two answer shapes a component can carry. Both read the answer through the</span>
<span style="color: navy">// </span><span style="color: green">untyped `.value` accessor: reading `valueCoding` or `valueQuantity` by its</span>
<span style="color: navy">// </span><span style="color: green">typed property name fails at transform time on HAPI R5 with "Attempt to read</span>
<span style="color: navy">// </span><span style="color: green">invalid property ... on QuestionnaireResponse.item.answer".</span>
<b>group </b>SetComponentCodedValue<span style="color: navy">(</span><b>source</b> <span style="color: maroon">it</span>, <b>target</b> <span style="color: maroon">comp</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">cv</span><span style="color: navy"><b> -> </b></span>comp.value = <b>create</b><span style="color: navy">(</span><span style="color: blue">'CodeableConcept'</span><span style="color: navy">)</span><b> as </b><span style="color: maroon">cc</span><b> then</b><span style="color: navy"> {
</span> cv<span style="color: navy"><b> -> </b></span>cc.coding = <span style="color: maroon">cv</span> <i>"valueCoding"</i><span style="color: navy">;</span>
cv.display<b> as </b><span style="color: maroon">d</span><span style="color: navy"><b> -> </b></span>cc.text = <span style="color: maroon">d</span> <i>"valueText"</i><span style="color: navy">;</span>
<span style="color: navy">}</span> <i>"codedValue"</i><span style="color: navy">;</span>
<span style="color: navy">}</span> <i>"componentAnswer"</i><span style="color: navy">;</span>
<span style="color: navy">}
</span><b>group </b>SetComponentValue<span style="color: navy">(</span><b>source</b> <span style="color: maroon">it</span>, <b>target</b> <span style="color: maroon">comp</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>comp.value = <span style="color: maroon">v</span> <i>"plainValue"</i><span style="color: navy">;</span>
<span style="color: navy">}</span> <i>"componentAnswer"</i><span style="color: navy">;</span>
<span style="color: navy">}
</span><b>group </b>SetSurveyCategory<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">obs</span><span style="color: navy"> : </span>Observation<span style="color: navy">)</span><span style="color: navy"> {
</span> qr<span style="color: navy"><b> -> </b></span>obs.category<b> as </b><span style="color: maroon">cat</span><b> then</b><span style="color: navy"> {
</span> qr<span style="color: navy"><b> -> </b></span>cat.coding<b> as </b><span style="color: maroon">coding</span><b> then</b><span style="color: navy"> {
</span> qr<span style="color: navy"><b> -> </b></span>coding.system = <span style="color: blue">'http://terminology.hl7.org/CodeSystem/observation-category'</span> <i>"categorySystem"</i><span style="color: navy">;</span>
qr<span style="color: navy"><b> -> </b></span>coding.code = <span style="color: blue">'survey'</span> <i>"categoryCode"</i><span style="color: navy">;</span>
qr<span style="color: navy"><b> -> </b></span>coding.display = <span style="color: blue">'Survey'</span> <i>"categoryDisplay"</i><span style="color: navy">;</span>
<span style="color: navy">}</span> <i>"categoryCoding"</i><span style="color: navy">;</span>
<span style="color: navy">}</span> <i>"category"</i><span style="color: navy">;</span>
<span style="color: navy">}
</span><b>group </b>BuildConsentBase<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">r</span><span style="color: navy"> : </span>Consent, <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>r<b> then </b>SetResponseProvenance<span style="color: navy">(</span><span style="color: maroon">qr</span><span style="color: navy">, </span><span style="color: maroon">r</span><span style="color: navy">)</span> <i>"responseProvenance"</i><span style="color: navy">;</span>
qr<span style="color: navy"><b> -> </b></span>r.id = <b>uuid</b><span style="color: navy">(</span><span style="color: navy">)</span><b> then </b>SetConsentFullUrl<span style="color: navy">(</span><span style="color: maroon">r</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">'Consent'</span> <i>"requestUrl"</i><span style="color: navy">;</span>
<span style="color: navy">}</span> <i>"entryRequest"</i><span style="color: navy">;</span>
qr.subject<b> as </b><span style="color: maroon">s</span><span style="color: navy"><b> -> </b></span>r.subject = <span style="color: maroon">s</span><span style="color: navy">;</span>
<span style="color: navy">}
</span><b>group </b>SetConsentFullUrl<span style="color: navy">(</span><b>source</b> <span style="color: maroon">r</span><span style="color: navy"> : </span>Consent, <b>target</b> <span style="color: maroon">entry</span><span style="color: navy">)</span><span style="color: navy"> {
</span> r.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/Consent/'</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><span style="color: navy">// </span><span style="color: green">── Provenance and tenancy ───────────────────────────────────────────────────</span>
<span style="color: navy">// </span><span style="color: green">Two tags on everything this map creates. The first says which questionnaire</span>
<span style="color: navy">// </span><span style="color: green">produced it, so a form that reopens mid-admission recalls its own earlier</span>
<span style="color: navy">// </span><span style="color: green">entries and not another form's. The second copies the tenant tags off the</span>
<span style="color: navy">// </span><span style="color: green">response, because nothing else on the path puts them there.</span>
<span style="color: navy">// </span><span style="color: green">The code is the form's document type, not the questionnaire's id: every</span>
<span style="color: navy">// </span><span style="color: green">environment mints its own ids, and there is only one set of maps, so an id</span>
<span style="color: navy">// </span><span style="color: green">here would tie the tag to whichever environment stamped it.</span>
<span style="color: navy">// </span><span style="color: green">── Provenance and tenancy ───────────────────────────────────────────────────</span>
<b>group </b>SetResponseProvenance<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">r</span><span style="color: navy">)</span><span style="color: navy"> {
</span> qr<span style="color: navy"><b> -> </b></span>r.meta<b> as </b><span style="color: maroon">m</span><b> then</b><span style="color: navy"> {
</span> qr<span style="color: navy"><b> -> </b></span>m.tag<b> as </b><span style="color: maroon">t</span><b> then</b><span style="color: navy"> {
</span> qr<span style="color: navy"><b> -> </b></span>t.system = <span style="color: blue">'http://slade360edi.com/questionnaire-provenance'</span> <i>"provenanceSystem"</i><span style="color: navy">;</span>
qr<span style="color: navy"><b> -> </b></span>t.code = <span style="color: blue">'procedure-consent'</span> <i>"provenanceCode"</i><span style="color: navy">;</span>
qr<span style="color: navy"><b> -> </b></span>t.display = <span style="color: blue">'Consent for a procedure or treatment'</span> <i>"provenanceDisplay"</i><span style="color: navy">;</span>
<span style="color: navy">}</span> <i>"provenanceTag"</i><span style="color: navy">;</span>
<span style="color: navy">}</span> <i>"provenanceMeta"</i><span style="color: navy">;</span>
<span style="color: navy">// </span><span style="color: green">Every tag the response carries, onto the resource. `meta` is 0..1, so this</span>
<span style="color: navy">// </span><span style="color: green">lands on the same meta the rule above created rather than a second one.</span>
qr.meta<b> as </b><span style="color: maroon">qm</span><b> then</b><span style="color: navy"> {
</span> qm.tag<b> as </b><span style="color: maroon">qt</span><span style="color: navy"><b> -> </b></span> r.meta<b> as </b><span style="color: maroon">m</span><span style="color: navy">, </span> m.tag = <span style="color: maroon">qt</span> <i>"copyTag"</i><span style="color: navy">;</span>
<span style="color: navy">}</span> <i>"tenantTags"</i><span style="color: navy">;</span>
<span style="color: navy">}
</span></pre></div>
</text>
<url
value="https://fhir.slade360.co.ke/fhir/StructureMap/ExtractProcedureConsent"/>
<version value="0.1.0"/>
<name value="ExtractProcedureConsent"/>
<title value="Procedure Consent 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="The three consent forms out as one Consent, with a provision per authorisation actually given: the procedure itself, the further-measures clause, the anaesthesia clause, and on an endoscopy form the tissue-disposal clause and each procedure ticked. Each provision is written only when its box was answered yes, so a consent nobody gave never appears as one. An Observation records whether the explanation was given in a language the person consenting understood, because that is what makes the consent informed and what an audit or a complaint turns on."/>
<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/Consent"/>
<mode value="target"/>
<alias value="Consent"/>
</structure>
<structure>
<url value="http://hl7.org/fhir/StructureDefinition/Observation"/>
<mode value="target"/>
<alias value="Observation"/>
</structure>
<group>
<name value="ExtractProcedureConsent"/>
<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="createConsent"/>
<source>
<context value="qr"/>
<condition
value="item.where(linkId = 'signatures').item.where(linkId = 'signatures/consenter-signed').answer.value = true"/>
</source>
<target>
<context value="bundle"/>
<element value="entry"/>
<variable value="entry"/>
</target>
<target>
<context value="entry"/>
<element value="resource"/>
<variable value="consent"/>
<transform value="create"/>
<parameter>
<valueString value="Consent"/>
</parameter>
</target>
<rule>
<name value="base"/>
<source>
<context value="qr"/>
</source>
<target>
<context value="consent"/>
</target>
<target>
<context value="entry"/>
</target>
<dependent>
<name value="BuildConsentBase"/>
<parameter>
<valueId value="qr"/>
</parameter>
<parameter>
<valueId value="consent"/>
</parameter>
<parameter>
<valueId value="entry"/>
</parameter>
</dependent>
</rule>
<rule>
<name value="status"/>
<source>
<context value="qr"/>
</source>
<target>
<context value="consent"/>
<element value="status"/>
<transform value="copy"/>
<parameter>
<valueString value="active"/>
</parameter>
</target>
</rule>
<rule>
<name value="decision"/>
<source>
<context value="qr"/>
</source>
<target>
<context value="consent"/>
<element value="decision"/>
<transform value="copy"/>
<parameter>
<valueString value="permit"/>
</parameter>
</target>
</rule>
<rule>
<name value="category"/>
<source>
<context value="qr"/>
</source>
<target>
<context value="consent"/>
<element value="category"/>
<variable value="cat"/>
</target>
<rule>
<name value="coding"/>
<source>
<context value="qr"/>
</source>
<target>
<context value="cat"/>
<element value="coding"/>
<variable value="cg"/>
</target>
<rule>
<name value="sys"/>
<source>
<context value="qr"/>
</source>
<target>
<context value="cg"/>
<element value="system"/>
<transform value="copy"/>
<parameter>
<valueString value="http://loinc.org"/>
</parameter>
</target>
</rule>
<rule>
<name value="cd"/>
<source>
<context value="qr"/>
</source>
<target>
<context value="cg"/>
<element value="code"/>
<transform value="copy"/>
<parameter>
<valueString value="64293-4"/>
</parameter>
</target>
</rule>
<rule>
<name value="dsp"/>
<source>
<context value="qr"/>
</source>
<target>
<context value="cg"/>
<element value="display"/>
<transform value="copy"/>
<parameter>
<valueString value="Procedure consent Document"/>
</parameter>
</target>
</rule>
</rule>
</rule>
<rule>
<name value="signaturesGroup"/>
<source>
<context value="qr"/>
<element value="item"/>
<variable value="sg"/>
<condition value="linkId = 'signatures'"/>
</source>
<rule>
<name value="signedAtRule"/>
<source>
<context value="sg"/>
<element value="item"/>
<variable value="it"/>
<condition
value="(linkId = 'signatures/consenter-signed-at') and answer.value.exists()"/>
</source>
<rule>
<name value="answer"/>
<source>
<context value="it"/>
<element value="answer"/>
<listMode value="first"/>
<variable value="a"/>
</source>
<rule>
<name value="signedPeriodStart"/>
<source>
<context value="a"/>
<element value="value"/>
<variable value="t"/>
</source>
<target>
<context value="consent"/>
<element value="period"/>
<variable value="per"/>
</target>
<target>
<context value="per"/>
<element value="start"/>
<transform value="copy"/>
<parameter>
<valueId value="t"/>
</parameter>
</target>
<documentation
value="The form asks for a date *and time* signed, and Consent.date is a
`date`. The timestamp goes to Consent.period.start, which keeps it:
a consent taken the evening before theatre and one taken in the
anaesthetic room are hours apart and share a date."/>
</rule>
</rule>
</rule>
<documentation
value="The signing time, from the form. Not qr.authored: a consent taken the
evening before an operation and transcribed the next morning would
otherwise be dated to the transcription, which is the one date a dispute
about consent turns on."/>
</rule>
<rule>
<name value="explainedByGroup"/>
<source>
<context value="qr"/>
<element value="item"/>
<variable value="eg"/>
<condition value="linkId = 'explained-by'"/>
</source>
<rule>
<name value="clinicianRule"/>
<source>
<context value="eg"/>
<element value="item"/>
<variable value="it"/>
<condition
value="(linkId = 'explained-by/clinician') and answer.value.exists()"/>
</source>
<rule>
<name value="answer"/>
<source>
<context value="it"/>
<element value="answer"/>
<listMode value="first"/>
<variable value="a"/>
</source>
<rule>
<name value="verification"/>
<source>
<context value="a"/>
<element value="value"/>
<variable value="ref"/>
</source>
<target>
<context value="consent"/>
<element value="verification"/>
<variable value="ver"/>
</target>
<rule>
<name value="verified"/>
<source>
<context value="ref"/>
</source>
<target>
<context value="ver"/>
<element value="verified"/>
<transform value="copy"/>
<parameter>
<valueBoolean value="true"/>
</parameter>
</target>
</rule>
<rule>
<name value="verifiedBy"/>
<source>
<context value="ref"/>
</source>
<target>
<context value="ver"/>
<element value="verifiedBy"/>
<transform value="copy"/>
<parameter>
<valueId value="ref"/>
</parameter>
</target>
</rule>
</rule>
</rule>
</rule>
<rule>
<name value="explanationRule"/>
<source>
<context value="eg"/>
<element value="item"/>
<variable value="it"/>
<condition
value="(linkId = 'explained-by/what-was-explained') and answer.value.exists()"/>
</source>
<rule>
<name value="answer"/>
<source>
<context value="it"/>
<element value="answer"/>
<listMode value="first"/>
<variable value="a"/>
</source>
<rule>
<name value="explanationProvision"/>
<source>
<context value="a"/>
<element value="value"/>
<variable value="txt"/>
</source>
<target>
<context value="consent"/>
<element value="provision"/>
<variable value="prov"/>
</target>
<target>
<context value="prov"/>
<element value="code"/>
<variable value="pc"/>
</target>
<target>
<context value="pc"/>
<element value="text"/>
<transform value="copy"/>
<parameter>
<valueId value="txt"/>
</parameter>
</target>
</rule>
</rule>
</rule>
<documentation
value="Who explained it becomes the verifier -- they attested that the
discussion happened -- and who consented becomes the grantor."/>
</rule>
<rule>
<name value="consenterGroup"/>
<source>
<context value="qr"/>
<element value="item"/>
<variable value="cg2"/>
<condition value="linkId = 'consenter'"/>
</source>
<rule>
<name value="consenterNameRule"/>
<source>
<context value="cg2"/>
<element value="item"/>
<variable value="it"/>
<condition
value="(linkId = 'consenter/name') and answer.value.exists()"/>
</source>
<rule>
<name value="answer"/>
<source>
<context value="it"/>
<element value="answer"/>
<listMode value="first"/>
<variable value="a"/>
</source>
<rule>
<name value="grantorDisplay"/>
<source>
<context value="a"/>
<element value="value"/>
<variable value="txt"/>
</source>
<target>
<context value="consent"/>
<element value="grantor"/>
<variable value="ref"/>
<transform value="create"/>
<parameter>
<valueString value="Reference"/>
</parameter>
</target>
<target>
<context value="ref"/>
<element value="display"/>
<transform value="copy"/>
<parameter>
<valueId value="txt"/>
</parameter>
</target>
</rule>
</rule>
</rule>
<rule>
<name value="relationshipRule"/>
<source>
<context value="cg2"/>
<element value="item"/>
<variable value="it"/>
<condition
value="(linkId = 'consenter/relationship') and answer.value.exists()"/>
</source>
<rule>
<name value="answer"/>
<source>
<context value="it"/>
<element value="answer"/>
<listMode value="first"/>
<variable value="a"/>
</source>
<rule>
<name value="relationshipDisplay"/>
<source>
<context value="a"/>
<element value="value"/>
<variable value="txt"/>
</source>
<target>
<context value="consent"/>
<element value="grantor"/>
<variable value="ref"/>
<transform value="create"/>
<parameter>
<valueString value="Reference"/>
</parameter>
</target>
<target>
<context value="ref"/>
<element value="display"/>
<transform value="copy"/>
<parameter>
<valueId value="txt"/>
</parameter>
</target>
</rule>
</rule>
</rule>
</rule>
<rule>
<name value="consentForGroup"/>
<source>
<context value="qr"/>
<element value="item"/>
<variable value="g"/>
<condition value="linkId = 'consent-for'"/>
</source>
<rule>
<name value="procedureProvision"/>
<source>
<context value="g"/>
<element value="item"/>
<variable value="it"/>
<condition
value="(linkId = 'consent-for/procedure') and answer.value.exists()"/>
</source>
<target>
<context value="consent"/>
<element value="provision"/>
<variable value="prov"/>
</target>
<rule>
<name value="answer"/>
<source>
<context value="it"/>
<element value="answer"/>
<listMode value="first"/>
<variable value="a"/>
</source>
<rule>
<name value="procedureText"/>
<source>
<context value="a"/>
<element value="value"/>
<variable value="txt"/>
</source>
<target>
<context value="prov"/>
<element value="code"/>
<variable value="pc"/>
</target>
<target>
<context value="pc"/>
<element value="text"/>
<transform value="copy"/>
<parameter>
<valueId value="txt"/>
</parameter>
</target>
</rule>
</rule>
</rule>
<rule>
<name value="plannedForRule"/>
<source>
<context value="g"/>
<element value="item"/>
<variable value="it"/>
<condition
value="(linkId = 'consent-for/planned-for') and answer.value.exists()"/>
</source>
<rule>
<name value="answer"/>
<source>
<context value="it"/>
<element value="answer"/>
<listMode value="first"/>
<variable value="a"/>
</source>
<rule>
<name value="plannedPeriodStart"/>
<source>
<context value="a"/>
<element value="value"/>
<variable value="d"/>
</source>
<target>
<context value="consent"/>
<element value="period"/>
<variable value="per"/>
</target>
<target>
<context value="per"/>
<element value="start"/>
<transform value="cast"/>
<parameter>
<valueId value="d"/>
</parameter>
<parameter>
<valueString value="dateTime"/>
</parameter>
</target>
</rule>
</rule>
</rule>
<documentation
value="── The provisions ────────────────────────────────────────────────────
One per authorisation. The procedure itself is always a provision, since
it is what the form exists for; the rest appear only where their own box
was answered yes."/>
</rule>
<rule>
<name value="additionalAuthorisationsGroup"/>
<source>
<context value="qr"/>
<element value="item"/>
<variable value="g"/>
<condition value="linkId = 'additional-authorisations'"/>
</source>
<rule>
<name value="furtherMeasuresProvision"/>
<source>
<context value="g"/>
<element value="item"/>
<variable value="it"/>
<condition
value="(linkId = 'additional-authorisations/further-measures') and (answer.value.ofType(Coding).code = 'Y')"/>
</source>
<target>
<context value="consent"/>
<element value="provision"/>
<variable value="prov"/>
</target>
<rule>
<name value="furtherMeasuresText"/>
<source>
<context value="it"/>
</source>
<target>
<context value="prov"/>
<element value="code"/>
<variable value="pc"/>
</target>
<target>
<context value="pc"/>
<element value="text"/>
<transform value="copy"/>
<parameter>
<valueString
value="Further alternative operative measures or treatment found necessary during the procedure"/>
</parameter>
</target>
</rule>
</rule>
<rule>
<name value="anaesthesiaProvision"/>
<source>
<context value="g"/>
<element value="item"/>
<variable value="it"/>
<condition
value="(linkId = 'additional-authorisations/anaesthesia') and (answer.value.ofType(Coding).code = 'Y')"/>
</source>
<target>
<context value="consent"/>
<element value="provision"/>
<variable value="prov"/>
</target>
<rule>
<name value="anaesthesiaText"/>
<source>
<context value="it"/>
</source>
<target>
<context value="prov"/>
<element value="code"/>
<variable value="pc"/>
</target>
<target>
<context value="pc"/>
<element value="text"/>
<transform value="copy"/>
<parameter>
<valueString
value="Administration of general or other anaesthesia"/>
</parameter>
</target>
</rule>
</rule>
<rule>
<name value="noNamedPractitionerRule"/>
<source>
<context value="g"/>
<element value="item"/>
<variable value="it"/>
<condition
value="(linkId = 'additional-authorisations/no-named-practitioner') and (answer.value.ofType(Coding).code = 'Y')"/>
</source>
<rule>
<name value="noNamedPractitionerNote"/>
<source>
<context value="it"/>
</source>
<target>
<context value="consent"/>
<element value="provision"/>
<variable value="prov"/>
</target>
<target>
<context value="prov"/>
<element value="code"/>
<variable value="pc"/>
</target>
<target>
<context value="pc"/>
<element value="text"/>
<transform value="copy"/>
<parameter>
<valueString
value="The person consenting understands no assurance has been given that a particular practitioner will perform the procedure."/>
</parameter>
</target>
</rule>
</rule>
</rule>
<rule>
<name value="endoscopyProceduresGroup"/>
<source>
<context value="qr"/>
<element value="item"/>
<variable value="it"/>
<condition value="linkId = 'endoscopy-procedures'"/>
</source>
<rule>
<name value="endoscopyProvision"/>
<source>
<context value="it"/>
<element value="answer"/>
<variable value="a"/>
</source>
<target>
<context value="consent"/>
<element value="provision"/>
<variable value="prov"/>
</target>
<rule>
<name value="endoscopyCode"/>
<source>
<context value="a"/>
<element value="value"/>
<variable value="cv"/>
</source>
<target>
<context value="prov"/>
<element value="code"/>
<variable value="pc"/>
</target>
<rule>
<name value="coding"/>
<source>
<context value="cv"/>
</source>
<target>
<context value="pc"/>
<element value="coding"/>
<transform value="copy"/>
<parameter>
<valueId value="cv"/>
</parameter>
</target>
</rule>
<rule>
<name value="text"/>
<source>
<context value="cv"/>
<element value="display"/>
<variable value="d"/>
</source>
<target>
<context value="pc"/>
<element value="text"/>
<transform value="copy"/>
<parameter>
<valueId value="d"/>
</parameter>
</target>
</rule>
</rule>
</rule>
<documentation
value="Endoscopy: one provision per procedure ticked, so a consent for an upper
GI endoscopy alone cannot be read as covering a colonoscopy."/>
</rule>
<rule>
<name value="tissueDisposalProvision"/>
<source>
<context value="qr"/>
<element value="item"/>
<variable value="it"/>
<condition
value="(linkId = 'endoscopy-tissue-disposal') and (answer.value.ofType(Coding).code = 'Y')"/>
</source>
<target>
<context value="consent"/>
<element value="provision"/>
<variable value="prov"/>
</target>
<rule>
<name value="tissueDisposalText"/>
<source>
<context value="it"/>
</source>
<target>
<context value="prov"/>
<element value="code"/>
<variable value="pc"/>
</target>
<target>
<context value="pc"/>
<element value="text"/>
<transform value="copy"/>
<parameter>
<valueString
value="Examination, preservation or disposal of tissues and body fluids removed, and of X-ray or photographic records taken"/>
</parameter>
</target>
</rule>
</rule>
<rule>
<name value="antiCancerGroup"/>
<source>
<context value="qr"/>
<element value="item"/>
<variable value="g"/>
<condition value="linkId = 'anti-cancer-therapy'"/>
</source>
<rule>
<name value="regimenProvision"/>
<source>
<context value="g"/>
<element value="item"/>
<variable value="it"/>
<condition
value="(linkId = 'anti-cancer-therapy/regimen') and answer.value.exists()"/>
</source>
<target>
<context value="consent"/>
<element value="provision"/>
<variable value="prov"/>
</target>
<rule>
<name value="answer"/>
<source>
<context value="it"/>
<element value="answer"/>
<listMode value="first"/>
<variable value="a"/>
</source>
<rule>
<name value="regimenText"/>
<source>
<context value="a"/>
<element value="value"/>
<variable value="txt"/>
</source>
<target>
<context value="prov"/>
<element value="code"/>
<variable value="pc"/>
</target>
<target>
<context value="pc"/>
<element value="text"/>
<transform value="copy"/>
<parameter>
<valueId value="txt"/>
</parameter>
</target>
</rule>
</rule>
</rule>
<rule>
<name value="purposeRule"/>
<source>
<context value="g"/>
<element value="item"/>
<variable value="it"/>
<condition
value="(linkId = 'anti-cancer-therapy/intended-purpose') and answer.value.exists()"/>
</source>
<rule>
<name value="answer"/>
<source>
<context value="it"/>
<element value="answer"/>
<listMode value="first"/>
<variable value="a"/>
</source>
<rule>
<name value="purposeProvision"/>
<source>
<context value="a"/>
<element value="value"/>
<variable value="txt"/>
</source>
<target>
<context value="consent"/>
<element value="provision"/>
<variable value="prov"/>
</target>
<target>
<context value="prov"/>
<element value="code"/>
<variable value="pc"/>
</target>
<target>
<context value="pc"/>
<element value="text"/>
<transform value="copy"/>
<parameter>
<valueId value="txt"/>
</parameter>
</target>
</rule>
</rule>
</rule>
<rule>
<name value="sideEffectsRule"/>
<source>
<context value="g"/>
<element value="item"/>
<variable value="it"/>
<condition
value="(linkId = 'anti-cancer-therapy/side-effects-and-risks') and answer.value.exists()"/>
</source>
<rule>
<name value="answer"/>
<source>
<context value="it"/>
<element value="answer"/>
<listMode value="first"/>
<variable value="a"/>
</source>
<rule>
<name value="sideEffectsProvision"/>
<source>
<context value="a"/>
<element value="value"/>
<variable value="txt"/>
</source>
<target>
<context value="consent"/>
<element value="provision"/>
<variable value="prov"/>
</target>
<target>
<context value="prov"/>
<element value="code"/>
<variable value="pc"/>
</target>
<target>
<context value="pc"/>
<element value="text"/>
<transform value="copy"/>
<parameter>
<valueId value="txt"/>
</parameter>
</target>
</rule>
</rule>
</rule>
<documentation
value="Systemic anti-cancer therapy: the regimen is the provision, and the
purpose and side effects explained are notes on the consent -- they are
what was said, not what was permitted."/>
</rule>
<documentation
value="── The Consent ─────────────────────────────────────────────────────────
Guarded on the person consenting having actually signed. Everything below
hangs off that signature, and a Consent built from a half-filled form
asserts a permission that was never given."/>
</rule>
<rule>
<name value="languageGroup"/>
<source>
<context value="qr"/>
<element value="item"/>
<variable value="g"/>
<condition value="linkId = 'explained-by'"/>
</source>
<rule>
<name value="languageObservation"/>
<source>
<context value="g"/>
<element value="item"/>
<variable value="it"/>
<condition
value="(linkId = 'explained-by/language-understood') and answer.value.exists()"/>
</source>
<target>
<context value="bundle"/>
<element value="entry"/>
<variable value="entry"/>
</target>
<target>
<context value="entry"/>
<element value="resource"/>
<variable value="obs"/>
<transform value="create"/>
<parameter>
<valueString value="Observation"/>
</parameter>
</target>
<rule>
<name value="base"/>
<source>
<context value="qr"/>
</source>
<target>
<context value="obs"/>
</target>
<target>
<context value="entry"/>
</target>
<dependent>
<name value="BuildObsBase"/>
<parameter>
<valueId value="qr"/>
</parameter>
<parameter>
<valueId value="obs"/>
</parameter>
<parameter>
<valueId value="entry"/>
</parameter>
</dependent>
</rule>
<rule>
<name value="category"/>
<source>
<context value="qr"/>
</source>
<target>
<context value="obs"/>
</target>
<dependent>
<name value="SetSurveyCategory"/>
<parameter>
<valueId value="qr"/>
</parameter>
<parameter>
<valueId value="obs"/>
</parameter>
</dependent>
</rule>
<rule>
<name value="code"/>
<source>
<context value="it"/>
</source>
<target>
<context value="obs"/>
<element value="code"/>
<variable value="cc"/>
</target>
<rule>
<name value="coding"/>
<source>
<context value="it"/>
</source>
<target>
<context value="cc"/>
<element value="coding"/>
<variable value="cg"/>
</target>
<rule>
<name value="sys"/>
<source>
<context value="it"/>
</source>
<target>
<context value="cg"/>
<element value="system"/>
<transform value="copy"/>
<parameter>
<valueString
value="https://fhir.slade360.co.ke/fhir/CodeSystem/inpatient-clinical-concept-codesystem"/>
</parameter>
</target>
</rule>
<rule>
<name value="cd"/>
<source>
<context value="it"/>
</source>
<target>
<context value="cg"/>
<element value="code"/>
<transform value="copy"/>
<parameter>
<valueString value="capacity-to-consent"/>
</parameter>
</target>
</rule>
<rule>
<name value="dsp"/>
<source>
<context value="it"/>
</source>
<target>
<context value="cg"/>
<element value="display"/>
<transform value="copy"/>
<parameter>
<valueString value="Capacity to consent"/>
</parameter>
</target>
</rule>
</rule>
<rule>
<name value="codeText"/>
<source>
<context value="it"/>
</source>
<target>
<context value="cc"/>
<element value="text"/>
<transform value="copy"/>
<parameter>
<valueString
value="Explained in a language the person consenting fully understands"/>
</parameter>
</target>
</rule>
</rule>
<rule>
<name value="answer"/>
<source>
<context value="it"/>
<element value="answer"/>
<listMode value="first"/>
<variable value="a"/>
</source>
<rule>
<name value="codedValue"/>
<source>
<context value="a"/>
<element value="value"/>
<variable value="cv"/>
</source>
<target>
<context value="obs"/>
<element value="value"/>
<variable value="vc"/>
<transform value="create"/>
<parameter>
<valueString value="CodeableConcept"/>
</parameter>
</target>
<rule>
<name value="valueCoding"/>
<source>
<context value="cv"/>
</source>
<target>
<context value="vc"/>
<element value="coding"/>
<transform value="copy"/>
<parameter>
<valueId value="cv"/>
</parameter>
</target>
</rule>
<rule>
<name value="valueText"/>
<source>
<context value="cv"/>
<element value="display"/>
<variable value="d"/>
</source>
<target>
<context value="vc"/>
<element value="text"/>
<transform value="copy"/>
<parameter>
<valueId value="d"/>
</parameter>
</target>
</rule>
</rule>
</rule>
<rule>
<name value="languageInterpretation"/>
<source>
<context value="it"/>
<element value="answer"/>
<listMode value="first"/>
<variable value="a"/>
</source>
<rule>
<name value="notUnderstoodInterp"/>
<source>
<context value="a"/>
<element value="value"/>
<variable value="cv"/>
<condition value="code = 'N'"/>
</source>
<target>
<context value="obs"/>
<element value="interpretation"/>
<variable value="interp"/>
</target>
<rule>
<name value="coding"/>
<source>
<context value="cv"/>
</source>
<target>
<context value="interp"/>
<element value="coding"/>
<variable value="icg"/>
</target>
<rule>
<name value="sys"/>
<source>
<context value="cv"/>
</source>
<target>
<context value="icg"/>
<element value="system"/>
<transform value="copy"/>
<parameter>
<valueString
value="http://terminology.hl7.org/CodeSystem/v3-ObservationInterpretation"/>
</parameter>
</target>
</rule>
<rule>
<name value="cd"/>
<source>
<context value="cv"/>
</source>
<target>
<context value="icg"/>
<element value="code"/>
<transform value="copy"/>
<parameter>
<valueString value="A"/>
</parameter>
</target>
</rule>
<rule>
<name value="dsp"/>
<source>
<context value="cv"/>
</source>
<target>
<context value="icg"/>
<element value="display"/>
<transform value="copy"/>
<parameter>
<valueString value="Abnormal"/>
</parameter>
</target>
</rule>
</rule>
</rule>
</rule>
<rule>
<name value="interpreterRule"/>
<source>
<context value="g"/>
<element value="item"/>
<variable value="ip"/>
<condition
value="(linkId = 'explained-by/interpreter-name') and answer.value.exists()"/>
</source>
<rule>
<name value="answer"/>
<source>
<context value="ip"/>
<element value="answer"/>
<listMode value="first"/>
<variable value="a"/>
</source>
<rule>
<name value="interpreterNote"/>
<source>
<context value="a"/>
<element value="value"/>
<variable value="txt"/>
</source>
<target>
<context value="obs"/>
<element value="note"/>
<variable value="n"/>
</target>
<target>
<context value="n"/>
<element value="text"/>
<transform value="copy"/>
<parameter>
<valueId value="txt"/>
</parameter>
</target>
</rule>
</rule>
</rule>
</rule>
<documentation
value="── Was it explained in a language they understood? ─────────────────────
Its own Observation. It is not a permission, so it is not a provision; but
it is the fact that makes the consent informed, and a complaint or an
inquest turns on it. An interpreter's name, where one was used, rides
alongside as a note."/>
</rule>
</group>
<group>
<name value="BuildObsBase"/>
<documentation
value="─────────────────────────────────────────────────────────────────────────────
Shared scaffolding. Repeated in each map rather than imported: the transform
engine resolves `imports` against whatever StructureMaps happen to be on the
server, and a form 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.
`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="obs"/>
<type value="Observation"/>
<mode value="target"/>
</input>
<input>
<name value="entry"/>
<mode value="target"/>
</input>
<rule>
<name value="responseProvenance"/>
<source>
<context value="qr"/>
</source>
<target>
<context value="obs"/>
</target>
<dependent>
<name value="SetResponseProvenance"/>
<parameter>
<valueId value="qr"/>
</parameter>
<parameter>
<valueId value="obs"/>
</parameter>
</dependent>
</rule>
<rule>
<name value="idAndFullUrl"/>
<source>
<context value="qr"/>
</source>
<target>
<context value="obs"/>
<element value="id"/>
<transform value="uuid"/>
</target>
<dependent>
<name value="SetObservationFullUrl"/>
<parameter>
<valueId value="obs"/>
</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="Observation"/>
</parameter>
</target>
</rule>
</rule>
<rule>
<name value="status"/>
<source>
<context value="qr"/>
</source>
<target>
<context value="obs"/>
<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="obs"/>
<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="obs"/>
<element value="encounter"/>
<transform value="copy"/>
<parameter>
<valueId value="e"/>
</parameter>
</target>
</rule>
<rule>
<name value="effective"/>
<source>
<context value="qr"/>
<element value="authored"/>
<variable value="t"/>
</source>
<target>
<context value="obs"/>
<element value="effective"/>
<transform value="copy"/>
<parameter>
<valueId value="t"/>
</parameter>
</target>
</rule>
<rule>
<name value="performerFromSource"/>
<source>
<context value="qr"/>
<element value="source"/>
<variable value="src"/>
</source>
<target>
<context value="obs"/>
<element value="performer"/>
<transform value="copy"/>
<parameter>
<valueId value="src"/>
</parameter>
</target>
</rule>
<rule>
<name value="performerFallback"/>
<source>
<context value="qr"/>
<condition value="source.exists().not()"/>
</source>
<rule>
<name value="performerFromAuthor"/>
<source>
<context value="qr"/>
<element value="author"/>
<variable value="a"/>
</source>
<target>
<context value="obs"/>
<element value="performer"/>
<transform value="copy"/>
<parameter>
<valueId value="a"/>
</parameter>
</target>
</rule>
</rule>
<rule>
<name value="linkQuestionnaireResponse"/>
<source>
<context value="qr"/>
<element value="id"/>
<variable value="qid"/>
<condition value="$this.hasValue()"/>
</source>
<target>
<context value="obs"/>
<element value="derivedFrom"/>
<variable value="ref"/>
<transform value="create"/>
<parameter>
<valueString value="Reference"/>
</parameter>
</target>
<target>
<context value="ref"/>
<element value="reference"/>
<transform value="copy"/>
<parameter>
<valueId value="qid"/>
</parameter>
</target>
<documentation
value="A stored response's id already reads "QuestionnaireResponse/<id>", so it is
a relative reference as it stands. The hasValue() guard is what stops an
unsaved response -- one posted straight to $extract rather than saved first
-- from writing "QuestionnaireResponse/null" into the record."/>
</rule>
</group>
<group>
<name value="SetObservationFullUrl"/>
<input>
<name value="obs"/>
<type value="Observation"/>
<mode value="source"/>
</input>
<input>
<name value="entry"/>
<mode value="target"/>
</input>
<rule>
<name value="assignFullUrl"/>
<source>
<context value="obs"/>
<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/Observation/"/>
</parameter>
<parameter>
<valueId value="id"/>
</parameter>
</target>
</rule>
</group>
<group>
<name value="SetComponentCodedValue"/>
<documentation
value="The two answer shapes a component can carry. Both read the answer through the
untyped `.value` accessor: reading `valueCoding` or `valueQuantity` by its
typed property name fails at transform time on HAPI R5 with "Attempt to read
invalid property ... on QuestionnaireResponse.item.answer"."/>
<input>
<name value="it"/>
<mode value="source"/>
</input>
<input>
<name value="comp"/>
<mode value="target"/>
</input>
<rule>
<name value="componentAnswer"/>
<source>
<context value="it"/>
<element value="answer"/>
<listMode value="first"/>
<variable value="a"/>
</source>
<rule>
<name value="codedValue"/>
<source>
<context value="a"/>
<element value="value"/>
<variable value="cv"/>
</source>
<target>
<context value="comp"/>
<element value="value"/>
<variable value="cc"/>
<transform value="create"/>
<parameter>
<valueString value="CodeableConcept"/>
</parameter>
</target>
<rule>
<name value="valueCoding"/>
<source>
<context value="cv"/>
</source>
<target>
<context value="cc"/>
<element value="coding"/>
<transform value="copy"/>
<parameter>
<valueId value="cv"/>
</parameter>
</target>
</rule>
<rule>
<name value="valueText"/>
<source>
<context value="cv"/>
<element value="display"/>
<variable value="d"/>
</source>
<target>
<context value="cc"/>
<element value="text"/>
<transform value="copy"/>
<parameter>
<valueId value="d"/>
</parameter>
</target>
</rule>
</rule>
</rule>
</group>
<group>
<name value="SetComponentValue"/>
<input>
<name value="it"/>
<mode value="source"/>
</input>
<input>
<name value="comp"/>
<mode value="target"/>
</input>
<rule>
<name value="componentAnswer"/>
<source>
<context value="it"/>
<element value="answer"/>
<listMode value="first"/>
<variable value="a"/>
</source>
<rule>
<name value="plainValue"/>
<source>
<context value="a"/>
<element value="value"/>
<variable value="v"/>
</source>
<target>
<context value="comp"/>
<element value="value"/>
<transform value="copy"/>
<parameter>
<valueId value="v"/>
</parameter>
</target>
</rule>
</rule>
</group>
<group>
<name value="SetSurveyCategory"/>
<input>
<name value="qr"/>
<type value="QR"/>
<mode value="source"/>
</input>
<input>
<name value="obs"/>
<type value="Observation"/>
<mode value="target"/>
</input>
<rule>
<name value="category"/>
<source>
<context value="qr"/>
</source>
<target>
<context value="obs"/>
<element value="category"/>
<variable value="cat"/>
</target>
<rule>
<name value="categoryCoding"/>
<source>
<context value="qr"/>
</source>
<target>
<context value="cat"/>
<element value="coding"/>
<variable value="coding"/>
</target>
<rule>
<name value="categorySystem"/>
<source>
<context value="qr"/>
</source>
<target>
<context value="coding"/>
<element value="system"/>
<transform value="copy"/>
<parameter>
<valueString
value="http://terminology.hl7.org/CodeSystem/observation-category"/>
</parameter>
</target>
</rule>
<rule>
<name value="categoryCode"/>
<source>
<context value="qr"/>
</source>
<target>
<context value="coding"/>
<element value="code"/>
<transform value="copy"/>
<parameter>
<valueString value="survey"/>
</parameter>
</target>
</rule>
<rule>
<name value="categoryDisplay"/>
<source>
<context value="qr"/>
</source>
<target>
<context value="coding"/>
<element value="display"/>
<transform value="copy"/>
<parameter>
<valueString value="Survey"/>
</parameter>
</target>
</rule>
</rule>
</rule>
</group>
<group>
<name value="BuildConsentBase"/>
<input>
<name value="qr"/>
<type value="QR"/>
<mode value="source"/>
</input>
<input>
<name value="r"/>
<type value="Consent"/>
<mode value="target"/>
</input>
<input>
<name value="entry"/>
<mode value="target"/>
</input>
<rule>
<name value="responseProvenance"/>
<source>
<context value="qr"/>
</source>
<target>
<context value="r"/>
</target>
<dependent>
<name value="SetResponseProvenance"/>
<parameter>
<valueId value="qr"/>
</parameter>
<parameter>
<valueId value="r"/>
</parameter>
</dependent>
</rule>
<rule>
<name value="idAndFullUrl"/>
<source>
<context value="qr"/>
</source>
<target>
<context value="r"/>
<element value="id"/>
<transform value="uuid"/>
</target>
<dependent>
<name value="SetConsentFullUrl"/>
<parameter>
<valueId value="r"/>
</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="Consent"/>
</parameter>
</target>
</rule>
</rule>
<rule>
<name value="subject"/>
<source>
<context value="qr"/>
<element value="subject"/>
<variable value="s"/>
</source>
<target>
<context value="r"/>
<element value="subject"/>
<transform value="copy"/>
<parameter>
<valueId value="s"/>
</parameter>
</target>
</rule>
</group>
<group>
<name value="SetConsentFullUrl"/>
<input>
<name value="r"/>
<type value="Consent"/>
<mode value="source"/>
</input>
<input>
<name value="entry"/>
<mode value="target"/>
</input>
<rule>
<name value="assignFullUrl"/>
<source>
<context value="r"/>
<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/Consent/"/>
</parameter>
<parameter>
<valueId value="id"/>
</parameter>
</target>
</rule>
</group>
<group>
<name value="SetResponseProvenance"/>
<documentation
value="── Provenance and tenancy ───────────────────────────────────────────────────
Two tags on everything this map creates. The first says which questionnaire
produced it, so a form that reopens mid-admission recalls its own earlier
entries and not another form's. The second copies the tenant tags off the
response, because nothing else on the path puts them there.
The code is the form's document type, not the questionnaire's id: every
environment mints its own ids, and there is only one set of maps, so an id
here would tie the tag to whichever environment stamped it.
── Provenance and tenancy ───────────────────────────────────────────────────"/>
<input>
<name value="qr"/>
<type value="QR"/>
<mode value="source"/>
</input>
<input>
<name value="r"/>
<mode value="target"/>
</input>
<rule>
<name value="provenanceMeta"/>
<source>
<context value="qr"/>
</source>
<target>
<context value="r"/>
<element value="meta"/>
<variable value="m"/>
</target>
<rule>
<name value="provenanceTag"/>
<source>
<context value="qr"/>
</source>
<target>
<context value="m"/>
<element value="tag"/>
<variable value="t"/>
</target>
<rule>
<name value="provenanceSystem"/>
<source>
<context value="qr"/>
</source>
<target>
<context value="t"/>
<element value="system"/>
<transform value="copy"/>
<parameter>
<valueString
value="http://slade360edi.com/questionnaire-provenance"/>
</parameter>
</target>
</rule>
<rule>
<name value="provenanceCode"/>
<source>
<context value="qr"/>
</source>
<target>
<context value="t"/>
<element value="code"/>
<transform value="copy"/>
<parameter>
<valueString value="procedure-consent"/>
</parameter>
</target>
</rule>
<rule>
<name value="provenanceDisplay"/>
<source>
<context value="qr"/>
</source>
<target>
<context value="t"/>
<element value="display"/>
<transform value="copy"/>
<parameter>
<valueString value="Consent for a procedure or treatment"/>
</parameter>
</target>
</rule>
</rule>
</rule>
<rule>
<name value="tenantTags"/>
<source>
<context value="qr"/>
<element value="meta"/>
<variable value="qm"/>
</source>
<rule>
<name value="copyTag"/>
<source>
<context value="qm"/>
<element value="tag"/>
<variable value="qt"/>
</source>
<target>
<context value="r"/>
<element value="meta"/>
<variable value="m"/>
</target>
<target>
<context value="m"/>
<element value="tag"/>
<transform value="copy"/>
<parameter>
<valueId value="qt"/>
</parameter>
</target>
</rule>
<documentation
value="Every tag the response carries, onto the resource. `meta` is 0..1, so this
lands on the same meta the rule above created rather than a second one."/>
</rule>
</group>
</StructureMap>