Versions Compared

Key

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

...

Der er udviklet et testværktøj, til at trække data for samtlige SOR2 registre ud af KRS, og gemmer dem lokalt på disken i CSV format. Dette gør test på data i KRS lettere at kontrollere.

Formålet er, at kommende brugere vil kunne teste de udtræk der generes fra KRS servicen. Det kræver, at IT-kyndige fagfolk downloader Java, og generere udtrækkene til forretningsbrugerne, der skal teste data.

KRS-testværktøjet vil være i stand til følgende udtræk (og varianter af disse), som konverteres til .csv-format:

  • Fulde KRS-udtræk til dags dato
  • Deltaudtræk (udtræk fra en given dato til dags dato); disse bruges i produktion til opdatering af et register

Værktøjet køres fra lokal maskine og et deltaudtræk vil forudsætte medsendelse af en "token" (datostempel for seneste udtræk) der oprettes ved udtræk.


Værktøjet er sat op, så mindst mulig opsætning fra brugerens side er nødvendigt. Det kan startes uden at angive nogen parametre overhovedet, og den vil hente alt data fra samtlige registre.

...

Kort navnLangt navnStandard værdiBeskrivelse
-h--help
Printer hjælpeteksten med kort opsummering af alle parametre, og stopper eksekveringen derefter
-s--stsUrlhttp://test1.ekstern-test.nspop.dk:8080/sts/services/NewSecurityTokenServiceURL til STS for at hente en ny adgangstoken
-n--systemNameTE-STSNavn på kaldeststemet, bruges i forbindelse med at hente adgangstoken
-c--companyNameCAPGEMINI DANMARK A/SNavn på virksomheden som henter adgangstoken
-b--companyCvr25606965CVR for virksomheden som henter adgangstoken
-p--vaultPath

Sti til certifikat container, bruges til autentificering mod både STS og KRS. Skal være i JKS format. Sættes ingen, benyttes et medfølgende certifikat fra Capgemini.

Konverter fra PKCS12 til JKS format kan gøres ved brug af keytool værktøjet medfølgende i alle Java installationer (se eventuelt hjælp ved at sætte -h til kommandoen for at se yderligere parametre):

keytool -importkeystore -srckeystore <source.p12> -srcstoretype pkcs12 -srcalias <soureAlias> -destkeystore <destination.jks> -deststoretype jks -deststorepass <destinationPassword> -destalias <destinationAlias>

-w--vaultPassword
Password for den angivne certifikat container
-a--certName
Navnet på det certifikat der skal bruges
-q--certPassword
Password for certifikatet der skal bruges
-u--skrsUrlhttp://test1-cnsp.ekstern-test.nspop.dk:8080/stamdata-batch-copy-ws/service/StamdataReplicationURL til KRS
-o--registerOffset0

Offset værktøjet skal begynde at hente data fra, 0 angiver fra begyndelsen af (alt data).

Parametren kan angives på to forskellige måder, UNIX timestamp i sekunder (UTC) eller i et format der matcher "yyyy-MM-dd[[' ']['T']HH[':'mm[':'ss]]][XXX]". Formatet lægger sig op af ISO-8601, men fuld forklaring på alt i formatet kan findes her: https://docs.oracle.com/javase/8/docs/api/java/time/format/DateTimeFormatter.html

-m--registerMaxRecords1000Antallet af rækker der skal returneres fra KRS ved hvert kald. Værktøjet kalder kontinuert indtil alt data er hentet ned, dette påvirker bare hvor mange kald den kommer til at lave før at det sker - højere tal giver færre kald til KRS, men også længere ventetid mellem hvert kald, og længere tid før yderligere data skrives til de genererede filer.
-r--registers

Hvilke registre som skal hentes fra KRS separeret med komma. Angives ingen, hentes data for alle registre.

Tilgængelige registre: sorclassifications, eanlocationcode, eanlocationcodeeditype, geolocalisation, sorentity, sorshakmap, editypes, sorreplacedbyentities

-d--destination
Sti til hvor alle genererede filer skal skrives til disken, kan være relativ eller fuld sti. Sættes ingen, bruges nuværende lokation som destination.
-v--verbose
Giver mere information i konsollen undervejs i eksekveringen. Kan specificeres op til to gange, for mest muligt output (samtlige requests/responses printes).

...

Code Block
> java -jar skrsclient.jar -h
Usage: <main class> [-hv] [-q[=<PASSWORD>]]... [-w[=<PASSWORD>]]... [-a=<NAME>]
                    [-b=<CVR>] [-c=<NAME>] [-d=PATH] [-m=<MAXRECORDS>]
                    [-n=<NAME>] [-o=<OFFSET>] [-p=<PATH>] [-s=<URL>] [-u=<URL>]
                    [-r=<REGISTER>[,<REGISTER>...]]...
  -a, --certName=<NAME>      Name the certificate to use is stored under
  -b, --companyCvr=<CVR>     Company CVR number, used when creating an ID card
                               for calling the STS
  -c, --companyName=<NAME>   Company name, used when creating an ID card for
                               calling the STS
  -d, --destination=PATH     Destination to print all generated files to, can
                               be a relative or full path
  -h, --help                 Prints help and exits
  -m, --registerMaxRecords=<MAXRECORDS>
                             Number of entries to fetch in each call to SKRS
                               Default: 1000
  -n, --systemName=<NAME>    System name, used when creating an ID card for
                               calling the STS
  -o, --registerOffset=<OFFSET>
                             Date offset for when to fetch entries from, can be
                               a unix timestamp or a date of format "yyyy-MM-dd
                               [[' ']['T']HH[':'mm[':'ss]]][XXX]"
                               Default: 0
  -p, --vaultPath=<PATH>     Certificate vault to use, must be in JKS format,
                               uses a default Capgemini certificate if none is
                               provided
  -q, --certPassword[=<PASSWORD>]
                             Password to unlock the certificate
  -r, --registers=<REGISTER>[,<REGISTER>...]
                             List of registers separated by comma to pull data
                               from, default is all registers. Available is all registers. Available
                               registers: sorclassifications, eanlocationcode,
                               registers: sorclassificationseanlocationcodeeditype, eanlocationcodegeolocalisation,
                               eanlocationcodeeditypesorentity, sorshakmap, geolocalisationeditypes,
                               sorentity, sorshakmap, editypessorreplacedbyentities
  -s, --stsUrl=<URL>         URL to STS
                               Default: http://test1.ekstern-test.nspop.dk:
                               8080/sts/services/NewSecurityTokenService
  -u, --skrsUrl=<URL>        URL to SKRS
                               Default: http://test1-cnsp.ekstern-test.nspop.dk:
                               8080/stamdata-batch-copy-ws/service/StamdataRepli
                               cation
  -v, --verbose              Enable verbose debugging logging, can be specified
                               multiple times to increase verbosity (up to two
                               times)
  -w, --vaultPassword[=<PASSWORD>]
                             Password to unlock the certificate vault

...

Step 2: Download skrsclient.jar; Nederst på siden eller fra dette link;- ved eventuel fejlmeddelelse, click "Behold"

...

JAR filen for klienten kan hentes her:

View file
nameskrsclient_test1_test2.jar
height250

View file
nameskrsclient_prodtest.jar
height250


Koden til denne kan også findes på Subversion:

...