Min Kommune Oppgaver er en løsning laget for målrettet tildeling av oppgaver til enkeltinnbyggere, via KS Min kommune. Løsningen består av et web-grensesnitt i Min Kommune brukt av innbyggere til å vise og håndtere oppgavene, ett api for eksterne fag-system til bruk for å opprette og endre oppgaver, samt en konfigurasjons-side i vår forvaltnings-løsning under min kommune.
| Grensesnitt | Støtte |
|---|---|
| Web portal | Ja |
| Maskin til maskin | Ja |
En oppgave fungerer som en referanse, og kan omfatte flere forskjellige typer av offentlige oppgaver. Det kan være et skjema som skal fylles ut, et samtykke som skal tas stilling til, en kontrakt som må vises og bekreftes osv. En oppgave som lagres hos oss inneholder en url med referansen til den eksterne ressursen. Flere innbyggere kan dele samme oppgave. Oppgaven er da lik for alle, med unntak av individuell status om utførelse.
OppgaveStatus forteller i første iterasjon om en person har fullført oppgaven eller ikke. Flere statuser kan kommer ved behov. En overordnet status for oppgaven kan også komme ved behov:
UtførtKriterie forteller om hvilket kriterie som gjelder for at oppgaven som helhet skal anses som utført, og har i dag følgende verdier:
En oppgave opprettes via API. I denne requesten sendes innhold i oppgaven, som tittel, beskrivelse, handling, url, eventuell frist, utført-kriterie, samt komplett liste over mottakere og informasjon om varsling. Det kan også sendes med metadata, som ikke brukes av KS Min kommune, men som kan brukes til å f.eks. lagre eksterne ID-er som oppgaven er knyttet til.
I første iterasjon er dette endepunktet brukt for å oppdatere status fra “NY” til “FULLFORT” for en mottaker av oppgaven.
En oppgave kan hentes via dette endepunktet. Dette returnerer informasjon om oppgaven, inkludert liste over mottakere og deres individuelle status.
https://api.fiks.dev.ks.no/min-kommune/api/v1/api/https://api.fiks.test.ks.no/min-kommune/api/v1/api/https://api.fiks.ks.no/min-kommune/api/v1/api/