Systemoppgaver
Slik bruker du systemoppgaver til arbeid appen gjør selv
En systemoppgave er et steg i prosessen som appen kjører selv, uten at brukeren gjør noe. Plattformen har noen innebygde systemoppgaver du bare konfigurerer, og utviklerne dine kan skrive egne.
Innebygde systemoppgaver
Disse systemoppgavene følger med plattformen:
- PDF-generering lager en PDF av det brukeren har fylt ut.
- eFormidling sender data videre til arkivet eller en annen mottaker.
- Fiks Arkiv sender data til arkiv gjennom KS Fiks. Den ligger i en egen pakke som utviklerne legger til i appen.
Du finner hele oversikten over oppgavetyper under 📚 Referanse.
Egne systemoppgaver
Skal tjenesten din gjøre noe plattformen ikke har en innebygd oppgave for, kan utviklerne skrive en egen systemoppgave. Typiske eksempler er å melde saken inn i fagsystemet deres, hente en bekreftelse fra et register eller bestille noe hos en annen virksomhet før prosessen går videre.
Se Lage en egendefinert systemoppgave.
Slik kjører appen en systemoppgave
Plattformen kjører oppgaven på serveren når prosessen kommer til steget, og prosessen går som hovedregel videre av seg selv når oppgaven er ferdig. Tre ting bør du vite:
- Plattformen prøver på nytt. Feiler oppgaven fordi noe utenfor appen er nede, kjører plattformen den på nytt med økende pause mellom forsøkene. Oppgaven må derfor tåle å kjøre flere ganger uten å gjøre samme arbeid to ganger.
- Oppgaven kan vente. Venter oppgaven på svar fra et annet system, holder plattformen prosessen i steget til svaret kommer, enten ved å sjekke på nytt eller ved å ta imot en melding. Brukeren ser at appen venter. Oppgaven har en ventefrist, og plattformen stopper oppgaven når fristen er ute.
- Noen feil stopper prosessen. Gir oppgaven opp, står instansen i steget til noen retter årsaken og starter oppgaven på nytt. Da trenger dere en rutine for å følge opp slike instanser.
Appen har innebygde visninger for alle disse situasjonene: en lastevisning mens oppgaven jobber eller venter, og en feilside når den har gitt opp. Du kan bytte ut tekstene i beskjedene og på feilsiden, og du kan lage en egen side som brukeren ser mens oppgaven kjører. Se Hva brukeren ser mens en systemoppgave kjører.
Nyttige spørsmål til utviklerne:
- Hva skjer hvis oppgaven kjører to ganger — kan brukeren få dobbelt vedtak, dobbel faktura eller dobbel arkivering?
- Hvor lenge venter oppgaven på svar fra andre, og hva skjer når ventetiden er ute?
- Hvem hos oss oppdager og følger opp en instans der oppgaven har gitt opp?
- Lage en egendefinert systemoppgave
Slik lager du en systemoppgave som kjører egen kode i prosessen
- Systemoppgaver med flere steg
Slik deler du en systemoppgave i flere arbeidssteg, og lar den vente på svar utenfra
- Hva brukeren ser mens en systemoppgave kjører
Slik styrer du visningen mens appen jobber, venter eller feiler