xShare Project Yellow Button
0.3.0-ci - ci-build 150

xShare Project Yellow Button, published by xShare Project. This guide is not an authorized publication; it is the continuous build for version 0.3.0-ci built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/hl7-eu/xshare-yb/ and changes regularly. See the Directory of published versions

## Get Started with the xShare Yellow Button Download

This is a brief guideline on why and how to implement the xShare Yellow Button Download feature in your system, and prove its conformance.

To use the Yellow Button Label you have to:

### Why the Yellow Button?

- Enhance your system by offering natural persons a tool to easily access their data in a shareable and standardized format.
- Comply with the EHDS regulation.

### What You Should Be Able to Do

Given that your system manages Natural Person authentication in accordance with European Regulations , the following functionality should be provided:

- Your system enables the authenticated Natural Person (data owner) to:
  - View and select from the available health data to download.
  - Optionally configure download options (e.g., format, translations, pseudonymization, etc.).
  - Download the selected content to a chosen destination.

A detailed diagram is available here.

### How to Implement: the specifications

For this version of the xShare Yellow Button the only technical specifications to prove conformance with are the content specifications listed below, acting as xShare Yellow Button Content Creator:

| xBundle | HL7 FHIR IG
--- | --- | ---
| Patient Summary | HL7 International Patient Summary FHIR IG v2.0.1
| Core | HL7 Europe Base and Core FHIR IG v2.0.0
| Laboratory Report | HL7 Europe Laboratory Report FHIR IG v2.0.0
| MyHealth@EU Laboratory Report | MyHealth@EU Laboratory Report FHIR IG v9.1.1
| Medicine Prescription and Dispense | HL7 EU Medication Prescription and Dispense FHIR IG v1.0.0

Early implementers might be interested in

(a) piloting the following 'frozen' specifications

| xBundle | HL7 FHIR IG
--- | --- | ---
| Hospital Discharge Report | HL7 Europe Hospital Discharge Report FHIR IG (1.0.0-alpha)
| Patient Summary | HL7 Europe Patient Summary FHIR IG (1.0.0-ballot)
| CarePlan | xShare Project CarePlan FHIR IG (0.1.0)
| Imaging Report | HL7 EU Imaging Report FHIR IG (1.0.0-ballot)
| Imaging Study Manifest | IHE Manifest-based Access to DICOM Objects (MADO) v1.1

### Declare and Prove Your Conformance

#### Claim Your Conformance

To claim conformance with the xShare Yellow Button Download, implementers must issue a conformance statement specifying the content specifications and the optional features supported (e.g. additional download formats, password protected content, psuedoanonymized data;…).

#### Prove Your Conformance

To prove conformance to the xShare Yellow Button Download as xShare Yellow Button Provider you must:

1. Demonstrate that only authenticated Natural Persons can access the xShare Yellow Button Download feature.
2. Claim that user autentication is realized in conformance with the European Regulations
3. Demonstrate that (only) authenticated Natural Persons can search for and select the documents or data they wish to download.
4. Pass validation tests for each of the declared supported content specifications (e.g., Patient Summary, Laboratory Results), as listed in the Yellow Button Information view page.
5. Ensure that the download content is available in the selected target format.

To prove conformance to the xShare Yellow Button Download as xShare Yellow Button Consumer you must:

1. Demonstrate that is able to 'consume' (e.g. display, import,…) any of the declared supported content specifications (e.g., Patient Summary, Laboratory Results), as listed in the Yellow Button Information view page.

### Label Your System

To label your system follow the labeling process.