WHO Immunization Implementation Guide
0.2.0 - ci-build

WHO Immunization Implementation Guide, published by WHO. This guide is not an authorized publication; it is the continuous build for version 0.2.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/WorldHealthOrganization/smart-immunizations/ and changes regularly. See the Directory of published versions

Library: IMMZD2DTVaricella2DosesLogic

Official URL: http://smart.who.int/immunizations/Library/IMMZD2DTVaricella2DosesLogic Version: 0.2.0
Draft as of 2025-11-25 Computable Name: IMMZD2DTVaricella2DosesLogic

This library defines decision support logic for the IMMZ.D2.DT.Varicella.2 doses decision table in the Immunization CPG

Title: IMMZD2DTVaricella2DosesLogic
Id: IMMZD2DTVaricella2DosesLogic
Version: 0.2.0
Url: IMMZD2DTVaricella2DosesLogic
Status: draft
Type:

system: http://terminology.hl7.org/CodeSystem/library-type

code: logic-library

Date: 2025-11-25 20:07:03+0000
Publisher: WHO
Description:

This library defines decision support logic for the IMMZ.D2.DT.Varicella.2 doses decision table in the Immunization CPG

Related Artifacts:

Dependencies

Parameters:
NameTypeMinMaxIn/Out
Todaydate01In
PatientPatient01Out
Client is not due for varicella vaccination Case 1boolean01Out
Client is not due for varicella vaccination Case 2boolean01Out
Client is not due for varicella vaccination Case 3boolean01Out
Client is not due for varicella vaccination Case 4boolean01Out
Client is not due for varicella vaccinationboolean01Out
Client is not due for varicella vaccination Guidancestring01Out
Client is due for varicella vaccination Case 1boolean01Out
Client is due for varicella vaccination Case 2boolean01Out
Client is due for varicella vaccinationboolean01Out
Client is due for varicella vaccination Guidancestring01Out
Varicella immunization schedule is completeboolean01Out
Varicella immunization schedule is complete Guidancestring01Out
Guidancestring01Out
Has Guidanceboolean01Out
Test ValidationResource01Out
Content: text/cql
/*
 * Library: IMMZD2DTVaricella2DosesLogic (IMMZ.D2.DT.Varicella.2 doses)
 * Rule: Determine if the client is due for a varicella vaccination according to the national immunization schedule
 * Decision Table: Countries where varicella is an important public health burden could consider introducing varicella vaccination in the routine childhood immunization programme. However, resources should be sufficient to ensure reaching and sustaining vaccine coverage ≥ 80%. Decision-making on childhood varicella vaccination should also include consideration of the possible impact on herpes zoster.
The number of doses recommended is dependent on the goal of the vaccination programme. One dose is sufficient to reduce mortality and severe morbidity from varicella but not to prevent limited virus circulation and outbreaks. Two doses have higher effectiveness and should therefore be recommended in countries where the programmatic goal is, in addition to decreasing mortality and severe morbidity, to further reduce the number of cases and outbreaks.
 * Trigger: IMMZ.D2 Determine required vaccination(s) if any
 */
library IMMZD2DTVaricella2DosesLogic

using FHIR version '4.0.1'
include FHIRHelpers version '4.0.1'

include IMMZD2DTVaricellaEncounterElements called Encounter

parameter Today Date default Today()

context Patient


/*
@dynamicValue: Guidance
*/
define "Guidance":
  case 
    when "Client is not due for varicella vaccination" then "Client is not due for varicella vaccination Guidance"
    when "Client is due for varicella vaccination" then "Client is due for varicella vaccination Guidance"
    when "Varicella immunization schedule is complete" then "Varicella immunization schedule is complete Guidance" 
    else ''
  end
  
define "Has Guidance":
  "Guidance" is not null and "Guidance" != ''

/*
@output: Client is not due for varicella vaccination Case 1
@pseudocode: "Immunization recommendation status" = "Not due"
*/
define "Client is not due for varicella vaccination Case 1":
  Encounter."Client's age is less than 12 months"

/*
@output: Client is not due for varicella vaccination Case 2
@pseudocode: "Immunization recommendation status" = "Not due"
*/
define "Client is not due for varicella vaccination Case 2":
  Encounter."No varicella primary series doses were administered"
    and Encounter."Cient's age is more than or equal to 12 months"
    and Encounter."Live vaccine was administered in the past 4 weeks"

/*
@output: Client is not due for varicella vaccination Case 3
@pseudocode: "Immunization recommendation status" = "Not due"
*/
define "Client is not due for varicella vaccination Case 3":
  Encounter."One varicella primary series dose was administered"
    and Encounter."The latest varicella dose administered less than 4 weeks ago"

/*
@output: Client is not due for varicella vaccination Case 4
@pseudocode: "Immunization recommendation status" = "Not due"
*/
define "Client is not due for varicella vaccination Case 4":
  Encounter."One varicella primary series dose was administered"
    and Encounter."The latest varicella dose administered more than 4 weeks ago"
    and Encounter."Live vaccine was administered in the past 4 weeks"

/*
@output: Client is not due for varicella vaccination
@pseudocode: "Immunization recommendation status" = "Not due"
*/
define "Client is not due for varicella vaccination":
  "Client is not due for varicella vaccination Case 1"
    or "Client is not due for varicella vaccination Case 2"
    or "Client is not due for varicella vaccination Case 3"
    or "Client is not due for varicella vaccination Case 4"

/*
@output: Client is not due for varicella vaccination Guidance
@guidance = Should not vaccinate client with first varicella dose as client's age is less than 12 months. Check for any other vaccines due and inform the caregiver of when to come back for the first varicella dose.
@guidance = Should not vaccinate client with first varicella dose as live vaccine was administered in the past 4 weeks. Check for any other vaccines due and inform the caregiver of when to come back for the first varicella dose.
@guidance = Should not vaccinate client with second varicella dose as the latest varicella dose was administered less than 4 weeks ago. Check for any other vaccines due and inform the caregiver when to come back for the second dose.
@guidance = Should not vaccinate client with second varicella dose as live vaccine was administered in the past 4 weeks. Check for any vaccines due and inform the caregiver of when to come back for the second dose.
*/
define "Client is not due for varicella vaccination Guidance":
  case
    when "Client is not due for varicella vaccination Case 1" then 'Should not vaccinate client with first varicella dose as client\'s age is less than 12 months. Check for any other vaccines due and inform the caregiver of when to come back for the first varicella dose.'
    when "Client is not due for varicella vaccination Case 2" then 'Should not vaccinate client with first varicella dose as live vaccine was administered in the past 4 weeks. Check for any other vaccines due and inform the caregiver of when to come back for the first varicella dose.'
    when "Client is not due for varicella vaccination Case 3" then 'Should not vaccinate client with second varicella dose as the latest varicella dose was administered less than 4 weeks ago. Check for any other vaccines due and inform the caregiver when to come back for the second dose.'
    when "Client is not due for varicella vaccination Case 4" then 'Should not vaccinate client with second varicella dose as live vaccine was administered in the past 4 weeks. Check for any vaccines due and inform the caregiver of when to come back for the second dose.'
    else ''
  end

/*
@output: Client is due for varicella vaccination Case 1
@pseudocode: "Immunization recommendation status" = "Due"
*/
define "Client is due for varicella vaccination Case 1":
  Encounter."No varicella primary series doses were administered"
    and Encounter."Cient's age is more than or equal to 12 months"
    and Encounter."No live vaccine was administered in the past 4 weeks"

/*
@output: Client is due for varicella vaccination Case 2
@pseudocode: "Immunization recommendation status" = "Due"
*/
define "Client is due for varicella vaccination Case 2":
  Encounter."One varicella primary series dose was administered"
    and Encounter."The latest varicella dose administered more than 4 weeks ago"
    and Encounter."No live vaccine was administered in the past 4 weeks"

/*
@output: Client is due for varicella vaccination
@pseudocode: "Immunization recommendation status" = "Due"
*/
define "Client is due for varicella vaccination":
  "Client is due for varicella vaccination Case 1"
    or "Client is due for varicella vaccination Case 2"

/*
@output: Client is due for varicella vaccination Guidance
@guidance = Should vaccinate client with first varicella dose as no varicella dose was administered, client is within appropriate age range and no live vaccine was administered in past 4 weeks. Check for contraindications.
@guidance = Should vaccinate client with second varicella dose as the latest varicella dose was administered more than 4 weeks ago and no live vaccine was administered in past 4 weeks. Check for contraindications.
*/
define "Client is due for varicella vaccination Guidance":
  case
    when "Client is due for varicella vaccination Case 1" then 'Should vaccinate client with first varicella dose as no varicella dose was administered, client is within appropriate age range and no live vaccine was administered in past 4 weeks. Check for contraindications.'
    when "Client is due for varicella vaccination Case 2" then 'Should vaccinate client with second varicella dose as the latest varicella dose was administered more than 4 weeks ago and no live vaccine was administered in past 4 weeks. Check for contraindications.'
    else ''
  end

/*
@output: Varicella immunization schedule is complete
@pseudocode: "Immunization recommendation status" = "Complete"
*/
define "Varicella immunization schedule is complete":
  Encounter."Two varicella primary series doses were administered"

/*
@output: Varicella immunization schedule is complete Guidance
@guidance: Varicella immunization schedule is complete. Two varicella primary series doses were administered. Check for any other vaccines due.
*/
define "Varicella immunization schedule is complete Guidance":
  'Varicella immunization schedule is complete. Two varicella primary series doses were administered. Check for any other vaccines due.'


/*
@test: Test expected results based on example patients
*/
define "Test Validation":
  case
    when Patient.id = 'Varicella21.1' then "Client is not due for varicella vaccination Case 1" and "Guidance" = 'Should not vaccinate client with first varicella dose as client\'s age is less than 12 months. Check for any other vaccines due and inform the caregiver of when to come back for the first varicella dose.'
    when Patient.id = 'Varicella22.3' then "Client is not due for varicella vaccination Case 2" and "Guidance" = 'Should not vaccinate client with first varicella dose as live vaccine was administered in the past 4 weeks. Check for any other vaccines due and inform the caregiver of when to come back for the first varicella dose.'
    when Patient.id = 'Varicella23.3' then "Client is due for varicella vaccination Case 1" and "Guidance" = 'Should vaccinate client with first varicella dose as no varicella dose was administered, client is within appropriate age range and no live vaccine was administered in past 4 weeks. Check for contraindications.'
    when Patient.id = 'Varicella24.2' then "Client is not due for varicella vaccination Case 3" and "Guidance" = 'Should not vaccinate client with second varicella dose as the latest varicella dose was administered less than 4 weeks ago. Check for any other vaccines due and inform the caregiver when to come back for the second dose.'
    when Patient.id = 'Varicella25.3' then "Client is not due for varicella vaccination Case 4" and "Guidance" = 'Should not vaccinate client with second varicella dose as live vaccine was administered in the past 4 weeks. Check for any vaccines due and inform the caregiver of when to come back for the second dose.'
    when Patient.id = 'Varicella26.3' then "Client is due for varicella vaccination Case 2" and "Guidance" = 'Should vaccinate client with second varicella dose as the latest varicella dose was administered more than 4 weeks ago and no live vaccine was administered in past 4 weeks. Check for contraindications.'
    when Patient.id = 'Varicella27.1' then "Varicella immunization schedule is complete" and "Guidance" = 'Varicella immunization schedule is complete. Two varicella primary series doses were administered. Check for any other vaccines due.'
    else 'No test case set'
  end
Content: application/elm+xml
Encoded data (93448 characters)