Difference between Version 1.0.0 and 2.0.0

This page lists the differences for resource profile definitions between Version 1.0.0 and this Version 2.0.0 of the PCR FHIR implementation guide. The purpose is to help implementers who are supporting Version 1.0.0 understand the necessary changes required to migrate to Version 2.0.0. At this point, both versions will be supported by Ontario Health.

MustSupport:

This implementation guide introduces the "MustSupport" flag to identify elements that implementers must be aware of in order to query data from the PCR. Refer to the Implementation Guidelines for additional details on how to interpet the "MustSupport" flag.

MIME types:

MIME types used in the query parameter "_format" have changed in FHIR. The following values should now be used:

• JSON(preferred): application/fhir+json

• XML: application/fhir+xml

Refer to the Implementation Guidelines for additional details on supported Content Types and Encodings.

meta.profile value change in all resource profile definitions:

The resource.meta.profile will contain the new canonical URI for all PCR profiles. For example in pcr-patient-response, the meta.profile value will be http://ehealthontario.ca/fhir/StructureDefinition/ca-on-pcr-profile-Patient|2.0.0

Please refer to the table below for the new canonical URIs:

Profile Version 1.0.0 Canonical URI Version 2.0.0 Canonical URI
Patient Response Profile http://ehealthontario.ca/fhir/StructureDefinition/pcr-patient-response http://ehealthontario.ca/fhir/StructureDefinition/ca-on-pcr-profile-Patient
Patient EMPI Match Request Profile http://ehealthontario.ca/fhir/StructureDefinition/pcr-patient-matchreq http://ehealthontario.ca/fhir/StructureDefinition/ca-on-pcr-matchreq-profile-Patient
Bundle Response Profile http://ehealthontario.ca/fhir/StructureDefinition/pcr-bundle-response http://ehealthontario.ca/fhir/StructureDefinition/ca-on-pcr-profile-Bundle
Patient EMPI Match Request Parameters Profile http://ehealthontario.ca/fhir/StructureDefinition/pcr-parameters-match-in http://ehealthontario.ca/fhir/StructureDefinition/ca-on-pcr-match-in-profile-Parameters
Patient PIXm Response Profile http://ehealthontario.ca/fhir/StructureDefinition/pcr-parameters-pixm-out http://ehealthontario.ca/fhir/StructureDefinition/ca-on-pcr-pixm-out-profile-Parameters
PCR OperationOutcome Profile http://ehealthontario.ca/fhir/StructureDefinition/pcr-operationoutcome http://ehealthontario.ca/fhir/StructureDefinition/ca-on-pcr-profile-OperationOutcome

Bundle Response

Element Change Details Implementation Change Required?
Bundle.link Added Bundle.link to support self link as per FHIR R4 rule. Link Yes, this is a new MustSupport element
Bundle.entry(OperationOutcome).search Added search with mode="outcome" Yes, this is a new MustSupport element

Patient EMPI Match Request:

No change.

Patient EMPI Match Response:

  1. The Patient EMPI Match response will use the patient profile instead of the patient match profile. As per business rules, the Patient EMPI Match response is a summary view of the patient profile. Therefore the patient response profile will be used with an additional Patient.meta.tag set to "SUBSETTED". Note that the following elements are not returned in a Patient EMPI Match response:
  • Patient.deceased[x]
  • Patient.multipleBirth[x]
  • Patient.contact
  • Patient.communication

The Patient.meta.tag will be populated as follows:

<meta>
    <tag>
        <system value="http://hl7.org/fhir/v3/ObservationValue" />
        <code value="SUBSETTED" />
        <display value="subsetted" />
    </tag>
</meta>

Patient Read Request:

No change.

Patient Read Response:

Element Change Details Implementation Change Required?
Patient.meta.security Added security.display field for textual information. Possible values are "normal" (if code is N), and "restricted" (if code is R). Yes
Patient.meta.security.coding.system System url changed from http://hl7.org/fhir/v3/Confidentiality to http://terminology.hl7.org/CodeSystem/v3-Confidentiality.
Patient.identifier.type.coding.system System url changed from http://hl7.org/fhir/v2/0203 to http://terminology.hl7.org/CodeSystem/v2-0203.
Patient.contact.relationship.coding.system Valueset url changed from http://hl7.org/fhir/ValueSet/patient-contact-relationship to http://terminology.hl7.org/CodeSystem/v2-0131. Yes
Patient.contact.relationship.coding.code Code changed from "emergency" to "C" Yes
Patient.contact.relationship.coding.display Added display field with fixed value "Emergency Contact". Yes
Patient.communication.language Changed to BCP47 language valuesets required by FHIR. See HumanLanguage Valueset. Yes

Patient Search Request:

Added support for the HTTP POST method (in addition to GET) on the Patient Search Operation. See Patient Search for details

Patient Search Response:

Same profile change as in the table above.

Cross-Identifier PIXm Request:

Added support for the HTTP POST method (in addition to GET) on the Cross-Identifier-PIXm Operation. See PIXm page for details.

Cross-Identifier PIXm Response:

No change.