Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Alle filer der refereres til ligger sammen med projektets kildekode i NSP's Subversion. Referencer til stier er relative med udgangspunkt i projektets rodmappe.

Byggevejledning

For at bygge projektet og dets deployables (war-filen) uden at køre unit-tests og integrationstests, anvendes følgende Maven kommando:

mvn clean install -DskipTests

Projektets deployables ender i target-mappen under de respektive moduler.

Afvikling af unit-tests

Unit-testene i projektet kan afvikles med følgende Maven-kommando:

mvn clean test

Alternativt kan også samtidigt bygge projektet ved at anvende Maven-kommandoen:

mvn clean install

Når unittests afvikles startes en database og SFTP server op vha. TestContainers. Relevante databaseobjekter oprettes automatisk i den forbindelse.

Afvikling af integrationstests

Se testvejledningen.

Krav til miljø

Komponenten er tilpasset at kunne indgå i det aktuelt gældende CI-miljø på NSP. Det tager aktuelt udgangspunkt i version 1 af NSP's platform Docker image.

...

Ved initial installation af servicen vil Flyway håndtere at køre scriptene i den korrekte rækkefølge:.

Deployment

Komponenten deployes vha. NSP's platform Docker image og konfigurationsfiler mountes i containeren som angivet i projektets Compose-filer.

...

Property

Beskrivelse

Default

datasource.jndi

Angiver navnet på den datasource der er konfigureret på Wildfly'en.

java:jboss/datasources/yder

failIfNotRunInNumberOfDays

Hvis der ikke er blevet indlæst data i det antal dage der står i denne property, så melder servicen en statusfejl.

2

allowableDifferencePercentage

Hvis modtagne data afviger mere denne % sats meldes en fejl og indlæsningen stoppes30
batchSizeData persisteres i databasen i batches og størrelsen på disse angives i denne property.100
batchTimeoutAngiver Hvis der ikke er flere data at persistere, og det igangværende batch derfor ikke kan nå batchSize, angiver denne tiden i millisekunder for hvornår en Camel aggregering har været inaktiv - og dermed er færdigder ventes på yderligere data før et batch anses for at være komplet.500
input_camelUrlAngiver det Camel udtryk hvor der henter input-filerne kan hentesfra SFTP serveren.*)

ekstern_camelUrl

Denne konfiguration er udelukkende til brug for Yderindlæseren og er således ikke en generisk funktionalitet i indlæser reference arkitekturen

Den Data fra den indlæste fil bliver indlæst i en database og den leveres også . Det er muligt at få indholdet af den indlæste fil leveret til en ekstern sftpSFTP-server. Her angives det , og dette Camel udtryk hvor angiver hvordan filen skal leveres.**)
backupType

Angiver den ønskede backuptype

  • RawBackup - der foretages en backup af den rå fil. Hvis den modtagne fil har navnet xxx.yyy vil backup filen få navnet xxx-<exchangeId>.yyy hvor <exchangeId> er et UUID som vil matche log- og database registreringer for behandlingen af filen. Backup filen placeres i backupFolder.
  • ZipBackup - der foretages et zip backup af den modtagne fil. Hvis den modtagne fil har navnet xxx.yyy vil backup filen få navnet xxx-<exchangeId>.zip hvor <exchangeId> er et UUID som vil matche log- og database registreringer for behandlingen af filen. Backup filen placeres i backupFolder.
  • NoBackup - der foretages ikke noget backup af den modtagne fil
RawBackup
backupFolderAngiver placering af backup fil. Dette er en folder internt i den Docker container der kører Yderindlæseren, og for at have adgang til de backup'ede filer efter Docker containeren er slukket, skal der laves en volume-mount af en ekstern folder ind til den angivne folder i Docker containeren. 
/tmp/yder/input/.done


De to Camel udtryk er meget lange så defaultværdierne står her:

...