Indhold

Introduktion

Formål

Denne guide har som formål at give et overblik over Batchmotoren.

Beskrivelse

Batchmotoren anvendes til oprettelse af rekvisitioner og afsendelse af breve på baggrund af modtagne lister med CPR numre. De leverede lister med CPR numre indeholder også et ark med kontrol data som styrer håndteringen i batchmotoren.

Læsevejledning og forudsætninger

Dette dokument er henvendt til SSI ansatte der skal levere lister med CPR numre til Batchmotoren.

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, hvor v. 2.0 bør foretrækkes da den giver mulighed for at styre alle kontrol parametre, samt giver mulighed for at angive information til breve som skal indeholde links til spørgeskema undersøgelser.Begge . 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 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.

CPR Batch template v. 1.4

. 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  View filenameSSI_Indberetning_Template_v14.40.20.xltxheight150

CPR Batch template v. 2.0

CPR Batch template v. 3.0

. Betydningen af cifre kan aflæses i følgende tabel:

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).

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.

...

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.

...

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.

...

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.

...

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.

...

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.

...

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.

...

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).

...

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).

Test csv-fil

Filen herunder kan anvendes til test af brevskabeloner med de flettefelter der stilles til rådighed for Strålforsleverancen. View filenameSSI_COVID19_SKRX_200806_150027_01.csvheight250