Difference between revisions of "Step-By-Step Instruction"

From Metadata-Registry
Jump to: navigation, search
(STEP 1. User Registration)
(STEP 1. User Registration)
Line 7: Line 7:
  
  
[[Image:Registry-front-page.jpg]]
+
[[Image:Registry-front-page.png]]
  
  
Line 13: Line 13:
  
  
[[Image:New_login_screen.png]]
+
[[Image:Signin-register-new.png]]
  
 
====STEP 2. Register an Owner or Maintenance Agency====  
 
====STEP 2. Register an Owner or Maintenance Agency====  

Revision as of 09:35, 28 October 2008

Step-by-Step Instructions for Using the NSDL Registry

STEP 1. User Registration

  • Go to the production Registry (or to the Sandbox if you want to try things out first). Please note that separate signons are necessary for each, and do make sure you know whether you're in Production or Sandbox before you start!
  • Note that currently you must have JavaScript enabled in your browser to use the site.


Registry-front-page.png


  • Click on sign in/register in the top right hand corner. When the sign in/register form appears, if you haven't yet registered click on the checkbox next to "click here to create a new account" to display the rest of the registration form and register yourself as a user.
    If you just want to browse the Registry, you don't need to register, but user registration and login is essential for managing schemas and vocabularies.


File:Signin-register-new.png

STEP 2. Register an Owner or Maintenance Agency

  • As a User, you may now register an organization or a person as a Resource Owner or maintenance agency. When you register an owner, you automatically become an administrator for that owner/maintenance agency within the Registry. Soon you will be able to add other registered users as maintainers for the vocabularies you register (for now, if you need to add another maintainer, contact the Registry Admin).
  • All registered vocabularies must have an owner, but registered owners may have any number of vocabularies. Not every vocabulary owned by a particular agency or individual will be managed by the same maintainers.


New owner page2.png


  • Required information for owners or maintenance agencies allows essential contact to be maintained between the individual or organization and the NSDL Registry. Contact information is used to provide notifications of activity and to provide assistance in the event of problems.

Step 3. Register a Top-Level Vocabulary

  • After you've registered an owner/maintenance agency, you will be shown your accepted data. On the right side menu, you will see a list of current vocabularies and owners, and links on the bottom of the list that allow you to register a new owner or a new vocabulary. If you click the vocabulary link, you will be presented with a form to fill out for your vocabulary.
  • You MUST be an administrator associated with the owner to register a vocabulary for that owner.


New vocabulary page.png


  • If you are a maintainer or administrator for more than one owner, you will be given a pull down list to select on behalf of which owner you are registering the vocabulary. It is critical that you select the correct owner at this stage, because all other relationships cascade from this action.
  • Specific data instructions:
    • Name (required): Use the full name by which the vocabulary is commonly known.
    • URL: If the vocabulary is available on a website, key in the full address here, including the "http://" portion.
    • Note: Any relevant human-readable text may be added here. Remember that this not will be publicly available to those browsing the Registry.
    • Community: If the vocabulary was developed for use by a specific community, it may be noted here.
    • Base Domain: The form will default to the Registry domain: http://metadataregistry.org/uri/ but you may override the default if you wish to use a domain associated with the vocabulary owner.
    • Token: The token distinguishing the specific vocabulary (ensuring unambiguous URIs) should be related to the vocabulary name, but in shortened form.
    • URI: If you click in the URI he application will ask you if you wish to associate the domain name and token to create the base URI for the vocabulary. You should say "yes."

Step 4. Add Terms to your Vocabulary

  • Once your vocabulary is registered, you may add concepts/terms by clicking on the concepts tab at the top tab. You will be presented with a header with the name of your vocabulary, and an "Add Concept" button. After the first concept is registered, you can use “save and add” to save the current concept and invoke an empty form to register the next in the same step. We suggest that you register all your concepts FIRST, before adding any properties to the concepts (why we suggest this will become more obvious when you begin to create relationships between concepts).
  • You will only be enabled to add terms or edit terms for vocabularies for which you are an administrator or maintainer. All administrators and maintainers are listed at the bottom of the top-level vocabulary page.

Add concept form.png


  • Note that when the form is presented, the URI will default to the Domain name/token you chose for the vocabulary, and a unique number. If you prefer a different number or text string, you can substitute it for that defaulted number before saving the entry. Once the page is saved, the URI cannot be chanced, but instead must be deleted and the concept re-entered.

Step 5. Add Properties to your Terms

  • Once your concepts are registered, you can go through your set of terms and add additional properties. To add properties, invoke a list of your concepts, click the link on the one to which you wish to add properties. When it displays, click on "Properties" on the top tab, and then the "Add Properties" button on the bottom.
  • Specific data instructions:
    • SKOS Property: Choose a property from the pull down list that contains all the SKOS properties currently supported by the Registry
    • Value: Add the text information appropriate to the property chosen. When you add “broader,” “narrower,” or “related” properties to a concept, The Registry will automatically present you with a list of other concepts available for the reciprocal relationship. The Registry will automatically add the reciprocal in the related concepts.
  • You will only be enabled to add or edit properties to vocabularies for which you are a registered administrator or maintainer. All administrators and maintainers are listed at the bottom of the top-level vocabulary page.


Add property form.png


  • When the form is saved, the new properties will be listed at the bottom of the concept page.


New property page.png