AP221 Use Case SBL Preutfyll og instansier innsendingstjeneste

Transkript

1 AP221 Use Case SBL innsendingstjeneste

2 innsendingstjeneste Preutfylling av innsendingstjenester skal hjelpe brukerne med utfyllingen av innsendingstjenesten. Der tjenesteeier kjenner til informasjonen som skal fylles inn kan preutfylling benyttes. Preutfyllingen skjer rett etter en innsendingstjeneste instansieres og før den kan vises for bruker i utfyllingsmodus eller sendes inn. Innlesing av preutfyllingsdata og registerdata dekkes av egne Use Case Registrer Preutfyllingsdata og Importer registerdata. Finn preutfyllingsdata Legg inn preutfyllingsdata Instansier innsendingstjeneste Sett gjeldende steg i tjenestens arbeidsflyt til første steg Figur 1 2

3 Aktør(er) Trigger: Pre-betingelser Post-betingelser Normal utføring Alternativ utføring Feilhåndtering Forretningsregler innsendingstjeneste Altinn Trigges fra Use Case: Benytt innsendingstjeneste. Trigges for portalbruker direkte etter funksjonalitet beskrevet i Use Case Start tjeneste. Trigges for sluttbrukersystem etter at forsendelsen er validert ok. Registrer abonnement Registrer preutfyllingsdata (valgfri instansiering ved sanntid registrering) Finn aktive, mottatte og arkiverte elementer (ved bruk av ny kopi funksjonalitet) Preutfyllingsdata/abonnementsdata må ha blitt registrert for at preutfylling faktisk skjer. Funksjonalitet i Use Case kjøres uansett om preutfyllingsdata er registrert eller ikke. Innsendingstjenesten er instansiert og preutfylt 1. Finn preutfyllingsdata Altinn finner preutfyllingsdata etter gjeldende regler for preutfylling (spesifiseres i design). Aktuelle kilder å hente preutfyllingsdata fra er register i Altinn og preutfyllingsdata sendt inn fra etat (nøkkel/verdi og skjemasett). 2. Legg inn preutfyllingsdata Altinn legger de aktuelle preutfyllingsdataene som er funnet inn i dataene til innsendingstjenesten slik at de vil vises når bruker åpner innsendingstjenesten/kvittering. Innsendingstjenesten inneholder allerede på dette tidspunktet data som kommer fra sluttbrukersystem eller fra ny kopi funksjonalitet. Regler for konflikter mellom denne typen data og preutfyllingsdata spesifiseres i design. 3. Instansier innsendingstjeneste Instansen opprettes og lagres i databasen. Informasjon om blant annet hvem som initierte instansieringen og når den skjedde logges i databasen. 4. Sett gjeldende steg i tjenestens arbeidsflyt til første steg Styring av arbeidsflyt beskrives i Use Case Benytt innsendingstjeneste Dersom et skjema uten preutfyllingsdata instansieres, så vil skjema ikke inneholde noen form for preutfyllingsdata. Dersom preutfyllingsdataene ikke har gyldighetsvindu (gyldig fra- og tildato) i det skjema instansieres så skal systemet oppføre seg som om preutfyllingsdataene ikke fantes. Felter som skal preutfylles er markert til å bli preutfylt i TUL. Felt uten en slik markering skal ikke preutfylles så frem det ikke er et komplett oppgavesett som preutfylles. Angivelse av felt gjøres på tjenesteutgavenivå. Ved komplett oppgavesett ignoreres alle markeringene og alle felt med preutfyllingsdata fylles ut. Referanse til krav SBLE_ SBLE_ Ved instansiering av skjema, blir skjema preutfylt med informasjon fra interne register i Altinn. Det kan preutfylles fra de interne register i Altinn slik som Enhetsregisteret og Det sentral folkeregisteret 3

4 Eksterne UseCase(s) Krav dekket i design Input til design (Krav som spesifiseres i design) Det kan preutfylles fra interne register slik som kommunetabell, poststedtabell og etatsspesifikke register som finnes i Altinn. SBLE_ Preutfylling på feltnivå knyttes opp i mot en privatperson eller virksomhet og tidsperiode preutfyllingsdataene er gyldig. SBLE_ Preutfylling av oppgavesett kan gjøres for privatpersoner eller virksomheter. SBLE_ Preutfyllingsdata inneholder informasjon om tidsperioden dataene er gyldig. Autentiser og autoriser bruker Benytt innsendingstjeneste Registrer abonnement Registrer preutfyllingsdata Benytt meldingsboks SBLE_ Oppgaveregisteret definerer om et felt skal preutfylles ved instansiering eller ikke. (I ny løsning skal dette angis i tjenesteutviklingsløsningen.) SBLE_ Felter som ikke er definert i Oppgaveregisteret til å preutfylles, skal ikke preutfylles. (I ny løsning skal dette angis i tjenesteutviklingsløsningen.) SBLE_ Preutfylling på feltnivå leveres fra tjenesteeier uavhengig skjema. Verdiene som overføres knyttes opp i mot orid og kan benyttes i hvilket som helst skjema som har definert preutfylling på feltnivå. SBLE_ Preutfylling av oppgavesett gjøres av etaten i henhold til de XSDene som gjelder for skjemaene i oppgavesettet som skal preutfylles. SBLE_ Preutfylling av oppgavesett kan bestå av hovedskjema, hovedskjema og div underskjema ev. i kombinasjon med filvedlegg eller komplette oppgavesett. SBLE_ Preutfylling av oppgavesett benytter identifiserende felter og unik ID for å ha mulighet til å ha flere preutfyllingsdata liggende tilgjengelig samtidig. SBLE_ Preutfylling av oppgavesettet spesifiserer status på om oppgavesettet er validert eller ikke. Dersom oppgavesettet er validert, er oppgavesettet komplett og fullstendig preutfylt. SBLE_ Preutfylling av oppgavesettet kan inneholde filvedlegg (attachment). Her kan tjenesteeier beskrive type filvedlegg, filnavn, navn på vedlegg, beskrivelse av innhold, status på vedlegget og om vedlegget skal signeres. SBLE_ Identifiserende felter i forbindelse med abonnement og preutfylling benyttes for å kunne skille flere instanser av samme skjema fra hver andre SBLE_ Filvedlegg som overføres som preutfyllingsdata kodes i henhold til base64. 4

5 Relatert dokumentasjon Dokument Type Komponent/Subkomponent AP353 Sub-component Design Service Engine/Prefill Definition - SBL - Service engine - Prefill AP311 Service Definition Design Service Engine/Prefill High Level - SBL - Prefill AP312 Batch Design Definition -Service engine - Subscription - Instantiate subscriptions Design Intermediary 5