Noark 5 Tjenestegrensesnitt. aka Noark 5v4

Transkript

1 Noark 5 Tjenestegrensesnitt aka Noark 5v4 IKA Hordaland thomas.sodring@hioa.no 1/18

2 Kjernen i arkivering Referanse Kontekst Proveniens Struktur Stabilitet Integritet Autentisitet Verdi som bevis 2/18

3 Ville du stolt på et dokument herfra? [e] 3/18

4 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

5 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

6 Tjenestegrensesnittet Endelig kom tjenestegrensesnittet til Noark 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

7 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

8 Moderne programvare Moderne tjenesteorientert programvare bruker web teknologi Skalerbarhet Enkelhet 8/18

9 HTTP-Verber og HTTP-Statuser HTTP-Verber GET PUT POST DELETE PATCH HTTP-Status /18

10 JSON "systemid": "c7d2c5c2-08e6-4e7c-87ab-92c17715b475", "tittel": "Eksempel kommune hovedarkiv", "beskrivelse": "Eksempel kommune sitt arkivsystem...", "arkivstatus": "Opprettet", "opprettetdato": " T07:56:36", "opprettetav": "arkivansvarlig", 10/18

11 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

12 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

13 rotnivå "_links": [ "href": " "rel": " "href": " "rel": " "href": " "rel": " "href": " "rel": " ] GET 13/18

14 arkivstruktur "_links": [ "href": " "rel": " "href": " "rel": " "href": " "rel": " "href": " "rel": " "href": " "rel": " "href": " "rel": " "href": " "rel": " "href": " "rel": " "href": " "rel": " "href": " "rel": " "href": " "rel": " "href": " "rel": " ] GET 14/18

15 arkivstruktur/arkiv "results": [ "systemid": "c7d2c5c2-08e6-4e7c-87ab-92c17715b475", "tittel": "Eksempel kommune hovedarkiv", "beskrivelse": "Eksempel kommune sitt arkivsystem...", "arkivstatus": "Opprettet", "opprettetdato": " T07:56:36", "opprettetav": "admin", "_links": [ "href": " "rel": " "href": " "rel": " "href": " "rel": " "href": " "rel": " "href": " "rel": " "href": " "rel": " "href": " "rel": " "href": " "rel": " "href": " "rel": "self", ] ], "_links": [ "href": " "rel": "self", ] GET 15/18

16 Opprett arkiv "tittel": "Eksempel kommune hovedarkiv", "beskrivelse": "Eksempel kommune sitt arkivsystem...", "dokumentmedium": "Elektronisk arkiv" POST "systemid": "c7d2c5c2-08e6-4e7c-87ab-92c17715b475", "tittel": "Eksempel kommune hovedarkiv", "beskrivelse": "Eksempel kommune sitt arkivsystem...", "arkivstatus": "Opprettet", "opprettetdato": " T07:56:36", "opprettetav": "admin", "_links": [ "href": " ", "rel": " alle lenker... 16/18

17 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

18 Vite mer... nikita-noark5-kjerne re Fri programvare Noark 5v4 kjerne Mangelmeldinger Noark 5v4 -tester/tree/master/mangelmelding 18/18