RetinaIntegration
0.6.0 - ci-build

RetinaIntegration - Local Development build (v0.6.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

OperationDefinition: Retina Append AI Result Operation

Official URL: http://dips.no/fhir/RetinaIntegration/OperationDefinition/append-retina-ai-result Version: 0.6.0
Draft as of 2026-02-03 Computable Name: AppendRetinaAIResult

OperationDefinition for appending retina AI results to an existing DiagnosticReport.

Append results from AI analysis of retina images to a existing DiagnosticReport

Overview

The $append-retina-ai-result operation is used to add AI analysis results to an existing DiagnosticReport. This operation is invoked bye the regional integration platform after the AI system has analyzed retinal images.

Example

See RetinaAppendAIResultOperation-Example for a an example of the parameters.

Usage

Add AI result to an examination using the following operation:

[baseUrl]/DiagnosticReport/[id]/$append-retina-ai-result

[id] is the identifier UUID (Universally Unique Identifier), sometimes referred to as a GUID, of the DiagnosticReport, a.k.a examination, to update.

URL: [base]/DiagnosticReport/[id]/$append-retina-ai-result

Parameters

UseNameScopeCardinalityTypeBindingDocumentation
INsectraStudyId1..1string

Sectra study ID for the retinal images that were analyzed.

INconclusion1..1CodeableConcept

Conclusion indicating the next step. MUST be a single code from the 1000 series. If the validation parameter is set to true, the next step will always be manual grading.

INdaysUntilNextExamination0..1integer

Number of days until next examination. Only included if the conclusion code indicates that the next step is a new examination.

INleftDiabeticRetinopathy0..1decimal

Left eye diabetic retinopathy evaluation, a decimal between 0.0 and 5.0

INleftDiabeticMacularEdema0..1boolean

Left eye diabetic macular edema evaluation. True if diabetic macular edema is present.

INrightDiabeticRetinopathy0..1decimal

Right eye diabetic retinopathy evaluation, a decimal between 0.0 and 5.0

INrightDiabeticMacularEdema0..1boolean

Right eye diabetic macular edema evaluation. True if diabetic macular edema is present.

INrightEyeImage0..*Observation (Retina Image Parameter)

Right eye images used in the AI analysis. MUST conform to RetinaImageParameter profile.

INleftEyeImage0..*Observation (Retina Image Parameter)

Left eye images used in the AI analysis. MUST conform to RetinaImageParameter profile.

INaiDevice1..1Device (Retina AI Device)

AI Device that performed the analysis. Includes AI product name, algorithm version and protocol version.

INfullReport1..1Attachment

Technical details for further reference about the AI grading.

INvalidation1..1boolean

Set true if the AI result is for validation purposes only and will not be used in clinical decision making.