Mobile Access to DICOM Objects (MADO)
0.1.0-SNAPSHOT - ci-build

Mobile Access to DICOM Objects (MADO), published by IHE Radiology Technical Committee. This guide is not an authorized publication; it is the continuous build for version 0.1.0-SNAPSHOT built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/bvdh/bvdh-ihe-mado/ and changes regularly. See the Directory of published versions

## Manifest Envelopes for IHE-MHD

The following MHD DocumentReferences SHALL be used when distributing a MADO Imaging Manifest in an IHE-ITI-MHD environment:

- MADO FHIR Minimal DocumentReference for FHIR Manifests
- MADO DICOM KOS Minimal DocumentReference for DICOM KOS Manifests

The figure below shows the `MHD DocumentReference`s including the most relevant restrictions and its relationship with the manifests and each other.

Figure: IHE-MHD envelope

The main choices illustrated in the figure are:

- There are two different DocumentReferences, one for the FHIR and one for the DICOM KOS representation. When both are present, the relatesTo field points to the other representation.
- A FHIR manifest is represented as a FHIR json encoded FHIR `Bundle` following the profile MADO FHIR Bundle. This Bundle contains the `ImagingStudy` resource as well other resources such as the `Patient` and various `Endpoint`s.
- A KOS manifest is represented as a DICOM encoded DICOM instance following the MADO KOS profile.

The FHIR-manifest can be translated into the KOS-manifest and vice-versa allowing applications to change the representation when needed.

> In this specification the choice for presenting the manifest in an IHE-MHD environment is representing them as two separate DocumentReference instances. Feedback is requested from the implementer community whether this is the approach is correct and adequate.

### Related FHIR profiles

Name | Title | Description
MadoDicomKosMinimalDocumentReference | MADO MHD DocumentReference Profile for DICOM KOS Imaging Manifests | MADO specific profile for the IHE-MHD Minimal Document Reference for MADO DICOM KOS Manifests that includes the MADO specific content format, the extensions related to body-site and modality, and the definition on where `StudyInstanceUID` and `AccessionNumber` are stored.
MadoFhirMinimalDocumentReference | MADO MHD DocumentReference Profile for FHIR Imaging Manifests | MADO specific profile for the IHE-MHD Minimal Document Reference for MADO FHIR Manifests that includes the MADO specific content format, the extensions related to body-site and modality, and the definition on where `StudyInstanceUID` and `AccessionNumber` are stored.

### Search parameters

#### Imaging specific search parameters

Imaging specific search parameters include:

Name | Type | Description | Expression
bodysite | token | The body site studied | DocumentReference.bodySite.concept
modality | token | The modality used | DocumentReference.modality

#### IHE-ITI-MHD search parameters

General defined search parameters are:

Name | Type | Description | Expression
author | reference | Who and/or what authored the document | DocumentReference.author
author.given & author.family | string | This parameters, of type string, specify the name parts of the author person, which is associated with the DocumentReference Resource, or in Document Sharing nomenclature, the author of the Document Entry. See ITI TF-2x: Appendix Z.2 for use of the string data type. This use of author.given and author.family follows the FHIR Chaining Parameters search methodology. |
category | token | This parameter, of type token, specifies the general classification of the DocumentReference Resource, or in Document Sharing nomenclature, the classCode of the Document Entry. See ITI TF-2x: Appendix Z.2 for additional constraints on the use of the token search parameter type. | DocumentReference.category
creation | date | Date attachment was first created | DocumentReference.content.attachment.creation
date | date | When this document reference was created | DocumentReference.date
event | token | This parameter, of type token, specifies the main clinical acts documented by the DocumentReference Resource, or in Document Sharing nomenclature, the eventCodeList of the Document Entry. See ITI TF-2x: Appendix Z.2 for additional constraints on the use of the token search parameter type. | DocumentReference.context.event
format | token | Format code content rules for the (DocumentReference.content.profile.value.ofType(Coding)) | DocumentReference.content.format
facility | token | Kind of facility where patient was; or in Document Sharing nomenclature, the healthcareFacilityTypeCode of the Document Entry. See ITI TF-2x: Appendix Z.2 for additional constraints on the use of the token search parameter type. | DocumentReference.context.facilityType
identifier | token | Identifier of the attachment binary DocumentReference.identifier |
patient | reference | Who/what is the subject of the DocumentReference | DocumentReference.subject.where(resolve() is Patient)
patient.identifier | token | This parameter, of type token, specifies an identifier associated with the patient to which the DocumentReference Resource is assigned. See ITI TF-2x: Appendix Z.2 for additional constraints on the use of the token search parameter type. This use of patient.identifier follows the FHIR Chaining Parameters search methodology. |
period | date | the time of service that is being documented by the DocumentReference. The period search parameter specifies an interval which the time of service overlaps. | DocumentReference.period
related | reference | represents other identifiers associated with the DocumentReference Resource, or in Document Sharing nomenclature, the referenceIdList of the Document Entry. | DocumentReference.context.related
security-label | token | Document security-tags | DocumentReference.securityLabel
setting | token | the specific practice setting of the DocumentReference Resource, or in Document Sharing nomenclature, the practiceSettingCode of the Document Entry. | DocumentReference.context.practiceSetting
status | token | The status of the DocumentReference Resource | DocumentReference.status
type | token | Kind of document (LOINC if possible) | DocumentReference.type