VEDLEGG HOVEDPROSJEKT VÅR 2013 KNOWIT CVREG TILBUD

Transkript

1 VEDLEGG HOVEDPROSJEKT VÅR 2013 KNOWIT CVREG TILBUD GRUPPE 36 FORFATTERE: NORDENGEN, THOMAS LARSEN, GLENRUBEN E. STEEN, SEBASTIEN-JEROME 1

2 INNHOLDSFORTEGNELSE VEDLEGG 1 KRAVSPESIFIKASJON VEDLEGG 2 BRUKERMANUAL VEDLEGG 3 TESTRAPPORT VEDLEGG 4 USE CASE VEDLEGG 5 - SEKVENSDIAGRAM

3 VEDLEGG 1 KNOWIT CVREG GRUPPE 36 K R A V S P E S I F I K A S J O N H O V E D P R O S J E K T VÅR FORFATTERE: NORDENGEN, THOMAS LARSEN, GLENRUBEN E. STEEN, SEBASTIEN-JEROME [FRAFALT MEDLEM] V.3 D A T O:

4 Innhold 1. Prosjektbeskrivelse Innledning Om hovedprosjektet Om Bedriften Innføring i hovedprosjektet Arbeidsmetodikk Rammebetingelser Suksesskriteria Antagelser Kravspesifikasjon Funksjonelle krav Ikke funksjonelle krav krav til dokumentasjon Krav til kvalitetssikring Mål og videre utvikling Milepæl Øvrige milepæler

5 5

6 1. Prosjektbeskrivelse Hovedprosjekts tittel: Utvikling av CvReg Beskrivelse: Videreutvikle og implementere nye funksjoner i Knowit sin egenutviklede ansattdatabase, CvReg Prosjektgruppe: Gruppe 36 Prosjektdeltakere: Glenruben Engen glenruben@gmail.com Thomas Nordengen metalthomas@gmail.com Sebastien-Jerome Steen sebastien.steen@gmail.com [Frafalt medlem] Veileder: Steinar Johannesen steinar.johannesen@hioa.no 6

7 Oppdragsgiver: Knowit Kontaktpersoner: Sigmund Marius Nilssen Øyvind Marthinsen Jon Marius Håkedal 7

8 2. Innledning 2.1 Om hovedprosjektet Hovedprosjektet ved Høgskolen i Oslo og Akershus er et fag på slutten av bachelorstudiene til de forskjellige datalinjene for å sette i praksis kunnskapen studentene har ervervet under de tre årene med utdanning. Gruppe 36 er formet av tre studenter fra anvendt datateknologi og én fra Informasjonsteknologi. De har fått anledningen til å jobbe sammen med IT konsulentfirmaet Knowit, der de skal videreutvikle en databasebasert webside Knowit har utviklet til eget bruk. 2.2 Om Bedriften Knowit er et av de ledende konsulentfirmaene i nordeuropa med over 1700 ansatte spredt over fem land. Siden sin stiftelse i Sverige i 1990 har Knowit spesialisert seg på informasjonsteknologi og digitale tjenester. Knowit Norge har over 300 ansatte og har i de siste årene klart å utvide seg i fire byer rundt i Norge og jobbe sammen med noen av Norges største bedrifter og organisasjoner. 2.3 Innføring i hovedprosjektet Knowit Norge har et eksisterende system for registrering av ansattes CV er. Det er et webinterface for å registrere arbeidserfaring, kompetanseområder og informasjon om hver enkelt ansatt på en måte som er enkelt søkbart og lett tilgjengelig både for utviklere og selgere. Disse kan eksporteres som PDF, ODT eller DOCX format, for å sendes ut til potensielle kunder eller brukes internt i bedriften. Det er altså to grupper av brukere i dette systemet: Brukere: Utviklere registrerer sine CV er med detaljer som skal være likt formulert for alle ansatte. Forskjellig informasjon fylles inn i et system som lager en pent formatert CV. Administratorer: Selgere søker på relevante kompetanse og erfaringer og hente ut alle CV ene de trenger til et tilbud til en ekstern aktør. Dette gjøres i dag manuelt. 8

9 I dag eksisterer det ingen funksjonalitet i dette systemet for å samle sammen flere CV er til et team, eller et tilbud. Dette må gjøres manuelt, noe som gjør det vanskelig å ha oversikt over hvilke ansatte som er tilgjengelige, det gjør det tungvint for enkeltpersoner å ha oversikt over hvem som er inkludert i et tilbud, og ekstra tungvint å knytte personer til et tilbud, og presentere og sende dette rundt internt i bedriften. 2.4 Arbeidsmetodikk I og med at prosjektet er en skoleoppgave i regi av HiOA, som omfatter arbeidsverktøy som er i daglig drift og bruk hos Knowit, er det viktig å balansere både den akademiske tilnærmingen ved oppgaveskrivingen og den praktiske utviklingen av Knowit sin webapplikasjon. Vi har derfor valgt å organisere prosjektet ved hjelp av Scrum rammeverket, da det skal gi oss mulighet til å følge opp utviklingen både i henhold til oppgaven for høyskolen, og som del av kommunikasjon og kartlegging av utviklingen med Knowit. 3. Rammebetingelser 3.1 Suksesskriteria Under følger en liste over kriterier som er nødvendige for at prosjektet skal bli vellykket: - Oppdragsgiver må stille nødvendige ressurser tilgjengelig i alle de de forskjellige fasene av prosjektet - Prosjektmedlemmene må opprettholde aktiv kommunikasjon internt - Prosjektmedlemmene må holde seg til de mål og aktiviteter som gjelder i det gitte tidsrommet - Minimale endringer i forhold til planlegging 9

10 - Opprettholde aktiv dialog med oppdragsgiver og veileder 3.2 Antagelser Forutsetning: - Det forutsettes at kunden gir tilgang til kildekoden - Det forutsettes at funksjonene integreres i det eksisterende systemet - Tilgang til databasen for å implementere funksjonene korrekt - Løsningen skal utformes med plattformuavhengighet i fokus - Detaljert kravanalyse frem til design - Løsningen må være 100% web-basert - Oppdatering av eksisterende rutiner er ikke en del av prosjektet - Tidsfrist for fullført prosjekt er 26. mai - Arbeidet skal dokumenteres nøye i form av dokumenter og data-modeller, slik at systemet enkelt kan videreutvikles av andre i fremtiden - Det må lages gode testrutiner for funksjonaliteten, for å sjekke at alt virker og å se at det fungerer godt sammen med eksisterende funksjoner Begrensninger: CvReg bygger på Groovy og Grails, Javascript og LessCSS som sine hovedkomponenter. Det er også brukt HTML utvidet med spesielle «tags» for Grails. CvReg knytter seg mot MySQL og Crowd for henholdsvis database og brukere. Arbeidsmiljøet blir også begrenset til bruken av Windows 7 og Grails sin tilpasset versjon av Eclipse så medlemmene lettere kan hjelpe hverandre under utviklingen. 10

11 Knowit sine systemer og servere blir brukt for mye av arbeidsdokumnteringen. Dette forsikrer at prosjektet alltid har en fullverdig back-up av kildekode og dokumentasjon, og at arbeidsgiver har fullt innsyn i arbeidet. Gruppen har totalt 1600 arbeidstimer til rådighet for planlegging, utvikling og produksjon av prosjektrapporten, fordelt på 4 medlemmer og 20 arbeidsuker. 4. Kravspesifikasjon 4.1 Funksjonelle krav -Kun administrator skal kunne endre, slette, deaktivere og opprette Tilbud -Alle brukere skal ha mulighet til å lese alle tilbud -En bruker skal enkelt få en oversikt over alle tilbudene han er oppført i -Systemet skal kunne liste alle eksisterende, (aktive og inaktive) tilbud -Administratorer skal også kunne legge til og fjerne CV fra tilbud -Et tilbud skal ha følgende egenskaper: *Navn *Beskrivelse *Oppstartsdato *Sluttdato for tilbudet *Ansvarlige personer for tilbudet ved navn, (én til mange i CvReg) *En timeoutfunkjson som setter tilbudet inaktivt etter ønsket tid. 4.2 Ikke funksjonelle krav - Systemet må ha en tilgjengelighet på 99,5% - Responstid for nøkkelhandlinger bør ikke overstige 3 sekunder 11

12 - Web-grensesnittet må fungere mot Internett Explorer 9.0, Firefox 18.0, Google Chrome , og Opera Safari er ikke med i kvalitetssikringen, men skal være dekket av Google Chrome da begge bruker WebKit - Datasystemet skal sikres mot innsyn av uautoriserte personer 12

13 4.3 krav til dokumentasjon - Planlegging, organisasjon og oppfølging skal dokumenteres i Jira - Praktiske dokumentasjoner og veiledninger skal dokumenteres i Confluence - Kildekode og historikk skal dokumenteres via Git - All systemdokumentasjon skal lagres og oppbevares på Knowit sine servere 4.4 Krav til kvalitetssikring - Der det er hensiktsmessig skal det under utvikling skrives enhetstester for ny og endret kode - Prosjektgruppen utfører funksjonell testing underveis, minst før hvert demomøte og før milepælsleveranser - Prosjektgruppen gjennomfører demomøter for Knowit som avslutning av hver sprint - Knowit utfører akseptansetest og code-review etter milepælsleveranser 5. Mål og videre utvikling 5.1 Milepæl Vi har lagt opp en konkret plan på hva som skal utføres i løpet av de neste ukene. Dette er det absolutte minimumskravet for at prosjektet skal anses som vellykket, men skal ikke anses som en begrensning av utviklingen. Hvis milepælen kan bli nådd i god tid og med nok ressurser, vil prosjektet utvides med nye milepæler og oppgaver. Hovedmålet er å utforme en ny variabel kjent som «Tilbud» som skal integreres i databasen sammen med de andre funksjonene: Et Tilbud skal minimum inneholde: o o Navn på tilbudet Beskrivelse av tilbudet 13

14 o Oppstartsdato o Sluttdato (Når tilbudet skal inaktiveres?) o CVer inkludert i tilbudet En CV (bruker) skal være ansvarlig for tilbudet. Systemet skal kunne utføre følgende handlinger: o Liste over opprettede tilbud: skal være synlig for alle. Sorteres i: Aktive, inaktive, alle med Aktive som default. Evnt: Lage pen presentasjon med kort oppsummering av tilbudet & bilder av personer som er inkludert. o Legg til nytt tilbud: Synlig for Admin Knapp på liste over tilbud knapp i alle popup-lister over tilbud på ernkeltcv og CVliste o Redigere tilbud: Synlig for Admin endre navn på tilbud endre hvem som er ansvarlig for tilbud o Deaktiver tilbud: Synlig for Admin Kun tilgjengelig på tilbudssiden o Legg CV til tilbud: Synlig for admin Knapp på hver enkelt CV Knapp på liste over tilbud Knapp på liste over CVer o Fjern CV fra tilbud: Synlig for admin 5.2 Øvrige milepæler Så lenge første milepæl ikke skaper større utfordringer enn forventet, skal gruppen ha kapasitet til å utvide funksjonalitet utover hovedmålene. Hovedoppgaven utvikles med fokus på å gjøre fremtidig utvikling smidig. Følgende er tjenester som har blitt vurdert å implementeres hvis tid og ressurser tillater det: - Advarsel om at CV allerede er inkludert i annet, aktivt tilbud. - Funksjon for å laste opp vedlegg til et tilbud (pdf, bilder, video, etc ) 14

15 - Funksjon for å laste ned alle CVer i et tilbud som zipfil - Disse og andre mulige løsninger, endringer eller forbedringer som kan bli utviklet under prosjektet, blir eventuelt kartlagt under sprintmøter og dokumentert derfra. 15

16 16

17 VEDLEGG 2 KNOWIT CVREG GRUPPE 36 B R U K E R M A N U A L H O V E D P R O S J E K T VÅR FORFATTERE: NORDENGEN, THOMAS LARSEN, GLENRUBEN E. STEEN, SEBASTIEN-JEROME 17

18 FORORD Dette er e brukermanual for Cv-Reg, og da hovedsakelig for tilbudsmodulen som vi har utviklet, men denne manualen vil også ta for seg andre skjermbilder som er vesentlige for denne modulen. 18

19 INNHOLDSFORTEGNELSE forord BRUKERMANUAL Innlogging i systemet Liste over alle eksisterende tilbud Sortere tilbud Opprette nytt tilbud Vise detaljer Slette en deltager Legge til en deltager Redigerer et tilbud Endre ansvarlig for tilbud Slette et tilbud Legge en CV inn i et tilbud

20 BRUKERMANUAL 1.0 Innlogging i systemet Figur 1.1: Innlogging Det første skjermbildet en møter er innloggings skjermen, denne er veldig enkel, og tilbyr brukeren å taste inn en brukernavn og ett passord. Det er ingen egen innlogging for administratorer. Administratorer logger inn på samme måte, men deres ekstra administrator funksjoner vil ikke være synlig inne i systemet for vanlige brukere. Figur 1.2: Oversikt over CV 20

21 Når korrekt brukernavn og passord er tastet inn, vil brukeren bli sendt til siden som vist over. Dette er CV-oversikten til brukeren. I fra denne side er det mulig via knappen: + Tilbud øverst til venstre i menyen, kunne legge til den respektive CV-en til i et tilbud. Dette vil bli videre beskrevet senere i dokumentet. 2.0 Liste over alle eksisterende tilbud For å navigere seg videre til tilbuds-modulen, trykker en på Tilbud fanen, helt øverst menyen. Figur 2.1: Liste over tilbud Brukeren befinner seg nå i tilbuds-modulen, som gir en oversikt over alle eksisterende tilbud registrert i systemet. 21

22 Figur 2.2: Sortering 3.0 Sortere tilbud Over ser du et bilde av de tre sorteringsmulighetene som denne modulen har. Det er mulig å liste ut tilbud på tre hoved kategorier: Vis alle fanen vil gi deg en liste over alle eksisterende tilbudene, uavhengig om de er aktive eller ikke. Videre er det mulig å sortere på aktive og inaktive. Figur 3.1: Nytt tilbud 22

23 4.0 Opprette nytt tilbud For å opprette et nytt tilbud benyttes Nytt tilbud knappen. Denne vil laste inn en ny side venstre i skjermbildet. Dette er en oversikt over de alternativene denne funksjonen har. Figur 4.1: Nytt tilbud form For å opprette et nytt tilbud er brukeren nødt til å fylle ut de nødvendige feltene i registreringsformen. Foreløpig er det kun navn, startdato og sluttdato som er påkrevd for at et tilbud skal kunne bli opprettet. Klikk Legg til knappen, eller Avbryt knappen for å fortsette. 23

24 5.0 Vise detaljer Figur 5.1: Tilbud detaljer For å få opp informasjon om et tilbud, eller om du ønsker å redigere et tilbud, trykker en på et av tilbudene i oversikten. Dette vil laste inn informasjonen om det valgte tilbudet, samt å tilby brukeren å redigere den informasjonen som finnes om tilbudet. 6.0 Slette en deltager For raskt å lunne slette en deltager fra et tilbud, er et en veldig enkel måte å gjøre dette på. Det er ikke nødvendig å måtte gå inn på redigerings siden for å gjøre dette. En kan enkelt trykke på fjern knappen, som befinner seg til venstre for hvert deltagernavn. Denne knappen vil raskt fjerne en deltager fra tilbudet. Figur 6.1: Legg CV inn i tilbud 24

25 7.0 Legge til en deltager For å legge til en deltager i et valgt tilbud, er det bare å velge navnet til en person i listen, ved å trykke på pil ned tasten, som vist på bildet over. Der etter velger markerer du et ønsket navn ved å klikke på det. Til slutt trykker du på knappen: Legg til i tilbudet. Om litt vil listen over deltager oppdateres automatisk, og den nye personen vil være lagt til i tilbudet. 8.0 Redigerer et tilbud Figur 8.1: Rediger tilbud For å redigere et tilbud, trykk på Rediger tilbud knappen som vist over. 25

26 Figur 8.2: Rediger tilbud form I Rediger Tilbud siden vil du finne den totale oversikten over et tilbud, samt muligheten for å kunne endre på den informasjonen som er ønskelig. De feltene som kan være blanke om dette skulle være ønskelig er: Beskrivelse av tilbudet og tilbudsansvarlig. Resten, navn og fra og til dato kan ikke være blanke. Denne nødvendig informasjonen vil automatisk bli fylt inn i det du befinner deg på Rediger Tilbud siden. 26

27 9.0 Endre ansvarlig for tilbud Figur 9.1: Rediger ansvarlig For å velge tilbudsansvarlig, klikk på pil ned tasten under: Tilbudsansvarlig og marker så navnet til personen du ønsker at skal være den ansvarlige for tilbudet. Nå all ønskelig informasjon er oppdatert, klikk på enten: Oppdater eller Avbryt knappen for å gå videre Slette et tilbud Figur 10.1: Slett tilbud For å slette et tilbud trenger brukeren kun å befinne seg i hovedvinduet for modulen. Uavhengig av hvilken fane du befinner deg i, vil du kunne finne en slett knapp, til venstre i tabellen for hvert enkelt tilbud, (som vist i bildet over). 27

28 11.0 Legge en CV inn i et tilbud Figur 11.1: Valgt CV inn i tilbud For å legge til en CV i et tilbud, velg først fanen markert CV, og trykk så på + legg til knappen. Dette vil kalle opp et sprettoppvindu med muligheten til å legge den valgte CV-en inn et ønsket tilbud. Trykk så videre på pil ned knappen, under Eksisterende tilbud: for å få listet opp alle de eksisterende tilbudene i databasen. Marker så ønsket tilbud, og klikk på knappen Legg til. Til slutt klikker en på OK knappen nederst i høyre gjønet. 28

29 VEDLEGG 3 KNOWIT CVREG GRUPPE 36 T E S T R A P P O R T H O V E D P R O S J E K T VÅR FORFATTERE: NORDENGEN, THOMAS LARSEN, GLENRUBEN E. STEEN, SEBASTIEN-JEROME 29

30 INNHOLDSFORTEGNELSE 1.0 Innledning Mål for testene Funksjonalitet: Responsivitet: Funksjonalitet med forskjellige nettlesere: Funksjonalitet på mobile enheter: VERKTØY OG PROGRAMVARE BENYTTET Maskinvare: Hvilke tester ble utført Testing i utviklingsfasen Testing av applikasjonen på mobile enheter Funksjonalitetstest TESTRESULTATER Funksjonalitetstesting: TEST AV CvReg TILBUD... Error! Bookmark not defined. 30

31 1.0 INNLEDNING Dette dokumentet gir leseren en oversikt over hvilke tester som ble utført, og resultatene disse testene ga. Testene har blitt gjort kontinuerlig under utviklingen. 2.0 MÅL FOR TESTENE Med våre tester har vi prøvd å teste visse mål som vi mener er viktige, og som forhåpentligvis ville avdekke viktige feil og mangler. 2.1 Funksjonalitet: Sørge for at den generelle funksjonaliteten for vår modul er på plass, og at applikasjonen i sin helhet, det vil også si de delene av applikasjonen som benytter vår modul på én eller annen måte, fungerer som de skal. 2.2Responsivitet: Det er viktig at applikasjonen generelt ikke blir for treg, med tanke på større databasekall og utskrift av oppføringer i databasen. 31

32 2.3 Funksjonalitet med forskjellige nettlesere: Det benyttes i dag mange forskjellige nettlesere, og veldig sjeldent fungerer alle nettsider likt i alle nettlesere de blir benyttet av. Derfor er det viktig at vi sørger for lik funksjonalitet i alle nettlesere, og sikre at de samme funksjonene er tilgjengelige uavhengig av nettleser brukeren benytter. 2.4 Funksjonalitet på mobile enheter: Mobil funksjonalitet inngår ikke i vårt ansvarsområdet, og vil ikke bli testet i særlig stor grad av oss. Applikasjonen må for det første på nett for at dette skal la seg gjøre, noe vi ikke var en del av utviklingsplanen. 3.0 VERKTØY OG PROGRAMVARE BENYTTET De forskjellige testene ble utført med forskjellige datamaskiner og forskjellige nettlesere. Dette for å sørge for at applikasjonen fungerer som tiltenkt på alle maskiner, og uavhengig av nettleser. Maskinvare: Vi har kun benyttet Microsoft Windows under utviklingen og testingen. Vi har ingen krav som definerer hvordan applikasjonen skal fungerer på andre operativsystemer, men da applikasjonen er basert på et rammeverk, vil nok ikke dette være et problem. 32

33 4.0 HVILKE TESTER BLE UTFØRT 4.1 Testing i utviklingsfasen Denne applikasjonen har blitt utviklet iterativt, det vil si at vi gjennom hele prosjektet har prøvd å forbedre den koden i tidligere har produsert, med et ønske om å oppnå en så effektiv og fungerende kode som mulig. Dette har også sørget for at vi gjennom hele utviklingen av applikasjonen, har verdt nødt til å teste den koden som har vert utviklet gjentatte ganger. Et problem vi støtte på med tanke på listingen av tilbudene på hovedsiden for modulen, var at denne prosessen med å søke igjen om hele databasen for så å sortere dette etter et spesifikt ønske, viste seg å være vanskeligere å kode effektivt enn vi først hadde tenkt. Gjennom hele siste halvdel av prosjektet var dette en av de tingene vi hadde i fokus å effektivisere, og som testresultatene forhåpentligvis kommer til å bevise at var vellykket. 4.2 Testing av applikasjonen på mobile enheter Det har ikke blitt foretatt noen tester på mobile enheter av hovedsakelig to grunner. Den ene er at CvReg har kun blitt utviklet som en desktop basert web-applikasjon. Det andre er at applikasjonen kun har blitt utviklet lokalt på PCer, og har ikke blitt oppdatert over nett, slik at det ikke har vært mulig å få testet den nye modulen på mobile enheter. 4.3 Funksjonalitetstest Vi har testet applikasjonen i flere forskjellige nettlesere, da applikasjonen (som tidligere beskrevet), benytter mange forskjellige teknologier innenfor nettutvikling, noe som kan gi betydelig forskjeller i oppførselen av applikasjonen. Vi har da testet den generelle funksjonaliteten i forskjellige nettlesere, for å forsikre oss om at de forskjellige funksjonene, og det generelle designet både ser likt ut, men også oppfører seg likt. 33

34 5.0 TESTRESULTATER Videre følger en skjematisk oversikt over de forskjellige resultatene av testingen vi har utført på applikasjonen, disse testene er utført i en naturlig rekkefølge av handlinger: 5.1 Funksjonalitetstesting: View Test utført Chrome Firefox Opera Main view - > Tilbud Innlasting av tilbuds view ok ok ok Benytte sorteringsfunksjonalitet for aktive og inaktive tilbud Klikke på knapp for å opprette nytt tilbud Klikke på knapp for å lagre nytt tilbud, etter at inndata er ferdig inntastet Oppdatering av ny liste over tilbud etter lagring av nytt tilbud Klikking på tilbud i listen over tilbud for uthenting av informasjon om tilbudet ok ok ok ok ok ok ok ok ok ok ok ok treg treg treg Fjerne person fra et eksisterende tilbud treg treg treg 34

35 Legge en person inn i et tilbud treg treg treg Trykke på knapp Rediger tilbud for eksisterende tilbud ok ok ok Oppdatere tilbud med ny inndata ok ok m/ falsk feil ok Slette tilbud med eksisterende deltagere ok ok ok Slette tilbud uten eksisterende deltagere ok ok ok Main -> CV Trykke på tilbudsknapp venstre i menyen ok ok ok Legge til nå valgte CV inn i ønsket tilbud via knapp ok ok m/ falsk feil ok m/ falsk feil I noen av testene virket modulen som den skulle, allikevel kom det feil av typen «Ajax call failed». 35

36 VEDLEGG 5 - USE CASE Use Case: Legg til CV i tilbud Aktører: Administrator Betingelser:Admin har opprettet nytt tilbud Trigger: Admin skal legge til CV-er i tilbud - NORMAL HENDELSESFLYTT 1. Admin logger inn 2. Admin trykker på Tilbud 3. Admin velger relevant tilbud fra liste 4. Admin velger CV fra drop down liste 5. Admin trykker på Legg til CV - VARIASJONER/Feilsituasjoner 1a. Admin får ikke logget inn 3a Relevant tilbud er ikke tilgjengelig 3b Informasjon om tilbud kommer ikke opp når tilbud velges fra listen 4a Navn til relevant CV kommer ikke opp 5a Tilbud blir ikke oppdatert med ny CV 36

37 VEDLEGG 6 - SEKVENSDIAGRAM 37