RiskAssessment-Interface

The CapabilityStatement

Maia RiskAssessment Interface CapabilityStatement

This CapabilityStatement specifies the MAIA RiskAssessment interface for accessing all rule-based evaluations and risk prediction models relevant to patients currently admitted to the facility.


REST Capabilities Server

ModeServer

Resource Interactions

Resource Type

Global Operations

OperationReferenceLevel
Operation - Maia RiskAssessmentRequestOperation - Maia RiskAssessmentRequestSHALL


The Operation

Operation - Maia RiskAssessmentRequest

Maia defines an interface to consume Tiplu risk prediction models and rule-based evaluations. The following OperationDefinition is the representation of that interface. In addition to the RiskAssessments, the result contains CaseErrors and Interactions. It is not possible to retrieve RiskAssessments by their ID or via FHIR search due to missing associated MaiaCaseErrors. RiskAssessments must not be consumed unless the corresponding MaiaCaseErrors have been reviewed.


Invocations

URL: [base]/RiskAssessment/$maiarisks

Parameters (In)

NameCardinalityTypeBindingDocumentation
Fallnummer1..*string

One or more account identifiers (German: Fallnummer/Abrechnungsnummer) for which MAIA results are to be requested. A maximum of 64 identifiers can be processed.

FilterMethod0..*CodingMaiaAssessmentMethodVS (required)

This filter allows restricting the RiskAssessment output to include only specific types of MaiaAssessment methods. It enables precise control over which evaluation methodologies are considered in the result set.

FilterReviewStatus0..*CodingMaiaRuleBasedEvaluationReviewStatusVS (required)

This filter allows control over which review statuses the MaiaRuleBasedEvaluations should have in the result set. The filter only takes effect if the code 'TRBE' has not been removed via the 'FilterMethod' parameter.

FilterRiskResultCategory0..*CodingMaiaRiskResultCategoryVS (required)

This filter allows limiting Tiplu risk predictions to specific outcomes. The filter only applies if the code 'TRPM' has not been removed via the 'FilterMethod' parameter.

RiskResultAmount0..*integer

Anzahl der mitgelieferten Results bei RiskPrediction

Return Values (Out)

NameCardinalityTypeDocumentation
RiskResult1..*(MaiaRiskAssessmentRequestOutput)
RiskResult.Fallnummer1..1Identifier

The Fallnummer to which all information in this RiskResult context refers.

RiskResult.RiskAssessmentResultBundle0..*Resource
RiskResult.CaseError0..*Resource

List of all MaiaCaseErrors


The Out-Parameter

MaiaRiskAssessmentRequestOutput

Structure for the response to the MaiaRiskAssessmentRequest operation, containing risk assessment results, errors, and interaction details.


idΣ0..1string
metaΣ0..1Meta
implicitRulesΣ ?!0..1uri
language0..1codeBinding
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
nameS Σ1..1stringPattern
resourceΣ I0..0Resource
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
nameS Σ1..1stringPattern
id0..1string
extensionI0..*Extension
useΣ ?!0..1codeBinding
typeΣ0..1CodeableConceptBinding
systemS Σ0..1uri
valueS Σ0..1string
periodΣ0..1Period
assignerΣ0..1Reference(Organization)
resourceΣ I0..0Resource
partΣ0..0see (parameter)
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
nameS Σ1..1stringPattern
resourceI0..1MaiaRiskAssessmentResultBundle
partΣ0..0see (parameter)
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
nameS Σ1..1stringPattern
resourceI0..1MaiaCaseError
partΣ0..0see (parameter)


The Result-Bundle

MaiaRiskAssessmentResultBundle

This profile defines the structure of the result bundle returned by the MaiaRiskAssessmentRequest operation. It contains all relevant resources associated with risk predictions and rule-based evaluations for a specific case, including RiskAssessments, referenced ServiceRequests, risk definitions, and recorded user interactions.


idΣ0..1string
metaΣ0..1Meta
implicitRulesΣ ?!0..1uri
language0..1codeBinding
identifierΣ0..1Identifier
typeS Σ1..1codeBindingPattern
timestampΣ0..1instant
totalΣ I0..1unsignedInt
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
relationΣ1..1string
urlΣ1..1uri
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
fullUrlΣ0..1uri
resourceΣ0..1Resource
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
modeΣ0..1codeBinding
scoreΣ0..1decimal
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
methodΣ1..1codeBinding
urlΣ1..1uri
ifNoneMatchΣ0..1string
ifModifiedSinceΣ0..1instant
ifMatchΣ0..1string
ifNoneExistΣ0..1string
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
statusΣ1..1string
locationΣ0..1uri
etagΣ0..1string
lastModifiedΣ0..1instant
outcomeΣ0..1Resource
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
fullUrlΣ0..1uri
resourceS Σ0..1MaiaRuleBasedEvaluation, MaiaRiskPredictionModel
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
modeΣ0..1codeBinding
scoreΣ0..1decimal
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
methodΣ1..1codeBinding
urlΣ1..1uri
ifNoneMatchΣ0..1string
ifModifiedSinceΣ0..1instant
ifMatchΣ0..1string
ifNoneExistΣ0..1string
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
statusΣ1..1string
locationΣ0..1uri
etagΣ0..1string
lastModifiedΣ0..1instant
outcomeΣ0..1Resource
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
fullUrlΣ0..1uri
resourceS I0..1MaiaRuleBasedEvaluationServiceRequestHint
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
modeΣ0..1codeBinding
scoreΣ0..1decimal
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
methodΣ1..1codeBinding
urlΣ1..1uri
ifNoneMatchΣ0..1string
ifModifiedSinceΣ0..1instant
ifMatchΣ0..1string
ifNoneExistΣ0..1string
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
statusΣ1..1string
locationΣ0..1uri
etagΣ0..1string
lastModifiedΣ0..1instant
outcomeΣ0..1Resource
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
fullUrlΣ0..1uri
resourceS I0..1MaiaRiskAssessmentDefinition
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
modeΣ0..1codeBinding
scoreΣ0..1decimal
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
methodΣ1..1codeBinding
urlΣ1..1uri
ifNoneMatchΣ0..1string
ifModifiedSinceΣ0..1instant
ifMatchΣ0..1string
ifNoneExistΣ0..1string
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
statusΣ1..1string
locationΣ0..1uri
etagΣ0..1string
lastModifiedΣ0..1instant
outcomeΣ0..1Resource
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
fullUrlΣ0..1uri
resourceS I0..1MaiaRuleBasedEvaluationInteraction
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
modeΣ0..1codeBinding
scoreΣ0..1decimal
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
methodΣ1..1codeBinding
urlΣ1..1uri
ifNoneMatchΣ0..1string
ifModifiedSinceΣ0..1instant
ifMatchΣ0..1string
ifNoneExistΣ0..1string
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
statusΣ1..1string
locationΣ0..1uri
etagΣ0..1string
lastModifiedΣ0..1instant
outcomeΣ0..1Resource
signatureΣ0..1Signature


The Profiles

Tiplu risk predictions are based on machine learning models trained in Tiplu's own ML network and on the basis of medical labels, which are used to generate alerts on the probability of occurrence of certain diseases and medical events.

German: Tiplu-Risikoprädiktionen beruhen auf Machine Learning-Modellen, die im Tiplu-eigenen ML-Netz und auf Grundlage medizinischer Labels trainiert werden und auf deren Basis Hinweise zur Eintrittswahrscheinlichkeit bestimmter Erkrankungen und medizinischer Ereignisse angeboten werden.

Tiplu presumed diagnoses are generated and displayed based on a set of rules derived from medical guidelines and literature (state-of-the-art medicine).

Customised presumptive diagnoses can be created and released to all MAIA users in the hospital by physicians trained by the manufacturer, known as Medical Administrators, using a rules editor built into MAIA. These function similarly to Tiplu presumed diagnoses, but additionally provide the option to include therapy and diagnostic information. Medical administrators can enable/disable these rules only for patients within the departments for which they have access rights.

German: Tiplu-Verdachtsdiagnosen werden auf der Grundlage eines von Leitlinien und Fachliteratur (State-of-the-Art Medizin) basierenden Regelwerkes generiert und angezeigt.

Vom Hersteller geschulte Ärzte, so genannte Medical Administrators, können mithilfe eines in MAIA integrierten Regeleditors benutzerdefinierte Verdachtsdiagnosen erstellen und für alle MAIA-Benutzer im Krankenhaus freigeben. Diese funktionieren analog zu Tiplu-Verdachtsdiagnosen, bieten jedoch zusätzlich die Möglichkeit, Therapie- und Diagnostikinformationen zu hinterlegen. Medizinische Administrator:innen können dabei entsprechende Hinweise nur für Patient:innen der Fachabteilungen aktivieren/deaktivieren, auf deren Patient:innen sie ein Zugriffsrecht haben.

The profile captures the interaction with a rule-based evaluation, including the type of interaction performed, the time of execution, the evaluated target, and the responsible agent.

German: Das Profil erfasst die Interaktion mit einer Verdachtsdiagnose, einschließlich der Art der durchgeführten Interaktion, des Ausführungszeitpunkts, des bewerteten Ziels und des zuständigen Agenten.

MAIA offers the possibility to additionally store structured and user-defined therapy and diagnostic information for presumed diagnoses. These contents are represented in a profiled ServiceRequest, which standardizes the documentation of recommended measures and clinical assessments.

German: MAIA bietet die Möglichkeit, bei Verdachtsdiagnosen zusätzlich strukturierte und benutzerdefinierte Therapie- und Diagnostikinformationen zu hinterlegen. Diese Inhalte werden in einem profilierten ServiceRequest abgebildet, der empfohlene Maßnahmen und klinische Bewertungen standardisiert dokumentiert.

This profile defines the basic structure for a risk assessment definition.
Since FHIR R4 does not include a dedicated RiskAssessmentDefinition resource, we initially chose the Basic resource extended with custom extensions.
The profile represents general information about suspected diagnoses and risk predictions that are universally valid.
It is referenced via the RiskAssessment.basis element.

German: Mit diesem Profil wird die grundlegende Definition eines RiskAssessment abgebildet.
Da in FHIR R4 keine dedizierte Ressource für RiskAssessmentDefinition existiert, wurde im ersten Schritt die Basic-Ressource mit entsprechenden Extensions verwendet.
Das Profil enthält allgemeine Informationen zu Verdachtsdiagnosen und Risikoprädiktionen, die unabhängig vom Einzelfall gültig sind.
Es wird über das Element RiskAssessment.basis referenziert.