Difference between revisions of "Use cases"

From ICA-AtoM
Jump to navigation Jump to search
Line 3: Line 3:
 
== Purpose ==
 
== 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.
+
Use cases describe interactions with an application from the end-users' point of view in a variety of ''what if'' scenarios. Use cases:
  
 +
*Identify [[Functional requirements|functional]], [[Metadata requirements|metadata]], and [[Quality requirements|quality requirements]].
  
== Structure ==
+
*Test the application's current functionality.
 +
 
 +
*Identify issues that need to be addressed in future releases.
 +
 
 +
*Support development of user-end documentation.
 +
 
 +
 
 +
== Organization ==
 +
 
 +
Use cases are clustered around the same broad categories as the [[Functional requirements|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 (UC = use case), the number establishes its position in the hierarchy. Six main use cases have been identified:
  
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-1 | USC-1 Implement a system of control]]
 +
 
*[[USC-2 | USC-2 Add / edit content]]
 
*[[USC-2 | USC-2 Add / edit content]]
 +
 
*[[USC-3 | USC-3 Translate content]]
 
*[[USC-3 | USC-3 Translate content]]
 +
 
*[[USC-4 | USC-4 Access content]]
 
*[[USC-4 | USC-4 Access content]]
 +
 
*[[USC-5 | USC-5 Import / export content]]
 
*[[USC-5 | USC-5 Import / export content]]
 +
 
*[[USC-6 | USC-6 Administer the system]]
 
*[[USC-6 | USC-6 Administer the system]]
  

Revision as of 13:11, 11 July 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 an application from the end-users' point of view in a variety of what if scenarios. Use cases:

  • Test the application's current functionality.
  • Identify issues that need to be addressed in future releases.
  • Support development of user-end documentation.


Organization

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 (UC = 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.

Actor

The main actor(s) involved in the scenario.

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

USC-1 Implement a system of control


USC-2 Add / edit content


USC-3 Translate content


USC-4 Access content


USC-5 Import / export content


USC-6 Administer the system