Difference between revisions of "Use cases"

From ICA-AtoM
Jump to navigation Jump to search
Line 1: Line 1:
 
[[Main Page]] > [[System Requirements]] > Use cases
 
[[Main Page]] > [[System Requirements]] > Use cases
  
Use cases describe scenarios from the end-users' perspective of their day to day activities. Individual use cases are clustered around the same broad categories as the functional requirements:
+
== Purpose ==
  
*[[USC-1 Establish a system of control]]
+
Use cases describe interactions with the application from the end-users' point of view. Use cases provide tests of the application's functionality and identify issues that need to be addressed in future releases.
*[[USC-2 Add / edit content]]
 
*[[USC3 Translate content]]
 
*[[USC-4 Access content]]
 
*[[USC-5 Import / export content]]
 
*[[USC-6 Administer the system]]
 
  
 +
 +
== Structure ==
 +
 +
Use cases are clustered around the same broad categories as the functional requirements. Like the latter, use cases are organized hierarchy with high-level scenarios broken down into more specific tests (sub- and sub-sub-cases). To facilitate cross-references and links, each case has been assigned an alpha-numeric code: the alpha prefix designates its type (USC = use case), the number establishes its position in the hierarchy. Six main use cases have been identified:
 +
*[[USC-1 | USC-1 Implement a system of control]]
 +
*[[USC-2 | USC-2 Add / edit content]]
 +
*[[USC-3 | USC-3 Translate content]]
 +
*[[USC-4 | USC-4 Access content]]
 +
*[[USC-5 | USC-5 Import / export content]]
 +
*[[USC-6 | USC-6 Administer the system]]
 +
 +
 +
== Use case actors ==
  
 
The following generic actors are invoked in the use cases:
 
The following generic actors are invoked in the use cases:
Line 18: Line 26:
 
*Researcher: a person who accesses the archival materials held by Institutions.
 
*Researcher: a person who accesses the archival materials held by Institutions.
  
 +
 +
== Information ==
  
 
Each use case includes the following information:
 
Each use case includes the following information:
Line 24: Line 34:
  
 
|- valign="top" align="left" style="background:#00008B; color:white"
 
|- valign="top" align="left" style="background:#00008B; color:white"
| colspan="3" | Use case name
+
| colspan="3" | USC-x.x.x (unique tracking number assigned to case).
  
 
|- valign="top" align="left"
 
|- valign="top" align="left"
 
| width="100" rowspan="4" style="background:silver" | Summary
 
| width="100" rowspan="4" style="background:silver" | Summary
! width="150" | ID number
+
! width="150" | Use case name
| width="700" | USC-x.x.x (unique tracking number assigned to requirement)
+
| width="700" | Descriptive name assigned to use case
  
 
|- valign="top" align="left"
 
|- valign="top" align="left"
Line 44: Line 54:
 
! Secondary actor
 
! Secondary actor
 
|  
 
|  
Other actors involved in the scenario.
+
Other actors involved in the scenario in less central roles.
  
 
|- valign="top" align="left"
 
|- valign="top" align="left"
Line 89: Line 99:
  
 
|- valign="top" align="left"
 
|- valign="top" align="left"
! style="background:silver" | Diagrams
+
| style="background:silver" | Diagrams
 
| colspan="2" |  
 
| colspan="2" |  
 
Work-flow or other diagrams illustrating the scenario.
 
Work-flow or other diagrams illustrating the scenario.
  
 
|}
 
|}
 +
 +
Note that most of this detail will only be found at the lower-level cases. Higher-level cases will typically only include the case name, number, and overview, with links to the lower-level sub-requirements.
 +
 +
 +
== Index ==
 +
 +
*[[USC-1 | USC-1 Implement a system of control]]
 +
*[[USC-2 | USC-2 Add / edit content]]
 +
*[[USC-3 | USC-3 Translate content]]
 +
*[[USC-4 | USC-4 Access content]]
 +
*[[USC-5 | USC-5 Import / export content]]
 +
*[[USC-6 | USC-6 Administer the system]]

Revision as of 17:18, 5 May 2008

Please note that ICA-AtoM is no longer actively supported by Artefactual Systems.
Visit https://www.accesstomemory.org for information about AtoM, the currently supported version.

Main Page > System Requirements > Use cases

Purpose

Use cases describe interactions with the application from the end-users' point of view. Use cases provide tests of the application's functionality and identify issues that need to be addressed in future releases.


Structure

Use cases are clustered around the same broad categories as the functional requirements. Like the latter, use cases are organized hierarchy with high-level scenarios broken down into more specific tests (sub- and sub-sub-cases). To facilitate cross-references and links, each case has been assigned an alpha-numeric code: the alpha prefix designates its type (USC = use case), the number establishes its position in the hierarchy. Six main use cases have been identified:


Use case actors

The following generic actors are invoked in the use cases:

  • Institution: a body having custody and control of archival materials.
  • Archivist: a staff member of an Institution.
  • Network: a group of Institutions sharing descriptions and other information relating to archival materials.
  • Administrator: a person responsible for the application of an Institution or Network.
  • Researcher: a person who accesses the archival materials held by Institutions.


Information

Each use case includes the following information:

USC-x.x.x (unique tracking number assigned to case).
Summary Use case name Descriptive name assigned to use case
Overview

Brief description of the scenario.

Primary actor

The main actor involved in the scenario.

Secondary actor

Other actors involved in the scenario in less central roles.

Description Preconditions

Other use cases whose completion is a precondition for the current case.

Trigger

The event that initiates the current case.

Successful outcome

The outcomes of a successful resolution of the scenario.

Main scenario

Step-by-step breakdown description of the scenario ("Scenario A").

Exceptions / variations

Other possible variations, including unsuccessful outcomes ("Scenario B", "Scenario C" etc).

Requirements Functional requirements

Links to associated functional requirements (FNC-x).

Metadata requirements

Links to associated metadata requirements (MTD-x).

Technical requirements

Links to associated technical requirements (TCN-x).

Diagrams

Work-flow or other diagrams illustrating the scenario.

Note that most of this detail will only be found at the lower-level cases. Higher-level cases will typically only include the case name, number, and overview, with links to the lower-level sub-requirements.


Index