Difference between revisions of "Application UseCase Template"

From Earth Science Information Partners (ESIP)
 
(3 intermediate revisions by 2 users not shown)
Line 6: Line 6:
 
  <number>={1, 2, 3, ...}
 
  <number>={1, 2, 3, ...}
 
  <letter>={a, b, c, ...}
 
  <letter>={a, b, c, ...}
 +
Please complete as many sections as possible down to the section entitled:
 +
"Use Case Elaboration"
  
==Purpose==
+
==Definition==
 +
 +
Define the use case in plain sentences and wherever possible, avoid
 +
specifying technical solutions or implementation choices. Concentrate
 +
on the application aspects of the intended scenario.
 +
 
 +
===Purpose===
 +
 
 +
A verbose description of why this use case exists, what the problem is
 +
to be solved, what resources are generally needed (if known) and what
 +
a successful outcome and impact may be.
  
Earth Information Exchange
+
===Application Area Detail===
 +
 
 +
===Definition of Success===
  
 
==Revision Information==
 
==Revision Information==
Line 38: Line 52:
  
 
Through this use case, the system User locates and identifies datasets (collections of related grandules) for use or processing. This process results in the User having access to a subset of the datasets in the portal that meet the requirements of the User. Individual datasets, and their constituent granules, may then be identified for further action or processing (e.g. Visualization, analysis, download).  
 
Through this use case, the system User locates and identifies datasets (collections of related grandules) for use or processing. This process results in the User having access to a subset of the datasets in the portal that meet the requirements of the User. Individual datasets, and their constituent granules, may then be identified for further action or processing (e.g. Visualization, analysis, download).  
 +
 +
===Successful Outcomes===
 +
*1.Operation succeeds and user obtains QQQ.
 +
 +
===Failure Outcomes===
 +
 +
*1.Operation fails to return any XXX. Should instead YYYY.
 +
*2.Illegal input of AAA, Should instead ZZZZ
 +
 +
==General Diagrams==
 +
 +
===Schematic of Use case===
 +
 +
A diagram of how the different elements and people/processes
 +
may fit together in the use case (if possible do not refer to
 +
specific technologies).
 +
 +
==General Requirements==
 +
 +
List any performance or metric requirements for this use case and
 +
any other considerations that a user would expect.
 +
 +
==Use Case Elaboration==
  
 
===Actors===
 
===Actors===
  
 
  Always identify primary actors, may be more than one. Also identify other actor
 
  Always identify primary actors, may be more than one. Also identify other actor
  including any other systems or services which are important.
+
  including any other systems or services which are important. Primary actors
 +
are usually ones that invoke the use case and are beneficiaries of the
 +
result. They may be human or computer. They are actionable. Other actors
 +
are those that support the primary actor, i.e. would be part of the use case
 +
without the tasks, work flow, resource, or requirements implied by the needs
 +
of the primary actor.
  
 
====Primary Actors====
 
====Primary Actors====
Line 49: Line 91:
  
 
====Other Actors====
 
====Other Actors====
 +
Security actor, who authenticates the user requests and issues authorizations
 +
for access to relevant data/resources.
 
   
 
   
 
===Preconditions===
 
===Preconditions===
Line 69: Line 113:
 
*1)The user selects the 'dataset discovery' tool collection from the user interface
 
*1)The user selects the 'dataset discovery' tool collection from the user interface
 
*2)The user selects a control that provides access to an advanced search tool that supports spatial, temporal, and parametric search methods. Flow then extends to EIE11-EIE14.
 
*2)The user selects a control that provides access to an advanced search tool that supports spatial, temporal, and parametric search methods. Flow then extends to EIE11-EIE14.
 
===Successful Outcomes===
 
*1.Operation succeeds and user obtains QQQ.
 
 
===Failure Outcomes===
 
 
*1.Operation fails to return any XXX. Should instead YYYY.
 
*2.Illegal input of AAA, Should instead ZZZZ
 
  
 
===Special Functional Requirements===
 
===Special Functional Requirements===

Latest revision as of 09:06, March 19, 2007

Use Case <Cluster>.<SubArea>.<number>.<letter>: <Short Name>

E.g.
Use Case AQ.Smoke.1.a: Smoke plume event detection and related dataset discovery
<Cluster>={AQ, DM, EC, EF, PH, WM}
<number>={1, 2, 3, ...}
<letter>={a, b, c, ...}
Please complete as many sections as possible down to the section entitled:
"Use Case Elaboration"

Definition

Define the use case in plain sentences and wherever possible, avoid
specifying technical solutions or implementation choices. Concentrate
on the application aspects of the intended scenario.

Purpose

A verbose description of why this use case exists, what the problem is
to be solved, what resources are generally needed (if known) and what
a successful outcome and impact may be.

Application Area Detail

Definition of Success

Revision Information

Version X.N.a (can be labeled draft if X=0)

Prepared by <Author(s) with responsibility>

<Affiliation>

<Date/Time created>

Revision History

Modified by <Modifier Name/Affil>, <Date/time>, <Brief Description>

Use Case Identification

Use Case Designation

<Cluster>.<SubArea>.<number>.<letter>

Use Case Name

<Insert short name and long name>

Use Case Definition

First paragraph is short description, second paragraph, etc. may contain
further details.

Through this use case, the system User locates and identifies datasets (collections of related grandules) for use or processing. This process results in the User having access to a subset of the datasets in the portal that meet the requirements of the User. Individual datasets, and their constituent granules, may then be identified for further action or processing (e.g. Visualization, analysis, download).

Successful Outcomes

  • 1.Operation succeeds and user obtains QQQ.

Failure Outcomes

  • 1.Operation fails to return any XXX. Should instead YYYY.
  • 2.Illegal input of AAA, Should instead ZZZZ

General Diagrams

Schematic of Use case

A diagram of how the different elements and people/processes
may fit together in the use case (if possible do not refer to 
specific technologies).

General Requirements

List any performance or metric requirements for this use case and 
any other considerations that a user would expect.

Use Case Elaboration

Actors

Always identify primary actors, may be more than one. Also identify other actor
including any other systems or services which are important. Primary actors 
are usually ones that invoke the use case and are beneficiaries of the
result. They may be human or computer. They are actionable. Other actors
are those that support the primary actor, i.e. would be part of the use case
without the tasks, work flow, resource, or requirements implied by the needs
of the primary actor.

Primary Actors

The actor that initiates this use case is the portal User. Providers may also initiate this use case as a precursor to use case EIE05, Manage Collections/datasets.

Other Actors

Security actor, who authenticates the user requests and issues authorizations for access to relevant data/resources.

Preconditions

  • 1.Collection metadata have been entered into the system
  • 2.Collection metadata have been validated
  • 3.Collection metadata have been published

Postconditions

  • 1.Datasets or granules have been identified within the system for further action
  • 2.Appropriate action (i.e. Map, download, process) controls have been provided to the user to initiate that action.
  • 3.Controls are provided to the user to refine the criteria used to 'discover' the dataset.

Normal Flow (Process Model)

  • 1)The user selects the 'dataset discovery' tool collection from the user interface
  • 2)The user performs a 'simple' search using a simple interface that searches commonly queries dataset attribute fields for matching text/terms.
  • 3)The results of the search are presented to the user with appropriate action controls associated with the datasets.
  • 4)The user selects one of the action controls to 'use' the identified dataset(s) in a specified action (i.e. Visualization, download, processing)

Alternative Flows

  • 1)The user selects the 'dataset discovery' tool collection from the user interface
  • 2)The user selects a control that provides access to an advanced search tool that supports spatial, temporal, and parametric search methods. Flow then extends to EIE11-EIE14.

Special Functional Requirements

None

Extension Points

  • <Cluster>.<SubArea>.<number>.<letter+1> something added or a variant.

E.g. AQ.Smoke.1.b something added or a variant

  • <Cluster>.<SubArea>.<number>.<letter+2> something added or a variant
  • <Cluster>.<SubArea>.<number>.<letter+3> something added or a variant

Diagrams

Use Case Diagram

State Diagram

Activity Diagram

Other Diagrams

Non-Functional Requirements

Performance

Reliability

Scalability

Usability

Security

Other Non-functional Requirements

Selected Technology

Overall Technical Approach

Architecture

Technology A

Description

Benefits

Limitations

Technology B

Description

Benefits

Limitations

References

None