MyHealtheVet use of PGHD
0.2.10-beta - ci-build United States of America flag

MyHealtheVet use of PGHD - Local Development build (v0.2.10-beta) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

Artifacts Summary

This page provides a list of the FHIR artifacts defined as part of this implementation guide.

Behavior: Capability Statements

The following artifacts define the specific capabilities that different types of systems are expected to have in order to comply with this implementation guide. Systems conforming to this implementation guide are expected to declare conformance to one or more of the following capability statements.

This indicates how MHV uses PGHD

CapabilityStatement prototype for MHV as a FHIR Client

Structures: Resource Profiles

These define constraints on FHIR resources for systems conforming to this implementation guide.

VA MHV Allergy or Intolerance

A profile on the AllergyIntolerance that declares how MHV will Create in PGHD for allergy or intolerance.

Given that MyHealtheVet has access to the medical record (Vista and Cerner), there should be logic keeping a patient from entering a duplicate allergy or intolerance.

  • Derived off of US-Core Allergy
  • must be marked with MHV app tag
  • must point at the patient
  • must indicate patient is the asserter
  • may have recorder be the user (e.g. delegate)
  • must have clinicalStatus of active
  • may have type set to allergy or intolerance (default blank)
  • must have a recordedDate of the date entered
  • must have a onsetDateTime from the UI
  • must have a code.text or code.coding from a valueset from the UI
  • may have a category from the UI
  • may have a severity from the UI
  • must have a reaction.note or reaction.manifestation from the UI
  • may have a comments note from the UI
  • once created will or might have an id, versionId, lastUpdated, text, and identifier
  • DSTU2 uses slightly different element names (e.g., substance and onset)
VA MHV Blood Oxygen Saturation Observation

A profile on the Observation that declares how MHV will Read/Create in PGHD for blood Oxygen Saturation measurements (aka Pulse Ox).

This profile is consistent with FHIR core Vital-Signs for Oxygen Saturation

  • must be marked with MHV app tag
  • must have vital-signs category
  • must have LOINC#59408-5 code AND LOINC#2708-6
    • Argonaut and VCM use 59408-5
    • FHIR Core R4 also adds 2708-6
  • must have effectiveDateTime
    • others might use effectivePeriod
  • must have a valueQuantity with UCUM ‘%’ units
    • must be between 50% <= n <= 100%
  • must have status at final or preliminary
  • must point at the patient
  • may have a hasMember of a heart-rate and/or respiration-rate
  • may have a note (comment)
  • MHV captures Oxygen Setting, but this is not captured or stored in PGHD
  • once created will or might have an id, versionId, lastUpdated, text, and identifier
  • DSTU2 use comment rather than note
VA MHV Blood Pressure Observation

A profile on the Observation that declares how MHV will Create/Read in PGHD for blood pressure measurements.

Note: This profile is not aligned with FHIR core Vital-Signs. FHIR Core Vital-Signs would prefer we use LOINC 85354-9 - Blood pressure panel with all children optional. This was not agreed by Mobile.

  • must be marked with MHV app tag
  • must have vital-signs category
  • must have LOINC#55284-4 code AND LOINC#8716-3
    • 8716-3 was added as some mobile apps searched on this
  • must have effectiveDateTime
    • others might use effectivePeriod
  • must not have a value[x]
  • must have two components
  • must have systolic and diastolic component values in mm[Hg]
    • systolic must be between 20 <= s <= 300
    • diastolic must be between 20 <= d <= 250
  • may have a related has-member heart-rate observation
  • must have status at final
  • must point at the patient
  • may have a note (comment)
  • once created will or might have an id, versionId, lastUpdated, text, and identifier

Later may have a position component (sitting, standing, supline, and resting)

VA MHV Blood Sugar Observation

A profile on the Observation that declares how MHV could Create in PGHD for blood sugar measurements. Indicate fasting status as a code.

Switched to this with the move to R4

Note that Blood Sugar is not part of FHIR core vital-signs.

  • must be marked with MHV app tag
  • must have laboratory category
  • must have LOINC#2339-0 code
    • no longer using LOINC#2345-7 with move to FHIR R4
  • may have indication of fasting (LOINC#88365-2), or 2-hours after meal (LOINC#87422-2)
  • must have effectiveDateTime
    • others might use effectivePeriod
  • must have valueQuantity with units only of mg/dL
    • must be between 10 <= n <= 1000
  • must have status at final
  • must point at the patient
  • may have a method of clinical lab test, sterile lancet, transcutaneous, implant, or other
  • may have a note (comment)
  • once created will or might have an id, versionId, lastUpdated, text, and identifier
VA MHV BlueButton Bundle

A profile on the Bundle that declares how MHV will Create in PGHD for BlueButton report.

This is a work in progress. It is not agreed to, and it is not ready for review.

  • must be a document type Bundle
  • must have a timestamp of when this was created
  • must have a MHV Bluebutton type of a Composition
  • must include Patient Resource
  • must include all Resources referenced by Composition
  • DSTU2 use comment rather than note
VA MHV BlueButton Composition

A profile on the Composition that declares how MHV will Create/Update in PGHD for BlueButton report.

This is a work in progress. It is not agreed to, and it is not ready for review.

  • must be marked with MHV app tag
  • must be status final
  • must have a title explaining the content - for example: all vital-signs from past 60 days
  • must have date stamp of when created (now)
  • must be LOINC 55188-7 Patient data Document
  • must point at the patient for both subject and author
  • DSTU2 use comment rather than note
VA MHV Body Temperature Observation

A profile on the Observation that declares how MHV will Create/Read in PGHD for body temperature measurements.

Note this is compliant with FHIR core vital-signs.

  • must be marked with MHV app tag
  • must have vital-signs category
  • must have LOINC#8310-5 code
  • must have effectiveDateTime
    • others might use effectivePeriod
  • must have valueQuantity with units from the MHV body temperatures (F and C)
    • must be value between 80 <= n <= 110 Fahrenheit
  • must have status at final
  • must point at the patient
  • may have a bodySite from MHV body temperature sites (tongue, underarm, ear, mouth, or rectum)
  • may have a note (comment)
  • once created will or might have an id, versionId, lastUpdated, text, and identifier
VA MHV BodyWeight Observation

A profile on the Observation that declares how MHV will Create in PGHD for body weight measurements.

Note this is compliant with FHIR core vital-signs.

  • must be marked with MHV app tag
  • must have vital-signs category
  • must have LOINC#29463-7 code
  • must have effectiveDateTime
    • others might use effectivePeriod
  • must have valueQuantity with units from the MHV body weights (lbs and kg)
    • must be value 0.25 <= n <= 999 lbs
  • must have status at final
  • must point at the patient
  • may have a note (comment)
  • once created will or might have an id, versionId, lastUpdated, text, and identifier
VA MHV FamilyMemberHistory

A profile on the FamilyMemberHistory that declares how MHV will Create in PGHD for an family member history record.

Proposed mapping not yet approved for implementation

Given that MyHealtheVet has access to medical record (Vista and Cerner) of FamilyMemberHistory, there should be logic keeping a patient from entering a duplicate details.

  • For each relative of the Patient there will be a FamilyMemberHistory instance
    • Thus a query of the FamilyMemberHistory instances for a given Patient will give you all the relatives for which medical history is known.
    • Each FamilyMemberHistory record would be updated when new medical conditions/problems are learned
    • Thus FamilyMemberHistory needs to have support for Create/Read/Update/Delete
  • once created will or might have an id, versionId, lastUpdated, text, and identifier
  • must be marked with MHV app tag
  • must point at the patient
  • must indicate the date this record is being recorded into PGHD
  • should have a name of the family member
  • must have the relationship this family member has with the Patient
  • should have the sex/gender (birth sex) of this family member
  • should have the age or date-of-birth
    • should use a valueSet for date ranges on decades
    • indicate estimatedAge if the age is estimated
  • should have indication when patient has died with the age of death or date
    • should use a valueSet for date ranges on decades
  • may have extension indication of twin (multiple-birth) using
  • may have extension indicate Race
  • may have extension indicate Ethnicity
  • may have extension indicate Adopted
  • should have 0..* conditions
    • condition.code should be from a given valueSet
    • condition.outcome should indicate the outcome of this condition
    • condition.onset[x] should indicate when this condition first manifested
    • condition.note may include a freetext note
  • should have a note
VA MHV HeartRate Observation

A profile on the Observation that declares how MHV will Create in PGHD for heart rate measurements.

Note this is compliant with FHIR core vital-signs.

  • must be marked with MHV app tag
  • must have vital-signs category
  • must have LOINC#8867-4 code
  • must have effectiveDateTime
    • others might use effectivePeriod
  • must have valueQuantity with units only of beats per minute
    • must be value 10 <= n <= 250
  • must have status at final
  • must point at the patient
  • may have a note (comment)
  • once created will or might have an id, versionId, lastUpdated, text, and identifier
VA MHV Immunization

A profile on the Immunization that declares how MHV will Create in PGHD for an immunization.

Proposed mapping not yet approved for implementation

Given that MyHealtheVet has access to medical record (Vista and Cerner) of immunizations, there should be logic keeping a patient from entering a duplicate immunization.

  • Derived off of US-Core Immunization
  • must be marked with MHV app tag
  • must point at the patient
  • must have status of completed (can not enter not-done or entered-in-error)
  • must have a code.text or code.coding from a valueset from the UI
    • codes from given valueSet
  • must have a date (occuranceDateTime) the vaccine was administered from the UI
  • must indicate the date this record is being recorded into PGHD
  • must be indicated this data are not official record (primarySource=false)
  • must indicate this is being recorded from patient recollection
  • any reaction is recorded as a contained observation
  • may have a comment note
  • once created will or might have an id, versionId, lastUpdated, text, and identifier
  • DSTU2 uses slightly different element names (e.g., substance and onset)
VA MHV Medication

A profile on the MedicationStatement that declares how MHV will Create in PGHD.

Proposed mapping not yet approved for implementation

  • NOT Derived off of US-Core as there is no MedicationStatement in US-Core
  • must be marked with MHV app tag
  • must have a medication name
  • must have a strength per dose
  • must have a reason for use
  • must have effectiveDateTime
  • must have status at final, stopped, or complete
  • must point at the patient
  • may have a note
  • may have quantity
  • may have frequency
  • may have method of taking
  • may have a rx number
  • may indicate where it was filled
  • may indicate who prescribed
  • may indicate if side affects or none
  • once created will or might have an id, versionId, lastUpdated, text, and identifier
VA MHV Pain Observation

A profile on the Observation that declares how MHV will Create in PGHD for pain measurements.

Note that Pain is not part of FHIR core vital-signs.

  • must be marked with MHV app tag
  • must have vital-signs category
  • must have both LOINC#72514-3 and SCT#225908003 code
  • must have effectiveDateTime
    • others might use effectivePeriod
  • must have valueQuantity with no units
    • must have integer between 0-10
  • must have status at final
  • must point at the patient
  • may have a note (comment)
  • once created will or might have an id, versionId, lastUpdated, text, and identifier
VA MHV Respiration Rate Observation

A profile on the Observation that declares how MHV will Read/Create in PGHD for respiration rate measurements. This is mostly used in conjunction with Blood Oxygen Saturation (aka PulseOx).

This profile is consistent with FHIR core Vital-Signs for Respiration Rate

  • must be marked with MHV app tag
  • must have vital-signs category
  • must have LOINC#9279-1 code
    • FHIR Core, Argonaut and VCM use 9279-1
  • must have effectiveDateTime
    • others might use effectivePeriod
  • must have valueQuantity with units only of breaths per minute
    • typical is 12-16 breaths per minute
    • must be a value 5 <= n <=120
  • must have status at final or preliminary
  • must point at the patient
  • may have a note (comment)
  • once created will or might have an id, versionId, lastUpdated, text, and identifier
  • DSTU2 use comment rather than note

Structures: Extension Definitions

These define constraints on FHIR data types for systems conforming to this implementation guide.

Adopted indication

When this family member is Adopted.

Ethnicity

What is the Ethnicity of this family member

Note would like to use the us-core defined extension, but it is not allowed in FamilyMemberHistory jira issue

MultiBirth indication

When this family member is known to be part of a MultiBirth, indicate how many siblings.

Race

What is the Race of this family member

Note would like to use us-core defined extension, but is not allowed in FamilyMemberHistory Jira issue

Terminology: Value Sets

These define sets of codes used by systems conforming to this implementation guide.

Ages ValueSet

ValueSet of the Ages allowed

PGD App Id Codes

All valid App ID codes

The body temperature measurement sites that MHV supports

These are the SNOMED body sites that MHV supports.

The body temperature measurement types that MHV supports

These are the UCUM types that MHV supports.

The body weight measurement types that MHV supports

These are the UCUM types that MHV supports. This is a subset of the full bodyWeight types (which also brings in grams. Others might also include stone).

The methods of measurement for blood pressure that MHV supports

These are the loinc body positions that MHV supports on blood pressure.

The methods of measurement for blood sugar that MHV supports

These are the SNOMED body sites that MHV supports.

The routes of medication that MHV supports

These are the SNOMED-CT routes for medications that MHV supports.

Terminology: Code Systems

These define new code systems used by systems conforming to this implementation guide.

Ages in decades

Used when the Age is not known very well

PGD apps

App identifiers for use with PGD

PGD other apps

Seems to be used by Mobile Kidney

Example: Example Instances

These are example instances that show what data produced and consumed by systems conforming with this implementation guide might look like.

Dummy Patient example

Dummy patient example for completeness sake. No actual use of this resource other than an example target

Example Encounter

holding typical values

Example Father Family Member History

Minimal details

  • Johannes Yakub Schmidt
  • Father
  • Male
  • born July 25, 1903 - estimated
  • deceased
  • note
  • conditions: Anxiety and Choroidal
Example Mother Family Member History

Minimal details

  • Katherine Irene Schmidt
  • Mother
  • Female
  • note
  • conditions: Homiothermia and decreased hair growth
Example Practitioner

holding typical values

Example Second Son Family Member History

Maximal details

  • John Jacob Schmidt
  • Son
  • twin
  • born 7/25/1943
  • Male
  • not adopted
  • not hispanic or latino
  • Irish
  • note
  • conditions: Meningitis leading to Meningoccermia at age 50s
  • conditions: bipolar
Example Son Family Member History

Minimal details

  • John Jacob Schmidt
  • Son
  • twin
  • age 78
  • Male
  • note
  • conditions: scrotum wound and bladder continence
Example Wife Family Member History

Minimal details

  • Jania Luise Schmidt
  • Wife
  • Female
  • note
  • conditions: Pharyngitis and normal peripheral vision
Example of a MHV pain R4 observation 8, please help

holding typical values

Example of a MHV pain R4 observation 9, I can't take it

holding typical values

Example of a MHV pain R4 observation of 10, Oh, scream in pain

holding typical values

Example of a MHV pain R4 observation of 10. This is also not fully compliant but MHV should see it

holding typical values

Example of a non MHV bodyTemperature R4 observation by forehead

holding typical values

Example of a non MHV bodyTemperature R4 observation by tongue

holding typical values

Example of a non MHV bodyTemperature R4 observation by tongue over a period

holding typical values

Example of a non MHV bodyTemperature R4 observation by urinary bladder

holding typical values

Example of a non MHV bodyTemperature R4 observation with no site

holding typical values

Example of a non MHV pain R4 observation of 10 (it has three codes)

holding typical values

Example of a non MHV pain R4 observation of 11

holding invalid values

Example of a non MHV pain R4 observation of 3.14159 (it is between 0-10, but is not an integer)

holding invalid values

Example of a non MHV pain R4 observation of 37 degrees cel

holding invalid values

Example of a non-MHV blood sugar R4 observation, vital-sign

holding a value that is too high (1001) value

Example of a pain R4 observation of 10. This is not fully compliant but MHV should see it

holding typical values

Example of an Apple bodyWeight

This observation does not use a dateTime, but rather a period.

This is similar to how Apple data looks.

  • note no category
  • note effectivePeriod with start and end that are equal
Example of an MHV BlueButton Document Composition

holding typical values

Example of an MHV allergy R4 to aspirin, no note

holding typical values

Example of an MHV blood pressure R4 observation, like Apple produes

holding Apple like values of 140/90 with a heart-rate

Note

  • apple does not populate the category
  • apple only uses one code of LOINC#55284-4
  • apple uses effectivePeriod (seemingly to have start and end the same)
  • has meta.source populated with unknown identifier (presume some link back to apple, although this could be PGHD and not SMHD)
Example of an MHV blood pressure R4 observation, minimal

holding typical values of 140/90

Example of an MHV blood pressure R4 observation, minimal

holding typical values of 140/90 with a heart-rate

Example of an MHV blood pressure R4 observation, minimal

holding typical values of 140/90 with a heart-rate, using only a end Period time/date

Example of an MHV blood pressure R4 observation, minimal

holding typical values of 140/90 with a heart-rate, using only a start Period time/date

Example of an MHV blood sugar R4 observation, ZERO, unknown eating, by implant

holding atypical values

Example of an MHV blood sugar R4 observation, after meal

holding typical values

Example of an MHV blood sugar R4 observation, fasting

holding typical values

Example of an MHV blood sugar R4 observation, impossibly high, unknown eating, by implant

holding atypical values

Example of an MHV blood sugar R4 observation, minimal

holding typical values

Example of an MHV blood sugar R4 observation, too high

holding a value that is too high (1001) value

Example of an MHV blood sugar R4 observation, too low

holding a value that is too low (1) value

Example of an MHV blood sugar R4 observation, unknown eating

holding typical values

Example of an MHV blood sugar R4 observation, unknown eating, by implant

holding typical values

Example of an MHV blood sugar R4 observation, unknown eating, by lancet

holding typical values

Example of an MHV blood sugar R4 observation, unknown eating, by skin

holding typical values

Example of an MHV bodyTemperature R4 observation by ear

holding typical values

Example of an MHV bodyTemperature R4 observation by mouth

holding typical values

Example of an MHV bodyTemperature R4 observation by mouth, no bodySite, no note

holding typical values

Example of an MHV bodyTemperature R4 observation by rectum

holding typical values

Example of an MHV bodyTemperature R4 observation by tongue

holding typical values

Example of an MHV bodyTemperature R4 observation by tongue

holding typical values

Example of an MHV bodyTemperature R4 observation by underarm

holding typical values

Example of an MHV bodyWeight R4 observation - kg - 81.5 kg

holding typical values

Example of an MHV bodyWeight R4 observation - pounds

holding typical values

  • 185 pounds
Example of an MHV heartRate R4 observation

Heart Rate holding typical values

Example of an MHV heartRate R4 observation

Heart Rate holding typical values

Example of an MHV heartRate R4 observation

Heart Rate holding typical values

Example of an MHV immunization R4 to flu, no note, no reaction

holding typical values

Example of an MHV medication R4, minimal

holding typical values

Example of an MHV oxygenSat R4 observation

Oxygen Saturation holding high value of 99.4%

Example of an MHV oxygenSat R4 observation of 65% with a heart-rate

Heart Rate holding typical values

Example of an MHV oxygenSat R4 observation of 94% with a heart-rate and respiration-rate

Heart Rate holding typical values

Example of an MHV oxygenSat R4 observation of 95% with a respiration-rate

Heart Rate holding typical values

Example of an MHV oxygenSat R4 observation really low at 65%

Oxygen Saturation holding typical values

Example of an MHV oxygenSat R4 observation value of 95%

Oxygen Saturation holding typical values

Example of an MHV pain R4 observation of 1 with good vibes

holding typical values

Example of an MHV pain R4 observation of 2, no note

holding typical values

Example of an MHV pain R4 observation of 3, no note

holding typical values

Example of an MHV pain R4 observation of 4, no note

holding typical values

Example of an MHV pain R4 observation of 5, comme ci comme ça

holding typical values

Example of an MHV pain R4 observation of 6, no note

holding typical values

Example of an MHV pain R4 observation of 7, not good

holding typical values

Example of an MHV pain R4 observation of zero, no note

holding typical values

Example of an MHV respirationRate R4 observation

Respiration Rate holding typical values

Example of an MHV respirationRate R4 observation

Respiration Rate holding typical values

Example of an MHV respirationRate R4 observation

Respiration Rate holding typical values

Example of an OxygenSat that is rumored to exist

This is not coded as oxygen sat, but has a text. Rumored to be what SMHD might create.

Example of an non MHV bodyTemperature R4 observation by truck

holding typical values

Example of an non-MHV blood sugar R4 observation, by self monitoring

holding atypical values

Example of an non-MHV blood sugar R4 observation, by self supper time blood sugar measurement

holding atypical values

Example of an non-MHV blood sugar R4 observation, by urine

holding atypical values

Example of an non-MHV blood sugar R4 observation, just one of the .code values (2339-0)

holding atypical values

Example of an non-MHV blood sugar R4 observation, random blood glucose measurement

holding atypical values

Example of an non-MHV blood sugar R4 observation, the second .code value (2345-7)

holding atypical values

Example of an non-MHV blood sugar R4 observation, with a coded eating

holding atypical values

Example of an oxygenSat R4 observation of 94% with a heart-rate and respiration-rate and pain

Heart Rate holding typical values

Example of an valid FHIR International bodyWeight R4 observation

holding typical values. Should be close to the example body weight in the FHIR core specification

Example of an valid FHIR International bodyWeight R4 observation over a period

This observation does not use a dateTime, but rather a period.

This is similar to how Apple data looks.

  • note no category
  • note effectivePeriod with start and end that are equal
Example of an valid FHIR International bodyWeight R4 observation over a period with just a start

holding typical values. Should be close to the example body weight in the FHIR core specification. This observation does not use a dateTime, but rather a period with just a start.

Example of an valid FHIR International bodyWeight R4 observation over a period with just an end

holding typical values. Should be close to the example body weight in the FHIR core specification. This observation does not use a dateTime, but rather a period with just an end.

Example of an valid FHIR bodyWeight R4 observation

holding typical value but NOT using ucum units of measure.

Example of an valid FHIR bodyWeight R4 observation

holding typical stone values.

Example of an valid FHIR bodyWeight R4 observation

holding typical value in a string.