Difference between revisions of "Functional requirements"

From ICA-AtoM
Jump to navigation Jump to search
 
(8 intermediate revisions by the same user not shown)
Line 1: Line 1:
[[Main Page]] > [[System Requirements]] > Functional requirements
+
[[Main Page]] > [[System requirements]] > Functional requirements
  
 
== Purpose ==
 
== Purpose ==
  
 
Functional requirements state what the system must be able to do. The requirements provide:
 
Functional requirements state what the system must be able to do. The requirements provide:
*Parameters for designing the system.
+
 
 +
*Parameters for designing the system and identifying [[Metadata requirements|metadata requirements]].
 +
 
 
*Criteria for testing the system (used in initial release and future iterations and upgrades).
 
*Criteria for testing the system (used in initial release and future iterations and upgrades).
 +
 
*Planning guidelines for developing the system (improve existing or add new functionality).
 
*Planning guidelines for developing the system (improve existing or add new functionality).
 +
 
*Documentation for standards compliance (link requirements to relevant international or national descriptive standards)
 
*Documentation for standards compliance (link requirements to relevant international or national descriptive standards)
 +
 
*A framework for structuring user-end documentation (step-by-step procedures for how to do things in the system).
 
*A framework for structuring user-end documentation (step-by-step procedures for how to do things in the system).
  
Line 32: Line 37:
 
Each functional requirement includes some or all of the following information:
 
Each functional requirement includes some or all of the following information:
  
'''Requirement number'''
+
*'''Requirement number''': FR-x.x.x, unique tracking number assigned to requirement.
*FR-x.x.x, unique tracking number assigned to requirement.
+
 
 +
*'''Requirement name''': descriptive name assigned to requirement.
  
'''Requirement name'''
+
*'''Specification''': brief description of requirement; users of the application must be able to do X, the system must be able to do X.
*Descriptive name assigned to requirement.
 
  
'''Specification'''
+
*'''Context (parent requirements)''': links to higher-level requirements, if applicable.
*Brief description of requirement; users of the application must be able to do X, the system must be able to do X.
 
  
''Context (parent requirements)''
+
*'''Sub-requirements''': links to lower-level requirements, if applicable.
*Links to higher-level requirements, if applicable.
 
  
''Sub-requirements''
+
*'''Source quotations''': links to standards or other documents: why must the applicable be able to do X?
*Links to lower-level requirements, if applicable.
 
  
''Source quotations''
+
*'''Associated metadata requirements''': what data must the application capture in order to be able to do X?
*Links to standards or other documents: why must the applicable be able to do X?
 
  
''Associated metadata requirements''
+
*'''Associated quality requirements''': what design and interface features must the application have to do X '''well'''?
*What data must the application capture in order to be able to do X?
 
  
''Associated quality requirements''
+
*'''Associated technical requirements''': what system architecture, hardware / software configurations, and programming rules must the application implement to do X?
*What design and interface features must the application have to do X '''well'''?
 
  
''Associated technical requirements''
+
*'''ICA-AtoM implementation''': brief description of how ICA-AtoM implements X.
*What system architecture, hardware / software configurations, and programming rules must the application implement to do X?
 
  
''ICA-AtoM implementation''
+
*'''Known issues''': brief indication of known problems or limitations in the current version of ICA-AtoM that should be addressed in future releases.
*Brief description of how ICA-AtoM implements X.
 
  
''Known issues''
+
*'''Use cases''': links to descriptions of user-end scenarios relating to the requirement and how they are handled in ICA-AtoM.
*Brief indication of known problems or limitations in the current version of ICA-AtoM that should be addressed in future releases.
 
  
''Use cases''
+
*'''User Manual sections''': links to the User manual sections that provide step-by-step instructions for doing X.
*Links to descriptions of user-end scenarios relating to the requirement and how they are handled in ICA-AtoM.
 
  
''User Manual sections''
 
*Links to the User manual sections that provide step-by-step instructions for doing X.
 
  
 
Note that most of this detail will only be found at the lower-level requirements. Higher-level requirements will typically only include the requirement name, number, specification, and source quotation, with links to the lower-level sub-requirements.
 
Note that most of this detail will only be found at the lower-level requirements. Higher-level requirements will typically only include the requirement name, number, specification, and source quotation, with links to the lower-level sub-requirements.
Line 75: Line 68:
  
 
== Index of functional requirements ==
 
== Index of functional requirements ==
 +
 +
The following is the full index of functional requirements identified to date.
 +
  
 
[[FR-1|'''FR-1 Implement a system of control''']]
 
[[FR-1|'''FR-1 Implement a system of control''']]
  
 
*[[FR-1.1|FR-1.1 Define system scope]]
 
*[[FR-1.1|FR-1.1 Define system scope]]
**[[FR-1.1.1|FR-1.1.1 Identify data input methods]]
+
**[[FR-1.1.1|FR-1.1.1 Specify data input methods]]
**[[FR-1.1.2|FR-1.1.2 Identify repositories that will contribute descriptions]]
+
**[[FR-1.1.2|FR-1.1.2 Specify repositories that will contribute descriptions]]
**[[FR-1.1.3|FR-1.1.3 Identify languages in which descriptions will be accessible]]
+
**[[FR-1.1.3|FR-1.1.3 Specify languages in which descriptions will be accessible]]
**[[FR-1.1.4|FR-1.1.4 Identify individuals who will contribute descriptions]]
+
**[[FR-1.1.4|FR-1.1.4 Specify individuals who will contribute descriptions]]
  
 
*[[FR-1.2 |FR-1.2 Implement a system of intellectual control]]
 
*[[FR-1.2 |FR-1.2 Implement a system of intellectual control]]
Line 93: Line 89:
 
*[[FR-1.3|FR-1.3 Implement a system of administrative control]]
 
*[[FR-1.3|FR-1.3 Implement a system of administrative control]]
  
*[[FR=1.4| FR-1.4 Implement a system of physical control]]
+
*[[FR-1.4| FR-1.4 Implement a system of physical control]]
  
  
Line 127: Line 123:
 
*[[FR-2.10|FR-2.10 Administer access to archival materials]]
 
*[[FR-2.10|FR-2.10 Administer access to archival materials]]
 
 
*[[FR-2.11|FR-2.11 Promote archival materials]][[FNC-3 | FNC-3 Translate content]]
+
*[[FR-2.11|FR-2.11 Promote archival materials]]
  
  

Latest revision as of 12:14, 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 > Functional requirements

Purpose

Functional requirements state what the system must be able to do. The requirements provide:

  • Criteria for testing the system (used in initial release and future iterations and upgrades).
  • Planning guidelines for developing the system (improve existing or add new functionality).
  • Documentation for standards compliance (link requirements to relevant international or national descriptive standards)
  • A framework for structuring user-end documentation (step-by-step procedures for how to do things in the system).


Organization

Functional requirements are organized hierarchically, with high-level requirements broken down into sub- and sub-sub-requirements. To facilitate cross-references and links, each requirement has been assigned an alpha-numeric code: the alpha prefix designates the type of requirement (FR = functional requirement), the number establishes its position in the hierarchy. Six main functional requirements have been identified:

FR-1 Implement a system of control

FR-2 Add / edit content

FR-3 Translate content

FR-4 Access content

FR-5 Import / export content

FR-6 Administer the system


Information

Each functional requirement includes some or all of the following information:

  • Requirement number: FR-x.x.x, unique tracking number assigned to requirement.
  • Requirement name: descriptive name assigned to requirement.
  • Specification: brief description of requirement; users of the application must be able to do X, the system must be able to do X.
  • Context (parent requirements): links to higher-level requirements, if applicable.
  • Sub-requirements: links to lower-level requirements, if applicable.
  • Source quotations: links to standards or other documents: why must the applicable be able to do X?
  • Associated metadata requirements: what data must the application capture in order to be able to do X?
  • Associated quality requirements: what design and interface features must the application have to do X well?
  • Associated technical requirements: what system architecture, hardware / software configurations, and programming rules must the application implement to do X?
  • ICA-AtoM implementation: brief description of how ICA-AtoM implements X.
  • Known issues: brief indication of known problems or limitations in the current version of ICA-AtoM that should be addressed in future releases.
  • Use cases: links to descriptions of user-end scenarios relating to the requirement and how they are handled in ICA-AtoM.
  • User Manual sections: links to the User manual sections that provide step-by-step instructions for doing X.


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


Index of functional requirements

The following is the full index of functional requirements identified to date.


FR-1 Implement a system of control


FR-2 Add / edit content


FR-3 Translate content


FR-4 Access content


FR-5 Import / export content


FR-6 Administer the system