API katalog: tilbakemeldinger fra Skate

API katalog: tilbakemeldinger fra Skate fra skriftlig høring-/forankringsrunde for sluttbehandling av «Felles API oversikt» Claire Czternasty Hembre, prosjektleder Arena for Informasjonsforvaltning, Difi, 6.2.2019

Oppdrag fra SKATE: Felles datakatalog igangsatt av SKATE 13. juni. 2016 Felles Hvor API-katalog er igangsatt vi nå? av SKATE 13. juni 2018 Begge tiltak støttet av Medfinansieringsordningen Revidert statsbudsjett 2018: Utvidelse av Felles datakatalog til å omfatte API-er (grensesnitt som kan aktiviseres fra annen programvare). Hvor er vi nå? Levert 3 av 4 funksjonelle leveranser for API-katalog I tillegg, etter re-planlegging (SG 9.11), én leveranse på Begreper og én på Informasjonsmodeller Siste leveranse: 22. februar Én funksjonell leveranse Veilederen

Sluttbehandling i Skate Onsdag 5.12.18 Mandag 10.12.18 Onsdag 19.12.18 Onsdag 19.12.18 Torsdag 20.12.18 Fredag 25.1.19 Mandag 4.2.19 Onsdag 13.2.19 AU-møte Mandag 25.02.19 Mandag 11.03.19 Onsdag 13.3.19 Utkast til hørings- /forankringsnotat sendes Skatesekretariatet for kvalitetssikring Presentasjon til AUmøtet 19.12 sendes innledende AU-møte Skatesekretariatet orientering Dette skal være en innledende orientering til AU før skriftlig høring- /forankringsrunde Endelig hørings- /forankringsnotat sendes Skatesekretariatet med eventuelle vedlegg eller lenker til sluttresultat Utsending fra Skatesekretariatet av det som skal på hørings- /forankringsrunde Høringsfrist for Skatevirksomhetene. (Skatesekretariatets forslag) Send Skatesekretariatet utkast til saksframlegg og presentasjon til sluttbehandling i neste Skate-møte samt oppsummering til AU fra hørings- /forankringsrunden Forbehandling av Skate-saken og orientering til AU om hørings- /forankringsrunden Endelig saksframlegg for Skate sendes til Skatesekretariatet Endelig presentasjon for Skate-møtet sendes til Skatesekretariatet Sluttbehandling av saken i Skate

Sluttbehandling i Skate Felles API-oversikt API katalogen går over i forvaltning 1.3. Onsdag 19.12.18 AU-møte Fredag 25.1.19 Onsdag 13.2.19 AU-møte Onsdag 13.3.19 Skate møte Innledende orientering til AU før skriftlig høring- /forankringsrunde Høringsfrist for Skatevirksomhetene. Forbehandling av Skate-saken og orientering til AU om hørings- /forankringsrunden Sluttbehandling av saken i Skate

API katalog: høringsforankringsrunde i forbindelse med sluttbehandling i Skate SPØRSMÅLENE Gevinstrealisering: innhold og kvalitet for Felles datakatalog (inkludert API-katalog) 1. Hvordan skal det sikres kontinuerlig arbeid i offentlige virksomheter for å bidra til innhold og kvalitet i Felles datakatalog, herunder også API katalog, og gi den nytteverdi? Brukergrupper API-katalog 2. Hvilke roller i virksomheten (eks. virksomhetsarkitekter, løsningsarkitekter, utviklere, fagpersoner) anser dere som mest aktuelle brukere av henholdsvis registrerings- og søkeløsningen, og hvor godt mener dere løsningene er tilpasset disse brukergruppene? Videreutviklingsplaner 2019 3. Hvilke kommentarer har dere om videreutviklingsplanene for 2019, og hvilke andre forslag til vesentlige endringer som bør prioriteres høyt har dere?

API Begrep Informasjonsmodeller Datasett Prioriteringer H1 2019 September 2018 Oktober 2018 MVP søketjeneste API MVP Høstings- og registreringstjeneste API Etablere støtte for Begrepsstandarder November 2018 Desember 2018 Høstings- og registreringstjeneste Januar 2019 Februar 2019 Ferdig søketjeneste Registrering av interne datasett Mars 2019 April 2019 Oppslag på standardiserte API-er Nasjonalt tilgangspunkt for transportdata Mai 2019 Begrepsregistrering Juni 2019 Informasjonsmodell MVP

Tilbakemeldinger Hvem har svart? Difi Kartverket NAV Arkivverket Skatteetaten Direktoratet fra e-helse KS UNIT Arbeid i egen virksomhet BR som forvalter Difi premissgiver og pådriver Innhold og kvalitet i Felles datakatalog BR som videreutvikler BR som pådriver

Engasjement! 8 svar, grundige og gjennomtenkte. Mange positive innspill. «NAV er i prosess med å plassere arbeidet med Felles datakatalog (FDK) inn i NAV sitt målbilde for informasjonsforvaltning» «Vi ser fram til å bruke API-katalogen, og Unit ønsker dialog om utnyttelse av sektorløsninger inn mot API-katalogen og felles datakatalog.» (Unit) «Datasett-katalogen nærmer seg et modent nivå der løsningen er godt tilpasset brukerne. ( ) (SKD) «Planen for Videreutvikling virker bra.» (SKD) «Begrepsregistering ( ) vil være nyttig for bedre nøkling og gjenfinning av data» (Unit) «Kunnskapssektoren vil sikre kontinuerlig arbeid med kvalitet og innhold i Felles datakatalog, inkludert API-katalog» (Unit) «Det er nyttig med gode oversikter hva som er tilgjengelig hvor. Hvis offentlig sektor gjør tilgjengelig så mange API-er som vi ønsker, så ville det blitt veldig kaotisk og uoversiktlig uten en API katalog.» (Unit) «Fordelen med den nasjonale API katalogen må være å få en helhetsoversikt på tvers av [andre API kataloger]» (Unit) «Vi anser API-oversikten så langt som viktig for å oppnå godt samspill mellom flere løsninger.» (Difi) «Difi og Brønnøysundregistrene er viktige bidragsytere for å tilrettelegge for et helhetlig arbeid» (NAV)

Innspill til Brønnøysundregistrene som utvikler av løsningen Behandlingsoversikt (NAV) Rapporter som virksomhetene kan bruke for å følge opp vedlikehold av informasjon om sine datasett/api'er (e-helse) Metadata til administratorer for vedlikeholdet av sine datasett/api'er (e-helse) Utvidelse av informasjon om API-katalog knyttet til klientregistrering og autorisasjon (Unit) Høste API-er på andre formater enn openapi (e-helse) Registrering av interne datasett og API (SKD) Arbeidet med informasjonsmodeller. (SKD, e-helse, KS) Det bør på plass en egen aktivitet knyttet til kodeverk. (e-helse) Legge inn strukturerte data i selve nettsidene (Unit) Registreringsløsningen må være enkel i bruk og bør ikke ha for mange obligatoriske felt. (e-helse)

Innspill til Brønnøysundregistrene (forts.) Som forvalter av løsningen (utover videreutvikling) Tydeliggjøre hvilke krav som gjelder for innhold og registrering i løsningen (Kartverket) Etablere rutiner for innholdsoppdatering. Alle API som etableres for deling mot eksterne parter for eksempel bør automatisk registreres i APIkatalogen med tilhørende datasett-beskrivelse når de publiseres. (SKD) Tydelig teknisk dokumentasjon og veiledning om hvordan man kommer i gang (Arkivverket) «Når det gjelder andre områder å utvikle FDK på, ser vi at det å katalogisere hvem som har ansvaret for hvilke funksjoner, kunne vært nyttig å for de som skal bygge løsninger.» (NAV) Åpent og transparent produktkø (NAV) Lifecycle management (NAV) Som pådriver (se også Difi) Det bør jobbes med opplæring og med å vise fordeler med deling av data, med særlig fokus på gevinstrealisering (Arkivverket) Det bør beskrives suksesshistorier som viser hvordan deling av data gir besparelser med eksempler både fra Norge og fra andre land (Arkivverket) KS poengterer noe utydelighet (eierskap, samordning og koordinering Difi/BR)

Innspill om Difi sin rolle Etablering av «beste praksis» (NAV) Prioritere arbeidet med veilederen for orden i eget hus for API-er (Kartverket) Det som spesielt kan ha en stor verdi, er å bygge videre på det eksisterende nettverket for informasjonsforvaltning (NAV) Etablere policy for registrering av API'er og datasett (e-helse) Verdien i API-katalogen ligger i å knytte sammen tilbydere og konsumenter av data og API-er. Man må nok jobbe aktivt for å få registrert API-er frem til man når kritisk masse, slik at API katalogen blir det naturlige stedet for å lete etter datakilder / API-er. (Unit) Det bør jobbes med opplæring og med å vise fordeler med deling av data, med særlig fokus på gevinstrealisering (Arkivverket) Det bør beskrives suksesshistorier som viser hvordan deling av data gir besparelser med eksempler både fra Norge og fra andre land (Arkivverket) «Skape tro på at dette konseptet gir merverdi i lengden, både eksternt for Norge og internt for den enkelte virksomheten og hos den enkelte bruker av katalogen. ( ) Modenhet, holdninger og forankring i alle ledd» (NAV) KS poengterer noe utydelighet (eierskap, samordning og koordinering Difi/BR)

Innspill om arbeid i egen virksomhet Vurder å sette av dedikerte ressurser til arbeid med initiell registrering, eventuelt organiser det initielle arbeidet som et prosjekt. (e-helse) Den enkelte eier (virksomhet) må sikre at katalogen holdes oppdatert. Virksomheten kan vurdere å opprette en rolle som koordinator for å følge opp vedlikehold. (e-helse) Ansvarliggjør ressurser for vedlikehold. Lag rutiner for å sikre at ansvar for vedlikehold overføres til andre ved omorganiseringer eller når ressurser slutter. (e-helse) Virksomheter bør etablere løsninger for API-management for å gjøre vedlikeholdet enklere. (e-helse) «Viktig med tydelig forankring på riktig nivå i ledelsen og i virksomheten for øvrig.» (NAV) Modenhetskartlegging og gjennomføring av orden i eget hus (Kartverket) «Felles datakatalog må forankres tydelig i organisasjonen, det må etableres føringer for at datasett skal legges inn og det må etableres enn ressursgruppe som kan bistå med innlegging og forvaltning. Disse må ha tett dialog med fagpersoner om oversikter og innhold i datasett.» (SKD) «Dersom felles datakatalog og felles API-katalog skal framstå som attraktiv og nyttig for brukergruppene, så må det være et tilstrekkelig stort antall av datakilder som oppfattes som nyttige i katalogen. Det innebærer at de enkelte virksomhetene må ha vilje og tid til å tilrettelegge sine data for deling, med vekt på datakilder som brukergruppene deres oppfatter som viktige.» (Unit) Legg inn et punkt i sjekklisten ved avslutning av prosjekter for å huske vurdering av om prosjektet har datasett/api'er som bør registreres nasjonalt (eller om det er behov for vedlikehold). (e-helse)

Konklusjon Tiltaket Felles API oversikt er gjennomført og en del av Felles datakatalog, som også tilbyr en felles oversikt over datasett, begrep, og informasjonsmodeller, og på denne måten muliggjør deling og gjenbruk av data og informasjon mellom offentlige virksomheter. Men for å realisere ambisjonsnivå 3 og målsettingen om "kun én gang" forutsetter det at lederne av de aktuelle etatene sørger for at det innarbeides rutiner med å fylle katalogene med innhold og sikre at den vedlikeholdes som en del av virksomhetenes rutiner og daglig arbeid.

Informasjonsmodeller Datasett Prioriteringer H1 2019 oppdatert pr 31.1.2019 Februar Mars April Mai Juni Juli August September Oktober November Desember API Begrep Ferdig søketjeneste (API) Oppslag på standardisert e API-er Felles tilgangsstyring + LOS Begrepsregistrering Nasjonalt tilgangspunkt for transportdata Registrering av interne datasett Behandlingsaktiviteter