Use Case Specification - Add a comment or reference

Name of Use Case: Use Case Specification - Add a comment or reference

Project: e-Portfolio for Lifelong Learning Reference Model

Author	Alan Paull
Creation Date	15 July 2006
Last Update Date	17 July 2006
Version	0.2
Diagram	Use Case diagram

Description
This Use Case describes how an adviser makes comments on Personal Statement items. These comments might include references for use in an HE application, general comments on a whole Personal Statement or individual comments on a Personal Statement item.

Narrative

This Use Case starts when the adviser views a Personal Statement on screen to comment on it.

The adviser selects an option to add a comment about the Personal Statement to the learner's e-Portfolio. The system presents the adviser with space for his or her comment on screen. The adviser keys the comment and selects a save option. The system saves the comment and links it to the Personal Statement item.

The Use Case ends when the comment and link have been saved.

Conditions

Preconditions	Learner has created a Personal Statement. Adviser is already logged in, so known to the system. Adviser has been given access to the Personal Statement items by the learner and this has been checked by the system. Adviser has been notified of the permission by the e-Portfolio engine. The Personal Statement item is already on screen.
Successful end condition	Comment and link between Personal Statement item and comment saved.
Failed end condition	Adviser cancels the operation.

Primary Actors	AdviserTutor
Secondary Actors	e-Portfolio enabled repository for learners data

Trigger

Adviser selects option to make a comment against the Personal Statement item.

Included Use Cases

None

Main Flow

Advisere-Portfolio engine
1. Views the Personal Statement item.2. Selects option to make a comment against it.3. Presents an on screen template for the comment.4. Keys and edits comment.5. Selects option to save the comment.6. Creates a record for the comment, including a link to the Personal Statement item7. Creates a notification to the learner that a comment has been made.8. Confirms that comment has been saved successfully. End of Use Case.

Alternative scenario: Adviser writes a reference.
Conditions

Preconditions	Learner has created a Personal Statement. Adviser is already logged in, so known to the system. Adviser has been given access to the whole Personal Statement by the learner and this has been checked by the system. Adviser has been notified of the permission by the e-Portfolio engine. The whole Personal Statement is already on screen.
Successful end condition	Comment and link between the whole Personal Statement and reference saved.
Failed end condition	Adviser cancels the operation.

Advisere-Portfolio engine
1. Views the whole Personal Statement.2. Selects option to create a reference against it.3. Presents an on screen template for the reference.4. Keys and edits reference.5. Selects option to save the reference.6. Creates a record for the reference, including a link to the Personal Statement.7. Creates a notification to the learner that a reference has been made. This is done only when the reference is first saved, not on subsequent edits.8. Confirms that reference has been saved successfully. End of Use Case.

Branching Action for alternative scenario

The approver does not have to be the adviser that wrote the reference, but could be for instance the Head of Sixth Form.

Advisere-Portfolio engine
5.1 Selects option to approve the reference.5.2 Updates the record for the reference to show that it has been approved.5.3 Creates a notification to the learner that the reference has been approved.5.4. Confirms that changes have been saved successfully. End of Use Case.