CurrentPolicyStatesForPerson

Unterstützt ab TTP-FHIR Gateway Version 2.1.0

Voraussetzung
  • Spezifizierte Domäne muss angelegt sein
  • Es muss eine gültige Einwilligung mit dem gegebenen personIdentifier existieren
  • Unterstützt ab TTP FHIR Gateway Version 2.1.0 (gICS 2.13.4)
Aufruf und Rückgabe

Invocations

URL: [base]/$currentPolicyStatesForPerson

This operation does NOT change content

Parameters (In)

NameCardinalityTypeDocumentation
personIdentifier1..*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 und Verzicht auf Config-Parameter werden diese ODER-verknüpft (dies entspricht der Konfiguration AT-LEAST-ONE).

domain1..1string

Angabe der Einwilligungsdomaene

config0..1Parameters

Return Values (Out)

NameCardinalityTypeDocumentation
return0..1Bundle

Bundle mit den beschriebenen Inhalten

Liefert die aktuellen, gültigen Policies einer Person einer spezifischen Einwilligungsdomaene (Status: permit, deny). Die Rückgabe erfolgt als Bundle vom Typ "collection". Das Bundle enthält ausschließlich Consent-Ressourcen zur Abbildung der Policies, d.h. je unterzeichneter Policy ist eine Consent-Ressource mit jeweils einer Policy (provision) enthalten.

Per default werden alle aktuell gültigen vom Patienten unterzeichneten Policies zurückgegeben (Accepted=Permit, Declined=Deny, Unknown=Deny). Sollen eingewilligte Policies mit Status "Unknown" ignoriert werden (mittels UNKNOWN können detailliertere Statusangaben wie UNKNOWN, NOT_ASKED, NOT_CHOSEN, WITHDRAWN, INVALIDATED, REFUSED und EXPIRED intern gruppiert werden) , kann dies parametrisiert werden (checkconsentconfig.unknownStateIsConsideredAsDecline=false).

Der Parameter config enthält eine verschachtelte Parameters-Ressource entsprechend dem Config-Profil:

idΣ0..1string
metaΣ0..1Meta
implicitRulesΣ ?!0..1uri
language0..1codeBinding
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
nameΣ1..1string
valueBase64Binarybase64Binary
valueBooleanboolean
valueCanonicalcanonical()
valueCodecode
valueDatedate
valueDateTimedateTime
valueDecimaldecimal
valueIdid
valueInstantinstant
valueIntegerinteger
valueMarkdownmarkdown
valueOidoid
valuePositiveIntpositiveInt
valueStringstring
valueTimetime
valueUnsignedIntunsignedInt
valueUriuri
valueUrlurl
valueUuiduuid
valueAddressAddress
valueAgeAge
valueAnnotationAnnotation
valueAttachmentAttachment
valueCodeableConceptCodeableConcept
valueCodingCoding
valueContactPointContactPoint
valueCountCount
valueDistanceDistance
valueDurationDuration
valueHumanNameHumanName
valueIdentifierIdentifier
valueMoneyMoney
valuePeriodPeriod
valueQuantityQuantity
valueRangeRange
valueRatioRatio
valueSampledDataSampledData
valueSignatureSignature
valueTimingTiming
valueContactDetailContactDetail
valueContributorContributor
valueDataRequirementDataRequirement
valueExpressionExpression
valueParameterDefinitionParameterDefinition
valueRelatedArtifactRelatedArtifact
valueTriggerDefinitionTriggerDefinition
valueUsageContextUsageContext
valueDosageDosage
valueMetaMeta
valueReferenceReference()
resourceΣ I0..1Resource
partΣ0..*see (parameter)
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
nameΣ1..1stringFixed Value
id0..1string
extensionI0..*Extension
systemΣ1..1uri
versionΣ0..1string
codeΣ1..1code
displayΣ0..1string
userSelectedΣ0..1boolean
resourceΣ I0..0Resource
partΣ0..0see (parameter)
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
nameΣ1..1stringFixed Value
valueBooleanboolean
resourceΣ I0..0Resource
partΣ0..0see (parameter)
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
nameΣ1..1stringFixed Value
valueBooleanboolean
resourceΣ I0..0Resource
partΣ0..0see (parameter)
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
nameΣ1..1stringFixed Value
valueDatedate
resourceΣ I0..0Resource
partΣ0..0see (parameter)

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:

<Parameters xmlns="http://hl7.org/fhir">
    <id value="CurrentPolicyStatesForPerson-request-example-1" />
    <parameter>
        <name value="personIdentifier" />
        <valueIdentifier>
            <system value="https://ths-greifswald.de/fhir/gics/identifiers/Pseudonym" />
            <value value="dic_1H51T" />
        </valueIdentifier>
    </parameter>
    <parameter>
        <name value="domain" />
        <valueString value="MII" />
    </parameter>
    <parameter>
        <name value="config" />
        <resource>
            <Parameters>
                <parameter>
                    <name value="idMatchingType" />
                    <valueCoding>
                        <system value="https://ths-greifswald.de/fhir/CodeSystem/gics/IdMatchingType" />
                        <code value="AT_LEAST_ONE" />
                    </valueCoding>
                </parameter>
                <parameter>
                    <name value="ignoreVersionNumber" />
                    <valueBoolean value="false" />
                </parameter>
                <parameter>
                    <name value="unknownStateIsConsideredAsDecline" />
                    <valueBoolean value="false" />
                </parameter>
                <parameter>
                    <name value="requestDate" />
                    <valueDate value="2022-01-13" />
                </parameter>
            </Parameters>
        </resource>
    </parameter>
</Parameters>

Beispielhafte Rückmeldung:

Command 'xml' could not render: File not found for 'subject=Resources/fsh-generated/resources/Bundle-CurrentPolicyStatesForPerson-response-example-1.json'