...

Beskrivelse

Support ansvarlig: TriforkKvalitets-IT
NSP: Stamdatamodul (SDM)

Adgangen er begrænset af den aftale der indgås med NSP-operatøren; servicen er underlagt whitelistningbegrænsning. Denne whitelistning er baseret på CVR-nummeret, der er indeholdt i anvendte ID-kort kombineret med et registernavn, datatypenavn og version.
Servicen udstiller stamdata registre via en mapping af kolonner og understøtter flere versioner og historiske data. Mulige stamdata registre er beskrevet her: Stamdataregistre og tilhørende datatyper

...

Anvendelse af Stamdata Kopi Register Service (SKRS): SDM - Guide til anvendere

Arkitekturbeskrivelser af stamdata importere:  Stamdata

...

Relaterede registre og services:

Applikationsbeskrivelse

^^Tilbage til toppen^^

Stamdata KopiRegister Service (SKRS) er en identitetsbaseret DGWS webservice udstillet på NSP-platformen, som giver adgang til relevante nationale stamdataregistre opsamlet af NSP fra forskellige myndigheder og dataansvarlige enheder.
Kopiregisterservicen giver dels mulighed for etableringsudtræk, hvor det komplette register leveres, dels såkaldte ”delta-opdateringer”, hvor ændringer i registret siden sidste udtræk leveres. De to typer udtræk er varianter af samme kald, hvor et etableringsudtræk leverer summen af samtlige ændringer i det pågældende registers levetid, og hvor et deltaudtræk leverer summen af ændringer siden sidste kald.

Support ansvarlig: TriforkKvalitetsIT
NSP: Stamdatamodul (SDM)

Stamdata Kopi Register Service (SKRS) giver mulighed for at hente komplette kopier af stamdata-registre. Dette giver anvendere mulighed for at ajourføre en lokal kopi af et stamdata-register.
Adgangen er begrænset af den aftale der indgås med NSP-operatøren; servicen er underlagt whitelistningbegrænsning. Denne whitelistning er baseret på CVR-nummeret, der er indeholdt i anvendte ID-kort kombineret med et registernavn, datatypenavn og version.
Servicen udstiller stamdata registre via en mapping af kolonner og understøtter flere versioner og historiske data. Mulige stamdata registre er beskrevet her: Stamdataregistre og tilhørende datatyper

...

Operation replicate
---------------------
Denne operation bruges til at sende replikerings-requestet til SKRS. Svaret er SOAP, hvori der findes et ATOM-feed, som har det reelle indhold, der ønskes kopieret. De til enhver tid mulige felter i det reelle indhold er defineret ved en række XML-skemaer. Der kan angives en række værdier til parametre i requestet:
- register -- Registernavnet der ønskes udtræk fra, som bekrevet på tidligere nævnte oversigt.
- datatype --Datatypen som bekrevet på tidligere nævnte oversigt.
- version -- Af hensyn til bagudkompabilitet versioneres udtræksfunktionaliteten for hvert enkelt register. Seneste tilgængelige version er bekrevet på tidligere nævnte oversigt.
- offset -- En parameter, der angiver hvorfra i servicens udtræk af ændrede data svaret skal påbegyndes. Fra begyndelsen angives med '0' (nul). I hvert svar fra SKRS findes et revisionsnummer på en entitet, eksempelvis <atom:id>tag:nsi.dk,2011:cpr/person/v1/13667186340000000001</atom:id>, hvor sidste del, navnlig 13667186340000000001 angiver hvilket offset entiteten har. Denne værdi kan bruges som offset ifbm. paginering.
- maxRecords -- Bruges til at begrænse antallet af entitieter, som returneres i hvert svar. Der eksisterer en øvre grænse defineret af servicen, som ikke kan overstyres af anvendere.

Datastruktur, Intern register: SKRS whitelist

^^Tilbage til toppen^^

Register properties:

Stamdata Kopi Register Service registeret understøtter SKRS servicen.
database: stamdata

...

Entitetsbeskrivelser

Client

^^Tilbage til toppen^^

Objektet indeholder de brugere (cvr) som er whitelisted som bruger af SKRS servicen

Objektet indeholder informationen:
---------------------------------------
id -- PRIMARY KEY
name -- Firmanavn
subjectSerialNumber -- CVR:12345678-UID:1234
comment -- Her anføres NSP Jira nummer som relaterer den enkelte whitelisting

Client_permissions

^^Tilbage til toppen^^

Whitelisting for hver bruger (cvr) til at udhente de forskellige registre, tabeller og versioner

Objektet indeholder informationen:
---------------------------------------
id -- PRIMARY KEY
client_id -- reference til Client tabellen
permissions -- tilladelse angives for hver "register/tabel/version"
comment -- Her anføres NSP Jira nummer som relaterer den enkelte whitelisting

SKRSViewMapping

^^Tilbage til toppen^^

Når man forespørger SKRS medsender man altid en viewpath som indeholder register, datatype og version og SKRS kan derefter kigge i SKRSViewMapping om den har beskrivelse af registeret.
Dynamisk SKRS som implementeret herigennem (samt SKRSColumns) giver mulighed for at release en importer uafhængigt af kopi register servicen, dette er en stor gevinst i forhold til tiden det tager fra man sætter en importer i produktion til man kan hente data igennem kopi register servicen. Derudover er importeren nu det eneste sted man skal kigge når man leder efter en fejl og eneste sted det skal rettes.

Objektet indeholder informationen:
---------------------------------------
`idSKRSViewMapping` -- primary key
`register` -- stamdata registernavn
`datatype` -- datatype tabelnavn
`version` -- version af registered (v1, v2, ..)
`tableName` -- tabelnavn med foranstillet registernavn
`createdDate` --

SKRSColumns

^^Tilbage til toppen^^

Dette objekt indeholder en beskrivelse af hver enkel tabel kolonne i et bestemt view

...

whitelist_config (SAES+SCES+SYES)

^^Tilbage til toppen^^

Objektet indeholder de CVR som er whitelisted til SAES (Autorisation), SCES (CPR) og SYES (Yderregister) enkeltopslag servicene
(Bemærk: Whitelisting af SKRS (stamdata kopi register service) foretages i stamdata.client og stamdata.client_permissions)
Database: stamdata

Objektet indeholder informationen:
---------------------------------------
component_name -- angiver om registerdata for denne cvr skal samtykke bekyttes eller ej
-- SDM : enkeltopslag servicen
-- SDMwithConsent -- enkeltopslag servicen, samtykkebeskyttet
cvr -- CVR nummer
comment -- Her anføres NSP Jira nummer som relaterer den enkelte whitelisting

db_migrations

^^Tilbage til toppen^^

Fælles styring af skema-versioner, som alle importerer benytter til at holde styr på hvilke scripts der er afviklet, så hvert script kun afvikles én gang.

...

Tabelbeskrivelser

Tabel: Client

^^Tilbage til toppen^^

-- ADMINISTRATION TABLES (USERS ETC.)

...

Tabel: Client_permissions

^^Tilbage til toppen^^

-- ADMINISTRATION TABLES (USERS ETC.)

CREATE TABLE Client_permissions (
id BIGINT NOT NULL AUTO_INCREMENT PRIMARY KEY,
client_id BIGINT NOT NULL,
permissions TEXT NOT NULL,
comment VARCHAR(100) NULL,
FOREIGN KEY (client_id) REFERENCES Client(id) ON DELETE CASCADE
) ENGINE=InnoDB COLLATE=utf8_bin;

Tabel: SKRSViewMapping

^^Tilbage til toppen^^

CREATE TABLE IF NOT EXISTS `SKRSViewMapping` (
`idSKRSViewMapping` BIGINT(15) NOT NULL AUTO_INCREMENT ,
`register` VARCHAR(255) NOT NULL ,
`datatype` VARCHAR(255) NOT NULL ,
`version` INT NOT NULL ,
`tableName` VARCHAR(255) NOT NULL ,
`createdDate` TIMESTAMP NOT NULL ,
PRIMARY KEY (`idSKRSViewMapping`) ,
INDEX `idx` (`register` ASC, `datatype` ASC, `version` ASC) ,
UNIQUE INDEX `unique` (`register` ASC, `datatype` ASC, `version` ASC) )
ENGINE = InnoDB;

Tabel: SKRSColumns

^^Tilbage til toppen^^

CREATE TABLE IF NOT EXISTS `SKRSColumns` (
`idSKRSColumns` BIGINT(15) NOT NULL AUTO_INCREMENT ,
`viewMap` BIGINT(15) NOT NULL ,
`isPID` TINYINT NOT NULL ,
`tableColumnName` VARCHAR(255) NOT NULL ,
`feedColumnName` VARCHAR(255) NULL ,
`feedPosition` INT NOT NULL ,
`dataType` INT NOT NULL ,
`maxLength` INT NULL ,
PRIMARY KEY (`idSKRSColumns`) ,
INDEX `viewMap_idx` (`viewMap` ASC) ,
UNIQUE INDEX `viewColumn` (`tableColumnName` ASC, `viewMap` ASC) ,
CONSTRAINT `viewMap`
FOREIGN KEY (`viewMap` )
REFERENCES `SKRSViewMapping` (`idSKRSViewMapping` )
ON DELETE CASCADE
ON UPDATE NO ACTION)
ENGINE = InnoDB;

Tabel: whitelist_config (kun til brug for SAES+SCES+SYES)

^^Tilbage til toppen^^

CREATE TABLE whitelist_config (
component_name VARCHAR(50) NOT NULL,
cvr CHAR(8) NOT NULL,
comment VARCHAR(100) NULL,
PRIMARY KEY (component_name, cvr)
) ENGINE=InnoDB COLLATE=utf8_bin;

Tabel: db_migrations

^^Tilbage til toppen^^

CREATE TABLE `db_migrations` (
`version` varchar(20) NOT NULL,
`description` varchar(100) DEFAULT NULL,
`installed_by` varchar(30) NOT NULL,
`installed_on` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
PRIMARY KEY (`version`),
UNIQUE KEY `version` (`version`)
) ENGINE=InnoDB DEFAULT CHARSET=latin1

Teknologibeskrivelse

^^Tilbage til toppen^^

Refereres fra

^^Tilbage til toppen^^