Gebrekkig en incomplete requirements zijn een veelgenoemde oorzaak voor uit de hand gelopen IT projecten. Binnen de software design discipline zijn daarom steeds meer methodes ontwikkeld om requirements beter vast te leggen en beheersen.Voorbeelden daarvan zijn UML gebaseerde analyse, interactie ontwerp, tracebility en change management. Veel requirements management tools hebben deze ontwikkelingen echter niet kunnen volgen, waardoor development start zonder een helder beeld van het beoogde resultaat.

Zijn ontwerpen in de praktijk nog wel te volgen?

Veelal worden requirements opgesteld met behulp van Word, Excel, en wellicht met enkele diagrammen uit een tool als Enterprise architect of Visio. Ook worden steeds meer schermprototypes gemaakt, in tools zoals Axure.Het probleem met textuele requirements is dat deze vatbaar zijn voor meerdere interpretaties. Lange requirements documenten bieden de lezer vaak geen context en zijn lastig om te begrijpen en te controleren op compleetheid. Schermprototypes zijn eenvoudiger te begrijpen, maar modelleren geen systeem gedrag en zijn kostbaar om te maken vanwege de mate van detail.

Hoe kunnen ontwerpen toegankelijker worden gemaakt?

Use case (scenario) modellering kan hier uitkomst bieden omdat alle interactie tussen het systeem en de gebruiker wordt uitgewerkt. Het ontwerp wordt ook toegankelijker en makkelijker te controleren  door  de visuele representaties van uses cases in bijvoorbeeld het context diagram en activity diagrams. De volledigheid van een ontwerp kan o.a. worden gecontroleerd door requirements te koppelen aan Use cases en Use cases aan (prototype) schermen. In de praktijk worden Use cases echter vaak niet uitgewerkt omdat dit in Word en de losse tools arbeidsintensief is. Tevens is het aanbrengen en onderhouden van relaties tussen requirements en Use cases eveneens arbeidsintensief, foutgevoelig en lastig te controleren. Dit is exact de behoefte waar Topteam op inspeelt.

Requirements modelleren in Topteam

Topteam is een client-server applicatie met een Windows interface. Na inloggen toont de applicatie de project tree met o.a. requirements, Use cases, schermen, woordenlijst, diagrammen (zie afbeelding 1). Tevens zijn er speciale doorsnedes o.a. voor het bewerken van requirements, Use cases, issues/RFC’s, Testcases en projecten.

Requirements kunnen worden geïmporteerd vanuit Word of Excel, waarbij ook kenmerken als type (b.v. non functioneel) en prioriteit mee worden genomen. Requirements kunnen ook direct in Topteam worden ingevoerd, waarbij de gebruiker de keuze heeft tussen een Word achtige interface (genummerde lijst met nivo’s) of een lijst/boom interface. Dit is waar de meeste requirements management tools stoppen. Topteam bevat echter ook een uitgebreide ondersteuning voor het verder vertalen van de requirements naar Use cases en daar vervolgens weer schermen aan te koppelen. Op basis van de Use case lijst kunnen één of meerdere Context en Use case diagrammen worden gegenereerd.

Wijzigingen in het Use case diagram, bijvoorbeeld het tekenen van een relatie tussen een Actor en een Use case, worden ook bijgewerkt in de Use cases en vice-versa. De requirements kunnen eenvoudig aan Use cases worden gekoppeld door eenvoudigweg een lijn tussen beiden te trekken in het “Tracebility diagram”. Hierdoor heb je als ontwerper bij het beschrijven van de Use Case de requirements direct bij de hand.

Krachtige functionaliteit rondom Use cases

Het bewerken van Use cases, en met name Use case scenario’s, is waar Topteam in excelleert.  Het uitwerken van de scenario’s gebeurt in een Word-achtige interface die razendsnel werkt en waarbij het systeem begrijpt wat wordt ingevoerd.  Zo worden Actoren, schermen, andere Use cases en begrippen automatisch herkend of kan de gebruiker deze kiezen uit een lijst. Op deze manier wordt ook de traceability links tussen Use cases en requirements, Use cases en schermen vastgelegd.

Kers op de taart is het Activity diagram, eventueel met swimlanes,  dat de tool geheel automatisch genereert op basis van de scenario’s. De gebruiker kan projecten, releases en iteraties definiëren en hier de requirements en Use cases aan koppelen. Hierbij bieden de vrijwel onbegrenste querymogelijkheden van de tool een helpende hand, doordat zowat elke doorsnede door de repository kan worden gemaakt, en alle gevonden items vervolgens in één keer kunnen worden bewerkt (b.v. koppelen aan een release).

Solide versiebeheer en Word ontwerpen genereren

Topteam houdt automatisch van vrijwel alles een versiehistorie bij, waarbij voor iedere wijziging een nieuwe versie wordt aangemaakt. Zo kan je altijd teruggevallen op een oudere versie. En kunnen verschillen tussen versies worden bekeken. Tevens kunnen projectbrede baselines worden aangemaakt.

Topteam kan ontwerpen in een Word document generen door een doorsnede te maken uit de repository.  Standaard worden er maar liefst 60 templates meegeleverd die geheel naar eigen hand aan te passen zijn. Hierbij kan ook gebruik worden gemaakt van de tracebility links, bijvoorbeeld om bij een Use case gerelateerde requirements en schermen te tonen.

Tevens biedt topteam de mogelijkheid het hele ontwerp te exporteren naar Microsoft TFS waardoor de projectmanager en developer direct kan plannen en ontwikkelen op basis van Use cases.

Volgende week deel 2 van de review, met daarin de beperkingen, praktijkervaring en conclusie!