MII-Initiative

MII IG Person DE v2024

Proband:in (ResearchSubject)


Beschreibung

Dieses Profil beschreibt eine ProbandIn in der Medizininformatik-Initiative.

Beim Einschluss einer Person in eine Studie (auch in einen MII-Use Case) MUSS für diese Person eine ResearchSubject-Ressource erstellt werden. Es sind folgende Varianten zu unterscheiden:

  • Der Einschluss erfolgt durch eine spezifische Informierte Einwilligung für eine Studie.

  • Der Einschluss erfolgt auf der Basis einer Breiten Informierten Einwilligung („Broad Consent“).

  • Der Einschluss erfolgt auf der Basis einer speziellen gesetzlichen Grundlage (Spezialgesetz wie Landeskrankenhausgesetz, Infektionsschutzgesetz oder Krebsregistergesetz). Dies gilt gleichermaßen für die Personen der Untersuchungsgruppe, der Kontrollgruppe und jeder Form von Referenzpopulation, für die personenbezogene (oder personenbeziehbare) Einzelangaben in Berechnungen einbezogen werden.

Die Erstellung der Ressource MUSS zum Zeitpunkt des Abrufens der Daten für die Studie erfolgen. Weitere Pflichten und Anpassungen sind für jeden Use Case zu prüfen.

NameStatusVersionCanonicalBasis
MII_PR_Person_Probandactive2024.0.0https://www.medizininformatik-initiative.de/fhir/core/modul-person/StructureDefinition/ResearchSubjecthttp://hl7.org/fhir/StructureDefinition/ResearchSubject

Inhalt

idS Σ0..1string
id0..1string
extensionI0..*Extension
versionIdΣ0..1id
lastUpdatedΣ0..1instant
sourceΣ0..1uri
profileS Σ0..*canonical(StructureDefinition)
securityΣ0..*CodingBinding
tagΣ0..*Coding
implicitRulesΣ ?!0..1uri
language0..1codeBinding
text0..1Narrative
contained0..*Resource
extensionI0..*Extension
modifierExtension?! I0..*Extension
id0..1string
extensionI0..*Extension
useΣ ?!0..1codeBinding
typeS Σ0..1CodeableConceptBindingPattern
systemS Σ1..1uri
valueS Σ1..1string
periodΣ0..1Period
assignerΣ0..1Reference(Organization)
statusS Σ ?!1..1codeBinding
id0..1string
extensionI0..*Extension
startS Σ I1..1dateTime
endS Σ I0..1dateTime
studyS Σ1..1Reference(ResearchStudy)
individualS Σ1..1Reference(Patient)
assignedArm0..1string
actualArm0..1string
consentS1..1Reference(Consent)

Dieses Profil beschreibt eine Proband*in in der Medizininformatik-Initiative.

Feldname
ResearchSubject.id
ResearchSubject.meta
ResearchSubject.meta.profile
ResearchSubject.identifier
ResearchSubject.identifier:subjectIdentificationCode
ResearchSubject.identifier:subjectIdentificationCode.type
ResearchSubject.identifier:subjectIdentificationCode.system
ResearchSubject.identifier:subjectIdentificationCode.value
ResearchSubject.status
ResearchSubject.period
ResearchSubject.period.start
ResearchSubject.period.end
ResearchSubject.study
ResearchSubject.individual
ResearchSubject.consent
<StructureDefinition xmlns="http://hl7.org/fhir">
    <id value="mii-pr-person-proband" />
    <url value="https://www.medizininformatik-initiative.de/fhir/core/modul-person/StructureDefinition/ResearchSubject" />
    <version value="2024.0.0" />
    <name value="MII_PR_Person_Proband" />
    <title value="MII PR Person Proband" />
    <status value="active" />
    <date value="2024-02-08" />
    <publisher value="Medizininformatik Initiative" />
    <contact>
        <telecom>
            <system value="url" />
            <value value="https://www.medizininformatik-initiative.de" />
        </telecom>
    </contact>
    <description value="Dieses Profil beschreibt eine Proband*in in der Medizininformatik-Initiative." />
    <fhirVersion value="4.0.1" />
    <kind value="resource" />
    <abstract value="false" />
    <type value="ResearchSubject" />
    <baseDefinition value="http://hl7.org/fhir/StructureDefinition/ResearchSubject" />
    <derivation value="constraint" />
    <differential>
        <element id="ResearchSubject.id">
            <path value="ResearchSubject.id" />
            <mustSupport value="true" />
        </element>
        <element id="ResearchSubject.meta">
            <path value="ResearchSubject.meta" />
            <mustSupport value="true" />
        </element>
        <element id="ResearchSubject.meta.profile">
            <path value="ResearchSubject.meta.profile" />
            <mustSupport value="true" />
        </element>
        <element id="ResearchSubject.identifier">
            <path value="ResearchSubject.identifier" />
            <slicing>
                <discriminator>
                    <type value="pattern" />
                    <path value="$this" />
                </discriminator>
                <rules value="open" />
            </slicing>
            <min value="1" />
            <mustSupport value="true" />
        </element>
        <element id="ResearchSubject.identifier:subjectIdentificationCode">
            <path value="ResearchSubject.identifier" />
            <sliceName value="subjectIdentificationCode" />
            <min value="1" />
            <max value="1" />
            <patternIdentifier>
                <type>
                    <coding>
                        <system value="http://terminology.hl7.org/CodeSystem/v2-0203" />
                        <code value="ANON" />
                    </coding>
                </type>
            </patternIdentifier>
            <mustSupport value="true" />
        </element>
        <element id="ResearchSubject.identifier:subjectIdentificationCode.type">
            <path value="ResearchSubject.identifier.type" />
            <mustSupport value="true" />
        </element>
        <element id="ResearchSubject.identifier:subjectIdentificationCode.system">
            <path value="ResearchSubject.identifier.system" />
            <min value="1" />
            <mustSupport value="true" />
        </element>
        <element id="ResearchSubject.identifier:subjectIdentificationCode.value">
            <path value="ResearchSubject.identifier.value" />
            <min value="1" />
            <mustSupport value="true" />
        </element>
        <element id="ResearchSubject.status">
            <path value="ResearchSubject.status" />
            <mustSupport value="true" />
        </element>
        <element id="ResearchSubject.period">
            <path value="ResearchSubject.period" />
            <min value="1" />
            <mustSupport value="true" />
        </element>
        <element id="ResearchSubject.period.start">
            <path value="ResearchSubject.period.start" />
            <min value="1" />
            <mustSupport value="true" />
        </element>
        <element id="ResearchSubject.period.end">
            <path value="ResearchSubject.period.end" />
            <mustSupport value="true" />
        </element>
        <element id="ResearchSubject.study">
            <path value="ResearchSubject.study" />
            <mustSupport value="true" />
        </element>
        <element id="ResearchSubject.individual">
            <path value="ResearchSubject.individual" />
            <mustSupport value="true" />
        </element>
        <element id="ResearchSubject.consent">
            <path value="ResearchSubject.consent" />
            <min value="1" />
            <mustSupport value="true" />
        </element>
    </differential>
</StructureDefinition>
{
    "resourceType": "StructureDefinition",
    "id": "mii-pr-person-proband",
    "url": "https://www.medizininformatik-initiative.de/fhir/core/modul-person/StructureDefinition/ResearchSubject",
    "version": "2024.0.0",
    "name": "MII_PR_Person_Proband",
    "title": "MII PR Person Proband",
    "status": "active",
    "date": "2024-02-08",
    "publisher": "Medizininformatik Initiative",
    "contact":  [
        {
            "telecom":  [
                {
                    "system": "url",
                    "value": "https://www.medizininformatik-initiative.de"
                }
            ]
        }
    ],
    "description": "Dieses Profil beschreibt eine Proband*in in der Medizininformatik-Initiative.",
    "fhirVersion": "4.0.1",
    "kind": "resource",
    "abstract": false,
    "type": "ResearchSubject",
    "baseDefinition": "http://hl7.org/fhir/StructureDefinition/ResearchSubject",
    "derivation": "constraint",
    "differential": {
        "element":  [
            {
                "id": "ResearchSubject.id",
                "path": "ResearchSubject.id",
                "mustSupport": true
            },
            {
                "id": "ResearchSubject.meta",
                "path": "ResearchSubject.meta",
                "mustSupport": true
            },
            {
                "id": "ResearchSubject.meta.profile",
                "path": "ResearchSubject.meta.profile",
                "mustSupport": true
            },
            {
                "id": "ResearchSubject.identifier",
                "path": "ResearchSubject.identifier",
                "slicing": {
                    "discriminator":  [
                        {
                            "type": "pattern",
                            "path": "$this"
                        }
                    ],
                    "rules": "open"
                },
                "min": 1,
                "mustSupport": true
            },
            {
                "id": "ResearchSubject.identifier:subjectIdentificationCode",
                "path": "ResearchSubject.identifier",
                "sliceName": "subjectIdentificationCode",
                "min": 1,
                "max": "1",
                "patternIdentifier": {
                    "type": {
                        "coding":  [
                            {
                                "code": "ANON",
                                "system": "http://terminology.hl7.org/CodeSystem/v2-0203"
                            }
                        ]
                    }
                },
                "mustSupport": true
            },
            {
                "id": "ResearchSubject.identifier:subjectIdentificationCode.type",
                "path": "ResearchSubject.identifier.type",
                "mustSupport": true
            },
            {
                "id": "ResearchSubject.identifier:subjectIdentificationCode.system",
                "path": "ResearchSubject.identifier.system",
                "min": 1,
                "mustSupport": true
            },
            {
                "id": "ResearchSubject.identifier:subjectIdentificationCode.value",
                "path": "ResearchSubject.identifier.value",
                "min": 1,
                "mustSupport": true
            },
            {
                "id": "ResearchSubject.status",
                "path": "ResearchSubject.status",
                "mustSupport": true
            },
            {
                "id": "ResearchSubject.period",
                "path": "ResearchSubject.period",
                "min": 1,
                "mustSupport": true
            },
            {
                "id": "ResearchSubject.period.start",
                "path": "ResearchSubject.period.start",
                "min": 1,
                "mustSupport": true
            },
            {
                "id": "ResearchSubject.period.end",
                "path": "ResearchSubject.period.end",
                "mustSupport": true
            },
            {
                "id": "ResearchSubject.study",
                "path": "ResearchSubject.study",
                "mustSupport": true
            },
            {
                "id": "ResearchSubject.individual",
                "path": "ResearchSubject.individual",
                "mustSupport": true
            },
            {
                "id": "ResearchSubject.consent",
                "path": "ResearchSubject.consent",
                "min": 1,
                "mustSupport": true
            }
        ]
    }
}

Hinweise

FHIR-Element Erklärung
ResearchSubject.id Must-support, jedoch optional
ResearchSubject.meta Must-support, jedoch optional
ResearchSubject.meta.profile VERPFLICHTEND für die Abfrage im DIZ-Repsoitory inkl Versionsnummer des Profils. Siehe CapabilityStatement. In allen anderen Fällen optional.
Patient.identifier:subjectIdentificationCode Fixes NamingSystem zur einheitlichen, standort-übergreifenden Abfrage des Identifiers (bei Auswertungen)
ResearchSubject.period.start Startdatum (Einschluss der PatientIn in die Studie)
ResearchSubject.period.end Enddatum (Abschluss der Studie oder Ausschluss der PatientIn)
ResearchSubject.study Referenz auf die Metadaten der Studie an welcher die PatientIn teilnimmt. Weitere Vorgaben siehe Erweiterungsmodul STUDIENDATEN.
ResearchSubject.individual Jede ProbandIn MUSS einer PatientIn zugeordnet werden.
ResearchSubject.consent Einwilligung in die Studie oder regulatorische Grundlage MUSS vorliegen. Weitere Vorgaben für die Modellierung des Consents können durch andere Erweiterungsmodule entstehen.

Mapping

FHIR-Element Logischer Datensatz
ResearchSubject.identifier:subjectIdentificationCode Person.Studienteilnehmer.SubjektIdentifizierungscode
ResearchSubject.status Person.Studienteilnehmer.StatusDerTeilnahme
ResearchSubject.period.start Person.Studienteilnehmer.BeginnTeilnahme
ResearchSubject.period.end Person.Studienteilnehmer.EndeTeilnahme
ResearchSubject.consent Person.Studienteilnehmer.Rechtsgrundlage

Suchparameter

Folgende Suchparameter sind für das Modul Person relevant, auch in Kombination:

  1. Der Suchparameter "_id" MUSS unterstützt werden:

    Beispiele:

    GET [base]/ResearchSubject?_id=103270

    Anwendungshinweise: Weitere Informationen zur Suche nach "_id" finden sich in der FHIR-Basisspezifikation - Abschnitt "Parameters for all resources".

  2. Der Suchparameter "_profile" MUSS unterstützt werden:

    Beispiele:

    GET [base]/ResearchSubject?_profile=https://www.medizininformatik-initiative.de/fhir/core/modul-person/StructureDefinition/ResearchSubject

    Anwendungshinweise: Weitere Informationen zur Suche nach "_profile" finden sich in der FHIR-Basisspezifikation - Abschnitt "Parameters for all resources".

  3. Der Suchparameter "identifier" MUSS unterstützt werden:

    Beispiele:

    GET [base]/ResearchSubject?identifier=http://fhir.krankenhaus.example/sid/subjectIdentificationCode|1032702

    Anwendungshinweise: Weitere Informationen zur Suche nach "ResearchSubject.identifier" finden sich in der FHIR-Basisspezifikation - Abschnitt "Token Search".

  4. Der Suchparameter "status" MUSS unterstützt werden:

    Beispiele:

    GET [base]/ResearchSubject?status=candidate

    Anwendungshinweise: Weitere Informationen zur Suche nach "ResearchSubject.status" finden sich in der FHIR-Basisspezifikation - Abschnitt "Token Search".

  5. Der Suchparameter "date" MUSS unterstützt werden:

    Beispiele:

    GET [base]/ResearchSubject?date=2022-01-01

    Anwendungshinweise: Weitere Informationen zur Suche nach "ResearchSubject.period" finden sich in der FHIR-Basisspezifikation - Abschnitt "Date Search".

  6. Der Suchparameter "study" MUSS unterstützt werden:

    Beispiele:

    GET [base]/ResearchSubject?study=ResearchStudy/study

    Anwendungshinweise: Weitere Informationen zur Suche nach "ResearchStudy.study" finden sich in der FHIR-Basisspezifikation - Abschnitt "reference".

  7. Der Suchparameter "individual" MUSS unterstützt werden:

    Beispiele:

    GET [base]/ResearchSubject?individual=Patient/test

    Anwendungshinweise: Weitere Informationen zur Suche nach "ResearchStudy.individual" finden sich in der FHIR-Basisspezifikation - Abschnitt "reference".

  8. Der Suchparameter "consent" MUSS unterstützt werden:

    Beispiele:

    GET [base]/ResearchSubject?consent=Consent/test

    Anwendungshinweise: Weitere Informationen zur Suche nach "ResearchStudy.consent" finden sich in der FHIR-Basisspezifikation - Abschnitt "reference".


Beispiele

Beispiel (vollständig):

{
    "resourceType": "Patient",
    "id": "mii-exa-person-patient-pseudonymisiert",
    "meta": {
        "security":  [
            {
                "code": "HTEST",
                "system": "http://terminology.hl7.org/CodeSystem/v3-ActReason",
                "display": "test health data"
            }
        ],
        "profile":  [
            "https://www.medizininformatik-initiative.de/fhir/core/modul-person/StructureDefinition/PatientPseudonymisiert|2025.0.1"
        ]
    },
    "identifier":  [
        {
            "type": {
                "coding":  [
                    {
                        "code": "PSEUDED",
                        "system": "http://terminology.hl7.org/CodeSystem/v3-ObservationValue"
                    }
                ]
            },
            "system": "https://www.medizininformatik-initiative.de/fhir/sid/pseudonym",
            "value": "1234567890"
        }
    ],
    "address":  [
        {
            "type": "both",
            "postalCode": "50",
            "country": "DE"
        }
    ],
    "gender": "male",
    "birthDate": "2000-04-01"
}