Unterstützt ab TTP-FHIR Gateway Version 2.0.0
Voraussetzung
- Spezifizierte Domäne muss angelegt sein
- Spezifiziertes Template muss angelegt sein
- Es muss eine gültige Einwilligung mit dem gegebenen personIdentfier auf Basis des spezifizierten Templates existieren
Aufruf und Rückgabe
Invocations
URL: [base]/$currentConsentForPersonAndTemplate
This operation does NOT change content
Parameters (In)
Name | Cardinality | Type | Documentation |
---|
personIdentifier | 1..* | Identifier | Um den Bezug zwischen Person und Einwilligung herzustellen, ist die Angabe von mindestens einem eindeutigen Personenidentifikator erforderlich. Dies kann je nach Anforderungen die Fallnummer, ein Patienten-Identifikator, die Angabe eines Bevollmächtigten oder ein Studienpseudonym, o.ä. sein. Bei Angabe von mehreren Identifikatoren werden diese ODER-verknüpft. |
domain | 1..1 | string | Angabe der Einwilligungsdomaene |
ignore-version-number | 0..1 | boolean | Wenn TRUE, wird die Datumsbezogen jüngste Einwilligung der Person ermittelt und die Versionsangabe der spezifizierten Einwilligungsvorlage (TemplateFrame) ignoriert. Default=FALSE |
template | 1..1 | string | Angabe der eindeutigen TemplateId in Form des TemplateFrame.Identifier.Value für das vorbelegte Template.Identifier.System "https://ths-greifswald.de/fhir/gics/" |
_profile | 0..1 | canonical | Angabe um Ausgabeprofil festzulegen.
Default ist die gics-Variante; alternativ das Profil aus dem IG Einwilligungsmanagement. |
Return Values (Out)
Name | Cardinality | Type | Documentation |
---|
return | 0..1 | Bundle | Bundle mit den beschriebenen Inhalten |
Liefert den aktuellen Consent einer Person bezogen auf eine spezifische Einwilligungsvorlage (unter Angabe des TemplateFrame-Identifiers) per POST-Request. Aktuell bedeutet <b>"höchste Version der Einwilligungsvorlage" UND "jüngstes Datum"</b>. Die Rückgabe erfolgt als Bundle vom Typ "collection". Das Bundle enthält exakt einen Bundle-Entry, der alle für den spezifischen Consent relevanten Ressourcen (z.B. TemplateFrame, QuestionnaireComposed, QuestionnaireResponse, Provenance) enthält. Details zu den verwendeten Profilen unter https://simplifier.net/guide/einwilligungsmanagement/igeinwilligungsmanagement
Im Erfolgsfall wird der HTTP Statuscode 200 zurückgegeben.
Im Fehlerfall wird einer der folgenden HTTP Statuscodes in Verbindung mit einer OperationOutcome-Ressource zurückgegeben:
- 400: Fehlende oder fehlerhafte Parameter.
- 401: Fehlende Authentifizierung oder Autorisierung.
- 404: Parameter mit unbekanntem Inhalt.
- 422: Fehlende oder falsche Patienten-Attribute.
Beispiel
Beispielhafter Request-Body:
<id value="CurrentConsentForPersonAndTemplate-request-example-1" />
<name value="personIdentifier" />
<system value="https://ths-greifswald.de/fhir/gics/identifiers/Pseudonym" />
<value value="dic_1H51T" />
</valueIdentifier>
</parameter>
</parameter>
<name value="template" />
<valueString value="MII;Patienteneinwilligung MII;1.6.f" />
</parameter>
<name value="ignore-version-number" />
</parameter>
</Parameters>
Beispielhafte Rückmeldung:
<Bundle xmlns="http://hl7.org/fhir">
<id value="AllConsentsForDomain-response-example-1" />
<type value="collection" />
<fullUrl value="urn:uuid:dfd5edc6-3a8a-4796-a9bb-f9572cf15c96" />
<QuestionnaireResponse>
<id value="dfd5edc6-3a8a-4796-a9bb-f9572cf15c96" />
<profile value="http://fhir.de/ConsentManagement/StructureDefinition/QuestionnaireResponse" />
</meta>
<questionnaire value="https://ths-greifswald.de/fhir/gics/QuestionnaireComposed/MII/Patienteneinwilligung+MII|1.6.f" />
<reference value="Patient/d4c9a2fe-0eea-4a84-899d-3dbd9dc5c7f1" />
<display value="Pseudonym dic_1H51T" />
</subject>
<authored value="2021-05-19T00:00:00+02:00" />
<reference value="Patient/d4c9a2fe-0eea-4a84-899d-3dbd9dc5c7f1" />
<display value="Pseudonym dic_1H51T" />
</author>
<reference value="Patient/d4c9a2fe-0eea-4a84-899d-3dbd9dc5c7f1" />
<display value="Pseudonym dic_1H51T" />
</source>
<linkId value="PATDAT_erheben_speichern_nutzen|1.6" />
<system value="urn:oid:2.16.840.1.113883.3.1937.777.24.5.2" />
<code value="2.16.840.1.113883.3.1937.777.24.5.2.1" />
</valueCoding>
</answer>
</item>
<linkId value="KKDAT_retrospektiv_uebertragen_speichern_nutzen|1.6" />
<system value="urn:oid:2.16.840.1.113883.3.1937.777.24.5.2" />
<code value="2.16.840.1.113883.3.1937.777.24.5.2.2" />
</valueCoding>
</answer>
</item>
<linkId value="KKDAT_prospektiv_uebertragen_speichern_nutzen|1.6" />
<system value="urn:oid:2.16.840.1.113883.3.1937.777.24.5.2" />
<code value="2.16.840.1.113883.3.1937.777.24.5.2.2" />
</valueCoding>
</answer>
</item>
<linkId value="BIOMAT_erheben_lagern_nutzen|1.6" />
<system value="urn:oid:2.16.840.1.113883.3.1937.777.24.5.2" />
<code value="2.16.840.1.113883.3.1937.777.24.5.2.2" />
</valueCoding>
</answer>
</item>
<linkId value="BIOMAT_Zusatzentnahme|1.6" />
<system value="urn:oid:2.16.840.1.113883.3.1937.777.24.5.2" />
<code value="2.16.840.1.113883.3.1937.777.24.5.2.2" />
</valueCoding>
</answer>
</item>
<linkId value="Rekontaktierung_Ergaenzungen|1.6" />
<system value="urn:oid:2.16.840.1.113883.3.1937.777.24.5.2" />
<code value="2.16.840.1.113883.3.1937.777.24.5.2.1" />
</valueCoding>
</answer>
</item>
<linkId value="Rekontaktierung_Zusatzbefund|1.6" />
<system value="urn:oid:2.16.840.1.113883.3.1937.777.24.5.2" />
<code value="2.16.840.1.113883.3.1937.777.24.5.2.1" />
</valueCoding>
</answer>
</item>
<linkId value="Z1_GECCO83_Nutzung_NUM_CODEX|1.0" />
<system value="urn:oid:2.16.840.1.113883.3.1937.777.24.5.2" />
<code value="2.16.840.1.113883.3.1937.777.24.5.2.1" />
</valueCoding>
</answer>
</item>
<linkId value="Z1_GECCO83_Weitergabe_NUM_CODEX_EU_DSGVO_nonkonform|1.0" />
<system value="urn:oid:2.16.840.1.113883.3.1937.777.24.5.2" />
<code value="2.16.840.1.113883.3.1937.777.24.5.2.2" />
</valueCoding>
</answer>
</item>
</QuestionnaireResponse>
</resource>
</entry>
<fullUrl value="urn:uuid:d72bc4dc-1f2b-4c5d-8f3c-51fe6a9a5d90" />
<Consent>
<id value="d72bc4dc-1f2b-4c5d-8f3c-51fe6a9a5d90" />
<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">
<reference value="ResearchStudy/593d66f3-3654-4e8a-9524-3bcd78a363bb" />
</valueReference>
</extension>
<system value="http://hl7.org/fhir/publication-status" />
</valueCoding>
</extension>
</extension>
<system value="http://terminology.hl7.org/CodeSystem/consentscope" />
<code value="research" />
</coding>
</scope>
<system value="http://loinc.org" />
</coding>
</category>
<system value="http://fhir.de/ConsentManagement/CodeSystem/ResultType" />
<code value="document" />
</coding>
</category>
<reference value="Patient/d4c9a2fe-0eea-4a84-899d-3dbd9dc5c7f1" />
<display value="Pseudonym dic_1H51T" />
</patient>
<dateTime value="2021-05-19T00:00:00+02:00" />
</organization>
<reference value="QuestionnaireResponse/dfd5edc6-3a8a-4796-a9bb-f9572cf15c96" />
</sourceReference>
<uri value="urn:oid:2.16.840.1.113883.3.1937.777.24.2.184" />
</policy>
<start value="2021-05-19T17:50:22+02:00" />
<end value="2051-05-19T17:50:23+02:00" />
</period>
<start value="2021-05-19T17:50:22+02:00" />
<end value="2051-05-19T17:50:23+02:00" />
</period>
<system value="https://ths-greifswald.de/fhir/CodeSystem/gics/Policy" />
<code value="IDAT_bereitstellen_EU_DSGVO_NIVEAU" />
<display value="Herausgabe identifizierender Daten (IDAT)[...]" />
</coding>
</code>
<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.5" />
</coding>
</code>
</provision>
<start value="2021-05-19T17:50:22+02:00" />
<end value="2051-05-19T17:50:23+02:00" />
</period>
<system value="https://ths-greifswald.de/fhir/CodeSystem/gics/Policy" />
<code value="IDAT_erheben" />
<display value="Erfassung neuer identifizierender Daten (IDAT)" />
</coding>
</code>
<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.2" />
</coding>
</code>
</provision>
<start value="2021-05-19T17:50:22+02:00" />
<end value="2051-05-19T17:50:23+02:00" />
</period>
<system value="https://ths-greifswald.de/fhir/CodeSystem/gics/Policy" />
<code value="IDAT_speichern_verarbeiten" />
<display value="Speicherung und Verarbeitung identifizierender Daten (IDAT)[...]" />
</coding>
</code>
<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.3" />
</coding>
</code>
</provision>
<start value="2021-05-19T17:50:22+02:00" />
<end value="2051-05-19T17:50:23+02:00" />
</period>
<system value="https://ths-greifswald.de/fhir/CodeSystem/gics/Policy" />
<code value="IDAT_zusammenfuehren_Dritte" />
<display value="Zusammenführung identifizierender Daten (IDAT)[...]" />
</coding>
</code>
<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.4" />
</coding>
</code>
</provision>
<start value="2021-05-19T17:50:22+02:00" />
<end value="2051-05-19T17:50:23+02:00" />
</period>
<system value="https://ths-greifswald.de/fhir/CodeSystem/gics/Policy" />
<code value="MDAT_erheben" />
<display value="Erfassung medizinischer Daten" />
</coding>
</code>
<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>
<start value="2021-05-19T17:50:22+02:00" />
<end value="2051-05-19T17:50:23+02:00" />
</period>
<system value="https://ths-greifswald.de/fhir/CodeSystem/gics/Policy" />
<code value="MDAT_speichern_verarbeiten" />
<display value="Speicherung_Verarbeitung von medizinischen Daten[...]" />
</coding>
</code>
<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.7" />
</coding>
</code>
</provision>
<start value="2021-05-19T17:50:22+02:00" />
<end value="2051-05-19T17:50:23+02:00" />
</period>
<system value="https://ths-greifswald.de/fhir/CodeSystem/gics/Policy" />
<code value="MDAT_wissenschaftlich_nutzen_EU_DSGVO_NIVEAU" />
<display value="Bereitstellung medizinischer Daten (MDAT)[...]" />
</coding>
</code>
<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.8" />
</coding>
</code>
</provision>
<start value="2021-05-19T17:50:22+02:00" />
<end value="2051-05-19T17:50:23+02:00" />
</period>
<system value="https://ths-greifswald.de/fhir/CodeSystem/gics/Policy" />
<code value="MDAT_zusammenfuehren_Dritte" />
<display value="Zusammenführung medizinischer Daten (MDAT)[...]" />
</coding>
</code>
<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.9" />
</coding>
</code>
</provision>
<start value="2021-05-19T17:50:22+02:00" />
<end value="2051-05-19T17:50:23+02:00" />
</period>
<system value="https://ths-greifswald.de/fhir/CodeSystem/gics/Policy" />
<code value="Rekontaktierung_Verknuepfung_Datenbanken" />
<display value="Rekontaktierung zur Verknüpfung[...]" />
</coding>
</code>
<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.27" />
</coding>
</code>
</provision>
<start value="2021-05-19T17:50:22+02:00" />
<end value="2051-05-19T17:50:23+02:00" />
</period>
<system value="https://ths-greifswald.de/fhir/CodeSystem/gics/Policy" />
<code value="Rekontaktierung_weitere_Erhebung" />
<display value="Rekontaktierung bezüglich Erhebung zusätzlicher Daten" />
</coding>
</code>
<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.28" />
</coding>
</code>
</provision>
<start value="2021-05-19T17:50:22+02:00" />
<end value="2051-05-19T17:50:23+02:00" />
</period>
<system value="https://ths-greifswald.de/fhir/CodeSystem/gics/Policy" />
<code value="Rekontaktierung_weitere_Studien" />
<display value="Rekontaktierung bezüglich Information[...]" />
</coding>
</code>
<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.29" />
</coding>
</code>
</provision>
<start value="2021-05-19T17:50:22+02:00" />
<end value="2051-05-19T17:50:23+02:00" />
</period>
<system value="https://ths-greifswald.de/fhir/CodeSystem/gics/Policy" />
<code value="MDAT_GECCO83_bereitstellen_NUM_CODEX" />
<display value="Medizinische Daten des GECCO83 Datensatz[...]" />
</coding>
</code>
<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.33" />
</coding>
</code>
</provision>
<start value="2021-05-19T17:50:22+02:00" />
<end value="2051-05-19T17:50:23+02:00" />
</period>
<system value="https://ths-greifswald.de/fhir/CodeSystem/gics/Policy" />
<code value="MDAT_GECCO83_speichern_verarbeiten_NUM_CODEX" />
<display value="Medizinische Daten des GECCO83 Datensatz[...]" />
</coding>
</code>
<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.34" />
</coding>
</code>
</provision>
<start value="2021-05-19T17:50:22+02:00" />
<end value="2051-05-19T17:50:23+02:00" />
</period>
<system value="https://ths-greifswald.de/fhir/CodeSystem/gics/Policy/MII" />
<code value="MDAT_GECCO83_wissenschaftlich_nutzen_COVID_19_Forschung_EU_DSGVO_konform" />
<display value="Nutzung des Covid-19-Datensatzes[...]" />
</coding>
</code>
</provision>
<start value="2021-05-19T17:50:22+02:00" />
<end value="2051-05-19T17:50:23+02:00" />
</period>
<system value="https://ths-greifswald.de/fhir/CodeSystem/gics/Policy/MII" />
<code value="MDAT_GECCO83_wissenschaftlich_nutzen_Pandemie_Forschung_EU_DSGVO_konform" />
<display value="Nutzung des Covid-19-Datensatzes[...]" />
</coding>
</code>
</provision>
<start value="2021-05-19T17:50:22+02:00" />
<end value="2051-05-19T17:50:23+02:00" />
</period>
<system value="https://ths-greifswald.de/fhir/CodeSystem/gics/Policy/MII" />
<code value="Rekontaktierung_Zusatzbefund" />
<display value="Rekontaktierung bezüglich Zusatzbefund" />
</coding>
</code>
<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.31" />
</coding>
</code>
</provision>
</provision>
</Consent>
</resource>
</entry>
<fullUrl value="urn:uuid:ab52ee3d-0616-4b07-8449-65264f97e5ad" />
<Provenance>
<id value="ab52ee3d-0616-4b07-8449-65264f97e5ad" />
<profile value="https://ths-greifswald.de/fhir/StructureDefinition/gics/Provenance" />
<profile value="http://fhir.de/ConsentManagement/StructureDefinition/Provenance" />
</meta>
<reference value="Consent/d72bc4dc-1f2b-4c5d-8f3c-51fe6a9a5d90" />
</target>
<recorded value="2021-05-19T17:50:23.000+02:00" />
<display value="https://ths-greifswald.de/gics" />
</who>
</agent>
<extension url="https://ths-greifswald.de/fhir/StructureDefinition/gics/SignatureLocation">
</extension>
<system value="urn:iso-astm:E1762-95:2013" />
<code value="1.2.840.10065.1.12.1.7" />
<display value="Consent Signature" />
</type>
<when value="2021-05-19T00:00:00.000+02:00" />
<reference value="Patient/d4c9a2fe-0eea-4a84-899d-3dbd9dc5c7f1" />
<display value="Pseudonym dic_1H51T" />
</who>
<data value="ZHVtbXky" />
</signature>
<extension url="https://ths-greifswald.de/fhir/StructureDefinition/gics/SignatureLocation">
</extension>
<system value="urn:iso-astm:E1762-95:2013" />
<code value="1.2.840.10065.1.12.1.5" />
<display value="Verification Signature" />
</type>
<when value="2021-05-19T00:00:00.000+02:00" />
</who>
<data value="ZHVtbXk=" />
</signature>
</Provenance>
</resource>
</entry>
<fullUrl value="urn:uuid:d4c9a2fe-0eea-4a84-899d-3dbd9dc5c7f1" />
<Patient>
<id value="d4c9a2fe-0eea-4a84-899d-3dbd9dc5c7f1" />
<profile value="https://ths-greifswald.de/fhir/StructureDefinition/epix/Patient" />
<profile value="http://fhir.de/ConsentManagement/StructureDefinition/Patient" />
</meta>
<system value="http://hl7.org/fhir/v2/0203/" />
<display value="Anonymous identifier" />
</coding>
</type>
<system value="https://ths-greifswald.de/fhir/gics/identifiers/Pseudonym" />
<value value="dic_1H51T" />
</identifier>
</Patient>
</resource>
</entry>
</Bundle>