Mapping:  NZCentralRegionHL7V2ToFlag
Source:   NZCentralRegionFlag
Target:   "https://standards.digital.health.nz/ns/central-region/hl7-v2"
Id:       nzcr-flag-from-hl7v2
Title:    "Central Region Message Specification (1.14)"
Description: "Central Region Message Specification (1.14) - Flag from ADT^031 ZAL where Alert Type field `ZAL-2.1` with values from 
[Flag Alert Code](./ValueSet-nzcr-flag-alert-code-vs.html) codes."

* category -> "ZAL-2"
* category.coding.code -> "ZAL-2.1"
* category.coding.system -> "https://standards.digital.health.nz/ns/central-region/alert-category"
* category.coding.display -> "ZAL-2.2"

* identifier.use -> "'usual'"
* identifier.system -> "'https://standards.digital.health.nz/ns/central-region/pas-alert-id'"
* identifier.value -> "PID-3.1 + '-' + ZAL2.1 + '-' + ZAL-3.1" "Concatenation of PatientId, Alert Category and Alert Code"

* status -> "ZAL-5 & ZAL-9" "**if** ZAL-5 is in the past **AND** ZAL-9 is in the future or empty\r\n**then** 'active'\r\n**else** 'inactive'"

* category -> "ZAL-2" "Repeat for each coding"
* category.coding -> "ZAL-2" "Repeat for each coding"
* category.coding.system -> "http://terminology.hl7.org/CodeSystem/flag-category"
* category.coding.code -> "ZAL-2.1" "Raw value and mapped from webPAS alert category"
* category.coding.display -> "ZAL-2.2" "Raw value and mapped from webPAS alert category"

* code -> "ZAL-3"
* code.coding.code -> "ZAL-3.1"
* code.coding.system -> " " "One of:
* https://standards.digital.health.nz/ns/central-region/flag-alert-code-ls
* https://standards.digital.health.nz/ns/central-region/flag-alert-code-h2
* https://standards.digital.health.nz/ns/central-region/flag-alert-code-h4
* https://standards.digital.health.nz/ns/central-region/flag-alert-code-h5
* https://standards.digital.health.nz/ns/central-region/flag-alert-code-h6
* https://standards.digital.health.nz/ns/central-region/flag-alert-code-h7
* https://standards.digital.health.nz/ns/central-region/flag-alert-code-h8"
* code.coding.display -> "ZAL-3.2"
* code.text -> "ZAL-3.2" "When ZAL-3.1 is one of:
* https://standards.digital.health.nz/ns/central-region/flag-alert-code-nhimws
* https://standards.digital.health.nz/ns/central-region/flag-alert-code-mc
* https://standards.digital.health.nz/ns/central-region/flag-alert-code-ma
ie: these categories denote 'free-text' alert codes"

* subject.reference -> " " "read-only field"
* subject.type -> "'Patient'"
* subject.identifier -> " " "Select the NHI identifier from the list provided; where PID-3.4.2 = 2.16.840.1.113883.2.18.2"
* subject.identifier.use -> "'usual'"
* subject.identifier.system -> "'https://standards.digital.health.nz/ns/nhi-id'"
* subject.identifier.value -> "PID-3.1"
* subject.identifier.type.coding
  * code -> "'MR'"
  * system -> "'http://terminology.hl7.org/CodeSystem/v2-0203'"
  * display -> "'Medical record number'"
* subject.display -> "PID-5.1 + ', ' + PID-5.2 + ' ' + PID-5.3 + ' ' + PID-5.5"

* period.start -> "ZAL-5" "**Note:** ISO-8601 date format includes dashes"
* period.end -> "ZAL-9"

* author.reference -> " " "read-only field"
* author.type -> "'Practitioner'"
* author.identifier.use -> "'usual'"
* author.identifier.system -> "'https://standards.digital.health.nz/ns/central-region/pas-practitioner-id'"
* author.identifier.value -> "ZAL-10.1"
* author.identifier.type.coding -> " " "Practitioner Identifiers are locally assigned within PAS"
  * code -> "'LR'"
  * system -> "'http://terminology.hl7.org/CodeSystem/v2-0203'"
  * display -> "'Local registry ID'"
* author.display -> "ZAL-10.1 + ', ' + ZAL-10.2 + ' ' + ZAL-10.3 + ' ' + ZAL-10.5"

* extension[flag-alert].url -> "'https://standards.digital.health.nz/ns/central-region/alert'"

// TODO: severityLevel should be integer??
* extension[flag-alert].extension[webPASCategory].url -> "'webPASCategory'"
* extension[flag-alert].extension[webPASCategory].valueCoding
  * code -> "ZAL-2.1" 
  * display -> "ZAL-2.2"
  * system -> "'https://standards.digital.health.nz/ns/central-region/alert-category'"

* extension[flag-alert].extension[severityLevel].url -> "'severityLevel'"
* extension[flag-alert].extension[severityLevel].valueString -> "ZAL-6"  "TODO: severityLevel should be integer"

* extension[flag-alert].extension[allergyReaction].url -> "'allergyReaction'"
* extension[flag-alert].extension[allergyReaction].valueCodeableConcept -> "ZAL-4.1" "Optional field which is populated when `ZAL-4.1` is present."
  * coding.code -> "ZAL-4.1"
  * coding.system -> "'https://standards.digital.health.nz/ns/central-region/allergy-reaction-a3-a4' or 'https://standards.digital.health.nz/ns/central-region/allergy-reaction-h1-h3'"
  * coding.display -> "ZAL-4.2"

* extension[flag-alert].extension[reviewDate].url -> "'reviewDate'"
* extension[flag-alert].extension[reviewDate].valueDate -> "ZAL-7"

* extension[flag-alert].extension[inactiveDate].url -> "'inactiveDate'"
* extension[flag-alert].extension[inactiveDate].valueDate -> "ZAL-8"

* extension[flag-alert].extension[lastUpdatedDateTime].url -> "'lastUpdatedDateTime'"
* extension[flag-alert].extension[lastUpdatedDateTime].valueDateTime -> "ZAL-11" "**Note:** ISO-8601 datetime format includes dashes, colons, 'T' and '+12:00' timezone"

* extension[flag-alert].extension[lastUpdatedBy].url -> "'lastUpdatedBy'"
* extension[flag-alert].extension[lastUpdatedBy].valueString -> "ZAL-12.1 + ' - ' + ZAL-12.2" "Not to be confused with Author"

* extension[flag-alert].extension[recordingHospital].url -> "'recordingHospital'"
* extension[flag-alert].extension[recordingHospital].valueCodeableConcept
  * coding.code -> "ZAL-13.1" "if `ZAL-13.1` is a recognised medical facility code"
  * coding.system -> "'https://standards.digital.health.nz/ns/central-region/hospital-code'"
  * coding.display -> "ZAL-13.2" "if `ZAL-13.1` is a recognised medical facility code"
  * text -> "`ZAL-13.3` + ' defined code:' + `ZAL-13.1`" "if `ZAL-13.1` is **not** a recognised medical facility code"

* extension[flag-alert].extension[comments].url -> "'comments'"
* extension[flag-alert].extension[comments].valueString -> "ZAL-14"