Difference between revisions of "Functional requirements"

From ICA-AtoM
Jump to navigation Jump to search
Line 97: Line 97:
  
 
---
 
---
 
 
<span id="FR-1.1"></span>
 
<span id="FR-1.1"></span>
 
=== Implement a system of control ===
 
=== Implement a system of control ===
  
 +
{| border="1" cellpadding="2"
 +
 +
|- valign="top" align="left" style="background:#00008B; color:white"
 +
!width="250" | Requirement number
 +
!width="700" | FR-1.1
 +
 +
|- valign="top" align="left"
 +
| style="background:silver"  | Requirement name
 +
| Implement a system of control.
 +
 +
|- valign="top" align="left"
 +
| style="background:silver"  | Requirement specification
 +
| The system must:
 +
 +
|- valign="top" align="left"
 +
| style="background:silver"  | Sub-requirements
 +
|
 +
*[[#FR-1.1.1 | 1.1.1 Support multi-level description]]
 +
*[[#FR-1.1.2 | 1.1.2 Accommodate different levels as the highest level of arrangement and description]]
 +
*[[#FR-1.1.3 | 1.1.3 Accommodate different systems for assigning reference codes]]
 +
 +
|}
 +
 +
---
 +
 +
<span id="FR-1.1.1"></span>
 +
==== Support multi-level description ====
 +
 +
{| border="1" cellpadding="2"
 +
 +
|- valign="top" align="left" style="background:#00008B; color:white"
 +
!width="250" | Requirement number
 +
!width="700" | FR-1.1.1
 +
 +
|- valign="top" align="left"
 +
| style="background:silver" | Requirement name
 +
| Support multi-level description.
 +
 +
|- valign="top" align="left"
 +
| style="background:silver"  | Requirement specification
 +
| The system must be able to:
 +
 +
|- valign="top" align="left"
 +
| style="background:silver" | Requirement quotation
 +
|
 +
*[[ISAD(G)# | ISAD(G) ]]
 +
*[[ISAAR(CPF)# | ISAAR(CPF) ]]
 +
*[[ISIAH# | ISIAH ]]
 +
 +
|- valign="top" align="left"
 +
| style="background:silver" | Associated metadata requirements
 +
|
 +
 +
|- valign="top" align="left"
 +
| style="background:silver" | Associated quality requirements
 +
|
 +
 +
|- valign="top" align="left"
 +
| style="background:silver" | Associated technical requirements
 +
|
 +
 +
|- valign="top" align="left"
 +
| style="background:silver" | ICA-AtoM implementation
 +
|
 +
 +
|- valign="top" align="left"
 +
| style="background:silver" | Known issues
 +
|
 +
 +
|- valign="top" align="left"
 +
| style="background:silver" | User Manual sections
 +
|
 +
 +
|}
 +
 +
---
 +
 +
<span id="FR-1.1.2"></span>
 +
==== Accommodate different levels as the highest level of arrangement and description ====
 +
 +
{| border="1" cellpadding="2"
 +
 +
|- valign="top" align="left" style="background:#00008B; color:white"
 +
!width="250" | Requirement number
 +
!width="700" | FR-1.1.2
 +
 +
|- valign="top" align="left"
 +
| style="background:silver" | Requirement name
 +
| Accommodate different levels as the highest level of arrangement and description.
 +
 +
|- valign="top" align="left"
 +
| style="background:silver"  | Requirement specification
 +
| The system must be able to:
 +
 +
|- valign="top" align="left"
 +
| style="background:silver" | Requirement quotation
 +
|
 +
*[[ISAD(G)# | ISAD(G) ]]
 +
*[[ISAAR(CPF)# | ISAAR(CPF) ]]
 +
*[[ISIAH# | ISIAH ]]
 +
 +
|- valign="top" align="left"
 +
| style="background:silver" | Associated metadata requirements
 +
|
 +
 +
|- valign="top" align="left"
 +
| style="background:silver" | Associated quality requirements
 +
|
 +
 +
|- valign="top" align="left"
 +
| style="background:silver" | Associated technical requirements
 +
|
 +
 +
|- valign="top" align="left"
 +
| style="background:silver" | ICA-AtoM implementation
 +
|
 +
 +
|- valign="top" align="left"
 +
| style="background:silver" | Known issues
 +
|
 +
 +
|- valign="top" align="left"
 +
| style="background:silver" | User Manual sections
 +
|
 +
 +
|}
 +
 +
---
 +
 +
<span id="FR-1.1.3"></span>
 +
==== Accommodate different systems for assigning reference codes ====
 +
 +
{| border="1" cellpadding="2"
 +
 +
|- valign="top" align="left" style="background:#00008B; color:white"
 +
!width="250" | Requirement number
 +
!width="700" | FR-1.1.3
 +
 +
|- valign="top" align="left"
 +
| style="background:silver" | Requirement name
 +
| Accommodate different systems for assigning reference codes.
 +
 +
|- valign="top" align="left"
 +
| style="background:silver"  | Requirement specification
 +
| The system must be able to:
 +
 +
|- valign="top" align="left"
 +
| style="background:silver" | Requirement quotation
 +
|
 +
*[[ISAD(G)# | ISAD(G) ]]
 +
*[[ISAAR(CPF)# | ISAAR(CPF) ]]
 +
*[[ISIAH# | ISIAH ]]
 +
 +
|- valign="top" align="left"
 +
| style="background:silver" | Associated metadata requirements
 +
|
 +
 +
|- valign="top" align="left"
 +
| style="background:silver" | Associated quality requirements
 +
|
 +
 +
|- valign="top" align="left"
 +
| style="background:silver" | Associated technical requirements
 +
|
 +
 +
|- valign="top" align="left"
 +
| style="background:silver" | ICA-AtoM implementation
 +
|
 +
 +
|- valign="top" align="left"
 +
| style="background:silver" | Known issues
 +
|
 +
 +
|- valign="top" align="left"
 +
| style="background:silver" | User Manual sections
 +
|
 +
 +
|}
 +
 +
---
  
 
<span id="FR-1.2"></span>
 
<span id="FR-1.2"></span>
 
=== Implement descriptive standards ===
 
=== Implement descriptive standards ===
  
 +
{| border="1" cellpadding="2"
 +
 +
|- valign="top" align="left" style="background:#00008B; color:white"
 +
!width="250" | Requirement number
 +
!width="700" | FR-1.2
 +
 +
|- valign="top" align="left"
 +
| style="background:silver"  | Requirement name
 +
| Implement descriptive standards.
 +
 +
|- valign="top" align="left"
 +
| style="background:silver"  | Requirement specification
 +
| The system must:
 +
 +
|- valign="top" align="left"
 +
| style="background:silver"  | Sub-requirements
 +
|
 +
*[[#FR-1.2.1 | 1.2.1 Support all ICA standards]]
 +
*[[#FR-1.2.2 | 1.2.2 Integrate with existing national or local standards]]
 +
*[[#FR-1.2.3 | 1.2.3 Accommodate different practices for the level of detail required]]
 +
*[[#FR-1.2.4 | 1.2.4 Separate description of archival materials from description of creators and repositories]]
 +
 +
|}
  
 
<span id="FR-1.3"></span>
 
<span id="FR-1.3"></span>
 
=== Create and control description records ===
 
=== Create and control description records ===
 +
 +
{| border="1" cellpadding="2"
 +
 +
|- valign="top" align="left" style="background:#00008B; color:white"
 +
!width="250" | Requirement number
 +
!width="700" | FR-1.3
 +
 +
|- valign="top" align="left"
 +
| style="background:silver"  | Requirement name
 +
| Create and control descriptions
 +
 +
|- valign="top" align="left"
 +
| style="background:silver"  | Requirement specification
 +
| The system must:
 +
 +
|- valign="top" align="left"
 +
| style="background:silver"  | Sub-requirements
 +
|
 +
*[[#FR-1.3.1 | 1.3.1 Accept contributions from multiple repositories]]
 +
*[[#FR-1.3.2 | 1.3.2 Assign unique identifiers to descriptions]]
 +
*[[#FR-1.3.3 | 1.3.3 Accommodate descriptions of different status (draft, finalized, superseded / obsolete]]
 +
*[[#FR-1.3.4 | 1.3.4 Prevent unauthorized creation, alteration or deletion of descriptions]]
 +
 +
 +
|}
  
  
Line 113: Line 340:
 
=== Describe archival materials ===
 
=== Describe archival materials ===
  
 +
 +
{| border="1" cellpadding="2"
 +
 +
|- valign="top" align="left" style="background:#00008B; color:white"
 +
!width="250" | Requirement number
 +
!width="700" | FR-1.2
 +
 +
|- valign="top" align="left"
 +
| style="background:silver"  | Requirement name
 +
| Implement descriptive standards.
 +
 +
|- valign="top" align="left"
 +
| style="background:silver"  | Requirement specification
 +
| The system must:
 +
 +
|- valign="top" align="left"
 +
| style="background:silver"  | Sub-requirements
 +
|
 +
*[[#FR-1.2.1 | 1.2.1 Support all ICA standards]]
 +
*[[#FR-1.2.2 | 1.2.2 Integrate with existing national or local standards]]
 +
*[[#FR-1.2.3 | 1.2.3 Accommodate different practices for the level of detail required]]
 +
*[[#FR-1.2.4 | 1.2.4 Separate description of archival materials from description of creators and repositories]]
 +
 +
|}
  
 
<span id="FR-1.5"></span>
 
<span id="FR-1.5"></span>
 
=== Describe actors ===
 
=== Describe actors ===
  
 +
 +
{| border="1" cellpadding="2"
 +
 +
|- valign="top" align="left" style="background:#00008B; color:white"
 +
!width="250" | Requirement number
 +
!width="700" | FR-1.2
 +
 +
|- valign="top" align="left"
 +
| style="background:silver"  | Requirement name
 +
| Implement descriptive standards.
 +
 +
|- valign="top" align="left"
 +
| style="background:silver"  | Requirement specification
 +
| The system must:
 +
 +
|- valign="top" align="left"
 +
| style="background:silver"  | Sub-requirements
 +
|
 +
*[[#FR-1.2.1 | 1.2.1 Support all ICA standards]]
 +
*[[#FR-1.2.2 | 1.2.2 Integrate with existing national or local standards]]
 +
*[[#FR-1.2.3 | 1.2.3 Accommodate different practices for the level of detail required]]
 +
*[[#FR-1.2.4 | 1.2.4 Separate description of archival materials from description of creators and repositories]]
 +
 +
|}
  
 
<span id="FR-1.6"></span>
 
<span id="FR-1.6"></span>
Line 122: Line 397:
  
  
 +
{| border="1" cellpadding="2"
 +
 +
|- valign="top" align="left" style="background:#00008B; color:white"
 +
!width="250" | Requirement number
 +
!width="700" | FR-1.2
 +
 +
|- valign="top" align="left"
 +
| style="background:silver"  | Requirement name
 +
| Implement descriptive standards.
 +
 +
|- valign="top" align="left"
 +
| style="background:silver"  | Requirement specification
 +
| The system must:
 +
 +
|- valign="top" align="left"
 +
| style="background:silver"  | Sub-requirements
 +
|
 +
*[[#FR-1.2.1 | 1.2.1 Support all ICA standards]]
 +
*[[#FR-1.2.2 | 1.2.2 Integrate with existing national or local standards]]
 +
*[[#FR-1.2.3 | 1.2.3 Accommodate different practices for the level of detail required]]
 +
*[[#FR-1.2.4 | 1.2.4 Separate description of archival materials from description of creators and repositories]]
 +
 +
|}
  
 
== Template ==
 
== Template ==

Revision as of 15:57, 1 February 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


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

  • Parameters for designing the system.
  • 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).


Functional requirements are organized hierarchically, with core requirements, broken down into sub- and sub-sub-requirements. around the core functions of repositories holding archival material. ICA-AtoM currently focuses on two functions, breaking these down into sub- and sub-sub-requirements:

  1. Establish intellectual and administrative control over archival materials
  2. Provide an interface that supports user interaction with the system (create, read, update, delete, search


Each functional requirement includes the following information:

Requirement number FR-x.x.x (unique tracking number assigned to requirement)
Requirement name Descriptive name assigned to requirement.
Requirement specification Brief description of requirement: system must do X.
Sub-requirements If the requirement is broken down into sub-requirements, provides links to these.
Requirement quotation Links to standards or other documents: why must the system be able to do X?
Associated metadata requirements Links to functional requirements: what data must the system capture in order to be able to do X?
Associated quality requirements Links to quality requirements: what design and interface features must the system have to do X well?
Associated technical requirements Links to technical requirements: what system architecture, hardware / software configurations, and programming rules must the system 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.
User Manual sections Links to the User manual sections that provide step-by-step instructions for doing X.


Establish intellectual and administrative control over archival materials

Requirement number FR-1
Requirement name Establish intellectual and administrative control over archival materials
Requirement specification The system must:
  • Support the arrangement and description of archival materials in order to make them accessible.
Sub-requirements

---

Implement a system of control

Requirement number FR-1.1
Requirement name Implement a system of control.
Requirement specification The system must:
Sub-requirements

---

Support multi-level description

Requirement number FR-1.1.1
Requirement name Support multi-level description.
Requirement specification The system must be able to:
Requirement quotation
Associated metadata requirements
Associated quality requirements
Associated technical requirements
ICA-AtoM implementation
Known issues
User Manual sections

---

Accommodate different levels as the highest level of arrangement and description

Requirement number FR-1.1.2
Requirement name Accommodate different levels as the highest level of arrangement and description.
Requirement specification The system must be able to:
Requirement quotation
Associated metadata requirements
Associated quality requirements
Associated technical requirements
ICA-AtoM implementation
Known issues
User Manual sections

---

Accommodate different systems for assigning reference codes

Requirement number FR-1.1.3
Requirement name Accommodate different systems for assigning reference codes.
Requirement specification The system must be able to:
Requirement quotation
Associated metadata requirements
Associated quality requirements
Associated technical requirements
ICA-AtoM implementation
Known issues
User Manual sections

---

Implement descriptive standards

Requirement number FR-1.2
Requirement name Implement descriptive standards.
Requirement specification The system must:
Sub-requirements

Create and control description records

Requirement number FR-1.3
Requirement name Create and control descriptions
Requirement specification The system must:
Sub-requirements



Describe archival materials

Requirement number FR-1.2
Requirement name Implement descriptive standards.
Requirement specification The system must:
Sub-requirements

Describe actors

Requirement number FR-1.2
Requirement name Implement descriptive standards.
Requirement specification The system must:
Sub-requirements

Describe archival institutions

Requirement number FR-1.2
Requirement name Implement descriptive standards.
Requirement specification The system must:
Sub-requirements

Template

Requirement number MR-x
Requirement name Name
Requirement specification

The system must:

  • requirement1
  • requirement2
Requirement quotation
  • link to ISAD(G).
  • link to ISAAR(CPF).
  • link to ISIAH.
  • link to ISDF.
  • link to OSARIS.
Associated metadata requirements
  • link to metadata requirement.
Associated quality requirements
  • link to quality requirement.
Associated technical requirements
  • link to technical requirement.
ICA-AtoM implementation
  • discuss how ICA-AtoM implements requirement.
Known issues
  • discuss how any known problems with ICA-AtoM's current implementation / functionality.
User Manual sections
  • link to User Manual pages.