Links

Mappings with lisp/mapping

Aidbox provides the ability to convert data dynamically using lisp/mapping in your configuration. This is used in the HL7 v2 pipeline and some API constructor operations.
In order to create mapping, you need to declare a definition with lisp/mapping tag and write a structure with :mapping key, using lisp expressions in places where data will be calculated dynamically from the passed structure. It also allow to define an optional parameter :data-schema, which should be tagged as zen/schema and allows to validate the input data.
my-data-schema
{:zen/tags #{zen/schema}
:type zen/map
:values {:type zen/any}}
breathing-rate-mapping
{:zen/tags #{lisp/mapping}
:mapping {:resourceType "Bundle"
:type "transaction"
:entry [{:resource {:resourceType "Patient"}
:request {:method "PUT"
:url "/Patient/zero"}}
{:resource {:resourceType "Observation"
:status "final"
:code {:coding [{:system "http://loinc.org"
:code "8867-4"
:display "Respiratory rate"}]
:text "Breathing Rate"}
:subject {:reference "Patient/zero"}
:effectiveDateTime (get-in [:br 0 :dateTime]),
:valueQuantity {
:value (get-in [:br 0 :value :breathingRate]),
:unit "breaths/minute",
:system "http://unitsofmeasure.org",
:code "/min"}}
:request {:method "POST"
:url "/Observation"}}]}
:data-schema my-data-schema ;; Optional
}

Example

Passed structure

{:br [{:value {:breathingRate 18.1}
:dateTime "2022-11-15"}]}

Result

{:type "transaction-response"
:entry
[{:resource
{:id "zero"
:resourceType "Patient"}}
{:resource
{:valueQuantity
{:code "/min",
:unit "breaths/minute",
:value 17.8,
:system "http://unitsofmeasure.org"},
:resourceType "Observation",
:effectiveDateTime "2021-10-25",
:status "final",
:code
{:text "Breathing Rate",
:coding
[{:code "8867-4",
:system "http://loinc.org",
:display "Respiratory rate"}]},
:subject {:reference "Patient/zero"}},}]}
In the provided example, mapping is used to create a Bundle with dynamically calculated Observation.valueQuantity.value and Obsevation.effectiveDateTime FHIR properties.
Last modified 4mo ago