Difference between revisions of "NSDL Registry Functional Requirements"

From Metadata-Registry
Jump to: navigation, search
(Creating and editing schemas using the NSDL schema creation tool)
Line 9: Line 9:
 
==Creating and editing schemas using the NSDL schema creation tool==
 
==Creating and editing schemas using the NSDL schema creation tool==
  
The tool should allow a user to create, maintain and remove resource descriptions which they own within the NSDL registry.
+
The tool should allow a user to upload, create, maintain and remove resource descriptions which they own within the NSDL registry.
  
 
#Add Agency description
 
#Add Agency description
Line 28: Line 28:
 
#Add Element Set description
 
#Add Element Set description
 
#*Create description of Element Set
 
#*Create description of Element Set
#*For each Element in Element Set, create description of Element
 
 
#*Save description of Element Set
 
#*Save description of Element Set
 
#*Submit description of Element Set to registry
 
#*Submit description of Element Set to registry
 +
 +
#Upload or Create elements
 +
#*If element descriptions were created in an external tool, and available in approved XML schema,  uploaded the set of elements into the registry [Note: Uploaded descriptions subject to validation.]
 +
#*User verifies that upload has completed correctly, and submits the element descriptions to the Registry
 +
#*Alternatively, for each Element in Element Set, create description of Element
 +
#*Save element description
 +
#*Submit individual descriptions or set to the registry
  
 
#Edit/Update Element Set description
 
#Edit/Update Element Set description
Line 39: Line 45:
 
#*For each Element to be removed, remove description of Element (Do not permit removal if Element used in relationships?)
 
#*For each Element to be removed, remove description of Element (Do not permit removal if Element used in relationships?)
 
#*Save description of Element Set
 
#*Save description of Element Set
#*Re-submit description of Element Set to registry
+
#*Re-submit description of Element Set to registry [NOTE: we will need to work out a versioning policy for this function]
  
 
#Remove Element Set description
 
#Remove Element Set description
 
#*Open existing description of Element Set
 
#*Open existing description of Element Set
#*Remove existing description of Elements in Element Set, remove existing description of Element Set (Do not permit removal if any Element used in relationships, or if Element Set used in relationships?)
+
#*Remove existing description of Elements in Element Set, remove existing description of Element Set (Do not permit removal if any Element used in relationships, or if Element Set used in relationships? Maybe not remove at all, but mark "obsolete"?)
  
 
#Add Encoding Scheme description
 
#Add Encoding Scheme description
Line 50: Line 56:
 
#*Save description of Encoding Scheme
 
#*Save description of Encoding Scheme
 
#*Submit description of Encoding Scheme to registry
 
#*Submit description of Encoding Scheme to registry
 +
[NOTE: Wouldn't this and the following be for syntax encoding schemes only, since we'll have a separate stream for vocabulary encoding schemes?]
  
 
#Edit/Update Encoding Scheme description
 
#Edit/Update Encoding Scheme description
Line 63: Line 70:
 
#*Open existing description of Encoding Scheme
 
#*Open existing description of Encoding Scheme
 
#*Remove existing description of Values in Encoding Scheme (OK because no references), remove existing description of Encoding Scheme (Do not permit removal if Encoding Scheme used in relationships)
 
#*Remove existing description of Values in Encoding Scheme (OK because no references), remove existing description of Encoding Scheme (Do not permit removal if Encoding Scheme used in relationships)
 +
[NOTE: Need to consider carefully whether anything used in instance data should be removed, and whether a change in status to "obsolete" might be better?]
  
 
#Add Application Profile description
 
#Add Application Profile description
Line 78: Line 86:
 
#*Save description of Application Profile
 
#*Save description of Application Profile
 
#*Re-submit description of application to registry
 
#*Re-submit description of application to registry
 +
[NOTE: We'll need an upload option for this section, eventually]
  
 
#Remove Application Profile description
 
#Remove Application Profile description
 
#*Open existing description of Application Profile
 
#*Open existing description of Application Profile
 
#*Remove existing description of Element Usages in Application Profile, remove existing description of Application Profile (OK because no references)
 
#*Remove existing description of Element Usages in Application Profile, remove existing description of Application Profile (OK because no references)
 +
[NOTE: This should probably be a status change rather than removal]
  
 
==Creating and editing annotations==
 
==Creating and editing annotations==

Revision as of 10:31, 26 August 2005

Requirements for Administrative Functions and Interfaces

User Registration and Authentication

Administrative Management and Maintenance

Requirements for User Functions and Interfaces

Creating and editing schemas using the NSDL schema creation tool

The tool should allow a user to upload, create, maintain and remove resource descriptions which they own within the NSDL registry.

  1. Add Agency description
    • Create description of Agency
    • Save description of Agency
    • Submit description of Agency to registry
  1. Edit/Update Agency description
    • Open existing description of Agency
    • Amend description of Agency
    • Save description of Agency
    • Re-submit description of Agency to registry
  1. Remove Agency description
    • Open existing description of Agency
    • Remove existing description of Agency (Do not permit removal if used in relationships?)
  1. Add Element Set description
    • Create description of Element Set
    • Save description of Element Set
    • Submit description of Element Set to registry
  1. Upload or Create elements
    • If element descriptions were created in an external tool, and available in approved XML schema, uploaded the set of elements into the registry [Note: Uploaded descriptions subject to validation.]
    • User verifies that upload has completed correctly, and submits the element descriptions to the Registry
    • Alternatively, for each Element in Element Set, create description of Element
    • Save element description
    • Submit individual descriptions or set to the registry
  1. Edit/Update Element Set description
    • Open existing description of Element Set
    • Amend description of Element Set
    • For each Element to be amended, open existing description of Element, amend description of Element
    • For each Element to be added, create description of Element
    • For each Element to be removed, remove description of Element (Do not permit removal if Element used in relationships?)
    • Save description of Element Set
    • Re-submit description of Element Set to registry [NOTE: we will need to work out a versioning policy for this function]
  1. Remove Element Set description
    • Open existing description of Element Set
    • Remove existing description of Elements in Element Set, remove existing description of Element Set (Do not permit removal if any Element used in relationships, or if Element Set used in relationships? Maybe not remove at all, but mark "obsolete"?)
  1. Add Encoding Scheme description
    • Create description of Encoding Scheme
    • For each Value in Encoding Scheme, create description of Value
    • Save description of Encoding Scheme
    • Submit description of Encoding Scheme to registry

[NOTE: Wouldn't this and the following be for syntax encoding schemes only, since we'll have a separate stream for vocabulary encoding schemes?]

  1. Edit/Update Encoding Scheme description
    • Open existing description of Encoding Scheme
    • Amend description of Encoding Scheme
    • For each Value to be amended, open existing description of Value, amend description of Value
    • For each Value to be added, create description of Value
    • For each Value to be removed, remove description of Value
    • Save description of Encoding Scheme
    • Re-submit description of Encoding Scheme to registry
  1. Remove Encoding Scheme description
    • Open existing description of Encoding Scheme
    • Remove existing description of Values in Encoding Scheme (OK because no references), remove existing description of Encoding Scheme (Do not permit removal if Encoding Scheme used in relationships)

[NOTE: Need to consider carefully whether anything used in instance data should be removed, and whether a change in status to "obsolete" might be better?]

  1. Add Application Profile description
    • Create description of Application Profile
    • For each Element Usage in Application Profile, create description of Element Usage. Note: a Element Usage does not automatically inherit the Encoding Schemes associated with the used Element. Any relevant Encoding Schemes must be explicitly associated with the Element Usage.
    • Save description of Application Profile
    • Submit description of Application Profile to registry
  1. Edit/Update Application Profile description
    • Open existing description of Application Profile
    • Amend description of Application Profile
    • For each Element Usage to be amended, open existing description of Element Usage, amend description of Element Usage
    • For each Element Usage to be added, create description of Element Usage
    • For each Element Usage to be removed, remove description of Element Usage (OK because no references)
    • Save description of Application Profile
    • Re-submit description of application to registry

[NOTE: We'll need an upload option for this section, eventually]

  1. Remove Application Profile description
    • Open existing description of Application Profile
    • Remove existing description of Element Usages in Application Profile, remove existing description of Application Profile (OK because no references)

[NOTE: This should probably be a status change rather than removal]

Creating and editing annotations

  1. Add commentator description
    • Prompt for details on first attempt to create annotation
  1. Edit commentator description
    • Amend description
  1. Add annotation description
    • Click on annotations button
    • Enter details of annotation
    • Specify whether public or private
    • Specify type of annotation (chose from controlled list?)
    • Specify whether it is public or private annotation
  1. Edit annotation description
    • Open existing annotation
    • Amend text
  1. Remove annotation description
    • Delete annotation

Creating and Editing Schemes (Controlled Vocabularies)

Creating and Editing Schema Crosswalks