Noark 5 Tjenestegrensesnitt aka Noark 5v4 IKA Hordaland 24.04.2017 thomas.sodring@hioa.no 1/18
Kjernen i arkivering Referanse Kontekst Proveniens Struktur Stabilitet Integritet Autentisitet Verdi som bevis 2/18
Ville du stolt på et dokument herfra? [e] 3/18
Arkivet ble digital Men vi glemte kjernen i arkivering, vi glemte det som gir materialet verdi som bevis [d] [f] Vi har dannet rettighetsdokumentasjon i 30 år med forskjellige systemer og vi vet ikke hva vi har eller hva vi ikke har 4/18
Bakgrunn Generell oppdatering av Noark standarden med IT-utviklingen Digitalisering Interoperabilitet Interoperabilitet er den evnen og det potensialet forretningsprosessene med tilhørende IKT-løsninger har til å utveksle data og dele informasjon 5/18
Tjenestegrensesnittet Endelig kom tjenestegrensesnittet til Noark 26.08.2014 01.07.2016 Versjon 1.0 Beta Beta etter høringsrunden (?) Når kommer det ut av beta? Er det mulig å implementere en fungerende frittstående Noark 5 kjerne for fagsystem integrasjon på bakgrunn av dette dokumentet? 6/18
Får dere en ny hverdag? Med Noark 5 komplett, sannsynligvis ikke I teorien blir det enklere å innlemme fagsystem i arkivkjernen Teori og praksis da... Noark 5v4 gjør at det er kanskje noen nye begreper som dere må forholde dere til HTTP-verb og HTTP-statusverdier JSON Hvis du kan trykke på en HTML-lenke kan du forstå hovedprinsippet i tjenestegrensesnittet 7/18
Moderne programvare Moderne tjenesteorientert programvare bruker web teknologi Skalerbarhet Enkelhet 8/18
HTTP-Verber og HTTP-Statuser HTTP-Verber GET PUT POST DELETE PATCH HTTP-Status 200 201 401 403 404 500 9/18
JSON "systemid": "c7d2c5c2-08e6-4e7c-87ab-92c17715b475", "tittel": "Eksempel kommune hovedarkiv", "beskrivelse": "Eksempel kommune sitt arkivsystem...", "arkivstatus": "Opprettet", "opprettetdato": "2017-04-21T07:56:36", "opprettetav": "arkivansvarlig", 10/18
systemid Noark 5 har et felt som heter systemid som kan brukes til å identifisere arkivenheter Arkivkjernen må sørge for at dette er en unik og identifikator på tvers av andre systemer Kan bruke UUID for systemid c7d2c5c2-08e6-4e7c-87ab-92c17715b475 11/18
Konformitetsnivåer Konformitetsnivåer er: Nivå 0 Basiskrav Nivå 1 Arkivstruktur - obligatoriske krav Nivå 1.1 Arkivstruktur - valgfrie krav Nivå 2a Sakarkiv obligatoriske krav Nivå 2.1a Sakarkiv - valgfrie krav 12/18
rotnivå "_links": [ "href": "http://localhost:8092/noark5v4/hateoas-api/arkivstruktur", "rel": "http://rel.kxml.no/noark5/v4/api/arkivstruktur/" "href": "http://localhost:8092/noark5v4/hateoas-api/sakarkiv", "rel": "http://rel.kxml.no/noark5/v4/api/sakarkiv/" "href": "http://localhost:8092/noark5v4/hateoas-api/metadata", "rel": "http://nikita.arkivlab.no/noark5/v4/metadata/" "href": "http://localhost:8092/noark5v4/auth", "rel": "http://nikita.arkivlab.no/noark5/v4/login/rfc7519/" ] GET http://localhost:8092/noark5v4/ 13/18
arkivstruktur "_links": [ "href": "http://localhost:8092/noark5v4/hateoas-api/arkivstruktur/arkiv", "rel": "http://rel.kxml.no/noark5/v4/api/arkivstruktur/arkiv/", "href": "http://localhost:8092/noark5v4/hateoas-api/arkivstruktur/arkivdel", "rel": "http://rel.kxml.no/noark5/v4/api/arkivstruktur/arkivdel/", "href": "http://localhost:8092/noark5v4/hateoas-api/arkivstruktur/arkivskaper", "rel": "http://rel.kxml.no/noark5/v4/api/arkivstruktur/arkivskaper/", "href": "http://localhost:8092/noark5v4/hateoas-api/arkivstruktur/basisregistrering", "rel": "http://rel.kxml.no/noark5/v4/api/arkivstruktur/basisregistrering/", "href": "http://localhost:8092/noark5v4/hateoas-api/arkivstruktur/dokumentbeskrivelse", "rel": "http://rel.kxml.no/noark5/v4/api/arkivstruktur/dokumentbeskrivelse/", "href": "http://localhost:8092/noark5v4/hateoas-api/arkivstruktur/dokumentobjekt", "rel": "http://rel.kxml.no/noark5/v4/api/arkivstruktur/dokumentobjekt/", "href": "http://localhost:8092/noark5v4/hateoas-api/arkivstruktur/klasse", "rel": "http://rel.kxml.no/noark5/v4/api/arkivstruktur/klasse/", "href": "http://localhost:8092/noark5v4/hateoas-api/arkivstruktur/klassifikasjonssystem", "rel": "http://rel.kxml.no/noark5/v4/api/arkivstruktur/klassifikasjonssystem/", "href": "http://localhost:8092/noark5v4/hateoas-api/arkivstruktur/mappe", "rel": "http://rel.kxml.no/noark5/v4/api/arkivstruktur/mappe/", "href": "http://localhost:8092/noark5v4/hateoas-api/arkivstruktur/ny-arkiv", "rel": "http://rel.kxml.no/noark5/v4/api/arkivstruktur/ny-arkiv/", "href": "http://localhost:8092/noark5v4/hateoas-api/arkivstruktur/ny-arkivskaper", "rel": "http://rel.kxml.no/noark5/v4/api/arkivstruktur/ny-arkivskaper/", "href": "http://localhost:8092/noark5v4/hateoas-api/arkivstruktur/registrering", "rel": "http://rel.kxml.no/noark5/v4/api/arkivstruktur/registrering/", ] GET http://localhost:8092/noark5v4/hateoas-api/arkivstruktur 14/18
arkivstruktur/arkiv "results": [ "systemid": "c7d2c5c2-08e6-4e7c-87ab-92c17715b475", "tittel": "Eksempel kommune hovedarkiv", "beskrivelse": "Eksempel kommune sitt arkivsystem...", "arkivstatus": "Opprettet", "opprettetdato": "2017-04-21T07:56:36", "opprettetav": "admin", "_links": [ "href": "http://localhost:8092/noark5v4/hateoas-api/arkivstruktur/arkiv/c7d2c5c2-08e6-4e7c-87ab-92c17715b475/arkivdel/", "rel": "http://rel.kxml.no/noark5/v4/api/arkivstruktur/arkivdel/", "href": "http://localhost:8092/noark5v4/hateoas-api/arkivstruktur/arkiv/c7d2c5c2-08e6-4e7c-87ab-92c17715b475/arkivskaper/", "rel": "http://rel.kxml.no/noark5/v4/api/arkivstruktur/arkivskaper/", "href": "http://localhost:8092/noark5v4/hateoas-api/arkivstruktur/arkiv/c7d2c5c2-08e6-4e7c-87ab-92c17715b475/ny-arkivdel/", "rel": "http://rel.kxml.no/noark5/v4/api/arkivstruktur/ny-arkivdel/", "href": "http://localhost:8092/noark5v4/hateoas-api/arkivstruktur/arkiv/c7d2c5c2-08e6-4e7c-87ab-92c17715b475/ny-arkivskaper/", "rel": "http://rel.kxml.no/noark5/v4/api/arkivstruktur/ny-arkivskaper/", "href": "http://localhost:8092/noark5v4/hateoas-api/arkivstruktur/arkiv/c7d2c5c2-08e6-4e7c-87ab-92c17715b475/ny-underarkiv/", "rel": "http://rel.kxml.no/noark5/v4/api/arkivstruktur/ny-underarkiv/", "href": "http://localhost:8092/noark5v4/hateoas-api/arkivstruktur/arkiv/c7d2c5c2-08e6-4e7c-87ab-92c17715b475/underarkiv/", "rel": "http://rel.kxml.no/noark5/v4/api/arkivstruktur/underarkiv/", "href": "http://localhost:8092/noark5v4/hateoas-api/metadata/arkivstatus/", "rel": "http://rel.kxml.no/noark5/v4/api/metadata/arkivstatus/", "href": "http://localhost:8092/noark5v4/hateoas-api/metadata/dokumentmedium", "rel": "http://rel.kxml.no/noark5/v4/api/metadata/dokumentmedium/", "href": "http://localhost:8092/noark5v4/hateoas-api/arkivstruktur/arkiv/c7d2c5c2-08e6-4e7c-87ab-92c17715b475/", "rel": "self", ] ], "_links": [ "href": "http://localhost:8092/noark5v4/hateoas-api/arkivstruktur/arkiv", "rel": "self", ] GET http://localhost:8092/noark5v4/hateoas-api/arkivstruktur/arkiv 15/18
Opprett arkiv "tittel": "Eksempel kommune hovedarkiv", "beskrivelse": "Eksempel kommune sitt arkivsystem...", "dokumentmedium": "Elektronisk arkiv" POST http://localhost:8092/noark5v4/hateoas-api/arkivstruktur/arkiv "systemid": "c7d2c5c2-08e6-4e7c-87ab-92c17715b475", "tittel": "Eksempel kommune hovedarkiv", "beskrivelse": "Eksempel kommune sitt arkivsystem...", "arkivstatus": "Opprettet", "opprettetdato": "2017-04-21T07:56:36", "opprettetav": "admin", "_links": [ "href": "http://localhost:8092/noark5v4/hateoas-api/arkivstruktur/arkiv/c7d2c5c2-08e6-4e7c-87ab-92c17715b475/arkivdel/ ", "rel": "http://rel.kxml.no/noark5/v4/api/arkivstruktur/arkivdel/",... alle lenker... 16/18
Slik standarden foreligger i dag... Skrevet fra et Noark 5 komplett perspektiv, ikke frittstående kjerne for fagsystem integrasjon Fare for at vi får evry-noark5v4, tieto-noark5v4 osv og uheldig leverandørinnlåsing Fare for store datakvalitetsproblemer med tilhørende dyre utrekksprosesser Uferdig, underspesifisert, feil og mangler, misvisende Handler mer om utvidbarhet enn interoperabilitet 17/18
Vite mer... nikita-noark5-kjerne https://github.com/hioa-abi/nikita-noark5-co re Fri programvare Noark 5v4 kjerne Mangelmeldinger Noark 5v4 https://github.com/petterreinholdtsen/noark5 -tester/tree/master/mangelmelding 18/18