AP221 Use Case SBL innsendingstjeneste
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
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_2.1.5.2.1 SBLE_2.1.5.2.4 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
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_2.1.5.2.9 Preutfylling på feltnivå knyttes opp i mot en privatperson eller virksomhet og tidsperiode preutfyllingsdataene er gyldig. SBLE_2.1.5.2.13 Preutfylling av oppgavesett kan gjøres for privatpersoner eller virksomheter. SBLE_2.1.5.2.20 Preutfyllingsdata inneholder informasjon om tidsperioden dataene er gyldig. Autentiser og autoriser bruker Benytt innsendingstjeneste Registrer abonnement Registrer preutfyllingsdata Benytt meldingsboks SBLE_2.1.5.2.2 Oppgaveregisteret definerer om et felt skal preutfylles ved instansiering eller ikke. (I ny løsning skal dette angis i tjenesteutviklingsløsningen.) SBLE_2.1.5.2.3 Felter som ikke er definert i Oppgaveregisteret til å preutfylles, skal ikke preutfylles. (I ny løsning skal dette angis i tjenesteutviklingsløsningen.) SBLE_2.1.5.2.8 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_2.1.5.2.11 Preutfylling av oppgavesett gjøres av etaten i henhold til de XSDene som gjelder for skjemaene i oppgavesettet som skal preutfylles. SBLE_2.1.5.2.12 Preutfylling av oppgavesett kan bestå av hovedskjema, hovedskjema og div underskjema ev. i kombinasjon med filvedlegg eller komplette oppgavesett. SBLE_2.1.5.2.14 Preutfylling av oppgavesett benytter identifiserende felter og unik ID for å ha mulighet til å ha flere preutfyllingsdata liggende tilgjengelig samtidig. SBLE_2.1.5.2.15 Preutfylling av oppgavesettet spesifiserer status på om oppgavesettet er validert eller ikke. Dersom oppgavesettet er validert, er oppgavesettet komplett og fullstendig preutfylt. SBLE_2.1.5.2.16 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_2.1.4.1.3 Identifiserende felter i forbindelse med abonnement og preutfylling benyttes for å kunne skille flere instanser av samme skjema fra hver andre SBLE_2.1.5.2.17 Filvedlegg som overføres som preutfyllingsdata kodes i henhold til base64. 4
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