Difference between revisions of "Metadata requirements"

From ICA-AtoM
Jump to navigation Jump to search
Line 17: Line 17:
 
*[[MR-7|MR-7 Record information about users]]
 
*[[MR-7|MR-7 Record information about users]]
  
 +
[[MTD-1]]
 +
[[MTD-2]]
 +
[[MTD-3]]
 +
[[MTD-4]]
 +
[[MTD-5]]
 +
[[MTD-6]]
 +
[[MTD-7]]
  
 
== Information ==
 
== Information ==
Line 22: Line 29:
 
Each metadata requirement includes some or all of the following information:
 
Each metadata requirement includes some or all of the following information:
  
'''Requirement number'''
+
*'''Requirement number''': MR-x.x.x, unique tracking number assigned to requirement.
*Unique tracking number assigned to requirement in form MR-x.x.x
 
  
 +
*'''Requirement name''': descriptive name assigned to requirement.
  
'''Requirement name'''
+
*'''Specification''': brief description of requirement; what data must the application be able to capture?
*Descriptive name assigned to requirement.
 
  
 +
*'''Context (parent requirements)''': links to higher-level metadata requirements, if applicable.
  
'''Requirement specification'''
+
*'''Sub-requirements''': links to lower-level metadata requirements, if applicable.
*Brief description of requirement: what data must the application be able to capture?
 
  
|- valign="top" align="left"
+
*'''Source quotations''': links to standards or other documents: why must the application capture this data.
| style="background:silver" | Source quotation
 
| Links to standards or other documents: why must the applicable capture this data?
 
  
|- valign="top" align="left"
+
*'''Associated functional requirements''': what functionality requires the application to capture this data.
| style="background:silver" | Associated functional requirements
 
| Links to funcational requirements: what functionality requires the application to capture this data?
 
  
|- valign="top" align="left"
+
*'''Associated quality requirements''': what design and interface features must the application have to capture the data ''well''.
| style="background:silver" | Associated quality requirements
 
| What design and interface features must the application have to do capture this data well?
 
  
|- valign="top" align="left"
+
*'''Associated technical requirements''': what system architecture, hardware / software configurations, and programming rules must the application implement to capture the data.
| style="background:silver" | Associated technical requirements
 
| Links to technical requirements: what system architecture, hardware / software configurations, and programming rules must the application implement to capture this data?
 
  
|- valign="top" align="left"
+
*'''ICA-AtoM implementation''': what fields in ICA-AtoM store the data.
| style="background:silver" | ICA-AtoM fields
 
| List of fields in ICA-AtoM that store the required date (in the form <span class="dbElement">table_name::field_name</span>.
 
  
|- valign="top" align="left"
+
*'''Known issues''': brief indication of known problems or limitations in the current version of ICA-AtoM that should be addressed in future releases.
| style="background:silver" | ICA-AtoM implementation
 
| Brief description of how ICA-AtoM implements this metadata requirement.
 
  
|- valign="top" align="left"
+
*'''Use cases''': links to descriptions of user-end scenarios relating to the requirement and how they are handled in ICA-AtoM.
| style="background:silver" | Known issues
 
| Brief indication of known problems or limitations in the current version of ICA-AtoM that should be addressed in future releases.
 
  
|- valign="top" align="left"
+
*'''User Manual sections''': links to the User manual sections that provide step-by-step instructions for capturing the data.
| style="background:silver" | Use cases
 
| Links to descriptions of user-end scenarios relating to the requirement and how they are handled in ICA-AtoM.
 
  
|- valign="top" align="left"
 
| style="background:silver" | User Manual sections
 
| Links to the User manual sections that provide step-by-step instructions for capturing this data.
 
  
|}
+
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 ==
 +
 
 +
[[MR-1|'''MR-1 Record information about archival materials''']]
 +
*[[MR-1.1 |MR-1.1 Register units of description]]
 +
**[[MR-1.1.1|MR-1.1.1 Assign unique identifiers to a description]]
 +
**[[MR-1.1.2|MR-1.1.2 Assign names to the object of a description]]
 +
**[[MR-1.1.3|MR-1.1.3 Indicate the level of description]]
 +
**[[MR-1.1.4|MR-1.1.4 Indicate the dates of the material described]]
 +
**[[MR-1.1.5|MR-1.1.5 Indicate the extent of the material described]]
 +
 
 +
*[[MR-1.2|MR-1.2 Record information about the context of archival materials]]
 +
**[[MR-1.2.1|MR-1.2.1 Indicate the creator(s) of archival materials]]
 +
**[[MR-1.2.2|MR-1.2.2 Describe the creator(s) of archival materials]]
 +
**[[MR-1.2.3|MR-1.2.3 Describe the custody of archival materials]]
  
 +
*[[MR-1.3|MR-1.3 Record information about the content and structure of archival materials]]
 +
**[[MR-1.3.1|MR-1.3.1. Describe the scope and content of archival materials]]
 +
**[[MR-1.3.2|MR-1.3.2. Describe the appraisal, destruction and scheduling of archival materials]]
 +
**[[MR-1.3.3|MR-1.3.3 Indicate future accruals to archival materials]]
 +
**[[MR-1.3.4|MR-1.3.4 Describe the system of arrangement of archival materials]]
  
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.
+
*[[MR-1.4|MR-1.4 Record information about the conditions of access and use of archival mtrls]]
 +
**[[MR-1.4.1|MR-1.4.1 Indicate the conditions governing access to archival materials]]
 +
**[[MR-1.4.2|MR-1.4.2 Indicate the conditions governing reproduction of archival material]]
 +
**[[MR-1.4.3|MR-1.4.3 Indicate languages and scripts employed in archival materials]]
 +
**[[MR-1.4.4|MR-1.4.4 Indicate physical characteristics and technical requirements affecting availability of archival materials]]
 +
**[[MR-1.4.5|MR-1.4.5 Indciate the existence of other finding aids to archival materials]]
  
 +
*[[MR-1.5|MR-1.5 Record information about materials related to the unit of description]]
 +
**[[MR-1.5.1|MR-1.5.1 Indicate the location of the originals of the archival materials described]]
 +
**[[MR-1.5.2|MR-1.5.2 Indicate the location of copies of the archival materials described]]
 +
**[[MR-1.5.3|MR-1.5.3 Indicate related archival materials in other units of description]]
 +
**[[MR-1.5.4|MR-1.5.4 Indicate publications related to the archival materials described]]
  
== Index ==
 
  
[[MTD-1 | '''MTD-1 Record information about archival materials''']]
+
[[MR-2|'''MR-2 Record information about actors''']]
*[[MTD-1.1 | MTD-1.1 Register units of description]]
 
**[[MTD-1.1.1 | MTD-1.1.1 Assign unique identifiers to a description]]
 
**[[MTD-1.1.2 | MTD-1.1.2 Assign names to the object of a description]]
 
**[[MTD-1.1.3 | MTD-1.1.3 Indicate the level of description]]
 
**[[MTD-1.1.4 | MTD-1.1.4 Indicate the dates of the material described]]
 
**[[MTD-1.1.5 | MTD-1.1.5 Indicate the extent of the material described]]
 
  
*[[MTD-1.2 | MTD-1.2 Record information about the context of archival materials]]
 
**[[MTD-1.2.1 | MTD-1.2.1 Indicate the creator(s) of archival materials]]
 
**[[MTD-1.2.2  | MTD-1.2.2 Describe the creator(s) of archival materials]]
 
**[[MTD-1.2.3 | MTD-1.2.3 Describe the custody of archival materials]]
 
  
*[[MTD-1.3 | MTD-1.3 Record information about the content and structure of archival materials]]
+
[[MR-3|'''MR-3 Record information about archival institutions''']]
**[[MTD-1.3.1 | MTD-1.3.1. Describe the scope and content of archival materials]]
 
**[[MTD-1.3.2 | MTD-1.3.2. Describe the appraisal, destruction and scheduling of archival materials]]
 
**[[MTD-1.3.3 | MTD-1.3.3 Indicate future accruals to archival materials]]
 
**[[MTD-1.3.4 | MTD-1.3.4 Describe the system of arrangement of archival materials]]
 
  
*[[MTD-1.4 | MTD-1.4 Record information about the conditions of access and use of archival mtrls]]
 
**[[MTD-1.4.1 | MTD-1.4.1 Indicate the conditions governing access to archival materials]]
 
**[[MTD-1.4.2 | MTD-1.4.2 Indicate the conditions governing reproduction of archival material]]
 
**[[MTD-1.4.3 | MTD-1.4.3 Indicate languages and scripts employed in archival materials]]
 
**[[MTD-1.4.4 | MTD-1.4.4 Indicate physical characteristics and technical requirements affecting availability of archival materials]]
 
**[[MTD-1.4.5  | MTD-1.4.5 Indciate the existence of other finding aids to archival materials]]
 
  
*[[MTD-1.5 | MTD-1.5 Record information about materials related to the unit of description]]
+
[[MR-4|'''MR-4 Record information about controlled terms''']]
**[[MTD-1.5.1 | MTD-1.5.1 Indicate the location of the originals of the archival materials described]]
 
**[[MTD-1.5.2 | MTD-1.5.2 Indicate the location of copies of the archival materials described]]
 
**[[MTD-1.5.3 | MTD-1.5.3 Indicate related archival materials in other units of description]]
 
**[[MTD-1.5.4 | MTD-1.5.4 Indicate publications related to the archival materials described]]
 
  
[[MTD-2 | '''MTD-2 Record information about actors''']]
 
  
[[MTD-3 | '''MTD-3 Record information about archival institutions''']]
+
[[MR-5|'''MR-5 Record information about descriptions''']]
  
[[MTD-4 | '''MTD-4 Record information about controlled terms''']]
 
  
[[MTD-5 | '''MTD-5 Record information about descriptions''']]
+
[[MR-6|'''MR-6 Record information about relationships between descriptions''']]
  
[[MTD-6 | '''MTD-6 Record information about relationships between descriptions''']]
 
  
[[MTD-7 | '''MTD-7 Record information about users''']]
+
[[MR-7|'''MR-7 Record information about users''']]

Revision as of 16:45, 10 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 > Metadata requirements

Purpose

Metadata requirements identify the entities the system must track and the kinds of information about them it must capture in order to do the things specified by the functional requirements. The requirements provide parameters for designing the system.


Organization

Metadata 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 (MTD = mateadata requirement), the number establishes its position in the hierarchy. Seven main metadata requirements have been identified:

MTD-1 MTD-2 MTD-3 MTD-4 MTD-5 MTD-6 MTD-7

Information

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

  • Requirement number: MR-x.x.x, unique tracking number assigned to requirement.
  • Requirement name: descriptive name assigned to requirement.
  • Specification: brief description of requirement; what data must the application be able to capture?
  • Context (parent requirements): links to higher-level metadata requirements, if applicable.
  • Sub-requirements: links to lower-level metadata requirements, if applicable.
  • Source quotations: links to standards or other documents: why must the application capture this data.
  • Associated functional requirements: what functionality requires the application to capture this data.
  • Associated quality requirements: what design and interface features must the application have to capture the data well.
  • Associated technical requirements: what system architecture, hardware / software configurations, and programming rules must the application implement to capture the data.
  • ICA-AtoM implementation: what fields in ICA-AtoM store the data.
  • 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 capturing the data.


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

MR-1 Record information about archival materials


MR-2 Record information about actors


MR-3 Record information about archival institutions


MR-4 Record information about controlled terms


MR-5 Record information about descriptions


MR-6 Record information about relationships between descriptions


MR-7 Record information about users