createdS I0..1Extension(instant)
versionIdΣ0..1id
lastUpdatedΣ0..1instant
sourceΣ0..1uri
profileΣ0..*canonical(StructureDefinition)
securityΣ0..*CodingBinding
tagΣ0..*Coding
url1..1System.StringFixed Value
referenceΣ I1..1string
typeΣ0..1uriBinding
identifierΣ0..1Identifier
displayΣ0..1string
valueReferenceReference(Consent Management Domain Organization | Consent Management Domain Research Study)
url1..1System.StringFixed Value
systemΣ1..1uri
versionΣ0..1string
codeΣ1..1code
displayΣ0..1string
userSelectedΣ0..1boolean
url1..1System.StringFixed Value
externalPropertyS I0..*Extension(Complex)
expirationPropertyS I0..*Extension(Complex)
identifierΣ0..*Identifier
statusS Σ ?!1..1codeBinding
scopeΣ ?!1..1CodeableConceptBinding
codingS Σ1..*Coding
textΣ0..1string
referenceΣ I0..1string
typeΣ0..1uriBinding
identifierΣ0..1Identifier
displayΣ0..1string
dateTimeS Σ1..1dateTime
performerΣ I0..*Reference(Organization | Patient | Practitioner | RelatedPerson | PractitionerRole)
organizationS Σ I0..*Reference(Organization)
referenceS Σ I1..1string
typeΣ0..1uriBinding
identifierΣ0..1Identifier
displayΣ0..1string
sourceReferenceReference(Consent Management QuestionnaireResponse)
authorityI0..1uri
uriS I1..1uri
xacmlS I0..1Extension(base64Binary)
codingΣ0..*Coding
textΣ0..1string
verifiedΣ1..1boolean
verifiedWithI0..1Reference(Patient | RelatedPerson)
verificationDate0..1dateTime
typeΣ0..1codeBinding
periodS Σ I0..1Period
role1..1CodeableConceptBinding
referenceI1..1Reference(Device | Group | CareTeam | Organization | Patient | Practitioner | RelatedPerson | PractitionerRole)
actionΣ0..*CodeableConcept
securityLabelΣ0..*CodingBinding
purposeΣ0..*CodingBinding
classΣ0..*CodingBinding
codeΣ0..*CodeableConcept
dataPeriodΣ I0..1Period
meaningΣ1..1codeBinding
referenceΣ I1..1Reference(Resource)
provision0..*see (provision)

Zweck

Angepasstes FHIR Consent Profil auf Basis des offiziellen Consent Management: Consent erweitertet um ausgewählte gICS Eigenschaften.

Beispiel

Erweitertes Beispiel folgt.

Multi Provision Consent:

<Consent xmlns="http://hl7.org/fhir">
    <id value="Consent-example-1" />
    <meta>
        <extension url="https://ths-greifswald.de/fhir/StructureDefinition/gics/Created">
            <valueInstant value="2020-01-02T04:05:06+01:00" />
        </extension>
        <lastUpdated value="2021-06-17T14:02:21.285+02:00" />
        <profile value="https://ths-greifswald.de/fhir/StructureDefinition/gics/Consent" />
        <profile value="http://fhir.de/ConsentManagement/StructureDefinition/Consent" />
    </meta>
    <extension url="http://fhir.de/ConsentManagement/StructureDefinition/DomainReference">
        <extension url="domain">
            <valueReference>
                <reference value="ResearchStudy/593d66f3-3654-4e8a-9524-3bcd78a363bb" />
            </valueReference>
        </extension>
        <extension url="status">
            <valueCoding>
                <system value="http://hl7.org/fhir/publication-status" />
                <code value="active" />
            </valueCoding>
        </extension>
    </extension>
    <status value="active" />
    <scope>
        <coding>
            <system value="http://terminology.hl7.org/CodeSystem/consentscope" />
            <code value="research" />
        </coding>
    </scope>
    <category>
        <coding>
            <system value="http://loinc.org" />
            <code value="57016-8" />
        </coding>
    </category>
    <patient>
        <reference value="Patient/b5ad0847-597d-4825-bb6c-537d949159f8" />
        <display value="Pseudonym dic_1H51T" />
    </patient>
    <dateTime value="2021-06-17T14:02:21+02:00" />
    <sourceReference>
        <reference value="QuestionnaireResponse/cde387ba-27df-43c2-9f8d-4a2157a16363" />
    </sourceReference>
    <policyRule>
        <coding>
            <system value="https://ths-greifswald.de/fhir/CodeSystem/gics/Policy" />
            <code value="MDAT_erheben" />
            <display value="Erfassung medizinischer Daten" />
        </coding>
    </policyRule>
    <provision>
        <type value="permit" />
        <period>
            <start value="2021-06-17T14:02:21+02:00" />
            <end value="2026-06-17T14:02:21+02:00" />
        </period>
        <code>
            <coding>
                <system value="https://ths-greifswald.de/fhir/CodeSystem/gics/Policy" />
                <code value="MDAT_erheben" />
                <display value="Erfassung medizinischer Daten" />
            </coding>
        </code>
        <code>
            <coding>
                <system value="urn:oid:2.16.840.1.113883.3.1937.777.24.5.3" />
                <code value="2.16.840.1.113883.3.1937.777.24.5.3.6" />
            </coding>
        </code>
    </provision>
</Consent>

Single Provision Consent:

<Consent xmlns="http://hl7.org/fhir">
    <id value="Consent-example-2" />
    <meta>
        <extension url="https://ths-greifswald.de/fhir/StructureDefinition/gics/Created">
            <valueInstant value="2020-01-02T04:05:06+01:00" />
        </extension>
        <lastUpdated value="2021-10-29T11:00:08.695+02:00" />
        <profile value="https://ths-greifswald.de/fhir/StructureDefinition/gics/Consent" />
    </meta>
    <extension url="http://fhir.de/ConsentManagement/StructureDefinition/DomainReference">
        <extension url="domain">
            <valueReference>
                <reference value="ResearchStudy/b0b83c00-e230-4c52-8d3a-cbb882e0a72f" />
            </valueReference>
        </extension>
        <extension url="status">
            <valueCoding>
                <system value="http://hl7.org/fhir/publication-status" />
                <code value="active" />
            </valueCoding>
        </extension>
    </extension>
    <extension url="https://ths-greifswald.de/fhir/StructureDefinition/gics/ExternalProperty">
        <extension url="key">
            <valueString value="mykey1" />
        </extension>
        <extension url="value">
            <valueString value="myvalue1" />
        </extension>
    </extension>
    <extension url="https://ths-greifswald.de/fhir/StructureDefinition/gics/ExternalProperty">
        <extension url="key">
            <valueString value="mykey2" />
        </extension>
        <extension url="value">
            <valueString value="myvalue2" />
        </extension>
    </extension>
    <extension url="https://ths-greifswald.de/fhir/StructureDefinition/gics/ExternalProperty">
        <extension url="key">
            <valueString value="EXPIRATION_DATE" />
        </extension>
        <extension url="value">
            <valueString value="Tue Nov 30 00:00:00 CET 2021" />
        </extension>
    </extension>
    <status value="active" />
    <scope>
        <coding>
            <system value="http://terminology.hl7.org/CodeSystem/consentscope" />
            <code value="research" />
        </coding>
    </scope>
    <category>
        <coding>
            <system value="http://loinc.org" />
            <code value="59284-0" />
        </coding>
    </category>
    <patient>
        <reference value="Patient/65d4cbf1-f20a-4fd0-9585-53be76416b02" />
        <display value="Pseudonym aachen1" />
    </patient>
    <dateTime value="2021-10-29T11:00:08+02:00" />
    <organization>
        <display value="MII" />
    </organization>
    <sourceReference>
        <reference value="QuestionnaireResponse/0f1ccc50-9b24-4f12-a998-49f80d5285c1" />
    </sourceReference>
    <policyRule>
        <text value="Patienteneinwilligung MII|1.6.f" />
    </policyRule>
    <provision>
        <type value="deny" />
        <period>
            <start value="2021-10-29T11:00:08+02:00" />
            <end value="2021-11-30T00:00:00+01:00" />
        </period>
        <provision>
            <type value="permit" />
            <period>
                <start value="2021-10-29T11:00:08+02:00" />
                <end value="2021-11-30T00:00:00+01:00" />
            </period>
            <code>
                <coding>
                    <system value="https://ths-greifswald.de/fhir/CodeSystem/gics/Policy" />
                    <code value="IDAT_bereitstellen_EU_DSGVO_NIVEAU" />
                    <display value="Herausgabe identifizierender Daten (IDAT) an verantwortliche Stelle zur weiteren Verarbeitung" />
                </coding>
            </code>
        </provision>
        <provision>
            <type value="permit" />
            <period>
                <start value="2021-10-29T11:00:08+02:00" />
                <end value="2021-11-30T00:00:00+01:00" />
            </period>
            <code>
                <coding>
                    <system value="https://ths-greifswald.de/fhir/CodeSystem/gics/Policy" />
                    <code value="IDAT_erheben" />
                    <display value="Erfassung neuer identifizierender Daten (IDAT)" />
                </coding>
            </code>
        </provision>
        <provision>
            <type value="permit" />
            <period>
                <start value="2021-10-29T11:00:08+02:00" />
                <end value="2021-11-30T00:00:00+01:00" />
            </period>
            <code>
                <coding>
                    <system value="https://ths-greifswald.de/fhir/CodeSystem/gics/Policy" />
                    <code value="IDAT_speichern_verarbeiten" />
                    <display value="Speicherung und Verarbeitung identifizierender Daten (IDAT) in der verantwortlichen Stelle" />
                </coding>
            </code>
        </provision>
        <provision>
            <type value="permit" />
            <period>
                <start value="2021-10-29T11:00:08+02:00" />
                <end value="2021-11-30T00:00:00+01:00" />
            </period>
            <code>
                <coding>
                    <system value="https://ths-greifswald.de/fhir/CodeSystem/gics/Policy" />
                    <code value="IDAT_zusammenfuehren_Dritte" />
                    <display value="Zusammenf&#252;hrung identifizierender Daten (IDAT) mit Dritten Forschungspartnern" />
                </coding>
            </code>
        </provision>
        <provision>
            <type value="permit" />
            <period>
                <start value="2021-10-29T11:00:08+02:00" />
                <end value="2021-11-30T00:00:00+01:00" />
            </period>
            <code>
                <coding>
                    <system value="https://ths-greifswald.de/fhir/CodeSystem/gics/Policy" />
                    <code value="MDAT_erheben" />
                    <display value="Erfassung medizinischer Daten" />
                </coding>
            </code>
        </provision>
        <provision>
            <type value="permit" />
            <period>
                <start value="2021-10-29T11:00:08+02:00" />
                <end value="2021-11-30T00:00:00+01:00" />
            </period>
            <code>
                <coding>
                    <system value="https://ths-greifswald.de/fhir/CodeSystem/gics/Policy" />
                    <code value="MDAT_speichern_verarbeiten" />
                    <display value="Speicherung_Verarbeitung von medizinischen Daten innerhalb der verantwortlichen Stelle (MDAT)" />
                </coding>
            </code>
        </provision>
        <provision>
            <type value="permit" />
            <period>
                <start value="2021-10-29T11:00:08+02:00" />
                <end value="2021-11-30T00:00:00+01:00" />
            </period>
            <code>
                <coding>
                    <system value="https://ths-greifswald.de/fhir/CodeSystem/gics/Policy" />
                    <code value="MDAT_wissenschaftlich_nutzen_EU_DSGVO_NIVEAU" />
                    <display value="Bereitstellung medizinischer Daten (MDAT) f&#252;r wissenschaftliche Nutzung" />
                </coding>
            </code>
        </provision>
        <provision>
            <type value="permit" />
            <period>
                <start value="2021-10-29T11:00:08+02:00" />
                <end value="2021-11-30T00:00:00+01:00" />
            </period>
            <code>
                <coding>
                    <system value="https://ths-greifswald.de/fhir/CodeSystem/gics/Policy" />
                    <code value="MDAT_zusammenfuehren_Dritte" />
                    <display value="Zusammenf&#252;hrung medizinischer Daten (MDAT) mit Dritten Forschungspartnern" />
                </coding>
            </code>
        </provision>
        <provision>
            <type value="permit" />
            <period>
                <start value="2021-10-29T11:00:08+02:00" />
                <end value="2021-11-30T00:00:00+01:00" />
            </period>
            <code>
                <coding>
                    <system value="https://ths-greifswald.de/fhir/CodeSystem/gics/Policy" />
                    <code value="Rekontaktierung_Verknuepfung_Datenbanken" />
                    <display value="Rekontaktierung zur Verknuepfung von PatDat mit Info anderer Dbs" />
                </coding>
            </code>
        </provision>
        <provision>
            <type value="permit" />
            <period>
                <start value="2021-10-29T11:00:08+02:00" />
                <end value="2021-11-30T00:00:00+01:00" />
            </period>
            <code>
                <coding>
                    <system value="https://ths-greifswald.de/fhir/CodeSystem/gics/Policy" />
                    <code value="Rekontaktierung_weitere_Erhebung" />
                    <display value="Rekontaktierung bez&#252;glich Erhebung zus&#228;tzlicher Daten" />
                </coding>
            </code>
        </provision>
        <provision>
            <type value="permit" />
            <period>
                <start value="2021-10-29T11:00:08+02:00" />
                <end value="2021-11-30T00:00:00+01:00" />
            </period>
            <code>
                <coding>
                    <system value="https://ths-greifswald.de/fhir/CodeSystem/gics/Policy" />
                    <code value="Rekontaktierung_weitere_Studien" />
                    <display value="Rekontaktierung bez&#252;glich Information zu neuen Forschungsvorhaben oder Studien" />
                </coding>
            </code>
        </provision>
        <provision>
            <type value="permit" />
            <period>
                <start value="2021-10-29T11:00:08+02:00" />
                <end value="2021-11-30T00:00:00+01:00" />
            </period>
            <code>
                <coding>
                    <system value="https://ths-greifswald.de/fhir/CodeSystem/gics/Policy" />
                    <code value="KDAT_retro_speichern_verarbeiten" />
                    <display value="Krankenkassendaten (KKDAT) f&#252;r 5 Jahre retrospektiv speichern_verarbeiten in der verantwortlichen Stelle" />
                </coding>
            </code>
        </provision>
        <provision>
            <type value="permit" />
            <period>
                <start value="2021-10-29T11:00:08+02:00" />
                <end value="2021-11-30T00:00:00+01:00" />
            </period>
            <code>
                <coding>
                    <system value="https://ths-greifswald.de/fhir/CodeSystem/gics/Policy" />
                    <code value="KDAT_retro_uebertragen" />
                    <display value="Krankenkassendaten (KKDAT) f&#252;r 5 Jahre retrospektiv &#252;bertragen" />
                </coding>
            </code>
        </provision>
        <provision>
            <type value="permit" />
            <period>
                <start value="2021-10-29T11:00:08+02:00" />
                <end value="2021-11-30T00:00:00+01:00" />
            </period>
            <code>
                <coding>
                    <system value="https://ths-greifswald.de/fhir/CodeSystem/gics/Policy" />
                    <code value="KDAT_retro_wissenschaftlich_nutzen" />
                    <display value="Krankenkassendaten (KKDAT) f&#252;r 5 Jahre retrospektiv wissenschaftlich nutzen" />
                </coding>
            </code>
        </provision>
    </provision>
</Consent>

Suchparameter

Die Suche nach Einwilligungsinformationen ist mittels der FHIR Search-API umgesetzt. Die Rückgabe erfolgt dementsprechend in Form eines Bundles vom Typ searchset.

Suchanfragen werden ausschließlich als GET-Requests akzeptiert. Bezüglich des Encodings der URL sei auf die Hinweise unter Technische Grundlagen verwiesen.

Unterstützt wird die logische UND-Verknüpfung gemäß FHIR Search API, nicht jedoch das logische ODER.

Paging entsprechend der FHIR Search API wird unterstützt, namentlich die link-Elemente im Bundle sowie die Parameter

  • _count: (maximale) Anzahl der im Bundle enthaltenen Ressourcen
  • _offset: fortlaufende Nummer der ersten im Bundle enthaltenen Ressource

Der Default-Offset ist 0.

Werden weder _count noch _offset angegeben, enthält das Bundle alle Ergebnisse.

Die reine Anzahl der Suchergebnisse ohne deren Übermittlung kann mit Hilfe des Parameters _summary=count abgefragt werden, vgl. http://www.hl7.org/fhir/r4/search.html#count .

Die Suche erfolgt auf dem Consent-Endpoint mittels der nachfolgend beschriebenen Suchparameter.

Hinweis: Die Angabe des Suchparameters "domain" ist verpflichtend. Existiert dieser nicht im Request, wird der HTTP-Statuscode 400 zurück gegeben.

Domain

Der Suchparameter domain ist im Rahmen dieses Leitfadens wie folgt definiert:

Invocations

[base]/Consent?domain=[id]

Details

ResourceCodeTypeFhirPath
Consentdomainreferenceextension('http://fhir.de/ConsentManagement/StructureDefinition/DomainReference').extension('domain').valueReference

Er wird in der Regel gemeinsam mit weiteren Suchparametern verwendet. Beispiele siehe dort.

Kategorie

Der Standard-Suchparameter category wird unterstützt (vgl. http://www.hl7.org/fhir/consent.html#search)

Beispiel:

GET [base]/Consent?domain:identifier=MIRACUM&category=2.16.840.1.113883.3.1937.777.24.2.184

findet alle Consent-Ressourcen, die einer beliebigen Version des MII Broad Consent (entsprechend der hier beispielhaften OID) entsprechen.

Typ der Provision (permit, deny)

Der Suchparameter provisionType, definiert im Rahmen des Implementierungsleitfaden Consent der MII, wird unterstützt.

Beispiel:

GET [base]/Consent?domain:identifier=MIRACUM&provisionType=permit
Provision-Code

Der Suchparameter provisionCode, definiert im Implementierungsleitfaden Consent der MII, wird unterstützt.

Beispiel:

GET [base]/Consent?domain:identifier=MIRACUM&provisionCode=urn:oid:2.16.840.1.113883.3.1937.777.24.5.3|2.16.840.1.113883.3.1937.777.24.5.3.8
Provisions-Zeitraum

Der Suchparameter provisionPeriod, definiert im Rahmen des Implementierungsleitfaden Consent der MII, wird unterstützt.

Bezüglich des Verhaltens bei der Suche in Elementen vom Datentyp period sei ausdrücklich auf den entsprechenden Abschnitt der FHIR-Spezifikation und die dortigen Beispiele zur Inklusion bzw. Exklusion von Suchergebnissen verwiesen: http://hl7.org/fhir/r4/search.html#date .

Beispiel:

GET [base]/Consent?domain:identifier=MIRACUM&provisionPeriod=2020-12-15

Der Suchparameter policyUri, definiert im Implementierungsleitfaden Consent der MII, wird unterstützt.

Command 'render' could not render: File was not found for 'https://www.medizininformatik-initiative.de/fhir/modul-consent/SearchParameter/mii-sp-consent-policyuri'

Beispiel:

GET [base]/Consent?domain:identifier=MIRACUM&policyUri=urn:oid:2.16.840.1.113883.3.1937.777.24.2.1791
Komplexere Beispiele
GET [base]/Consent?domain:identifier=MIRACUM&provisionType=permit&provisionCode=urn:oid:2.16.840.1.113883.3.1937.777.24.5.3|2.16.840.1.113883.3.1937.777.24.5.3.8&provisionCode=urn:oid:2.16.840.1.113883.3.1937.777.24.5.3|2.16.840.1.113883.3.1937.777.24.5.3.9

findet alle Consent-Ressourcen mit Permit-Provision, bei denen sowohl der Provison-Code 2.16.840.1.113883.3.1937.777.24.5.3.8 als auch der Provison-Code 2.16.840.1.113883.3.1937.777.24.5.3.9 gesetzt sind.

GET [base]/Consent?domain:identifier=MIRACUM&provisionType=permit&provisionCode=urn:oid:2.16.840.1.113883.3.1937.777.24.5.3|2.16.840.1.113883.3.1937.777.24.5.3.8,provisionCode=urn:oid:2.16.840.1.113883.3.1937.777.24.5.3|2.16.840.1.113883.3.1937.777.24.5.3.9

findet alle Consent-Ressourcen mit Permit-Provision, bei denen der Provison-Code 2.16.840.1.113883.3.1937.777.24.5.3.8 ode auch der Provison-Code 2.16.840.1.113883.3.1937.777.24.5.3.9 gesetzt sind.