Release 4B Snapshot 3: Connectathon 32 Base

This page is part of the FHIR Specification (v4.3.0: R4B - STU (v5.0.0-snapshot3: R5 Snapshot #3, to support Connectathon 32 ). The current version which supercedes this version is 5.0.0 . For a full list of available versions, see the Directory of published versions . Page versions: R5 R4B

15.7 Resource ClinicalUseDefinition - Content

Biomedical Research and Regulation icon Work Group Maturity Level : 1 2   Trial Use Security Category : Anonymous Compartments : Not linked to any defined compartments

A single issue - either an indication, contraindication, interaction or an undesirable effect for a medicinal product, medication, device or procedure.

15.7.1 Scope and Usage

For an overview of this resource and others in the Medication Definition domain, also see the module page

ClinicalUseDefinition is to record an instance of facts about a particular medication, device or procedure in relation to its intended use (indication), situations where it should not normally be used (contraindication), known side effects (undesirable effects), clashes with other substances - medications, foods etc. (interactions) and critical information about risks or hazards to caution the user or consumer (warnings). The resource is used to record one such instance, and all its details.

15.7.2 Boundaries and Relationships

The ClinicalUseDefinition resource is designed to represent definitional facts about the potential use of a medication, device or procedure.

These may be used when submitting a product dossier to regulators, as part of an electronic medication or medical device knowledge base, or directly during decision support activities.

The clinical use issue does not refer to any actual instance of the medication, device or procedure being used, or to any actual patient event.

The resource is used to record one instance of one of these:

  • Indication - A medical situation in which a medicinal product, medical device or procedure is appropriate for use
  • Contraindication - A reason why a medicinal product, medical device or procedure is not to be used in a certain context
  • Interaction - The interactions of the medicinal product or medical device with other medicinal products, food, substances etc.
  • Undesirable Effect - A potential negative outcome from the use of a medicinal product, medical device or procedure. See also AdverseEvent, which is for actual events (or near misses), and AllergyIntolerance.
  • Warning – Critical information about the environmental or health or physical risks or hazards, that serve as caution to the user or consumer.
This resource covers a range of closely related concepts that are commonly found along side each other, such as all being on a Patient Information Leaflet (or its electronic representation), submitted as key aspects of a product's dossier, or used together as input to a prescribing decision support system. Cross-workgroup consultation resulted in an original set of separate resources being combined into this single resource, with one typed definition instance per resource.

15.7.3 References to this Resource

This resource is referenced by

15.7.4 Resource Content

Structure

Name icon Flags icon Card. icon Type icon Description & Constraints icon doco icon
. . ClinicalUseDefinition TU DomainResource A single issue - either an indication, contraindication, interaction or an undesirable effect for a medicinal product, medication, device or procedure
+ Rule: Indication, Contraindication, Interaction, UndesirableEffect and Warning cannot be used in the same instance

Elements defined in Ancestors: id , meta , implicitRules , language , text , contained , extension , modifierExtension
. . . identifier Σ 0..* Identifier Business identifier for this issue

. . . type Σ 1..1 code indication | contraindication | interaction | undesirable-effect | warning
ClinicalUseDefinitionType ( Required )
. . . category Σ 0..* CodeableConcept A categorisation of the issue, primarily for dividing warnings into subject heading areas such as "Pregnancy", "Overdose"
ClinicalUseDefinitionCategory ( Preferred )

. . . status Σ 0..1 CodeableConcept Whether this is a current issue or one that has been retired etc
PublicationStatus ( Preferred )
. . . contraindication Σ 0..1 BackboneElement Specifics for when this is a contraindication
. . . . diseaseSymptomProcedure Σ 0..1 CodeableReference ( ObservationDefinition ) The situation that is being documented as contraindicating against this item
DiseaseSymptomProcedure ( Example )
. . . . diseaseStatus Σ 0..1 CodeableReference ( ObservationDefinition ) The status of the disease or symptom for the contraindication
DiseaseStatus ( Example )
. . . . comorbidity Σ 0..* CodeableReference ( ObservationDefinition ) A comorbidity (concurrent condition) or coinfection
DiseaseSymptomProcedure ( Example )

. . . . indication Σ 0..* Reference ( ClinicalUseDefinition ) The indication which this is a contraidication for

. . . . applicability 0..1 Expression An expression that returns true or false, indicating whether the indication is applicable or not, after having applied its other elements
. . . . otherTherapy Σ 0..* BackboneElement Information about use of the product in relation to other therapies described as part of the contraindication

. . . . . relationshipType Σ 1..1 CodeableConcept The type of relationship between the product indication/contraindication and another therapy
TherapyRelationshipType ( Preferred )
. . . . therapy . treatment Σ 1..1 CodeableReference ( MedicinalProductDefinition | Medication | Substance | SubstanceDefinition | ActivityDefinition ) Reference to a specific medication as part of an indication or contraindication
Therapy ( Example )
. . . indication Σ 0..1 BackboneElement Specifics for when this is an indication
. . . . diseaseSymptomProcedure Σ 0..1 CodeableReference ( ObservationDefinition ) The situation that is being documented as an indicaton for this item
DiseaseSymptomProcedure ( Example )
. . . . diseaseStatus Σ 0..1 CodeableReference ( ObservationDefinition ) The status of the disease or symptom for the indication
DiseaseStatus ( Example )
. . . . comorbidity Σ 0..* CodeableReference ( ObservationDefinition ) A comorbidity or coinfection as part of the indication
DiseaseSymptomProcedure ( Example )

. . . . intendedEffect Σ 0..1 CodeableReference ( ObservationDefinition ) The intended effect, aim or strategy to be achieved
ProductIntendedUse ( Preferred )
. . . . duration[x] Σ 0..1 Timing or duration information
. . . . . durationRange Range
. . . . . durationString string
. . . . undesirableEffect Σ 0..* Reference ( ClinicalUseDefinition ) An unwanted side effect or negative outcome of the subject of this resource when being used for this indication

. . . . applicability 0..1 Expression An expression that returns true or false, indicating whether the indication is applicable or not, after having applied its other elements
. . . . otherTherapy Σ 0..* see otherTherapy The use of the medicinal product in relation to other therapies described as part of the indication

. . . interaction Σ 0..1 BackboneElement Specifics for when this is an interaction
. . . . interactant Σ 0..* BackboneElement The specific medication, food, substance or laboratory test that interacts

. . . . . item[x] Σ 1..1 The specific medication, food or laboratory test that interacts
Interactant ( Example )
. . . . . . itemReference Reference ( MedicinalProductDefinition | Medication | Substance | ObservationDefinition )
. . . . . . itemCodeableConcept CodeableConcept
. . . . type Σ 0..1 CodeableConcept The type of the interaction e.g. drug-drug interaction, drug-lab test interaction
InteractionType ( Example )
. . . . effect Σ 0..1 CodeableReference ( ObservationDefinition ) The effect of the interaction, for example "reduced gastric absorption of primary medication"
InteractionEffect ( Example )
. . . . incidence Σ 0..1 CodeableConcept The incidence of the interaction, e.g. theoretical, observed
InteractionIncidence ( Example )
. . . . management Σ 0..* CodeableConcept Actions for managing the interaction
InteractionManagement ( Example )

. . . population Σ 0..* Reference ( Group ) The population group to which this applies

. . . library Σ 0..* canonical ( Library ) Logic used by the clinical use definition

. . . undesirableEffect Σ 0..1 BackboneElement A possible negative outcome from the use of this treatment
. . . . symptomConditionEffect Σ 0..1 CodeableReference ( ObservationDefinition ) The situation in which the undesirable effect may manifest
UndesirableEffectSymptom ( Example )
. . . . classification Σ 0..1 CodeableConcept High level classification of the effect
UndesirableEffectClassification ( Example )
. . . . frequencyOfOccurrence Σ 0..1 CodeableConcept How often the effect is seen
UndesirablEffectFrequency ( Example )
. . . warning Σ 0..1 BackboneElement Critical environmental, health or physical risks or hazards. For example 'Do not operate heavy machinery', 'May cause drowsiness'
. . . . description Σ 0..1 markdown A textual definition of this warning, with formatting
. . . . code Σ 0..1 CodeableConcept A coded or unformatted textual definition of this warning
WarningType ( Example )

doco Documentation for this format icon

See the Extensions for this resource

UML Diagram ( Legend )

ClinicalUseDefinition ( DomainResource ) Business identifier for this issue identifier : Identifier [0..*] indication | contraindication | interaction | undesirable-effect | warning type : code [1..1] « null (Strength=Required) ClinicalUseDefinitionType ! » A categorisation of the issue, primarily for dividing warnings into subject heading areas such as "Pregnancy and Lactation", "Overdose", "Effects on Ability to Drive and Use Machines" category : CodeableConcept [0..*] « null (Strength=Preferred) ClinicalUseDefinitionCategory ? » The medication or procedure for which this is an indication subject : Reference [0..*] « MedicinalProductDefinition | Medication | ActivityDefinition | PlanDefinition | Device | DeviceDefinition | Substance » Whether this is a current issue or one that has been retired etc status : CodeableConcept [0..1] « null (Strength=Preferred) PublicationStatus ? » The population group to which this applies population : Reference [0..*] « Group » Logic used by the clinical use definition library : canonical [0..*] « Library » Contraindication The situation that is being documented as contraindicating against this item diseaseSymptomProcedure : Element CodeableReference [0..1] « ObservationDefinition ; null (Strength=Example) DiseaseSymptomProcedure ?? » The status of the disease or symptom for the contraindication, for example "chronic" or "metastatic" diseaseStatus : Element CodeableReference [0..1] « ObservationDefinition ; null (Strength=Example) DiseaseStatus ?? » A comorbidity (concurrent condition) or coinfection comorbidity : Element CodeableReference [0..*] « ObservationDefinition ; null (Strength=Example) DiseaseSymptomProcedure ?? » The indication which this is a contraidication for indication : Reference [0..*] « ClinicalUseDefinition » An expression that returns true or false, indicating whether the indication is applicable or not, after having applied its other elements applicability : Expression [0..1] OtherTherapy The type of relationship between the medicinal product indication or contraindication and another therapy relationshipType : CodeableConcept [1..1] « null (Strength=Preferred) TherapyRelationshipType ? » Reference to a specific medication (active substance, medicinal product or class of products) as part of an indication or contraindication therapy treatment : Element CodeableReference [1..1] « MedicinalProductDefinition | Medication | Substance | SubstanceDefinition | ActivityDefinition ; null (Strength=Example) Therapy ?? » Indication The situation that is being documented as an indicaton for this item diseaseSymptomProcedure : Element CodeableReference [0..1] « ObservationDefinition ; null (Strength=Example) DiseaseSymptomProcedure ?? » The status of the disease or symptom for the indication, for example "chronic" or "metastatic" diseaseStatus : Element CodeableReference [0..1] « ObservationDefinition ; null (Strength=Example) DiseaseStatus ?? » A comorbidity (concurrent condition) or coinfection as part of the indication comorbidity : Element CodeableReference [0..*] « ObservationDefinition ; null (Strength=Example) DiseaseSymptomProcedure ?? » The intended effect, aim or strategy to be achieved intendedEffect : Element CodeableReference [0..1] « ObservationDefinition ; null (Strength=Preferred) ProductIntendedUse ? » Timing or duration information, that may be associated with use with the indicated condition e.g. Adult patients suffering from myocardial infarction (from a few days until less than 35 days), ischaemic stroke (from 7 days until less than 6 months) duration[x] : Element DataType [0..1] « Range | string » An unwanted side effect or negative outcome that may happen if you use the drug (or other subject of this resource) for this indication undesirableEffect : Reference [0..*] « ClinicalUseDefinition » An expression that returns true or false, indicating whether the indication is applicable or not, after having applied its other elements applicability : Expression [0..1] Interaction The type of the interaction e.g. drug-drug interaction, drug-food interaction, drug-lab test interaction type : CodeableConcept [0..1] « null (Strength=Example) InteractionType ?? » The effect of the interaction, for example "reduced gastric absorption of primary medication" effect : Element CodeableReference [0..1] « ObservationDefinition ; null (Strength=Example) InteractionEffect ?? » The incidence of the interaction, e.g. theoretical, observed incidence : CodeableConcept [0..1] « null (Strength=Example) InteractionIncidence ?? » Actions for managing the interaction management : CodeableConcept [0..*] « null (Strength=Example) InteractionManagement ?? » Interactant The specific medication, food or laboratory test that interacts item[x] : Element DataType [1..1] « Reference ( MedicinalProductDefinition | Medication | Substance | ObservationDefinition )| CodeableConcept ; null (Strength=Example) Interactant ?? » UndesirableEffect The situation in which the undesirable effect may manifest symptomConditionEffect : Element CodeableReference [0..1] « ObservationDefinition ; null (Strength=Example) UndesirableEffectSymptom ?? » High level classification of the effect classification : CodeableConcept [0..1] « null (Strength=Example) UndesirableEffectClassificati... ?? » How often the effect is seen frequencyOfOccurrence : CodeableConcept [0..1] « null (Strength=Example) UndesirablEffectFrequency ?? » Warning A textual definition of this warning, with formatting description : markdown [0..1] A coded or unformatted textual definition of this warning code : CodeableConcept [0..1] « null (Strength=Example) WarningType ?? » Information about the use of the medicinal product in relation to other therapies described as part of the contraindication otherTherapy [0..*] Specifics for when this is a contraindication contraindication [0..1] Information about the use of the medicinal product in relation to other therapies described as part of the indication otherTherapy [0..*] Specifics for when this is an indication indication [0..1] The specific medication, food, substance or laboratory test that interacts interactant [0..*] Specifics for when this is an interaction interaction [0..1] Describe the possible undesirable effects (negative outcomes) from the use of the medicinal product as treatment undesirableEffect [0..1] A critical piece of information about environmental, health or physical risks or hazards that serve as caution to the user. For example 'Do not operate heavy machinery', 'May cause drowsiness', or 'Get medical advice/attention if you feel unwell' warning [0..1]

XML Template 

<ClinicalUseDefinition xmlns="http://hl7.org/fhir"> doco
 <!-- from Resource: id, meta, implicitRules, and language -->
 <!-- from DomainResource: text, contained, extension, and modifierExtension -->
 <identifier><!-- 0..* Identifier Business identifier for this issue --></identifier>
 <type value="[code]"/><!-- 1..1 indication | contraindication | interaction | undesirable-effect | warning -->
 <category><!-- 0..* CodeableConcept A categorisation of the issue, primarily for dividing warnings into subject heading areas such as "Pregnancy", "Overdose" --></category>
 <subject><!-- 0..* Reference(ActivityDefinition|Device|DeviceDefinition|
   Medication|MedicinalProductDefinition|PlanDefinition|Substance) The medication or procedure for which this is an indication --></subject>
 <status><!-- 0..1 CodeableConcept Whether this is a current issue or one that has been retired etc --></status>
 <contraindication>  <!-- 0..1 Specifics for when this is a contraindication -->
  <diseaseSymptomProcedure><!-- 0..1 CodeableReference(ObservationDefinition) The situation that is being documented as contraindicating against this item --></diseaseSymptomProcedure>
  <diseaseStatus><!-- 0..1 CodeableReference(ObservationDefinition) The status of the disease or symptom for the contraindication --></diseaseStatus>
  <comorbidity><!-- 0..* CodeableReference(ObservationDefinition) A comorbidity (concurrent condition) or coinfection --></comorbidity>
  <indication><!-- 0..* Reference(ClinicalUseDefinition) The indication which this is a contraidication for --></indication>
  <applicability><!-- 0..1 Expression An expression that returns true or false, indicating whether the indication is applicable or not, after having applied its other elements --></applicability>

  <otherTherapy>  <!-- 0..* Information about use of the product in relation to other therapies described as part of the contraindication -->
   <relationshipType><!-- 1..1 CodeableConcept The type of relationship between the product indication/contraindication and another therapy --></relationshipType>
   <|
     </therapy>

   <treatment><!-- 1..1 CodeableReference(ActivityDefinition|Medication|
     MedicinalProductDefinition|Substance|SubstanceDefinition) Reference to a specific medication as part of an indication or contraindication --></treatment>
  </otherTherapy>
 </contraindication>
 <indication>  <!-- 0..1 Specifics for when this is an indication -->
  <diseaseSymptomProcedure><!-- 0..1 CodeableReference(ObservationDefinition) The situation that is being documented as an indicaton for this item --></diseaseSymptomProcedure>
  <diseaseStatus><!-- 0..1 CodeableReference(ObservationDefinition) The status of the disease or symptom for the indication --></diseaseStatus>
  <comorbidity><!-- 0..* CodeableReference(ObservationDefinition) A comorbidity or coinfection as part of the indication --></comorbidity>
  <intendedEffect><!-- 0..1 CodeableReference(ObservationDefinition) The intended effect, aim or strategy to be achieved --></intendedEffect>
  <duration[x]><!-- 0..1 Range|string Timing or duration information --></duration[x]>
  <undesirableEffect><!-- 0..* Reference(ClinicalUseDefinition) An unwanted side effect or negative outcome of the subject of this resource when being used for this indication --></undesirableEffect>
  <applicability><!-- 0..1 Expression An expression that returns true or false, indicating whether the indication is applicable or not, after having applied its other elements --></applicability>

  <otherTherapy><!-- 0..* Content as for ClinicalUseDefinition.contraindication.otherTherapy The use of the medicinal product in relation to other therapies described as part of the indication --></otherTherapy>
 </indication>
 <interaction>  <!-- 0..1 Specifics for when this is an interaction -->
  <interactant>  <!-- 0..* The specific medication, food, substance or laboratory test that interacts -->
   <item[x]><!-- 1..1 Reference(Medication|MedicinalProductDefinition|
     ObservationDefinition|Substance)|CodeableConcept The specific medication, food or laboratory test that interacts --></item[x]>
  </interactant>
  <type><!-- 0..1 CodeableConcept The type of the interaction e.g. drug-drug interaction, drug-lab test interaction --></type>
  <effect><!-- 0..1 CodeableReference(ObservationDefinition) The effect of the interaction, for example "reduced gastric absorption of primary medication" --></effect>
  <incidence><!-- 0..1 CodeableConcept The incidence of the interaction, e.g. theoretical, observed --></incidence>
  <management><!-- 0..* CodeableConcept Actions for managing the interaction --></management>
 </interaction>
 <population><!-- 0..* Reference(Group) The population group to which this applies --></population>
 <library><!-- 0..* canonical(Library) Logic used by the clinical use definition --></library>

 <undesirableEffect>  <!-- 0..1 A possible negative outcome from the use of this treatment -->
  <symptomConditionEffect><!-- 0..1 CodeableReference(ObservationDefinition) The situation in which the undesirable effect may manifest --></symptomConditionEffect>
  <classification><!-- 0..1 CodeableConcept High level classification of the effect --></classification>
  <frequencyOfOccurrence><!-- 0..1 CodeableConcept How often the effect is seen --></frequencyOfOccurrence>
 </undesirableEffect>
 <warning>  <!-- 0..1 Critical environmental, health or physical risks or hazards. For example 'Do not operate heavy machinery', 'May cause drowsiness' -->
  <description value="[markdown]"/><!-- 0..1 A textual definition of this warning, with formatting -->
  <code><!-- 0..1 CodeableConcept A coded or unformatted textual definition of this warning --></code>
 </warning>
</ClinicalUseDefinition>

JSON Template 

{doco
  "resourceType" : "ClinicalUseDefinition",
  // from Resource: id, meta, implicitRules, and language
  // from DomainResource: text, contained, extension, and modifierExtension
  "identifier" : [{ Identifier }], // Business identifier for this issue
  "type" : "<code>", // R!  indication | contraindication | interaction | undesirable-effect | warning
  "category" : [{ CodeableConcept }], // A categorisation of the issue, primarily for dividing warnings into subject heading areas such as "Pregnancy", "Overdose"
  "subject" : [{ Reference(ActivityDefinition|Device|DeviceDefinition|
   Medication|MedicinalProductDefinition|PlanDefinition|Substance) }], // The medication or procedure for which this is an indication
  "status" : { CodeableConcept }, // Whether this is a current issue or one that has been retired etc
  "contraindication" : { // Specifics for when this is a contraindication
    "diseaseSymptomProcedure" : { CodeableReference(ObservationDefinition) }, // The situation that is being documented as contraindicating against this item
    "diseaseStatus" : { CodeableReference(ObservationDefinition) }, // The status of the disease or symptom for the contraindication
    "comorbidity" : [{ CodeableReference(ObservationDefinition) }], // A comorbidity (concurrent condition) or coinfection
    "indication" : [{ Reference(ClinicalUseDefinition) }], // The indication which this is a contraidication for
    "applicability" : { Expression }, // An expression that returns true or false, indicating whether the indication is applicable or not, after having applied its other elements

    "otherTherapy" : [{ // Information about use of the product in relation to other therapies described as part of the contraindication
      "relationshipType" : { CodeableConcept }, // R!  The type of relationship between the product indication/contraindication and another therapy
      "|

      "treatment" : { CodeableReference(ActivityDefinition|Medication|

     MedicinalProductDefinition|Substance|SubstanceDefinition) } // R!  Reference to a specific medication as part of an indication or contraindication
    }]
  },
  "indication" : { // Specifics for when this is an indication
    "diseaseSymptomProcedure" : { CodeableReference(ObservationDefinition) }, // The situation that is being documented as an indicaton for this item
    "diseaseStatus" : { CodeableReference(ObservationDefinition) }, // The status of the disease or symptom for the indication
    "comorbidity" : [{ CodeableReference(ObservationDefinition) }], // A comorbidity or coinfection as part of the indication
    "intendedEffect" : { CodeableReference(ObservationDefinition) }, // The intended effect, aim or strategy to be achieved
    // duration[x]: Timing or duration information. One of these 2:
    "durationRange" : { Range },
    "durationString" : "<string>",
    "undesirableEffect" : [{ Reference(ClinicalUseDefinition) }], // An unwanted side effect or negative outcome of the subject of this resource when being used for this indication
    "applicability" : { Expression }, // An expression that returns true or false, indicating whether the indication is applicable or not, after having applied its other elements

    "otherTherapy" : [{ Content as for ClinicalUseDefinition.contraindication.otherTherapy }] // The use of the medicinal product in relation to other therapies described as part of the indication
  },
  "interaction" : { // Specifics for when this is an interaction
    "interactant" : [{ // The specific medication, food, substance or laboratory test that interacts
      // item[x]: The specific medication, food or laboratory test that interacts. One of these 2:
      "itemReference" : { Reference(Medication|MedicinalProductDefinition|
      }

     ObservationDefinition|Substance) },
      "itemCodeableConcept" : { CodeableConcept }
    }],
    "type" : { CodeableConcept }, // The type of the interaction e.g. drug-drug interaction, drug-lab test interaction
    "effect" : { CodeableReference(ObservationDefinition) }, // The effect of the interaction, for example "reduced gastric absorption of primary medication"
    "incidence" : { CodeableConcept }, // The incidence of the interaction, e.g. theoretical, observed
    "management" : [{ CodeableConcept }] // Actions for managing the interaction
  },
  "population" : [{ Reference(Group) }], // The population group to which this applies
  "library" : ["<canonical(Library)>"], // Logic used by the clinical use definition

  "undesirableEffect" : { // A possible negative outcome from the use of this treatment
    "symptomConditionEffect" : { CodeableReference(ObservationDefinition) }, // The situation in which the undesirable effect may manifest
    "classification" : { CodeableConcept }, // High level classification of the effect
    "frequencyOfOccurrence" : { CodeableConcept } // How often the effect is seen
  },
  "warning" : { // Critical environmental, health or physical risks or hazards. For example 'Do not operate heavy machinery', 'May cause drowsiness'
    "description" : "<markdown>", // A textual definition of this warning, with formatting
    "code" : { CodeableConcept } // A coded or unformatted textual definition of this warning
  }
}

Turtle Template 

@prefix fhir: <http://hl7.org/fhir/> .doco


[ a fhir:ClinicalUseDefinition;
  fhir:nodeRole fhir:treeRoot; # if this is the parser root

  # from Resource: .id, .meta, .implicitRules, and .language
  # from DomainResource: .text, .contained, .extension, and .modifierExtension
  fhir:ClinicalUseDefinition.identifier [ Identifier ], ... ; # 0..* Business identifier for this issue
  fhir:ClinicalUseDefinition.type [ code ]; # 1..1 indication | contraindication | interaction | undesirable-effect | warning
  fhir:ClinicalUseDefinition.category [ CodeableConcept ], ... ; # 0..* A categorisation of the issue, primarily for dividing warnings into subject heading areas such as "Pregnancy", "Overdose"
  fhir:ClinicalUseDefinition.subject [ Reference(ActivityDefinition|Device|DeviceDefinition|Medication|MedicinalProductDefinition|
  PlanDefinition|Substance) ], ... ; # 0..* The medication or procedure for which this is an indication
  fhir:ClinicalUseDefinition.status [ CodeableConcept ]; # 0..1 Whether this is a current issue or one that has been retired etc
  fhir:ClinicalUseDefinition.contraindication [ # 0..1 Specifics for when this is a contraindication
    fhir:ClinicalUseDefinition.contraindication.diseaseSymptomProcedure [ CodeableReference(ObservationDefinition) ]; # 0..1 The situation that is being documented as contraindicating against this item
    fhir:ClinicalUseDefinition.contraindication.diseaseStatus [ CodeableReference(ObservationDefinition) ]; # 0..1 The status of the disease or symptom for the contraindication
    fhir:ClinicalUseDefinition.contraindication.comorbidity [ CodeableReference(ObservationDefinition) ], ... ; # 0..* A comorbidity (concurrent condition) or coinfection
    fhir:ClinicalUseDefinition.contraindication.indication [ Reference(ClinicalUseDefinition) ], ... ; # 0..* The indication which this is a contraidication for
    fhir:ClinicalUseDefinition.contraindication.applicability [ Expression ]; # 0..1 An expression that returns true or false, indicating whether the indication is applicable or not, after having applied its other elements

    fhir:ClinicalUseDefinition.contraindication.otherTherapy [ # 0..* Information about use of the product in relation to other therapies described as part of the contraindication
      fhir:ClinicalUseDefinition.contraindication.otherTherapy.relationshipType [ CodeableConcept ]; # 1..1 The type of relationship between the product indication/contraindication and another therapy
      fhir:|

      fhir:ClinicalUseDefinition.contraindication.otherTherapy.treatment [ CodeableReference(ActivityDefinition|Medication|MedicinalProductDefinition|Substance|

  SubstanceDefinition) ]; # 1..1 Reference to a specific medication as part of an indication or contraindication
    ], ...;
  ];
  fhir:ClinicalUseDefinition.indication [ # 0..1 Specifics for when this is an indication
    fhir:ClinicalUseDefinition.indication.diseaseSymptomProcedure [ CodeableReference(ObservationDefinition) ]; # 0..1 The situation that is being documented as an indicaton for this item
    fhir:ClinicalUseDefinition.indication.diseaseStatus [ CodeableReference(ObservationDefinition) ]; # 0..1 The status of the disease or symptom for the indication
    fhir:ClinicalUseDefinition.indication.comorbidity [ CodeableReference(ObservationDefinition) ], ... ; # 0..* A comorbidity or coinfection as part of the indication
    fhir:ClinicalUseDefinition.indication.intendedEffect [ CodeableReference(ObservationDefinition) ]; # 0..1 The intended effect, aim or strategy to be achieved
    # ClinicalUseDefinition.indication.duration[x] : 0..1 Timing or duration information. One of these 2
      fhir:ClinicalUseDefinition.indication.durationRange [ Range ]
      fhir:ClinicalUseDefinition.indication.durationString [ string ]
    fhir:ClinicalUseDefinition.indication.undesirableEffect [ Reference(ClinicalUseDefinition) ], ... ; # 0..* An unwanted side effect or negative outcome of the subject of this resource when being used for this indication
    fhir:ClinicalUseDefinition.indication.applicability [ Expression ]; # 0..1 An expression that returns true or false, indicating whether the indication is applicable or not, after having applied its other elements

    fhir:ClinicalUseDefinition.indication.otherTherapy [ See ClinicalUseDefinition.contraindication.otherTherapy ], ... ; # 0..* The use of the medicinal product in relation to other therapies described as part of the indication
  ];
  fhir:ClinicalUseDefinition.interaction [ # 0..1 Specifics for when this is an interaction
    fhir:ClinicalUseDefinition.interaction.interactant [ # 0..* The specific medication, food, substance or laboratory test that interacts
      # ClinicalUseDefinition.interaction.interactant.item[x] : 1..1 The specific medication, food or laboratory test that interacts. One of these 2
        fhir:ClinicalUseDefinition.interaction.interactant.itemReference [ Reference(Medication|MedicinalProductDefinition|ObservationDefinition|Substance) ]
        fhir:ClinicalUseDefinition.interaction.interactant.itemCodeableConcept [ CodeableConcept ]
    ], ...;
    fhir:ClinicalUseDefinition.interaction.type [ CodeableConcept ]; # 0..1 The type of the interaction e.g. drug-drug interaction, drug-lab test interaction
    fhir:ClinicalUseDefinition.interaction.effect [ CodeableReference(ObservationDefinition) ]; # 0..1 The effect of the interaction, for example "reduced gastric absorption of primary medication"
    fhir:ClinicalUseDefinition.interaction.incidence [ CodeableConcept ]; # 0..1 The incidence of the interaction, e.g. theoretical, observed
    fhir:ClinicalUseDefinition.interaction.management [ CodeableConcept ], ... ; # 0..* Actions for managing the interaction
  ];
  fhir:ClinicalUseDefinition.population [ Reference(Group) ], ... ; # 0..* The population group to which this applies
  fhir:ClinicalUseDefinition.library [ canonical(Library) ], ... ; # 0..* Logic used by the clinical use definition

  fhir:ClinicalUseDefinition.undesirableEffect [ # 0..1 A possible negative outcome from the use of this treatment
    fhir:ClinicalUseDefinition.undesirableEffect.symptomConditionEffect [ CodeableReference(ObservationDefinition) ]; # 0..1 The situation in which the undesirable effect may manifest
    fhir:ClinicalUseDefinition.undesirableEffect.classification [ CodeableConcept ]; # 0..1 High level classification of the effect
    fhir:ClinicalUseDefinition.undesirableEffect.frequencyOfOccurrence [ CodeableConcept ]; # 0..1 How often the effect is seen
  ];
  fhir:ClinicalUseDefinition.warning [ # 0..1 Critical environmental, health or physical risks or hazards. For example 'Do not operate heavy machinery', 'May cause drowsiness'
    fhir:ClinicalUseDefinition.warning.description [ markdown ]; # 0..1 A textual definition of this warning, with formatting
    fhir:ClinicalUseDefinition.warning.code [ CodeableConcept ]; # 0..1 A coded or unformatted textual definition of this warning
  ];
]

Changes since R4

This resource did not exist in Release 3

This analysis is available as XML or JSON .

Conversions between R3 and R4

Structure

Name icon Flags icon Card. icon Type icon Description & Constraints icon doco icon
. . ClinicalUseDefinition TU DomainResource A single issue - either an indication, contraindication, interaction or an undesirable effect for a medicinal product, medication, device or procedure
+ Rule: Indication, Contraindication, Interaction, UndesirableEffect and Warning cannot be used in the same instance

Elements defined in Ancestors: id , meta , implicitRules , language , text , contained , extension , modifierExtension
. . . identifier Σ 0..* Identifier Business identifier for this issue

. . . type Σ 1..1 code indication | contraindication | interaction | undesirable-effect | warning
ClinicalUseDefinitionType ( Required )
. . . category Σ 0..* CodeableConcept A categorisation of the issue, primarily for dividing warnings into subject heading areas such as "Pregnancy", "Overdose"
ClinicalUseDefinitionCategory ( Preferred )

. . . status Σ 0..1 CodeableConcept Whether this is a current issue or one that has been retired etc
PublicationStatus ( Preferred )
. . . contraindication Σ 0..1 BackboneElement Specifics for when this is a contraindication
. . . . diseaseSymptomProcedure Σ 0..1 CodeableReference ( ObservationDefinition ) The situation that is being documented as contraindicating against this item
DiseaseSymptomProcedure ( Example )
. . . . diseaseStatus Σ 0..1 CodeableReference ( ObservationDefinition ) The status of the disease or symptom for the contraindication
DiseaseStatus ( Example )
. . . . comorbidity Σ 0..* CodeableReference ( ObservationDefinition ) A comorbidity (concurrent condition) or coinfection
DiseaseSymptomProcedure ( Example )

. . . . indication Σ 0..* Reference ( ClinicalUseDefinition ) The indication which this is a contraidication for

. . . . applicability 0..1 Expression An expression that returns true or false, indicating whether the indication is applicable or not, after having applied its other elements
. . . . otherTherapy Σ 0..* BackboneElement Information about use of the product in relation to other therapies described as part of the contraindication

. . . . . relationshipType Σ 1..1 CodeableConcept The type of relationship between the product indication/contraindication and another therapy
TherapyRelationshipType ( Preferred )
. . . . therapy . treatment Σ 1..1 CodeableReference ( MedicinalProductDefinition | Medication | Substance | SubstanceDefinition | ActivityDefinition ) Reference to a specific medication as part of an indication or contraindication
Therapy ( Example )
. . . indication Σ 0..1 BackboneElement Specifics for when this is an indication
. . . . diseaseSymptomProcedure Σ 0..1 CodeableReference ( ObservationDefinition ) The situation that is being documented as an indicaton for this item
DiseaseSymptomProcedure ( Example )
. . . . diseaseStatus Σ 0..1 CodeableReference ( ObservationDefinition ) The status of the disease or symptom for the indication
DiseaseStatus ( Example )
. . . . comorbidity Σ 0..* CodeableReference ( ObservationDefinition ) A comorbidity or coinfection as part of the indication
DiseaseSymptomProcedure ( Example )

. . . . intendedEffect Σ 0..1 CodeableReference ( ObservationDefinition ) The intended effect, aim or strategy to be achieved
ProductIntendedUse ( Preferred )
. . . . duration[x] Σ 0..1 Timing or duration information
. . . . . durationRange Range
. . . . . durationString string
. . . . undesirableEffect Σ 0..* Reference ( ClinicalUseDefinition ) An unwanted side effect or negative outcome of the subject of this resource when being used for this indication

. . . . applicability 0..1 Expression An expression that returns true or false, indicating whether the indication is applicable or not, after having applied its other elements
. . . . otherTherapy Σ 0..* see otherTherapy The use of the medicinal product in relation to other therapies described as part of the indication

. . . interaction Σ 0..1 BackboneElement Specifics for when this is an interaction
. . . . interactant Σ 0..* BackboneElement The specific medication, food, substance or laboratory test that interacts

. . . . . item[x] Σ 1..1 The specific medication, food or laboratory test that interacts
Interactant ( Example )
. . . . . . itemReference Reference ( MedicinalProductDefinition | Medication | Substance | ObservationDefinition )
. . . . . . itemCodeableConcept CodeableConcept
. . . . type Σ 0..1 CodeableConcept The type of the interaction e.g. drug-drug interaction, drug-lab test interaction
InteractionType ( Example )
. . . . effect Σ 0..1 CodeableReference ( ObservationDefinition ) The effect of the interaction, for example "reduced gastric absorption of primary medication"
InteractionEffect ( Example )
. . . . incidence Σ 0..1 CodeableConcept The incidence of the interaction, e.g. theoretical, observed
InteractionIncidence ( Example )
. . . . management Σ 0..* CodeableConcept Actions for managing the interaction
InteractionManagement ( Example )

. . . population Σ 0..* Reference ( Group ) The population group to which this applies

. . . library Σ 0..* canonical ( Library ) Logic used by the clinical use definition

. . . undesirableEffect Σ 0..1 BackboneElement A possible negative outcome from the use of this treatment
. . . . symptomConditionEffect Σ 0..1 CodeableReference ( ObservationDefinition ) The situation in which the undesirable effect may manifest
UndesirableEffectSymptom ( Example )
. . . . classification Σ 0..1 CodeableConcept High level classification of the effect
UndesirableEffectClassification ( Example )
. . . . frequencyOfOccurrence Σ 0..1 CodeableConcept How often the effect is seen
UndesirablEffectFrequency ( Example )
. . . warning Σ 0..1 BackboneElement Critical environmental, health or physical risks or hazards. For example 'Do not operate heavy machinery', 'May cause drowsiness'
. . . . description Σ 0..1 markdown A textual definition of this warning, with formatting
. . . . code Σ 0..1 CodeableConcept A coded or unformatted textual definition of this warning
WarningType ( Example )

doco Documentation for this format icon

See the Extensions for this resource

UML Diagram ( Legend )

ClinicalUseDefinition ( DomainResource ) Business identifier for this issue identifier : Identifier [0..*] indication | contraindication | interaction | undesirable-effect | warning type : code [1..1] « null (Strength=Required) ClinicalUseDefinitionType ! » A categorisation of the issue, primarily for dividing warnings into subject heading areas such as "Pregnancy and Lactation", "Overdose", "Effects on Ability to Drive and Use Machines" category : CodeableConcept [0..*] « null (Strength=Preferred) ClinicalUseDefinitionCategory ? » The medication or procedure for which this is an indication subject : Reference [0..*] « MedicinalProductDefinition | Medication | ActivityDefinition | PlanDefinition | Device | DeviceDefinition | Substance » Whether this is a current issue or one that has been retired etc status : CodeableConcept [0..1] « null (Strength=Preferred) PublicationStatus ? » The population group to which this applies population : Reference [0..*] « Group » Logic used by the clinical use definition library : canonical [0..*] « Library » Contraindication The situation that is being documented as contraindicating against this item diseaseSymptomProcedure : Element CodeableReference [0..1] « ObservationDefinition ; null (Strength=Example) DiseaseSymptomProcedure ?? » The status of the disease or symptom for the contraindication, for example "chronic" or "metastatic" diseaseStatus : Element CodeableReference [0..1] « ObservationDefinition ; null (Strength=Example) DiseaseStatus ?? » A comorbidity (concurrent condition) or coinfection comorbidity : Element CodeableReference [0..*] « ObservationDefinition ; null (Strength=Example) DiseaseSymptomProcedure ?? » The indication which this is a contraidication for indication : Reference [0..*] « ClinicalUseDefinition » An expression that returns true or false, indicating whether the indication is applicable or not, after having applied its other elements applicability : Expression [0..1] OtherTherapy The type of relationship between the medicinal product indication or contraindication and another therapy relationshipType : CodeableConcept [1..1] « null (Strength=Preferred) TherapyRelationshipType ? » Reference to a specific medication (active substance, medicinal product or class of products) as part of an indication or contraindication therapy treatment : Element CodeableReference [1..1] « MedicinalProductDefinition | Medication | Substance | SubstanceDefinition | ActivityDefinition ; null (Strength=Example) Therapy ?? » Indication The situation that is being documented as an indicaton for this item diseaseSymptomProcedure : Element CodeableReference [0..1] « ObservationDefinition ; null (Strength=Example) DiseaseSymptomProcedure ?? » The status of the disease or symptom for the indication, for example "chronic" or "metastatic" diseaseStatus : Element CodeableReference [0..1] « ObservationDefinition ; null (Strength=Example) DiseaseStatus ?? » A comorbidity (concurrent condition) or coinfection as part of the indication comorbidity : Element CodeableReference [0..*] « ObservationDefinition ; null (Strength=Example) DiseaseSymptomProcedure ?? » The intended effect, aim or strategy to be achieved intendedEffect : Element CodeableReference [0..1] « ObservationDefinition ; null (Strength=Preferred) ProductIntendedUse ? » Timing or duration information, that may be associated with use with the indicated condition e.g. Adult patients suffering from myocardial infarction (from a few days until less than 35 days), ischaemic stroke (from 7 days until less than 6 months) duration[x] : Element DataType [0..1] « Range | string » An unwanted side effect or negative outcome that may happen if you use the drug (or other subject of this resource) for this indication undesirableEffect : Reference [0..*] « ClinicalUseDefinition » An expression that returns true or false, indicating whether the indication is applicable or not, after having applied its other elements applicability : Expression [0..1] Interaction The type of the interaction e.g. drug-drug interaction, drug-food interaction, drug-lab test interaction type : CodeableConcept [0..1] « null (Strength=Example) InteractionType ?? » The effect of the interaction, for example "reduced gastric absorption of primary medication" effect : Element CodeableReference [0..1] « ObservationDefinition ; null (Strength=Example) InteractionEffect ?? » The incidence of the interaction, e.g. theoretical, observed incidence : CodeableConcept [0..1] « null (Strength=Example) InteractionIncidence ?? » Actions for managing the interaction management : CodeableConcept [0..*] « null (Strength=Example) InteractionManagement ?? » Interactant The specific medication, food or laboratory test that interacts item[x] : Element DataType [1..1] « Reference ( MedicinalProductDefinition | Medication | Substance | ObservationDefinition )| CodeableConcept ; null (Strength=Example) Interactant ?? » UndesirableEffect The situation in which the undesirable effect may manifest symptomConditionEffect : Element CodeableReference [0..1] « ObservationDefinition ; null (Strength=Example) UndesirableEffectSymptom ?? » High level classification of the effect classification : CodeableConcept [0..1] « null (Strength=Example) UndesirableEffectClassificati... ?? » How often the effect is seen frequencyOfOccurrence : CodeableConcept [0..1] « null (Strength=Example) UndesirablEffectFrequency ?? » Warning A textual definition of this warning, with formatting description : markdown [0..1] A coded or unformatted textual definition of this warning code : CodeableConcept [0..1] « null (Strength=Example) WarningType ?? » Information about the use of the medicinal product in relation to other therapies described as part of the contraindication otherTherapy [0..*] Specifics for when this is a contraindication contraindication [0..1] Information about the use of the medicinal product in relation to other therapies described as part of the indication otherTherapy [0..*] Specifics for when this is an indication indication [0..1] The specific medication, food, substance or laboratory test that interacts interactant [0..*] Specifics for when this is an interaction interaction [0..1] Describe the possible undesirable effects (negative outcomes) from the use of the medicinal product as treatment undesirableEffect [0..1] A critical piece of information about environmental, health or physical risks or hazards that serve as caution to the user. For example 'Do not operate heavy machinery', 'May cause drowsiness', or 'Get medical advice/attention if you feel unwell' warning [0..1]

XML Template 

<ClinicalUseDefinition xmlns="http://hl7.org/fhir"> doco
 <!-- from Resource: id, meta, implicitRules, and language -->
 <!-- from DomainResource: text, contained, extension, and modifierExtension -->
 <identifier><!-- 0..* Identifier Business identifier for this issue --></identifier>
 <type value="[code]"/><!-- 1..1 indication | contraindication | interaction | undesirable-effect | warning -->
 <category><!-- 0..* CodeableConcept A categorisation of the issue, primarily for dividing warnings into subject heading areas such as "Pregnancy", "Overdose" --></category>
 <subject><!-- 0..* Reference(ActivityDefinition|Device|DeviceDefinition|
   Medication|MedicinalProductDefinition|PlanDefinition|Substance) The medication or procedure for which this is an indication --></subject>
 <status><!-- 0..1 CodeableConcept Whether this is a current issue or one that has been retired etc --></status>
 <contraindication>  <!-- 0..1 Specifics for when this is a contraindication -->
  <diseaseSymptomProcedure><!-- 0..1 CodeableReference(ObservationDefinition) The situation that is being documented as contraindicating against this item --></diseaseSymptomProcedure>
  <diseaseStatus><!-- 0..1 CodeableReference(ObservationDefinition) The status of the disease or symptom for the contraindication --></diseaseStatus>
  <comorbidity><!-- 0..* CodeableReference(ObservationDefinition) A comorbidity (concurrent condition) or coinfection --></comorbidity>
  <indication><!-- 0..* Reference(ClinicalUseDefinition) The indication which this is a contraidication for --></indication>
  <applicability><!-- 0..1 Expression An expression that returns true or false, indicating whether the indication is applicable or not, after having applied its other elements --></applicability>

  <otherTherapy>  <!-- 0..* Information about use of the product in relation to other therapies described as part of the contraindication -->
   <relationshipType><!-- 1..1 CodeableConcept The type of relationship between the product indication/contraindication and another therapy --></relationshipType>
   <|
     </therapy>

   <treatment><!-- 1..1 CodeableReference(ActivityDefinition|Medication|
     MedicinalProductDefinition|Substance|SubstanceDefinition) Reference to a specific medication as part of an indication or contraindication --></treatment>
  </otherTherapy>
 </contraindication>
 <indication>  <!-- 0..1 Specifics for when this is an indication -->
  <diseaseSymptomProcedure><!-- 0..1 CodeableReference(ObservationDefinition) The situation that is being documented as an indicaton for this item --></diseaseSymptomProcedure>
  <diseaseStatus><!-- 0..1 CodeableReference(ObservationDefinition) The status of the disease or symptom for the indication --></diseaseStatus>
  <comorbidity><!-- 0..* CodeableReference(ObservationDefinition) A comorbidity or coinfection as part of the indication --></comorbidity>
  <intendedEffect><!-- 0..1 CodeableReference(ObservationDefinition) The intended effect, aim or strategy to be achieved --></intendedEffect>
  <duration[x]><!-- 0..1 Range|string Timing or duration information --></duration[x]>
  <undesirableEffect><!-- 0..* Reference(ClinicalUseDefinition) An unwanted side effect or negative outcome of the subject of this resource when being used for this indication --></undesirableEffect>
  <applicability><!-- 0..1 Expression An expression that returns true or false, indicating whether the indication is applicable or not, after having applied its other elements --></applicability>

  <otherTherapy><!-- 0..* Content as for ClinicalUseDefinition.contraindication.otherTherapy The use of the medicinal product in relation to other therapies described as part of the indication --></otherTherapy>
 </indication>
 <interaction>  <!-- 0..1 Specifics for when this is an interaction -->
  <interactant>  <!-- 0..* The specific medication, food, substance or laboratory test that interacts -->
   <item[x]><!-- 1..1 Reference(Medication|MedicinalProductDefinition|
     ObservationDefinition|Substance)|CodeableConcept The specific medication, food or laboratory test that interacts --></item[x]>
  </interactant>
  <type><!-- 0..1 CodeableConcept The type of the interaction e.g. drug-drug interaction, drug-lab test interaction --></type>
  <effect><!-- 0..1 CodeableReference(ObservationDefinition) The effect of the interaction, for example "reduced gastric absorption of primary medication" --></effect>
  <incidence><!-- 0..1 CodeableConcept The incidence of the interaction, e.g. theoretical, observed --></incidence>
  <management><!-- 0..* CodeableConcept Actions for managing the interaction --></management>
 </interaction>
 <population><!-- 0..* Reference(Group) The population group to which this applies --></population>
 <library><!-- 0..* canonical(Library) Logic used by the clinical use definition --></library>

 <undesirableEffect>  <!-- 0..1 A possible negative outcome from the use of this treatment -->
  <symptomConditionEffect><!-- 0..1 CodeableReference(ObservationDefinition) The situation in which the undesirable effect may manifest --></symptomConditionEffect>
  <classification><!-- 0..1 CodeableConcept High level classification of the effect --></classification>
  <frequencyOfOccurrence><!-- 0..1 CodeableConcept How often the effect is seen --></frequencyOfOccurrence>
 </undesirableEffect>
 <warning>  <!-- 0..1 Critical environmental, health or physical risks or hazards. For example 'Do not operate heavy machinery', 'May cause drowsiness' -->
  <description value="[markdown]"/><!-- 0..1 A textual definition of this warning, with formatting -->
  <code><!-- 0..1 CodeableConcept A coded or unformatted textual definition of this warning --></code>
 </warning>
</ClinicalUseDefinition>

JSON Template 

{doco
  "resourceType" : "ClinicalUseDefinition",
  // from Resource: id, meta, implicitRules, and language
  // from DomainResource: text, contained, extension, and modifierExtension
  "identifier" : [{ Identifier }], // Business identifier for this issue
  "type" : "<code>", // R!  indication | contraindication | interaction | undesirable-effect | warning
  "category" : [{ CodeableConcept }], // A categorisation of the issue, primarily for dividing warnings into subject heading areas such as "Pregnancy", "Overdose"
  "subject" : [{ Reference(ActivityDefinition|Device|DeviceDefinition|
   Medication|MedicinalProductDefinition|PlanDefinition|Substance) }], // The medication or procedure for which this is an indication
  "status" : { CodeableConcept }, // Whether this is a current issue or one that has been retired etc
  "contraindication" : { // Specifics for when this is a contraindication
    "diseaseSymptomProcedure" : { CodeableReference(ObservationDefinition) }, // The situation that is being documented as contraindicating against this item
    "diseaseStatus" : { CodeableReference(ObservationDefinition) }, // The status of the disease or symptom for the contraindication
    "comorbidity" : [{ CodeableReference(ObservationDefinition) }], // A comorbidity (concurrent condition) or coinfection
    "indication" : [{ Reference(ClinicalUseDefinition) }], // The indication which this is a contraidication for
    "applicability" : { Expression }, // An expression that returns true or false, indicating whether the indication is applicable or not, after having applied its other elements

    "otherTherapy" : [{ // Information about use of the product in relation to other therapies described as part of the contraindication
      "relationshipType" : { CodeableConcept }, // R!  The type of relationship between the product indication/contraindication and another therapy
      "|

      "treatment" : { CodeableReference(ActivityDefinition|Medication|

     MedicinalProductDefinition|Substance|SubstanceDefinition) } // R!  Reference to a specific medication as part of an indication or contraindication
    }]
  },
  "indication" : { // Specifics for when this is an indication
    "diseaseSymptomProcedure" : { CodeableReference(ObservationDefinition) }, // The situation that is being documented as an indicaton for this item
    "diseaseStatus" : { CodeableReference(ObservationDefinition) }, // The status of the disease or symptom for the indication
    "comorbidity" : [{ CodeableReference(ObservationDefinition) }], // A comorbidity or coinfection as part of the indication
    "intendedEffect" : { CodeableReference(ObservationDefinition) }, // The intended effect, aim or strategy to be achieved
    // duration[x]: Timing or duration information. One of these 2:
    "durationRange" : { Range },
    "durationString" : "<string>",
    "undesirableEffect" : [{ Reference(ClinicalUseDefinition) }], // An unwanted side effect or negative outcome of the subject of this resource when being used for this indication
    "applicability" : { Expression }, // An expression that returns true or false, indicating whether the indication is applicable or not, after having applied its other elements

    "otherTherapy" : [{ Content as for ClinicalUseDefinition.contraindication.otherTherapy }] // The use of the medicinal product in relation to other therapies described as part of the indication
  },
  "interaction" : { // Specifics for when this is an interaction
    "interactant" : [{ // The specific medication, food, substance or laboratory test that interacts
      // item[x]: The specific medication, food or laboratory test that interacts. One of these 2:
      "itemReference" : { Reference(Medication|MedicinalProductDefinition|
      }

     ObservationDefinition|Substance) },
      "itemCodeableConcept" : { CodeableConcept }
    }],
    "type" : { CodeableConcept }, // The type of the interaction e.g. drug-drug interaction, drug-lab test interaction
    "effect" : { CodeableReference(ObservationDefinition) }, // The effect of the interaction, for example "reduced gastric absorption of primary medication"
    "incidence" : { CodeableConcept }, // The incidence of the interaction, e.g. theoretical, observed
    "management" : [{ CodeableConcept }] // Actions for managing the interaction
  },
  "population" : [{ Reference(Group) }], // The population group to which this applies
  "library" : ["<canonical(Library)>"], // Logic used by the clinical use definition

  "undesirableEffect" : { // A possible negative outcome from the use of this treatment
    "symptomConditionEffect" : { CodeableReference(ObservationDefinition) }, // The situation in which the undesirable effect may manifest
    "classification" : { CodeableConcept }, // High level classification of the effect
    "frequencyOfOccurrence" : { CodeableConcept } // How often the effect is seen
  },
  "warning" : { // Critical environmental, health or physical risks or hazards. For example 'Do not operate heavy machinery', 'May cause drowsiness'
    "description" : "<markdown>", // A textual definition of this warning, with formatting
    "code" : { CodeableConcept } // A coded or unformatted textual definition of this warning
  }
}

Turtle Template 

@prefix fhir: <http://hl7.org/fhir/> .doco


[ a fhir:ClinicalUseDefinition;
  fhir:nodeRole fhir:treeRoot; # if this is the parser root

  # from Resource: .id, .meta, .implicitRules, and .language
  # from DomainResource: .text, .contained, .extension, and .modifierExtension
  fhir:ClinicalUseDefinition.identifier [ Identifier ], ... ; # 0..* Business identifier for this issue
  fhir:ClinicalUseDefinition.type [ code ]; # 1..1 indication | contraindication | interaction | undesirable-effect | warning
  fhir:ClinicalUseDefinition.category [ CodeableConcept ], ... ; # 0..* A categorisation of the issue, primarily for dividing warnings into subject heading areas such as "Pregnancy", "Overdose"
  fhir:ClinicalUseDefinition.subject [ Reference(ActivityDefinition|Device|DeviceDefinition|Medication|MedicinalProductDefinition|
  PlanDefinition|Substance) ], ... ; # 0..* The medication or procedure for which this is an indication
  fhir:ClinicalUseDefinition.status [ CodeableConcept ]; # 0..1 Whether this is a current issue or one that has been retired etc
  fhir:ClinicalUseDefinition.contraindication [ # 0..1 Specifics for when this is a contraindication
    fhir:ClinicalUseDefinition.contraindication.diseaseSymptomProcedure [ CodeableReference(ObservationDefinition) ]; # 0..1 The situation that is being documented as contraindicating against this item
    fhir:ClinicalUseDefinition.contraindication.diseaseStatus [ CodeableReference(ObservationDefinition) ]; # 0..1 The status of the disease or symptom for the contraindication
    fhir:ClinicalUseDefinition.contraindication.comorbidity [ CodeableReference(ObservationDefinition) ], ... ; # 0..* A comorbidity (concurrent condition) or coinfection
    fhir:ClinicalUseDefinition.contraindication.indication [ Reference(ClinicalUseDefinition) ], ... ; # 0..* The indication which this is a contraidication for
    fhir:ClinicalUseDefinition.contraindication.applicability [ Expression ]; # 0..1 An expression that returns true or false, indicating whether the indication is applicable or not, after having applied its other elements

    fhir:ClinicalUseDefinition.contraindication.otherTherapy [ # 0..* Information about use of the product in relation to other therapies described as part of the contraindication
      fhir:ClinicalUseDefinition.contraindication.otherTherapy.relationshipType [ CodeableConcept ]; # 1..1 The type of relationship between the product indication/contraindication and another therapy
      fhir:|

      fhir:ClinicalUseDefinition.contraindication.otherTherapy.treatment [ CodeableReference(ActivityDefinition|Medication|MedicinalProductDefinition|Substance|

  SubstanceDefinition) ]; # 1..1 Reference to a specific medication as part of an indication or contraindication
    ], ...;
  ];
  fhir:ClinicalUseDefinition.indication [ # 0..1 Specifics for when this is an indication
    fhir:ClinicalUseDefinition.indication.diseaseSymptomProcedure [ CodeableReference(ObservationDefinition) ]; # 0..1 The situation that is being documented as an indicaton for this item
    fhir:ClinicalUseDefinition.indication.diseaseStatus [ CodeableReference(ObservationDefinition) ]; # 0..1 The status of the disease or symptom for the indication
    fhir:ClinicalUseDefinition.indication.comorbidity [ CodeableReference(ObservationDefinition) ], ... ; # 0..* A comorbidity or coinfection as part of the indication
    fhir:ClinicalUseDefinition.indication.intendedEffect [ CodeableReference(ObservationDefinition) ]; # 0..1 The intended effect, aim or strategy to be achieved
    # ClinicalUseDefinition.indication.duration[x] : 0..1 Timing or duration information. One of these 2
      fhir:ClinicalUseDefinition.indication.durationRange [ Range ]
      fhir:ClinicalUseDefinition.indication.durationString [ string ]
    fhir:ClinicalUseDefinition.indication.undesirableEffect [ Reference(ClinicalUseDefinition) ], ... ; # 0..* An unwanted side effect or negative outcome of the subject of this resource when being used for this indication
    fhir:ClinicalUseDefinition.indication.applicability [ Expression ]; # 0..1 An expression that returns true or false, indicating whether the indication is applicable or not, after having applied its other elements

    fhir:ClinicalUseDefinition.indication.otherTherapy [ See ClinicalUseDefinition.contraindication.otherTherapy ], ... ; # 0..* The use of the medicinal product in relation to other therapies described as part of the indication
  ];
  fhir:ClinicalUseDefinition.interaction [ # 0..1 Specifics for when this is an interaction
    fhir:ClinicalUseDefinition.interaction.interactant [ # 0..* The specific medication, food, substance or laboratory test that interacts
      # ClinicalUseDefinition.interaction.interactant.item[x] : 1..1 The specific medication, food or laboratory test that interacts. One of these 2
        fhir:ClinicalUseDefinition.interaction.interactant.itemReference [ Reference(Medication|MedicinalProductDefinition|ObservationDefinition|Substance) ]
        fhir:ClinicalUseDefinition.interaction.interactant.itemCodeableConcept [ CodeableConcept ]
    ], ...;
    fhir:ClinicalUseDefinition.interaction.type [ CodeableConcept ]; # 0..1 The type of the interaction e.g. drug-drug interaction, drug-lab test interaction
    fhir:ClinicalUseDefinition.interaction.effect [ CodeableReference(ObservationDefinition) ]; # 0..1 The effect of the interaction, for example "reduced gastric absorption of primary medication"
    fhir:ClinicalUseDefinition.interaction.incidence [ CodeableConcept ]; # 0..1 The incidence of the interaction, e.g. theoretical, observed
    fhir:ClinicalUseDefinition.interaction.management [ CodeableConcept ], ... ; # 0..* Actions for managing the interaction
  ];
  fhir:ClinicalUseDefinition.population [ Reference(Group) ], ... ; # 0..* The population group to which this applies
  fhir:ClinicalUseDefinition.library [ canonical(Library) ], ... ; # 0..* Logic used by the clinical use definition

  fhir:ClinicalUseDefinition.undesirableEffect [ # 0..1 A possible negative outcome from the use of this treatment
    fhir:ClinicalUseDefinition.undesirableEffect.symptomConditionEffect [ CodeableReference(ObservationDefinition) ]; # 0..1 The situation in which the undesirable effect may manifest
    fhir:ClinicalUseDefinition.undesirableEffect.classification [ CodeableConcept ]; # 0..1 High level classification of the effect
    fhir:ClinicalUseDefinition.undesirableEffect.frequencyOfOccurrence [ CodeableConcept ]; # 0..1 How often the effect is seen
  ];
  fhir:ClinicalUseDefinition.warning [ # 0..1 Critical environmental, health or physical risks or hazards. For example 'Do not operate heavy machinery', 'May cause drowsiness'
    fhir:ClinicalUseDefinition.warning.description [ markdown ]; # 0..1 A textual definition of this warning, with formatting
    fhir:ClinicalUseDefinition.warning.code [ CodeableConcept ]; # 0..1 A coded or unformatted textual definition of this warning
  ];
]

Changes since Release 4

This resource did not exist in Release 3

This analysis is available as XML or JSON .

Conversions between R3 and R4

 

See the Profiles & Extensions and the alternate Additional definitions: Master Definition XML + JSON , XML Schema / Schematron + JSON Schema , ShEx (for Turtle ) + see the extensions , the spreadsheet version & the dependency analysis

15.7.4.1 Terminology Bindings

Path Definition Type Reference
ClinicalUseDefinition.type

Overall defining type of this clinical use definition.

Required ClinicalUseDefinitionType
ClinicalUseDefinition.category

A categorisation for a clinical use information item.

Preferred ClinicalUseDefinitionCategory
ClinicalUseDefinition.status

The lifecycle status of an artifact.

Preferred PublicationStatus
ClinicalUseDefinition.contraindication.diseaseSymptomProcedure

A symptom, disease or procedure.

Example DiseaseSymptomProcedure
ClinicalUseDefinition.contraindication.diseaseStatus

The status of a disease or symptom.

Example DiseaseStatus
ClinicalUseDefinition.contraindication.comorbidity

A symptom, disease or procedure.

Example DiseaseSymptomProcedure
ClinicalUseDefinition.contraindication.otherTherapy.relationshipType

Classification of relationship between a therapy and a contraindication or an indication.

Preferred TherapyRelationshipType
ClinicalUseDefinition.contraindication.otherTherapy.therapy ClinicalUseDefinition.contraindication.otherTherapy.treatment

A therapy.

Example Therapy
ClinicalUseDefinition.indication.diseaseSymptomProcedure

A symptom, disease or procedure.

Example DiseaseSymptomProcedure
ClinicalUseDefinition.indication.diseaseStatus

The status of a disease or symptom.

Example DiseaseStatus
ClinicalUseDefinition.indication.comorbidity

A symptom, disease or procedure.

Example DiseaseSymptomProcedure
ClinicalUseDefinition.indication.intendedEffect

The overall intended use of a product.

Preferred ProductIntendedUse
ClinicalUseDefinition.interaction.interactant.item[x]

An interactant - a substance that may have an clinically significant effect on another.

Example Interactant
ClinicalUseDefinition.interaction.type

A categorisation for an interaction between two substances.

Example InteractionType
ClinicalUseDefinition.interaction.effect

A interaction effect of clinical use of a medication or other substance.

Example InteractionEffect
ClinicalUseDefinition.interaction.incidence

A categorisation for incidence of occurence of an interaction.

Example InteractionIncidence
ClinicalUseDefinition.interaction.management

A type of management for an interaction of a medication or other substance.

Example InteractionManagement
ClinicalUseDefinition.undesirableEffect.symptomConditionEffect

An undesirable effect of clinical use.

Example UndesirableEffectSymptom
ClinicalUseDefinition.undesirableEffect.classification

A categorisation for an undesirable effect.

Example UndesirableEffectClassification
ClinicalUseDefinition.undesirableEffect.frequencyOfOccurrence

A categorisation for a frequency of occurence of an undesirable effect.

Example UndesirablEffectFrequency
ClinicalUseDefinition.warning.code

Classification of warning type.

Example WarningType

15.7.4.2 Constraints

id UniqueKey Level Location Description Expression
cud-1 img  cud-1 Rule (base) Indication, Contraindication, Interaction, UndesirableEffect and Warning cannot be used in the same instance (ClinicalUseDefinition.indication.count() + ClinicalUseDefinition.contraindication.count() + ClinicalUseDefinition.interaction.count() + ClinicalUseDefinition.undesirableEffect.count() + ClinicalUseDefinition.warning.count()) < 2

15.7.5 Search Parameters

Search parameters for this resource. The common parameters also apply. See Searching for more information about searching in REST, messaging, and services.

Name Type Description Expression In Common
contraindication token The situation that is being documented as contraindicating against this item, as a code ClinicalUseDefinition.contraindication.diseaseSymptomProcedure
contraindication-reference reference The situation that is being documented as contraindicating against this item, as a reference ClinicalUseDefinition.contraindication.diseaseSymptomProcedure
effect token The situation in which the undesirable effect may manifest, as a code ClinicalUseDefinition.undesirableEffect.symptomConditionEffect
effect-reference reference The situation in which the undesirable effect may manifest, as a reference ClinicalUseDefinition.undesirableEffect.symptomConditionEffect
identifier token Business identifier for this issue ClinicalUseDefinition.identifier
indication token The situation that is being documented as an indicaton for this item, as a code ClinicalUseDefinition.indication.diseaseSymptomProcedure
indication-reference reference The situation that is being documented as an indicaton for this item, as a reference ClinicalUseDefinition.indication.diseaseSymptomProcedure
interaction token The type of the interaction e.g. drug-drug interaction, drug-food interaction, drug-lab test interaction ClinicalUseDefinition.interaction.type
product reference The medicinal product for which this is a clinical usage issue ClinicalUseDefinition.subject.where(resolve() is MedicinalProductDefinition)
( MedicinalProductDefinition )
status token Whether this is a current issue or one that has been retired etc ClinicalUseDefinition.status
subject reference The resource for which this is a clinical usage issue ClinicalUseDefinition.subject
( MedicinalProductDefinition , Device , Medication , DeviceDefinition , PlanDefinition , Substance , ActivityDefinition )
type N token indication | contraindication | interaction | undesirable-effect | warning ClinicalUseDefinition.type