Page History
| Navitabs | ||||||
|---|---|---|---|---|---|---|
| ||||||
Indhold
Table of Contents
Introduktion
Formål
Denne guide har som formål at give et overblik over Antigentest indlæseren.
Beskrivelse
Antigentest indlæseren anvendes til at hente og vedligeholde data om Antigentest enheder der er godkendte i Europa.
Denne information bliver f.eks. anvendt til Corona-passet for at afgøre om en given test er udført med en godkendt enhed.
Læsevejledning og forudsætninger
Dette dokument er henvendt til anvendere af de vedligeholdte data.
Sikkerhed
| Service udstil type | - |
| Krævede adgange | - |
| Whitelisting | - |
| Krævet sikkerhedsniveau | - |
| Forudsætninger for anvendelse | - |
| Logning | Det logges når et Antigentest data hentes |
Definitioner og referencer
Reference | Beskrivelse |
|---|---|
| NSP | Den nationale service platform |
Dokument historik
Dato | Ansvarlig | Beskrivelse | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 22/11-2021 | Mikael Jørgensen | Initiel version | ||||||||||||
| 22/02-2022 | Mikael Jørgensen | Tilrettet jf.
| ||||||||||||
| 22/2-2023 | Mikael Jørgensen | Tilrettet jf. ? |
Adgang, brug og snitflader
Adgang
| Teknisk navn | antigentestregister |
| Opdateringsfrekvens | Dagligt |
| Kilde | NSP Proxy - https://eu-proxy-prod.nsp.dsdn.dk |
| Versioner | 1 (ny reference implementering) |
Snitfladebeskrivelse og brug
Antigentest indlæseren henter data ved at kalde den beskrevne HTTP grænseflade.
Den URL der kaldes er:
https://eu-proxy-prod.nsp.dsdn.dk
URL'en henter et fast datasæt fra NSP Proxy.
URL'en styres via konfigurations-propertien inputDeviceUrl.
Input hentes fra den angivne URL og data mappes til tilsvarende felter i databasen
Hentning af data
Antigentest indlæseren vil hente data med den frekvens der er angivet i konfigurations propertien fetch.cron.
Manuel hentning af data
Efter behov kan hentning af data aktiveres via statussiden ved at kalde URL'en http://<host>:<port>/antigentestindlaeser/status?FetchData=Start hvor <host> og <port> peger på den aktuelle installation.
Datatyper - oversigt
Navn | Beskrivelse |
|---|---|
| antigentest | Stamdata for et antigentest udstyr |
Datatyper - detaljer
| Datatype: antigentest | ||||
|---|---|---|---|---|
| Feltnavn | Beskrivelse | Optional | Unik nøgle | Type |
idDevice | Udstyrs ID | Nej | x | VarChar(16) |
display | Display tekst | Ja | VarChar(4000) | |
lang | Sprog | Ja | VarChar(50) | |
active | Angiver om testen er aktiv | Ja | Boolean | |
system | Datakilden | Ja | VarChar(4000) | |
version | Tidsstempel der angiver versionen | Ja | VarChar(200) | |
validUntil | Tidsstempel der angiver slutdato for testen | Ja | VarChar(200) | |
DataModifiedDate | Modificeret (format: yyyy-MM-ddTHH:mm:ss+Z) | Ja | Timestamp | |
DataValidFrom | Gyldig fra (format: yyyy-MM-ddTHH:mm:ss+Z) | Nej | Timestamp | |
DataValidTo | Gyldig til (format: yyyy-MM-ddTHH:mm:ss+Z) | Nej | Timestamp | |
Statusside
Statusservicen kan tilgås på URL http://<host>:<port>/antigentestindlaeser/status hvor <host> og <port> peger på den aktuelle installation.
Denne statusservice returnerer en HTTP status kode, som enten er 200 (ok) eller 500 (internal server error). Ved 500 er det tegn på, at en NSP driftleverandøren skal i gang med at undersøge problemet.
Statusservicen giver udslag i følgende situationer, som vil sætte support i gang:
- Afhængighedsproblemer (fx. ingen forbindelse til kilden)
- Værdier i de hentede data overholder ikke formatet eller enkelte værdier overstiger den allokerede længde i databasen
De mulige svar fra statusservicen er:
OK status
Ved normal drift vil statusservicen returnere http 200 med denne information
Ikke Ok status
Opstår som følge af HTTP 500 status kode og kræver NSP driftleverandørens umiddelbare opmærksomhed. De mulige situationer, hvor HTTP 500 status kode leveres er beskrevet herunder.
Fejl ved adgang til databasen
Fejl ved adgang til data kilden
Fejl ved indlæsning af data
Værdi i data overstiger allokeret felt I databasen - enkelte elementer indlæses ikke
Data overholder ikke overordnet struktur - hele datasættet afvises
Elementer i data overholder ikke strukturen - enkelte elementer indlæses ikke
