Altinn II Leseguide for brukerveiledningen til TUL Versjon 1.0 Dato: 10.05.2010
Innhold 1 Leserguide... 3 1.1 Felles kapitler... 4 1.2 Fagperson... 4 1.3 IKT-medarbeider... 5 1.4 Teknisk utvikler... 6 1.5 Oversetter... 6 1.6 Løsningsadministrator... 6 Altinn Side 2 / 6
1 Leserguide Dette kapittelet gir en oversikt over de brukergruppene som skal bruke TUL og hvilke oppgaver hver av disse er tiltenkt å jobbe med. Bruker og egenskaper Fagperson som forstår kommunikasjonsbehov knyttet til aktuelle offentlig tjenester basert på faglig kompetanse. Er opptatt av at tjenester skal være effektive, feilfrie og av høy brukskvalitet; er nøyaktig og ønsker å levere god kvalitet. Har et fagområde utenom IKT; bruker IKTverktøy, men er ingen systemutvikler. Har fått grunnopplæring i TUL og evt. InfoPath. Arbeider med tjenestedefinisjon og -vedlikehold generelt, eller er spesialisert inn mot bestemte oppgaver. Oversetter som har kompetanse på de aktuelle språkene. Typiske oppgaver - Opprette tjeneste/tjenesteutgave - Utarbeide design - Definere tjeneste inkludert evt. prosessflyt og skjemasett - Utvikle tjenesteinnhold inkludert layout, tekster, kalkyler og regler - Enhetsteste tjeneste - Starte migrering til portalmiljø - Systemteste/akseptanseteste tjeneste - Publisere informasjon om tjeneste - Vedlikeholde og migrere kodeliste - Oversette tjeneste Er grundig og ønsker å bidra til enkel og forståelig kommunikasjon. Har fått grunnopplæring i TUL vinklet mot språkmodulen. IKT-person som har erfaring med systemutvikling. Behersker InfoPath (inkludert Xpath og C# i Visual Studio for Application) og SharePoint. Har fått grunnopplæring i TUL. Teknisk utvikler med god forståelse av Altinnløsningen. Har spesialisert kompetanse knyttet til verktøyene i Altinn, for eksempel Workflow Foundation eller BizTalk. Enkelte har tilgang til å iverksette endringer i produksjonsmiljøet. For øvrig som IKT. - Utarbeide prosessflytmal - Utarbeide komplekse regler/kontroller - Utvikle ny kjøretidskomponent, for eksempel prosessflytkomponent - Produksjonssette mal - Produksjonssette tjeneste - Opprette arbeidsområde og database for etat/ny tjenesteeier - Opprette nytt integrasjonspunkt mot etat Altinn Side 3 / 6
Løsningsadmin Løsningsadministrator med god forståelse av Altinn-løsningen, spesielt TUL. Gir støtte til tjenesteeiere i tjenesteutviklingsarbeidet. Kan være administrator på vegne av en enkelt tjenesteeier eller for hele løsningen. Bruker IKT-verktøy, men er ingen systemutvikler. Har fått opplæring i Active Directory og i SharePoint, vinklet mot brukeradministrasjon og/eller tilpasning av samhandlingsområder i SharePoint. - Administrere roller og rettigheter - Laste opp nyttig og nødvendig informasjon for de som skal jobbe i TUL, for eksempel dokumentmaler, dokumenter og kunngjøringer 1.1 Felles kapitler Kap. 1 - Innledning er overordnet informasjon om hva brukerveiledningen inneholder og setter bruker inn i hvilke deler løsningen består av og hvem som skal bruke den. Hvilke roller som skal bruke TUL er også gjengitt over i dette dokumentet. Spesielt bør alle lese igjennom kap. 1.2 for å forstå arbeidsprosessen for tjenesteutvikling. Kap. 4 Kom igang med tjenesteutvikling. Dette kapittelet inneholder informasjon om hvordan sette opp miljøet for å få tilgang til TUL og dermed være klar for å starte med tjeneste utvikling. Dette er et kapittel alle bør lese for sette opp miljøet man senere skal jobbe i. Kap. 16 Begrepsliste. En bruker bør sette seg inn i begreper som brukes i løsningen og under utvikling før utviklingen starter. 1.2 Fagperson En fagperson vil i all hovedsak ha i oppgave å opprette det meste av innholdet i en tjeneste. Under følger en hjelp på hvordan en fagperson kan lese brukerveiledningen for å komme raskt igang og i hvilken rekkefølge de ulike oppgavene mest sannsynlig blir relevante. Kap. 5 - Lage tjeneste og utgave er første del av brukerveiledning som bør leses av fagperson etter at miljøet er satt opp (kap. 4). Her finnes overeordnet informasjon om inndelingen av TUL og hvordan komme igang med utviklingen. Kap. 6 Design. Neste steg etter at en tjeneste er opprettet er å designe tjenesten. Dette kan gjelde å legge inn dokumentmaler for tjeneste, designe skjema etc. En del design kan være gjennomført utenfor TUL, men det er ikke mulig å få dette inn som en del av løsningen før etter at en tjeneste er opprettet. Altinn Side 4 / 6
Kap. 7 Definèr tjeneste og utgave vil gi brukeren detaljert veiledning i hvordan opprette en tjeneste, en tjenesteutgave og utgavespesifikasjoner. Kap. 18 Vedlegg A, B og C (18.1, 18.2 og 18.3) gir bruker en innføring i hvordan opprette og bygge opp et skjema ved hjelp av InfoPath. Et skjema må være lastet opp på arbeidsflaten til en utgave for å kunne gå videre med utvikling av innholdsspesifikkasjoner. Grunnleggende kunnskap om InfoPath-utvikling er viktig for å komme videre med utviklingen av en tjeneste utgaven. Kap. 8 Utvikling av tjenesteinnhold. Etter at et InfoPath-skjema er designet og lastet opp på arbeidsflaten for en utgave (av typen innsendingstjeneste), vil det være mulig å utvikle innholdspesifikasjoner for en utgave. Her finnes informasjon om gjenstående utvikling av en utgave. Kap 10 Enhetstest. Etter at en tjenesteutgave er ferdig utviklet vil det neste steget være å enhetsteste denne. Denne testen gjøres før migrering av utgaven. Kap. 14 Kodelister kan utvikles uavhengig og parallelt med tjenesteutgaver. Hvis et InfoPathskjema for en utgave bruker en kodeliste, er skjemaet avhengig av at kodelisten er migrert til det/de miljøer der utgaven skal brukes for at skjema skal kunne ta i bruk kodelisten. Kap. 11 Migrering til portalmiljø. Migrering av en tjeneste skjer først etter at en tjenesteutgave er ferdig utviklet og utgaven er enhetstestet. Kap. 13 Slette tjeneste og utgave. Sletting av tjeneste og tjenesteutgave kan gjennomføres så lenge det finnes tjenester og tjenesteutgaver i tilgjengelig i løsningen. Kap. 17 Referanser. Her finner du linker til web innhold som gir mer informasjon om dette. 1.3 IKT-medarbeider En IKT-medarbeider har mer teknisk kunnskap rundt avansert utvikling av et InfoPath-skjema enn enn en fagperson gjerne har. Disse kan alikevel i noen tilfeller være en og samme person. Kap. 18 - Vedlegg A, B og C (18.1, 18.2 og 18.3) gir bruker en innføring i hvordan opprette og bygge opp et skjema ved hjelp av InfoPath. Et skjema må være lastet opp på arbeidsflaten til en utgave for å kunne gå videre med utvikling av innholdsspesifikasjoner. Grunnleggende kunnskap om InfoPath-utvikling er viktig for å komme videre med utviklingen av en tjenesteutgav. Her finner du linker til web innhold som gir mer informasjon om dette. Kap. 8 Utvikling av tjenesteinnhold. En IKT-medarbeider kan også stå for utvikling av en tjeneste utgave etter at InfoPath dokument er utviklet. Altinn Side 5 / 6
1.4 Teknisk utvikler En teknisk utvikler vil ha de samme oppgaver som en IKT-medarbeier, men kunne ta mer tekniske oppgaver. Dette er imidlertid ikke dokumenteret i brukerveiledningen for TUL. Kap. 18.4 Vedlegg D. Tildeling av brukerrettigheter via Active Directory og i SharePoint er en oppgave Teknisk utvikler kan få ved oppgaven som administrator for tjenesteeier. 1.5 Oversetter Oversetter skal ta utgangspunkt i eksisterende hovedspråk og oversette til andre språk en tjeneste skal leveres på. Kap. 12 Oversetting. Her finner oversetteren instruksjoner om hvordan gå frem for å oversette tjenesteutgave-innhold til flere språk. 1.6 Løsningsadministrator Administrator skal være ansvarlig for den daglige driften av systemet og bl.a. ha ansvaret for brukertilganger til løsningen. Kap. 13 Slette tjeneste og utgave, En løsningsadministrator vil kunne rydde opp i løsningen for å fjerne ikke lenger gyldige tjenester og tjenesteutgaver. Kap. 18.4 Vedlegg D. Tildeling av brukerrettigheter via Active Directory og i SharePoint er en oppgave for løsningsadministrator. Altinn Side 6 / 6