DSTU2 STU 3 Ballot
This page is part of the FHIR Specification (v1.0.2: DSTU 2). The current version which supercedes this version is

This page is part of the FHIR Specification (v1.6.0: STU 3 Ballot 4). The current version which supercedes this version is 5.0.0 . For a full list of available versions, see the Directory of published versions . For a full list of available versions, see the Directory of published versions . Page versions: . Page versions: R5 R4B R4 R3 R2

5.16 8.13 Resource Substance - Content Resource Substance - Content

A homogeneous material with a definite composition.
Orders and Observations Orders and Observations Work Group Work Group Maturity Level : 1 Maturity Level : 1 Compartments : Not linked to any defined compartments : Not linked to any defined compartments

A homogeneous material with a definite composition.

5.16.1 Scope and Usage 8.13.1 Scope and Usage This resource allows for a material to be represented. The resource can be used to represent either a kind of a substance - e.g. a formulation commonly used for treating patients, or it can be used to describe a particular package of a known substance (e.g. bottle, jar, packet). The composition of the material can be specified in terms of a mix of other materials, including with precise amounts if required.

This resource allows for a material to be represented. The resource can be used to represent either a kind of a substance - e.g. a formulation commonly used for treating patients, or it can be used to describe a particular package of a known substance (e.g. bottle, jar, packet).

The composition of the material can be specified in terms of a mix of other materials, including with precise amounts if required.

5.16.2 Boundaries and Relationships 8.13.2 Boundaries and Relationships A medication is a substance that is packaged and used as an administered medication. The medication resource uses the substance resource to represent the actual ingredients of a medication. This resource is referenced by

A medication is a substance that is packaged and used as an administered medication. The medication resource uses the substance resource to represent the actual ingredients of a medication.

This resource is referenced by ActivityDefinition , CarePlan , , Contract , , Group , , Medication , Order , , Procedure , , Specimen , , SupplyDelivery and and SupplyRequest

5.16.3 Resource Content 8.13.3 Resource Content

Structure

A component of the substance
Name Flags Card. Type Description & Constraints Description & Constraints doco
. . Substance DomainResource A homogeneous material with a definite composition A homogeneous material with a definite composition
. . . identifier Σ 0..* Identifier Unique identifier Unique identifier
. . . category Σ 0..* CodeableConcept What class/type of substance this is What class/type of substance this is
Substance Category Codes ( Substance Category Codes ( Extensible )
. . . code Σ 1..1 CodeableConcept What substance this is What substance this is
Substance Code ( Substance Code ( Example )
. . . description Σ 0..1 string Textual description of the substance, comments Textual description of the substance, comments
. . . instance Σ 0..* BackboneElement If this describes a specific package/container of the substance If this describes a specific package/container of the substance
. . . . identifier Σ 0..1 Identifier Identifier of the package/container Identifier of the package/container
. . . . expiry Σ 0..1 dateTime When no longer valid to use When no longer valid to use
. . . . quantity Σ 0..1 SimpleQuantity Amount of substance in the package Amount of substance in the package
. . . ingredient Σ 0..* BackboneElement Composition information about the substance Composition information about the substance
. . . . quantity Σ 0..1 Ratio Optional amount (concentration) Optional amount (concentration)
. . . substance . substance[x] Σ 1..1 A component of the substance
Substance Code ( Example )
..... substanceCodeableConcept CodeableConcept
..... substanceReference Reference ( Substance )

Documentation for this format doco Documentation for this format

UML Diagram UML Diagram ( Legend )

Substance ( ( DomainResource ) Unique identifier for the substance Unique identifier for the substance identifier : : Identifier [0..*] [0..*] A code that classifies the general type of substance. This is used for searching, sorting and display purposes A code that classifies the general type of substance. This is used for searching, sorting and display purposes category : : CodeableConcept [0..*] « [0..*] « Category or classification of substance (Strength=Extensible) Category or classification of substance (Strength=Extensible) Substance Category + » Substance Category + » A code (or set of codes) that identify this substance A code (or set of codes) that identify this substance code : : CodeableConcept [1..1] « [1..1] « Substance codes (Strength=Example) Substance codes (Strength=Example) Substance Code Substance Code ?? » ?? » A description of the substance - its appearance, handling requirements, and other usage notes A description of the substance - its appearance, handling requirements, and other usage notes description : : string [0..1] [0..1] Instance Identifier associated with the package/container (usually a label affixed directly) Identifier associated with the package/container (usually a label affixed directly) identifier : : Identifier [0..1] [0..1] When the substance is no longer valid to use. For some substances, a single arbitrary date is used for expiry When the substance is no longer valid to use. For some substances, a single arbitrary date is used for expiry expiry : : dateTime [0..1] [0..1] The amount of the substance The amount of the substance quantity : : Quantity ( SimpleQuantity ) [0..1] ) [0..1] Ingredient The amount of the ingredient in the substance - a concentration ratio The amount of the ingredient in the substance - a concentration ratio quantity : : Ratio [0..1] [0..1] Another substance that is a component of this substance Another substance that is a component of this substance substance substance[x] : Type [1..1] « CodeableConcept : | Reference [1..1] « ( Substance » ); Substance Ingredient codes (Strength=Example) Substance Code ?? » Substance may be used to describe a kind of substance, or a specific package/container of the substance: an instance Substance may be used to describe a kind of substance, or a specific package/container of the substance: an instance instance [0..*] A substance can be composed of other substances A substance can be composed of other substances ingredient [0..*]

XML Template XML Template <

<Substance xmlns="http://hl7.org/fhir"> doco

 <!-- from Resource: id, meta, implicitRules, and language -->
 <!-- from DomainResource: text, contained, extension, and modifierExtension -->
 <</identifier>
 <</category>
 <</code>
 <
 <
  <</identifier>
  <
  <</quantity>

 <identifier><!-- 0..* Identifier Unique identifier --></identifier>
 <category><!-- 0..* CodeableConcept What class/type of substance this is --></category>
 <code><!-- 1..1 CodeableConcept What substance this is --></code>
 <description value="[string]"/><!-- 0..1 Textual description of the substance, comments -->
 <instance>  <!-- 0..* If this describes a specific package/container of the substance -->
  <identifier><!-- 0..1 Identifier Identifier of the package/container --></identifier>
  <expiry value="[dateTime]"/><!-- 0..1 When no longer valid to use -->
  <quantity><!-- 0..1 Quantity(SimpleQuantity) Amount of substance in the package --></quantity>

 </instance>
 <
  <</quantity>
  <</substance>

 <ingredient>  <!-- 0..* Composition information about the substance -->
  <quantity><!-- 0..1 Ratio Optional amount (concentration) --></quantity>
  <substance[x]><!-- 1..1 CodeableConcept|Reference(Substance) A component of the substance --></substance[x]>

 </ingredient>
</Substance>

Turtle Template


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


[ a fhir:Substance;
  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:Substance.identifier [ Identifier ], ... ; # 0..* Unique identifier
  fhir:Substance.category [ CodeableConcept ], ... ; # 0..* What class/type of substance this is
  fhir:Substance.code [ CodeableConcept ]; # 1..1 What substance this is
  fhir:Substance.description [ string ]; # 0..1 Textual description of the substance, comments
  fhir:Substance.instance [ # 0..* If this describes a specific package/container of the substance
    fhir:Substance.instance.identifier [ Identifier ]; # 0..1 Identifier of the package/container
    fhir:Substance.instance.expiry [ dateTime ]; # 0..1 When no longer valid to use
    fhir:Substance.instance.quantity [ Quantity(SimpleQuantity) ]; # 0..1 Amount of substance in the package
  ], ...;
  fhir:Substance.ingredient [ # 0..* Composition information about the substance
    fhir:Substance.ingredient.quantity [ Ratio ]; # 0..1 Optional amount (concentration)
    # Substance.ingredient.substance[x] : 1..1 A component of the substance. One of these 2
      fhir:Substance.ingredient.substanceCodeableConcept [ CodeableConcept ]
      fhir:Substance.ingredient.substanceReference [ Reference(Substance) ]
  ], ...;
]

Changes since DSTU2

Substance
Substance.ingredient.substance[x] Renamed from substance to substance[x]
Add CodeableConcept

See the Full Difference for further information

Structure

A component of the substance
Name Flags Card. Type Description & Constraints Description & Constraints doco
. . Substance DomainResource A homogeneous material with a definite composition A homogeneous material with a definite composition
. . . identifier Σ 0..* Identifier Unique identifier Unique identifier
. . . category Σ 0..* CodeableConcept What class/type of substance this is What class/type of substance this is
Substance Category Codes ( Substance Category Codes ( Extensible )
. . . code Σ 1..1 CodeableConcept What substance this is What substance this is
Substance Code ( Substance Code ( Example )
. . . description Σ 0..1 string Textual description of the substance, comments Textual description of the substance, comments
. . . instance Σ 0..* BackboneElement If this describes a specific package/container of the substance If this describes a specific package/container of the substance
. . . . identifier Σ 0..1 Identifier Identifier of the package/container Identifier of the package/container
. . . . expiry Σ 0..1 dateTime When no longer valid to use When no longer valid to use
. . . . quantity Σ 0..1 SimpleQuantity Amount of substance in the package Amount of substance in the package
. . . ingredient Σ 0..* BackboneElement Composition information about the substance Composition information about the substance
. . . . quantity Σ 0..1 Ratio Optional amount (concentration) Optional amount (concentration)
. . . substance . substance[x] Σ 1..1 A component of the substance
Substance Code ( Example )
..... substanceCodeableConcept CodeableConcept
..... substanceReference Reference ( Substance )

Documentation for this format doco Documentation for this format

UML Diagram UML Diagram ( Legend )

Substance ( ( DomainResource ) Unique identifier for the substance Unique identifier for the substance identifier : : Identifier [0..*] [0..*] A code that classifies the general type of substance. This is used for searching, sorting and display purposes A code that classifies the general type of substance. This is used for searching, sorting and display purposes category : : CodeableConcept [0..*] « [0..*] « Category or classification of substance (Strength=Extensible) Category or classification of substance (Strength=Extensible) Substance Category + » Substance Category + » A code (or set of codes) that identify this substance A code (or set of codes) that identify this substance code : : CodeableConcept [1..1] « [1..1] « Substance codes (Strength=Example) Substance codes (Strength=Example) Substance Code Substance Code ?? » ?? » A description of the substance - its appearance, handling requirements, and other usage notes A description of the substance - its appearance, handling requirements, and other usage notes description : : string [0..1] [0..1] Instance Identifier associated with the package/container (usually a label affixed directly) Identifier associated with the package/container (usually a label affixed directly) identifier : : Identifier [0..1] [0..1] When the substance is no longer valid to use. For some substances, a single arbitrary date is used for expiry When the substance is no longer valid to use. For some substances, a single arbitrary date is used for expiry expiry : : dateTime [0..1] [0..1] The amount of the substance The amount of the substance quantity : : Quantity ( SimpleQuantity ) [0..1] ) [0..1] Ingredient The amount of the ingredient in the substance - a concentration ratio The amount of the ingredient in the substance - a concentration ratio quantity : : Ratio [0..1] [0..1] Another substance that is a component of this substance Another substance that is a component of this substance substance substance[x] : Type [1..1] « CodeableConcept : | Reference [1..1] « ( Substance » ); Substance Ingredient codes (Strength=Example) Substance Code ?? » Substance may be used to describe a kind of substance, or a specific package/container of the substance: an instance Substance may be used to describe a kind of substance, or a specific package/container of the substance: an instance instance [0..*] A substance can be composed of other substances A substance can be composed of other substances ingredient [0..*]

XML Template XML Template <

<Substance xmlns="http://hl7.org/fhir"> doco

 <!-- from Resource: id, meta, implicitRules, and language -->
 <!-- from DomainResource: text, contained, extension, and modifierExtension -->
 <</identifier>
 <</category>
 <</code>
 <
 <
  <</identifier>
  <
  <</quantity>

 <identifier><!-- 0..* Identifier Unique identifier --></identifier>
 <category><!-- 0..* CodeableConcept What class/type of substance this is --></category>
 <code><!-- 1..1 CodeableConcept What substance this is --></code>
 <description value="[string]"/><!-- 0..1 Textual description of the substance, comments -->
 <instance>  <!-- 0..* If this describes a specific package/container of the substance -->
  <identifier><!-- 0..1 Identifier Identifier of the package/container --></identifier>
  <expiry value="[dateTime]"/><!-- 0..1 When no longer valid to use -->
  <quantity><!-- 0..1 Quantity(SimpleQuantity) Amount of substance in the package --></quantity>

 </instance>
 <
  <</quantity>
  <</substance>

 <ingredient>  <!-- 0..* Composition information about the substance -->
  <quantity><!-- 0..1 Ratio Optional amount (concentration) --></quantity>
  <substance[x]><!-- 1..1 CodeableConcept|Reference(Substance) A component of the substance --></substance[x]>

 </ingredient>
</Substance>

Turtle Template


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


[ a fhir:Substance;
  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:Substance.identifier [ Identifier ], ... ; # 0..* Unique identifier
  fhir:Substance.category [ CodeableConcept ], ... ; # 0..* What class/type of substance this is
  fhir:Substance.code [ CodeableConcept ]; # 1..1 What substance this is
  fhir:Substance.description [ string ]; # 0..1 Textual description of the substance, comments
  fhir:Substance.instance [ # 0..* If this describes a specific package/container of the substance
    fhir:Substance.instance.identifier [ Identifier ]; # 0..1 Identifier of the package/container
    fhir:Substance.instance.expiry [ dateTime ]; # 0..1 When no longer valid to use
    fhir:Substance.instance.quantity [ Quantity(SimpleQuantity) ]; # 0..1 Amount of substance in the package
  ], ...;
  fhir:Substance.ingredient [ # 0..* Composition information about the substance
    fhir:Substance.ingredient.quantity [ Ratio ]; # 0..1 Optional amount (concentration)
    # Substance.ingredient.substance[x] : 1..1 A component of the substance. One of these 2
      fhir:Substance.ingredient.substanceCodeableConcept [ CodeableConcept ]
      fhir:Substance.ingredient.substanceReference [ Reference(Substance) ]
  ], ...;
]

Changes since DSTU2

Substance
Substance.ingredient.substance[x] Renamed from substance to substance[x]
Add CodeableConcept

See the Full Difference for further information

 

Alternate definitions: Master Definition ( XML , JSON ), XML Schema / Schematron , Resource Profile ( XML , (for ) + JSON Schema , ShEx (for Turtle ), Questionnaire )

5.16.3.1 Terminology Bindings 8.13.3.1 Terminology Bindings

Substance.category Substance.code
Path Definition Type Reference
Substance.category Category or classification of substance Category or classification of substance Extensible Substance Category Codes Substance Category Codes
Substance.code Substance codes Substance codes Example Substance Code Substance Code
Substance.ingredient.substance[x] Substance Ingredient codes Example Substance Code

5.16.4 Search Parameters 8.13.4 Search Parameters Search parameters for this resource. The common parameters also apply. See

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

© HL7.org 2011+. FHIR DSTU2 (v1.0.2-7202) generated on Sat, Oct 24, 2015 07:44+1100. Links: Search | Version History | Table of Contents | Compare to DSTU1
Name Type Description Paths
category token The category of the substance The category of the substance Substance.category
code token The code of the substance The code of the substance or ingredient Substance.code Substance.code, Substance.ingredient.substanceCodeableConcept
container-identifier token Identifier of the package/container Identifier of the package/container Substance.instance.identifier
expiry date Expiry date of package or container of substance Expiry date of package or container of substance Substance.instance.expiry
identifier token Unique identifier for the substance Unique identifier for the substance Substance.identifier
quantity quantity Amount of substance in the package Amount of substance in the package Substance.instance.quantity
substance substance-reference reference A component of the substance A component of the substance Substance.ingredient.substance Substance.ingredient.substanceReference
( Substance )