Uploaded image for project: 'FHIR Specification Feedback'
  1. FHIR Specification Feedback
  2. FHIR-25277

seriesDoses and DoseNumber elements should be text only

    XMLWordPrintableJSON

Details

    • Icon: Change Request Change Request
    • Resolution: Persuasive
    • Icon: Medium Medium
    • FHIR Core (FHIR)
    • R4
    • Public Health
    • Immunization
      ImmunizationEvaluation
      ImmunizationRecommendation
    • Hide

      Update the doseNumber and seriesDoses elements in Immunization, ImmunizationEvaluation and ImmunizationRecommendation to only have a data type of ‘string’. Element names will remain the same (as opposed to doseNumberString, etc)

       

      The element descriptions will also be clarify the intent of the elements in the resource

      • In Immunization, it's the intent of the provider in administering the vaccine
      • In ImmunizationEvaluation and ImmunizationRecommendation, it is the outcome of the CDS engine evaluation of patient history against the specific set of recommendations it uses
      • Guidance will also be given that if a term like "booster" or "annual" is to be used to describe the dose given or being recommended, it should go in doseNumber.
      Show
      Update the doseNumber and seriesDoses elements in Immunization, ImmunizationEvaluation and ImmunizationRecommendation to only have a data type of ‘string’. Element names will remain the same (as opposed to doseNumberString, etc)   The element descriptions will also be clarify the intent of the elements in the resource In Immunization, it's the intent of the provider in administering the vaccine In ImmunizationEvaluation and ImmunizationRecommendation, it is the outcome of the CDS engine evaluation of patient history against the specific set of recommendations it uses Guidance will also be given that if a term like "booster" or "annual" is to be used to describe the dose given or being recommended, it should go in doseNumber.
    • Heather Patrick/Nathan Bunker: 20-0-0
    • Correction
    • Compatible, substantive
    • R5

    Description

      Originally, the doseNumber and seriesDoses elements in the immunization related resources were created with a data type of positiveInt (note that these elements have had different names in different base FHIR releases). This is probably because most doses can be expressed in the form of "dose 1 of 3", so having a number makes sense on the surface. But many vaccines are administered as "boosters" beyond the primary sequence of vaccines or "annually" such as influenza. For this reason, in R4, these elements were allowed to choose between positiveInt and string. But really, the fact that these concepts can be expressed as numbers, no "number type things" are ever done with the values (additional, order, etc). To simplify things, these elements should only be strings. 

      The element descriptions should also be clarify that the source/intent of the elements in each resource is a bit different (that is, in Immunization, it's the intent of the provider in administering the vaccine and in ImmunizationEvaluation and ImmunizationRecommendation, its the outcome of the CDS engine evaluation of patient history against the specific set of recommendations it uses). 

      See the Zulip thread for further details of the discussion: https://chat.fhir.org/#narrow/stream/211987-methodology/topic/ConceptReference

      Attachments

        Activity

          People

            Unassigned Unassigned
            craig.newman Craig Newman
            Watchers:
            1 Start watching this issue

            Dates

              Created:
              Updated:
              Resolved: