Introduction to SoDAIntroduction to SoDA

Copyright, 2001 © Jerzy R. Nawrocki

Jerzy.Nawrocki@put.poznan.pl

www.cs.put.poznan.pl/jnawrocki/mse/require/

Requirements EngineeringRequirements Engineering

Lecture Lecture 99

Requirements EngineeringRequirements Engineering

Lecture Lecture 99

J. Nawrocki, Requirements Eng. (9)

IntroductionIntroductionIntroductionIntroduction

SoDA = Software Documentation Automation

SoDA

RequisiteProClearQuestTeamTestClearCaseRose DiagramsFile SystemMS Project

Document or report

Status of: requirements, design, test or defects

J. Nawrocki, Requirements Eng. (9)

SoDA information structureSoDA information structureSoDA information structureSoDA information structure

Domain

Class

Attribute Attribute

Class

Domain

J. Nawrocki, Requirements Eng. (9)

Getting Started WizardGetting Started WizardGetting Started WizardGetting Started Wizard

Select a template

Choose directory

Select the source

Generate a report

J. Nawrocki, Requirements Eng. (9)

Creating a new templateCreating a new templateCreating a new templateCreating a new template

J. Nawrocki, Requirements Eng. (9)

SoDA CommandsSoDA CommandsSoDA CommandsSoDA Commands

OPEN – opens an information source

DISPLAY – displays a section of document

REPEAT – repeats for each element

LIMIT – limits the displayed objects

J. Nawrocki, Requirements Eng. (9)

OPEN CommandOPEN CommandOPEN CommandOPEN Command

Like open a file: establishes the context for other SoDA commands.

Name project_directory

Class File System -> Directory

Arguments Filename: C:\PROJECTS

J. Nawrocki, Requirements Eng. (9)

Selecting a sourceSelecting a sourceSelecting a sourceSelecting a source

J. Nawrocki, Requirements Eng. (9)

OPEN CommandOPEN CommandOPEN CommandOPEN Command

J. Nawrocki, Requirements Eng. (9)

REPEAT CommandREPEAT CommandREPEAT CommandREPEAT Command

Creates sections for each object found in source.

Create a section for each directory that starts with ‘ROSE’

Select Relationship project_directory->Contents

Where Is A Directory

And Where SimpleName LIKE ^ROSE

J. Nawrocki, Requirements Eng. (9)

REPEAT CommandREPEAT CommandREPEAT CommandREPEAT Command

And Where expressions:

=!=>>=<<=LIKENOT LIKE

J. Nawrocki, Requirements Eng. (9)

REPEAT CommandREPEAT CommandREPEAT CommandREPEAT Command

Metacharacters for LIKE:

. any single character

reflexive closure

^ beginning

$ end

[ ] set of characters

\ single quate (e.g. \.)

J. Nawrocki, Requirements Eng. (9)

DISPLAY CommandDISPLAY CommandDISPLAY CommandDISPLAY Command

Create a section for each directory in the project directory (OPEN, REPEAT).

Select all_directories > SimpleName

Modifiers

Single Paragraph? yes (default)

J. Nawrocki, Requirements Eng. (9)

LIMIT CommandLIMIT CommandLIMIT CommandLIMIT Command

Limits objects in the source:

Select Object all_directories > SelfWhere Is A FileAnd Where SimpleName LIKE ^ROSE

Special LIMIT commands:OMIT – omits a section when there is no

object satisfying the LIMIT conditionOTHERWISE – puts an alternative text

J. Nawrocki, Requirements Eng. (9)

A complete templateA complete templateA complete templateA complete template

J. Nawrocki, Requirements Eng. (9)

SummarySummarySummarySummary

SoDA is a document/report generating tool

It has four commands:

OPEN

REPEAT

DISPLAY

LIMIT

J. Nawrocki, Requirements Eng. (9)

Further readingsFurther readingsFurther readingsFurther readings

Using Rational SoDA for Word, Version 2001.30.00

• RequisitePro domain

J. Nawrocki, Requirements Eng. (9)

HomeworkHomeworkHomeworkHomework

• Prepare a document template for SDS requirements

J. Nawrocki, Requirements Eng. (9)

Quality assessmentQuality assessmentQuality assessmentQuality assessment

1. What is your general impression? (1 - 6)

2. Was it too slow or too fast?

3. What important did you learn during the lecture?

4. What to improve and how?