MII-Initiative

[DE] Medizininformatik Initiative - Medizinische Forschungsvorhaben - Implementierungsleitfaden - Version 2025.0.0

Beteiligte Person (PractitionerRole)


Beschreibung

Dieses Profil beschreibt eine beteiligte Person innerhalb einer Studie in der Medizininformatik-Initiative.

NameCanonical
MII_PR_Studie_Beteiligte_Personhttps://www.medizininformatik-initiative.de/fhir/modul-studie/StructureDefinition/mii-pr-studie-beteiligte-person

Differential

idΣ0..1string
metaΣ0..1Meta
implicitRulesΣ ?!0..1uri
language0..1codeBinding
text0..1Narrative
contained0..*Resource
extensionI0..*Extension
modifierExtension?! I0..*Extension
identifierΣ0..*Identifier
activeΣ0..1boolean
periodΣ I0..1Period
practitionerS Σ I0..1Reference(Practitioner)
organizationS Σ I0..1Reference(Organization)
codeS Σ0..*CodeableConcept
specialtyΣ0..*CodeableConceptBinding
locationΣ I0..*Reference(Location)
healthcareServiceI0..*Reference(HealthcareService)
telecomS Σ I0..*ContactPoint
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
daysOfWeek0..*codeBinding
allDay0..1boolean
availableStartTime0..1time
availableEndTime0..1time
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
description1..1string
duringI0..1Period
availabilityExceptions0..1string
endpointI0..*Reference(Endpoint)


Hinweise

FHIR-Element Erklärung
PractitionerRole.id Must-support, jedoch optional
PractitionerRole.meta Must-support, jedoch optional
PractitionerRole.meta.profile Verpflichtend für die Abfrage im DIZ-Repository inkl. Versionsnummer des Profils. Siehe CapabilityStatement. In allen anderen Fällen optional.
PractitionerRole.code Hausinterne Kodierung kann hier verwendet werden. Die nächste Version des vorliegenden Moduls wird hier voraussichtlich weitere Vorgaben zur Standardisierung eines ValueSets fordern.
PractitionerRole.telecom Es ist drauf zu achten, dass hier nur Informationen exponiert werden, die bereits durch die Studie ansich veröffentlicht wurden
PractitionerRole.organization Um alle zu einer Studie zugehörigen Personen zu finden ist die Verwendung von Referenz.reference anstelle von Referent.identifier zu bevorzugen.

Mapping

FHIR Element Logischer Datensatz
PractitionerRole.code Forschungsvorhaben.Beteiligter.Rolle
PractitionerRole.telecom Forschungsvorhaben.Beteiligter.Kontakt
PractitionerRole.organization Forschungsvorhaben.Beteiligter.Standort
FHIR Element Logischer Datensatz
PractitionerRole.code Forschungsvorhaben.Studienleiter
PractitionerRole.telecom Forschungsvorhaben.Studienleiter.Kontakt
PractitionerRole.organization Forschungsvorhaben.Studienleiter.Standort

Snapshot

idΣ0..1string
metaΣ0..1Meta
implicitRulesΣ ?!0..1uri
language0..1codeBinding
text0..1Narrative
contained0..*Resource
extensionI0..*Extension
modifierExtension?! I0..*Extension
identifierΣ0..*Identifier
activeΣ0..1boolean
periodΣ I0..1Period
practitionerS Σ I0..1Reference(Practitioner)
organizationS Σ I0..1Reference(Organization)
codeS Σ0..*CodeableConcept
specialtyΣ0..*CodeableConceptBinding
locationΣ I0..*Reference(Location)
healthcareServiceI0..*Reference(HealthcareService)
telecomS Σ I0..*ContactPoint
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
daysOfWeek0..*codeBinding
allDay0..1boolean
availableStartTime0..1time
availableEndTime0..1time
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
description1..1string
duringI0..1Period
availabilityExceptions0..1string
endpointI0..*Reference(Endpoint)


Suchparameter

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

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

    Beispiele:

    GET [base]/PractitionerRole?_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]/PractitionerRole?_profile=https://www.medizininformatik-initiative.de/fhir/modul-studie/StructureDefinition/mii-pr-studie-beteiligte-person

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

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

    Beispiele

    GET [base]/PractitionerRole?practitioner=Practitioner/practitioner-test

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

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

    Beispiele

    GET [base]/PractitionerRole?organization=Organization/organization-test

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

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

    Beispiele

    GET [base]/PractitionerRole?role=http://example.org/fhir/CodeSystem/RolleBeteiligtePerson|studienleiter

    Anwendungshinweise: Weitere Informationen zur Suche nach "PractitionerRole.code" finden sich in der FHIR-Basisspezifikation - Abschnitt "token".

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

    Beispiele

    GET [base]/PractitionerRole?telecom=phone|+4915232584956

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


Beispiele

Beispiel (minimal):

{
    "resourceType": "PractitionerRole",
    "id": "mii-exa-studie-beteiligte-person",
    "meta": {
        "profile":  [
            "https://www.medizininformatik-initiative.de/fhir/modul-studie/StructureDefinition/mii-pr-studie-beteiligte-person"
        ]
    },
    "code":  [
        {
            "coding":  [
                {
                    "code": "doctor",
                    "system": "http://terminology.hl7.org/CodeSystem/practitioner-role"
                }
            ]
        }
    ],
    "telecom":  [
        {
            "system": "phone",
            "value": "0123456789"
        }
    ],
    "organization": {
        "reference": "Organization/Example"
    },
    "practitioner": {
        "reference": "Practitioner/Example"
    }
}