This page is part of the FHIR Specification (v4.0.1: R4 - Mixed Normative and STU) in it's permanent home (it will always be available at this URL). The current version which supercedes this version is 5.0.0. For a full list of available versions, see the Directory of published versions
Biomedical Research and Regulation Work Group | Maturity Level: 0 | Trial Use | Security Category: Anonymous | Compartments: Not linked to any defined compartments |
The detailed description of a substance, typically at a level beyond what is used for prescribing.
This resource is still undergoing development and review by the appropriate Workgroups. At this time, is considered only as a draft resource not suitable for production implementation
This resource is referenced by MedicinalProductContraindication, MedicinalProductIndication and itself
Structure
Name | Flags | Card. | Type | Description & Constraints |
---|---|---|---|---|
SubstanceSpecification | ΣTU | DomainResource | The detailed description of a substance, typically at a level beyond what is used for prescribing Elements defined in Ancestors: id, meta, implicitRules, language, text, contained, extension, modifierExtension | |
identifier | Σ | 0..1 | Identifier | Identifier by which this substance is known |
type | Σ | 0..1 | CodeableConcept | High level categorization, e.g. polymer or nucleic acid |
status | Σ | 0..1 | CodeableConcept | Status of substance within the catalogue e.g. approved |
domain | Σ | 0..1 | CodeableConcept | If the substance applies to only human or veterinary use |
description | Σ | 0..1 | string | Textual description of the substance |
source | Σ | 0..* | Reference(DocumentReference) | Supporting literature |
comment | Σ | 0..1 | string | Textual comment about this record of a substance |
moiety | Σ | 0..* | BackboneElement | Moiety, for structural modifications |
role | Σ | 0..1 | CodeableConcept | Role that the moiety is playing |
identifier | Σ | 0..1 | Identifier | Identifier by which this moiety substance is known |
name | Σ | 0..1 | string | Textual name for this moiety substance |
stereochemistry | Σ | 0..1 | CodeableConcept | Stereochemistry type |
opticalActivity | Σ | 0..1 | CodeableConcept | Optical activity type |
molecularFormula | Σ | 0..1 | string | Molecular formula |
amount[x] | Σ | 0..1 | Quantitative value for this moiety | |
amountQuantity | Quantity | |||
amountString | string | |||
property | Σ | 0..* | BackboneElement | General specifications for this substance, including how it is related to other substances |
category | Σ | 0..1 | CodeableConcept | A category for this property, e.g. Physical, Chemical, Enzymatic |
code | Σ | 0..1 | CodeableConcept | Property type e.g. viscosity, pH, isoelectric point |
parameters | Σ | 0..1 | string | Parameters that were used in the measurement of a property (e.g. for viscosity: measured at 20C with a pH of 7.1) |
definingSubstance[x] | Σ | 0..1 | A substance upon which a defining property depends (e.g. for solubility: in water, in alcohol) | |
definingSubstanceReference | Reference(SubstanceSpecification | Substance) | |||
definingSubstanceCodeableConcept | CodeableConcept | |||
amount[x] | Σ | 0..1 | Quantitative value for this property | |
amountQuantity | Quantity | |||
amountString | string | |||
referenceInformation | Σ | 0..1 | Reference(SubstanceReferenceInformation) | General information detailing this substance |
structure | Σ | 0..1 | BackboneElement | Structural information |
stereochemistry | Σ | 0..1 | CodeableConcept | Stereochemistry type |
opticalActivity | Σ | 0..1 | CodeableConcept | Optical activity type |
molecularFormula | Σ | 0..1 | string | Molecular formula |
molecularFormulaByMoiety | Σ | 0..1 | string | Specified per moiety according to the Hill system, i.e. first C, then H, then alphabetical, each moiety separated by a dot |
isotope | Σ | 0..* | BackboneElement | Applicable for single substances that contain a radionuclide or a non-natural isotopic ratio |
identifier | Σ | 0..1 | Identifier | Substance identifier for each non-natural or radioisotope |
name | Σ | 0..1 | CodeableConcept | Substance name for each non-natural or radioisotope |
substitution | Σ | 0..1 | CodeableConcept | The type of isotopic substitution present in a single substance |
halfLife | Σ | 0..1 | Quantity | Half life - for a non-natural nuclide |
molecularWeight | Σ | 0..1 | BackboneElement | The molecular weight or weight range (for proteins, polymers or nucleic acids) |
method | Σ | 0..1 | CodeableConcept | The method by which the molecular weight was determined |
type | Σ | 0..1 | CodeableConcept | Type of molecular weight such as exact, average (also known as. number average), weight average |
amount | Σ | 0..1 | Quantity | Used to capture quantitative values for a variety of elements. If only limits are given, the arithmetic mean would be the average. If only a single definite value for a given element is given, it would be captured in this field |
molecularWeight | Σ | 0..1 | see molecularWeight | The molecular weight or weight range (for proteins, polymers or nucleic acids) |
source | Σ | 0..* | Reference(DocumentReference) | Supporting literature |
representation | Σ | 0..* | BackboneElement | Molecular structural representation |
type | Σ | 0..1 | CodeableConcept | The type of structure (e.g. Full, Partial, Representative) |
representation | Σ | 0..1 | string | The structural representation as text string in a format e.g. InChI, SMILES, MOLFILE, CDX |
attachment | Σ | 0..1 | Attachment | An attached file with the structural representation |
code | Σ | 0..* | BackboneElement | Codes associated with the substance |
code | Σ | 0..1 | CodeableConcept | The specific code |
status | Σ | 0..1 | CodeableConcept | Status of the code assignment |
statusDate | Σ | 0..1 | dateTime | The date at which the code status is changed as part of the terminology maintenance |
comment | Σ | 0..1 | string | Any comment can be provided in this field, if necessary |
source | Σ | 0..* | Reference(DocumentReference) | Supporting literature |
name | Σ | 0..* | BackboneElement | Names applicable to this substance |
name | Σ | 1..1 | string | The actual name |
type | Σ | 0..1 | CodeableConcept | Name type |
status | Σ | 0..1 | CodeableConcept | The status of the name |
preferred | Σ | 0..1 | boolean | If this is the preferred name for this substance |
language | Σ | 0..* | CodeableConcept | Language of the name |
domain | Σ | 0..* | CodeableConcept | The use context of this name for example if there is a different name a drug active ingredient as opposed to a food colour additive |
jurisdiction | Σ | 0..* | CodeableConcept | The jurisdiction where this name applies |
synonym | Σ | 0..* | see name | A synonym of this name |
translation | Σ | 0..* | see name | A translation for this name |
official | Σ | 0..* | BackboneElement | Details of the official nature of this name |
authority | Σ | 0..1 | CodeableConcept | Which authority uses this official name |
status | Σ | 0..1 | CodeableConcept | The status of the official name |
date | Σ | 0..1 | dateTime | Date of official name change |
source | Σ | 0..* | Reference(DocumentReference) | Supporting literature |
molecularWeight | Σ | 0..* | see molecularWeight | The molecular weight or weight range (for proteins, polymers or nucleic acids) |
relationship | Σ | 0..* | BackboneElement | A link between this substance and another, with details of the relationship |
substance[x] | Σ | 0..1 | A pointer to another substance, as a resource or just a representational code | |
substanceReference | Reference(SubstanceSpecification) | |||
substanceCodeableConcept | CodeableConcept | |||
relationship | Σ | 0..1 | CodeableConcept | For example "salt to parent", "active moiety", "starting material" |
isDefining | Σ | 0..1 | boolean | For example where an enzyme strongly bonds with a particular substance, this is a defining relationship for that enzyme, out of several possible substance relationships |
amount[x] | Σ | 0..1 | A numeric factor for the relationship, for instance to express that the salt of a substance has some percentage of the active substance in relation to some other | |
amountQuantity | Quantity | |||
amountRange | Range | |||
amountRatio | Ratio | |||
amountString | string | |||
amountRatioLowLimit | Σ | 0..1 | Ratio | For use when the numeric |
amountType | Σ | 0..1 | CodeableConcept | An operator for the amount, for example "average", "approximately", "less than" |
source | Σ | 0..* | Reference(DocumentReference) | Supporting literature |
nucleicAcid | Σ | 0..1 | Reference(SubstanceNucleicAcid) | Data items specific to nucleic acids |
polymer | Σ | 0..1 | Reference(SubstancePolymer) | Data items specific to polymers |
protein | Σ | 0..1 | Reference(SubstanceProtein) | Data items specific to proteins |
sourceMaterial | Σ | 0..1 | Reference(SubstanceSourceMaterial) | Material or taxonomic/anatomical source for the substance |
Documentation for this format |
UML Diagram (Legend)
XML Template
<SubstanceSpecification xmlns="http://hl7.org/fhir"> <!-- from Resource: id, meta, implicitRules, and language --> <!-- from DomainResource: text, contained, extension, and modifierExtension --> <identifier><!-- 0..1 Identifier Identifier by which this substance is known --></identifier> <type><!-- 0..1 CodeableConcept High level categorization, e.g. polymer or nucleic acid --></type> <status><!-- 0..1 CodeableConcept Status of substance within the catalogue e.g. approved --></status> <domain><!-- 0..1 CodeableConcept If the substance applies to only human or veterinary use --></domain> <description value="[string]"/><!-- 0..1 Textual description of the substance --> <source><!-- 0..* Reference(DocumentReference) Supporting literature --></source> <comment value="[string]"/><!-- 0..1 Textual comment about this record of a substance --> <moiety> <!-- 0..* Moiety, for structural modifications --> <role><!-- 0..1 CodeableConcept Role that the moiety is playing --></role> <identifier><!-- 0..1 Identifier Identifier by which this moiety substance is known --></identifier> <name value="[string]"/><!-- 0..1 Textual name for this moiety substance --> <stereochemistry><!-- 0..1 CodeableConcept Stereochemistry type --></stereochemistry> <opticalActivity><!-- 0..1 CodeableConcept Optical activity type --></opticalActivity> <molecularFormula value="[string]"/><!-- 0..1 Molecular formula --> <amount[x]><!-- 0..1 Quantity|string Quantitative value for this moiety --></amount[x]> </moiety> <property> <!-- 0..* General specifications for this substance, including how it is related to other substances --> <category><!-- 0..1 CodeableConcept A category for this property, e.g. Physical, Chemical, Enzymatic --></category> <code><!-- 0..1 CodeableConcept Property type e.g. viscosity, pH, isoelectric point --></code> <parameters value="[string]"/><!-- 0..1 Parameters that were used in the measurement of a property (e.g. for viscosity: measured at 20C with a pH of 7.1) --> <definingSubstance[x]><!-- 0..1 Reference(SubstanceSpecification|Substance)| CodeableConcept A substance upon which a defining property depends (e.g. for solubility: in water, in alcohol) --></definingSubstance[x]> <amount[x]><!-- 0..1 Quantity|string Quantitative value for this property --></amount[x]> </property> <referenceInformation><!-- 0..1 Reference(SubstanceReferenceInformation) General information detailing this substance --></referenceInformation> <structure> <!-- 0..1 Structural information --> <stereochemistry><!-- 0..1 CodeableConcept Stereochemistry type --></stereochemistry> <opticalActivity><!-- 0..1 CodeableConcept Optical activity type --></opticalActivity> <molecularFormula value="[string]"/><!-- 0..1 Molecular formula --> <molecularFormulaByMoiety value="[string]"/><!-- 0..1 Specified per moiety according to the Hill system, i.e. first C, then H, then alphabetical, each moiety separated by a dot --> <isotope> <!-- 0..* Applicable for single substances that contain a radionuclide or a non-natural isotopic ratio --> <identifier><!-- 0..1 Identifier Substance identifier for each non-natural or radioisotope --></identifier> <name><!-- 0..1 CodeableConcept Substance name for each non-natural or radioisotope --></name> <substitution><!-- 0..1 CodeableConcept The type of isotopic substitution present in a single substance --></substitution> <halfLife><!-- 0..1 Quantity Half life - for a non-natural nuclide --></halfLife> <molecularWeight> <!-- 0..1 The molecular weight or weight range (for proteins, polymers or nucleic acids) --> <method><!-- 0..1 CodeableConcept The method by which the molecular weight was determined --></method> <type><!-- 0..1 CodeableConcept Type of molecular weight such as exact, average (also known as. number average), weight average --></type> <amount><!-- 0..1 Quantity Used to capture quantitative values for a variety of elements. If only limits are given, the arithmetic mean would be the average. If only a single definite value for a given element is given, it would be captured in this field --></amount> </molecularWeight> </isotope> <molecularWeight><!-- 0..1 Content as for SubstanceSpecification.structure.isotope.molecularWeight The molecular weight or weight range (for proteins, polymers or nucleic acids) --></molecularWeight> <source><!-- 0..* Reference(DocumentReference) Supporting literature --></source> <representation> <!-- 0..* Molecular structural representation --> <type><!-- 0..1 CodeableConcept The type of structure (e.g. Full, Partial, Representative) --></type> <representation value="[string]"/><!-- 0..1 The structural representation as text string in a format e.g. InChI, SMILES, MOLFILE, CDX --> <attachment><!-- 0..1 Attachment An attached file with the structural representation --></attachment> </representation> </structure> <code> <!-- 0..* Codes associated with the substance --> <code><!-- 0..1 CodeableConcept The specific code --></code> <status><!-- 0..1 CodeableConcept Status of the code assignment --></status> <statusDate value="[dateTime]"/><!-- 0..1 The date at which the code status is changed as part of the terminology maintenance --> <comment value="[string]"/><!-- 0..1 Any comment can be provided in this field, if necessary --> <source><!-- 0..* Reference(DocumentReference) Supporting literature --></source> </code> <name> <!-- 0..* Names applicable to this substance --> <name value="[string]"/><!-- 1..1 The actual name --> <type><!-- 0..1 CodeableConcept Name type --></type> <status><!-- 0..1 CodeableConcept The status of the name --></status> <preferred value="[boolean]"/><!-- 0..1 If this is the preferred name for this substance --> <language><!-- 0..* CodeableConcept Language of the name --></language> <domain><!-- 0..* CodeableConcept The use context of this name for example if there is a different name a drug active ingredient as opposed to a food colour additive --></domain> <jurisdiction><!-- 0..* CodeableConcept The jurisdiction where this name applies --></jurisdiction> <synonym><!-- 0..* Content as for SubstanceSpecification.name A synonym of this name --></synonym> <translation><!-- 0..* Content as for SubstanceSpecification.name A translation for this name --></translation> <official> <!-- 0..* Details of the official nature of this name --> <authority><!-- 0..1 CodeableConcept Which authority uses this official name --></authority> <status><!-- 0..1 CodeableConcept The status of the official name --></status> <date value="[dateTime]"/><!-- 0..1 Date of official name change --> </official> <source><!-- 0..* Reference(DocumentReference) Supporting literature --></source> </name> <molecularWeight><!-- 0..* Content as for SubstanceSpecification.structure.isotope.molecularWeight The molecular weight or weight range (for proteins, polymers or nucleic acids) --></molecularWeight> <relationship> <!-- 0..* A link between this substance and another, with details of the relationship --> <substance[x]><!-- 0..1 Reference(SubstanceSpecification)|CodeableConcept A pointer to another substance, as a resource or just a representational code --></substance[x]> <relationship><!-- 0..1 CodeableConcept For example "salt to parent", "active moiety", "starting material" --></relationship> <isDefining value="[boolean]"/><!-- 0..1 For example where an enzyme strongly bonds with a particular substance, this is a defining relationship for that enzyme, out of several possible substance relationships --> <amount[x]><!-- 0..1 Quantity|Range|Ratio|string A numeric factor for the relationship, for instance to express that the salt of a substance has some percentage of the active substance in relation to some other --></amount[x]> <amountRatioLowLimit><!-- 0..1 Ratio For use when the numeric --></amountRatioLowLimit> <amountType><!-- 0..1 CodeableConcept An operator for the amount, for example "average", "approximately", "less than" --></amountType> <source><!-- 0..* Reference(DocumentReference) Supporting literature --></source> </relationship> <nucleicAcid><!-- 0..1 Reference(SubstanceNucleicAcid) Data items specific to nucleic acids --></nucleicAcid> <polymer><!-- 0..1 Reference(SubstancePolymer) Data items specific to polymers --></polymer> <protein><!-- 0..1 Reference(SubstanceProtein) Data items specific to proteins --></protein> <sourceMaterial><!-- 0..1 Reference(SubstanceSourceMaterial) Material or taxonomic/anatomical source for the substance --></sourceMaterial> </SubstanceSpecification>
JSON Template
{ "resourceType" : "SubstanceSpecification", // from Resource: id, meta, implicitRules, and language // from DomainResource: text, contained, extension, and modifierExtension "identifier" : { Identifier }, // Identifier by which this substance is known "type" : { CodeableConcept }, // High level categorization, e.g. polymer or nucleic acid "status" : { CodeableConcept }, // Status of substance within the catalogue e.g. approved "domain" : { CodeableConcept }, // If the substance applies to only human or veterinary use "description" : "<string>", // Textual description of the substance "source" : [{ Reference(DocumentReference) }], // Supporting literature "comment" : "<string>", // Textual comment about this record of a substance "moiety" : [{ // Moiety, for structural modifications "role" : { CodeableConcept }, // Role that the moiety is playing "identifier" : { Identifier }, // Identifier by which this moiety substance is known "name" : "<string>", // Textual name for this moiety substance "stereochemistry" : { CodeableConcept }, // Stereochemistry type "opticalActivity" : { CodeableConcept }, // Optical activity type "molecularFormula" : "<string>", // Molecular formula // amount[x]: Quantitative value for this moiety. One of these 2: "amountQuantity" : { Quantity } "amountString" : "<string>" }], "property" : [{ // General specifications for this substance, including how it is related to other substances "category" : { CodeableConcept }, // A category for this property, e.g. Physical, Chemical, Enzymatic "code" : { CodeableConcept }, // Property type e.g. viscosity, pH, isoelectric point "parameters" : "<string>", // Parameters that were used in the measurement of a property (e.g. for viscosity: measured at 20C with a pH of 7.1) // definingSubstance[x]: A substance upon which a defining property depends (e.g. for solubility: in water, in alcohol). One of these 2: "definingSubstanceReference" : { Reference(SubstanceSpecification|Substance) }, "definingSubstanceCodeableConcept" : { CodeableConcept }, // amount[x]: Quantitative value for this property. One of these 2: "amountQuantity" : { Quantity } "amountString" : "<string>" }], "referenceInformation" : { Reference(SubstanceReferenceInformation) }, // General information detailing this substance "structure" : { // Structural information "stereochemistry" : { CodeableConcept }, // Stereochemistry type "opticalActivity" : { CodeableConcept }, // Optical activity type "molecularFormula" : "<string>", // Molecular formula "molecularFormulaByMoiety" : "<string>", // Specified per moiety according to the Hill system, i.e. first C, then H, then alphabetical, each moiety separated by a dot "isotope" : [{ // Applicable for single substances that contain a radionuclide or a non-natural isotopic ratio "identifier" : { Identifier }, // Substance identifier for each non-natural or radioisotope "name" : { CodeableConcept }, // Substance name for each non-natural or radioisotope "substitution" : { CodeableConcept }, // The type of isotopic substitution present in a single substance "halfLife" : { Quantity }, // Half life - for a non-natural nuclide "molecularWeight" : { // The molecular weight or weight range (for proteins, polymers or nucleic acids) "method" : { CodeableConcept }, // The method by which the molecular weight was determined "type" : { CodeableConcept }, // Type of molecular weight such as exact, average (also known as. number average), weight average "amount" : { Quantity } // Used to capture quantitative values for a variety of elements. If only limits are given, the arithmetic mean would be the average. If only a single definite value for a given element is given, it would be captured in this field } }], "molecularWeight" : { Content as for SubstanceSpecification.structure.isotope.molecularWeight }, // The molecular weight or weight range (for proteins, polymers or nucleic acids) "source" : [{ Reference(DocumentReference) }], // Supporting literature "representation" : [{ // Molecular structural representation "type" : { CodeableConcept }, // The type of structure (e.g. Full, Partial, Representative) "representation" : "<string>", // The structural representation as text string in a format e.g. InChI, SMILES, MOLFILE, CDX "attachment" : { Attachment } // An attached file with the structural representation }] }, "code" : [{ // Codes associated with the substance "code" : { CodeableConcept }, // The specific code "status" : { CodeableConcept }, // Status of the code assignment "statusDate" : "<dateTime>", // The date at which the code status is changed as part of the terminology maintenance "comment" : "<string>", // Any comment can be provided in this field, if necessary "source" : [{ Reference(DocumentReference) }] // Supporting literature }], "name" : [{ // Names applicable to this substance "name" : "<string>", // R! The actual name "type" : { CodeableConcept }, // Name type "status" : { CodeableConcept }, // The status of the name "preferred" : <boolean>, // If this is the preferred name for this substance "language" : [{ CodeableConcept }], // Language of the name "domain" : [{ CodeableConcept }], // The use context of this name for example if there is a different name a drug active ingredient as opposed to a food colour additive "jurisdiction" : [{ CodeableConcept }], // The jurisdiction where this name applies "synonym" : [{ Content as for SubstanceSpecification.name }], // A synonym of this name "translation" : [{ Content as for SubstanceSpecification.name }], // A translation for this name "official" : [{ // Details of the official nature of this name "authority" : { CodeableConcept }, // Which authority uses this official name "status" : { CodeableConcept }, // The status of the official name "date" : "<dateTime>" // Date of official name change }], "source" : [{ Reference(DocumentReference) }] // Supporting literature }], "molecularWeight" : [{ Content as for SubstanceSpecification.structure.isotope.molecularWeight }], // The molecular weight or weight range (for proteins, polymers or nucleic acids) "relationship" : [{ // A link between this substance and another, with details of the relationship // substance[x]: A pointer to another substance, as a resource or just a representational code. One of these 2: "substanceReference" : { Reference(SubstanceSpecification) }, "substanceCodeableConcept" : { CodeableConcept }, "relationship" : { CodeableConcept }, // For example "salt to parent", "active moiety", "starting material" "isDefining" : <boolean>, // For example where an enzyme strongly bonds with a particular substance, this is a defining relationship for that enzyme, out of several possible substance relationships // amount[x]: A numeric factor for the relationship, for instance to express that the salt of a substance has some percentage of the active substance in relation to some other. One of these 4: "amountQuantity" : { Quantity }, "amountRange" : { Range }, "amountRatio" : { Ratio }, "amountString" : "<string>", "amountRatioLowLimit" : { Ratio }, // For use when the numeric "amountType" : { CodeableConcept }, // An operator for the amount, for example "average", "approximately", "less than" "source" : [{ Reference(DocumentReference) }] // Supporting literature }], "nucleicAcid" : { Reference(SubstanceNucleicAcid) }, // Data items specific to nucleic acids "polymer" : { Reference(SubstancePolymer) }, // Data items specific to polymers "protein" : { Reference(SubstanceProtein) }, // Data items specific to proteins "sourceMaterial" : { Reference(SubstanceSourceMaterial) } // Material or taxonomic/anatomical source for the substance }
Turtle Template
@prefix fhir: <http://hl7.org/fhir/> . [ a fhir:SubstanceSpecification; 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:SubstanceSpecification.identifier [ Identifier ]; # 0..1 Identifier by which this substance is known fhir:SubstanceSpecification.type [ CodeableConcept ]; # 0..1 High level categorization, e.g. polymer or nucleic acid fhir:SubstanceSpecification.status [ CodeableConcept ]; # 0..1 Status of substance within the catalogue e.g. approved fhir:SubstanceSpecification.domain [ CodeableConcept ]; # 0..1 If the substance applies to only human or veterinary use fhir:SubstanceSpecification.description [ string ]; # 0..1 Textual description of the substance fhir:SubstanceSpecification.source [ Reference(DocumentReference) ], ... ; # 0..* Supporting literature fhir:SubstanceSpecification.comment [ string ]; # 0..1 Textual comment about this record of a substance fhir:SubstanceSpecification.moiety [ # 0..* Moiety, for structural modifications fhir:SubstanceSpecification.moiety.role [ CodeableConcept ]; # 0..1 Role that the moiety is playing fhir:SubstanceSpecification.moiety.identifier [ Identifier ]; # 0..1 Identifier by which this moiety substance is known fhir:SubstanceSpecification.moiety.name [ string ]; # 0..1 Textual name for this moiety substance fhir:SubstanceSpecification.moiety.stereochemistry [ CodeableConcept ]; # 0..1 Stereochemistry type fhir:SubstanceSpecification.moiety.opticalActivity [ CodeableConcept ]; # 0..1 Optical activity type fhir:SubstanceSpecification.moiety.molecularFormula [ string ]; # 0..1 Molecular formula # SubstanceSpecification.moiety.amount[x] : 0..1 Quantitative value for this moiety. One of these 2 fhir:SubstanceSpecification.moiety.amountQuantity [ Quantity ] fhir:SubstanceSpecification.moiety.amountString [ string ] ], ...; fhir:SubstanceSpecification.property [ # 0..* General specifications for this substance, including how it is related to other substances fhir:SubstanceSpecification.property.category [ CodeableConcept ]; # 0..1 A category for this property, e.g. Physical, Chemical, Enzymatic fhir:SubstanceSpecification.property.code [ CodeableConcept ]; # 0..1 Property type e.g. viscosity, pH, isoelectric point fhir:SubstanceSpecification.property.parameters [ string ]; # 0..1 Parameters that were used in the measurement of a property (e.g. for viscosity: measured at 20C with a pH of 7.1) # SubstanceSpecification.property.definingSubstance[x] : 0..1 A substance upon which a defining property depends (e.g. for solubility: in water, in alcohol). One of these 2 fhir:SubstanceSpecification.property.definingSubstanceReference [ Reference(SubstanceSpecification|Substance) ] fhir:SubstanceSpecification.property.definingSubstanceCodeableConcept [ CodeableConcept ] # SubstanceSpecification.property.amount[x] : 0..1 Quantitative value for this property. One of these 2 fhir:SubstanceSpecification.property.amountQuantity [ Quantity ] fhir:SubstanceSpecification.property.amountString [ string ] ], ...; fhir:SubstanceSpecification.referenceInformation [ Reference(SubstanceReferenceInformation) ]; # 0..1 General information detailing this substance fhir:SubstanceSpecification.structure [ # 0..1 Structural information fhir:SubstanceSpecification.structure.stereochemistry [ CodeableConcept ]; # 0..1 Stereochemistry type fhir:SubstanceSpecification.structure.opticalActivity [ CodeableConcept ]; # 0..1 Optical activity type fhir:SubstanceSpecification.structure.molecularFormula [ string ]; # 0..1 Molecular formula fhir:SubstanceSpecification.structure.molecularFormulaByMoiety [ string ]; # 0..1 Specified per moiety according to the Hill system, i.e. first C, then H, then alphabetical, each moiety separated by a dot fhir:SubstanceSpecification.structure.isotope [ # 0..* Applicable for single substances that contain a radionuclide or a non-natural isotopic ratio fhir:SubstanceSpecification.structure.isotope.identifier [ Identifier ]; # 0..1 Substance identifier for each non-natural or radioisotope fhir:SubstanceSpecification.structure.isotope.name [ CodeableConcept ]; # 0..1 Substance name for each non-natural or radioisotope fhir:SubstanceSpecification.structure.isotope.substitution [ CodeableConcept ]; # 0..1 The type of isotopic substitution present in a single substance fhir:SubstanceSpecification.structure.isotope.halfLife [ Quantity ]; # 0..1 Half life - for a non-natural nuclide fhir:SubstanceSpecification.structure.isotope.molecularWeight [ # 0..1 The molecular weight or weight range (for proteins, polymers or nucleic acids) fhir:SubstanceSpecification.structure.isotope.molecularWeight.method [ CodeableConcept ]; # 0..1 The method by which the molecular weight was determined fhir:SubstanceSpecification.structure.isotope.molecularWeight.type [ CodeableConcept ]; # 0..1 Type of molecular weight such as exact, average (also known as. number average), weight average fhir:SubstanceSpecification.structure.isotope.molecularWeight.amount [ Quantity ]; # 0..1 Used to capture quantitative values for a variety of elements. If only limits are given, the arithmetic mean would be the average. If only a single definite value for a given element is given, it would be captured in this field ]; ], ...; fhir:SubstanceSpecification.structure.molecularWeight [ See SubstanceSpecification.structure.isotope.molecularWeight ]; # 0..1 The molecular weight or weight range (for proteins, polymers or nucleic acids) fhir:SubstanceSpecification.structure.source [ Reference(DocumentReference) ], ... ; # 0..* Supporting literature fhir:SubstanceSpecification.structure.representation [ # 0..* Molecular structural representation fhir:SubstanceSpecification.structure.representation.type [ CodeableConcept ]; # 0..1 The type of structure (e.g. Full, Partial, Representative) fhir:SubstanceSpecification.structure.representation.representation [ string ]; # 0..1 The structural representation as text string in a format e.g. InChI, SMILES, MOLFILE, CDX fhir:SubstanceSpecification.structure.representation.attachment [ Attachment ]; # 0..1 An attached file with the structural representation ], ...; ]; fhir:SubstanceSpecification.code [ # 0..* Codes associated with the substance fhir:SubstanceSpecification.code.code [ CodeableConcept ]; # 0..1 The specific code fhir:SubstanceSpecification.code.status [ CodeableConcept ]; # 0..1 Status of the code assignment fhir:SubstanceSpecification.code.statusDate [ dateTime ]; # 0..1 The date at which the code status is changed as part of the terminology maintenance fhir:SubstanceSpecification.code.comment [ string ]; # 0..1 Any comment can be provided in this field, if necessary fhir:SubstanceSpecification.code.source [ Reference(DocumentReference) ], ... ; # 0..* Supporting literature ], ...; fhir:SubstanceSpecification.name [ # 0..* Names applicable to this substance fhir:SubstanceSpecification.name.name [ string ]; # 1..1 The actual name fhir:SubstanceSpecification.name.type [ CodeableConcept ]; # 0..1 Name type fhir:SubstanceSpecification.name.status [ CodeableConcept ]; # 0..1 The status of the name fhir:SubstanceSpecification.name.preferred [ boolean ]; # 0..1 If this is the preferred name for this substance fhir:SubstanceSpecification.name.language [ CodeableConcept ], ... ; # 0..* Language of the name fhir:SubstanceSpecification.name.domain [ CodeableConcept ], ... ; # 0..* The use context of this name for example if there is a different name a drug active ingredient as opposed to a food colour additive fhir:SubstanceSpecification.name.jurisdiction [ CodeableConcept ], ... ; # 0..* The jurisdiction where this name applies fhir:SubstanceSpecification.name.synonym [ See SubstanceSpecification.name ], ... ; # 0..* A synonym of this name fhir:SubstanceSpecification.name.translation [ See SubstanceSpecification.name ], ... ; # 0..* A translation for this name fhir:SubstanceSpecification.name.official [ # 0..* Details of the official nature of this name fhir:SubstanceSpecification.name.official.authority [ CodeableConcept ]; # 0..1 Which authority uses this official name fhir:SubstanceSpecification.name.official.status [ CodeableConcept ]; # 0..1 The status of the official name fhir:SubstanceSpecification.name.official.date [ dateTime ]; # 0..1 Date of official name change ], ...; fhir:SubstanceSpecification.name.source [ Reference(DocumentReference) ], ... ; # 0..* Supporting literature ], ...; fhir:SubstanceSpecification.molecularWeight [ See SubstanceSpecification.structure.isotope.molecularWeight ], ... ; # 0..* The molecular weight or weight range (for proteins, polymers or nucleic acids) fhir:SubstanceSpecification.relationship [ # 0..* A link between this substance and another, with details of the relationship # SubstanceSpecification.relationship.substance[x] : 0..1 A pointer to another substance, as a resource or just a representational code. One of these 2 fhir:SubstanceSpecification.relationship.substanceReference [ Reference(SubstanceSpecification) ] fhir:SubstanceSpecification.relationship.substanceCodeableConcept [ CodeableConcept ] fhir:SubstanceSpecification.relationship.relationship [ CodeableConcept ]; # 0..1 For example "salt to parent", "active moiety", "starting material" fhir:SubstanceSpecification.relationship.isDefining [ boolean ]; # 0..1 For example where an enzyme strongly bonds with a particular substance, this is a defining relationship for that enzyme, out of several possible substance relationships # SubstanceSpecification.relationship.amount[x] : 0..1 A numeric factor for the relationship, for instance to express that the salt of a substance has some percentage of the active substance in relation to some other. One of these 4 fhir:SubstanceSpecification.relationship.amountQuantity [ Quantity ] fhir:SubstanceSpecification.relationship.amountRange [ Range ] fhir:SubstanceSpecification.relationship.amountRatio [ Ratio ] fhir:SubstanceSpecification.relationship.amountString [ string ] fhir:SubstanceSpecification.relationship.amountRatioLowLimit [ Ratio ]; # 0..1 For use when the numeric fhir:SubstanceSpecification.relationship.amountType [ CodeableConcept ]; # 0..1 An operator for the amount, for example "average", "approximately", "less than" fhir:SubstanceSpecification.relationship.source [ Reference(DocumentReference) ], ... ; # 0..* Supporting literature ], ...; fhir:SubstanceSpecification.nucleicAcid [ Reference(SubstanceNucleicAcid) ]; # 0..1 Data items specific to nucleic acids fhir:SubstanceSpecification.polymer [ Reference(SubstancePolymer) ]; # 0..1 Data items specific to polymers fhir:SubstanceSpecification.protein [ Reference(SubstanceProtein) ]; # 0..1 Data items specific to proteins fhir:SubstanceSpecification.sourceMaterial [ Reference(SubstanceSourceMaterial) ]; # 0..1 Material or taxonomic/anatomical source for the substance ]
Structure
Name | Flags | Card. | Type | Description & Constraints |
---|---|---|---|---|
SubstanceSpecification | ΣTU | DomainResource | The detailed description of a substance, typically at a level beyond what is used for prescribing Elements defined in Ancestors: id, meta, implicitRules, language, text, contained, extension, modifierExtension | |
identifier | Σ | 0..1 | Identifier | Identifier by which this substance is known |
type | Σ | 0..1 | CodeableConcept | High level categorization, e.g. polymer or nucleic acid |
status | Σ | 0..1 | CodeableConcept | Status of substance within the catalogue e.g. approved |
domain | Σ | 0..1 | CodeableConcept | If the substance applies to only human or veterinary use |
description | Σ | 0..1 | string | Textual description of the substance |
source | Σ | 0..* | Reference(DocumentReference) | Supporting literature |
comment | Σ | 0..1 | string | Textual comment about this record of a substance |
moiety | Σ | 0..* | BackboneElement | Moiety, for structural modifications |
role | Σ | 0..1 | CodeableConcept | Role that the moiety is playing |
identifier | Σ | 0..1 | Identifier | Identifier by which this moiety substance is known |
name | Σ | 0..1 | string | Textual name for this moiety substance |
stereochemistry | Σ | 0..1 | CodeableConcept | Stereochemistry type |
opticalActivity | Σ | 0..1 | CodeableConcept | Optical activity type |
molecularFormula | Σ | 0..1 | string | Molecular formula |
amount[x] | Σ | 0..1 | Quantitative value for this moiety | |
amountQuantity | Quantity | |||
amountString | string | |||
property | Σ | 0..* | BackboneElement | General specifications for this substance, including how it is related to other substances |
category | Σ | 0..1 | CodeableConcept | A category for this property, e.g. Physical, Chemical, Enzymatic |
code | Σ | 0..1 | CodeableConcept | Property type e.g. viscosity, pH, isoelectric point |
parameters | Σ | 0..1 | string | Parameters that were used in the measurement of a property (e.g. for viscosity: measured at 20C with a pH of 7.1) |
definingSubstance[x] | Σ | 0..1 | A substance upon which a defining property depends (e.g. for solubility: in water, in alcohol) | |
definingSubstanceReference | Reference(SubstanceSpecification | Substance) | |||
definingSubstanceCodeableConcept | CodeableConcept | |||
amount[x] | Σ | 0..1 | Quantitative value for this property | |
amountQuantity | Quantity | |||
amountString | string | |||
referenceInformation | Σ | 0..1 | Reference(SubstanceReferenceInformation) | General information detailing this substance |
structure | Σ | 0..1 | BackboneElement | Structural information |
stereochemistry | Σ | 0..1 | CodeableConcept | Stereochemistry type |
opticalActivity | Σ | 0..1 | CodeableConcept | Optical activity type |
molecularFormula | Σ | 0..1 | string | Molecular formula |
molecularFormulaByMoiety | Σ | 0..1 | string | Specified per moiety according to the Hill system, i.e. first C, then H, then alphabetical, each moiety separated by a dot |
isotope | Σ | 0..* | BackboneElement | Applicable for single substances that contain a radionuclide or a non-natural isotopic ratio |
identifier | Σ | 0..1 | Identifier | Substance identifier for each non-natural or radioisotope |
name | Σ | 0..1 | CodeableConcept | Substance name for each non-natural or radioisotope |
substitution | Σ | 0..1 | CodeableConcept | The type of isotopic substitution present in a single substance |
halfLife | Σ | 0..1 | Quantity | Half life - for a non-natural nuclide |
molecularWeight | Σ | 0..1 | BackboneElement | The molecular weight or weight range (for proteins, polymers or nucleic acids) |
method | Σ | 0..1 | CodeableConcept | The method by which the molecular weight was determined |
type | Σ | 0..1 | CodeableConcept | Type of molecular weight such as exact, average (also known as. number average), weight average |
amount | Σ | 0..1 | Quantity | Used to capture quantitative values for a variety of elements. If only limits are given, the arithmetic mean would be the average. If only a single definite value for a given element is given, it would be captured in this field |
molecularWeight | Σ | 0..1 | see molecularWeight | The molecular weight or weight range (for proteins, polymers or nucleic acids) |
source | Σ | 0..* | Reference(DocumentReference) | Supporting literature |
representation | Σ | 0..* | BackboneElement | Molecular structural representation |
type | Σ | 0..1 | CodeableConcept | The type of structure (e.g. Full, Partial, Representative) |
representation | Σ | 0..1 | string | The structural representation as text string in a format e.g. InChI, SMILES, MOLFILE, CDX |
attachment | Σ | 0..1 | Attachment | An attached file with the structural representation |
code | Σ | 0..* | BackboneElement | Codes associated with the substance |
code | Σ | 0..1 | CodeableConcept | The specific code |
status | Σ | 0..1 | CodeableConcept | Status of the code assignment |
statusDate | Σ | 0..1 | dateTime | The date at which the code status is changed as part of the terminology maintenance |
comment | Σ | 0..1 | string | Any comment can be provided in this field, if necessary |
source | Σ | 0..* | Reference(DocumentReference) | Supporting literature |
name | Σ | 0..* | BackboneElement | Names applicable to this substance |
name | Σ | 1..1 | string | The actual name |
type | Σ | 0..1 | CodeableConcept | Name type |
status | Σ | 0..1 | CodeableConcept | The status of the name |
preferred | Σ | 0..1 | boolean | If this is the preferred name for this substance |
language | Σ | 0..* | CodeableConcept | Language of the name |
domain | Σ | 0..* | CodeableConcept | The use context of this name for example if there is a different name a drug active ingredient as opposed to a food colour additive |
jurisdiction | Σ | 0..* | CodeableConcept | The jurisdiction where this name applies |
synonym | Σ | 0..* | see name | A synonym of this name |
translation | Σ | 0..* | see name | A translation for this name |
official | Σ | 0..* | BackboneElement | Details of the official nature of this name |
authority | Σ | 0..1 | CodeableConcept | Which authority uses this official name |
status | Σ | 0..1 | CodeableConcept | The status of the official name |
date | Σ | 0..1 | dateTime | Date of official name change |
source | Σ | 0..* | Reference(DocumentReference) | Supporting literature |
molecularWeight | Σ | 0..* | see molecularWeight | The molecular weight or weight range (for proteins, polymers or nucleic acids) |
relationship | Σ | 0..* | BackboneElement | A link between this substance and another, with details of the relationship |
substance[x] | Σ | 0..1 | A pointer to another substance, as a resource or just a representational code | |
substanceReference | Reference(SubstanceSpecification) | |||
substanceCodeableConcept | CodeableConcept | |||
relationship | Σ | 0..1 | CodeableConcept | For example "salt to parent", "active moiety", "starting material" |
isDefining | Σ | 0..1 | boolean | For example where an enzyme strongly bonds with a particular substance, this is a defining relationship for that enzyme, out of several possible substance relationships |
amount[x] | Σ | 0..1 | A numeric factor for the relationship, for instance to express that the salt of a substance has some percentage of the active substance in relation to some other | |
amountQuantity | Quantity | |||
amountRange | Range | |||
amountRatio | Ratio | |||
amountString | string | |||
amountRatioLowLimit | Σ | 0..1 | Ratio | For use when the numeric |
amountType | Σ | 0..1 | CodeableConcept | An operator for the amount, for example "average", "approximately", "less than" |
source | Σ | 0..* | Reference(DocumentReference) | Supporting literature |
nucleicAcid | Σ | 0..1 | Reference(SubstanceNucleicAcid) | Data items specific to nucleic acids |
polymer | Σ | 0..1 | Reference(SubstancePolymer) | Data items specific to polymers |
protein | Σ | 0..1 | Reference(SubstanceProtein) | Data items specific to proteins |
sourceMaterial | Σ | 0..1 | Reference(SubstanceSourceMaterial) | Material or taxonomic/anatomical source for the substance |
Documentation for this format |
XML Template
<SubstanceSpecification xmlns="http://hl7.org/fhir"> <!-- from Resource: id, meta, implicitRules, and language --> <!-- from DomainResource: text, contained, extension, and modifierExtension --> <identifier><!-- 0..1 Identifier Identifier by which this substance is known --></identifier> <type><!-- 0..1 CodeableConcept High level categorization, e.g. polymer or nucleic acid --></type> <status><!-- 0..1 CodeableConcept Status of substance within the catalogue e.g. approved --></status> <domain><!-- 0..1 CodeableConcept If the substance applies to only human or veterinary use --></domain> <description value="[string]"/><!-- 0..1 Textual description of the substance --> <source><!-- 0..* Reference(DocumentReference) Supporting literature --></source> <comment value="[string]"/><!-- 0..1 Textual comment about this record of a substance --> <moiety> <!-- 0..* Moiety, for structural modifications --> <role><!-- 0..1 CodeableConcept Role that the moiety is playing --></role> <identifier><!-- 0..1 Identifier Identifier by which this moiety substance is known --></identifier> <name value="[string]"/><!-- 0..1 Textual name for this moiety substance --> <stereochemistry><!-- 0..1 CodeableConcept Stereochemistry type --></stereochemistry> <opticalActivity><!-- 0..1 CodeableConcept Optical activity type --></opticalActivity> <molecularFormula value="[string]"/><!-- 0..1 Molecular formula --> <amount[x]><!-- 0..1 Quantity|string Quantitative value for this moiety --></amount[x]> </moiety> <property> <!-- 0..* General specifications for this substance, including how it is related to other substances --> <category><!-- 0..1 CodeableConcept A category for this property, e.g. Physical, Chemical, Enzymatic --></category> <code><!-- 0..1 CodeableConcept Property type e.g. viscosity, pH, isoelectric point --></code> <parameters value="[string]"/><!-- 0..1 Parameters that were used in the measurement of a property (e.g. for viscosity: measured at 20C with a pH of 7.1) --> <definingSubstance[x]><!-- 0..1 Reference(SubstanceSpecification|Substance)| CodeableConcept A substance upon which a defining property depends (e.g. for solubility: in water, in alcohol) --></definingSubstance[x]> <amount[x]><!-- 0..1 Quantity|string Quantitative value for this property --></amount[x]> </property> <referenceInformation><!-- 0..1 Reference(SubstanceReferenceInformation) General information detailing this substance --></referenceInformation> <structure> <!-- 0..1 Structural information --> <stereochemistry><!-- 0..1 CodeableConcept Stereochemistry type --></stereochemistry> <opticalActivity><!-- 0..1 CodeableConcept Optical activity type --></opticalActivity> <molecularFormula value="[string]"/><!-- 0..1 Molecular formula --> <molecularFormulaByMoiety value="[string]"/><!-- 0..1 Specified per moiety according to the Hill system, i.e. first C, then H, then alphabetical, each moiety separated by a dot --> <isotope> <!-- 0..* Applicable for single substances that contain a radionuclide or a non-natural isotopic ratio --> <identifier><!-- 0..1 Identifier Substance identifier for each non-natural or radioisotope --></identifier> <name><!-- 0..1 CodeableConcept Substance name for each non-natural or radioisotope --></name> <substitution><!-- 0..1 CodeableConcept The type of isotopic substitution present in a single substance --></substitution> <halfLife><!-- 0..1 Quantity Half life - for a non-natural nuclide --></halfLife> <molecularWeight> <!-- 0..1 The molecular weight or weight range (for proteins, polymers or nucleic acids) --> <method><!-- 0..1 CodeableConcept The method by which the molecular weight was determined --></method> <type><!-- 0..1 CodeableConcept Type of molecular weight such as exact, average (also known as. number average), weight average --></type> <amount><!-- 0..1 Quantity Used to capture quantitative values for a variety of elements. If only limits are given, the arithmetic mean would be the average. If only a single definite value for a given element is given, it would be captured in this field --></amount> </molecularWeight> </isotope> <molecularWeight><!-- 0..1 Content as for SubstanceSpecification.structure.isotope.molecularWeight The molecular weight or weight range (for proteins, polymers or nucleic acids) --></molecularWeight> <source><!-- 0..* Reference(DocumentReference) Supporting literature --></source> <representation> <!-- 0..* Molecular structural representation --> <type><!-- 0..1 CodeableConcept The type of structure (e.g. Full, Partial, Representative) --></type> <representation value="[string]"/><!-- 0..1 The structural representation as text string in a format e.g. InChI, SMILES, MOLFILE, CDX --> <attachment><!-- 0..1 Attachment An attached file with the structural representation --></attachment> </representation> </structure> <code> <!-- 0..* Codes associated with the substance --> <code><!-- 0..1 CodeableConcept The specific code --></code> <status><!-- 0..1 CodeableConcept Status of the code assignment --></status> <statusDate value="[dateTime]"/><!-- 0..1 The date at which the code status is changed as part of the terminology maintenance --> <comment value="[string]"/><!-- 0..1 Any comment can be provided in this field, if necessary --> <source><!-- 0..* Reference(DocumentReference) Supporting literature --></source> </code> <name> <!-- 0..* Names applicable to this substance --> <name value="[string]"/><!-- 1..1 The actual name --> <type><!-- 0..1 CodeableConcept Name type --></type> <status><!-- 0..1 CodeableConcept The status of the name --></status> <preferred value="[boolean]"/><!-- 0..1 If this is the preferred name for this substance --> <language><!-- 0..* CodeableConcept Language of the name --></language> <domain><!-- 0..* CodeableConcept The use context of this name for example if there is a different name a drug active ingredient as opposed to a food colour additive --></domain> <jurisdiction><!-- 0..* CodeableConcept The jurisdiction where this name applies --></jurisdiction> <synonym><!-- 0..* Content as for SubstanceSpecification.name A synonym of this name --></synonym> <translation><!-- 0..* Content as for SubstanceSpecification.name A translation for this name --></translation> <official> <!-- 0..* Details of the official nature of this name --> <authority><!-- 0..1 CodeableConcept Which authority uses this official name --></authority> <status><!-- 0..1 CodeableConcept The status of the official name --></status> <date value="[dateTime]"/><!-- 0..1 Date of official name change --> </official> <source><!-- 0..* Reference(DocumentReference) Supporting literature --></source> </name> <molecularWeight><!-- 0..* Content as for SubstanceSpecification.structure.isotope.molecularWeight The molecular weight or weight range (for proteins, polymers or nucleic acids) --></molecularWeight> <relationship> <!-- 0..* A link between this substance and another, with details of the relationship --> <substance[x]><!-- 0..1 Reference(SubstanceSpecification)|CodeableConcept A pointer to another substance, as a resource or just a representational code --></substance[x]> <relationship><!-- 0..1 CodeableConcept For example "salt to parent", "active moiety", "starting material" --></relationship> <isDefining value="[boolean]"/><!-- 0..1 For example where an enzyme strongly bonds with a particular substance, this is a defining relationship for that enzyme, out of several possible substance relationships --> <amount[x]><!-- 0..1 Quantity|Range|Ratio|string A numeric factor for the relationship, for instance to express that the salt of a substance has some percentage of the active substance in relation to some other --></amount[x]> <amountRatioLowLimit><!-- 0..1 Ratio For use when the numeric --></amountRatioLowLimit> <amountType><!-- 0..1 CodeableConcept An operator for the amount, for example "average", "approximately", "less than" --></amountType> <source><!-- 0..* Reference(DocumentReference) Supporting literature --></source> </relationship> <nucleicAcid><!-- 0..1 Reference(SubstanceNucleicAcid) Data items specific to nucleic acids --></nucleicAcid> <polymer><!-- 0..1 Reference(SubstancePolymer) Data items specific to polymers --></polymer> <protein><!-- 0..1 Reference(SubstanceProtein) Data items specific to proteins --></protein> <sourceMaterial><!-- 0..1 Reference(SubstanceSourceMaterial) Material or taxonomic/anatomical source for the substance --></sourceMaterial> </SubstanceSpecification>
JSON Template
{ "resourceType" : "SubstanceSpecification", // from Resource: id, meta, implicitRules, and language // from DomainResource: text, contained, extension, and modifierExtension "identifier" : { Identifier }, // Identifier by which this substance is known "type" : { CodeableConcept }, // High level categorization, e.g. polymer or nucleic acid "status" : { CodeableConcept }, // Status of substance within the catalogue e.g. approved "domain" : { CodeableConcept }, // If the substance applies to only human or veterinary use "description" : "<string>", // Textual description of the substance "source" : [{ Reference(DocumentReference) }], // Supporting literature "comment" : "<string>", // Textual comment about this record of a substance "moiety" : [{ // Moiety, for structural modifications "role" : { CodeableConcept }, // Role that the moiety is playing "identifier" : { Identifier }, // Identifier by which this moiety substance is known "name" : "<string>", // Textual name for this moiety substance "stereochemistry" : { CodeableConcept }, // Stereochemistry type "opticalActivity" : { CodeableConcept }, // Optical activity type "molecularFormula" : "<string>", // Molecular formula // amount[x]: Quantitative value for this moiety. One of these 2: "amountQuantity" : { Quantity } "amountString" : "<string>" }], "property" : [{ // General specifications for this substance, including how it is related to other substances "category" : { CodeableConcept }, // A category for this property, e.g. Physical, Chemical, Enzymatic "code" : { CodeableConcept }, // Property type e.g. viscosity, pH, isoelectric point "parameters" : "<string>", // Parameters that were used in the measurement of a property (e.g. for viscosity: measured at 20C with a pH of 7.1) // definingSubstance[x]: A substance upon which a defining property depends (e.g. for solubility: in water, in alcohol). One of these 2: "definingSubstanceReference" : { Reference(SubstanceSpecification|Substance) }, "definingSubstanceCodeableConcept" : { CodeableConcept }, // amount[x]: Quantitative value for this property. One of these 2: "amountQuantity" : { Quantity } "amountString" : "<string>" }], "referenceInformation" : { Reference(SubstanceReferenceInformation) }, // General information detailing this substance "structure" : { // Structural information "stereochemistry" : { CodeableConcept }, // Stereochemistry type "opticalActivity" : { CodeableConcept }, // Optical activity type "molecularFormula" : "<string>", // Molecular formula "molecularFormulaByMoiety" : "<string>", // Specified per moiety according to the Hill system, i.e. first C, then H, then alphabetical, each moiety separated by a dot "isotope" : [{ // Applicable for single substances that contain a radionuclide or a non-natural isotopic ratio "identifier" : { Identifier }, // Substance identifier for each non-natural or radioisotope "name" : { CodeableConcept }, // Substance name for each non-natural or radioisotope "substitution" : { CodeableConcept }, // The type of isotopic substitution present in a single substance "halfLife" : { Quantity }, // Half life - for a non-natural nuclide "molecularWeight" : { // The molecular weight or weight range (for proteins, polymers or nucleic acids) "method" : { CodeableConcept }, // The method by which the molecular weight was determined "type" : { CodeableConcept }, // Type of molecular weight such as exact, average (also known as. number average), weight average "amount" : { Quantity } // Used to capture quantitative values for a variety of elements. If only limits are given, the arithmetic mean would be the average. If only a single definite value for a given element is given, it would be captured in this field } }], "molecularWeight" : { Content as for SubstanceSpecification.structure.isotope.molecularWeight }, // The molecular weight or weight range (for proteins, polymers or nucleic acids) "source" : [{ Reference(DocumentReference) }], // Supporting literature "representation" : [{ // Molecular structural representation "type" : { CodeableConcept }, // The type of structure (e.g. Full, Partial, Representative) "representation" : "<string>", // The structural representation as text string in a format e.g. InChI, SMILES, MOLFILE, CDX "attachment" : { Attachment } // An attached file with the structural representation }] }, "code" : [{ // Codes associated with the substance "code" : { CodeableConcept }, // The specific code "status" : { CodeableConcept }, // Status of the code assignment "statusDate" : "<dateTime>", // The date at which the code status is changed as part of the terminology maintenance "comment" : "<string>", // Any comment can be provided in this field, if necessary "source" : [{ Reference(DocumentReference) }] // Supporting literature }], "name" : [{ // Names applicable to this substance "name" : "<string>", // R! The actual name "type" : { CodeableConcept }, // Name type "status" : { CodeableConcept }, // The status of the name "preferred" : <boolean>, // If this is the preferred name for this substance "language" : [{ CodeableConcept }], // Language of the name "domain" : [{ CodeableConcept }], // The use context of this name for example if there is a different name a drug active ingredient as opposed to a food colour additive "jurisdiction" : [{ CodeableConcept }], // The jurisdiction where this name applies "synonym" : [{ Content as for SubstanceSpecification.name }], // A synonym of this name "translation" : [{ Content as for SubstanceSpecification.name }], // A translation for this name "official" : [{ // Details of the official nature of this name "authority" : { CodeableConcept }, // Which authority uses this official name "status" : { CodeableConcept }, // The status of the official name "date" : "<dateTime>" // Date of official name change }], "source" : [{ Reference(DocumentReference) }] // Supporting literature }], "molecularWeight" : [{ Content as for SubstanceSpecification.structure.isotope.molecularWeight }], // The molecular weight or weight range (for proteins, polymers or nucleic acids) "relationship" : [{ // A link between this substance and another, with details of the relationship // substance[x]: A pointer to another substance, as a resource or just a representational code. One of these 2: "substanceReference" : { Reference(SubstanceSpecification) }, "substanceCodeableConcept" : { CodeableConcept }, "relationship" : { CodeableConcept }, // For example "salt to parent", "active moiety", "starting material" "isDefining" : <boolean>, // For example where an enzyme strongly bonds with a particular substance, this is a defining relationship for that enzyme, out of several possible substance relationships // amount[x]: A numeric factor for the relationship, for instance to express that the salt of a substance has some percentage of the active substance in relation to some other. One of these 4: "amountQuantity" : { Quantity }, "amountRange" : { Range }, "amountRatio" : { Ratio }, "amountString" : "<string>", "amountRatioLowLimit" : { Ratio }, // For use when the numeric "amountType" : { CodeableConcept }, // An operator for the amount, for example "average", "approximately", "less than" "source" : [{ Reference(DocumentReference) }] // Supporting literature }], "nucleicAcid" : { Reference(SubstanceNucleicAcid) }, // Data items specific to nucleic acids "polymer" : { Reference(SubstancePolymer) }, // Data items specific to polymers "protein" : { Reference(SubstanceProtein) }, // Data items specific to proteins "sourceMaterial" : { Reference(SubstanceSourceMaterial) } // Material or taxonomic/anatomical source for the substance }
Turtle Template
@prefix fhir: <http://hl7.org/fhir/> . [ a fhir:SubstanceSpecification; 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:SubstanceSpecification.identifier [ Identifier ]; # 0..1 Identifier by which this substance is known fhir:SubstanceSpecification.type [ CodeableConcept ]; # 0..1 High level categorization, e.g. polymer or nucleic acid fhir:SubstanceSpecification.status [ CodeableConcept ]; # 0..1 Status of substance within the catalogue e.g. approved fhir:SubstanceSpecification.domain [ CodeableConcept ]; # 0..1 If the substance applies to only human or veterinary use fhir:SubstanceSpecification.description [ string ]; # 0..1 Textual description of the substance fhir:SubstanceSpecification.source [ Reference(DocumentReference) ], ... ; # 0..* Supporting literature fhir:SubstanceSpecification.comment [ string ]; # 0..1 Textual comment about this record of a substance fhir:SubstanceSpecification.moiety [ # 0..* Moiety, for structural modifications fhir:SubstanceSpecification.moiety.role [ CodeableConcept ]; # 0..1 Role that the moiety is playing fhir:SubstanceSpecification.moiety.identifier [ Identifier ]; # 0..1 Identifier by which this moiety substance is known fhir:SubstanceSpecification.moiety.name [ string ]; # 0..1 Textual name for this moiety substance fhir:SubstanceSpecification.moiety.stereochemistry [ CodeableConcept ]; # 0..1 Stereochemistry type fhir:SubstanceSpecification.moiety.opticalActivity [ CodeableConcept ]; # 0..1 Optical activity type fhir:SubstanceSpecification.moiety.molecularFormula [ string ]; # 0..1 Molecular formula # SubstanceSpecification.moiety.amount[x] : 0..1 Quantitative value for this moiety. One of these 2 fhir:SubstanceSpecification.moiety.amountQuantity [ Quantity ] fhir:SubstanceSpecification.moiety.amountString [ string ] ], ...; fhir:SubstanceSpecification.property [ # 0..* General specifications for this substance, including how it is related to other substances fhir:SubstanceSpecification.property.category [ CodeableConcept ]; # 0..1 A category for this property, e.g. Physical, Chemical, Enzymatic fhir:SubstanceSpecification.property.code [ CodeableConcept ]; # 0..1 Property type e.g. viscosity, pH, isoelectric point fhir:SubstanceSpecification.property.parameters [ string ]; # 0..1 Parameters that were used in the measurement of a property (e.g. for viscosity: measured at 20C with a pH of 7.1) # SubstanceSpecification.property.definingSubstance[x] : 0..1 A substance upon which a defining property depends (e.g. for solubility: in water, in alcohol). One of these 2 fhir:SubstanceSpecification.property.definingSubstanceReference [ Reference(SubstanceSpecification|Substance) ] fhir:SubstanceSpecification.property.definingSubstanceCodeableConcept [ CodeableConcept ] # SubstanceSpecification.property.amount[x] : 0..1 Quantitative value for this property. One of these 2 fhir:SubstanceSpecification.property.amountQuantity [ Quantity ] fhir:SubstanceSpecification.property.amountString [ string ] ], ...; fhir:SubstanceSpecification.referenceInformation [ Reference(SubstanceReferenceInformation) ]; # 0..1 General information detailing this substance fhir:SubstanceSpecification.structure [ # 0..1 Structural information fhir:SubstanceSpecification.structure.stereochemistry [ CodeableConcept ]; # 0..1 Stereochemistry type fhir:SubstanceSpecification.structure.opticalActivity [ CodeableConcept ]; # 0..1 Optical activity type fhir:SubstanceSpecification.structure.molecularFormula [ string ]; # 0..1 Molecular formula fhir:SubstanceSpecification.structure.molecularFormulaByMoiety [ string ]; # 0..1 Specified per moiety according to the Hill system, i.e. first C, then H, then alphabetical, each moiety separated by a dot fhir:SubstanceSpecification.structure.isotope [ # 0..* Applicable for single substances that contain a radionuclide or a non-natural isotopic ratio fhir:SubstanceSpecification.structure.isotope.identifier [ Identifier ]; # 0..1 Substance identifier for each non-natural or radioisotope fhir:SubstanceSpecification.structure.isotope.name [ CodeableConcept ]; # 0..1 Substance name for each non-natural or radioisotope fhir:SubstanceSpecification.structure.isotope.substitution [ CodeableConcept ]; # 0..1 The type of isotopic substitution present in a single substance fhir:SubstanceSpecification.structure.isotope.halfLife [ Quantity ]; # 0..1 Half life - for a non-natural nuclide fhir:SubstanceSpecification.structure.isotope.molecularWeight [ # 0..1 The molecular weight or weight range (for proteins, polymers or nucleic acids) fhir:SubstanceSpecification.structure.isotope.molecularWeight.method [ CodeableConcept ]; # 0..1 The method by which the molecular weight was determined fhir:SubstanceSpecification.structure.isotope.molecularWeight.type [ CodeableConcept ]; # 0..1 Type of molecular weight such as exact, average (also known as. number average), weight average fhir:SubstanceSpecification.structure.isotope.molecularWeight.amount [ Quantity ]; # 0..1 Used to capture quantitative values for a variety of elements. If only limits are given, the arithmetic mean would be the average. If only a single definite value for a given element is given, it would be captured in this field ]; ], ...; fhir:SubstanceSpecification.structure.molecularWeight [ See SubstanceSpecification.structure.isotope.molecularWeight ]; # 0..1 The molecular weight or weight range (for proteins, polymers or nucleic acids) fhir:SubstanceSpecification.structure.source [ Reference(DocumentReference) ], ... ; # 0..* Supporting literature fhir:SubstanceSpecification.structure.representation [ # 0..* Molecular structural representation fhir:SubstanceSpecification.structure.representation.type [ CodeableConcept ]; # 0..1 The type of structure (e.g. Full, Partial, Representative) fhir:SubstanceSpecification.structure.representation.representation [ string ]; # 0..1 The structural representation as text string in a format e.g. InChI, SMILES, MOLFILE, CDX fhir:SubstanceSpecification.structure.representation.attachment [ Attachment ]; # 0..1 An attached file with the structural representation ], ...; ]; fhir:SubstanceSpecification.code [ # 0..* Codes associated with the substance fhir:SubstanceSpecification.code.code [ CodeableConcept ]; # 0..1 The specific code fhir:SubstanceSpecification.code.status [ CodeableConcept ]; # 0..1 Status of the code assignment fhir:SubstanceSpecification.code.statusDate [ dateTime ]; # 0..1 The date at which the code status is changed as part of the terminology maintenance fhir:SubstanceSpecification.code.comment [ string ]; # 0..1 Any comment can be provided in this field, if necessary fhir:SubstanceSpecification.code.source [ Reference(DocumentReference) ], ... ; # 0..* Supporting literature ], ...; fhir:SubstanceSpecification.name [ # 0..* Names applicable to this substance fhir:SubstanceSpecification.name.name [ string ]; # 1..1 The actual name fhir:SubstanceSpecification.name.type [ CodeableConcept ]; # 0..1 Name type fhir:SubstanceSpecification.name.status [ CodeableConcept ]; # 0..1 The status of the name fhir:SubstanceSpecification.name.preferred [ boolean ]; # 0..1 If this is the preferred name for this substance fhir:SubstanceSpecification.name.language [ CodeableConcept ], ... ; # 0..* Language of the name fhir:SubstanceSpecification.name.domain [ CodeableConcept ], ... ; # 0..* The use context of this name for example if there is a different name a drug active ingredient as opposed to a food colour additive fhir:SubstanceSpecification.name.jurisdiction [ CodeableConcept ], ... ; # 0..* The jurisdiction where this name applies fhir:SubstanceSpecification.name.synonym [ See SubstanceSpecification.name ], ... ; # 0..* A synonym of this name fhir:SubstanceSpecification.name.translation [ See SubstanceSpecification.name ], ... ; # 0..* A translation for this name fhir:SubstanceSpecification.name.official [ # 0..* Details of the official nature of this name fhir:SubstanceSpecification.name.official.authority [ CodeableConcept ]; # 0..1 Which authority uses this official name fhir:SubstanceSpecification.name.official.status [ CodeableConcept ]; # 0..1 The status of the official name fhir:SubstanceSpecification.name.official.date [ dateTime ]; # 0..1 Date of official name change ], ...; fhir:SubstanceSpecification.name.source [ Reference(DocumentReference) ], ... ; # 0..* Supporting literature ], ...; fhir:SubstanceSpecification.molecularWeight [ See SubstanceSpecification.structure.isotope.molecularWeight ], ... ; # 0..* The molecular weight or weight range (for proteins, polymers or nucleic acids) fhir:SubstanceSpecification.relationship [ # 0..* A link between this substance and another, with details of the relationship # SubstanceSpecification.relationship.substance[x] : 0..1 A pointer to another substance, as a resource or just a representational code. One of these 2 fhir:SubstanceSpecification.relationship.substanceReference [ Reference(SubstanceSpecification) ] fhir:SubstanceSpecification.relationship.substanceCodeableConcept [ CodeableConcept ] fhir:SubstanceSpecification.relationship.relationship [ CodeableConcept ]; # 0..1 For example "salt to parent", "active moiety", "starting material" fhir:SubstanceSpecification.relationship.isDefining [ boolean ]; # 0..1 For example where an enzyme strongly bonds with a particular substance, this is a defining relationship for that enzyme, out of several possible substance relationships # SubstanceSpecification.relationship.amount[x] : 0..1 A numeric factor for the relationship, for instance to express that the salt of a substance has some percentage of the active substance in relation to some other. One of these 4 fhir:SubstanceSpecification.relationship.amountQuantity [ Quantity ] fhir:SubstanceSpecification.relationship.amountRange [ Range ] fhir:SubstanceSpecification.relationship.amountRatio [ Ratio ] fhir:SubstanceSpecification.relationship.amountString [ string ] fhir:SubstanceSpecification.relationship.amountRatioLowLimit [ Ratio ]; # 0..1 For use when the numeric fhir:SubstanceSpecification.relationship.amountType [ CodeableConcept ]; # 0..1 An operator for the amount, for example "average", "approximately", "less than" fhir:SubstanceSpecification.relationship.source [ Reference(DocumentReference) ], ... ; # 0..* Supporting literature ], ...; fhir:SubstanceSpecification.nucleicAcid [ Reference(SubstanceNucleicAcid) ]; # 0..1 Data items specific to nucleic acids fhir:SubstanceSpecification.polymer [ Reference(SubstancePolymer) ]; # 0..1 Data items specific to polymers fhir:SubstanceSpecification.protein [ Reference(SubstanceProtein) ]; # 0..1 Data items specific to proteins fhir:SubstanceSpecification.sourceMaterial [ Reference(SubstanceSourceMaterial) ]; # 0..1 Material or taxonomic/anatomical source for the substance ]
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
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 |
code | token | The specific code | SubstanceSpecification.code.code |