AP221 Use Case SBL Benytt meldingstjeneste
Benytt meldingstjeneste.dc Benytt meldingstjeneste Meldinger kan sendes fra tjenesteeiere til brukere spesifisert av tjenesteeier. Dette Use Case beskriver et scenari hvr en bruker allerede har mttatt g åpnet en frsendelse/melding. Use Case beskriver handlingene en bruker kan freta seg inne i en mttatt frsendelse, sm fr eksempel å bekrefte at meldingen er mttatt eller å se på et vedlegg. Autentiser g autriser bruker Altinn Registrer mttatt frsendelse sm åpnet Vis mttatt frsendelse Prtalbruker Velg funksjn Bekreft-valg tilgjengelig? Bekreft mttatt Skriv ut mttatt frsendelse Åpne vedlegg Velg svarlenke Lukk mttatt frsendelse Slett Altinn Lagre bekreftelse Vis ppdatert mttatt frsendelse Vis vedlegg Figur 1 Benytt meldingstjeneste - Prtalbruker 2
Benytt meldingstjeneste.dc Benytt meldingstjeneste - Prtalbruker Aktør(er) Trigger: Pre-betingelser Pst-betingelser Nrmal utføring Prtalbruker(Figur 1 Benytt meldingstjeneste - Prtalbruker) Prtalbruker Etatsbruker (Se alternativ utføring fr denne brukeren) Prtalbruker klikker på en melding i listen ver meldinger, g åpner dermed denne meldingen (se eget Use Case fr Finn Mttatt ). Prtalbruker benytter en dyplenke fr å kmme rett til en mttatt frsendelse (Se eget Use Case fr Benytt dyplenke ). Etatsbruker klikker på en mttatt frsendelse i servicearkiv Tjenesteeier har registrert en melding sm prtalbruker kan åpne. (Se eget Use Case fr Registrer melding ) Prtalbruker har sett meldingen, g utført ønskede handlinger Den mttatte frsendelsen er registrert åpnet hvis den er åpnet av prtalbruker (registreres ikke sm åpnet hvis den er åpnet av etatsbruker) 1. Registrer mttatt frsendelse sm åpnet Lagrer infrmasjn m at den mttatte frsendelsen er åpnet. Dette må ikke frveksles med at frsendelsen er bekreftet mttatt. 2. Vis mttatt frsendelse innehlder følgende infrmasjn: Overskrift Meldingstekst Meldingsteksten kan frmateres med HTML, eller bare innehlde ren tekst. Referanse til et skjema i arkiv Valgfritt Lenke til å pprette en ny innsendingstjeneste Valgfritt Lenke til en lenketjeneste Valgfritt Vilkårlig lenke Valgfritt Lenke til vedlegg Valgfritt Infrmasjn m meldingen er bekreftet mttatt Valgfritt. Dersm meldingen er bekreftet mttatt av bruker, så vil det vises infrmasjn m hvem sm gjrde det, g når dette skjedde Varslingsinfrmasjn Valgfritt 3. Velg funksjn Bruker kan benytte seg av en av underfunksjnene. Etter å ha benyttet en funksjn, kmmer bruker tilbake til begynnelsen på punkt 3, med unntak av fr funksjnene Lukk mttatt frsendelse g Slett, hvr brukeren kmmer tilbake til hvedsiden. a. Bekreft mttatt Den mttatte frsendelsen kan være definert til å kunne bekreftes mttatt. Dersm gjeldende frsendelse ikke er bekreftet mttatt, g fristen fr å bekrefte ikke er verskredet, så tilbys bruker funksjnalitet fr å bekrefte at frsendelsen er mttatt. i. Lagre bekreftelse Systemet lagrer en bekreftelse m at meldingen er bekreftet mttatt. ii. Vis ppdatert mttatt frsendelse Det samme innhldet sm under Vis mttatt frsendelse vises, brtsett fra at innhldet er ppdatert med eventuelle bekreftelser g lignende. b. Skriv ut mttatt frsendelse Innhldet sm vises under Vis mttatt frsendelse skrives ut i utskriftsvennlig frmat. c. Åpne vedlegg 3
Benytt meldingstjeneste.dc Alternativ utføring Figur 1 Benytt meldingstjeneste - Prtalbruker Tjenesteeier kan legge ved ett eller flere vedlegg av typen HTML eller binær. i. Vis vedlegg Systemet viser vedlegget i nytt vindu. d. Velg svarlenke Svarlenke kan være enten en lenke til å pprette ny innsendingstjeneste, en lenke til en lenketjeneste eller en ekstern lenke. e. Lukk mttatt frsendelse Avslutter Use Case. (Avslutter bruk av tjenesten). f. Slett Sletter den mttatte frsendelsen, g avslutter Use Case. (Avslutter bruk av tjenesten). Alternativ flyt dersm Nrmalutføring i (Figur 1 Benytt meldingstjeneste - Prtalbruker) trigges av en etatsbruker fra servicearkivet (sm beskrevet i eget Use Case Finn mttatt g sendt infrmasjn i servicearkiv ). 1. Registrer mttatt frsendelse sm åpnet Dette steget hppes ver, da åpnet flagget ikke henspeiler på m Etatsbruker har åpnet den mttatte frsendelsen. 2. Vis mttatt frsendelse innehlder følgende infrmasjn: Overskrift Meldingstekst Meldingsteksten kan frmateres med HTML, eller bare innehlde ren tekst. Referanse til et skjema i arkiv Valgfritt Lenke til å pprette en ny innsendingstjeneste Valgfritt Lenke til en lenketjeneste Valgfritt Vilkårlig lenke Valgfritt Lenke til vedlegg - Valgfritt Infrmasjn m meldingen er bekreftet mttatt Valgfritt. Dersm meldingen er bekreftet mttatt av bruker, så vil det vises infrmasjn m hvem sm gjrde det, g når dette skjedde Varslingsinfrmasjn Valgfritt. 3. Velg funksjn Etatsbruker kan benytte seg av en av underfunksjnene. Etter å ha benyttet en funksjn, kmmer bruker tilbake til begynnelsen på punkt 3, med unntak av Lukk mttatt frsendelse. I dette punktet har på dette tidspunkt mulighet til å avbryte prsessen (lukke brwser, navigere tilbake g lignende). a. Bekreft mttatt Ikke tilgjengelig fr Etatsbruker b. Skriv ut mttatt frsendelse Innhldet sm vises under Vis mttatt frsendelse skrives ut i utskriftsvennlig frmat. c. Åpne vedlegg Tjenesteeier kan legge ved ett eller flere vedlegg av typen HTML eller binær. i. Vis vedlegg Systemet viser vedlegget i nytt vindu. d. Velg svarlenke Ikke tilgjengelig fr etatsbruker e. Lukk mttatt frsendelse Avslutter Use Case. 4
Benytt meldingstjeneste.dc Feilhåndtering Frretningsregler f. Slett Ikke tilgjengelig fr etatsbruker Dersm bruker ikke er autrisert fr å lese meldingen, vil ikke systemet vise meldingsinnhldet. Dersm meldingen er register med valg fr å bekrefte frsendelsen mttatt g fristen fr å bekrefte ikke er verskredet, så vil bruker få mulighet til å bekrefte meldingen mttatt. Dersm meldingen ikke er registrert med valg fr å bekrefte frsendelsen mttatt eller fristen fr å bekrefte meldingen er verskredet, blir ikke funksjnalitet fr å bekrefte presentert fr bruker. Dersm meldingen er bekreftet mttatt, så vises infrmasjn m hvem sm bekreftet den mttatt, g når. Dersm det er sendt varsling, så vises infrmasjn m dette i meldingen. Meldingen skal registreres sm åpnet idet prtalbruker åpner den. Meldingen må derimt ikke registreres åpnet hvis det er en etatsbruker sm åpner den. 5
Benytt meldingstjeneste.dc Sluttbrukersystem Spør etter funksjn Autentiser g autriser bruker Altinn Returner resultat av funksjn Returner melding m manglende autentisering/autrisering Sluttbrukersystem Mtta resultat av funksjn Mtta melding m manglende autentisering/autrisering Figur 2 Benytt meldingstjeneste - Sluttbrukersystem/etatssystem/eksterne systemer Benytt meldingstjeneste - Sluttbrukersystem/etatssystem/eksterne systemer Aktør(er) Trigger: Pre-betingelser Pst-betingelser Nrmal utføring Figur 2 Sluttbrukersystem/etatssystem eksterne systemer Sluttbrukersystem/etatssystem/eksterne systemer Sluttbrukersystem/etatssystem/eksterne systemer etterspør en av funksjnene dekket av dette Use Case (listet i raden Funksjner under). Tjenesten er tilgjengelig Tjenesten er imprtert fra tjenesteutviklingsløsningen til sluttbrukerløsningen Altinn har returnert resultatet av funksjnen eller en feilmelding dersm bruker ikke blir autentisert eller autrisert. 1. Spør etter funksjn. sluttbrukersystem/etatssystem/eksterne systemer kan etterspørre funksjner tilbudt via webservice grensesnitt i Altinn. Etterspør en meldingstjeneste Bekreft en meldingstjeneste 2. Autentiser g autriser bruker Denne utføringen dekker tilfellet der autentisering g autrisering av bruker er k. 3. Returner resultat av funksjn. Resultatet av funksjnen 6
Benytt meldingstjeneste.dc Funksjner Alternativ utføring Figur 2 Sluttbrukersystem/ etatssystem/eksterne systemer Feilhåndtering returneres av Altinn. 4. Mtta resultat av funksjn. Sluttbrukersystem/etatssystem/eksterne systemer mttar svar. Etterspør en meldingstjeneste Returnerer en bestemt meldingstjeneste basert på en identifikatr sm identifiserer hvilken meldingstjeneste det spørres etter. Meldingstjenesten sendes sm XML. Meldingstjenesten vil innehlde den samme infrmasjnen sm kan aksesseres i prtalen, med svarlenker g binære vedlegg representert. I det en meldingstjeneste etterspørres, så registreres den sm åpnet i Altinn, på samme måte sm meldingstjenester sm åpnes i prtalen. Bekreft en meldingstjeneste Bekrefter en enkelt meldingstjeneste mttatt basert på en identifikatr sm identifiserer hvilken meldingstjeneste sm skal bekreftes mttatt. Det tilbys ikke etatssystemer å bekrefte meldinger. Returnerer melding m hva sm er bekreftet mttatt. 1. Spør etter funksjn 2. Autentiser g autriser bruker Denne utføringen dekker tilfellet der autentisering g/eller autrisering feiler 3. Returner melding m manglende autentisering/autrisering 4. Mtta melding m manglende autentisering/autrisering Dersm sluttbrukersystem/eksternt system ber m bekreftelse fr mttatt frsendelse sm ikke finnes (angir en identifikatr sm ikke finnes), så vil ingenting bli markert sm mttatt. Returnerer melding m at ingen mttatt frsendelse finnes med angitt identifikatr. Dersm et etatssystem prøver å bekrefte en melding, vil frespørselen avvises da etatssystemer ikke tilbys denne funksjnaliteten. En melding skal registreres sm åpnet idet den returneres til sluttbrukersystem/eksternt system. Meldingen må derimt ikke registreres åpnet hvis den returneres til etatssystem. Benytt meldingstjeneste Referanse til krav SBL_4.6.1.1.1 Det skal finnes funksjnalitet sm gir samme muligheter sm eksisterende meldingstjeneste SBL_4.12.3.3.2 Det er mulig å få tilgang til kpiarkiv fra tjenesteeiers saksbehandlingsløsning via web-service. Tilgang skal baseres på SAML 2.0 g ID-WSF g gi samme innsyn g ppslag i utførte tjenester sm via nettleser. Det frutsettes at Altinn ved lggføring av ppslag får tilstrekkelig brukeridentifikasjn g at autentisering g autrisasjn er tilfredsstillende løst i tjenesteeiers saksbehandlingsløsning, slik at tilgang uten tjenestelige behv kan spres. Tjenesteeiers tilgang fra nettleser g web-service skal gi innsyn i tiltrdd tredjepartsarkiv. SBLE_2.1.5.3.3 Meldinger innehlder en Meldingsverskrift sm vises i meldingen g versiktslisten under mttatt meldinger. Denne hentes fra MessageHeader. SBLE_2.1.5.3.6 Meldinger innehlder en generell meldingstekst sm tjenesteeier legger inn fr hver enkelt melding. Denne hentes 7
Benytt meldingstjeneste.dc SBLE_2.1.5.3.7 SBLE_2.1.5.3.8 SBLE_2.1.5.3.1 9 SBLE_2.1.5.3.2 0 SBLE_2.1.5.3.2 1 SBLE_2.1.5.3.2 9 SBLE_2.1.5.3.3 0 SBLE_2.1.5.3.3 1 SBLE_2.2.1.1.2 fra MessageSummary Meldinger kan innehlde et eller flere filvedlegg. Disse vises sm lenker i meldingen. Filvedleggene er kdet ved hjelp av base64. Vedleggene hentes fra Attachments. Meldinger kan innehlde strukturert html sm vises i løsning. En melding kan være knfigurert slik at den skal bekreftes mttatt av sluttbruker. Meldingen kan innehlde en frist fr når sluttbruker må ha bekreftet meldingen fr mttatt. Meldinger sm krever bekreftelse skal kunne bekreftes mttatt av bruker Svartjenesten i meldingen kan peke på et tidligere innsendt skjema i arkiv, starte en tjeneste i Altinn i frm av skjema eller lenketjenste, eller innehlde en URL. Meldingen innehlder en versikt ver varsel sm er sendt ut, både til mbiltelefnnummer g e-pst. Meldinger sm er bekreftet mttatt, viser hvem sm har bekreftet mttatt meldingen. Sluttbrukersystem kan benytte metdene sm er definert fr Webservicen https://ws.altinn.n/webservices/messagereceiptexchange.as mx Eksterne Use Case(s) Krav dekket i design Se systemdkumentasjn fr Mttatte frsendelser /Altut Relatert dkumentasjn Dkument Type Kmpnent/subcmpnent AP310 Intermediary Design Intermediary Functinal High Level Design - Receive Crrespndence AP311 Service Definitin Design Service Engine/Crrespndence High Level - SBL - Crrespndence AP347 Page Specificatin Design Service Engine/Crrespndence High Level SBL Crrespndence AP353 Sub-cmpnent Design Service Engine/Crrespndence Definitin - SBL - Service engine - Crrespndences AP347 Page Specificatin High Level - SBL- Display Attachment Design Service Engine/Crrespndence 8