Skip to content

Latest commit

 

History

History
88 lines (58 loc) · 6.15 KB

README.md

File metadata and controls

88 lines (58 loc) · 6.15 KB
Raw

Veiledning for KOSTRA-kontrollprogrammet - kommandolinjebasert

Begrep:

  • <rapporteringsår> = rapporteringsår (obligatorisk), det året dataene i filuttrekket gjelder for, f.eks. 2020.
  • <skjemanummer> = 0A, 0B, 0C etc..
  • <kvartal> = det kvartalet innsendingen gjelder for, f.eks. 1, 2, 3 eller 4. Benyttes ikke for årsfiler.
  • <region> = kommunenummer + bydelsnummer eller regionsnummer (obligatorisk), skal være 6 siffer, f.eks. 030100, 030112, 500100 eller 667600.
  • <navn> = navnet til den organisasjonen dataene gjelder for (valgfri).
  • <foretaksnummer> = organisasjonsnummer for det foretaket som filuttrekket gjelder for, f.eks. 987654321
  • <organisasjonsnummer> = kommaseparert liste (hvis flere enheter) med organisasjonsnumre for de(n) enheten(e) som filuttrekket gjelder for, f.eks. 976543218,965432187,965432187
  • <kildefil> = fullstendig sti (inkludert filnavn) (obligatorisk) til kildefilen/filuttrekket som skal kontrolleres, sendes inn vha. <. Hvis stien eller filnavnet inneholder mellomrom/blanke tegn må <kildefil> omsluttes av hermetegn (") .
  • <rapportfil> = fullstendig sti (inkludert filnavn) (valgfri) til en fil som kontrollprogrammet kan skrive kontrollrapporten til, vha. >. Hvis stien eller filnavnet inneholder mellomrom/blanke tegn må <rapportfil> omsluttes av hermetegn (") .

Bruksanvisning for kontrollprogrammet:

  1. Sørg for at datamaskinen har Java utviklingsmiljø (JDK) installert. Minimum versjon: 17 (OpenJDK).
  2. Gå til nedlastningsiden for nyeste versjon, last ned og lagre filen kostra-kontrollprogram-[VERSION].jar i en katalog på datamaskinens filsystem.
  3. Åpne et kommandolinjevindu, og naviger til katalogen nevnt i punkt 2.
  4. Avhengig av hvilken type filuttrekk du vil kontrollere, skriv inn et av følgende:

1. Kontroll av års baserte filuttrekk. Gjelder for skjemanummer 0A, 0B, 0C, 0D, 0M, 0N, 0P, 0Q, 11F, 11CF, 15F, 52AF, 52BF, 53F og 55F:

java -jar kostra-kontrollprogram.jar -y <rapporteringsår> -s <skjemanummer> -r <region> -n <navn> < <kildefil> > <rapportfil>

F.eks.: java -jar kostra-kontrollprogram.jar -y 2020 -s 0A -r 030100 -n "OSLO KOMMUNE" < "C:\sti\til\kildefil\BEV_030100.dat" > "C:\sti\til\rapport fil\kontrollrapport_0a.html"

java -jar kostra-kontrollprogram.jar -y 2020 -s 11F -r 030100 -n "OSLO KOMMUNE" < "C:\sti\til\kildefil\Sosial_030100.dat" > "C:\sti\til\rapport fil\kontrollrapport_11.html"

java -jar kostra-kontrollprogram.jar -y 2020 -s 52AF -r 667600 -n "BUFDIR" < "C:\sti\til\kilde fil\FILUTTREKK.dat" > "C:\sti\til\rapport fil\kontrollrapport_52af.html"

Programmet benytter standard in/out for henholdsvis kilde- og rapportfil.

2. Kontroll av årsbaserte filuttrekk for et gitt organisasjonsnummer. Gjelder for 0F, 0G, 0I, 0J, 0K og 0L:

java -jar kostra-kontrollprogram.jar -y <rapporteringsår> -s <skjemanummer> -r <region> -u <organisasjonsnummer> -n <navn> < <kildefil> > <rapportfil>

F.eks.: java -jar kostra-kontrollprogram.jar -y 2020 -s 0F -r 110300 -u 976993403 -n "STAVANGER KIRKELIGE FELLESRÅD" < "C:\sti\til\kildefil\BEV_976993403.dat" > "C:\sti\til\rapport fil\kontrollrapport_0f_976993403.html"

java -jar kostra-kontrollprogram.jar -y 2020 -s 0J -r 030100 -u 987592567 -n "OSLO HAVN KF" < "C:\sti\til\kildefil\BAL_987592567.dat" > "C:\sti\til\rapport fil\kontrollrapport_0j_987592567.html"

Programmet benytter standard in/out for henholdsvis kilde- og rapportfil.

3. Kontroll av årsbaserte filuttrekk for et helseforetak. Gjelder for 0X og 0Y:

java -jar kostra-kontrollprogram.jar -y <rapporteringsår> -s <skjemanummer> -r <region> -c <foretaksnummer> -u <organisasjonsnummer> -n <navn> < <kildefil> > <rapportfil>

F.eks.: java -jar kostra-kontrollprogram.jar -y 2020 -s "0X" -y "2020" -r "040000" -n "HELSE MIDT-NORGE RHF" -c "983658776" -u "985831580,996246507,983658776,918098275" < "C:\sti\til\kildefil\RES_983658776.dat" > "C:\sti\til\rapportfil\kontrollrapport_0x_983658776.html"

java -jar kostra-kontrollprogram.jar -y 2020 -s "0X" -r "120000" -n "HELSE SØR-ØST RHF" -c "991324968" -u "991324968" < "C:\sti\til\kildefil\RES_991324968.dat" > "C:\sti\til\rapportfil\kontrollrapport_0x_991324968.html"

Programmet benytter standard in/out for henholdsvis kilde- og rapportfil.

4. Kontroll av kvartalsbaserte filuttrekk. Gjelder for skjemanummer 0AK* og 0BK*:

java -jar kostra-kontrollprogram.jar -y <rapporteringsår> -s <skjemanummer> -q <kvartal> -r <region> -n <navn> < <kildefil> > <rapportfil>

F.eks.: java -jar kostra-kontrollprogram.jar -y 2020 -s 0AK1 -q 1 -r 030100 -n "OSLO KOMMUNE" < "C:\sti\til\kildefil\BEV_030100_K1.dat" > "C:\sti\til\rapport fil\kontrollrapport_0ak1.html"

Programmet benytter standard in/out for henholdsvis kilde- og rapportfil.

For utviklere

Komme i gang

Bygge app fra rot

./gradlew -p konsoll clean build

Starte app fra rot (merk at dette vil kaste IllegalArgumentException, se påkrevde argumenter over)

./gradlew -p konsoll run

Bygge kjørbar JAR-fil

./gradlew -p konsoll shadowJar

Starte app fra JAR-fil (merk at dette vil kaste IllegalArgumentException, se påkrevde argumenter over)

java -jar ./konsoll/build/libs/kostra-kontrollprogram-LOCAL-SNAPSHOT-all.jar