Getting Started

From Metadata-Registry
Revision as of 09:32, 9 September 2010 by Diane (Talk | contribs)

Jump to: navigation, search

The Open Metadata Registry provides services for discovery, use, and administration of metadata vocabularies and element sets.


For vocabulary maintainers, the registry provides a stable hosting service and a range of management tools.


Training Screencasts

The Sandbox

The registry sandbox is a non-production implementation of the registry software and can be used for testing the registry's features. Everything there works the same as in the live registry, except for the URIs (this avoids the temptation to use the sandbox as a substitute for the production-level registry). We advise playing around a bit in the sandbox before trying anything on the real thing.

Use Cases

For information about common use cases, see: <ask format="ul"></ask>

Making Policy Decisions Prior to Implementation

  • Metadata increasingly lives in an open world. Most older vocabulary development tools are designed to provide assistance in developing vocabularies in commercial environments or where development processes are assumed to reside 'in house.' They are usually applications designed to run behind a firewall for a good-sized organization or on a personal computer. In most cases they can provide output that can be used to develop web pages, but they assume that the organization is not interested in exposing the process itself outside the institution. The Registry is designed to be used in an open web environment--it can be used behind firewalls, but this requires more effort for the institution to manage.
  • Group based vocabulary development and maintenance is the best approach. Most vocabularies are designed for some combination of use by internal and external parties for specific purposes: to enhance discoverability, to deal with the ambiguities of language, or to sell products. Given this reality, most groups find that the development process needs to take advantage of the wisdom of the entire group in order to meet the goals of the group. The Registry software is designed to recognize that need, and accommodates a variety of group processes and workflows, providing opportunities to build vocabularies that can improve over time and reflect changes in language.
  • Sensible vocabulary development tools will support institutions using the Semantic Web. While many institutions are still using vocabularies in traditional ways, many are excited by the possibilities of the Semantic Web and open linked data to improve their results and make their work (whether product, description or idea) more broadly available for use and reuse by new communities of practice. The Registry enables vocabulary development to be undertaken with these Semantic Web opportunities in mind--it is based on standards and good practices developed by the World Wide Web Consortium (W3C), increasingly seen as the underpinnings that will drive the new information world for libraries, commerce and users of all varieties working on the Web.

To start playing in the sandbox, it's enough to be aware of these assumptions. As you plan to use the registry software to maintain schemas & vocabularies either as an individual or in a larger organizational context, you will want to read the following for policy guidance:

User Registration

The Registry user management system is based on a simple model. An individual user begins the process by building a simple profile for himself or herself. This first user then registers an institutional or individual agent who will be the vocabulary owner for vocabularies developed subsequently. By registering an institution or individual agent, the user becomes the Agent Administator for that organization/individual.

Registry Standard Workflow.jpg

Who Should Register

Anyone who will work on vocabulary development should register as a user. If you will be maintaining vocabularies as a part of a larger organization, you should create or join the Agent representing that organization. Otherwise, you can simply register an individual resource owner. Please note that the production Registry and the Sandbox require separate registration.

You do not need to register as a user to access metadata resources hosted on the registry.


Step 1: Register an Individual

On the upper right hand corner of every Registry page is a tab, which, for a user not signed in says:

* sign in/register | about

When clicked on sign in/register, the following page appears:


A new user must register by clicking the box that says click here to create a new account which allows the user to fill in four boxes, all mandatory:

  • a login name
  • a password
  • a password confirmation
  • an email address

The email address is used only for password retrieval, when a user forgets his or her password, is used for no other purpose, nor shared with any other service or individual.


Results: A new user account is created. The user should note the login name and password, as well as the email address entered at the time of new account registration.

Step 2. Register an Agent

Now that you are logged in, you can add a resource owner. Every schema or vocabulary must be owned by a resource owning agent, which can be registered as either an individual or an organization.

To register an agent by click on the (Add) link next to Resource Owners in the Browse box on the right side of the page and fill out the resulting form. Owner Name and Email are required fields. Like with user registration, email addresses are kept private. When you register an agent, you become the registrar of and an administrator for that organization. Other users and administrators can be added later.

Agent Registration Page

What's Next?

Add other users in other roles