2nd DSTU Draft For Comment

This page is part of the FHIR Specification (v0.4.0: DSTU 2 Draft). The current version which supercedes this version is 5.0.0. For a full list of available versions, see the Directory of published versions

U.S. Data Access Framework (DAF) AllergyIntolerance Profile (Conformance Package)

Scope and Usage

This profile sets expectations for use of the AllergyIntolerance resource to record allergies/adverse events associated with a patient within the Data Access Framework (DAF) Implementation Guide. This profile identifies which core elements,extensions,vocabularies and value sets must be supported by DAF actors.

For the purposes of this profile, Supported means the following:

    SearchParameters:

  • DAF Query Requestor (client) SHALL be capable of querying the AllergyIntolerance resource using one or more of the search parameters for data elements tagged as MUST SUPPORT in this profile.
  • DAF Query Responder (server) SHALL be capable of receiving the queries submitted by the DAF Query Requestor and provide Query Results or error responses per the FHIR specifications.
  • DAF Query Responder MAY provide valid or error responses when the query parameters submitted contain data elements which are not tagged as MUST SUPPORT by this profile.

    • Query Results:

  • Query Results returned by DAF Query Responder SHOULD contain the data elements identified as MUST SUPPORT in the profile.
  • Query Results returned MAY contain data elements not tagged as MUST SUPPORT by the this profile.
  • Query Requestor SHALL process the Query Results containing additional data elements without indicating that the response is an erroneous response.

    • Missing Information:

  • When Query Results do not contain a particular data element identified as MUST SUPPORT, Query Requestors SHALL interpret the results to mean that the Query Responder did not have information and there is no further qualifying information as to why the information is missing.
  • In cases, where the Query Responder knows precisely the reason why the data is missing (e.g notasked in the data-absent-reason value set), then Query Responders MAY provide this additional information using the extension element as part of the data element. Query Requestors SHALL correctly process the data-absent-reason extension without rejecting the response as an erroneous response.

Relationship to Meaningful Use

The DAF AllergyIntolerance profile provides a mapping for the following Meaningful Use data elements to FHIR data elements.


Meaningful Use Data Element Name FHIR Resource Mapping
Allergy Substance AllergyIntolerance.substance
Allergy/Adverse Event Type AllergyIntolerance.category
Allergy Status AllergyIntolerance.status
Allergy Reaction AllergyIntolerance.event.manifestation
Allergy Severity AllergyIntolerance.event.severity
Allergy Intolerance Event Duration AllergyIntolerance.event.duration
Allergy Intolerance Occurrence Date AllergyIntolerance.event.onset

Boundaries and Relationships

This profile relies on the use of other profiles, some required, others available for use "when necessary":

  • DAFPatient which defines DAF Patient profile used by AllergyIntolerance.subject.
  • US Core which defines common properties related to Patient such as race and ethnicity.
  • FHIR Extensibility defines how extensions can be applied to FHIR resources and data types. Specifically the data-absent-reason extension is used to code data elements with missing information when appropriate.

Profile Details

Profiles:
DAFAllergyIntoleranceDefines constraints and extensions on the AllergyIntolerance resource for use in querying and retrieving allergy information. : U.S. Data Access Framework (DAF) AllergyIntolerance Profile

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

Additional Implementation Guidance

Implementers need to be mindful of the following during their implementation

    Representing No Known Allergies: No Known Allergies will be represented using the DAFAllergyIntolerance List with no entries and with an empty reason.

    Specifying Patients as part of the AllergyIntolerance Queries: DAF AllergyIntolerance profile supports the querying the AllergyIntolerances for a particular patient. In order to achieve this in implementation, it is recommended to use Patient.identifier field to precisely identify the allergies relevant to the patient. While other parameters such as Patient.name, Patient.given could be used for the query, it could lead to incorrect Patient matching and/or inefficient queries when systems are not tuned.

    Patient Matching: Patient Matching rules and criteria have to be evaluated by the implementing organization and have to comply with local policies and regulations. Query Requestors will have to deal with result sets that can return zero,one or more AllergyIntolerance Resources in response to a query.