Skip to content
This repository has been archived by the owner on May 8, 2019. It is now read-only.

e-gov/DVK

Repository files navigation

Riigi Infosüsteemi Amet Euroopa Regionaalarengu Fond

Dokumendivahetuskeskuse (DVK) tarkvara

DVK tarkvara koosneb klienditarkvarast ja serveritarkvarast. Samuti on olemas DVK API, mille abil saab liidestada DVK klienditarkvara kolmandate infosüsteemidega.

Repositooriumis on DVK tarkvaral viis erinevat alamprojekti:

  1. DVK-CORE - DVK tarkvara tuumikmeetodid ja parameetrifailid.
  2. DVK-CLIENT - DVK universaalkliendi tarkvara. Sõltub DVK-CORE projektist.
  3. DVK-SERVER - DVK serveri tarkvara. Sõltub DVK-CORE ja DVK-CLIENT projektist.
  4. DVK-API - DVK API tarkvara. DVK universaalkliendi ja kolmandate infosüsteemide liidestamiseks mõeldud teek.
  5. DOC - DVK tarkvara dokumentatsioon ning vastuvõtja staatuse id-d.
  6. INSTALLERS - DVK universaalkliendi installatsioonipaketid
  7. PORTAAL - Prototüüp DVK keskkonnast eesti.ee portaalis.

DVK teenused ning päringute näited leiab DVK spetsifikatsioonist

##Teadmiseks

DVK on tsentraalse dokumentide edastamise lahendusena saadaval veel 2 aastat, mille järel edastatakse dokumente hajusalt üle DHX protokolli. Üleminek hajusale dokumentide edastamisele algab 2017. aasta aprillist. DHX protokolli väljatöötamise vahetulemused ja taustamaterjalid asuvad aadressil https://github.com/e-gov/DHX.

Kapsel 1.0 -> 2.1 üleminejatele

Kapsel 2.1 üleminejatele on kõige olulisem info leitav siit: https://riha.eesti.ee/riha/main/xml/elektroonilise_andmevahetuse_metaandmete_loend/1

X-tee versioon 6-le üleminek DVK kontekstis

DVK kasutaja jaoks kõige olulisem muudatuse seoses X-tee versioon 6-le üleminekul on muudatused X-tee sõnumiprotokollis (versioon 4.0). See tähendab, et DVK teenuste poole pöördumisel on vajalik seda teha senisest erinevate X-tee sõnumipäistega.

DVK universaalklient saab uue versiooni ja hakkab toetama uut sõnumiprotokolli 2017 aasta algul. Juhul kui DVK teenuseid kasutav tarkvara ei kasuta DVK UK liidest, tuleb sõnumiprotokolli 4.0 tugi juurde arendada. Infot uue sõnumiprotokollile ülemineku kohta leiab vastavast peatükist DVK spetsifikatsioonist

Alamsüsteemide kasutamise loogika DVK-s

Kui asutus on DVK-ga liitunud mitme süsteemiga (näiteks eraldi struktuuriüksused, millele oleks võimalik otse dokumente adresseerida), siis on vaja v4.0 sõnumiprotokolli kasutades DVK keskserveris täpsustada alamsüsteemi (subsystemCode) ning registrikoodi (memberCode) väärtused.

Varasemalt on selliste süsteemide puhul rakendatud nn X-tee 'alamsertifikaati', kus registrikoodi väärtusena kasutati 'alamsüsteem.registrikood' väärtust. X-tee uues versioonis aga saab registrikood (memberCode) sisaldada vaid päris registrikoodi väärtust ning struktuuriüksuse või infosüsteemi nimi tuleb defineerida alamsüsteemi (subsystemCode) väljal. Uuele sõnumiprotokollile üleminemisel soovitame alamsüsteemi nimeks valida see just see sama väärtus, mis varasemalt alamsertifikaadi puhul kasutati.

Näiteks:

  • Viru Ringkonnaprokuratuur
<xrd:client id:objectType="SUBSYSTEM">
            <id:xRoadInstance>EE</id:xRoadInstance>
            <id:memberClass>GOV</id:memberClass>
            <id:memberCode>70000906</id:memberCode>
            <id:subsystemCode>viru.70000906</id:subsystemCode>
</xrd:client>
  • Ametlike dokumentide infrastruktuuri teenus (ADIT)
<xrd:client id:objectType="SUBSYSTEM">
            <id:xRoadInstance>EE</id:xRoadInstance>
            <id:memberClass>GOV</id:memberClass>
            <id:memberCode>70006317</id:memberCode>
            <id:subsystemCode>adit</id:subsystemCode>
</xrd:client>

Uuele sõnumiprotokollile üleminekul tuleb selliste süsteemide puhul anda teada RIA kasutajatoele (help@ria.ee), millise registrikoodi ja alamsüsteemiga päringuid soovitakse saata, ning eelnevalt testida testkeskkonnas, et kindlustada sujuvam üleminek.

Asutused, kes on varasemalt DVK-ga liidestunud ühe süsteemina (kasutanud selleks ühte asutuse X-tee sertifikaati) ning soovivad ka nii jätkata, ei pea uuele sõnumiprotokollile üleminemisel eraldi RIA kasutajatuge teavitama ning alamsüsteemi nimeks võib valida endale sobiva nimetuse, näiteks 'dok-haldus'.

DVK küsimuste puhul abistab Riigi Infosüsteemi Ameti kasutajatugi help@ria.ee