This page is part of the FHIR Specification (v4.3.0: R4B - STU). 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

Work Group

Maturity Level: 1

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 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

This resource is referenced by itself and RegulatedAuthorization.

This resource does not implement any patterns.

Structure

Name	Flags	Card.	Type	Description & Constraints
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)
subject	Σ	0..*	Reference(MedicinalProductDefinition \| Medication \| ActivityDefinition \| PlanDefinition \| Device \| DeviceDefinition \| Substance)	The medication or procedure for which this is an indication
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
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	Σ	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
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
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)
Documentation for this format

UML Diagram (Legend)

XML Template

<ClinicalUseDefinition xmlns="http://hl7.org/fhir"> 
 <!-- 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>
  <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><!-- 1..1 CodeableReference(ActivityDefinition|Medication|
     MedicinalProductDefinition|Substance|SubstanceDefinition) Reference to a specific medication as part of an indication or contraindication --></therapy>
  </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>
  <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>
 <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

{
  "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
    "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
      "therapy" : { 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
    "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
  "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/> .


[ 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.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:ClinicalUseDefinition.contraindication.otherTherapy.therapy [ 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.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.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	Flags	Card.	Type	Description & Constraints
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)
subject	Σ	0..*	Reference(MedicinalProductDefinition \| Medication \| ActivityDefinition \| PlanDefinition \| Device \| DeviceDefinition \| Substance)	The medication or procedure for which this is an indication
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
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	Σ	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
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
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)
Documentation for this format

UML Diagram (Legend)

XML Template

<ClinicalUseDefinition xmlns="http://hl7.org/fhir"> 
 <!-- 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>
  <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><!-- 1..1 CodeableReference(ActivityDefinition|Medication|
     MedicinalProductDefinition|Substance|SubstanceDefinition) Reference to a specific medication as part of an indication or contraindication --></therapy>
  </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>
  <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>
 <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

{
  "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
    "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
      "therapy" : { 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
    "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
  "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/> .


[ 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.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:ClinicalUseDefinition.contraindication.otherTherapy.therapy [ 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.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.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 definitions: Master Definition XML + JSON, XML Schema/Schematron + JSON Schema, ShEx (for Turtle) + see the extensions & the dependency analysis

15.7.4.1 Terminology Bindings

Path	Type	Reference
ClinicalUseDefinition.type	Required	ClinicalUseDefinitionType
ClinicalUseDefinition.category	Preferred	ClinicalUseDefinitionCategory
ClinicalUseDefinition.status	Preferred	PublicationStatus
ClinicalUseDefinition.contraindication.diseaseSymptomProcedure	Example	DiseaseSymptomProcedure
ClinicalUseDefinition.contraindication.diseaseStatus	Example	DiseaseStatus
ClinicalUseDefinition.contraindication.comorbidity	Example	DiseaseSymptomProcedure
ClinicalUseDefinition.contraindication.otherTherapy.relationshipType	Preferred	TherapyRelationshipType
ClinicalUseDefinition.contraindication.otherTherapy.therapy	Example	Therapy
ClinicalUseDefinition.indication.diseaseSymptomProcedure	Example	DiseaseSymptomProcedure
ClinicalUseDefinition.indication.diseaseStatus	Example	DiseaseStatus
ClinicalUseDefinition.indication.comorbidity	Example	DiseaseSymptomProcedure
ClinicalUseDefinition.indication.intendedEffect	Preferred	ProductIntendedUse
ClinicalUseDefinition.interaction.interactant.item[x]	Example	Interactant
ClinicalUseDefinition.interaction.type	Example	InteractionType
ClinicalUseDefinition.interaction.effect	Example	InteractionEffect
ClinicalUseDefinition.interaction.incidence	Example	InteractionIncidence
ClinicalUseDefinition.interaction.management	Example	InteractionManagement
ClinicalUseDefinition.undesirableEffect.symptomConditionEffect	Example	UndesirableEffectSymptom
ClinicalUseDefinition.undesirableEffect.classification	Example	UndesirableEffectClassification
ClinicalUseDefinition.undesirableEffect.frequencyOfOccurrence	Example	UndesirablEffectFrequency
ClinicalUseDefinition.warning.code	Example	WarningType

Path

Definition

Type

Reference

ClinicalUseDefinition.type

Required

ClinicalUseDefinitionType

ClinicalUseDefinition.category

Preferred

ClinicalUseDefinitionCategory

ClinicalUseDefinition.status

Preferred

PublicationStatus

ClinicalUseDefinition.contraindication.diseaseSymptomProcedure

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)
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