...

Antigentest indlæseren anvendes til at hente data om og vedligeholde en database med information 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 SSI ansatte der skal levere lister med CPR numre til Batchmotorenanvendere af de vedligeholdte data.

Sikkerhed

Definitioner og referencer

Dokument historik

Adgang, brug og snitflader

Adgang

Snitfladebeskrivelse og brug

CPR Batch

CPR batches leveres i en af nedenstående templates. Der findes i øjeblikket 2 typer af den gældende template. Én for regioner og én for alt andet. Der bør så vidt muligt anvendes nyeste version af disse templates, da det understøtter de eksisterende behov. Begge typer af templates indeholder kontrol information på 1. ark og listen af CPR numre der skal behandles på 2. ark. Et CPR batch leveres ved at anvender lægger CPR batches som en .xlsx fil i den tildelte SFTP folder, hvorefter den inden for få sekunder vil blive hentet og slettet af Batchmotoren. Repository for templates er: https://dksund.sharepoint.com/sites/covid19-testkapacitet, hvor alle versioner findes.

Versionering af templates

Det er nødvendigt, at styre versioneringen af templates efter en aftalt standard. Angivelsen af version på template-filer er på følgende format: x.y.z, hvor x,y og z repræsenterer et ciffer. Et eksempel på navnet for en template-fil er SSI_Indberetning_Template_4.0.0.xltx. Betydningen af cifre kan aflæses i følgende tabel:

...

z

...

Snitfladebeskrivelse og brug

Antigentest indlæseren henter data ved at kalde den beskrevne HTTP grænseflade med et antal søgekriterier.

Den URL der kaldes er:

https://covid-19-diagnostics.jrc.ec.europa.eu/devices/export/csv?manufacturer=&text_name=&marking=Yes&method=&rapid_diag=1&target_type=6&search_method=AND

URL'en fortæller at der hentes data

• på csv (tegnsepareret) format (csv)
• enheder der er CE godkendte (marking=Yes)
• enheder der anvendes til hurtigtest (rapid_diag=1)

Hvis et andet udtræk ønskes, kan konfigurations-propertien inputDeviceUrl ændres til at levere de ønskede data.

De mulige værdier kan afprøves på https://covid-19-diagnostics.jrc.ec.europa.eu/devices/

Input hentes fra den angivne URL og data mappes til tilsvarende felter i databasen

Håndtering af boolske værdier

Nogle af felterne i de modtagne CSV data repræsenterer boolske værdier.

Værdier der tilhører

("1", "yes", "y", "true")

opfattes som true og alle andre opfattes som false.

Hvis et felt indeholder en tydeligvis ikke boolsk værdi, vil den derfor opfattes som false.

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.

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 en kilden)
• Værdier i de hentede date 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

Image Added

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

Image Added

Fejl ved adgang til data kilden

Image Added

Fejl ved indlæsning af data

Image Added

Det er vigtigt, at versionen opdateres både på 1. ark i template-filen under feltet 'Version' og i det filnavn, som template'en gemmes under.

Flow for behandling af CPR Batch

Nedenstående figur beskriver flowet gennem batchmotoren med udgangspunkt i v. 2.0 batch templaten (v. 3.0 har yderligere mulighed for også at specificere om modtagerne af breve udelukkende skal have fysiske breve - dette gøres med "Send breve til eboks" optionen).

Image Removed

Daglig statistik

Batchmotoren vil på daglig basis tilføje statistik fra dagens kørte CPR Batches til et statistik regneark og levere dette til en angivet SFTP folder.

Statistikken leveres på formen

Den opdaterede statistik har navnet Statistik_<yyyy-MM-dd_HHmms>.xlsx, f.eks. Statistik_2020-07-23_013054.xlsx. Derved sikres det at en ny statistik ikke kommer til at overskrive en tidligere statistik.

Brevskabelon

Brevskabeloner skal indlæses i Batchmotoren for at de kan refereres fra et leveret CPR Batch.

Der kan tilføjes nye brevskabeloner ved at lægge dem som en .docx fil i den angivne SFTP folder. Herefter vil Batchmotoren indlæse brevskabelonen og gemme den internt men ikke fjerne den fra SFTP folderen. Derved kan anvendere se hvilke skabeloner der er til rådighed ved at inspirere indholdet af SFTP folderen.

Hvis en brevskabelon fjernes fra SFTP folderen bliver den ikke fjernet fra Batchmotoren.

I tvivlstilfæld eller hvis der er behov for at fjerne en brevskabelon fra Batchmotoren skal NSP kontaktes da de har mulighed for at se hvilke skabeloner der ligger internt i Batchmotoren og kan redigere dette indhold.

Flettefelter i brevskabeloner

Hver brevskabelon vil indeholde flettefelter som refererer til de fletteværdier som leveres til Strålfors.

De mulige flettefelter der kan anvendes er:

...

Hvis Batchtemplaten angiver at der skal udsendes et spørgeskema, vil disse flettefelter også være til rådighed:

...

Fejlbeskeder

Prøvebestillingsindlæseren er designet til at gøre opmærksom på hvis et modtaget CPR batch indeholder fejl der umuliggør behandling af filen.

Hvis der detekteres fejl lægges der en fil tilbage i SFTP folderen der hedder det samme som den modtagne fil men med endelsen .fejl. F.eks. hvis der leveres en fejlbehæftet fil med navnet SSI_Indberetning_20200601.xlsx vil der efter behandling af filen ligge i fil med navnet SSI_Indberetning_20200601.fejl i SFTP folderen som indeholder en beskrivelse af den detekterede fejl.

De fejlsituationer der håndteres er:

Der er tidligere modtaget et CPR batch med samme navn

Hvis der modtages et CPR batch med samme navn som en tidligere behandlet fil, vil fejl filen indeholde følgende beskrivelse:

CPR filen SSI_Indberetning_20200601.xlsx er fejlet og der er IKKE oprettet rekvisitioner eller afsendt breve på baggrund af denne fil.
Årsagen til fejlen er: En CPR liste med filnavnet SSI_Indberetning_20200601.xlsx er behandlet tidligere.
Når fejlen er rettet kan filen forsøges behandlet igen.

CPR batchet anvender en ukendt brevskabelon

Informationen på 1. faneblad skal udpege de brevskabeloner der skal anvendes til udsendelse af breve til de angivne CPR numre.

Hvis de angivne skabelon navne ikke matcher en kendt brevskabelon og der derfor ikke kan sendes de korrekte oplysninger til Strålfors, vil fejl filen indeholde følgende beskrivelse:

CPR filen SSI_Indberetning_20200601.xlsx er fejlet og der er IKKE oprettet rekvisitioner eller afsendt breve på baggrund af denne fil.
Årsagen til fejlen er: Der eksisterer ikke nogen brev-skabelon der matcher ønskede skabeloner XXXX og/eller YYYY i filen SSI_Indberetning_20200601.xlsx.
Når fejlen er rettet kan filen forsøges behandlet igen.

CPR batchet indeholder ikke nogen valide CPR numre

Hvis der ikke kan fremfindes nogen CPR numre i filen, vil fejl filen indeholde følgende beskrivelse:

CPR filen SSI_Indberetning.xlsx er fejlet og der er IKKE oprettet rekvisitioner eller afsendt breve på baggrund af denne fil.
Årsagen til fejlen er: Filen SSI_Indberetning.xlsx
- indeholder ikke nogen valide CPR numre.

CPR batches er korrupt

Hvis CPR filen er beskadiget og derfor ikke kan indlæses, vil fejl filen indeholde følgende beskrivelse:

CPR filen SSI_Indberetning_20200601.xlsx er fejlet og der er IKKE oprettet rekvisitioner eller afsendt breve på baggrund af denne fil.
Årsagen til fejlen er: Filen SSI_Indberetning_20200601.xlsx kan ikke indlæses som et Excel regneark.
Når fejlen er rettet kan filen forsøges behandlet igen.

CPR batchet mangler kontrol data

Informationen på 1. faneblad skal styre behandlingen af rekvisitioner og breve. Hvis ikke alle oplysningerne er udfyldt kan det betragtes som en fejl.

Hvis der mangler kontrol data i filen, vil fejl filen indeholde følgende beskrivelse (afhængig af hvilke kontrol data der mangler):

CPR filen SSI_Indberetning.xlsx er fejlet og der er IKKE oprettet rekvisitioner eller afsendt breve på baggrund af denne fil.
Årsagen til fejlen er: Filen SSI_Indberetning.xlsx
- indeholder ikke en angivelse af "Batch ID"
- indeholder ikke en angivelse af "Prøvetype"
- indeholder ikke en angivelse af "Send breve til gr1"
- indeholder ikke en angivelse af "Send breve til gr2+"
- indeholder ikke en angivelse af "Rekvisition til gr2+"

Når fejlen er rettet kan filen forsøges behandlet igen.

eller

CPR filen SSI_Indberetning.xlsx er fejlet og der er IKKE oprettet rekvisitioner eller afsendt breve på baggrund af denne fil.
Årsagen til fejlen er: Filen SSI_Indberetning.xlsx
- indeholder ikke en angivelse af "Prøvetype"
- indeholder ikke en angivelse af "Rekvisition til gr2+"
- indeholder ikke en angivelse af "Brevskabelon til gr2+"

Når fejlen er rettet kan filen forsøges behandlet igen.

CPR filen indeholder in-valide CPR numre

Enkelte CPR numre er ikke valide (f.eks. indeholder bogstaver) eller de kan ikke slås op i Person registret. I disse tilfælde fortsætter behandlingen af de resterende CPR numre og når behandlingen er færdig lægges der en fejl fil med navnet f.eks. SSI_Indberetning.cprfejl som indeholder listen af de CPR numre der ikke kunne behandles.

Hvis der er invalide CPR numre, vil fejl filen indeholde følgende beskrivelse:

CPR filen SSI_Indberetning.xlsx indeholder CPR fejl og der er IKKE oprettet rekvisitioner eller sendt breve for disse CPR numre:
0109981234 - findes ikke i Person registret
0110981234 - findes ikke i Person registret
0112981234 - findes ikke i Person registret
106991ab4 - >106991ab4< er ikke numerisk
0201981234 - findes ikke i Person registret

Test

Ved aftestning af templates osv. henstilles til at anvende NSPs testmiljø, hvor der kan anvendes testborgere af forskellige typer.

Der findes således en test sftp-server, hvor hele flowet omkring ibrugtagning af nye brevskabeloner, "ikke funktionelle" ændringer i excel-templaten osv. kan prøves af. Det anbefales derfor at arbejdsgangen for ibrugtagning af brevskabeloner og ny template er nogenlunde som følger (set i henhold til  NSP snitfladerne):

1. opret/ret brevskabeloner og tilføj nyt timestamp til disses filnavne
2. test brevskabeloner med test-csv-fil fra NSP, således flettefelterne bliver verificeret.
3. tilret template med nye skabelonnavne
4. upload brevskabeloner til testmiljøets SFTP brevskabelon-folder
5. Find testcprnumre, der dækker de ønskede udfaldsrum (her tænkes sortering i gr1 og gr2, således inputtet matcher med den nye skabelon). Indsæt disse i en excelfil lavet med ny template.
6. Upload denne til testmiljøets SFTP batch-folder
7. Verificer at der ikke kommer fejlbeskeder tilbage på ny skabelon og template
8. Få evt. NSP support til at verificere det videre flow (frembringelse af csv-filer etc.).
9. Gentag pkt. 3 på produktionsmiljøet - den nye excel template kan således tages i brug.

Test borgere

NSP stiller muligheden for at oprette testborgere til rådighed via den Dynamiske Testdatagenerator (DTG).

Denne findes via dette link: https://stamdata.nspop.dk/ (kræver oprettet bruger)

For denne findes der en anvenderguide her: https://www.nspop.dk/display/public/web/DTG+-+Guide+til+anvendere

Alternativt kan medcoms test-cprnumre også anvendes, idet de også er oprettet på NSP (de kan søges frem i DTG også, så relationer/adresser osv kan verificeres her).

Disse kan findes her: https://www.medcom.dk/opslag/koder-tabeller-ydere/tabeller/nationale-test-cpr-numre (der er på siden et link til et excel ark indeholdende testpersonerne).