AP221 Use Case - SBL - Benytt innsendingsjeneste

Transkript

1 AP221 Use Case - SBL - Benytt innsendingsjeneste

2 Benytt innsendingstjeneste Bruker kan fylle ut/signere/sende inn innsendingstjeneste og funksjonaliteten knyttet til disse operasjonene er beskrevet detaljert i use casene Preutfyll og instansier innsendingstjeneste, Fyll ut innsendingstjeneste og Send inn innsendingstjeneste. Innsendingstjeneste kan instansieres i portalen, fra sluttbrukersystem eller fra etatssystem. Use Case for Start tjeneste kjøres før ny tjeneste kan startes i portalen. Innsendingstjenestene har en arbeidsflyt som definerer hvilke steg som må utføres før tjenesten kan sendes inn og arkiveres. Funksjonalitet for å fylle ut ved å laste opp XML i portalen støttes bare av innsendingstjenester(skjematjenester) i eksisterende Altinn løsning. Dette vil derfor ikke beskrives i dette Use Case. Start tjeneste Preutfyll og instansier innsendingstjeneste Styr arbeidsflyt Se kvittering Send inn innsendingstjeneste Fyll ut innsendingstjeneste Figur 1 Benytt innsendingstjeneste - portal Benytt innsendingstjeneste - portal Aktør(er) Trigger: Pre-betingelser Post-betingelser Portalbruker Portalbruker velger å benytte en innsendingstjeneste enten fra Tjenestekatalogen eller en dyplenke(se eget use case Benytt dyplenke) Tjenesten er aktivert i Altinn Tjenesten er importert fra tjenesteutviklingsløsningen til sluttbrukerløsningen. Innsendingstjenesten er sendt til arkiv. Dersom innsendingtjenesten er konfigurert til å ikke lagres i arkiv, så blir ikke dataene liggende i arkivet. 2

3 Normal utføring Alternativ utføring Feilhåndtering Forretningsregler 1. Start tjeneste Sjekker om bruker lar seg autentisere og autorisere og om valgt avgiver oppfyller avgiverkrav til valgt tjeneste. Start tjeneste er detaljert i eget Use Case. 2. Preutfyll og instansier innsendingstjeneste Utfører instansiering av innsendingstjenesten og deretter preutfylles innsendingstjenesten. Instansier og preutfyll innsendingstjeneste er detaljert i eget Use Case. 3. Styr arbeidsflyt Avhengig av hvordan arbeidsflyten er definert vil flyten gå videre til et av de to punktene 3a eller 3b. Er siste steg i arbeidsflyten ferdig vil flyten gå videre til punkt 3c. Hvem som faktisk har mulighet til å gjennomføre de forskjellige stegene, er styrt av roller/rettigheter definert i arbeidsflyt. a. Fyll ut innsendingstjeneste Selve utfyllingen av innsendingstjenesten. Detaljert i Use Case Fyll ut innsendingstjeneste. b. Send inn innsendingstjeneste Her får bruker mulighet til å fullføre ett av innsendingsstegene eller sende innsendingstjenesten tilbake til et tidligere steg. Neste gjeldende steg i arbeidsflyten til innsendingstjenesten blir satt på bakgrunn av hva bruker gjør. Arkivering vil kunne skje i Send inn innsendingstjeneste. Detaljert i Use Case Send inn innsendingstjeneste. c. Se kvittering Detaljert i Use Case Se kvittering Underveis i aktivitetsdiagrammet har bruker mulighet til å avslutte arbeidet med innsendingstjenesten og gå tilbake til hovedsiden. Fra hovedsiden kan bruker gå tilbake inn i innsendingstjenesten som var under arbeid. I dette tilfellet vil bruker starte i punkt 3 i aktivitetsdiagrammet når arbeidet gjenopptas. Punkt 1 og 2 gjennomføres bare en gang. Ingen utover egen feilhåndtering i de nevnte Use Case. Forretningsregler utledet i nevnte Use Case. 3

4 Autentiser og autoriser bruker Utfør validering av forsendelse Lag kvittering for ugyldig forsendelse Preutfyll og instansier innsendingstjeneste Utfør kryssvalidering Lag kvittering for feil i kryssvalidering Styr arbeidsflyt Slett innsendingstjeneste Arkiver innsendingstjeneste Lag suksesskvittering for aktiv innsendingstjeneste Lag suksesskvittering for arkivert innsendingstjeneste Figur 2 Benytt innsendingstjeneste sluttbrukersystem/eksternt system Benytt innsendingstjeneste sluttbrukersystem/eksternt system Aktør(er) Trigger: Pre-betingelser Post-betingelser Normal utføring Sluttbrukersystem/eksternt system Sluttbrukersystem/eksternt system kaller webservice for innsending Tjenesten er aktiv Kvittering på utfallet av innsendingen har blitt opprettet. 1. Autentiser og autoriser bruker Sluttbrukersystemet autentiserer og autoriserer seg for at Altinn skal godta dataforsendelsen. 2. Utfør validering av forsendelse Forsendelsen valideres opp mot gitte kriterier. Forsendelsen 4

5 inneholder system- og brukerdata for autentisering og autorisering samt innsendingstjeneste- data. a. Lag kvittering for ugyldig forsendelse Dersom forsendelsen ikke er gyldig, så lages det en kvittering som forteller hva som er galt, og programflyten stopper uten å opprette noen innsendingstjeneste. 3. Preutfyll og instansier innsendingstjeneste Utfører preutfylling og instansiering av innsendingstjenesten, som detaljert i eget Use Case. 4. Utfør kryssvalidering Kryssvalidering foretas, og for hvert element i innsendingstjenesten så lagres det informasjon om denne er gyldig eller ikke. Under kryssvalidering kjøres de samme valideringssjekkene som gjøres i kryssvalidering initiert av portalen. a. Lag kvittering for feil i kryssvalidering Dersom innsendingen er satt komplett (se andre overskrift i punkt 5 under), og ett eller flere av elementene ikke passerer validering, lages en kvittering som inneholder feilmeldingen. Feilmeldingen vil inneholde de feilmeldinger med den kontekst som er lagt opp til av skjemautvikler. i. Slett innsendingstjeneste Instansen som er blitt opprettet slettes på grunn av feil i kryssvalidering. Deretter avbryter programflyten. 5. Styr arbeidsflyt Avhengig av hvilke parametere sluttbrukersystemet har satt i forsendelsen, settes innsendingstjenesten til en av de følgende tilstandene. Det vil lages logginnslag for hendelesene som nevnes under, som beskriver at stegene utfylling og signering eventuelt er utført. Logginslagene vil inneholde informasjon om hvem som har utført steget, og når. I disse tilfellene vil det være sluttbrukersystemene som utfører stegene. Følgende avsnitt tar høyde for dagens klassiske arbeidsflyter, som består av utfyllingssteg, deretter x antall signeringssteg og et innsendingssteg(kan være signering og innsending i ett steg). Dersom det utvikles nye typer arbeidsflyter, så vil disse flytene selv definere hvordan sluttbrukersysteminnsendinger skal behandles. Beskrivelsen under er generisk og vil bli styrt av den aktuelle innsendingstjenestens arbeidsflyt. - Ikke komplett Dersom innsendingstjenesten er sendt ikke komplett, betyr dette at innsendingstjenesten er ment å fortsette utfylling i portal etter innsending, og i dette tilfellet vil det ikke gjøres noen endring på hvilket arbeidsflytsteg som er aktivt. Tjenesten vil da bli stående i første arbeidsflytsteg, hvor den allerede har blitt plassert av punkt 3. Punkt 5.b vil da utføres. - Komplett Dersom innsendingstjenesten derimot er sendt komplett, så er intensjonen at første utfyllingssteg allerede er utført. Dersom det ikke finnes noen flere arbeidsflytsteg i innsendingstjenesten, så vil 5

6 en komplett innsending legges rett i arkiv (punkt 5.a under). Dersom det finnes flere arbeidsflytsteg, vil selv en komplett innsending legges i arbeidslisten (punkt 5.b). Gjeldende arbeidsflytsteg vil da være steget etter innsendingen - Komplett og signert Innsendingstjenester kan sendes inn signert fra sluttbrukersystem. Det er kun komplette innsendinger som kan signeres. Ved innsending av komplett og signert forsendelse, vil tjenester med bare 2 steg (utfylling og signering), gå rett til arkiv (punkt 5.a under). Dersom det er flere enn ett signeringssteg, så vil tjenesten legges i arbeidslisten (punkt 5.b) og aktivt arbeidsflytsteg settes til første arbeidsflytsteg etter de 2 allerede utførte stegene (utfylling og signering). a. Arkiver innsendingstjeneste Innsendingstjenesten har gjennomgått alle sine arbeidsflytsteg, og kan derfor sendes rett til arkiv (brukers Meldingsboks, servicearkiv og tredjepartsarkiv). Dersom innsendingstjenesten er konfigurert til å ikke arkiveres, så vil ikke selve dataene bli liggende i arkivet. i. Lag suksesskvittering for arkivert innsendingstjeneste Kvittering om at tjenesten er arkivert blir opprettet b. Lag suksesskvittering for aktiv innsendingstjeneste Kvittering om at innsendingstjenesten er instansiert og ligger i arbeidsflyt blir opprettet. Alternativ utføring Uthenting av kvittering fra sluttbrukersystem: Sluttbrukersystem kan etterspørre kvittering under eller etter prosessering av innsendingstjenesten. Dersom Altinn ikke er ferdig med å prosessere innsendingstjenesten, så vil dette føre til at sluttbrukersystem får tilbake en kvittering som opplyser om at prosessen ikke er ferdig. Dersom prosessen er ferdig (Aktivitetsdiagrammet har nådd sluttstadiet) når kvittering etterspørres, så vil enten en suksesskvittering eller en feilkvittering returneres. Den nevnte kvitteringen vil oppdateres dersom flere enkeltsteg utføres. Det vil si at det ikke bare er den stegene utført i den initielle innsendingen som det lages kvittering for. Dersom det utføres enkeltsteg på den innsendte tjenesten, så vil kvitteringen oppdateres med informasjon om disse enkeltstegene. Enkeltsteg kan enten gjennomføres i portalen(lagring/videresending/signering), eller fra sluttbrukersystem(som beskrevet under). Det vil ikke lages noen slik kvittering for innsendingstjenester som opprinnelig ble instansiert i portal, kun de som er innsendt fra sluttbrukersystem. Det presiseres at det her er snakk om en annen type kvitteringer enn det som nevnes i use case Se kvittering. Den typen kvittering som nevnes her er samme kvitteringstype som nevnes i normalutføring og tidligere i alternativ utføring. Det er snakk om en kvittering som angir status til et oppgavesett innsendt via sluttbrukersystem. I use case Se kvittering snakkes det om en kvittering på innsendt innsendingstjeneste, og denne typen kvitteringer kan alltid hentes ut fra SBS. Utføring av enkeltsteg fra sluttbrukersystem: Dersom en innsendingstjeneste sendes inn fra sluttbrukersystem med for lite informasjon til at arbeidsflyten kan fullføres, vil den bli liggende i 6

7 arbeidsflyten. Sluttbrukersystemene vil da ha mulighet til å utføre enkeltsteg for å drive arbeidsflyten videre, slik som signering eller videresending. Eventuelt å sende arbeidsflyten tilbake til utfylling(det er arbeidsflyten som modellerer hva som skal være tilbake, selv om dette vanligvis vil være utfylling). Dette blir på samme måte som portalbruker kan gjøre i portalen. De stegene som utføres vil logges på samme måte som om de hadde blitt utført i portalen. Dette utføres ved et tjenestegrensesnitt som tilbys ut mot sluttbrukersystemene. Disse tjenestegrensesnittene defineres per arbeidsstegtype, og må utvikles for hvert nye arbeidssteg. De arbeidsflytstegene som initielt vil finnes i løsningen vil ha disse grensesnittene definert, og det må utformes nye grensesnitt sammen med nye arbeidsflytsteg. Hvordan prosessen presenteres for sluttbrukersystembrukeren, defineres av de enkelte sluttbrukersystemleverandørene. Feilhåndtering Forretningsregler Uthenting av gyldige skjemaer: En liste over skjemaer og gyldige versjoner kan hentes av sluttbrukersystem. Denne listen inneholder alle gyldige skjemaer i løsningen. Ingen utover den allerede modellerte feilhåndteringen(feilkvitteringer ved valideringsfeil) Definert i nevnte Use Case. Benytt innsendingstjeneste Referanse til krav SBL_ SBL_ SBL_ SBL_ SBL_ SBL_ SBLE_ SBLE_ SBLE_ SBLE_ Det er mulig å uføre alle og de samme kalkyler og kontroller som er implementert både i web-skjema i portalen og på data innsendt fra sluttbrukersystem Det er mulig å benytte en svært forenklet dialog for innsending dersom tjenesten ikke krever signatur. Denne må kommunisere klart til brukeren når forsendelsen er sendt. Det er mulig å angi at flere personer/roller skal signere samme forsendelse før den kan sendes inn Sluttbrukersystem kan sende inn vedleggsskjema sammen med innsendingstjenesten. Sluttbrukersystem kan sende inn binære filvedlegg sammen med innsendingstjenesten. Det er mulig å presentere full informasjon om kontekst og innhold i feilmeldinger som legges ut til sluttbrukersystemer se liste i kravspesifikasjon for Tjenesteutvikling /5/ Arbeidsflyt knyttes opp mot en tjeneste i Altinn Arbeidsflyt bygges opp av flere steg, slik som for eksempel instansiering, utfylling, signering. Hvert steg i en arbeidsflyt er knyttet til én rolle. Rollen styrer tilgangen til steget. Presentasjonsfelter benyttes i forbindelse med en innsendingstjeneste og vises som en del av tjenesteinstansnavnet i hovedsiden lister for å kunne skille ulike instanser av samme tjeneste. Presentasjonsfelter skal kunne benyttes for alle 7

8 Eksterne Use Case Krav dekket i design tjenester som har instansdata presentasjonsfeltene kan populeres fra. Med instansdata menes data som er dynamiske, eksempelvis skjemainnhold fra bruker og data fra innsynstjeneste. For statiske tjenester, eksempelvis meldinger, defineres titler o.a. i de statiske dataene, og presentasjonsfelter benyttes derfor ikke for disse. SBLE_ Det kan maks defineres 6 presentasjonsfelter for en tjeneste SBLE_ De identifiserende feltene som defineres kan være forskjellig fra presentasjonsfeltene som defineres for tjenesten. SBLE_ Ved instansiering av en tjeneste, opprettet det også en instans av arbeidsflyt som knyttes opp i mot tjenesten. Start tjeneste Preutfyll innsendingstjeneste Fyll ut innsendingstjeneste Send inn innsendingstjeneste Finn aktive elementer Relevant dokumentasjon Dokument Type Komponent/subcomponent AP353 Sub-component Design Service Engine/Workflow definition SBL Service Engine Workflow AP311 Service definition Design Service Engine/Workflow SBL Workflow AP347 Page specification SBL Control workflow Design Service Engine/Workflow 8