Software Design Process A Process is a set

Software Design Process • A Process is a set of related and (sequenced) tasks that transforms a set of input to a set of output. Inputs requirements specifications Design Process sequence of tasks Outputs design specifications Is this diagram very clear? What does the rectangle, arrow, or the circle mean? ------ What about the coloring and the lables?

Talking About Design (indirectly) • We will describe: – Notations used to describe design activities – Design activities • Sequence of processing • Information (data) involved in the processing • Pointing out general design techniques: – Abstraction (& modeling) – Refinement (decomposition)

UML’s Activity Diagram • We use Activity Diagram to “model” the activities (sequence of tasks) in a system – – main components (& its functionality) relationship (interactions) among components • Activities (eventually decomposed down to functional actions, which are “atomic” in nature) • Activity Diagram also depicts the “Flow” of 1. Control 2. Data (information)

UML’s Activity Diagram • Software Design Process itself may be depicted or “modeled” with UML’s Activity Graph Diagram since a Design Process is Token composed of: in 1. Activities or Tasks • begin Node Represented as action nodes (rounded rectangles) 2. Flow (of control & data) • Activity 1 Represented as arrows This Activity Diagram depicts a “virtual machine” behavior of the process where there are tokens which run through the edges. 1) An action node begins Its execution when the tokens from all its incoming edges arrive. (implied synchronization) 2) When an action node begins execution it consumes all these tokens. 3) After a task is completed, the task node sends a token out on each of its outgoing edges. Activity 2 Activity 3 Activity 4 Token in End Node

UML’s Activity Diagram • Software Design Process may be depicted with UML’s Activity Graph Diagram since a Design Process is composed of: Token 1. Activities or Tasks • Represented as action nodes (rounded rectangles) 2. Flow (of control and data) • Read Req. Doc. Represented as arrows analyze Requirements This Activity Diagram depicts a “virtual machine” behavior of the process where there are tokens which run through the edges. 1) An action node begins Its execution when the tokens from all its incoming edges arrive. (implied synchronization) 2) When an action node begins execution it consumes all these tokens. 3) After a task is completed, the task node sends a token out on each of its outgoing edges. in begin Node prioritize Requirements Review Requirements Token in End Node

Decision and Merge Nodes • Besides the activity nodes and the edges, we need a mechanism to depict alternative flow based on some decision. 1. 2. 3. Decision node Guard Merge node 1) a decision node has a single entry edge, but multiple edges leaving it 2) a guard labels the “condition” that controls the flow through the edge (path) 3) a merge node has multiple entering edges but one exit edge A) If a token is available on any of the merge entering edges, it is passed to the leaving node. B) If a token is available on the decision node’s entering edge, a decision is made and a token is passed to the edge with the guard that depicts the decision Why do we need merge node here ? Req. Spec. Review Write Req. spec. Review Req. spec. [non-concur] [concur] Approve Req. Spec. Activity Symbol

Fork and Join in Control Flow (Explicit Synchronization) Note : this is a bit like the Petri net Read Req. Doc. analyze Requirements When a token is available on the incoming edge of a FORK Node (thick line), the token is duplicated and posted on all the outgoing edges of FORK prioritize Requirements Review Requirements When tokens are available on ALL the incoming edges of a JOIN Node (thick line), a token is placed on the outgoing edge Also: Read page 39 of your text on “flow final node”

Data tokens and Data flow • Data may flow through an Activity Diagram. Data or object are shown as a rectangular figure, object node: Req. Doc [reviewed] state of data Write Req. spec. Written Spec. for review Req. spec. reviewed spec. • Data tokens flow may be represented in the form of input pin and output pin: [non-concur] [concur] concurred Spec. Approve Req. Spec. Req. Doc [approved]

process name Activity Parameters What about the input & output of the process? Data name and data type Req. Spec. Review Process req. Notes: Docs appr. Req. Spec : Docs req. Notes - A process consumes inputs and produces outputs. - The inputs and outputs of a process may be represented as “parameters” to and from the process. - These parameters, in form of data or object node, are placed on the boundary of the activity symbol Note that we have listed the parameters at the upper left corner of the Activity Symbol Write Req. spec. Written Spec. for review Req. spec. reviewed spec. [non-concur] concurred Spec. [concur] Approve Req. Spec. appr. Req. Spec approved Spec.

When to Use Activity Diagram? May be used to depict the design (especially a description of a set of actions) at either – – High level (architectural and intermediate model) or Low level (pseudo code level) depicting: 1. 2. 3. (See page 45 of your text) Activity Control flow Data and data flow Also, note that an action node in an activity diagram may itself be expanded into an activity diagram ----- giving us the capability of further refinement

Some Guideline to Activity Diagram Use Activity Diagram to “model” the dynamic (or flow) process. • • Draw the flow control from left to right and from top to bottom. Name activity nodes with verb phrases. Name data nodes and data pins with noun phrases. Use the guard and labels on every output edge of a condition node. • Use data flow, and not both control and data flow, whenever data flow alone can suffice. • Make sure that all flows entering a node can provide tokens concurrently, so that no deadlock can occur - - - or use merge nodes. Noted: the condition node and the merge node syntax, diamond, being the same, is NOT appealing ---- room for improvement

“High Level” Software Design Process using Activity Diagram (Example) Software Design Process Needs & Wants: Doc Design Document: Doc Needs & Wants Product Design Analysis Product Design “Resolution” SRS Engineering Design Analysis Engineering Design Resolution Design Document

General Engineering Design Technique • 2 main steps: – Analysis of problem : Breaking Down, Understanding and clearly Defining the Problem – Design the solution : Finding the Solution(s) to the (Sub-)Problem(s) and Constructing the overall solution 1. Understand the problem and clearly defining it. (very important) -------------------------1. Develop possible solution(s) 2. Evaluate the potential solutions 3. If there is a “best” selection, choose it; otherwise iterate through step 2 again. 4. Finalize and document the chosen solution

Software Engineering Design (in Activity Diagram) Software Engineering Design SRS : Doc Design Document: Doc SRS Engineering Design Analysis clear Problem Statements Note: 1. Analysis is understanding the SRS Generate Possible Solutions Candidate Solutions Evaluate Candidate Solutions Select Solution Note: 1. Generate more than 1 solution 2. Process is iterative [else-no solution] [selected solution] Selected Solution finalize/document the Solution Design Document

Two Levels of Software Engineering Design • Software Engineering Design (levels): – Architectural Level – Detailed Level • The previous Activity Diagram is “repeated” for each of the 2 levels, with different inputs and outputs. – SRS (analyzed) is the input for Architectural Design Level – Selected architectural design specification is the output for this level – Architectural design specification combined with SRS is the input to the Detail Design level – Detailed Design analysis analyzes the architectural design specification – Detailed design document is the output for Detail Design level Recall: - “Analysis” : breakdown, understand further define - “Design” : propose solution alternatives; choose the solution; refine it; define it Redraw the previous activity diagram to depict the 2 -level engineering design.

Software Design Management • Designing Software is an activity that resembles a project in itself. – Operations (regular recurring work - - - payroll, monthly finance, etc. ) – ** Project (one time effort that starts and achieves specific goal) • Design Activities needs to be managed as a project with: – – – Planning Organizing Staffing Tracking (monitoring) Leadership-ing (adjusting and redirecting) Management of any project is very “iterative” between tracking and leading. But the process may also feedback to planning and re-adjust the plan

Managing Design Work • Managing any project depends a lot on how the work is decomposed – Design may be viewed as: – Product Design • Product Design Analysis: – Understanding the overall customer problem – Understanding the details of customers’ needs and wants • Product Design Resolution: – Reviewing, clarifying and prioritizing the overall problems and details – Defining, documenting, & agreeing on the problem and details in SRS document – Engineering Design • Engineering Design Analysis: – Study and analyze the SRS • Engineering Architectural Resolution: – Generating and documenting a high level architectural design document • Engineering Detailed Design Resolution: – Generating and documenting a detailed designed document This is the Work Breakdown Structure (WBS) • Management Activities with this view of Design - WBS: – Planning the following: • Estimating of time needed • Estimating resources needed • Putting together a schedule • Assessing risks – Organizing the project • Team structure • Authority structure – Tracking (monitoring) • Schedule • Design outputs-quality – Leading (adjusting) • Providing direction & support