Page Comparison

Resource id

[[Medication.Aggregated Data Point ID]]

Resource meta

• meta: Meta

  • lastUpdated = time of most recent update, automatically maintained by the FHIR server. It is normal for this to be slightly later than any value returned in the http://fhir.patientsknowbest.com/structuredefinition/version-persisted extension.

  • security[x]: Coding

    • system = "http://fhir.patientsknowbest.com/codesystem/privacy-label"

    • code = [[Data Point.Privacy Label]]

  • security[x]: Coding

    • system = “http://fhir.patientsknowbest.com/codesystem/source-organization”

    • code = the resource ID of the Organization representing the [[Data Point.Source Organisation]]

  • security[x]: Coding

    • system = “http://fhir.patientsknowbest.com/codesystem/source-team”

    • code = the resource ID of the Organization representing the [[Data Point.Source Team]]

  • <conditional>

  • If Source Person is a Professional:

  • security[x]: Coding

    • system = “http://fhir.patientsknowbest.com/codesystem/source-practitioner”

    • code = the resource ID of the Practitioner

  • Else if Source Person is a Patient:

  • security[x]: Coding

    • system = “http://fhir.patientsknowbest.com/codesystem/source-patient”

    • code = the resource

• • • ID of the Patient

  • security[x]: Coding

    • system = “http://fhir.patientsknowbest.com/codesystem/connecting-org”

    • code = the resource ID of the Organization representing the [[Data Point.Connecting Organisation]]

[[Data Point.Privacy Label]] code mappings (PKB → FHIR):

• GENERAL_HEALTH → GENERAL_HEALTH

• MENTAL_HEALTH → MENTAL_HEALTH

• SEXUAL_HEALTH → SEXUAL_HEALTH

• SOCIAL_CARE → SOCIAL_CARE

• extension[x]: Extension

  • url = “http://fhir.patientsknowbest.com/structuredefinition/uploaded-data-id”

  • valueString = [[Data Point.Uploaded Data ID]]

A single uploadeddata entry can result in multiple data points, so this ID does not necessarily uniquely identify a data point.

• extension[x]: Extension

  • url =

• • “http://fhir.patientsknowbest.com/structuredefinition/

• • access-route”

  • valueCoding: Coding

    • system = “http://fhir.patientsknowbest.com/

• • • codesystem/

• • • access-

• • • route”

• • • code = [[Data Point.

• • • Access Route]]

• extension[x]: Extension

  • url =

• • "http://fhir.patientsknowbest.com/structuredefinition/

• • source-

• • text"

  • valueString = [[Data Point.

• • Source Text]]

• extension[x]: Extension

  • url = “http://fhir.patientsknowbest.com/

• • structuredefinition/

• • responsible-

• • organization”

  • valueString = [[Data Point.Responsible Organisation Identifier]]

• extension[x]: Extension

  • url = “http://fhir.patientsknowbest.com/structuredefinition/

• • partner-

• • identifier”

• • valueReference: Reference

    • identifier: Identifier

      • system =

• • • • “urn:uuid:cd97da65-0aa4-43a6-b695-cfd0c6f3267d”

      • value = [[Data Point.

• • • • HL7 Partner]]

• extension[x]: Extension

  • url = “http://fhir.patientsknowbest.com/structuredefinition/privacy-override-source-organization”

  • valueReference: Reference

    • reference = the relative URL of the Organization resource for the source organisation of the most recent privacy override

Note that this is a reference, unlike the meta.security which contains a code.

• extension[x]: Extension

  • url = "http://fhir.patientsknowbest.com/structuredefinition/privacy-override-source-team”

  • valueReference: Reference

    • reference = the relative URL of the Organization resource for the source team of the most recent privacy override

Note that this is a reference, unlike the meta.security which contains a code.

• extension[x]: Extension

  • url = "http://fhir.patientsknowbest.com/structuredefinition/privacy-override-source-person”

  • valueReference: Reference

    • reference = the relative URL of the Patient or Practitioner resource of the source person of the most

• • • recent privacy override

Note that this is a reference, unlike the meta.security which contains a code.

• extension[x]: Extension

  • url = "http://fhir.patientsknowbest.com/structuredefinition/privacy-override-access-route”

  • valueCoding: Coding

    • system = “http://fhir.patientsknowbest.com/codesystem/access-route”

    • code = the access route which added the most recent privacy override

• extension[x]: Extension

  • url = "http://fhir.patientsknowbest.com/structuredefinition/privacy-override-change-date“

  • valueDateTime = the timestamp of the most recent privacy override

• extension[x]: Extension

  • url = “http://fhir.patientsknowbest.com/structuredefinition/recorded-date”

  • valueDateTime = [[Data Point.Entered Timestamp]]

• extension[x]: Extension

  • url = “http://fhir.patientsknowbest.com/structuredefinition/version-persisted”

  • valueDateTime = [[Data Point.Persisted Timestamp]]

• extension[x]: Extension

  • url = “

• • https://fhir.patientsknowbest.com/structuredefinition/

• • upstream-

• • last-

• • updated”

• • valueDateTime = as per extension definition

MedicationStatement.extension

For each [[Medication.Attachment]]:

• extension[x]: Extension

  • url = "http://fhir.patientsknowbest.com/structuredefinition/attachment"

  • valueAttachment: Attachment

    • contentType = [[Attachment.Media Type]]

    • title = [[Attachment.Filename]]

• extension[x]: Extension

  • url = "http://fhir.patientsknowbest.com/structuredefinition/specialty"

  • valueCoding: Coding

    • code = [[Data Point.Specialty]]

    • display = Resolve( [[Data Point.Specialty]] )

The “Resolve()” notation indicates that the display value for the corresponding specialty code will be determined at the time of retrieval, based on the (optional) code set for the source organisation.

• extension[x]: Extension

  • url = “https://fhir.patientsknowbest.com/structuredefinition/upstream”

  • extension[x]: Extension

    • url = “https://fhir.patientsknowbest.com/structuredefinition/upstream-source-id”

    • valueString = “ehrmigrated”

  • extension[x]: Extension

    • url = “https://fhir.patientsknowbest.com/structuredefinition/upstream-resource-id”

    • valueString = MedicationStatement/[[Data Point ID]]

MedicationStatement.identifier

• identifier[x]: Identifier

  • system = “http://fhir.patientsknowbest.com/id/menudata-legacy-identifier”

  • value = [[Data Point.Legacy Data Point ID]]

• identifier[x]: Identifier

  • value = [[Data Point.External Data Point ID]]

  • assigner: Reference

    • reference = the relative URL of the Organization representing the [[Data Point.Source Organisation]]

MedicationStatement.status

• <conditional>

• If [[Medication.Status]] == INACTIVE:

  • “completed“

• Else

  • “active“

MedicationStatement.medicationCodeableConcept

[[Medication.Substance]]

MedicationStatement.effectivePeriod

• effectivePeriod: Period

  • start = [[Medication.Start Timestamp]]

  • end = [[Medication.End Timestamp]]

MedicationStatement.subject

• subject: Reference

  • reference = the relative URL of the Patient resource

  • display = [[User.Title]] [[User.Given Name]] [[User.Family Name]]

MedicationStatement.dosage

• dosage[0]: Dosage

  • text = [[Medication.Frequency Text]]

  • patientInstruction = [[Medication.Instructions]]

  • timing: Timing

    • <conditional>

    • If [[Medication.Frequency Priority]] != AS_DIRECTED AND != AS_NEEDED:

      • repeat: Element

        • frequency = 1

        • period = [[Medication.Frequency Value]]

        • periodUnit = [[Medication.Frequency Units]]

    • Else if [[Medication.Frequency Priority]] == AS_DIRECTED:

      • code: CodeableConcept

        • text = "As directed"

    • Else:

      • Omit the "code" element

  • <conditional>

  • If [[Medication.Frequency Priority]] == AS_NEEDED:

    • asNeededBoolean = true

  • Else:

    • Omit the "asNeededBoolean" element

  • doseAndRate: Element

    • doseQuantity: SimpleQuantity

      • extension[x]: Extension

        • url =

• • • • • “http://fhir.patientsknowbest.com/structuredefinition/dose-

• • • • • units”

        • valueCodeableConcept = [[Medication.Dose Units]]

      • value = [[Medication.Dose Value]]

      • <conditional>

      • If [[Medication.Medication Unit]] NOT NULL:

        • code = [[Medication.Medication Unit]]

      • Else if [[Medication.Dose Units.Display Text]] NOT BLANK:

        • unit = [[Medication.Dose Units.Display Text]]

      • Else:

        • unit = [[Medication.Dose Units]] {coding[0] - display}

        • system = [[Medication.Dose Units]] {coding[0] - system}

        • code = [[Medication.Dose Units]] {coding[0] - code}

[[Medication.Frequency Units]] code mappings (PKB → FHIR):

• HOUR → h

Note #1: PKB supports more than one for dose units, but Quantity can represent only one. To ensure data is not lost, an extension is returned with the full CodeableConcept.

Note #2: Frequency instructions of “as directed” are discouraged, but if they have been provided then “As directed” will be set into the timing.code.text element.