STU 2 Ballot

This page is part of the Data Access Framework (v1.6.0: STU 2 Ballot 1) based on FHIR v1.6.0. . For a full list of available versions, see the Directory of published versions

D.4.1 StructureDefinition: DAF-core-allergyintolerance

U.S. Data Access Framework (DAF) Core AllergyIntolerance Profile

Scope and Usage

This profile sets minimum expectations for the AllergyIntolerance resource to record, search and fetch allergies/adverse events associated with a patient. It identifies the mandatory core elements, extensions, vocabularies and value sets which SHALL be present in the AllergyIntolerance resource when using this profile.

Example Usage Scenarios:

The following are example usage scenarios for the DAF-Core AllergyIntolerance profile:

  • Query for allergies belonging to a Patient
  • Query for all patients who have a specific allergy
Mandatory Data Elements and Terminology

The following data-elements are mandatory (i.e data MUST be present). These are presented below in a simple human-readable explanation. Profile specific guidance and an example are provided as well. The Formal Profile Definition below provides the formal summary, definitions, and terminology requirements.

Each AllergyIntolerance must have:

  1. a status of the allergy
  2. a code which tells you what the patient is allergic to
  3. a patient

Profile specific implementation guidance:

  • Representing No Known Allergies: No Known Allergies will be represented using the DAF-AllergyIntolerance profile with appropriate negation code in AllergyIntolerence.code.

Example Usage Scenarios

The following are example usage scenarios for the DAF-AllergyIntolerance profile:

  • Query for allergies belonging to a Patient
  • Query for all patients who have had a specific allergy category
  • Query for allergies experienced during a time period
  • Query for allergies for a patient for a specific category
  • Query for allergies based on reaction and severity
Example: AllergyIntolerance Example: example

D.4.1.1 Formal Views of Profile Content

The official URL for this profile is:

http://hl7.org/fhir/us/daf/StructureDefinition/daf-core-allergyintolerance

This profile was published on Mon Aug 01 00:00:00 AEST 2016 as a draft by Health Level Seven International (FHIR - Infrastructure).

Description of Profiles, Differentials, Snapshots, and how the XML and JSON presentations work.

This structure is derived from AllergyIntolerance

Summary of the Mandatory Requirements

  1. One status in AllergyIntolerance.status which has an required binding to:
  2. One Identification of a substance, or a class of substances, that is considered to be responsible for the adverse reaction risk in AllergyIntolerance.code which has an extensible binding to:
  3. One patient reference in AllergyIntolerance.patient
NameFlagsCard.TypeDescription & Constraintsdoco
.. AllergyIntolerance I0..*Allergy or Intolerance (generally: Risk of adverse reaction to a substance)
dom-2: If the resource is contained in another resource, it SHALL NOT contain nested Resources
dom-1: If the resource is contained in another resource, it SHALL NOT contain any narrative
dom-4: If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated
dom-3: If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource
... id 0..1idLogical id of this artifact
... meta 0..1MetaMetadata about the resource
... implicitRules ?!0..1uriA set of rules under which this content was created
... language 0..1codeLanguage of the resource content
Binding: Common Languages (extensible)
... text I0..1NarrativeText summary of the resource, for human interpretation
... contained 0..*ResourceContained, inline Resources
... extension 0..*ExtensionAdditional Content defined by implementations
... modifierExtension ?!0..*ExtensionExtensions that cannot be ignored
... identifier 0..*IdentifierExternal ids for this item
... status ?!S1..1codeactive | active-confirmed | inactive | resolved | refuted | entered-in-error
Binding: AllergyIntoleranceStatus (required)
... type 0..1codeallergy | intolerance - Underlying mechanism (if known)
Binding: AllergyIntoleranceType (required)
... category 0..1codefood | medication | biologic | environment
Binding: AllergyIntoleranceCategory (required)
... criticality 0..1codelow | high | unable-to-assess
Binding: AllergyIntoleranceCriticality (required)
... code S1..1CodeableConceptAllergy or intolerance code
Binding: DAF Substance-Reactant for Intolerance and Negation Codes (extensible)
... patient S1..1Reference(Profile daf-core-patient)Who the sensitivity is for
... attestedDate 0..1dateTimeDate record was believed accurate
... recorder 0..1Reference(Practitioner | Patient)Who recorded the sensitivity
... reporter 0..1Reference(Patient | RelatedPerson | Practitioner)Source of the information about the allergy
... onset 0..1dateTimeDate(/time) when manifestations showed
... lastOccurrence 0..1dateTimeDate(/time) of last known occurrence of a reaction
... note 0..*AnnotationAdditional text not captured in other fields
... reaction 0..*BackboneElementAdverse Reaction Events linked to exposure to substance
.... id 0..1stringxml:id (or equivalent in JSON)
.... extension 0..*ExtensionAdditional Content defined by implementations
.... modifierExtension ?!0..*ExtensionExtensions that cannot be ignored
.... substance 0..1CodeableConceptSpecific substance or pharmaceutical product considered to be responsible for event
Binding: Substance Code (example)
.... certainty 0..1codeunlikely | likely | confirmed - clinical certainty about the specific substance
Binding: AllergyIntoleranceCertainty (required)
.... manifestation 1..*CodeableConceptClinical symptoms/signs associated with the Event
Binding: SNOMED CT Clinical Findings (example)
.... description 0..1stringDescription of the event as a whole
.... onset 0..1dateTimeDate(/time) when manifestations showed
.... severity 0..1codemild | moderate | severe (of event as a whole)
Binding: AllergyIntoleranceSeverity (required)
.... exposureRoute 0..1CodeableConceptHow the subject was exposed to the substance
Binding: SNOMED CT Route Codes (example)
.... note 0..*AnnotationText about event not captured in other fields

doco Documentation for this format

yet to be done: Xml template

yet to be done: Json template

This structure is derived from AllergyIntolerance

Summary

Mandatory: 3 elements
Must-Support: 3 elements

Structures

This structure refers to these other structures:

Snapshot View

NameFlagsCard.TypeDescription & Constraintsdoco
.. AllergyIntolerance I0..*Allergy or Intolerance (generally: Risk of adverse reaction to a substance)
dom-2: If the resource is contained in another resource, it SHALL NOT contain nested Resources
dom-1: If the resource is contained in another resource, it SHALL NOT contain any narrative
dom-4: If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated
dom-3: If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource
... id 0..1idLogical id of this artifact
... meta 0..1MetaMetadata about the resource
... implicitRules ?!0..1uriA set of rules under which this content was created
... language 0..1codeLanguage of the resource content
Binding: Common Languages (extensible)
... text I0..1NarrativeText summary of the resource, for human interpretation
... contained 0..*ResourceContained, inline Resources
... extension 0..*ExtensionAdditional Content defined by implementations
... modifierExtension ?!0..*ExtensionExtensions that cannot be ignored
... identifier 0..*IdentifierExternal ids for this item
... status ?!S1..1codeactive | active-confirmed | inactive | resolved | refuted | entered-in-error
Binding: AllergyIntoleranceStatus (required)
... type 0..1codeallergy | intolerance - Underlying mechanism (if known)
Binding: AllergyIntoleranceType (required)
... category 0..1codefood | medication | biologic | environment
Binding: AllergyIntoleranceCategory (required)
... criticality 0..1codelow | high | unable-to-assess
Binding: AllergyIntoleranceCriticality (required)
... code S1..1CodeableConceptAllergy or intolerance code
Binding: DAF Substance-Reactant for Intolerance and Negation Codes (extensible)
... patient S1..1Reference(Profile daf-core-patient)Who the sensitivity is for
... attestedDate 0..1dateTimeDate record was believed accurate
... recorder 0..1Reference(Practitioner | Patient)Who recorded the sensitivity
... reporter 0..1Reference(Patient | RelatedPerson | Practitioner)Source of the information about the allergy
... onset 0..1dateTimeDate(/time) when manifestations showed
... lastOccurrence 0..1dateTimeDate(/time) of last known occurrence of a reaction
... note 0..*AnnotationAdditional text not captured in other fields
... reaction 0..*BackboneElementAdverse Reaction Events linked to exposure to substance
.... id 0..1stringxml:id (or equivalent in JSON)
.... extension 0..*ExtensionAdditional Content defined by implementations
.... modifierExtension ?!0..*ExtensionExtensions that cannot be ignored
.... substance 0..1CodeableConceptSpecific substance or pharmaceutical product considered to be responsible for event
Binding: Substance Code (example)
.... certainty 0..1codeunlikely | likely | confirmed - clinical certainty about the specific substance
Binding: AllergyIntoleranceCertainty (required)
.... manifestation 1..*CodeableConceptClinical symptoms/signs associated with the Event
Binding: SNOMED CT Clinical Findings (example)
.... description 0..1stringDescription of the event as a whole
.... onset 0..1dateTimeDate(/time) when manifestations showed
.... severity 0..1codemild | moderate | severe (of event as a whole)
Binding: AllergyIntoleranceSeverity (required)
.... exposureRoute 0..1CodeableConceptHow the subject was exposed to the substance
Binding: SNOMED CT Route Codes (example)
.... note 0..*AnnotationText about event not captured in other fields

doco Documentation for this format

XML Template

yet to be done: Xml template

JSON Template

yet to be done: Json template

Downloads: StructureDefinition: (XML, JSON), Schema: XML Schematron

 

D.4.1.2 Terminology Bindings

Terminology Bindings

PathNameConformanceValueSet
AllergyIntolerance.languageCommon LanguagesextensibleCommon Languages
AllergyIntolerance.statusAllergyIntoleranceStatusrequiredAllergyIntoleranceStatus
AllergyIntolerance.typeAllergyIntoleranceTyperequiredAllergyIntoleranceType
AllergyIntolerance.categoryAllergyIntoleranceCategoryrequiredAllergyIntoleranceCategory
AllergyIntolerance.criticalityAllergyIntoleranceCriticalityrequiredAllergyIntoleranceCriticality
AllergyIntolerance.codeDAF Substance-Reactant for Intolerance and Negation CodesextensibleDAF Substance-Reactant for Intolerance and Negation Codes
AllergyIntolerance.reaction.substanceSubstance CodeexampleSubstance Code
AllergyIntolerance.reaction.certaintyAllergyIntoleranceCertaintyrequiredAllergyIntoleranceCertainty
AllergyIntolerance.reaction.manifestationSNOMED CT Clinical FindingsexampleSNOMED CT Clinical Findings
AllergyIntolerance.reaction.severityAllergyIntoleranceSeverityrequiredAllergyIntoleranceSeverity
AllergyIntolerance.reaction.exposureRouteSNOMED CT Route CodesexampleSNOMED CT Route Codes

D.4.1.3 Constraints

Constraints

IdPathDetailsRequirements
dom-2AllergyIntoleranceIf the resource is contained in another resource, it SHALL NOT contain nested Resources
XPath: not(parent::f:contained and f:contained)
dom-1AllergyIntoleranceIf the resource is contained in another resource, it SHALL NOT contain any narrative
XPath: not(parent::f:contained and f:text)
dom-4AllergyIntoleranceIf a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated
XPath: not(exists(f:contained/*/f:meta/f:versionId)) and not(exists(f:contained/*/f:meta/f:lastUpdated))
dom-3AllergyIntoleranceIf the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource
XPath: not(exists(for $id in f:contained/*/@id return $id[not(ancestor::f:contained/parent::*/descendant::f:reference/@value=concat('#', $id))]))
.