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

From Metadata-Registry
Jump to: navigation, search
(Step 3. Register a Top-Level Vocabulary)
(Step 4. Add Terms to your Vocabulary)
Line 82: Line 82:
 
** Language: This is where the default human-readable language for the schema properties should be specified.
 
** Language: This is where the default human-readable language for the schema properties should be specified.
  
====Step 4. Add Terms to your Vocabulary====
+
====Step 4a. 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).
+
* Once your vocabulary is registered, you may add concepts/terms by clicking on the concepts tab at the top. You will be presented with a header with the name of your vocabulary, and an "Add Concept" button at the bottom. 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.
+
*Here's an existing vocabulary, for which we could add a concept:
  
[[Image:Add_concept_form.png]]
+
[[Image:Vocabulary-detail.png]]
  
 +
When the "Add concept" button is clicked, a new concept form is presented:
 +
 +
[[Image:Add-concept.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 changed, but instead must be deleted and the concept re-entered.
 +
 +
* 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.
  
* 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 4b: Add Properties to Your Schema====
  
 
====Step 5. Add Properties to your Terms====
 
====Step 5. Add Properties to your Terms====

Revision as of 13:37, 29 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.


SignIn-register-new.png

STEP 2. Register an Owner or Maintenance Agency

  • As a registered 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.
  • 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.


Add-owner-new.png


  • Required information for owners or maintenance agencies allows essential contact to be maintained between the individual or organization and the Registry. Contact information is used to provide notifications of activity and to provide assistance in the event of problems, and is not shared with other organizations or displayed to the public.

Step 2a. Register an Additional Maintainer for the Owner/Maintenance Agency

  • As an administrator for an owner/maintenance agency you can add other registered users as maintainers for the vocabularies you register.
  • First, go to the page for the owner/maintenance agency details

Add-maintainer-new1.png

  • Click on the tab for "Members." There you will see one member: the administrator that registered the entity in the first place.

Add-maintainer-new2.png

  • Below the second blue bar, at the right side, you will see a button to "Add member. When you click on that button, you will be given a list of all registered users from which to select (a new maintainer must already be registered as a user in order to be able to be assigned as a maintainer).

Add-maintainer-new3.png

  • Select a new maintainer from the list and "save" or "save and add."

Step 3. Register a Top-Level Vocabulary or Schema

  • After you've registered an owner/maintenance agency (and perhaps a maintainer or two), you will be shown your accepted data. On the right side menu, you will see a selection of browse categories that will allow you to either browse already registered owners, vocabularies or schemas, or register a new owner, a new vocabulary or a new schema. If you click the (add) vocabulary or (add) schema link, you will be presented with a form to fill out for your vocabulary or schema.
  • You MUST be an administrator or a maintainer associated with the owner to register a vocabulary or schema for that owner.

Step 3a: Registering a Top-Level Vocabulary

  • IMPORTANT: 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.

New-vocabulary-form.png

  • Specific data instructions for Vocabularies:
    • Name (required): Use the full name by which the vocabulary is commonly known.
    • URL: If the vocabulary is available from or has additional documentation on a website, key in the full address here, including the "http://" portion. NOTE: This URL is not the one that will be used to create the Vocabulary's URI--that comes later.
    • Note: Any relevant human-readable text may be added here. Remember that this 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: If no specific domain is entered here, the form will default to the Registry domain: http://metadataregistry.org/uri/. You may override the default if you wish to use a specific domain associated with the vocabulary owner. If you use a specific domain, you should contact the Registry staff about a script that will properly direct browsers and applications to the registry via your site.
    • 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 box the 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 3b: Registering a Top-Level Schema

  • IMPORTANT: 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 schema. It is critical that you select the correct owner at this stage, because all other relationships cascade from this action.

New-schema-form.png

  • Specific data instructions for Schemas:
    • Label (required): Use the full name by which the vocabulary or schema is commonly known. This will be used in the list of schemas for browsing.
    • Name: The name distinguishes the specific schema (ensuring unambiguous URIs) and should be related to the schema label, but in shortened form.
    • Namespace URI: If you click in the URI box the 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."
    • URL: If the schema is available from or has additional documentation on a website, key in the full address here, including the "http://" portion. NOTE: This URL is not the one that will be used to create the schema's URI--that comes later.
    • Note: Any relevant human-readable text may be added here. Remember that this will be publicly available to those browsing the Registry.
    • Tags: If the schema was developed for use by a specific community, it may be noted here.
    • Status: A pull-down list identifies the statuses that are valid here. If the status chosen is other than "Published," this implies that a formal or informal schema development process is in place.
    • Language: This is where the default human-readable language for the schema properties should be specified.

Step 4a. Add Terms to Your Vocabulary

  • Once your vocabulary is registered, you may add concepts/terms by clicking on the concepts tab at the top. You will be presented with a header with the name of your vocabulary, and an "Add Concept" button at the bottom. 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).
  • Here's an existing vocabulary, for which we could add a concept:

Vocabulary-detail.png

When the "Add concept" button is clicked, a new concept form is presented:

Add-concept.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 changed, but instead must be deleted and the concept re-entered.
  • 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.

Step 4b: Add Properties to Your Schema

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